@adia-ai/web-components 0.6.19 → 0.6.20

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog — @adia-ai/web-components
 
+## [0.6.20] — 2026-05-21
+
+### Added — `table-ui` `row-click` event (FEEDBACK-35)
+
+- `<table-ui>` now dispatches a bubbling `row-click` event (detail:
+  `{ row, dataIndex }`) once per row click, alongside the existing per-cell
+  `cell-click`. Master-detail / open-flyout wiring no longer has to
+  deduplicate `cell-click` by `dataIndex`. `table.yaml` documents it.
+
+### Changed — `select-ui` honours declarative `<option selected>` (FEEDBACK-36)
+
+- `<select-ui>` now promotes an `<option selected>` child to the initial
+  value when the host carries no `[value]` attribute — matching native
+  `<select>` semantics. Previously the `selected` attribute was silently
+  ignored and the placeholder shown. Guarded on an empty `this.value`, so
+  consumers who set `[value]` explicitly are unaffected.
+
+### Changed — `chart-ui` wrong-`.data`-shape warning shows the correct shape (FEEDBACK-34)
+
+- The one-shot `console.warn` emitted when `.data` is set to a non-array
+  now embeds a minimal correct-shape example
+  (`[{ label: "Jan", value: 100 }, … ]`) instead of only naming the wrong
+  API and pointing at `chart.yaml`.
+
+### Docs — `table.yaml` / `select.yaml` description clarifications (FEEDBACK-35 §2, FEEDBACK-36)
+
+- `components/table/table.yaml` `sort` event: the `key` / `dir` detail
+  descriptions now name the fields explicitly (`key` not `column`, `dir` not
+  `direction`) — closing the guess the bare names invited.
+- `components/select/select.yaml` `value`: documents that a declarative
+  `<option selected>` child sets the initial value when the host `[value]`
+  attribute is absent.
+
 ## [0.6.19] — 2026-05-21
 
 ### Fixed — `drawer-ui` `innerHTML`-on-host orphaned the internal `<dialog>` (FEEDBACK-30)

package/components/chart/class.js

@@ -260,7 +260,9 @@ export class UIChart extends UIElement {
       console.warn(
         `[chart-ui] .data must be an array of plain objects — received ` +
         `${arr === null ? 'null' : typeof arr}. The {labels, datasets} ` +
-        `envelope is the Chart.js API, not the chart-ui API. See chart.yaml.`,
+        `envelope is the Chart.js API, not the chart-ui API.\n` +
+        `Correct shape for <chart-ui x="label" y="value">:\n` +
+        `  [{ label: "Jan", value: 100 }, { label: "Feb", value: 200 }]`,
       );
     }
     this.#data = Array.isArray(arr) ? arr : [];

package/components/select/class.js

@@ -212,15 +212,20 @@ export class UISelect extends UIFormElement {
     this.#options = [];
     // §225 (v0.5.9): track unknown-child-tag names so we can warn once per element.
     const unknownTags = new Set();
+    // FEEDBACK-36: capture the value of an <option selected> child so a
+    // declarative initial selection is honoured (native <select> parity).
+    let preSelected;
     for (const child of this.children) {
       if (child.tagName === 'OPTGROUP') {
         const group = { label: child.label || child.getAttribute('label') || '', options: [] };
         for (const opt of child.querySelectorAll('option')) {
           group.options.push({ value: opt.value, label: opt.textContent.trim(), disabled: opt.disabled });
+          if (preSelected === undefined && opt.hasAttribute('selected')) preSelected = opt.value;
         }
         this.#options.push(group);
       } else if (child.tagName === 'OPTION') {
         this.#options.push({ value: child.value, label: child.textContent.trim(), disabled: child.disabled });
+        if (preSelected === undefined && child.hasAttribute('selected')) preSelected = child.value;
       } else if (
         // §225: skip [slot="display"] / [slot="listbox"] / [slot="action"] etc. — these are
         // stamped by the component itself, not consumer-authored options. Anything other
@@ -231,6 +236,10 @@ export class UISelect extends UIFormElement {
       }
     }
     for (const child of [...this.querySelectorAll('option, optgroup')]) child.remove();
+    // FEEDBACK-36: honour <option selected> as the initial value when the host
+    // carries no [value] — matches native <select> semantics. Guarded on an
+    // empty this.value so consumers who set [value] explicitly are unaffected.
+    if (!this.value && preSelected !== undefined) this.value = preSelected;
     // §225 (v0.5.9): warn once per element when consumer authored non-<option> children.
     if (unknownTags.size > 0 && !UISelect.#warnedNonOption.has(this)) {
       UISelect.#warnedNonOption.add(this);

package/components/select/select.a2ui.json

@@ -122,7 +122,7 @@
       "default": "md"
     },
     "value": {
-      "description": "Currently selected option value",
+      "description": "Currently selected option value. With declarative <option> children, a child carrying the native `selected` attribute sets the initial value when this attribute is absent (native <select> parity).",
       "type": "string",
       "default": ""
     },

package/components/select/select.yaml

@@ -111,7 +111,10 @@ props:
     type: boolean
     default: false
   value:
-    description: Currently selected option value
+    description: >-
+      Currently selected option value. With declarative <option> children, a
+      child carrying the native `selected` attribute sets the initial value
+      when this attribute is absent (native <select> parity).
     type: string
     default: ""
 events:

package/components/table/class.js

@@ -47,6 +47,7 @@
  *   page       — { detail: { page } }
  *   resize     — { detail: { key, width } }
  *   cell-click — { detail: { key, row, value, dataIndex } }
+ *   row-click  — { detail: { row, dataIndex } }  — row-level companion to cell-click
  */
 
 import { UIElement } from '../../core/element.js';
@@ -1303,6 +1304,13 @@ export class UITable extends UIElement {
           bubbles: true,
           detail: { key, row: rowData, value, dataIndex },
         }));
