Common
Shared constrained identifiers, values, units, bounds, provenance and extension payloads.
Raw schema: /schema/1.0/modules/common.schema.json
id
Stable document-wide identifier; references resolve locally, never through network execution.
type: string
No object properties on this definition.
taxonomy
Open taxonomy. Standard terms and namespaced vendor terms are accepted.
type: string
No object properties on this definition.
uri
type: string
No object properties on this definition.
time
type: number | string | object
No object properties on this definition.
duration
type: number | string | object
No object properties on this definition.
delay
type: number | string | object
No object properties on this definition.
dimension
type: number | string | object | tokenRef
No object properties on this definition.
size
type: number | string | "auto" | "fill" | "hug" | "min-content" | "max-content" | tokenRef
No object properties on this definition.
tokenRef
type: string
No object properties on this definition.
jsonValue
type: string | number | boolean | null | array<jsonValue> | object
No object properties on this definition.
extensions
Only namespaced extension keys are allowed. Unknown optional extensions may be retained without interpretation.
type: object
No object properties on this definition.
provenance
type: object · required: method
| Property | Type | Required | Constraints |
|---|---|---|---|
sourceRef | id | no | — |
method | "explicit" | "measured" | "extracted" | "inferred" | "generated" | "defaulted" | "platform-derived" | "vision-inference" | "reference-derived" | yes | — |
tool | string | no | minLength 1 |
agent | string | no | minLength 1 |
timestamp | string | no | — |
notes | string | no | minLength 1 |
evidence
type: object · required: status
| Property | Type | Required | Constraints |
|---|---|---|---|
status | "explicit" | "measured" | "extracted" | "inferred" | "generated" | "defaulted" | "platform-derived" | "unknown" | yes | — |
confidence | number | no | min 0 · max 1 |
provenance | provenance | no | — |
vector2
type: object · required: x, y
| Property | Type | Required | Constraints |
|---|---|---|---|
x | number | yes | — |
y | number | yes | — |
vector3
type: object · required: x, y, z
| Property | Type | Required | Constraints |
|---|---|---|---|
x | number | yes | — |
y | number | yes | — |
z | number | yes | — |
quaternion
type: object · required: x, y, z, w
| Property | Type | Required | Constraints |
|---|---|---|---|
x | number | yes | min -1 · max 1 |
y | number | yes | min -1 · max 1 |
z | number | yes | min -1 · max 1 |
w | number | yes | min -1 · max 1 |
bounds
type: object · required: x, y, width, height
| Property | Type | Required | Constraints |
|---|---|---|---|
x | number | yes | — |
y | number | yes | — |
z | number | no | — |
width | number | yes | min 0 |
height | number | yes | min 0 |
depth | number | no | min 0 |
coordinateSpace | coordinateSpace | no | — |
coordinateSpace
type: "absolute" | "normalized" | "local" | "parent" | "viewport" | "world" | "camera" | "screen" | "document"
No object properties on this definition.
viewport
type: object · required: width, height
| Property | Type | Required | Constraints |
|---|---|---|---|
width | number | yes | min 0 |
height | number | yes | min 0 |
pixelRatio | number | no | > 0 |
orientation | "portrait" | "landscape" | no | — |
condition
Declarative visual conditions only; no executable expressions or gameplay logic.
type: object
| Property | Type | Required | Constraints |
|---|---|---|---|
stateRef | id | no | — |
eventRef | id | no | — |
capability | taxonomy | no | — |
equals | string | number | boolean | no | minLength 1 |
not | boolean | no | — |
all | array<condition> | no | minItems 1 |
any | array<condition> | no | minItems 1 |
metadata
type: object · required: title
| Property | Type | Required | Constraints |
|---|---|---|---|
id | id | no | — |
title | string | yes | minLength 1 |
description | string | no | minLength 1 |
version | string | no | minLength 1 |
language | string | no | pattern ^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$ |
authors | array<object> | no | — |
license | string | no | minLength 1 |
created | string | no | — |
modified | string | no | — |
tags | array<string> | no | minLength 1 |
status | "draft" | "review" | "approved" | "deprecated" | no | — |
links | object | no | — |
extensions | extensions | no | — |