view-contracts 0.3.5 → 0.4.1

package/spec/ui-dsl.schema.json

@@ -113,8 +113,8 @@
     },
     "role": {
       "type": "string",
-      "enum": "role",
       "x-category": "identity",
+      "enum": "role",
       "description": "Accessibility semantics (not HTML tag names)"
     },
     "label": {
@@ -129,60 +129,31 @@
     },
     "enabled": {
       "type": "boolean",
-      "x-category": "state",
-      "x-appliesTo": [
-        "Button",
-        "IconButton",
-        "TextInput",
-        "TextArea",
-        "Select",
-        "Checkbox",
-        "Radio",
-        "Switch"
-      ]
+      "x-category": "state"
     },
     "selected": {
       "type": "boolean",
-      "x-category": "state",
-      "x-appliesTo": [
-        "ListItem"
-      ]
+      "x-category": "state"
     },
     "checked": {
       "type": "boolean",
-      "x-category": "state",
-      "x-appliesTo": [
-        "Checkbox",
-        "Radio",
-        "Switch"
-      ]
+      "x-category": "state"
     },
     "readonly": {
       "type": "boolean",
-      "x-category": "state",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea"
-      ]
+      "x-category": "state"
     },
     "required": {
       "type": "boolean",
-      "x-category": "state",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea",
-        "Select",
-        "Checkbox",
-        "Field"
-      ]
+      "x-category": "state"
     },
     "width": {
       "type": [
         "string",
         "number"
       ],
-      "enum": "widthSize",
       "x-category": "size",
+      "enum": "widthSize",
       "x-notes": "string: wrap|fill; number: fixed px/dp/pt; flex ratio uses weight property"
     },
     "height": {
@@ -190,8 +161,8 @@
         "string",
         "number"
       ],
-      "enum": "heightSize",
       "x-category": "size",
+      "enum": "heightSize",
       "x-notes": "string: wrap|fill; number: fixed px/dp/pt; flex ratio uses weight property"
     },
     "minWidth": {
@@ -220,10 +191,7 @@
     },
     "aspectRatio": {
       "type": "number",
-      "x-category": "size",
-      "x-appliesTo": [
-        "Image"
-      ]
+      "x-category": "size"
     },
     "weight": {
       "type": "number",
@@ -243,72 +211,43 @@
         "string",
         "number"
       ],
-      "x-category": "spacing",
-      "x-appliesTo": [
-        "Row",
-        "Column",
-        "List"
-      ]
+      "x-category": "spacing"
     },
     "align": {
       "type": "string",
-      "enum": "align",
       "x-category": "alignment",
-      "x-appliesTo": [
-        "Row",
-        "Column"
-      ]
+      "enum": "align"
     },
     "justify": {
       "type": "string",
-      "enum": "justify",
       "x-category": "alignment",
-      "x-appliesTo": [
-        "Row",
-        "Column"
-      ]
+      "enum": "justify"
     },
     "selfAlign": {
       "type": "string",
-      "enum": "align",
-      "x-category": "alignment"
+      "x-category": "alignment",
+      "enum": "align"
     },
     "contentAlign": {
       "type": "string",
-      "enum": "contentAlign",
       "x-category": "alignment",
-      "x-appliesTo": [
-        "Box",
-        "Stack"
-      ]
+      "enum": "contentAlign"
     },
     "axis": {
       "type": "string",
-      "enum": "axis",
       "x-category": "direction",
-      "x-appliesTo": [
-        "ScrollArea",
-        "List",
-        "Divider"
-      ]
+      "enum": "axis"
     },
     "direction": {
       "type": "string",
-      "enum": "direction",
       "x-category": "direction",
-      "x-appliesTo": [
-        "App",
-        "Page"
-      ],
+      "enum": "direction",
       "description": "Text/layout direction; set at app or screen root, not per layout container"
     },
     "scroll": {
       "type": "string",
-      "enum": "scroll",
       "x-category": "overflow",
-      "x-appliesTo": [
-        "ScrollArea"
-      ]
+      "enum": "scroll"
     },
     "background": {
       "type": "string",
@@ -318,11 +257,6 @@
     "foreground": {
       "type": "string",
       "x-category": "visual",
-      "x-appliesTo": [
-        "Text",
-        "Icon",
-        "Button"
-      ],
       "x-notes": "color token"
     },
     "border": {
@@ -330,8 +264,8 @@
         "string",
         "object"
       ],
-      "enum": "border",
       "x-category": "visual",
+      "enum": "border",
       "x-notes": "none|token|{width,color}"
     },
     "radius": {
@@ -341,8 +275,8 @@
     },
     "shadow": {
       "type": "string",
-      "enum": "shadow",
-      "x-category": "visual"
+      "x-category": "visual",
+      "enum": "shadow"
     },
     "opacity": {
       "type": "number",
@@ -351,124 +285,75 @@
     },
     "clip": {
       "type": "string",
-      "enum": "clip",
-      "x-category": "visual"
+      "x-category": "visual",
+      "enum": "clip"
     },
     "textStyle": {
       "type": "string",
       "x-category": "text",
-      "x-appliesTo": [
-        "Text",
-        "Heading"
-      ],
       "x-notes": "typography token"
     },
     "textAlign": {
       "type": "string",
-      "enum": "textAlign",
       "x-category": "text",
-      "x-appliesTo": [
-        "Text",
-        "Heading"
-      ]
+      "enum": "textAlign"
     },
     "lineLimit": {
       "type": [
         "string",
         "number"
       ],
-      "enum": "lineLimit",
       "x-category": "text",
-      "x-appliesTo": [
-        "Text"
-      ]
+      "enum": "lineLimit"
     },
     "textOverflow": {
       "type": "string",
-      "enum": "textOverflow",
       "x-category": "text",
-      "x-appliesTo": [
-        "Text"
-      ]
+      "enum": "textOverflow"
     },
     "fontWeight": {
       "type": "string",
-      "enum": "fontWeight",
       "x-category": "text",
-      "x-appliesTo": [
-        "Text"
-      ]
+      "enum": "fontWeight"
     },
