aeon-ui-engine 1.3.1 → 1.4.0

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

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

@@ -0,0 +1,168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/fileUpload.json",
+  "title": "FileUpload",
+  "description": "Drag-drop surface via fileUploadMachine — idle | dragging | rejected. File bytes stay in React callbacks.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "FileUpload"
+    },
+    "scope": {
+      "const": "fileUpload"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "dropzone",
+          "input",
+          "label",
+          "hint",
+          "preview",
+          "clearTrigger",
+          "rejectionMessage"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "dragging",
+          "rejected"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "fileUpload.root",
+          "description": "fileUpload.root"
+        },
+        "Dropzone": {
+          "const": "fileUpload.dropzone",
+          "description": "fileUpload.dropzone"
+        },
+        "Input": {
+          "const": "fileUpload.input",
+          "description": "fileUpload.input"
+        },
+        "Label": {
+          "const": "fileUpload.label",
+          "description": "fileUpload.label"
+        },
+        "Hint": {
+          "const": "fileUpload.hint",
+          "description": "fileUpload.hint"
+        },
+        "Preview": {
+          "const": "fileUpload.preview",
+          "description": "fileUpload.preview"
+        },
+        "ClearTrigger": {
+          "const": "fileUpload.clearTrigger",
+          "description": "fileUpload.clearTrigger"
+        },
+        "RejectionMessage": {
+          "const": "fileUpload.rejectionMessage",
+          "description": "fileUpload.rejectionMessage"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "fileUploadMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "DRAG_OVER",
+          "DRAG_LEAVE",
+          "DROP_ACCEPT",
+          "DROP_REJECT",
+          "RESET"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "fileUpload",
+    "parts": [
+      "root",
+      "dropzone",
+      "input",
+      "label",
+      "hint",
+      "preview",
+      "clearTrigger",
+      "rejectionMessage"
+    ],
+    "states": [
+      "idle",
+      "dragging",
+      "rejected"
+    ],
+    "machine": "fileUploadMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "DRAG_OVER",
+      "DRAG_LEAVE",
+      "DROP_ACCEPT",
+      "DROP_REJECT",
+      "RESET"
+    ],
+    "slots": {
+      "Root": "fileUpload.root",
+      "Dropzone": "fileUpload.dropzone",
+      "Input": "fileUpload.input",
+      "Label": "fileUpload.label",
+      "Hint": "fileUpload.hint",
+      "Preview": "fileUpload.preview",
+      "ClearTrigger": "fileUpload.clearTrigger",
+      "RejectionMessage": "fileUpload.rejectionMessage"
+    },
+    "examples": []
+  }
+}

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

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/identity.json",
+  "title": "Identity",
+  "description": "Avatar + title + subtitle strip — presentational layout, not a niche product scope.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Identity"
+    },
+    "scope": {
+      "const": "identity"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "avatar",
+          "title",
+          "subtitle",
+          "meta",
+          "trailing"
+        ]
+      },
+      "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": {
+        "size": {
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ]
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "identity.root",
+          "description": "identity.root"
+        },
+        "Avatar": {
+          "const": "identity.avatar",
+          "description": "identity.avatar"
+        },
+        "Title": {
+          "const": "identity.title",
+          "description": "identity.title"
+        },
+        "Subtitle": {
+          "const": "identity.subtitle",
+          "description": "identity.subtitle"
+        },
+        "Meta": {
+          "const": "identity.meta",
+          "description": "identity.meta"
+        },
+        "Trailing": {
+          "const": "identity.trailing",
+          "description": "identity.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": "identity",
+    "parts": [
+      "root",
+      "avatar",
+      "title",
+      "subtitle",
+      "meta",
+      "trailing"
+    ],
+    "states": [
+      "idle"
+    ],
+    "machine": null,
+    "runtime": "layout",
+    "events": [],
+    "slots": {
+      "Root": "identity.root",
+      "Avatar": "identity.avatar",
+      "Title": "identity.title",
+      "Subtitle": "identity.subtitle",
+      "Meta": "identity.meta",
+      "Trailing": "identity.trailing"
+    },
+    "examples": []
+  }
+}