aeon-ui-engine 1.3.1 → 1.4.0

package/packages/schemas/json/radioGroup.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/radioGroup.json",
+  "title": "RadioGroup",
+  "description": "Single selection via tabsMachine (same chart family as Tabs/Nav).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "RadioGroup"
+    },
+    "scope": {
+      "const": "radioGroup"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "item",
+          "itemControl",
+          "itemIndicator",
+          "itemLabel"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "selected"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "radioGroup.root",
+          "description": "radioGroup.root"
+        },
+        "Item": {
+          "const": "radioGroup.item",
+          "description": "radioGroup.item"
+        },
+        "ItemControl": {
+          "const": "radioGroup.itemControl",
+          "description": "radioGroup.itemControl"
+        },
+        "ItemLabel": {
+          "const": "radioGroup.itemLabel",
+          "description": "radioGroup.itemLabel"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "tabsMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "SELECT"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "radioGroup",
+    "parts": [
+      "root",
+      "item",
+      "itemControl",
+      "itemIndicator",
+      "itemLabel"
+    ],
+    "states": [
+      "selected"
+    ],
+    "machine": "tabsMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "SELECT"
+    ],
+    "slots": {
+      "Root": "radioGroup.root",
+      "Item": "radioGroup.item",
+      "ItemControl": "radioGroup.itemControl",
+      "ItemLabel": "radioGroup.itemLabel"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/rangeSlider.json

@@ -0,0 +1,157 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/rangeSlider.json",
+  "title": "RangeSlider",
+  "description": "Two-thumb range via rangeSliderMachine — idle | dragging with values pair and minStepsBetween gap.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "RangeSlider"
+    },
+    "scope": {
+      "const": "rangeSlider"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "track",
+          "range",
+          "thumb",
+          "valueText"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "dragging"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "rangeSlider.root",
+          "description": "rangeSlider.root"
+        },
+        "Track": {
+          "const": "rangeSlider.track",
+          "description": "rangeSlider.track"
+        },
+        "Range": {
+          "const": "rangeSlider.range",
+          "description": "rangeSlider.range"
+        },
+        "Thumb": {
+          "const": "rangeSlider.thumb",
+          "description": "rangeSlider.thumb"
+        },
+        "ValueText": {
+          "const": "rangeSlider.valueText",
+          "description": "rangeSlider.valueText"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "rangeSliderMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "SET_VALUES",
+          "SET_BOUNDS",
+          "SET_DISABLED",
+          "POINTER_DOWN",
+          "POINTER_MOVE",
+          "POINTER_UP",
+          "STEP",
+          "HOME",
+          "END"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [
+        "<RangeSlider.Root defaultValue={[20, 80]} minStepsBetween={1}>\n  <RangeSlider.Track /><RangeSlider.Range />\n  <RangeSlider.Thumb index={0} /><RangeSlider.Thumb index={1} />\n</RangeSlider.Root>"
+      ]
+    }
+  },
+  "x-aeon": {
+    "scope": "rangeSlider",
+    "parts": [
+      "root",
+      "track",
+      "range",
+      "thumb",
+      "valueText"
+    ],
+    "states": [
+      "idle",
+      "dragging"
+    ],
+    "machine": "rangeSliderMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "SET_VALUES",
+      "SET_BOUNDS",
+      "SET_DISABLED",
+      "POINTER_DOWN",
+      "POINTER_MOVE",
+      "POINTER_UP",
+      "STEP",
+      "HOME",
+      "END"
+    ],
+    "slots": {
+      "Root": "rangeSlider.root",
+      "Track": "rangeSlider.track",
+      "Range": "rangeSlider.range",
+      "Thumb": "rangeSlider.thumb",
+      "ValueText": "rangeSlider.valueText"
+    },
+    "examples": [
+      "<RangeSlider.Root defaultValue={[20, 80]} minStepsBetween={1}>\n  <RangeSlider.Track /><RangeSlider.Range />\n  <RangeSlider.Thumb index={0} /><RangeSlider.Thumb index={1} />\n</RangeSlider.Root>"
+    ]
+  }
+}

