@adia-ai/web-components 0.5.8 → 0.5.9

package/components/menu/menu-item.a2ui.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://adiaui.dev/a2ui/v0_9/components/MenuItem.json",
+  "title": "MenuItem",
+  "description": "Child of `<menu-ui>`. One actionable row inside a menu, with optional leading icon + label + value.",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "common_types.json#/$defs/ComponentCommon"
+    },
+    {
+      "$ref": "common_types.json#/$defs/CatalogComponentCommon"
+    }
+  ],
+  "properties": {
+    "component": {
+      "const": "MenuItem"
+    },
+    "disabled": {
+      "description": "Disabled state — blocks pointer + keyboard activation.",
+      "type": "boolean",
+      "default": false
+    },
+    "icon": {
+      "description": "Optional leading Phosphor icon name.",
+      "type": "string",
+      "default": ""
+    },
+    "text": {
+      "description": "Item label text.",
+      "type": "string",
+      "default": ""
+    },
+    "value": {
+      "description": "Stable identifier emitted via the parent menu's `select` event.",
+      "type": "string",
+      "default": ""
+    },
+    "variant": {
+      "description": "Semantic variant.",
+      "type": "string",
+      "enum": [
+        "default",
+        "danger"
+      ],
+      "default": "default"
+    }
+  },
+  "required": [
+    "component"
+  ],
+  "unevaluatedProperties": false,
+  "x-adiaui": {
+    "anti_patterns": [],
+    "category": "navigation",
+    "composes": [],
+    "events": {},
+    "examples": [],
+    "keywords": [],
+    "name": "UIMenuItem",
+    "related": [],
+    "slots": {
+      "icon": {
+        "description": "Custom leading element override; falls through to `[icon]` prop if not slotted."
+      },
+      "text": {
+        "description": "Custom label content; falls through to `[text]` prop if not slotted."
+      }
+    },
+    "states": [],
+    "synonyms": {},
+    "tag": "menu-item-ui",
+    "tokens": {},
+    "traits": [],
+    "version": 1
+  }
+}

package/components/menu/menu-item.yaml

@@ -0,0 +1,45 @@
+# Edit this file; run `npm run build:components` to regenerate a2ui.json.
+#
+# §228 (v0.5.9): authored to close the §229 baseline class-export-undeclared
+# drift for UIMenuItem. The item ships as a sibling class in menu/class.js
+# + is registered alongside UIMenu + UIMenuDivider.
+
+# Child component of <menu-ui>. Surface only inside that parent.
+$schema: ../../../../scripts/schemas/component.yaml.schema.json
+name: UIMenuItem
+tag: menu-item-ui
+component: MenuItem
+category: navigation
+version: 1
+description: |-
+  Child of `<menu-ui>`. One actionable row inside a menu, with optional leading icon + label + value.
+
+props:
+  icon:
+    description: Optional leading Phosphor icon name.
+    type: string
+    default: ""
+  text:
+    description: Item label text.
+    type: string
+    default: ""
+  value:
+    description: Stable identifier emitted via the parent menu's `select` event.
+    type: string
+    default: ""
+  variant:
+    description: Semantic variant.
+    type: string
+    default: default
+    enum:
+      - default
+      - danger
+  disabled:
+    description: Disabled state — blocks pointer + keyboard activation.
+    type: boolean
+    default: false
+slots:
+  icon:
+    description: Custom leading element override; falls through to `[icon]` prop if not slotted.
+  text:
+    description: Custom label content; falls through to `[text]` prop if not slotted.

package/components/menu/menu.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/menu
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.
@@ -36,3 +36,19 @@ export class UIMenu extends UIElement {
   ): void;
   addEventListener(type: 'action', listener: (ev: MenuActionEvent) => unknown, options?: boolean | AddEventListenerOptions): void;
 }