+        // FEEDBACK-35: row-click convenience event — fires once per row,
+        // regardless of which cell was hit. detail is a strict subset of
+        // cell-click (no key/value) so it reads as row identity, not a cell.
+        this.dispatchEvent(new CustomEvent('row-click', {
+          bubbles: true,
+          detail: { row: rowData, dataIndex },
+        }));
       }
     }
   };

package/components/table/table.a2ui.json

@@ -144,6 +144,19 @@
           }
         }
       },
+      "row-click": {
+        "description": "Fired once when any cell in a data row is clicked — the row-level companion to cell-click. Use it for master-detail / open-flyout wiring.",
+        "detail": {
+          "dataIndex": {
+            "description": "Row index in the underlying data array.",
+            "type": "number"
+          },
+          "row": {
+            "description": "Row data object.",
+            "type": "object"
+          }
+        }
+      },
       "row-collapse": {
         "description": "Fired when an already-expanded row's chevron is activated (collapses the row). Mirror of row-expand.",
         "detail": {
@@ -183,11 +196,11 @@
         "description": "Fired when sort state changes via header click.",
         "detail": {
           "dir": {
-            "description": "Sort direction — \"asc\" / \"desc\" / null (cleared).",
+            "description": "Sort direction — \"asc\" / \"desc\" / null (cleared). The detail field is `dir` (not `direction`).",
             "type": "string"
           },
           "key": {
-            "description": "Column key being sorted.",
+            "description": "Column key being sorted — the detail field is `key` (not `column`).",
             "type": "string"
           },
           "sortState": {

package/components/table/table.d.ts

@@ -44,6 +44,14 @@ export interface TableResizeEventDetail {
 }
 
 export type TableResizeEvent = CustomEvent<TableResizeEventDetail>;
+export interface TableRowClickEventDetail {
+  /** Row index in the underlying data array. */
+  dataIndex: number;
+  /** Row data object. */
+  row: Record<string, unknown>;
+}
+
+export type TableRowClickEvent = CustomEvent<TableRowClickEventDetail>;
 export interface TableRowCollapseEventDetail {
   /** Row index in the underlying data array. */
   index: number;
@@ -67,9 +75,9 @@ export interface TableSelectEventDetail {
 
 export type TableSelectEvent = CustomEvent<TableSelectEventDetail>;
 export interface TableSortEventDetail {
-  /** Sort direction — "asc" / "desc" / null (cleared). */
+  /** Sort direction — "asc" / "desc" / null (cleared). The detail field is `dir` (not `direction`). */
   dir: string;
-  /** Column key being sorted. */
+  /** Column key being sorted — the detail field is `key` (not `column`). */
   key: string;
   /** Full sort state array (multi-column support). */
   sortState: unknown[];
@@ -110,6 +118,7 @@ export class UITable extends UIElement {
   addEventListener(type: 'filter-change', listener: (ev: TableFilterChangeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
   addEventListener(type: 'page', listener: (ev: TablePageEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
   addEventListener(type: 'resize', listener: (ev: TableResizeEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
+  addEventListener(type: 'row-click', listener: (ev: TableRowClickEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
   addEventListener(type: 'row-collapse', listener: (ev: TableRowCollapseEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
   addEventListener(type: 'row-expand', listener: (ev: TableRowExpandEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
   addEventListener(type: 'select', listener: (ev: TableSelectEvent) => unknown, options?: boolean | AddEventListenerOptions): void;

package/components/table/table.yaml

@@ -91,6 +91,15 @@ events:
       dataIndex:
         type: number
         description: Row index in the underlying data array.
+  row-click:
+    description: Fired once when any cell in a data row is clicked — the row-level companion to cell-click. Use it for master-detail / open-flyout wiring.
+    detail:
+      row:
+        type: object
+        description: Row data object.
+      dataIndex:
+        type: number
+        description: Row index in the underlying data array.
   filter-change:
     description: Fired when an interactive filter row applies / clears. detail.filters is the current filter map.
     detail:
@@ -141,10 +150,10 @@ events:
     detail:
       key:
         type: string
-        description: Column key being sorted.
+        description: Column key being sorted — the detail field is `key` (not `column`).
       dir:
         type: string
-        description: Sort direction — "asc" / "desc" / null (cleared).
+        description: Sort direction — "asc" / "desc" / null (cleared). The detail field is `dir` (not `direction`).
       sortState:
         type: array
         description: Full sort state array (multi-column support).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.6.19",
+  "version": "0.6.20",
   "description": "AdiaUI web components \u2014 vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-runtime.",
   "type": "module",
   "types": "./index.d.ts",