package/packages/schemas/json/separator.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/separator.json",
+  "title": "Separator",
+  "description": "Static divider — orientation prop only.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Separator"
+    },
+    "scope": {
+      "const": "separator"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "horizontal",
+          "vertical"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "separator.root",
+          "description": "separator.root"
+        }
+      }
+    },
+    "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": "separator",
+    "parts": [
+      "root"
+    ],
+    "states": [
+      "horizontal",
+      "vertical"
+    ],
+    "machine": null,
+    "runtime": "props",
+    "events": [],
+    "slots": {
+      "Root": "separator.root"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/slider.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/slider.json",
+  "title": "Slider",
+  "description": "Range control via sliderMachine — idle | dragging plus numeric value in context.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "Slider"
+    },
+    "scope": {
+      "const": "slider"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "track",
+          "range",
+          "thumb",
+          "valueText"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "dragging"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "slider.root",
+          "description": "slider.root"
+        },
+        "Track": {
+          "const": "slider.track",
+          "description": "slider.track"
+        },
+        "Range": {
+          "const": "slider.range",
+          "description": "slider.range"
+        },
+        "Thumb": {
+          "const": "slider.thumb",
+          "description": "slider.thumb"
+        },
+        "ValueText": {
+          "const": "slider.valueText",
+          "description": "slider.valueText"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "sliderMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "SET_VALUE",
+          "STEP",
+          "POINTER_DOWN",
+          "POINTER_UP",
+          "HOME",
+          "END"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "slider",
+    "parts": [
+      "root",
+      "track",
+      "range",
+      "thumb",
+      "valueText"
+    ],
+    "states": [
+      "idle",
+      "dragging"
+    ],
+    "machine": "sliderMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "SET_VALUE",
+      "STEP",
+      "POINTER_DOWN",
+      "POINTER_UP",
+      "HOME",
+      "END"
+    ],
+    "slots": {
+      "Root": "slider.root",
+      "Track": "slider.track",
+      "Range": "slider.range",
+      "Thumb": "slider.thumb",
+      "ValueText": "slider.valueText"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/statusBanner.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/statusBanner.json",
+  "title": "StatusBanner",
+  "description": "Non-blocking top-of-app notice — tone + optional status props project to data-aeon-state.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "StatusBanner"
+    },
+    "scope": {
+      "const": "statusBanner"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "copy",
+          "title",
+          "body",
+          "actions"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "info",
+          "success",
+          "warning",
+          "danger",
+          "neutral"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tone": {
+          "type": "string",
+          "enum": [
+            "info",
+            "success",
+            "warning",
+            "danger",
+            "neutral"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "description": "Optional secondary token appended to data-aeon-state"
+        }
+      }
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "statusBanner.root",
+          "description": "statusBanner.root"
+        },
+        "Title": {
+          "const": "statusBanner.title",
+          "description": "statusBanner.title"
+        },
+        "Body": {
+          "const": "statusBanner.body",
+          "description": "statusBanner.body"
+        },
+        "Actions": {
+          "const": "statusBanner.actions",
+          "description": "statusBanner.actions"
+        }
+      }
+    },
+    "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": "statusBanner",
+    "parts": [
+      "root",
+      "copy",
+      "title",
+      "body",
+      "actions"
+    ],
+    "states": [
+      "info",
+      "success",
+      "warning",
+      "danger",
+      "neutral"
+    ],
+    "machine": null,
+    "runtime": "props",
+    "events": [],
+    "slots": {
+      "Root": "statusBanner.root",
+      "Title": "statusBanner.title",
+      "Body": "statusBanner.body",
+      "Actions": "statusBanner.actions"
+    },
+    "examples": []
+  }
+}