+
+export class UIMenuDivider extends UIElement {
+}
+
+export class UIMenuItem extends UIElement {
+  /** Disabled state — blocks pointer + keyboard activation. */
+  disabled: boolean;
+  /** Optional leading Phosphor icon name. */
+  icon: string;
+  /** Item label text. */
+  text: string;
+  /** Stable identifier emitted via the parent menu's `select` event. */
+  value: string;
+  /** Semantic variant. */
+  variant: 'default' | 'danger';
+}

package/components/modal/modal.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/modal
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/nav/nav.css

@@ -17,7 +17,7 @@
     /* Primary-variant collapse */
     --nav-width:           auto;
     --nav-width-collapsed: 48px;
-    --nav-duration: var(--a-duration-base, 200ms);
+    --nav-duration: var(--a-duration);  /* §230-bundle (v0.5.9): canonical mid-tier duration (250ms). Was orphaned --a-duration-base. */
     --nav-easing:   var(--a-easing, ease);
 
     /* Group-heading kicker */

package/components/nav/nav.d.ts

@@ -12,7 +12,7 @@ and a [heading] kicker rendered via CSS.
  * @see https://ui-kit.exe.xyz/site/components/nav
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/nav-group/nav-group.d.ts

@@ -12,7 +12,7 @@ when [collapsible] (default true).
  * @see https://ui-kit.exe.xyz/site/components/nav-group
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/nav-item/nav-item.d.ts

@@ -12,7 +12,7 @@ bubbles a `nav-select` event.
  * @see https://ui-kit.exe.xyz/site/components/nav-item
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/noodles/noodles.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/noodles
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/page/page.d.ts

@@ -10,7 +10,7 @@ primitives (`<header-ui>`, `<section-ui>`, `<footer-ui>`); the page's
  * @see https://ui-kit.exe.xyz/site/components/page
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/pagination/pagination.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/pagination
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/pane/pane.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/pane
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/pipeline-status/pipeline-status.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/pipeline-status
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/popover/popover.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/popover
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/progress/progress.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/progress
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

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

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/progress-row
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/range/range.css