-    "headingLevel": {
+    "size": {
       "type": "number",
       "x-category": "text",
-      "x-appliesTo": [
-        "Heading"
-      ],
-      "description": "Semantic heading level (1–6) for h1/h2 mapping and accessibility hierarchy"
+      "x-notes": "Font size shorthand (px/dp/pt)"
     },
     "fit": {
       "type": "string",
-      "enum": "imageFit",
       "x-category": "image",
-      "x-appliesTo": [
-        "Image"
-      ]
+      "enum": "imageFit"
     },
     "src": {
       "type": "string",
       "x-category": "image",
-      "x-appliesTo": [
-        "Image"
-      ],
       "description": "Image source URL or asset reference"
     },
     "alt": {
       "type": "string",
       "x-category": "image",
-      "x-appliesTo": [
-        "Image",
-        "Icon"
-      ],
       "description": "Alternative text; not a source reference"
     },
     "name": {
       "type": "string",
       "x-category": "image",
-      "x-appliesTo": [
-        "Icon"
-      ],
       "description": "Icon token or asset name in the renderer icon set"
     },
     "onClick": {
       "type": "action",
       "x-category": "interaction",
-      "x-appliesTo": [
-        "Button",
-        "IconButton",
-        "Link"
-      ],
       "description": "Action id, not arbitrary code"
     },
     "onSubmit": {
       "type": "action",
       "x-category": "interaction",
-      "x-appliesTo": [
-        "Form"
-      ],
       "description": "Form submit/validation action id"
     },
     "onChange": {
       "type": "action",
-      "x-category": "interaction",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea",
-        "Select",
-        "Checkbox",
-        "Radio",
-        "Switch"
-      ]
+      "x-category": "interaction"
     },
     "focusable": {
       "type": "boolean",
@@ -476,19 +361,12 @@
     },
     "autoFocus": {
       "type": "boolean",
-      "x-category": "interaction",
-      "x-appliesTo": [
-        "Modal",
-        "TextInput"
-      ]
+      "x-category": "interaction"
     },
     "keyboardType": {
       "type": "string",
-      "enum": "keyboardType",
       "x-category": "interaction",
-      "x-appliesTo": [
-        "TextInput"
-      ]
+      "enum": "keyboardType"
     },
     "value": {
       "type": [
@@ -496,43 +374,20 @@
         "number",
         "boolean"
       ],
-      "x-category": "data",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea",
-        "Select",
-        "Radio",
-        "Checkbox",
-        "Switch"
-      ]
+      "x-category": "data"
     },
     "binding": {
       "type": "string",
       "x-category": "data",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea",
-        "Select",
-        "Checkbox",
-        "Radio",
-        "Switch"
-      ],
       "description": "ViewModel or form state field identifier"
     },
     "placeholder": {
       "type": "string",
-      "x-category": "data",
-      "x-appliesTo": [
-        "TextInput",
-        "TextArea"
-      ]
+      "x-category": "data"
     },
     "options": {
       "type": "array",
       "x-category": "data",
-      "x-appliesTo": [
-        "Select"
-      ],
       "x-notes": "array<{value,label}>"
     },
     "error": {
@@ -540,26 +395,14 @@
         "string",
         "null"
       ],
