aeon-ui-engine 1.0.2 → 1.1.0

package/packages/schemas/json/menu.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/menu.json",
+  "title": "Menu",
+  "description": "Shares popoverMachine with Popover/Select open state.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Menu"
+    },
+    "scope": {
+      "const": "menu"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "trigger",
+          "positioner",
+          "content",
+          "item",
+          "separator"
+        ]
+      },
+      "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": "menu.root",
+          "description": "menu.root"
+        },
+        "Trigger": {
+          "const": "menu.trigger",
+          "description": "menu.trigger"
+        },
+        "Content": {
+          "const": "menu.content",
+          "description": "menu.content"
+        },
+        "Item": {
+          "const": "menu.item",
+          "description": "menu.item"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "popoverMachine"
+    },
+    "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": "menu",
+    "parts": [
+      "root",
+      "trigger",
+      "positioner",
+      "content",
+      "item",
+      "separator"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": "popoverMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "OPEN",
+      "CLOSE",
+      "TOGGLE"
+    ],
+    "slots": {
+      "Root": "menu.root",
+      "Trigger": "menu.trigger",
+      "Content": "menu.content",
+      "Item": "menu.item"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/popover.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/popover.json",
+  "title": "Popover",
+  "description": "Floating surface — shares popoverMachine. Do not fork a duplicate open/closed chart.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Popover"
+    },
+    "scope": {
+      "const": "popover"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "trigger",
+          "positioner",
+          "content",
+          "arrow",
+          "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": "popover.root",
+          "description": "popover.root"
+        },
+        "Trigger": {
+          "const": "popover.trigger",
+          "description": "popover.trigger"
+        },
+        "Content": {
+          "const": "popover.content",
+          "description": "popover.content"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "popoverMachine"
+    },
+    "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": "popover",
+    "parts": [
+      "root",
+      "trigger",
+      "positioner",
+      "content",
+      "arrow",
+      "closeTrigger"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": "popoverMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "OPEN",
+      "CLOSE",
+      "TOGGLE"
+    ],
+    "slots": {
+      "Root": "popover.root",
+      "Trigger": "popover.trigger",
+      "Content": "popover.content"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/progress.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/progress.json",
+  "title": "Progress",
+  "description": "Prop-driven progress: value + indeterminate → idle | loading | complete.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Progress"
+    },
+    "scope": {
+      "const": "progress"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "track",
+          "range",
+          "label"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "loading",
+          "complete"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "value": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "indeterminate": {
+          "type": "boolean"
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "progress.root",
+          "description": "progress.root"
+        },
+        "Track": {
+          "const": "progress.track",
+          "description": "progress.track"
+        },
+        "Range": {
+          "const": "progress.range",
+          "description": "progress.range"
+        },
+        "Label": {
+          "const": "progress.label",
+          "description": "progress.label"
+        }
+      }
+    },
+    "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": "progress",
+    "parts": [
+      "root",
+      "track",
+      "range",
+      "label"
+    ],
+    "states": [
+      "idle",
+      "loading",
+      "complete"
+    ],
+    "machine": null,
+    "runtime": "props",
+    "events": [],
+    "slots": {
+      "Root": "progress.root",
+      "Track": "progress.track",
+      "Range": "progress.range",
+      "Label": "progress.label"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/scroll.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/scroll.json",
+  "title": "Scroll",
+  "description": "Derived overflow/edge snapshot via getScrollSnapshot() — no XState machine.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Scroll"
+    },
+    "scope": {
+      "const": "scroll"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "viewport",
+          "content"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "start",
+          "middle",
+          "end",
+          "overflow-x",
+          "overflow-y",
+          "overflow-both"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "scroll.root",
+          "description": "scroll.root"
+        },
+        "Viewport": {
+          "const": "scroll.viewport",
+          "description": "scroll.viewport"
+        },
+        "Content": {
+          "const": "scroll.content",
+          "description": "scroll.content"
+        }
+      }
+    },
+    "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": "getScrollSnapshot"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": []
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "scroll",
+    "parts": [
+      "root",
+      "viewport",
+      "content"
+    ],
+    "states": [
+      "idle",
+      "start",
+      "middle",
+      "end",
+      "overflow-x",
+      "overflow-y",
+      "overflow-both"
+    ],
+    "machine": null,
+    "runtime": "getScrollSnapshot",
+    "events": [],
+    "slots": {
+      "Root": "scroll.root",
+      "Viewport": "scroll.viewport",
+      "Content": "scroll.content"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/select.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/select.json",
+  "title": "Select",
+  "description": "Open/closed via popoverMachine; highlight may be React-local. Do not invent a new open machine.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Select"
+    },
+    "scope": {
+      "const": "select"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "trigger",
+          "value",
+          "icon",
+          "positioner",
+          "content",
+          "item"
+        ]
+      },
+      "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": "select.root",
+          "description": "select.root"
+        },
+        "Trigger": {
+          "const": "select.trigger",
+          "description": "select.trigger"
+        },
+        "Content": {
+          "const": "select.content",
+          "description": "select.content"
+        },
+        "Item": {
+          "const": "select.item",
+          "description": "select.item"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "popoverMachine"
+    },
+    "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": "select",
+    "parts": [
+      "root",
+      "trigger",
+      "value",
+      "icon",
+      "positioner",
+      "content",
+      "item"
+    ],
+    "states": [
+      "open",
+      "closed"
+    ],
+    "machine": "popoverMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "OPEN",
+      "CLOSE",
+      "TOGGLE"
+    ],
+    "slots": {
+      "Root": "select.root",
+      "Trigger": "select.trigger",
+      "Content": "select.content",
+      "Item": "select.item"
+    },
+    "examples": []
+  }
+}