@@ -13,7 +13,7 @@ range-ui:not([disabled]) [slot="field"]:hover [data-layer="fill"] {
     --range-fill-bg-hover:   var(--a-ui-bg-hover);
     --range-fill-bg-active:  var(--a-ui-bg-active);
     --range-fill-bg-disabled: var(--a-canvas-muted);
-    --range-fill-fg:         var(--a-ui-fg);
+    --range-fill-fg:         var(--a-fg);
     --range-fill-fg-disabled: var(--a-ui-text-disabled);
     --range-fill-label-fg:   var(--a-ui-text-subtle);
     --range-border:          var(--a-ui-border);

package/components/richtext/richtext.a2ui.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://adiaui.dev/a2ui/v0_9/components/Richtext.json",
-  "title": "Richtext",
+  "$id": "https://adiaui.dev/a2ui/v0_9/components/RichText.json",
+  "title": "RichText",
   "description": "Renders markdown to styled HTML.",
   "type": "object",
   "allOf": [
@@ -14,7 +14,7 @@
   ],
   "properties": {
     "component": {
-      "const": "Richtext"
+      "const": "RichText"
     },
     "markdown": {
       "description": "Component property: markdown.",
@@ -61,7 +61,7 @@
     "keywords": [
       "richtext"
     ],
-    "name": "UIRichtext",
+    "name": "UIRichText",
     "related": [],
     "slots": {
       "default": {

package/components/richtext/richtext.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/richtext
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.
@@ -12,7 +12,7 @@
 
 import { UIElement } from '../../core/element.js';
 
-export class UIRichtext extends UIElement {
+export class UIRichText extends UIElement {
   /** Component property: markdown. */
   markdown: string;
   /** Source URL (image, iframe, etc.). */

package/components/richtext/richtext.yaml

@@ -1,7 +1,7 @@
 $schema: ../../../../scripts/schemas/component.yaml.schema.json
-name: UIRichtext
+name: UIRichText
 tag: richtext-ui
-component: Richtext
+component: RichText
 category: forms
 version: 1
 description: Renders markdown to styled HTML.

package/components/row/row.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/row
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/segment/segment.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/segment
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/select/class.js

@@ -26,6 +26,14 @@ export class UISelect extends UIFormElement {
   // (slot 11). Per FEEDBACK-06 §4 + FEEDBACK-07 §4.
   static requiredIcons = ['caret-up-down'];
 
+  // §225 (v0.5.9, FEEDBACK-10 §3): once-per-element console.warn dedup when
+  // consumer authors children that aren't native <option>/<optgroup>. The
+  // common authoring mistake is reaching for <select-option> (mirroring the
+  // <*-ui> naming convention), which #parseOptions silently ignores. Matches
+  // v0.5.5 §184 §8 button-ui safety-net + v0.5.7 §201 color-picker WeakSet
+  // pattern. WeakSet so the warn doesn't pin the element from GC.
+  static #warnedNonOption = new WeakSet();
+
   static properties = {
     ...UIFormElement.properties,
     placeholder: { type: String,  default: 'Select...', reflect: true },
@@ -201,6 +209,8 @@ export class UISelect extends UIFormElement {
   /** Parse <option> and <optgroup> children into internal model. */
   #parseOptions() {
     this.#options = [];
+    // §225 (v0.5.9): track unknown-child-tag names so we can warn once per element.
+    const unknownTags = new Set();
     for (const child of this.children) {
       if (child.tagName === 'OPTGROUP') {
         const group = { label: child.label || child.getAttribute('label') || '', options: [] };
@@ -210,9 +220,27 @@ export class UISelect extends UIFormElement {
         this.#options.push(group);
       } else if (child.tagName === 'OPTION') {
         this.#options.push({ value: child.value, label: child.textContent.trim(), disabled: child.disabled });
+      } else if (
+        // §225: skip [slot="display"] / [slot="listbox"] / [slot="action"] etc. — these are
+        // stamped by the component itself, not consumer-authored options. Anything other
+        // than a slot-bearing child OR <option>/<optgroup> is a likely authoring mistake.
+        !child.hasAttribute('slot')
+      ) {
+        unknownTags.add(child.tagName.toLowerCase());
       }
     }
     for (const child of [...this.querySelectorAll('option, optgroup')]) child.remove();
+    // §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);
+      // eslint-disable-next-line no-console
+      console.warn(
+        `<select-ui>: ignoring unrecognized child element(s) [${[...unknownTags].join(', ')}]. ` +
+        `Consumer-authored children must be native <option> or <optgroup>, NOT <select-option> ` +
+        `or other <*-ui> shapes. Or set element.options = [...] programmatically. ` +
+        `(Once-per-element warn; see select.yaml usage: for details.)`,
+      );
+    }
   }
 
   set options(list) {

package/components/select/select.css

@@ -314,7 +314,7 @@ select-ui[divider] [role="group"] + [role="group"] {
 select-ui > [slot="hint"] {
   display: block;
   margin-top: var(--select-hint-mt, var(--a-space-1));
-  font-size: var(--select-hint-size, var(--a-fine-size));
+  font-size: var(--select-hint-size, var(--a-ui-xs));
   color: var(--select-hint-fg, var(--a-fg-muted));
   line-height: var(--select-hint-lh, 1.4);
 }

package/components/select/select.yaml

@@ -117,6 +117,34 @@ props:
 events:
   change:
     description: Fired when selected value changes
+usage: |-
+  §225 (v0.5.9) — Consumer-authored children must be native `<option>` or
+  `<optgroup>`. The `#parseOptions()` walker reads only those two tag names;
+  other shapes (including hypothetical `<select-option>` mirroring the `<*-ui>`
+  convention) are silently ignored. v0.5.9 adds a once-per-element
+  `console.warn` to surface the authoring mistake at runtime.
+
+  Two canonical paths:
+
+  ```html
+  <!-- Path 1: native option children -->
+  <select-ui name="role" label="Role">
+    <option value="user">User</option>
+    <option value="admin">Admin</option>
+    <optgroup label="Special">
+      <option value="ghost">Ghost</option>
+    </optgroup>
+  </select-ui>
+
+  <!-- Path 2: programmatic .options property -->
+  <select-ui id="role" name="role" label="Role"></select-ui>
+  <script>
+    document.getElementById('role').options = [
+      { value: 'user', label: 'User' },
+      { value: 'admin', label: 'Admin' },
+    ];
+  </script>
+  ```
 slots:
   label:
     description: Label element above the trigger

package/components/skeleton/skeleton.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/skeleton
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

package/components/slider/class.js

@@ -42,16 +42,17 @@ export class UISlider extends UIFormElement {
     step:   { type: Number,  default: 1,  reflect: true },
     label:  { type: String,  default: '', reflect: true },
     suffix: { type: String,  default: '', reflect: true },
-    // §184 (v0.5.5, FEEDBACK-08 §4): declarative debounce for the
-    // `input` event when driving expensive computation (palette regen,
-    // shader compile, large list reflow). When > 0, value updates +
-    // visual feedback are immediate but `input` event emission is
-    // debounced — only the FINAL value in the throttle window dispatches.
-    // `change` fires unthrottled on pointerup / track click / keyboard;
-    // any pending `input` flushes BEFORE `change` so consumers always
-    // see input→input→…→input→change ordering. throttle="0" (default)
+    // §184 (v0.5.5, FEEDBACK-08 §4) → §220 (v0.5.9, FEEDBACK-14 §3):
+    // declarative trailing-debounce on `input` for expensive consumers
+    // (palette regen, shader compile, large list reflow). When > 0,
+    // value updates + visual feedback are immediate but `input` is
+    // collapsed across the window. `change` fires unthrottled on
+    // pointerup / track click / keyboard; any pending `input` flushes
+    // BEFORE `change` so consumers always see
+    // input→input→…→input→change ordering. throttle="0" (default)
     // preserves the pre-§184 every-pointer-move-fires-input behavior.
-    throttle: { type: Number, default: 0, reflect: true },
+    // The mechanism graduated to UIFormElement at v0.5.9 §220 — slider
+    // delegates via scheduleThrottledInput() + flushPendingInput().
   };
 
   static template = () => null;
@@ -62,11 +63,6 @@ export class UISlider extends UIFormElement {
   #trackEl = null;
   #thumbEl = null;
   #dragging = false;
-  // §184 (v0.5.5, FEEDBACK-08 §4): debounce timer for the `input`
-  // event. When `throttle > 0`, #setValue stores a pending dispatch
-  // here + restarts the timer on every value change. Flushed before
-  // any `change` event so input always precedes change.
-  #inputTimer = null;
 
   get #pct() {
     const range = this.max - this.min;
@@ -171,34 +167,11 @@ export class UISlider extends UIFormElement {
   #setValue(v) {
     if (v === this.value) return;
     this.value = v;
-    // §184: when throttle > 0, debounce the `input` dispatch.
-    // The value update + UI is still immediate; only event emission is
-    // accumulated. Same value can dispatch input multiple times across
-    // pointer moves, but the throttle collapses them to one trailing
-    // emission at quiet+throttle ms.
-    const t = Number(this.throttle) || 0;
-    if (t > 0) {
-      if (this.#inputTimer != null) clearTimeout(this.#inputTimer);
-      this.#inputTimer = setTimeout(() => {
-        this.#inputTimer = null;
-        this.dispatchEvent(new CustomEvent('input', { bubbles: true, detail: { value: this.value } }));
-      }, t);
-      return;
-    }
-    this.dispatchEvent(new CustomEvent('input', { bubbles: true, detail: { value: this.value } }));
-  }
-
-  /**
-   * §184: flush any pending throttled `input` dispatch synchronously.
-   * Called before `change` so consumers see the trailing input event
-   * BEFORE the change commit. No-op when no timer is pending.
-   */
-  #flushInput() {
-    if (this.#inputTimer != null) {
-      clearTimeout(this.#inputTimer);
-      this.#inputTimer = null;
-      this.dispatchEvent(new CustomEvent('input', { bubbles: true, detail: { value: this.value } }));
-    }
+    // §220 (v0.5.9): delegate to UIFormElement's shared throttle helper.
+    // When `this.throttle > 0`, the dispatch is trailing-debounced
+    // (collapses pointer-move bursts to one emission). When 0, fires
+    // synchronously.
+    this.scheduleThrottledInput();
   }
 
   #onPointerDown = (e) => {
@@ -220,14 +193,14 @@ export class UISlider extends UIFormElement {
     this.#thumbEl.releasePointerCapture(e.pointerId);
     this.#thumbEl.removeEventListener('pointermove', this.#onPointerMove);
     this.#thumbEl.removeEventListener('pointerup', this.#onPointerUp);
-    this.#flushInput(); // §184: pending throttled input fires before change
+    this.flushPendingInput(); // §220 (was §184 #flushInput): pending throttled input fires before change
     this.dispatchEvent(new CustomEvent('change', { bubbles: true, detail: { value: this.value } }));
   };
 
   #onTrackClick = (e) => {
     if (this.disabled || e.target === this.#thumbEl) return;
     this.#setValue(this.#valueFromX(e.clientX));
-    this.#flushInput(); // §184: ensure trailing input precedes change
+    this.flushPendingInput(); // §220 (was §184 #flushInput): ensure trailing input precedes change
     this.dispatchEvent(new CustomEvent('change', { bubbles: true, detail: { value: this.value } }));
   };
 
@@ -245,7 +218,7 @@ export class UISlider extends UIFormElement {
     }
     e.preventDefault();
     this.#setValue(this.#snap(v));
-    this.#flushInput(); // §184: trailing input fires before change
+    this.flushPendingInput(); // §220 (was §184 #flushInput): trailing input fires before change
     this.dispatchEvent(new CustomEvent('change', { bubbles: true, detail: { value: this.value } }));
   };
 
@@ -256,11 +229,8 @@ export class UISlider extends UIFormElement {
     this.#thumbEl?.removeEventListener('pointermove', this.#onPointerMove);
     this.#thumbEl?.removeEventListener('pointerup', this.#onPointerUp);
     this.removeEventListener('keydown', this.#onKey);
-    // §184: drop any pending throttle timer (no flush — element is gone)
-    if (this.#inputTimer != null) {
-      clearTimeout(this.#inputTimer);
-      this.#inputTimer = null;
-    }
+    // §220 (v0.5.9): UIFormElement.disconnected() auto-drops the pending
+    // throttled input dispatch via super.disconnected().
     this.#trackEl = null;
     this.#thumbEl = null;
   }

package/components/slider/slider.css

@@ -143,7 +143,7 @@
   [slot="hint"] {
     display: block;
     margin-top: var(--slider-hint-mt, var(--a-space-1));
-    font-size: var(--slider-hint-size, var(--a-fine-size));
+    font-size: var(--slider-hint-size, var(--a-ui-xs));
     color: var(--slider-hint-fg, var(--a-fg-muted));
     line-height: var(--slider-hint-lh, 1.4);
   }

package/components/stack/stack.d.ts

@@ -4,7 +4,7 @@
  * @see https://ui-kit.exe.xyz/site/components/stack
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.

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

@@ -10,7 +10,7 @@ primitive.
  * @see https://ui-kit.exe.xyz/site/components/step-progress
  *
  * Type declarations generated by scripts/build/dts-codegen.mjs from
- * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
  * 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.