aeon-ui-engine 1.0.3 → 1.2.0

package/packages/schemas/json/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/json/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>"
+    ]
+  }
+}

package/packages/schemas/json/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' })} />"
+    ]
+  }
+}