aeon-ui-engine 1.3.1 → 1.4.0

package/packages/schemas/json/stickyBar.json

@@ -0,0 +1,153 @@
+{
+  "$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": []
+  }
+}

package/packages/schemas/json/thread.json

@@ -0,0 +1,129 @@
+{
+  "$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": []
+  }
+}

package/packages/schemas/json/tooltip.json

@@ -2,7 +2,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": [
@@ -75,18 +75,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": {
@@ -110,9 +117,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",

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

@@ -1 +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}]]}
+{"version":"4.1.8","results":[[":src/index.test.ts",{"duration":5.161209000000014,"failed":false}],[":src/aeon-to-schema.test.ts",{"duration":5.569166999999993,"failed":false}]]}

package/packages/schemas/prompts/cursorrules.md

@@ -10,8 +10,8 @@ You are building UI with **Aeon UI**, a React component library powered by finit
 ## 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.
+3. **Select / Menu / Popover / Combobox / Tooltip** share `popoverMachine` for open/closed — never fork another open/closed chart. Combobox keeps query/highlight in React; Tooltip keeps openDelay/closeDelay/touchDuration in React.
+4. **PinInput** digit buffer is React-local today — do not invent a pin machine 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.
@@ -59,6 +59,8 @@ Rule: Pending must set aria-busy. Do not use disabled alone to mean "saving".
 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)
+## Popover family (Popover, Menu, Select, Combobox, Tooltip open state)
 Machine: popoverMachine — states open | closed.
-Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine forks.
+Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine / comboboxOpenMachine / tooltipOpenMachine forks.
+Combobox: query + highlight stay React-local; open/closed must still be popoverMachine.
+Tooltip: openDelay / closeDelay / touchDuration stay React-local; open/closed must still be popoverMachine.

package/packages/schemas/prompts/statecharts.md

@@ -22,10 +22,31 @@ Rule: Pending must set aria-busy. Do not use disabled alone to mean "saving".
 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)
+## Popover family (Popover, Menu, Select, Combobox, Tooltip open state)
 Machine: popoverMachine — states open | closed.
-Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine forks.
+Rule: Reuse this chart. Never create selectOpenMachine / menuOpenMachine / comboboxOpenMachine / tooltipOpenMachine forks.
+Combobox: query + highlight stay React-local; open/closed must still be popoverMachine.
+Tooltip: openDelay / closeDelay / touchDuration stay React-local; open/closed must still be popoverMachine.
 
 ## Switch / Checkbox
 Machine: toggleMachine — checked | unchecked. Events: TOGGLE, CHECK, UNCHECK.
 Rule: Hidden input stays in sync with snapshot for forms.
+
+## Slider statechart
+Machine: sliderMachine — idle | dragging; value/min/max/step in context.
+Events: SET_VALUE, STEP, POINTER_DOWN, POINTER_UP, HOME, END.
+Rule: Disabled blocks SET_VALUE / drag; project idle vs dragging on data-aeon-state.
+
+## Content region statechart
+Machine: contentRegionMachine — idle → pending → (empty | error | ready) → loadingMore | success.
+Events: LOAD, RESOLVE, REJECT, RETRY, LOAD_MORE, MORE_DONE, SUCCEED, RESET.
+Rule: Every stable state has a slot. Pair with Async for fetch; do not hide empty/error behind a spinner.
+
+## Toast item statechart
+Machine: toastMachine — hidden | visible. Events: SHOW, HIDE, DISMISS.
+Rule: Provider list orchestration may use React; each toast item uses the machine.
+
+## StickyBar statechart
+Machine: stickyBarMachine — floating | docked | collapsed | hidden.
+Events: DOCK, FLOAT, COLLAPSE, EXPAND, HIDE, SHOW, SET_OFFSET.
+Rule: DOM scope is bar (bar anatomy zones). Do not invent a parallel sticky useState.

package/packages/schemas/prompts/system.md

@@ -10,8 +10,8 @@ You are building UI with **Aeon UI**, a React component library powered by finit
 ## 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.
+3. **Select / Menu / Popover / Combobox / Tooltip** share `popoverMachine` for open/closed — never fork another open/closed chart. Combobox keeps query/highlight in React; Tooltip keeps openDelay/closeDelay/touchDuration in React.
+4. **PinInput** digit buffer is React-local today — do not invent a pin machine 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.