Core conceptsData
Types and schemas
Data in Codelab.
Fields, interfaces, and schemas
A field has a name and type. An interface is a list of fields. A schema names an interface for reuse within an app.
Types
Types describe the values a field accepts.
| Type | Kind | Shape | Description |
|---|---|---|---|
Type.Text | text | { kind, flavor? } | String. flavor is "inline" or "rich". |
Type.Number | number | { kind } | Number. |
Type.Boolean | boolean | { kind } | Boolean. |
Type.Date | date | { kind } | Date. |
Type.File | file | { kind, accept? } | File value { fileId, name?, format? }. accept is a MIME glob (image/*, video/*). |
Type.Object | object | { kind, fields } | Nested record. fields is a field list. Holds a value of a shape. |
Type.Array | array | { kind, item } | List. item is any nested type. |
Type.Ref | ref | { kind, refId } | An app schema. |
Type.And | and | { kind, operands } | Intersection. Last operand wins on the same field name. |
Type.Or | or | { kind, operands } | Type-level union (string | string[] | void). No stored discriminator. |
Type.OneOf | oneof | { kind } plus field discriminator / variants | Form toggle-group: named variants, each with fields. Distinct from or. |
Type.Element | element | { kind } | { elementId }. A ref to a node in the tree. |
Type.Component | component | { kind } | { componentId, instanceProps? }. |
Type.Function | function | { kind, params?, returns?, async?, identity? } | A callable. The value is a function call { functionId, instanceParams?, when? }. |
Type.RenderProp | renderprop | { kind, params } | The element's children are the callback body; declared params bind as {{render.<name>}}. Return is rendered, not consumed as a value. |
Type.Void | void | { kind } | Nothing. Only meaningful as a callable's returns. Distinct from omitted returns (undeclared). |
Type.Interface | interface | { kind } | The value is a field list (a shape). Object holds a value of a shape; Interface holds the shape. |