aeon-ui-engine 1.0.3 → 1.1.0

package/packages/schemas/json/catalog.json

@@ -0,0 +1,2299 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/catalog.json",
+  "title": "Aeon UI Component Catalog",
+  "description": "Machine-legible index of Aeon UI components. Prefer these schemas over inventing props, states, or boolean UI flags.",
+  "version": "0.1.0",
+  "principle": "UI = f(state)",
+  "attributes": [
+    "data-aeon-scope",
+    "data-aeon-part",
+    "data-aeon-state"
+  ],
+  "components": [
+    "button",
+    "async",
+    "field",
+    "dialog",
+    "switch",
+    "checkbox",
+    "tabs",
+    "accordion",
+    "popover",
+    "menu",
+    "select",
+    "combobox",
+    "tooltip",
+    "toast",
+    "scroll",
+    "progress"
+  ],
+  "schemas": {
+    "button": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/button.json",
+      "title": "Button",
+      "description": "Action control. status is a prop projection (not an in-tree machine). Never invent parallel useState for lifecycle.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Button"
+        },
+        "scope": {
+          "const": "button"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "group",
+              "label",
+              "icon"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "pending",
+              "success",
+              "failure",
+              "disabled"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "type": "string",
+              "enum": [
+                "idle",
+                "pending",
+                "success",
+                "failure",
+                "disabled"
+              ],
+              "default": "idle"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "solid",
+                "outline",
+                "ghost",
+                "link"
+              ]
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ]
+            },
+            "disabled": {
+              "type": "boolean"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "button.root",
+              "description": "button.root"
+            },
+            "Group": {
+              "const": "button.group",
+              "description": "button.group"
+            },
+            "Label": {
+              "const": "button.label",
+              "description": "button.label"
+            },
+            "Icon": {
+              "const": "button.icon",
+              "description": "button.icon"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "buttonLifecycleMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "status prop"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [
+            "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+            "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
+          ]
+        }
+      },
+      "x-aeon": {
+        "scope": "button",
+        "parts": [
+          "root",
+          "group",
+          "label",
+          "icon"
+        ],
+        "states": [
+          "idle",
+          "pending",
+          "success",
+          "failure",
+          "disabled"
+        ],
+        "machine": "buttonLifecycleMachine",
+        "runtime": "status prop",
+        "events": [],
+        "slots": {
+          "Root": "button.root",
+          "Group": "button.group",
+          "Label": "button.label",
+          "Icon": "button.icon"
+        },
+        "examples": [
+          "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+          "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
+        ]
+      }
+    },
+    "async": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/async.json",
+      "title": "Async",
+      "description": "Fetch region with full lifecycle totality: idle → loading → success|empty|failure. Always render every stable state in demos.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Async"
+        },
+        "scope": {
+          "const": "async"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "track",
+              "segment",
+              "readout",
+              "readoutRail",
+              "readoutBody",
+              "actions"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "loading",
+              "success",
+              "empty",
+              "failure"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "async.root",
+              "description": "async.root"
+            },
+            "Track": {
+              "const": "async.track",
+              "description": "async.track"
+            },
+            "Segment": {
+              "const": "async.segment",
+              "description": "async.segment"
+            },
+            "Readout": {
+              "const": "async.readout",
+              "description": "async.readout"
+            },
+            "Actions": {
+              "const": "async.actions",
+              "description": "async.actions"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "createAsyncMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "FETCH",
+              "RESOLVE",
+              "REJECT",
+              "RESET",
+              "STALE",
+              "REFRESH"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [
+            "<Async.Root>\n  {/* Content faces via asyncStatusToContentState — not Track */}\n  <Async.Actions />\n</Async.Root>"
+          ]
+        }
+      },
+      "x-aeon": {
+        "scope": "async",
+        "parts": [
+          "root",
+          "track",
+          "segment",
+          "readout",
+          "readoutRail",
+          "readoutBody",
+          "actions"
+        ],
+        "states": [
+          "idle",
+          "loading",
+          "success",
+          "empty",
+          "failure"
+        ],
+        "machine": "createAsyncMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "FETCH",
+          "RESOLVE",
+          "REJECT",
+          "RESET",
+          "STALE",
+          "REFRESH"
+        ],
+        "slots": {
+          "Root": "async.root",
+          "Track": "async.track",
+          "Segment": "async.segment",
+          "Readout": "async.readout",
+          "Actions": "async.actions"
+        },
+        "examples": [
+          "<Async.Root>\n  {/* Content faces via asyncStatusToContentState — not Track */}\n  <Async.Actions />\n</Async.Root>"
+        ]
+      }
+    },
+    "field": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/field.json",
+      "title": "Field",
+      "description": "Parallel regions: interaction × validation × submission. Do not collapse into a single error boolean.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Field"
+        },
+        "scope": {
+          "const": "field"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "label",
+              "control",
+              "textarea",
+              "message",
+              "hint"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "pristine",
+              "dirty",
+              "valid",
+              "invalid",
+              "idle",
+              "pending",
+              "interaction.pristine",
+              "interaction.dirty",
+              "validation.valid",
+              "validation.invalid",
+              "submission.idle",
+              "submission.pending"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "field.root",
+              "description": "field.root"
+            },
+            "Label": {
+              "const": "field.label",
+              "description": "field.label"
+            },
+            "Control": {
+              "const": "field.control",
+              "description": "field.control"
+            },
+            "Message": {
+              "const": "field.message",
+              "description": "field.message"
+            },
+            "Hint": {
+              "const": "field.hint",
+              "description": "field.hint"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "fieldMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "INPUT",
+              "BLUR",
+              "VALIDATE",
+              "SUBMIT",
+              "SUBMIT_DONE",
+              "SUBMIT_FAIL",
+              "RESET"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "field",
+        "parts": [
+          "root",
+          "label",
+          "control",
+          "textarea",
+          "message",
+          "hint"
+        ],
+        "states": [
+          "pristine",
+          "dirty",
+          "valid",
+          "invalid",
+          "idle",
+          "pending",
+          "interaction.pristine",
+          "interaction.dirty",
+          "validation.valid",
+          "validation.invalid",
+          "submission.idle",
+          "submission.pending"
+        ],
+        "machine": "fieldMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "INPUT",
+          "BLUR",
+          "VALIDATE",
+          "SUBMIT",
+          "SUBMIT_DONE",
+          "SUBMIT_FAIL",
+          "RESET"
+        ],
+        "slots": {
+          "Root": "field.root",
+          "Label": "field.label",
+          "Control": "field.control",
+          "Message": "field.message",
+          "Hint": "field.hint"
+        },
+        "examples": []
+      }
+    },
+    "dialog": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/dialog.json",
+      "title": "Dialog",
+      "description": "Modal open/closed via dialogMachine. Dismissal is a transition, not ad hoc flags.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Dialog"
+        },
+        "scope": {
+          "const": "dialog"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "trigger",
+              "portal",
+              "backdrop",
+              "positioner",
+              "content",
+              "title",
+              "description",
+              "closeTrigger"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "dialog.root",
+              "description": "dialog.root"
+            },
+            "Trigger": {
+              "const": "dialog.trigger",
+              "description": "dialog.trigger"
+            },
+            "Content": {
+              "const": "dialog.content",
+              "description": "dialog.content"
+            },
+            "Title": {
+              "const": "dialog.title",
+              "description": "dialog.title"
+            },
+            "Description": {
+              "const": "dialog.description",
+              "description": "dialog.description"
+            },
+            "CloseTrigger": {
+              "const": "dialog.closeTrigger",
+              "description": "dialog.closeTrigger"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "dialogMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "dialog",
+        "parts": [
+          "root",
+          "trigger",
+          "portal",
+          "backdrop",
+          "positioner",
+          "content",
+          "title",
+          "description",
+          "closeTrigger"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": "dialogMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "dialog.root",
+          "Trigger": "dialog.trigger",
+          "Content": "dialog.content",
+          "Title": "dialog.title",
+          "Description": "dialog.description",
+          "CloseTrigger": "dialog.closeTrigger"
+        },
+        "examples": []
+      }
+    },
+    "switch": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/switch.json",
+      "title": "Switch",
+      "description": "Binary toggle via toggleMachine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Switch"
+        },
+        "scope": {
+          "const": "switch"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "control",
+              "thumb",
+              "label",
+              "hiddenInput"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "checked",
+              "unchecked"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "switch.root",
+              "description": "switch.root"
+            },
+            "Control": {
+              "const": "switch.control",
+              "description": "switch.control"
+            },
+            "Thumb": {
+              "const": "switch.thumb",
+              "description": "switch.thumb"
+            },
+            "Label": {
+              "const": "switch.label",
+              "description": "switch.label"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "toggleMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "TOGGLE",
+              "CHECK",
+              "UNCHECK"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "switch",
+        "parts": [
+          "root",
+          "control",
+          "thumb",
+          "label",
+          "hiddenInput"
+        ],
+        "states": [
+          "checked",
+          "unchecked"
+        ],
+        "machine": "toggleMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "TOGGLE",
+          "CHECK",
+          "UNCHECK"
+        ],
+        "slots": {
+          "Root": "switch.root",
+          "Control": "switch.control",
+          "Thumb": "switch.thumb",
+          "Label": "switch.label"
+        },
+        "examples": []
+      }
+    },
+    "checkbox": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/checkbox.json",
+      "title": "Checkbox",
+      "description": "Binary toggle via toggleMachine (same chart family as Switch).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Checkbox"
+        },
+        "scope": {
+          "const": "checkbox"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "control",
+              "indicator",
+              "label",
+              "hiddenInput"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "checked",
+              "unchecked"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "checkbox.root",
+              "description": "checkbox.root"
+            },
+            "Control": {
+              "const": "checkbox.control",
+              "description": "checkbox.control"
+            },
+            "Indicator": {
+              "const": "checkbox.indicator",
+              "description": "checkbox.indicator"
+            },
+            "Label": {
+              "const": "checkbox.label",
+              "description": "checkbox.label"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "toggleMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "TOGGLE",
+              "CHECK",
+              "UNCHECK"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "checkbox",
+        "parts": [
+          "root",
+          "control",
+          "indicator",
+          "label",
+          "hiddenInput"
+        ],
+        "states": [
+          "checked",
+          "unchecked"
+        ],
+        "machine": "toggleMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "TOGGLE",
+          "CHECK",
+          "UNCHECK"
+        ],
+        "slots": {
+          "Root": "checkbox.root",
+          "Control": "checkbox.control",
+          "Indicator": "checkbox.indicator",
+          "Label": "checkbox.label"
+        },
+        "examples": []
+      }
+    },
+    "tabs": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/tabs.json",
+      "title": "Tabs",
+      "description": "Selected tab value from tabsMachine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Tabs"
+        },
+        "scope": {
+          "const": "tabs"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "list",
+              "trigger",
+              "content",
+              "indicator"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "selected"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "value": {
+              "type": "string",
+              "description": "Selected tab id — becomes data-aeon-state"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "tabs.root",
+              "description": "tabs.root"
+            },
+            "List": {
+              "const": "tabs.list",
+              "description": "tabs.list"
+            },
+            "Trigger": {
+              "const": "tabs.trigger",
+              "description": "tabs.trigger"
+            },
+            "Content": {
+              "const": "tabs.content",
+              "description": "tabs.content"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "tabsMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "SELECT"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "tabs",
+        "parts": [
+          "root",
+          "list",
+          "trigger",
+          "content",
+          "indicator"
+        ],
+        "states": [
+          "selected"
+        ],
+        "machine": "tabsMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SELECT"
+        ],
+        "slots": {
+          "Root": "tabs.root",
+          "List": "tabs.list",
+          "Trigger": "tabs.trigger",
+          "Content": "tabs.content"
+        },
+        "examples": []
+      }
+    },
+    "accordion": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/accordion.json",
+      "title": "Accordion",
+      "description": "Per-item open state via accordionMachine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Accordion"
+        },
+        "scope": {
+          "const": "accordion"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "item",
+              "itemTrigger",
+              "itemContent",
+              "itemIndicator"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "accordion.root",
+              "description": "accordion.root"
+            },
+            "Item": {
+              "const": "accordion.item",
+              "description": "accordion.item"
+            },
+            "ItemTrigger": {
+              "const": "accordion.itemTrigger",
+              "description": "accordion.itemTrigger"
+            },
+            "ItemContent": {
+              "const": "accordion.itemContent",
+              "description": "accordion.itemContent"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "accordionMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "accordion",
+        "parts": [
+          "root",
+          "item",
+          "itemTrigger",
+          "itemContent",
+          "itemIndicator"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": "accordionMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "accordion.root",
+          "Item": "accordion.item",
+          "ItemTrigger": "accordion.itemTrigger",
+          "ItemContent": "accordion.itemContent"
+        },
+        "examples": []
+      }
+    },
+    "popover": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/popover.json",
+      "title": "Popover",
+      "description": "Floating surface — shares popoverMachine. Do not fork a duplicate open/closed chart.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Popover"
+        },
+        "scope": {
+          "const": "popover"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "trigger",
+              "positioner",
+              "content",
+              "arrow",
+              "closeTrigger"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "popover.root",
+              "description": "popover.root"
+            },
+            "Trigger": {
+              "const": "popover.trigger",
+              "description": "popover.trigger"
+            },
+            "Content": {
+              "const": "popover.content",
+              "description": "popover.content"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "popoverMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "popover",
+        "parts": [
+          "root",
+          "trigger",
+          "positioner",
+          "content",
+          "arrow",
+          "closeTrigger"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": "popoverMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "popover.root",
+          "Trigger": "popover.trigger",
+          "Content": "popover.content"
+        },
+        "examples": []
+      }
+    },
+    "menu": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/menu.json",
+      "title": "Menu",
+      "description": "Shares popoverMachine with Popover/Select open state.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Menu"
+        },
+        "scope": {
+          "const": "menu"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "trigger",
+              "positioner",
+              "content",
+              "item",
+              "separator"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "menu.root",
+              "description": "menu.root"
+            },
+            "Trigger": {
+              "const": "menu.trigger",
+              "description": "menu.trigger"
+            },
+            "Content": {
+              "const": "menu.content",
+              "description": "menu.content"
+            },
+            "Item": {
+              "const": "menu.item",
+              "description": "menu.item"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "popoverMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "menu",
+        "parts": [
+          "root",
+          "trigger",
+          "positioner",
+          "content",
+          "item",
+          "separator"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": "popoverMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "menu.root",
+          "Trigger": "menu.trigger",
+          "Content": "menu.content",
+          "Item": "menu.item"
+        },
+        "examples": []
+      }
+    },
+    "select": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/select.json",
+      "title": "Select",
+      "description": "Open/closed via popoverMachine; highlight may be React-local. Do not invent a new open machine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Select"
+        },
+        "scope": {
+          "const": "select"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "trigger",
+              "value",
+              "icon",
+              "positioner",
+              "content",
+              "item"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "select.root",
+              "description": "select.root"
+            },
+            "Trigger": {
+              "const": "select.trigger",
+              "description": "select.trigger"
+            },
+            "Content": {
+              "const": "select.content",
+              "description": "select.content"
+            },
+            "Item": {
+              "const": "select.item",
+              "description": "select.item"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "popoverMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "select",
+        "parts": [
+          "root",
+          "trigger",
+          "value",
+          "icon",
+          "positioner",
+          "content",
+          "item"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": "popoverMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "select.root",
+          "Trigger": "select.trigger",
+          "Content": "select.content",
+          "Item": "select.item"
+        },
+        "examples": []
+      }
+    },
+    "combobox": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/combobox.json",
+      "title": "Combobox",
+      "description": "Typeahead — React useState for open/query/highlight today. Do not add a duplicate floating machine without COMPONENT_CHECKLIST.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Combobox"
+        },
+        "scope": {
+          "const": "combobox"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "input",
+              "icon",
+              "content",
+              "item",
+              "empty"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "combobox.root",
+              "description": "combobox.root"
+            },
+            "Input": {
+              "const": "combobox.input",
+              "description": "combobox.input"
+            },
+            "Content": {
+              "const": "combobox.content",
+              "description": "combobox.content"
+            },
+            "Item": {
+              "const": "combobox.item",
+              "description": "combobox.item"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": null
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useState"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "combobox",
+        "parts": [
+          "root",
+          "input",
+          "icon",
+          "content",
+          "item",
+          "empty"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": null,
+        "runtime": "useState",
+        "events": [],
+        "slots": {
+          "Root": "combobox.root",
+          "Input": "combobox.input",
+          "Content": "combobox.content",
+          "Item": "combobox.item"
+        },
+        "examples": []
+      }
+    },
+    "tooltip": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/tooltip.json",
+      "title": "Tooltip",
+      "description": "Open via React useState. Touch tap toggles.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Tooltip"
+        },
+        "scope": {
+          "const": "tooltip"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "trigger",
+              "positioner",
+              "content",
+              "arrow"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "tooltip.root",
+              "description": "tooltip.root"
+            },
+            "Trigger": {
+              "const": "tooltip.trigger",
+              "description": "tooltip.trigger"
+            },
+            "Content": {
+              "const": "tooltip.content",
+              "description": "tooltip.content"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": null
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useState"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "tooltip",
+        "parts": [
+          "root",
+          "trigger",
+          "positioner",
+          "content",
+          "arrow"
+        ],
+        "states": [
+          "open",
+          "closed"
+        ],
+        "machine": null,
+        "runtime": "useState",
+        "events": [],
+        "slots": {
+          "Root": "tooltip.root",
+          "Trigger": "tooltip.trigger",
+          "Content": "tooltip.content"
+        },
+        "examples": []
+      }
+    },
+    "toast": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/toast.json",
+      "title": "Toast",
+      "description": "Per-item visibility via toastMachine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Toast"
+        },
+        "scope": {
+          "const": "toast"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "viewport",
+              "root",
+              "title",
+              "description",
+              "closeTrigger"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "visible",
+              "hidden"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Provider": {
+              "const": "toast.provider",
+              "description": "toast.provider"
+            },
+            "Viewport": {
+              "const": "toast.viewport",
+              "description": "toast.viewport"
+            },
+            "Root": {
+              "const": "toast.root",
+              "description": "toast.root"
+            },
+            "Title": {
+              "const": "toast.title",
+              "description": "toast.title"
+            },
+            "Description": {
+              "const": "toast.description",
+              "description": "toast.description"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "toastMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "SHOW",
+              "HIDE",
+              "DISMISS"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "toast",
+        "parts": [
+          "viewport",
+          "root",
+          "title",
+          "description",
+          "closeTrigger"
+        ],
+        "states": [
+          "visible",
+          "hidden"
+        ],
+        "machine": "toastMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SHOW",
+          "HIDE",
+          "DISMISS"
+        ],
+        "slots": {
+          "Provider": "toast.provider",
+          "Viewport": "toast.viewport",
+          "Root": "toast.root",
+          "Title": "toast.title",
+          "Description": "toast.description"
+        },
+        "examples": []
+      }
+    },
+    "scroll": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/scroll.json",
+      "title": "Scroll",
+      "description": "Derived overflow/edge snapshot via getScrollSnapshot() — no XState machine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Scroll"
+        },
+        "scope": {
+          "const": "scroll"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "viewport",
+              "content"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "start",
+              "middle",
+              "end",
+              "overflow-x",
+              "overflow-y",
+              "overflow-both"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "scroll.root",
+              "description": "scroll.root"
+            },
+            "Viewport": {
+              "const": "scroll.viewport",
+              "description": "scroll.viewport"
+            },
+            "Content": {
+              "const": "scroll.content",
+              "description": "scroll.content"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": null
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "getScrollSnapshot"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "scroll",
+        "parts": [
+          "root",
+          "viewport",
+          "content"
+        ],
+        "states": [
+          "idle",
+          "start",
+          "middle",
+          "end",
+          "overflow-x",
+          "overflow-y",
+          "overflow-both"
+        ],
+        "machine": null,
+        "runtime": "getScrollSnapshot",
+        "events": [],
+        "slots": {
+          "Root": "scroll.root",
+          "Viewport": "scroll.viewport",
+          "Content": "scroll.content"
+        },
+        "examples": []
+      }
+    },
+    "progress": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/progress.json",
+      "title": "Progress",
+      "description": "Prop-driven progress: value + indeterminate → idle | loading | complete.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Progress"
+        },
+        "scope": {
+          "const": "progress"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "track",
+              "range",
+              "label"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "loading",
+              "complete"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "value": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "indeterminate": {
+              "type": "boolean"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "progress.root",
+              "description": "progress.root"
+            },
+            "Track": {
+              "const": "progress.track",
+              "description": "progress.track"
+            },
+            "Range": {
+              "const": "progress.range",
+              "description": "progress.range"
+            },
+            "Label": {
+              "const": "progress.label",
+              "description": "progress.label"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": null
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "props"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "progress",
+        "parts": [
+          "root",
+          "track",
+          "range",
+          "label"
+        ],
+        "states": [
+          "idle",
+          "loading",
+          "complete"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "progress.root",
+          "Track": "progress.track",
+          "Range": "progress.range",
+          "Label": "progress.label"
+        },
+        "examples": []
+      }
+    }
+  }
+}