aeon-ui-engine 1.3.1 → 1.4.0

package/packages/schemas/json/appNav.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/appNav.json",
+  "title": "AppNav",
+  "description": "Section + detail stack via appNavMachine — list→detail, settings drill-in.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "AppNav"
+    },
+    "scope": {
+      "const": "appNav"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "rail",
+          "section",
+          "stage",
+          "breadcrumb",
+          "crumb",
+          "back"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "section"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "appNav.root",
+          "description": "appNav.root"
+        },
+        "Rail": {
+          "const": "appNav.rail",
+          "description": "appNav.rail"
+        },
+        "Stage": {
+          "const": "appNav.stage",
+          "description": "appNav.stage"
+        },
+        "Back": {
+          "const": "appNav.back",
+          "description": "appNav.back"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "appNavMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "SET_SECTION",
+          "PUSH",
+          "REPLACE",
+          "POP",
+          "POP_TO",
+          "CLEAR",
+          "RESET"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "appNav",
+    "parts": [
+      "root",
+      "rail",
+      "section",
+      "stage",
+      "breadcrumb",
+      "crumb",
+      "back"
+    ],
+    "states": [
+      "section"
+    ],
+    "machine": "appNavMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "SET_SECTION",
+      "PUSH",
+      "REPLACE",
+      "POP",
+      "POP_TO",
+      "CLEAR",
+      "RESET"
+    ],
+    "slots": {
+      "Root": "appNav.root",
+      "Rail": "appNav.rail",
+      "Stage": "appNav.stage",
+      "Back": "appNav.back"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/appShell.json

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://aeon-ui.com/schemas/appShell.json",
+  "title": "AppShell",
+  "description": "Application chrome frame via appShellMachine — idle | overlayOpen (+ dockVisible).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "component",
+    "scope"
+  ],
+  "properties": {
+    "component": {
+      "const": "AppShell"
+    },
+    "scope": {
+      "const": "appShell"
+    },
+    "parts": {
+      "type": "array",
+      "description": "Anatomy part keys — map to data-aeon-part",
+      "items": {
+        "type": "string",
+        "enum": [
+          "root",
+          "header",
+          "subheader",
+          "content",
+          "aside",
+          "footer",
+          "dock",
+          "scrim"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "states": {
+      "type": "array",
+      "description": "Allowed data-aeon-state values (stable states only)",
+      "items": {
+        "type": "string",
+        "enum": [
+          "idle",
+          "overlayOpen"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "props": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "slots": {
+      "type": "object",
+      "description": "Named composition slots / compound parts",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "properties": {
+        "Root": {
+          "const": "appShell.root",
+          "description": "appShell.root"
+        },
+        "Header": {
+          "const": "appShell.header",
+          "description": "appShell.header"
+        },
+        "Content": {
+          "const": "appShell.content",
+          "description": "appShell.content"
+        },
+        "Dock": {
+          "const": "appShell.dock",
+          "description": "appShell.dock"
+        },
+        "Scrim": {
+          "const": "appShell.scrim",
+          "description": "appShell.scrim"
+        }
+      }
+    },
+    "machine": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "description": "XState machine export from @aeon-ui/primitives, or null if prop/React driven",
+      "const": "appShellMachine"
+    },
+    "runtime": {
+      "type": "string",
+      "description": "How headless state is driven at runtime",
+      "const": "useAeonMachine"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "OPEN_OVERLAY",
+          "CLOSE_OVERLAY",
+          "SHOW_DOCK",
+          "HIDE_DOCK",
+          "SET_DOCK"
+        ]
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    }
+  },
+  "x-aeon": {
+    "scope": "appShell",
+    "parts": [
+      "root",
+      "header",
+      "subheader",
+      "content",
+      "aside",
+      "footer",
+      "dock",
+      "scrim"
+    ],
+    "states": [
+      "idle",
+      "overlayOpen"
+    ],
+    "machine": "appShellMachine",
+    "runtime": "useAeonMachine",
+    "events": [
+      "OPEN_OVERLAY",
+      "CLOSE_OVERLAY",
+      "SHOW_DOCK",
+      "HIDE_DOCK",
+      "SET_DOCK"
+    ],
+    "slots": {
+      "Root": "appShell.root",
+      "Header": "appShell.header",
+      "Content": "appShell.content",
+      "Dock": "appShell.dock",
+      "Scrim": "appShell.scrim"
+    },
+    "examples": []
+  }
+}

package/packages/schemas/json/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/json/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/json/button.json

@@ -79,6 +79,10 @@
         },
         "disabled": {
           "type": "boolean"
+        },
+        "asChild": {
+          "type": "boolean",
+          "description": "Merge button attrs onto a single child element (Link, a)."
         }
       }
     },
@@ -134,6 +138,7 @@
       },
       "default": [
         "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+        "<Button.Root asChild variant=\"solid\"><a href=\"/upload\">Upload</a></Button.Root>",
         "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
       ]
     }
@@ -164,6 +169,7 @@
     },
     "examples": [
       "<Button.Root status=\"pending\" aria-busy>Saving…</Button.Root>",
+      "<Button.Root asChild variant=\"solid\"><a href=\"/upload\">Upload</a></Button.Root>",
       "const [snap, send] = useAeonMachine(buttonLifecycleMachine)\n<Button.Root status={snap.value as ButtonStatus} onClick={() => send({ type: 'PRESS' })} />"
     ]
   }