aeon-ui-engine 1.3.1 → 1.4.0

package/packages/schemas/json/catalog.json

@@ -26,7 +26,31 @@
     "tooltip",
     "toast",
     "scroll",
-    "progress"
+    "progress",
+    "radioGroup",
+    "slider",
+    "rangeSlider",
+    "fileUpload",
+    "pinInput",
+    "avatar",
+    "content",
+    "panel",
+    "appShell",
+    "stickyBar",
+    "bar",
+    "nav",
+    "appNav",
+    "prompt",
+    "statusBanner",
+    "separator",
+    "composer",
+    "thread",
+    "identity",
+    "profileHeader",
+    "metricStrip",
+    "listRow",
+    "entry",
+    "conversation"
   ],
   "schemas": {
     "button": {
@@ -110,6 +134,10 @@
             },
             "disabled": {
               "type": "boolean"
+            },
+            "asChild": {
+              "type": "boolean",
+              "description": "Merge button attrs onto a single child element (Link, a)."
             }
           }
         },
@@ -165,6 +193,7 @@
           },
           "default": [
             "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+            "<Button.Root asChild variant=\"solid\"><a href=\"/upload\">Upload</a></Button.Root>",
             "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
           ]
         }
@@ -195,6 +224,7 @@
         },
         "examples": [
           "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+          "<Button.Root asChild variant=\"solid\"><a href=\"/upload\">Upload</a></Button.Root>",
           "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
         ]
       }
@@ -1639,7 +1669,7 @@
       "$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.",
+      "description": "Open/closed via popoverMachine (same family as Select/Menu/Popover). Query, highlight, and item registry stay React-local for typeahead.",
       "type": "object",
       "additionalProperties": false,
       "required": [
@@ -1717,18 +1747,24 @@
             "null"
           ],
           "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
-          "const": null
+          "const": "popoverMachine"
         },
         "runtime": {
           "type": "string",
           "description": "How headless state is driven at runtime",
-          "const": "useState"
+          "const": "useAeonMachine"
         },
         "events": {
           "type": "array",
           "items": {
             "type": "string",
-            "enum": []
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE",
+              "ESCAPE",
+              "POINTER_DOWN_OUTSIDE"
+            ]
           }
         },
         "examples": {
@@ -1753,9 +1789,15 @@
           "open",
           "closed"
         ],
-        "machine": null,
-        "runtime": "useState",
-        "events": [],
+        "machine": "popoverMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE",
+          "ESCAPE",
+          "POINTER_DOWN_OUTSIDE"
+        ],
         "slots": {
           "Root": "combobox.root",
           "Input": "combobox.input",
@@ -1769,7 +1811,7 @@
       "$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.",
+      "description": "Open/closed via popoverMachine (same family as Popover/Select/Combobox). openDelay / closeDelay / touchDuration stay React-local.",
       "type": "object",
       "additionalProperties": false,
       "required": [
@@ -1842,18 +1884,25 @@
             "null"
           ],
           "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
-          "const": null
+          "const": "popoverMachine"
         },
         "runtime": {
           "type": "string",
           "description": "How headless state is driven at runtime",
-          "const": "useState"
+          "const": "useAeonMachine"
         },
         "events": {
           "type": "array",
           "items": {
             "type": "string",
-            "enum": []
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE",
+              "SET_OPEN",
+              "ESCAPE",
+              "POINTER_DOWN_OUTSIDE"
+            ]
           }
         },
         "examples": {
@@ -1877,9 +1926,16 @@
           "open",
           "closed"
         ],
-        "machine": null,
-        "runtime": "useState",
-        "events": [],
+        "machine": "popoverMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE",
+          "SET_OPEN",
+          "ESCAPE",
+          "POINTER_DOWN_OUTSIDE"
+        ],
         "slots": {
           "Root": "tooltip.root",
           "Trigger": "tooltip.trigger",
@@ -2294,6 +2350,3431 @@
         },
         "examples": []
       }
