aeon-ui-engine 1.0.3 → 1.1.0

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

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/button.json",
+  "title": "Button",
+  "description": "Action control. status is a prop projection (not an in-tree machine). Never invent parallel useState for lifecycle.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Button"
+    },
+    "scope": {
+      "const": "button"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "group",
+          "label",
+          "icon"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "pending",
+          "success",
+          "failure",
+          "disabled"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "idle",
+            "pending",
+            "success",
+            "failure",
+            "disabled"
+          ],
+          "default": "idle"
+        },
+        "variant": {
+          "type": "string",
+          "enum": [
+            "solid",
+            "outline",
+            "ghost",
+            "link"
+          ]
+        },
+        "size": {
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ]
+        },
+        "disabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "button.root",
+          "description": "button.root"
+        },
+        "Group": {
+          "const": "button.group",
+          "description": "button.group"
+        },
+        "Label": {
+          "const": "button.label",
+          "description": "button.label"
+        },
+        "Icon": {
+          "const": "button.icon",
+          "description": "button.icon"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "buttonLifecycleMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "status prop"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": []
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [
+        "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+        "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
+      ]
+    }
+  },
+  "x-aeon": {
+    "scope": "button",
+    "parts": [
+      "root",
+      "group",
+      "label",
+      "icon"
+    ],
+    "states": [
+      "idle",
+      "pending",
+      "success",
+      "failure",
+      "disabled"
+    ],
+    "machine": "buttonLifecycleMachine",
+    "runtime": "status prop",
+    "events": [],
+    "slots": {
+      "Root": "button.root",
+      "Group": "button.group",
+      "Label": "button.label",
+      "Icon": "button.icon"
+    },
+    "examples": [
+      "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+      "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
+    ]
+  }
+}

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

@@ -0,0 +1,136 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/checkbox.json",
+  "title": "Checkbox",
+  "description": "Binary toggle via toggleMachine (same chart family as Switch).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Checkbox"
+    },
+    "scope": {
+      "const": "checkbox"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "control",
+          "indicator",
+          "label",
+          "hiddenInput"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "checked",
+          "unchecked"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "checkbox.root",
+          "description": "checkbox.root"
+        },
+        "Control": {
+          "const": "checkbox.control",
+          "description": "checkbox.control"
+        },
+        "Indicator": {
+          "const": "checkbox.indicator",
+          "description": "checkbox.indicator"
+        },
+        "Label": {
+          "const": "checkbox.label",
+          "description": "checkbox.label"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "toggleMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "TOGGLE",
+          "CHECK",
+          "UNCHECK"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "checkbox",
+    "parts": [
+      "root",
+      "control",
+      "indicator",
+      "label",
+      "hiddenInput"
+    ],
+    "states": [
+      "checked",
+      "unchecked"
+    ],
+    "machine": "toggleMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "TOGGLE",
+      "CHECK",
+      "UNCHECK"
+    ],
+    "slots": {
+      "Root": "checkbox.root",
+      "Control": "checkbox.control",
+      "Indicator": "checkbox.indicator",
+      "Label": "checkbox.label"
+    },
+    "examples": []
+  }
+}

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

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/combobox.json",
+  "title": "Combobox",
+  "description": "Typeahead — React useState for open/query/highlight today. Do not add a duplicate floating machine without COMPONENT_CHECKLIST.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Combobox"
+    },
+    "scope": {
+      "const": "combobox"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "input",
+          "icon",
+          "content",
+          "item",
+          "empty"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "open",
+          "closed"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "combobox.root",
+          "description": "combobox.root"
+        },
+        "Input": {
+          "const": "combobox.input",
+          "description": "combobox.input"
+        },
+        "Content": {
+          "const": "combobox.content",
+          "description": "combobox.content"
+        },
+        "Item": {
+          "const": "combobox.item",
+          "description": "combobox.item"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": null
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useState"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": []
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "combobox",
+    "parts": [
+      "root",
+      "input",
+      "icon",
+      "content",
+      "item",
+      "empty"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": null,
+    "runtime": "useState",
+    "events": [],
+    "slots": {
+      "Root": "combobox.root",
+      "Input": "combobox.input",
+      "Content": "combobox.content",
+      "Item": "combobox.item"
+    },
+    "examples": []
+  }
+}

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

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/dialog.json",
+  "title": "Dialog",
+  "description": "Modal open/closed via dialogMachine. Dismissal is a transition, not ad hoc flags.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Dialog"
+    },
+    "scope": {
+      "const": "dialog"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "trigger",
+          "portal",
+          "backdrop",
+          "positioner",
+          "content",
+          "title",
+          "description",
+          "closeTrigger"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "open",
+          "closed"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "dialog.root",
+          "description": "dialog.root"
+        },
+        "Trigger": {
+          "const": "dialog.trigger",
+          "description": "dialog.trigger"
+        },
+        "Content": {
+          "const": "dialog.content",
+          "description": "dialog.content"
+        },
+        "Title": {
+          "const": "dialog.title",
+          "description": "dialog.title"
+        },
+        "Description": {
+          "const": "dialog.description",
+          "description": "dialog.description"
+        },
+        "CloseTrigger": {
+          "const": "dialog.closeTrigger",
+          "description": "dialog.closeTrigger"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "dialogMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "OPEN",
+          "CLOSE",
+          "TOGGLE"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "dialog",
+    "parts": [
+      "root",
+      "trigger",
+      "portal",
+      "backdrop",
+      "positioner",
+      "content",
+      "title",
+      "description",
+      "closeTrigger"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": "dialogMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "OPEN",
+      "CLOSE",
+      "TOGGLE"
+    ],
+    "slots": {
+      "Root": "dialog.root",
+      "Trigger": "dialog.trigger",
+      "Content": "dialog.content",
+      "Title": "dialog.title",
+      "Description": "dialog.description",
+      "CloseTrigger": "dialog.closeTrigger"
+    },
+    "examples": []
+  }
+}