Metadata

Top-level metadata uses bracket syntax to store schema-level configuration:

[version] = 1
[name] = 'MySchema'
[enabled] = true

Value Types

Metadata values can be:

Metadata Objects vs Key-Value Objects

There are two different object syntaxes that look similar but produce different data structures.

Metadata Objects

Metadata objects use bracket keys ([key] = value). Each entry is an ordered tuple of key, value, and attributes (annotations). They support:

• Annotations on entries
• Dotted key names
• Duplicate keys (preserved as separate entries)

[generate] = {
  [php.mappers] = {
    output = 'output/php/Mappers/'
    namespace = 'App\\Mappers\\'
  }
  [ts.types] = {
    output = 'output/ts/types/'
  }
}

Key-Value Objects

Key-value objects use plain identifiers (key = value). These are simple assignments with no annotation support. Duplicate keys override – only the last value is kept:

[config] = {
  name = 'example'
  nested = {
    deeper = {
      value = 42
    }
  }
}

Mixing Both Forms

Both forms can appear in the same object:

[generate] = {
  [php.mappers] = {
    output = 'output/php/Mappers/'
    namespace = 'App\\Mappers\\'
  }
  debug = false
}

Metadata Lists

Lists use {value, value} syntax:

[colors] = {'red', 'green', 'blue'}

Metadata with Annotations

Entries within metadata objects can have annotations:

[upgrades] = {
  @source('Asgard')
  [asgard_core] = 'Complete Asgard knowledge base'

  @source('Ancient')
  [zpm] = 'Zero Point Module power augmentation'
}

Common Metadata Blocks

[version]

Schema format version:

[version] = 1

[map]

Property mapping configuration (see Property Mapping):

[map] = {
  api = {
    strategy = MappingStrategy::snakeCase
  }
}

[generate]

Generator configuration (see Build System):

[generate] = {
  [ts.types] = {
    output = 'output/ts/'
  }
}

[type]

Type alias definitions (see Type Aliases):

[type] = {
  pub MessageType = 'text'|'image'|'video'
}

Model-Level Metadata

Metadata can also appear inside model definitions:

User {
  [version] = 2
  [map:local] = 'camelCase'

  id: int
  name: string
}