aeon-ui-engine 1.3.0 → 1.3.5

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

package/packages/schemas/json/conversation.json

@@ -0,0 +1,166 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/conversation.json",
+  "title": "Conversation",
+  "description": "Inbox / DM list — item state prop idle | unread | selected. Universal messaging chrome.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Conversation"
+    },
+    "scope": {
+      "const": "conversation"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "item",
+          "leading",
+          "body",
+          "title",
+          "preview",
+          "meta",
+          "badge"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "unread",
+          "selected"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": [
+            "idle",
+            "unread",
+            "selected"
+          ],
+          "default": "idle"
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "conversation.root",
+          "description": "conversation.root"
+        },
+        "Item": {
+          "const": "conversation.item",
+          "description": "conversation.item"
+        },
+        "Leading": {
+          "const": "conversation.leading",
+          "description": "conversation.leading"
+        },
+        "Body": {
+          "const": "conversation.body",
+          "description": "conversation.body"
+        },
+        "Title": {
+          "const": "conversation.title",
+          "description": "conversation.title"
+        },
+        "Preview": {
+          "const": "conversation.preview",
+          "description": "conversation.preview"
+        },
+        "Meta": {
+          "const": "conversation.meta",
+          "description": "conversation.meta"
+        },
+        "Badge": {
+          "const": "conversation.badge",
+          "description": "conversation.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": "props"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": []
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "conversation",
+    "parts": [
+      "root",
+      "item",
+      "leading",
+      "body",
+      "title",
+      "preview",
+      "meta",
+      "badge"
+    ],
+    "states": [
+      "idle",
+      "unread",
+      "selected"
+    ],
+    "machine": null,
+    "runtime": "props",
+    "events": [],
+    "slots": {
+      "Root": "conversation.root",
+      "Item": "conversation.item",
+      "Leading": "conversation.leading",
+      "Body": "conversation.body",
+      "Title": "conversation.title",
+      "Preview": "conversation.preview",
+      "Meta": "conversation.meta",
+      "Badge": "conversation.badge"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/entry.json

@@ -0,0 +1,182 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/entry.json",
+  "title": "Entry",
+  "description": "Universal multi-value card (feed stack or listing split). Root state idle | selected | muted — never invent niche scopes.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Entry"
+    },
+    "scope": {
+      "const": "entry"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "list",
+          "root",
+          "header",
+          "leading",
+          "heading",
+          "title",
+          "subtitle",
+          "meta",
+          "media",
+          "body",
+          "values",
+          "value",
+          "actions",
+          "footer"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "selected",
+          "muted"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": [
+            "idle",
+            "selected",
+            "muted"
+          ],
+          "default": "idle"
+        },
+        "density": {
+          "type": "string",
+          "enum": [
+            "compact",
+            "cozy"
+          ]
+        },
+        "layout": {
+          "type": "string",
+          "enum": [
+            "stack",
+            "split"
+          ]
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "List": {
+          "const": "entry.list",
+          "description": "entry.list"
+        },
+        "Root": {
+          "const": "entry.root",
+          "description": "entry.root"
+        },
+        "Header": {
+          "const": "entry.header",
+          "description": "entry.header"
+        },
+        "Body": {
+          "const": "entry.body",
+          "description": "entry.body"
+        },
+        "Actions": {
+          "const": "entry.actions",
+          "description": "entry.actions"
+        },
+        "Footer": {
+          "const": "entry.footer",
+          "description": "entry.footer"
+        }
+      }
+    },
+    "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": "entry",
+    "parts": [
+      "list",
+      "root",
+      "header",
+      "leading",
+      "heading",
+      "title",
+      "subtitle",
+      "meta",
+      "media",
+      "body",
+      "values",
+      "value",
+      "actions",
+      "footer"
+    ],
+    "states": [
+      "idle",
+      "selected",
+      "muted"
+    ],
+    "machine": null,
+    "runtime": "props",
+    "events": [],
+    "slots": {
+      "List": "entry.list",
+      "Root": "entry.root",
+      "Header": "entry.header",
+      "Body": "entry.body",
+      "Actions": "entry.actions",
+      "Footer": "entry.footer"
+    },
+    "examples": []
+  }
+}