-      "x-category": "validation",
-      "x-appliesTo": [
-        "Field",
-        "TextInput",
-        "TextArea",
-        "Select"
-      ]
+      "x-category": "validation"
     },
     "help": {
       "type": [
         "string",
         "null"
       ],
-      "x-category": "validation",
-      "x-appliesTo": [
-        "Field",
-        "TextInput",
-        "TextArea",
-        "Select"
-      ]
+      "x-category": "validation"
     },
     "variant": {
       "type": "string",
@@ -569,17 +412,33 @@
     "theme": {
       "type": "string",
       "x-category": "visual",
-      "x-appliesTo": [
-        "App"
-      ],
       "x-notes": "active theme id for runtime theme switching"
+    },
+    "flex": {
+      "type": "number",
+      "x-category": "size",
+      "description": "Flex grow ratio for proportional sizing in table columns/cells"
+    },
+    "each": {
+      "type": "string",
+      "x-category": "data",
+      "description": "Iterator variable name for data-bound row repetition"
+    },
+    "source": {
+      "type": "string",
+      "x-category": "data",
+      "description": "ViewModel array binding for data-driven elements"
+    },
+    "headerVisible": {
+      "type": "boolean",
+      "x-category": "state"
     }
   },
   "elements": {
     "App": {
+      "description": "App root; holds theme/token/navigation context",
       "x-tier": "core",
       "x-category": "structure",
-      "description": "App root; holds theme/token/navigation context",
       "x-notes": "Optional; not required for single-screen DSL",
       "properties": {
         "id": {
@@ -606,9 +465,9 @@
       }
     },
     "Page": {
+      "description": "Screen root; viewport and safe-area boundary",
       "x-tier": "core",
       "x-category": "structure",
-      "description": "Screen root; viewport and safe-area boundary",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -637,9 +496,9 @@
       }
     },
     "SafeArea": {
+      "description": "Insets for OS/browser safe areas",
       "x-tier": "core",
       "x-category": "structure",
-      "description": "Insets for OS/browser safe areas",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -661,9 +520,9 @@
       }
     },
     "Box": {
+      "description": "Single region; background, bounds, child placement",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Single region; background, bounds, child placement",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -692,6 +551,12 @@
         "padding": {
           "$ref": "#/properties/padding"
         },
+        "margin": {
+          "$ref": "#/properties/margin"
+        },
+        "gap": {
+          "$ref": "#/properties/gap"
+        },
         "contentAlign": {
           "$ref": "#/properties/contentAlign"
         },
@@ -704,6 +569,9 @@
         "border": {
           "$ref": "#/properties/border"
         },
+        "borderColor": {
+          "$ref": "#/properties/borderColor"
+        },
         "radius": {
           "$ref": "#/properties/radius"
         },
@@ -719,6 +587,15 @@
         "selfAlign": {
           "$ref": "#/properties/selfAlign"
         },
+        "display": {
+          "$ref": "#/properties/display"
+        },
+        "gridTemplateColumns": {
+          "$ref": "#/properties/gridTemplateColumns"
+        },
+        "flexDirection": {
+          "$ref": "#/properties/flexDirection"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         }
@@ -728,9 +605,9 @@
       }
     },
     "Row": {
+      "description": "Horizontal child layout",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Horizontal child layout",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -777,9 +654,9 @@
       }
     },
     "Column": {
+      "description": "Vertical child layout",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Vertical child layout",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -826,9 +703,9 @@
       }
     },
     "Stack": {
+      "description": "Overlay children by z-order (not absolute positioning)",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Overlay children by z-order (not absolute positioning)",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -836,6 +713,9 @@
         "visible": {
           "$ref": "#/properties/visible"
         },
+        "gap": {
+          "$ref": "#/properties/gap"
+        },
         "contentAlign": {
           "$ref": "#/properties/contentAlign"
         },
@@ -860,9 +740,9 @@
       }
     },
     "Spacer": {
+      "description": "Occupies remaining flex space",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Occupies remaining flex space",
       "x-notes": "Direct child of Row/Column only",
       "properties": {
         "id": {
@@ -886,9 +766,9 @@
       }
     },
     "Divider": {
+      "description": "Horizontal or vertical separator",
       "x-tier": "core",
       "x-category": "layout",
-      "description": "Horizontal or vertical separator",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -905,9 +785,9 @@
       }
     },
     "ScrollArea": {
+      "description": "Internal scroll boundary",
       "x-tier": "core",
       "x-category": "scroll",
-      "description": "Internal scroll boundary",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -942,9 +822,9 @@
       }
     },
     "List": {
+      "description": "Homogeneous list of items",
       "x-tier": "core",
       "x-category": "scroll",
-      "description": "Homogeneous list of items",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -973,9 +853,9 @@
       }
     },
     "ListItem": {
+      "description": "One row/cell in a list",
       "x-tier": "core",
       "x-category": "scroll",
-      "description": "One row/cell in a list",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1004,9 +884,9 @@
       }
     },
     "Text": {
+      "description": "Text display",
       "x-tier": "core",
       "x-category": "text",
-      "description": "Text display",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1029,45 +909,32 @@
         "fontWeight": {
           "$ref": "#/properties/fontWeight"
         },
+        "fontSize": {
+          "$ref": "#/properties/fontSize"
+        },
+        "size": {
+          "$ref": "#/properties/size"
+        },
         "foreground": {
           "$ref": "#/properties/foreground"
         },
+        "background": {
+          "$ref": "#/properties/background"
+        },
         "opacity": {
           "$ref": "#/properties/opacity"
         },
-        "role": {
-          "$ref": "#/properties/role"
-        },
-        "variant": {
-          "$ref": "#/properties/variant"
-        }
-      },
-      "_children": {
-        "x-kind": "text"
-      }
-    },
-    "Heading": {
-      "x-tier": "core",
-      "x-category": "text",
-      "description": "Heading text; visual style via textStyle, semantic level via headingLevel",
-      "properties": {
-        "id": {
-          "$ref": "#/properties/id"
-        },
-        "visible": {
-          "$ref": "#/properties/visible"
-        },
-        "headingLevel": {
-          "$ref": "#/properties/headingLevel"
+        "padding": {
+          "$ref": "#/properties/padding"
         },
-        "textStyle": {
-          "$ref": "#/properties/textStyle"
+        "radius": {
+          "$ref": "#/properties/radius"
         },
-        "textAlign": {
-          "$ref": "#/properties/textAlign"
+        "display": {
+          "$ref": "#/properties/display"
         },
-        "foreground": {
-          "$ref": "#/properties/foreground"
+        "alignItems": {
+          "$ref": "#/properties/alignItems"
         },
         "role": {
           "$ref": "#/properties/role"
@@ -1081,9 +948,9 @@
       }
     },
     "Link": {
+      "description": "Navigable text or region",
       "x-tier": "optional",
       "x-category": "text",
-      "description": "Navigable text or region",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1112,9 +979,9 @@
       }
     },
     "Image": {
+      "description": "Image display",
       "x-tier": "core",
       "x-category": "media",
-      "description": "Image display",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1152,9 +1019,9 @@
       }
     },
     "Icon": {
+      "description": "Icon display; asset set referenced by name token at renderer",
       "x-tier": "core",
       "x-category": "media",
-      "description": "Icon display; asset set referenced by name token at renderer",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1183,9 +1050,9 @@
       }
     },
     "Button": {
+      "description": "Pressable action; label or children required (label is a11y name when both present)",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Pressable action; label or children required (label is a11y name when both present)",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1208,6 +1075,24 @@
         "background": {
           "$ref": "#/properties/background"
         },
+        "radius": {
+          "$ref": "#/properties/radius"
+        },
+        "padding": {
+          "$ref": "#/properties/padding"
+        },
+        "shadow": {
+          "$ref": "#/properties/shadow"
+        },
+        "border": {
+          "$ref": "#/properties/border"
+        },
+        "borderColor": {
+          "$ref": "#/properties/borderColor"
+        },
+        "fontWeight": {
+          "$ref": "#/properties/fontWeight"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         },
@@ -1225,9 +1110,9 @@
       }
     },
     "IconButton": {
+      "description": "Icon-primary button; label required for accessibility",
       "x-tier": "optional",
       "x-category": "input",
-      "description": "Icon-primary button; label required for accessibility",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1244,6 +1129,18 @@
         "label": {
           "$ref": "#/properties/label"
         },
+        "foreground": {
+          "$ref": "#/properties/foreground"
+        },
+        "background": {
+          "$ref": "#/properties/background"
+        },
+        "radius": {
+          "$ref": "#/properties/radius"
+        },
+        "padding": {
+          "$ref": "#/properties/padding"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         }
@@ -1256,9 +1153,9 @@
       }
     },
     "TextInput": {
+      "description": "Single-line text input",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Single-line text input",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1308,6 +1205,27 @@
         "label": {
           "$ref": "#/properties/label"
         },
+        "foreground": {
+          "$ref": "#/properties/foreground"
+        },
+        "background": {
+          "$ref": "#/properties/background"
+        },
+        "radius": {
+          "$ref": "#/properties/radius"
+        },
+        "padding": {
+          "$ref": "#/properties/padding"
+        },
+        "border": {
+          "$ref": "#/properties/border"
+        },
+        "borderColor": {
+          "$ref": "#/properties/borderColor"
+        },
+        "minHeight": {
+          "$ref": "#/properties/minHeight"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         }
@@ -1317,9 +1235,9 @@
       }
     },
     "TextArea": {
+      "description": "Multi-line text input",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Multi-line text input",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1363,6 +1281,24 @@
         "label": {
           "$ref": "#/properties/label"
         },
+        "foreground": {
+          "$ref": "#/properties/foreground"
+        },
+        "background": {
+          "$ref": "#/properties/background"
+        },
+        "radius": {
+          "$ref": "#/properties/radius"
+        },
+        "padding": {
+          "$ref": "#/properties/padding"
+        },
+        "border": {
+          "$ref": "#/properties/border"
+        },
+        "borderColor": {
+          "$ref": "#/properties/borderColor"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         }
@@ -1372,9 +1308,9 @@
       }
     },
     "Select": {
+      "description": "Single selection",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Single selection",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1412,6 +1348,27 @@
         "label": {
           "$ref": "#/properties/label"
         },
+        "foreground": {
+          "$ref": "#/properties/foreground"
+        },
+        "background": {
+          "$ref": "#/properties/background"
+        },
+        "radius": {
+          "$ref": "#/properties/radius"
+        },
+        "padding": {
+          "$ref": "#/properties/padding"
+        },
+        "border": {
+          "$ref": "#/properties/border"
+        },
+        "borderColor": {
+          "$ref": "#/properties/borderColor"
+        },
+        "minHeight": {
+          "$ref": "#/properties/minHeight"
+        },
         "variant": {
           "$ref": "#/properties/variant"
         }
@@ -1421,9 +1378,9 @@
       }
     },
     "Checkbox": {
+      "description": "Boolean or multi-select toggle",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Boolean or multi-select toggle",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1458,9 +1415,9 @@
       }
     },
     "Radio": {
+      "description": "Single choice in a group (use Row/Column to group; binding identifies group)",
       "x-tier": "core",
       "x-category": "input",
-      "description": "Single choice in a group (use Row/Column to group; binding identifies group)",
       "x-notes": "RadioGroup is expressed via layout Group, not a separate element",
       "properties": {
         "id": {
@@ -1496,9 +1453,9 @@
       }
     },
     "Switch": {
+      "description": "On/off toggle",
       "x-tier": "core",
       "x-category": "input",
-      "description": "On/off toggle",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1530,9 +1487,9 @@
       }
     },
     "Form": {
+      "description": "Input group submit/validation boundary",
       "x-tier": "core",
       "x-category": "form",
-      "description": "Input group submit/validation boundary",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1555,9 +1512,9 @@
       }
     },
     "Field": {
+      "description": "label/help/error/input unit",
       "x-tier": "core",
       "x-category": "form",
-      "description": "label/help/error/input unit",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1589,9 +1546,9 @@
       }
     },
     "Modal": {
+      "description": "Primary transient dialog",
       "x-tier": "core",
       "x-category": "overlay",
-      "description": "Primary transient dialog",
       "x-notes": "Direct child of Page or App; role defaults to dialog at renderer",
       "properties": {
         "id": {
@@ -1619,9 +1576,9 @@
       }
     },
     "Drawer": {
+      "description": "Edge panel overlay",
       "x-tier": "extension",
       "x-category": "overlay",
-      "description": "Edge panel overlay",
       "x-notes": "Placement limited to start/end/bottom at renderer",
       "properties": {
         "id": {
@@ -1643,9 +1600,9 @@
       }
     },
     "Popover": {
+      "description": "Small anchored panel",
       "x-tier": "extension",
       "x-category": "overlay",
-      "description": "Small anchored panel",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1666,9 +1623,9 @@
       }
     },
     "Tooltip": {
+      "description": "Supplementary description",
       "x-tier": "extension",
       "x-category": "overlay",
-      "description": "Supplementary description",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1688,9 +1645,9 @@
       }
     },
     "Progress": {
+      "description": "Determinate progress",
       "x-tier": "core",
       "x-category": "feedback",
-      "description": "Determinate progress",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1710,9 +1667,9 @@
       }
     },
     "Spinner": {
+      "description": "Indeterminate loading",
       "x-tier": "core",
       "x-category": "feedback",
-      "description": "Indeterminate loading",
       "properties": {
         "id": {
           "$ref": "#/properties/id"
@@ -1727,6 +1684,123 @@
       "_children": {
         "x-kind": "none"
       }
+    },
+    "Table": {
+      "description": "Data table with header and repeated rows",
+      "x-tier": "core",
+      "x-category": "data",
+      "properties": {
+        "id": {
+          "$ref": "#/properties/id"
+        },
+        "visible": {
+          "$ref": "#/properties/visible"
+        },
+        "source": {
+          "$ref": "#/properties/source"
+        },
+        "gap": {
+          "$ref": "#/properties/gap"
+        },
+        "variant": {
+          "$ref": "#/properties/variant"
+        }
+      },
+      "_children": {
+        "x-kind": "list",
+        "x-items": [
+          "TableHeader",
+          "TableRow"
+        ]
+      }
+    },
+    "TableHeader": {
+      "description": "Table header row defining column labels",
+      "x-tier": "core",
+      "x-category": "data",
+      "properties": {
+        "height": {
+          "$ref": "#/properties/height"
+        },
+        "variant": {
+          "$ref": "#/properties/variant"
+        }
+      },
+      "_children": {
+        "x-kind": "list",
+        "x-items": [
+          "TableColumn"
+        ]
+      }
+    },
+    "TableColumn": {
+      "description": "Header cell definition; children override label text",
+      "x-tier": "core",
+      "x-category": "data",
+      "properties": {
+        "label": {
+          "$ref": "#/properties/label"
+        },
+        "width": {
+          "$ref": "#/properties/width"
+        },
+        "flex": {
+          "$ref": "#/properties/flex"
+        },
+        "align": {
+          "$ref": "#/properties/align"
+        },
+        "variant": {
+          "$ref": "#/properties/variant"
+        }
+      },
+      "_children": {
+        "x-kind": "any"
+      }
+    },
+    "TableRow": {
+      "description": "Row template repeated for each source item",
+      "x-tier": "core",
+      "x-category": "data",
+      "properties": {
+        "each": {
+          "$ref": "#/properties/each"
+        },
+        "height": {
+          "$ref": "#/properties/height"
+        },
+        "variant": {
+          "$ref": "#/properties/variant"
+        }
+      },
+      "_children": {
+        "x-kind": "list",
+        "x-items": [
+          "TableCell"
+        ]
+      }
+    },
+    "TableCell": {
+      "description": "Data cell; children define cell content",
+      "x-tier": "core",
+      "x-category": "data",
+      "properties": {
+        "width": {
+          "$ref": "#/properties/width"
+        },
+        "flex": {
+          "$ref": "#/properties/flex"
+        },
+        "align": {
+          "$ref": "#/properties/align"
+        },
+        "variant": {
+          "$ref": "#/properties/variant"
+        }
+      },
+      "_children": {
+        "x-kind": "any"
+      }
     }
   }
 }