+    },
+    "radioGroup": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/radioGroup.json",
+      "title": "RadioGroup",
+      "description": "Single selection via tabsMachine (same chart family as Tabs/Nav).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "RadioGroup"
+        },
+        "scope": {
+          "const": "radioGroup"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "item",
+              "itemControl",
+              "itemIndicator",
+              "itemLabel"
+            ]
+          },
+          "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": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "radioGroup.root",
+              "description": "radioGroup.root"
+            },
+            "Item": {
+              "const": "radioGroup.item",
+              "description": "radioGroup.item"
+            },
+            "ItemControl": {
+              "const": "radioGroup.itemControl",
+              "description": "radioGroup.itemControl"
+            },
+            "ItemLabel": {
+              "const": "radioGroup.itemLabel",
+              "description": "radioGroup.itemLabel"
+            }
+          }
+        },
+        "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": "radioGroup",
+        "parts": [
+          "root",
+          "item",
+          "itemControl",
+          "itemIndicator",
+          "itemLabel"
+        ],
+        "states": [
+          "selected"
+        ],
+        "machine": "tabsMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SELECT"
+        ],
+        "slots": {
+          "Root": "radioGroup.root",
+          "Item": "radioGroup.item",
+          "ItemControl": "radioGroup.itemControl",
+          "ItemLabel": "radioGroup.itemLabel"
+        },
+        "examples": []
+      }
+    },
+    "slider": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/slider.json",
+      "title": "Slider",
+      "description": "Range control via sliderMachine — idle | dragging plus numeric value in context.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Slider"
+        },
+        "scope": {
+          "const": "slider"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "track",
+              "range",
+              "thumb",
+              "valueText"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "dragging"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "slider.root",
+              "description": "slider.root"
+            },
+            "Track": {
+              "const": "slider.track",
+              "description": "slider.track"
+            },
+            "Range": {
+              "const": "slider.range",
+              "description": "slider.range"
+            },
+            "Thumb": {
+              "const": "slider.thumb",
+              "description": "slider.thumb"
+            },
+            "ValueText": {
+              "const": "slider.valueText",
+              "description": "slider.valueText"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "sliderMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "SET_VALUE",
+              "STEP",
+              "POINTER_DOWN",
+              "POINTER_UP",
+              "HOME",
+              "END"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "slider",
+        "parts": [
+          "root",
+          "track",
+          "range",
+          "thumb",
+          "valueText"
+        ],
+        "states": [
+          "idle",
+          "dragging"
+        ],
+        "machine": "sliderMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SET_VALUE",
+          "STEP",
+          "POINTER_DOWN",
+          "POINTER_UP",
+          "HOME",
+          "END"
+        ],
+        "slots": {
+          "Root": "slider.root",
+          "Track": "slider.track",
+          "Range": "slider.range",
+          "Thumb": "slider.thumb",
+          "ValueText": "slider.valueText"
+        },
+        "examples": []
+      }
+    },
+    "rangeSlider": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/rangeSlider.json",
+      "title": "RangeSlider",
+      "description": "Two-thumb range via rangeSliderMachine — idle | dragging with values pair and minStepsBetween gap.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "RangeSlider"
+        },
+        "scope": {
+          "const": "rangeSlider"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "track",
+              "range",
+              "thumb",
+              "valueText"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "dragging"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "rangeSlider.root",
+              "description": "rangeSlider.root"
+            },
+            "Track": {
+              "const": "rangeSlider.track",
+              "description": "rangeSlider.track"
+            },
+            "Range": {
+              "const": "rangeSlider.range",
+              "description": "rangeSlider.range"
+            },
+            "Thumb": {
+              "const": "rangeSlider.thumb",
+              "description": "rangeSlider.thumb"
+            },
+            "ValueText": {
+              "const": "rangeSlider.valueText",
+              "description": "rangeSlider.valueText"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "rangeSliderMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "SET_VALUES",
+              "SET_BOUNDS",
+              "SET_DISABLED",
+              "POINTER_DOWN",
+              "POINTER_MOVE",
+              "POINTER_UP",
+              "STEP",
+              "HOME",
+              "END"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": [
+            "<RangeSlider.Root defaultValue={[20, 80]} minStepsBetween={1}>\n  <RangeSlider.Track /><RangeSlider.Range />\n  <RangeSlider.Thumb index={0} /><RangeSlider.Thumb index={1} />\n</RangeSlider.Root>"
+          ]
+        }
+      },
+      "x-aeon": {
+        "scope": "rangeSlider",
+        "parts": [
+          "root",
+          "track",
+          "range",
+          "thumb",
+          "valueText"
+        ],
+        "states": [
+          "idle",
+          "dragging"
+        ],
+        "machine": "rangeSliderMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SET_VALUES",
+          "SET_BOUNDS",
+          "SET_DISABLED",
+          "POINTER_DOWN",
+          "POINTER_MOVE",
+          "POINTER_UP",
+          "STEP",
+          "HOME",
+          "END"
+        ],
+        "slots": {
+          "Root": "rangeSlider.root",
+          "Track": "rangeSlider.track",
+          "Range": "rangeSlider.range",
+          "Thumb": "rangeSlider.thumb",
+          "ValueText": "rangeSlider.valueText"
+        },
+        "examples": [
+          "<RangeSlider.Root defaultValue={[20, 80]} minStepsBetween={1}>\n  <RangeSlider.Track /><RangeSlider.Range />\n  <RangeSlider.Thumb index={0} /><RangeSlider.Thumb index={1} />\n</RangeSlider.Root>"
+        ]
+      }
+    },
+    "fileUpload": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/fileUpload.json",
+      "title": "FileUpload",
+      "description": "Drag-drop surface via fileUploadMachine — idle | dragging | rejected. File bytes stay in React callbacks.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "FileUpload"
+        },
+        "scope": {
+          "const": "fileUpload"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "dropzone",
+              "input",
+              "label",
+              "hint",
+              "preview",
+              "clearTrigger",
+              "rejectionMessage"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "dragging",
+              "rejected"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "fileUpload.root",
+              "description": "fileUpload.root"
+            },
+            "Dropzone": {
+              "const": "fileUpload.dropzone",
+              "description": "fileUpload.dropzone"
+            },
+            "Input": {
+              "const": "fileUpload.input",
+              "description": "fileUpload.input"
+            },
+            "Label": {
+              "const": "fileUpload.label",
+              "description": "fileUpload.label"
+            },
+            "Hint": {
+              "const": "fileUpload.hint",
+              "description": "fileUpload.hint"
+            },
+            "Preview": {
+              "const": "fileUpload.preview",
+              "description": "fileUpload.preview"
+            },
+            "ClearTrigger": {
+              "const": "fileUpload.clearTrigger",
+              "description": "fileUpload.clearTrigger"
+            },
+            "RejectionMessage": {
+              "const": "fileUpload.rejectionMessage",
+              "description": "fileUpload.rejectionMessage"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "fileUploadMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "DRAG_OVER",
+              "DRAG_LEAVE",
+              "DROP_ACCEPT",
+              "DROP_REJECT",
+              "RESET"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "fileUpload",
+        "parts": [
+          "root",
+          "dropzone",
+          "input",
+          "label",
+          "hint",
+          "preview",
+          "clearTrigger",
+          "rejectionMessage"
+        ],
+        "states": [
+          "idle",
+          "dragging",
+          "rejected"
+        ],
+        "machine": "fileUploadMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "DRAG_OVER",
+          "DRAG_LEAVE",
+          "DROP_ACCEPT",
+          "DROP_REJECT",
+          "RESET"
+        ],
+        "slots": {
+          "Root": "fileUpload.root",
+          "Dropzone": "fileUpload.dropzone",
+          "Input": "fileUpload.input",
+          "Label": "fileUpload.label",
+          "Hint": "fileUpload.hint",
+          "Preview": "fileUpload.preview",
+          "ClearTrigger": "fileUpload.clearTrigger",
+          "RejectionMessage": "fileUpload.rejectionMessage"
+        },
+        "examples": []
+      }
+    },
+    "pinInput": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/pinInput.json",
+      "title": "PinInput",
+      "description": "OTP / PIN cells — React state for digit buffer; projects idle | complete on root.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "PinInput"
+        },
+        "scope": {
+          "const": "pinInput"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "input"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "complete"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "pinInput.root",
+              "description": "pinInput.root"
+            },
+            "Input": {
+              "const": "pinInput.input",
+              "description": "pinInput.input"
+            }
+          }
+        },
+        "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": "pinInput",
+        "parts": [
+          "root",
+          "input"
+        ],
+        "states": [
+          "idle",
+          "complete"
+        ],
+        "machine": null,
+        "runtime": "useState",
+        "events": [],
+        "slots": {
+          "Root": "pinInput.root",
+          "Input": "pinInput.input"
+        },
+        "examples": []
+      }
+    },
+    "avatar": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/avatar.json",
+      "title": "Avatar",
+      "description": "Image load lifecycle in React; badge presence is a prop projection.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Avatar"
+        },
+        "scope": {
+          "const": "avatar"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "image",
+              "fallback",
+              "badge"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "loading",
+              "loaded",
+              "error"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "avatar.root",
+              "description": "avatar.root"
+            },
+            "Image": {
+              "const": "avatar.image",
+              "description": "avatar.image"
+            },
+            "Fallback": {
+              "const": "avatar.fallback",
+              "description": "avatar.fallback"
+            },
+            "Badge": {
+              "const": "avatar.badge",
+              "description": "avatar.badge"
+            }
+          }
+        },
+        "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": "avatar",
+        "parts": [
+          "root",
+          "image",
+          "fallback",
+          "badge"
+        ],
+        "states": [
+          "idle",
+          "loading",
+          "loaded",
+          "error"
+        ],
+        "machine": null,
+        "runtime": "useState",
+        "events": [],
+        "slots": {
+          "Root": "avatar.root",
+          "Image": "avatar.image",
+          "Fallback": "avatar.fallback",
+          "Badge": "avatar.badge"
+        },
+        "examples": []
+      }
+    },
+    "content": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/content.json",
+      "title": "Content",
+      "description": "Status-slotted body via contentRegionMachine (or Root state prop projection). Pair with Async for fetch.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Content"
+        },
+        "scope": {
+          "const": "content"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "toolbar",
+              "body",
+              "pending",
+              "empty",
+              "error",
+              "success",
+              "sentinel"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "pending",
+              "empty",
+              "error",
+              "ready",
+              "loadingMore",
+              "success"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "content.root",
+              "description": "content.root"
+            },
+            "Pending": {
+              "const": "content.pending",
+              "description": "content.pending"
+            },
+            "Empty": {
+              "const": "content.empty",
+              "description": "content.empty"
+            },
+            "Error": {
+              "const": "content.error",
+              "description": "content.error"
+            },
+            "Success": {
+              "const": "content.success",
+              "description": "content.success"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "contentRegionMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "LOAD",
+              "RESOLVE",
+              "REJECT",
+              "RETRY",
+              "LOAD_MORE",
+              "MORE_DONE",
+              "SUCCEED",
+              "RESET"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "content",
+        "parts": [
+          "root",
+          "toolbar",
+          "body",
+          "pending",
+          "empty",
+          "error",
+          "success",
+          "sentinel"
+        ],
+        "states": [
+          "idle",
+          "pending",
+          "empty",
+          "error",
+          "ready",
+          "loadingMore",
+          "success"
+        ],
+        "machine": "contentRegionMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "LOAD",
+          "RESOLVE",
+          "REJECT",
+          "RETRY",
+          "LOAD_MORE",
+          "MORE_DONE",
+          "SUCCEED",
+          "RESET"
+        ],
+        "slots": {
+          "Root": "content.root",
+          "Pending": "content.pending",
+          "Empty": "content.empty",
+          "Error": "content.error",
+          "Success": "content.success"
+        },
+        "examples": []
+      }
+    },
+    "panel": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/panel.json",
+      "title": "Panel",
+      "description": "Collapsible layout region via panelMachine — expanded | collapsed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Panel"
+        },
+        "scope": {
+          "const": "panel"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "group",
+              "root",
+              "trigger",
+              "label",
+              "content"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "expanded",
+              "collapsed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Group": {
+              "const": "panel.group",
+              "description": "panel.group"
+            },
+            "Root": {
+              "const": "panel.root",
+              "description": "panel.root"
+            },
+            "Trigger": {
+              "const": "panel.trigger",
+              "description": "panel.trigger"
+            },
+            "Label": {
+              "const": "panel.label",
+              "description": "panel.label"
+            },
+            "Content": {
+              "const": "panel.content",
+              "description": "panel.content"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "panelMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "EXPAND",
+              "COLLAPSE",
+              "TOGGLE",
+              "SET_EXPANDED"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "panel",
+        "parts": [
+          "group",
+          "root",
+          "trigger",
+          "label",
+          "content"
+        ],
+        "states": [
+          "expanded",
+          "collapsed"
+        ],
+        "machine": "panelMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "EXPAND",
+          "COLLAPSE",
+          "TOGGLE",
+          "SET_EXPANDED"
+        ],
+        "slots": {
+          "Group": "panel.group",
+          "Root": "panel.root",
+          "Trigger": "panel.trigger",
+          "Label": "panel.label",
+          "Content": "panel.content"
+        },
+        "examples": []
+      }
+    },
+    "appShell": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/appShell.json",
+      "title": "AppShell",
+      "description": "Application chrome frame via appShellMachine — idle | overlayOpen (+ dockVisible).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "AppShell"
+        },
+        "scope": {
+          "const": "appShell"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "header",
+              "subheader",
+              "content",
+              "aside",
+              "footer",
+              "dock",
+              "scrim"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "overlayOpen"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "appShell.root",
+              "description": "appShell.root"
+            },
+            "Header": {
+              "const": "appShell.header",
+              "description": "appShell.header"
+            },
+            "Content": {
+              "const": "appShell.content",
+              "description": "appShell.content"
+            },
+            "Dock": {
+              "const": "appShell.dock",
+              "description": "appShell.dock"
+            },
+            "Scrim": {
+              "const": "appShell.scrim",
+              "description": "appShell.scrim"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "appShellMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN_OVERLAY",
+              "CLOSE_OVERLAY",
+              "SHOW_DOCK",
+              "HIDE_DOCK",
+              "SET_DOCK"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "appShell",
+        "parts": [
+          "root",
+          "header",
+          "subheader",
+          "content",
+          "aside",
+          "footer",
+          "dock",
+          "scrim"
+        ],
+        "states": [
+          "idle",
+          "overlayOpen"
+        ],
+        "machine": "appShellMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "OPEN_OVERLAY",
+          "CLOSE_OVERLAY",
+          "SHOW_DOCK",
+          "HIDE_DOCK",
+          "SET_DOCK"
+        ],
+        "slots": {
+          "Root": "appShell.root",
+          "Header": "appShell.header",
+          "Content": "appShell.content",
+          "Dock": "appShell.dock",
+          "Scrim": "appShell.scrim"
+        },
+        "examples": []
+      }
+    },
+    "stickyBar": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/stickyBar.json",
+      "title": "StickyBar",
+      "description": "Sticky/fixed chrome band via stickyBarMachine. DOM scope is bar (reuses bar anatomy zones).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "StickyBar"
+        },
+        "scope": {
+          "const": "bar"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "leading",
+              "center",
+              "trailing",
+              "seam"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "floating",
+              "docked",
+              "collapsed",
+              "hidden"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "bar.root",
+              "description": "bar.root"
+            },
+            "Leading": {
+              "const": "bar.leading",
+              "description": "bar.leading"
+            },
+            "Center": {
+              "const": "bar.center",
+              "description": "bar.center"
+            },
+            "Trailing": {
+              "const": "bar.trailing",
+              "description": "bar.trailing"
+            },
+            "Seam": {
+              "const": "bar.seam",
+              "description": "bar.seam"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "stickyBarMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "DOCK",
+              "FLOAT",
+              "COLLAPSE",
+              "EXPAND",
+              "HIDE",
+              "SHOW",
+              "SET_OFFSET"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "bar",
+        "parts": [
+          "root",
+          "leading",
+          "center",
+          "trailing",
+          "seam"
+        ],
+        "states": [
+          "floating",
+          "docked",
+          "collapsed",
+          "hidden"
+        ],
+        "machine": "stickyBarMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "DOCK",
+          "FLOAT",
+          "COLLAPSE",
+          "EXPAND",
+          "HIDE",
+          "SHOW",
+          "SET_OFFSET"
+        ],
+        "slots": {
+          "Root": "bar.root",
+          "Leading": "bar.leading",
+          "Center": "bar.center",
+          "Trailing": "bar.trailing",
+          "Seam": "bar.seam"
+        },
+        "examples": []
+      }
+    },
+    "bar": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/bar.json",
+      "title": "Bar",
+      "description": "Three-zone toolbar layout (leading / center / trailing / seam). Sticky lifecycle uses StickyBar + stickyBarMachine.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Bar"
+        },
+        "scope": {
+          "const": "bar"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "leading",
+              "center",
+              "trailing",
+              "seam"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "bar.root",
+              "description": "bar.root"
+            },
+            "Leading": {
+              "const": "bar.leading",
+              "description": "bar.leading"
+            },
+            "Center": {
+              "const": "bar.center",
+              "description": "bar.center"
+            },
+            "Trailing": {
+              "const": "bar.trailing",
+              "description": "bar.trailing"
+            }
+          }
+        },
+        "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": "layout"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "bar",
+        "parts": [
+          "root",
+          "leading",
+          "center",
+          "trailing",
+          "seam"
+        ],
+        "states": [
+          "idle"
+        ],
+        "machine": null,
+        "runtime": "layout",
+        "events": [],
+        "slots": {
+          "Root": "bar.root",
+          "Leading": "bar.leading",
+          "Center": "bar.center",
+          "Trailing": "bar.trailing"
+        },
+        "examples": []
+      }
+    },
+    "nav": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/nav.json",
+      "title": "Nav",
+      "description": "Navigational collection via tabsMachine; items project inactive | active | disabled.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Nav"
+        },
+        "scope": {
+          "const": "nav"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "item",
+              "indicator",
+              "label",
+              "icon",
+              "badge"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "inactive",
+              "active",
+              "disabled"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "nav.root",
+              "description": "nav.root"
+            },
+            "Item": {
+              "const": "nav.item",
+              "description": "nav.item"
+            },
+            "Label": {
+              "const": "nav.label",
+              "description": "nav.label"
+            },
+            "Icon": {
+              "const": "nav.icon",
+              "description": "nav.icon"
+            }
+          }
+        },
+        "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": "nav",
+        "parts": [
+          "root",
+          "item",
+          "indicator",
+          "label",
+          "icon",
+          "badge"
+        ],
+        "states": [
+          "inactive",
+          "active",
+          "disabled"
+        ],
+        "machine": "tabsMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SELECT"
+        ],
+        "slots": {
+          "Root": "nav.root",
+          "Item": "nav.item",
+          "Label": "nav.label",
+          "Icon": "nav.icon"
+        },
+        "examples": []
+      }
+    },
+    "appNav": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/appNav.json",
+      "title": "AppNav",
+      "description": "Section + detail stack via appNavMachine — list→detail, settings drill-in.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "AppNav"
+        },
+        "scope": {
+          "const": "appNav"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "rail",
+              "section",
+              "stage",
+              "breadcrumb",
+              "crumb",
+              "back"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "section"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "appNav.root",
+              "description": "appNav.root"
+            },
+            "Rail": {
+              "const": "appNav.rail",
+              "description": "appNav.rail"
+            },
+            "Stage": {
+              "const": "appNav.stage",
+              "description": "appNav.stage"
+            },
+            "Back": {
+              "const": "appNav.back",
+              "description": "appNav.back"
+            }
+          }
+        },
+        "machine": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+          "const": "appNavMachine"
+        },
+        "runtime": {
+          "type": "string",
+          "description": "How headless state is driven at runtime",
+          "const": "useAeonMachine"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "SET_SECTION",
+              "PUSH",
+              "REPLACE",
+              "POP",
+              "POP_TO",
+              "CLEAR",
+              "RESET"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "appNav",
+        "parts": [
+          "root",
+          "rail",
+          "section",
+          "stage",
+          "breadcrumb",
+          "crumb",
+          "back"
+        ],
+        "states": [
+          "section"
+        ],
+        "machine": "appNavMachine",
+        "runtime": "useAeonMachine",
+        "events": [
+          "SET_SECTION",
+          "PUSH",
+          "REPLACE",
+          "POP",
+          "POP_TO",
+          "CLEAR",
+          "RESET"
+        ],
+        "slots": {
+          "Root": "appNav.root",
+          "Rail": "appNav.rail",
+          "Stage": "appNav.stage",
+          "Back": "appNav.back"
+        },
+        "examples": []
+      }
+    },
+    "prompt": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/prompt.json",
+      "title": "Prompt",
+      "description": "Confirm / permission dialog composed on Dialog. Open/closed via dialogMachine; face via status prop.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Prompt"
+        },
+        "scope": {
+          "const": "prompt"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "eyebrow",
+              "meta",
+              "amount",
+              "actions",
+              "primary",
+              "secondary"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "confirming",
+              "dismissed",
+              "confirmed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "status": {
+              "type": "string",
+              "enum": [
+                "pending",
+                "confirming",
+                "dismissed",
+                "confirmed"
+              ],
+              "default": "pending"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "prompt.root",
+              "description": "prompt.root"
+            },
+            "Primary": {
+              "const": "prompt.primary",
+              "description": "prompt.primary"
+            },
+            "Secondary": {
+              "const": "prompt.secondary",
+              "description": "prompt.secondary"
+            },
+            "Actions": {
+              "const": "prompt.actions",
+              "description": "prompt.actions"
+            }
+          }
+        },
+        "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": "status prop"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "OPEN",
+              "CLOSE",
+              "TOGGLE"
+            ]
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "prompt",
+        "parts": [
+          "root",
+          "eyebrow",
+          "meta",
+          "amount",
+          "actions",
+          "primary",
+          "secondary"
+        ],
+        "states": [
+          "pending",
+          "confirming",
+          "dismissed",
+          "confirmed"
+        ],
+        "machine": "dialogMachine",
+        "runtime": "status prop",
+        "events": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ],
+        "slots": {
+          "Root": "prompt.root",
+          "Primary": "prompt.primary",
+          "Secondary": "prompt.secondary",
+          "Actions": "prompt.actions"
+        },
+        "examples": []
+      }
+    },
+    "statusBanner": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/statusBanner.json",
+      "title": "StatusBanner",
+      "description": "Non-blocking top-of-app notice — tone + optional status props project to data-aeon-state.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "StatusBanner"
+        },
+        "scope": {
+          "const": "statusBanner"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "copy",
+              "title",
+              "body",
+              "actions"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "info",
+              "success",
+              "warning",
+              "danger",
+              "neutral"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "tone": {
+              "type": "string",
+              "enum": [
+                "info",
+                "success",
+                "warning",
+                "danger",
+                "neutral"
+              ]
+            },
+            "status": {
+              "type": "string",
+              "description": "Optional secondary token appended to data-aeon-state"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "statusBanner.root",
+              "description": "statusBanner.root"
+            },
+            "Title": {
+              "const": "statusBanner.title",
+              "description": "statusBanner.title"
+            },
+            "Body": {
+              "const": "statusBanner.body",
+              "description": "statusBanner.body"
+            },
+            "Actions": {
+              "const": "statusBanner.actions",
+              "description": "statusBanner.actions"
+            }
+          }
+        },
+        "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": "statusBanner",
+        "parts": [
+          "root",
+          "copy",
+          "title",
+          "body",
+          "actions"
+        ],
+        "states": [
+          "info",
+          "success",
+          "warning",
+          "danger",
+          "neutral"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "statusBanner.root",
+          "Title": "statusBanner.title",
+          "Body": "statusBanner.body",
+          "Actions": "statusBanner.actions"
+        },
+        "examples": []
+      }
+    },
+    "separator": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/separator.json",
+      "title": "Separator",
+      "description": "Static divider — orientation prop only.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Separator"
+        },
+        "scope": {
+          "const": "separator"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "horizontal",
+              "vertical"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "separator.root",
+              "description": "separator.root"
+            }
+          }
+        },
+        "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": "separator",
+        "parts": [
+          "root"
+        ],
+        "states": [
+          "horizontal",
+          "vertical"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "separator.root"
+        },
+        "examples": []
+      }
+    },
+    "composer": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/composer.json",
+      "title": "Composer",
+      "description": "Compose chrome — root state prop idle | sending | disabled | error.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Composer"
+        },
+        "scope": {
+          "const": "composer"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "input",
+              "actions",
+              "send"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "sending",
+              "disabled",
+              "error"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "composer.root",
+              "description": "composer.root"
+            },
+            "Input": {
+              "const": "composer.input",
+              "description": "composer.input"
+            },
+            "Send": {
+              "const": "composer.send",
+              "description": "composer.send"
+            }
+          }
+        },
+        "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": "composer",
+        "parts": [
+          "root",
+          "input",
+          "actions",
+          "send"
+        ],
+        "states": [
+          "idle",
+          "sending",
+          "disabled",
+          "error"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "composer.root",
+          "Input": "composer.input",
+          "Send": "composer.send"
+        },
+        "examples": []
+      }
+    },
+    "thread": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/thread.json",
+      "title": "Thread",
+      "description": "Message stream — item state prop mine | theirs | pending | failed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Thread"
+        },
+        "scope": {
+          "const": "thread"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "list",
+              "item",
+              "bubble",
+              "meta",
+              "day"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "mine",
+              "theirs",
+              "pending",
+              "failed"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "thread.root",
+              "description": "thread.root"
+            },
+            "Item": {
+              "const": "thread.item",
+              "description": "thread.item"
+            },
+            "Bubble": {
+              "const": "thread.bubble",
+              "description": "thread.bubble"
+            }
+          }
+        },
+        "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": "thread",
+        "parts": [
+          "root",
+          "list",
+          "item",
+          "bubble",
+          "meta",
+          "day"
+        ],
+        "states": [
+          "mine",
+          "theirs",
+          "pending",
+          "failed"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "thread.root",
+          "Item": "thread.item",
+          "Bubble": "thread.bubble"
+        },
+        "examples": []
+      }
+    },
+    "identity": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/identity.json",
+      "title": "Identity",
+      "description": "Avatar + title + subtitle strip — presentational layout, not a niche product scope.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Identity"
+        },
+        "scope": {
+          "const": "identity"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "avatar",
+              "title",
+              "subtitle",
+              "meta",
+              "trailing"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ]
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "identity.root",
+              "description": "identity.root"
+            },
+            "Avatar": {
+              "const": "identity.avatar",
+              "description": "identity.avatar"
+            },
+            "Title": {
+              "const": "identity.title",
+              "description": "identity.title"
+            },
+            "Subtitle": {
+              "const": "identity.subtitle",
+              "description": "identity.subtitle"
+            },
+            "Meta": {
+              "const": "identity.meta",
+              "description": "identity.meta"
+            },
+            "Trailing": {
+              "const": "identity.trailing",
+              "description": "identity.trailing"
+            }
+          }
+        },
+        "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": "layout"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "identity",
+        "parts": [
+          "root",
+          "avatar",
+          "title",
+          "subtitle",
+          "meta",
+          "trailing"
+        ],
+        "states": [
+          "idle"
+        ],
+        "machine": null,
+        "runtime": "layout",
+        "events": [],
+        "slots": {
+          "Root": "identity.root",
+          "Avatar": "identity.avatar",
+          "Title": "identity.title",
+          "Subtitle": "identity.subtitle",
+          "Meta": "identity.meta",
+          "Trailing": "identity.trailing"
+        },
+        "examples": []
+      }
+    },
+    "profileHeader": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/profileHeader.json",
+      "title": "ProfileHeader",
+      "description": "Dense account header — identity · metrics · actions. Universal people chrome.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "ProfileHeader"
+        },
+        "scope": {
+          "const": "profileHeader"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "media",
+              "identity",
+              "metrics",
+              "actions",
+              "body"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "profileHeader.root",
+              "description": "profileHeader.root"
+            },
+            "Media": {
+              "const": "profileHeader.media",
+              "description": "profileHeader.media"
+            },
+            "Identity": {
+              "const": "profileHeader.identity",
+              "description": "profileHeader.identity"
+            },
+            "Metrics": {
+              "const": "profileHeader.metrics",
+              "description": "profileHeader.metrics"
+            },
+            "Actions": {
+              "const": "profileHeader.actions",
+              "description": "profileHeader.actions"
+            },
+            "Body": {
+              "const": "profileHeader.body",
+              "description": "profileHeader.body"
+            }
+          }
+        },
+        "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": "layout"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "profileHeader",
+        "parts": [
+          "root",
+          "media",
+          "identity",
+          "metrics",
+          "actions",
+          "body"
+        ],
+        "states": [
+          "idle"
+        ],
+        "machine": null,
+        "runtime": "layout",
+        "events": [],
+        "slots": {
+          "Root": "profileHeader.root",
+          "Media": "profileHeader.media",
+          "Identity": "profileHeader.identity",
+          "Metrics": "profileHeader.metrics",
+          "Actions": "profileHeader.actions",
+          "Body": "profileHeader.body"
+        },
+        "examples": []
+      }
+    },
+    "metricStrip": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/metricStrip.json",
+      "title": "MetricStrip",
+      "description": "Dense value|label chips — cluster or loose density. Generic stats only.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "MetricStrip"
+        },
+        "scope": {
+          "const": "metricStrip"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "chip",
+              "value",
+              "label"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "density": {
+              "type": "string",
+              "enum": [
+                "cluster",
+                "loose"
+              ]
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "metricStrip.root",
+              "description": "metricStrip.root"
+            },
+            "Chip": {
+              "const": "metricStrip.chip",
+              "description": "metricStrip.chip"
+            },
+            "Value": {
+              "const": "metricStrip.value",
+              "description": "metricStrip.value"
+            },
+            "Label": {
+              "const": "metricStrip.label",
+              "description": "metricStrip.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": "layout"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "metricStrip",
+        "parts": [
+          "root",
+          "chip",
+          "value",
+          "label"
+        ],
+        "states": [
+          "idle"
+        ],
+        "machine": null,
+        "runtime": "layout",
+        "events": [],
+        "slots": {
+          "Root": "metricStrip.root",
+          "Chip": "metricStrip.chip",
+          "Value": "metricStrip.value",
+          "Label": "metricStrip.label"
+        },
+        "examples": []
+      }
+    },
+    "listRow": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/listRow.json",
+      "title": "ListRow",
+      "description": "Settings / menu row — leading · label · trailing. Layout only.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "ListRow"
+        },
+        "scope": {
+          "const": "listRow"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "leading",
+              "label",
+              "description",
+              "trailing"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {}
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "listRow.root",
+              "description": "listRow.root"
+            },
+            "Leading": {
+              "const": "listRow.leading",
+              "description": "listRow.leading"
+            },
+            "Label": {
+              "const": "listRow.label",
+              "description": "listRow.label"
+            },
+            "Description": {
+              "const": "listRow.description",
+              "description": "listRow.description"
+            },
+            "Trailing": {
+              "const": "listRow.trailing",
+              "description": "listRow.trailing"
+            }
+          }
+        },
+        "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": "layout"
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": []
+          }
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        }
+      },
+      "x-aeon": {
+        "scope": "listRow",
+        "parts": [
+          "root",
+          "leading",
+          "label",
+          "description",
+          "trailing"
+        ],
+        "states": [
+          "idle"
+        ],
+        "machine": null,
+        "runtime": "layout",
+        "events": [],
+        "slots": {
+          "Root": "listRow.root",
+          "Leading": "listRow.leading",
+          "Label": "listRow.label",
+          "Description": "listRow.description",
+          "Trailing": "listRow.trailing"
+        },
+        "examples": []
+      }
+    },
+    "entry": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/entry.json",
+      "title": "Entry",
+      "description": "Universal multi-value card (feed stack or listing split). Root state idle | selected | muted — never invent niche scopes.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Entry"
+        },
+        "scope": {
+          "const": "entry"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "list",
+              "root",
+              "header",
+              "leading",
+              "heading",
+              "title",
+              "subtitle",
+              "meta",
+              "media",
+              "body",
+              "values",
+              "value",
+              "actions",
+              "footer"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "selected",
+              "muted"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "idle",
+                "selected",
+                "muted"
+              ],
+              "default": "idle"
+            },
+            "density": {
+              "type": "string",
+              "enum": [
+                "compact",
+                "cozy"
+              ]
+            },
+            "layout": {
+              "type": "string",
+              "enum": [
+                "stack",
+                "split"
+              ]
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "List": {
+              "const": "entry.list",
+              "description": "entry.list"
+            },
+            "Root": {
+              "const": "entry.root",
+              "description": "entry.root"
+            },
+            "Header": {
+              "const": "entry.header",
+              "description": "entry.header"
+            },
+            "Body": {
+              "const": "entry.body",
+              "description": "entry.body"
+            },
+            "Actions": {
+              "const": "entry.actions",
+              "description": "entry.actions"
+            },
+            "Footer": {
+              "const": "entry.footer",
+              "description": "entry.footer"
+            }
+          }
+        },
+        "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": "entry",
+        "parts": [
+          "list",
+          "root",
+          "header",
+          "leading",
+          "heading",
+          "title",
+          "subtitle",
+          "meta",
+          "media",
+          "body",
+          "values",
+          "value",
+          "actions",
+          "footer"
+        ],
+        "states": [
+          "idle",
+          "selected",
+          "muted"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "List": "entry.list",
+          "Root": "entry.root",
+          "Header": "entry.header",
+          "Body": "entry.body",
+          "Actions": "entry.actions",
+          "Footer": "entry.footer"
+        },
+        "examples": []
+      }
+    },
+    "conversation": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://aeon-ui.com/schemas/conversation.json",
+      "title": "Conversation",
+      "description": "Inbox / DM list — item state prop idle | unread | selected. Universal messaging chrome.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "component",
+        "scope"
+      ],
+      "properties": {
+        "component": {
+          "const": "Conversation"
+        },
+        "scope": {
+          "const": "conversation"
+        },
+        "parts": {
+          "type": "array",
+          "description": "Anatomy part keys — map to data-aeon-part",
+          "items": {
+            "type": "string",
+            "enum": [
+              "root",
+              "item",
+              "leading",
+              "body",
+              "title",
+              "preview",
+              "meta",
+              "badge"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "states": {
+          "type": "array",
+          "description": "Allowed data-aeon-state values (stable states only)",
+          "items": {
+            "type": "string",
+            "enum": [
+              "idle",
+              "unread",
+              "selected"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "props": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "state": {
+              "type": "string",
+              "enum": [
+                "idle",
+                "unread",
+                "selected"
+              ],
+              "default": "idle"
+            }
+          }
+        },
+        "slots": {
+          "type": "object",
+          "description": "Named composition slots / compound parts",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "properties": {
+            "Root": {
+              "const": "conversation.root",
+              "description": "conversation.root"
+            },
+            "Item": {
+              "const": "conversation.item",
+              "description": "conversation.item"
+            },
+            "Leading": {
+              "const": "conversation.leading",
+              "description": "conversation.leading"
+            },
+            "Body": {
+              "const": "conversation.body",
+              "description": "conversation.body"
+            },
+            "Title": {
+              "const": "conversation.title",
+              "description": "conversation.title"
+            },
+            "Preview": {
+              "const": "conversation.preview",
+              "description": "conversation.preview"
+            },
+            "Meta": {
+              "const": "conversation.meta",
+              "description": "conversation.meta"
+            },
+            "Badge": {
+              "const": "conversation.badge",
+              "description": "conversation.badge"
+            }
+          }
+        },
+        "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": "conversation",
+        "parts": [
+          "root",
+          "item",
+          "leading",
+          "body",
+          "title",
+          "preview",
+          "meta",
+          "badge"
+        ],
+        "states": [
+          "idle",
+          "unread",
+          "selected"
+        ],
+        "machine": null,
+        "runtime": "props",
+        "events": [],
+        "slots": {
+          "Root": "conversation.root",
+          "Item": "conversation.item",
+          "Leading": "conversation.leading",
+          "Body": "conversation.body",
+          "Title": "conversation.title",
+          "Preview": "conversation.preview",
+          "Meta": "conversation.meta",
+          "Badge": "conversation.badge"
+        },
+        "examples": []
+      }
     }
   }
 }