aeon-ui-engine 1.3.0 → 1.3.5

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

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

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

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

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

@@ -2,7 +2,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": [
@@ -80,18 +80,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": {
@@ -116,9 +122,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",

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

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

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

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