@adia-ai/web-components 0.4.7 → 0.4.9

package/components/radio/radio.a2ui.json

@@ -76,6 +76,7 @@
       }
     ],
     "category": "input",
+    "composes": [],
     "events": {
       "change": {
         "description": "Fired when this radio becomes selected (bubbles)"

package/components/range/range.a2ui.json

@@ -74,6 +74,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "input",
+    "composes": [],
     "events": {
       "change": {
         "description": "Fired on drag end or keyboard commit"

package/components/rating/rating.a2ui.json

@@ -74,6 +74,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "form",
+    "composes": [],
     "events": {
       "[object Object]": {
         "description": "Fired on [object Object]."

package/components/richtext/richtext.a2ui.json

@@ -34,6 +34,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "forms",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/richtext/richtext.d.ts

@@ -5,8 +5,9 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/row/row.a2ui.json

@@ -54,6 +54,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "layout",
+    "composes": [],
     "events": {
       "drag-end": {
         "description": "Fired when a drag completes."

package/components/row/row.d.ts

@@ -5,12 +5,15 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';
 
+export type RowDragEndEvent = CustomEvent<unknown>;
+
 export class UIRow extends UIElement {
   /** Align items */
   align: string;
@@ -24,4 +27,11 @@ export class UIRow extends UIElement {
   justify: string;
   /** Enable flex wrap */
   wrap: boolean;
+
+  addEventListener<K extends keyof HTMLElementEventMap>(
+    type: K,
+    listener: (this: UIRow, ev: HTMLElementEventMap[K]) => unknown,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+  addEventListener(type: 'drag-end', listener: (ev: RowDragEndEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
 }

package/components/search/search.a2ui.json

@@ -54,6 +54,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "input",
+    "composes": [],
     "events": {
       "clear": {
         "description": "Fired when the clear button is clicked"

package/components/section/section.a2ui.json

@@ -34,6 +34,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "container",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/segment/segment.a2ui.json

@@ -49,6 +49,9 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "navigation",
+    "composes": [
+      "icon-ui"
+    ],
     "events": {},
     "examples": [
       {

package/components/segment/segment.d.ts

@@ -5,8 +5,9 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/segment/segment.yaml

@@ -7,6 +7,10 @@ component: Segment
 category: navigation
 version: 1
 description: Individual segment option, child of segmented-ui.
+# Per ADR-0027 — primitives that programmatically create other primitives
+# do NOT auto-import them. Consumer (or demo shell) must explicitly import.
+composes:
+  - icon-ui
 props:
   disabled:
     description: Disables this segment.

package/components/segmented/segmented.a2ui.json

@@ -29,6 +29,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "navigation",
+    "composes": [],
     "events": {
       "change": {
         "description": "Fired when the selected segment changes. detail contains { value }."

package/components/select/select.a2ui.json

@@ -140,6 +140,9 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "input",
+    "composes": [
+      "icon-ui"
+    ],
     "events": {
       "change": {
         "description": "Fired when selected value changes"

package/components/select/select.yaml

@@ -7,6 +7,10 @@ component: Select
 category: input
 version: 1
 description: Alias for ChoicePicker. Dropdown select with options.
+# Per ADR-0027 — primitives that programmatically create other primitives
+# do NOT auto-import them. Consumer (or demo shell) must explicitly import.
+composes:
+  - icon-ui  # chevron + option-row affixes (created in render)
 props:
   name:
     description: Form control name for form data submission

package/components/skeleton/skeleton.a2ui.json

@@ -51,6 +51,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "display",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/skeleton/skeleton.d.ts

@@ -5,8 +5,9 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/slider/slider.a2ui.json

@@ -74,6 +74,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "input",
+    "composes": [],
     "events": {
       "change": {
         "description": "Fired when the value changes (on blur for inputs, on selection for pickers)."

package/components/stack/stack.a2ui.json

@@ -29,6 +29,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "layout",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/stack/stack.d.ts

@@ -5,8 +5,9 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/stat/stat.a2ui.json

@@ -49,6 +49,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "display",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/step-progress/step-progress.a2ui.json

@@ -39,6 +39,7 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "feedback",
+    "composes": [],
     "events": {},
     "examples": [
       {

package/components/step-progress/step-progress.d.ts

@@ -11,8 +11,9 @@ primitive.
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/stepper/stepper.a2ui.json

@@ -34,6 +34,9 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "navigation",
+    "composes": [
+      "icon-ui"
+    ],
     "events": {},
     "examples": [
       {

package/components/stepper/stepper.d.ts

@@ -5,8 +5,9 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';

package/components/stepper/stepper.yaml

@@ -7,6 +7,10 @@ component: Stepper
 category: navigation
 version: 1
 description: Wizard / process stepper — parent step index drives numbered children.
+# Per ADR-0027 — primitives that programmatically create other primitives
+# do NOT auto-import them. Consumer (or demo shell) must explicitly import.
+composes:
+  - icon-ui
 props:
   orientation:
     description: horizontal | vertical

package/components/stream/stream.a2ui.json

@@ -39,12 +39,19 @@
   "x-adiaui": {
     "anti_patterns": [],
     "category": "agent",
+    "composes": [],
     "events": {
       "stream-end": {
         "description": "Fired when stream completes naturally"
       },
       "stream-error": {
-        "description": "Fired on stream error, detail: { error }"
+        "description": "Fired on stream error, detail: { error }",
+        "detail": {
+          "error": {
+            "description": "Error object or message.",
+            "type": "object"
+          }
+        }
       },
       "stream-start": {
         "description": "Fired when streaming begins"

package/components/stream/stream.d.ts

@@ -5,15 +5,34 @@
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
  * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
- * run `npm run components`, then `npm run codegen:dts` to regenerate;
- * or hand-author this file fully if rich event types are needed.
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
  */
 
 import { UIElement } from '../../core/element.js';
 
+export type StreamEndEvent = CustomEvent<unknown>;
+export interface StreamErrorEventDetail {
+  /** Error object or message. */
+  error: Record<string, unknown>;
+}
+
+export type StreamErrorEvent = CustomEvent<StreamErrorEventDetail>;
+export type StreamStartEvent = CustomEvent<unknown>;
+
 export class UIStream extends UIElement {
   /** Milliseconds between character renders. 0 = real-time. */
   pace: number;
   /** Read-only reflected state, true while stream is active */
   streaming: boolean;
+
+  addEventListener<K extends keyof HTMLElementEventMap>(
+    type: K,
+    listener: (this: UIStream, ev: HTMLElementEventMap[K]) => unknown,
+    options?: boolean | AddEventListenerOptions,
+  ): void;
+  addEventListener(type: 'stream-end', listener: (ev: StreamEndEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'stream-error', listener: (ev: StreamErrorEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'stream-start', listener: (ev: StreamStartEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
 }

package/components/stream/stream.yaml

@@ -25,6 +25,10 @@ events:
     description: Fired when stream completes naturally
   stream-error:
     description: "Fired on stream error, detail: { error }"
+    detail:
+      error:
+        type: object
+        description: Error object or message.
   stream-start:
     description: Fired when streaming begins
 slots: