aeon-ui-engine 1.0.2 → 1.1.0

package/packages/schemas/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/dist/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules/tsx/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/packages/schemas/node_modules/.bin/vite

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3/node_modules/vite/bin/vite.js" "$@"
+fi

package/packages/schemas/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/packages/schemas/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.1.8","results":[[":src/index.test.ts",{"duration":13.422166999999945,"failed":false}],[":src/aeon-to-schema.test.ts",{"duration":26.108833999999888,"failed":false}]]}

package/packages/schemas/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@aeon-ui/schemas",
+  "version": "0.1.0",
+  "description": "Deterministic JSON Schemas and agent prompts for Aeon UI components",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GenericCPU/aeon-ui.git",
+    "directory": "packages/schemas"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "json",
+    "prompts",
+    "registry",
+    "README.md"
+  ],
+  "keywords": [
+    "aeon-ui",
+    "json-schema",
+    "generative-ui",
+    "llm",
+    "ai-agent"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./json/*": "./json/*",
+    "./prompts/*": "./prompts/*",
+    "./registry/*": "./registry/*",
+    "./catalog.json": "./json/catalog.json"
+  },
+  "scripts": {
+    "build": "tsx scripts/emit.ts && tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@aeon-ui/primitives": "workspace:*",
+    "xstate": "^5.32.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.8"
+  }
+}

package/packages/schemas/prompts/cursorrules.md

@@ -0,0 +1,64 @@
+# Aeon UI — agent system prompt
+
+You are building UI with **Aeon UI**, a React component library powered by finite statecharts.
+
+## Order of work (mandatory)
+1. **Build the state machines first** — name every lifecycle the UX needs (states + events). Prefer machines from `@aeon-ui/primitives` (or documented prop projections such as Button `status`).
+2. **Then project UI from those machines** — compound parts, copy, and layout exist only to reflect the chart. Never invent UI for states that are not in a machine.
+3. **UI = f(state)** — the DOM exposes `data-aeon-scope`, `data-aeon-part`, `data-aeon-state`. Style targets those attributes. Do not drive the same concern with parallel React `useState` flags.
+
+## Non-negotiable rules
+1. Do not duplicate open/checked/lifecycle in `useState` when a machine exists in `@aeon-ui/primitives`.
+2. **Button `status` is a prop** (`idle|pending|success|failure|disabled`). Optional: drive it from `buttonLifecycleMachine` via `useAeonMachine` in app code.
+3. **Select / Menu / Popover** share `popoverMachine` — never fork another open/closed chart.
+4. **Combobox** and **Tooltip** use React state today — do not add floating machines without the component checklist.
+5. **Scroll** uses `getScrollSnapshot()` — no XState machine.
+6. If a machine lists N stable states, the UI must represent all N (totality).
+7. Prefer `@aeon-ui/react` (headless) or `@aeon-ui/ui` (styled). Relative TS imports use `.js` extensions inside the Aeon monorepo only.
+8. Primitives stay **universal** — never invent niche components (dating, colour-blind test, pong). Compose from generic parts.
+
+## DOM contract
+Every interactive surface sets anatomy via `partAttrs` from `@aeon-ui/core`:
+- `data-aeon-scope` — family (`button`, `async`, `field`, …)
+- `data-aeon-part` — anatomy key (`root`, `trigger`, …)
+- `data-aeon-state` — allowed snapshot / prop state only
+
+## Before writing JSX
+1. Enumerate machines (or documented status props) for the flow — states and events.
+2. Read the component JSON Schema from `@aeon-ui/schemas` (or pasted catalog) and match parts to those charts.
+3. Compose with documented compound parts (`Dialog.Root`, `Field.Control`, …).
+4. Wire events to machine events or documented props — never invent `isLoading && !isError && hasData` spaghetti when a named state exists.
+
+
+## Schemas
+When generating Aeon UI, constrain props/parts/states to @aeon-ui/schemas catalog.
+Import headless from @aeon-ui/react or styled from @aeon-ui/ui.
+Install: npm install aeon-ui-engine react react-dom xstate @xstate/react
+CSS: import 'aeon-ui-engine/aeon.css'
+Vite: aeonUiVitePlugin() from aeon-ui-engine/vite
+
+## Async region statechart
+States: idle → loading → (success | empty | failure); REFRESH from success/empty/failure; STALE flag while success.
+Events: FETCH, RESOLVE{data}, REJECT{error}, RESET, STALE, REFRESH.
+Rule: Render track segments for idle, loading, success, empty, failure. Never hide empty/failure behind a generic spinner.
+
+## Field parallel statechart
+Regions:
+- interaction: pristine | dirty
+- validation: valid | invalid
+- submission: idle | pending
+Events: INPUT, BLUR, VALIDATE{valid}, SUBMIT, SUBMIT_DONE, SUBMIT_FAIL, RESET.
+Rule: Do not collapse validation + submission into one `error` boolean. Message UI follows validation region; pending follows submission.
+
+## Button lifecycle
+Preferred headless API: `status` prop ∈ idle | pending | success | failure | disabled.
+Optional machine: buttonLifecycleMachine with PRESS / RESOLVE / REJECT / RESET.
+Rule: Pending must set aria-busy. Do not use disabled alone to mean "saving".
+
+## Dialog statechart
+States: open | closed. Events: OPEN, CLOSE, TOGGLE.
+Rule: Backdrop click and Escape are CLOSE transitions. Title/Description are required for a11y when open.
+
+## Popover family (Popover, Menu, Select open state)
+Machine: popoverMachine — states open | closed.
+Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine forks.

package/packages/schemas/prompts/statecharts.md

@@ -0,0 +1,31 @@
+# Aeon UI statecharts (agent prompts)
+
+## Async region statechart
+States: idle → loading → (success | empty | failure); REFRESH from success/empty/failure; STALE flag while success.
+Events: FETCH, RESOLVE{data}, REJECT{error}, RESET, STALE, REFRESH.
+Rule: Render track segments for idle, loading, success, empty, failure. Never hide empty/failure behind a generic spinner.
+
+## Field parallel statechart
+Regions:
+- interaction: pristine | dirty
+- validation: valid | invalid
+- submission: idle | pending
+Events: INPUT, BLUR, VALIDATE{valid}, SUBMIT, SUBMIT_DONE, SUBMIT_FAIL, RESET.
+Rule: Do not collapse validation + submission into one `error` boolean. Message UI follows validation region; pending follows submission.
+
+## Button lifecycle
+Preferred headless API: `status` prop ∈ idle | pending | success | failure | disabled.
+Optional machine: buttonLifecycleMachine with PRESS / RESOLVE / REJECT / RESET.
+Rule: Pending must set aria-busy. Do not use disabled alone to mean "saving".
+
+## Dialog statechart
+States: open | closed. Events: OPEN, CLOSE, TOGGLE.
+Rule: Backdrop click and Escape are CLOSE transitions. Title/Description are required for a11y when open.
+
+## Popover family (Popover, Menu, Select open state)
+Machine: popoverMachine — states open | closed.
+Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine forks.
+
+## Switch / Checkbox
+Machine: toggleMachine — checked | unchecked. Events: TOGGLE, CHECK, UNCHECK.
+Rule: Hidden input stays in sync with snapshot for forms.

package/packages/schemas/prompts/system.md

@@ -0,0 +1,30 @@
+# Aeon UI — agent system prompt
+
+You are building UI with **Aeon UI**, a React component library powered by finite statecharts.
+
+## Order of work (mandatory)
+1. **Build the state machines first** — name every lifecycle the UX needs (states + events). Prefer machines from `@aeon-ui/primitives` (or documented prop projections such as Button `status`).
+2. **Then project UI from those machines** — compound parts, copy, and layout exist only to reflect the chart. Never invent UI for states that are not in a machine.
+3. **UI = f(state)** — the DOM exposes `data-aeon-scope`, `data-aeon-part`, `data-aeon-state`. Style targets those attributes. Do not drive the same concern with parallel React `useState` flags.
+
+## Non-negotiable rules
+1. Do not duplicate open/checked/lifecycle in `useState` when a machine exists in `@aeon-ui/primitives`.
+2. **Button `status` is a prop** (`idle|pending|success|failure|disabled`). Optional: drive it from `buttonLifecycleMachine` via `useAeonMachine` in app code.
+3. **Select / Menu / Popover** share `popoverMachine` — never fork another open/closed chart.
+4. **Combobox** and **Tooltip** use React state today — do not add floating machines without the component checklist.
+5. **Scroll** uses `getScrollSnapshot()` — no XState machine.
+6. If a machine lists N stable states, the UI must represent all N (totality).
+7. Prefer `@aeon-ui/react` (headless) or `@aeon-ui/ui` (styled). Relative TS imports use `.js` extensions inside the Aeon monorepo only.
+8. Primitives stay **universal** — never invent niche components (dating, colour-blind test, pong). Compose from generic parts.
+
+## DOM contract
+Every interactive surface sets anatomy via `partAttrs` from `@aeon-ui/core`:
+- `data-aeon-scope` — family (`button`, `async`, `field`, …)
+- `data-aeon-part` — anatomy key (`root`, `trigger`, …)
+- `data-aeon-state` — allowed snapshot / prop state only
+
+## Before writing JSX
+1. Enumerate machines (or documented status props) for the flow — states and events.
+2. Read the component JSON Schema from `@aeon-ui/schemas` (or pasted catalog) and match parts to those charts.
+3. Compose with documented compound parts (`Dialog.Root`, `Field.Control`, …).
+4. Wire events to machine events or documented props — never invent `isLoading && !isError && hasData` spaghetti when a named state exists.

package/packages/schemas/registry/catalog.json

@@ -0,0 +1,54 @@
+{
+  "$id": "https://aeon-ui.com/registry/catalog.json",
+  "version": "0.1.0",
+  "principle": "UI = f(state)",
+  "description": "Lightweight runtime registry — fetch Aeon component schemas and state-tree JSON on demand instead of bundling every primitive.",
+  "endpoints": {
+    "catalog": "https://aeon-ui.com/registry/catalog.json",
+    "component": "https://aeon-ui.com/registry/components/{id}.json",
+    "machine": "https://aeon-ui.com/registry/machines/{id}.json"
+  },
+  "components": [
+    {
+      "id": "button",
+      "title": "Button",
+      "scope": "button",
+      "schemaUrl": "https://aeon-ui.com/registry/components/button.json",
+      "machineUrl": "https://aeon-ui.com/registry/machines/buttonLifecycle.json",
+      "runtime": "status prop",
+      "description": "Action control with idle|pending|success|failure|disabled"
+    },
+    {
+      "id": "async",
+      "title": "Async",
+      "scope": "async",
+      "schemaUrl": "https://aeon-ui.com/registry/components/async.json",
+      "machineUrl": "https://aeon-ui.com/registry/machines/async.json",
+      "runtime": "useAeonMachine",
+      "description": "Fetch lifecycle region with full totality"
+    },
+    {
+      "id": "field",
+      "title": "Field",
+      "scope": "field",
+      "schemaUrl": "https://aeon-ui.com/registry/components/field.json",
+      "machineUrl": "https://aeon-ui.com/registry/machines/field.json",
+      "runtime": "useAeonMachine",
+      "description": "Parallel interaction × validation × submission"
+    },
+    {
+      "id": "dialog",
+      "title": "Dialog",
+      "scope": "dialog",
+      "schemaUrl": "https://aeon-ui.com/registry/components/dialog.json",
+      "machineUrl": "https://aeon-ui.com/registry/machines/dialog.json",
+      "runtime": "useAeonMachine",
+      "description": "Modal open/closed"
+    }
+  ],
+  "client": {
+    "fetchCatalog": "fetch('https://aeon-ui.com/registry/catalog.json').then(r => r.json())",
+    "fetchComponent": "id => fetch(`https://aeon-ui.com/registry/components/${id}.json`).then(r => r.json())",
+    "fetchMachine": "id => fetch(`https://aeon-ui.com/registry/machines/${id}.json`).then(r => r.json())"
+  }
+}

package/packages/schemas/registry/components/accordion.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/accordion.json",
+  "title": "Accordion",
+  "description": "Per-item open state via accordionMachine.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Accordion"
+    },
+    "scope": {
+      "const": "accordion"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "item",
+          "itemTrigger",
+          "itemContent",
+          "itemIndicator"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "open",
+          "closed"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "accordion.root",
+          "description": "accordion.root"
+        },
+        "Item": {
+          "const": "accordion.item",
+          "description": "accordion.item"
+        },
+        "ItemTrigger": {
+          "const": "accordion.itemTrigger",
+          "description": "accordion.itemTrigger"
+        },
+        "ItemContent": {
+          "const": "accordion.itemContent",
+          "description": "accordion.itemContent"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "accordionMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "TOGGLE"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "accordion",
+    "parts": [
+      "root",
+      "item",
+      "itemTrigger",
+      "itemContent",
+      "itemIndicator"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": "accordionMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "TOGGLE"
+    ],
+    "slots": {
+      "Root": "accordion.root",
+      "Item": "accordion.item",
+      "ItemTrigger": "accordion.itemTrigger",
+      "ItemContent": "accordion.itemContent"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/registry/components/async.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/async.json",
+  "title": "Async",
+  "description": "Fetch region with full lifecycle totality: idle → loading → success|empty|failure. Always render every stable state in demos.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Async"
+    },
+    "scope": {
+      "const": "async"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "track",
+          "segment",
+          "readout",
+          "readoutRail",
+          "readoutBody",
+          "actions"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "loading",
+          "success",
+          "empty",
+          "failure"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "async.root",
+          "description": "async.root"
+        },
+        "Track": {
+          "const": "async.track",
+          "description": "async.track"
+        },
+        "Segment": {
+          "const": "async.segment",
+          "description": "async.segment"
+        },
+        "Readout": {
+          "const": "async.readout",
+          "description": "async.readout"
+        },
+        "Actions": {
+          "const": "async.actions",
+          "description": "async.actions"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "createAsyncMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "FETCH",
+          "RESOLVE",
+          "REJECT",
+          "RESET",
+          "STALE",
+          "REFRESH"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [
+        "<Async.Root>\n  {/* Content faces via asyncStatusToContentState — not Track */}\n  <Async.Actions />\n</Async.Root>"
+      ]
+    }
+  },
+  "x-aeon": {
+    "scope": "async",
+    "parts": [
+      "root",
+      "track",
+      "segment",
+      "readout",
+      "readoutRail",
+      "readoutBody",
+      "actions"
+    ],
+    "states": [
+      "idle",
+      "loading",
+      "success",
+      "empty",
+      "failure"
+    ],
+    "machine": "createAsyncMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "FETCH",
+      "RESOLVE",
+      "REJECT",
+      "RESET",
+      "STALE",
+      "REFRESH"
+    ],
+    "slots": {
+      "Root": "async.root",
+      "Track": "async.track",
+      "Segment": "async.segment",
+      "Readout": "async.readout",
+      "Actions": "async.actions"
+    },
+    "examples": [
+      "<Async.Root>\n  {/* Content faces via asyncStatusToContentState — not Track */}\n  <Async.Actions />\n</Async.Root>"
+    ]
+  }
+}