@weave-framework/ui 0.2.107

package/dist/popover-edit/popover-edit.js

@@ -0,0 +1,107 @@
+/**
+ * `use:popoverEdit` — inline editing of any element's value in a small **non-modal** overlay
+ * (the spreadsheet "click a cell → edit in place" gesture). Attaches to a host (a table cell,
+ * a label, …); activating it (click / Enter / F2) opens a CDK-overlay popover — the U3 overlay
+ * republic chrome — containing an editor seeded with the current value. **Enter or click-away
+ * commit** (`onCommit`), **Esc cancels** (restores). Focus moves into the editor on open and
+ * back to the host on close.
+ *
+ * The default editor is a text field sharing Input's underline (the shared `field-underline`
+ * helper — RULE #1, one field look); a custom `editor` factory can supply a Select/date/etc.
+ *
+ *   <td use:popoverEdit={{ { value: () => row.name, onCommit: (v) => rename(row, v) } }}>{{ row.name }}</td>
+ */
+import { createOverlay, connectedPosition } from '../cdk/index.js';
+import { buildPositions } from '../shared/positions.js';
+function disabledOf(d) {
+    return typeof d === 'function' ? d() : !!d;
+}
+/** Attach inline popover editing to `host`. Returns a ref (also a cleanup contract for Weave). */
+export function popoverEdit(host, config) {
+    let overlay = null;
+    let editor = null;
+    host.setAttribute('aria-haspopup', 'dialog');
+    const buildDefaultEditor = (value) => {
+        const input = document.createElement('input');
+        input.type = 'text';
+        input.className = 'weave-popover-edit__input';
+        input.value = value;
+        if (config.placeholder)
+            input.placeholder = config.placeholder;
+        if (config.label)
+            input.setAttribute('aria-label', config.label);
+        return { element: input, read: () => input.value, focusTarget: input };
+    };
+    function open() {
+        if (overlay || disabledOf(config.disabled))
+            return;
+        const panel = document.createElement('div');
+        panel.className = 'weave-popover-edit';
+        panel.setAttribute('role', 'dialog');
+        panel.setAttribute('aria-label', config.label ?? 'Edit');
+        editor = (config.editor ?? buildDefaultEditor)(config.value());
+        panel.appendChild(editor.element);
+        panel.addEventListener('keydown', onPanelKeydown);
+        overlay = createOverlay({
+            hasBackdrop: true,
+            backdropClass: 'weave-overlay-backdrop--transparent',
+            positionStrategy: connectedPosition(host, { positions: buildPositions(config.position, 'bottom-start'), offset: 4 }),
+        });
+        overlay.onBackdropClick(() => commit()); // click-away commits (spreadsheet feel)
+        overlay.attach(panel);
+        host.setAttribute('aria-expanded', 'true');
+        const focusEl = editor.focusTarget ?? editor.element;
+        focusEl.focus();
+        if (focusEl instanceof HTMLInputElement)
+            focusEl.select();
+    }
+    function teardown(returnFocus) {
+        overlay?.detach();
+        overlay?.dispose();
+        overlay = null;
+        editor = null;
+        host.setAttribute('aria-expanded', 'false');
+        if (returnFocus)
+            host.focus();
+    }
+    function commit() {
+        if (!overlay || !editor)
+            return;
+        const next = editor.read();
+        teardown(true);
+        config.onCommit(next);
+    }
+    function cancel() {
+        if (!overlay)
+            return;
+        teardown(true);
+    }
+    function onPanelKeydown(event) {
+        if (event.key === 'Enter') {
+            event.preventDefault();
+            commit();
+        }
+        else if (event.key === 'Escape') {
+            event.preventDefault();
+            cancel();
+        }
+    }
+    const onHostClick = () => open();
+    const onHostKeydown = (event) => {
+        if (event.key === 'Enter' || event.key === 'F2') {
+            event.preventDefault();
+            open();
+        }
+    };
+    host.addEventListener('click', onHostClick);
+    host.addEventListener('keydown', onHostKeydown);
+    const destroy = () => {
+        teardown(false);
+        host.removeEventListener('click', onHostClick);
+        host.removeEventListener('keydown', onHostKeydown);
+        host.removeAttribute('aria-haspopup');
+        host.removeAttribute('aria-expanded');
+    };
+    return { open, close: () => cancel(), destroy };
+}
+//# sourceMappingURL=popover-edit.js.map

package/dist/popover-edit/popover-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-edit.js","sourceRoot":"","sources":["../../src/popover-edit/popover-edit.ts"],"names":[],"mappings":"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"}

package/dist/progress-bar/progress-bar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `<ProgressBar>` — a thin horizontal progress indicator (Weave: 4px `field` track,
+ * accent fill). Two modes:
+ *
+ * - **Determinate (default)** — an accent fill grows to `value`% (0–100, clamped).
+ *   `role=progressbar` with `aria-valuemin/max/now`.
+ * - **Indeterminate (`indeterminate`)** — a sliding accent segment for work of unknown
+ *   length; `aria-valuenow` is omitted (only min/max remain), per WAI-ARIA.
+ *
+ *   import ProgressBar from '@weave-framework/ui/progress-bar';
+ *   <ProgressBar value={{ pct() }} />
+ *   <ProgressBar indeterminate label={{ 'Loading' }} />
+ */
+export interface ProgressBarProps {
+    /** Completion 0–100 (clamped). Ignored when `indeterminate`. Default 0. */
+    value?: number;
+    /** Unknown-length work: a sliding segment, no `aria-valuenow`. */
+    indeterminate?: boolean;
+    /** Accessible name for the bar. */
+    label?: string;
+    /** Extra classes, forwarded onto the container. */
+    class?: string;
+}
+export declare const template: string;
+export interface ProgressBarContext {
+    barClass: () => string;
+    valueNow: () => number | undefined;
+    fillStyle: () => string | undefined;
+    label: () => string | undefined;
+}
+export declare function setup(props: ProgressBarProps): ProgressBarContext;
+//# sourceMappingURL=progress-bar.d.ts.map

package/dist/progress-bar/progress-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar.d.ts","sourceRoot":"","sources":["../../src/progress-bar/progress-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,EAAE,MAIb,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACjC;AAQD,wBAAgB,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,kBAAkB,CAejE"}

package/dist/progress-bar/progress-bar.js

@@ -0,0 +1,42 @@
+/**
+ * `<ProgressBar>` — a thin horizontal progress indicator (Weave: 4px `field` track,
+ * accent fill). Two modes:
+ *
+ * - **Determinate (default)** — an accent fill grows to `value`% (0–100, clamped).
+ *   `role=progressbar` with `aria-valuemin/max/now`.
+ * - **Indeterminate (`indeterminate`)** — a sliding accent segment for work of unknown
+ *   length; `aria-valuenow` is omitted (only min/max remain), per WAI-ARIA.
+ *
+ *   import ProgressBar from '@weave-framework/ui/progress-bar';
+ *   <ProgressBar value={{ pct() }} />
+ *   <ProgressBar indeterminate label={{ 'Loading' }} />
+ */
+export const template = '<div class={{ barClass() }} role="progressbar" aria-valuemin="0" aria-valuemax="100"' +
+    ' aria-valuenow={{ valueNow() }} aria-label={{ label() }}>' +
+    '<div class="weave-progress-bar__fill" style={{ fillStyle() }}></div>' +
+    '</div>';
+/** Clamp to 0–100; non-finite → 0. */
+function clampPct(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, value));
+}
+export function setup(props) {
+    const indeterminate = () => !!props.indeterminate;
+    return {
+        barClass: () => {
+            const parts = ['weave-progress-bar'];
+            if (indeterminate())
+                parts.push('weave-progress-bar--indeterminate');
+            if (props.class)
+                parts.push(props.class);
+            return parts.join(' ');
+        },
+        // Omit aria-valuenow while indeterminate (WAI-ARIA: value is unknown).
+        valueNow: () => (indeterminate() ? undefined : clampPct(props.value)),
+        // Determinate drives the fill width inline; indeterminate lets the keyframes drive it.
+        fillStyle: () => (indeterminate() ? undefined : `width: ${clampPct(props.value)}%`),
+        label: () => props.label,
+    };
+}
+//# sourceMappingURL=progress-bar.js.map

package/dist/progress-bar/progress-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar.js","sourceRoot":"","sources":["../../src/progress-bar/progress-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,MAAM,CAAC,MAAM,QAAQ,GACnB,sFAAsF;IACtF,2DAA2D;IAC3D,sEAAsE;IACtE,QAAQ,CAAC;AASX,sCAAsC;AACtC,SAAS,QAAQ,CAAC,KAAyB;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAuB;IAC3C,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,GAAW,EAAE;YACrB,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;YAC/C,IAAI,aAAa,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YACrE,IAAI,KAAK,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,uEAAuE;QACvE,QAAQ,EAAE,GAAuB,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzF,uFAAuF;QACvF,SAAS,EAAE,GAAuB,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;QACvG,KAAK,EAAE,GAAuB,EAAE,CAAC,KAAK,CAAC,KAAK;KAC7C,CAAC;AACJ,CAAC"}

package/dist/progress-spinner/progress-spinner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `<ProgressSpinner>` — an indeterminate spinning ring (Weave: a `field` ring with an
+ * accent top arc, rotating `.8s linear infinite`). Two sizes: default 26px, `--small`
+ * 18px. Pure CSS + a size prop — `role=progressbar` with no `aria-valuenow` (the work
+ * is of unknown length).
+ *
+ *   import ProgressSpinner from '@weave-framework/ui/progress-spinner';
+ *   <ProgressSpinner label={{ 'Loading' }} />
+ *   <ProgressSpinner small />
+ */
+export interface ProgressSpinnerProps {
+    /** The compact 18px ring instead of the default 26px. */
+    small?: boolean;
+    /** Accessible name for the spinner. */
+    label?: string;
+    /** Extra classes, forwarded onto the ring. */
+    class?: string;
+}
+export declare const template: string;
+export interface ProgressSpinnerContext {
+    spinnerClass: () => string;
+    label: () => string | undefined;
+}
+export declare function setup(props: ProgressSpinnerProps): ProgressSpinnerContext;
+//# sourceMappingURL=progress-spinner.d.ts.map

package/dist/progress-spinner/progress-spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-spinner.d.ts","sourceRoot":"","sources":["../../src/progress-spinner/progress-spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,EAAE,MAC+D,CAAC;AAEvF,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,CAUzE"}

package/dist/progress-spinner/progress-spinner.js

@@ -0,0 +1,25 @@
+/**
+ * `<ProgressSpinner>` — an indeterminate spinning ring (Weave: a `field` ring with an
+ * accent top arc, rotating `.8s linear infinite`). Two sizes: default 26px, `--small`
+ * 18px. Pure CSS + a size prop — `role=progressbar` with no `aria-valuenow` (the work
+ * is of unknown length).
+ *
+ *   import ProgressSpinner from '@weave-framework/ui/progress-spinner';
+ *   <ProgressSpinner label={{ 'Loading' }} />
+ *   <ProgressSpinner small />
+ */
+export const template = '<div class={{ spinnerClass() }} role="progressbar" aria-label={{ label() }}></div>';
+export function setup(props) {
+    return {
+        spinnerClass: () => {
+            const parts = ['weave-progress-spinner'];
+            if (props.small)
+                parts.push('weave-progress-spinner--small');
+            if (props.class)
+                parts.push(props.class);
+            return parts.join(' ');
+        },
+        label: () => props.label,
+    };
+}
+//# sourceMappingURL=progress-spinner.js.map

package/dist/progress-spinner/progress-spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-spinner.js","sourceRoot":"","sources":["../../src/progress-spinner/progress-spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,MAAM,CAAC,MAAM,QAAQ,GACnB,oFAAoF,CAAC;AAOvF,MAAM,UAAU,KAAK,CAAC,KAA2B;IAC/C,OAAO;QACL,YAAY,EAAE,GAAW,EAAE;YACzB,MAAM,KAAK,GAAa,CAAC,wBAAwB,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,EAAE,GAAuB,EAAE,CAAC,KAAK,CAAC,KAAK;KAC7C,CAAC;AACJ,CAAC"}

package/dist/radio/radio.d.ts

@@ -0,0 +1,68 @@
+/**
+ * `<RadioGroup>` — a single-select group of real `<input type=radio>` (Weave: a 20px
+ * circle, off = 1.5px ring, on = accent ring + an 8px accent dot). Items-prop API like
+ * `<ButtonToggle>` (leaner + more testable than a compound `<Radio>` child API). The
+ * inputs share a native `name`, so the browser gives **arrow-key navigation + roving
+ * tabindex + single-selection for free** — this component adds only value/forms binding
+ * and the visual.
+ *
+ * Binding follows the **Weave form-control convention** set by Checkbox (here the value
+ * is the selected key, a `string`):
+ *  - **Signal**: `value` (a getter) + `onChange`.
+ *  - **Forms**: `control` — a structurally-typed `Field<string>` (a real
+ *    `@weave-framework/forms` Field satisfies it; `@weave-framework/ui` stays decoupled).
+ *    `control` drives the value two-way, marks `touched` on blur, and reflects
+ *    `aria-invalid` on the group while touched **and** invalid. `control` wins over
+ *    `value`/`onChange`.
+ *
+ *   import RadioGroup from '@weave-framework/ui/radio';
+ *   <RadioGroup options={{ plans }} value={{ plan() }} onChange={{ setPlan }} label={{ 'Plan' }} />
+ *   <RadioGroup options={{ plans }} control={{ form.controls.plan }} />
+ */
+import { type Signal } from '@weave-framework/runtime';
+/** The subset of a `@weave-framework/forms` `Field<string>` a radio group binds to. */
+export interface RadioControl {
+    value: Signal<string>;
+    touched?: Signal<boolean>;
+    error?: () => string | null;
+}
+export interface RadioOption {
+    /** The value this radio carries (what `value`/`onChange` speak in). */
+    value: string;
+    /** Visible text. Defaults to `value` when omitted. */
+    label?: string;
+    /** Disable just this radio. */
+    disabled?: boolean;
+}
+export interface RadioGroupProps {
+    /** The radios, top to bottom. */
+    options: RadioOption[];
+    /** Controlled selected value (a getter). Ignored when `control` is set. */
+    value?: string | null;
+    /** Called with the next value on select. Ignored when `control` is set. */
+    onChange?: (value: string) => void;
+    /** A forms `Field<string>` — two-way value + touched-on-blur + aria-invalid. */
+    control?: RadioControl;
+    /** Shared native `name` (auto-generated if omitted). */
+    name?: string;
+    /** Disable the whole group. */
+    disabled?: boolean;
+    /** Accessible name for the group. */
+    label?: string;
+    /** Extra classes, forwarded onto the group container. */
+    class?: string;
+}
+export declare const template: string;
+export interface RadioGroupContext {
+    root: Signal<HTMLElement | null>;
+    options: () => RadioOption[];
+    groupClass: () => string;
+    label: () => string | undefined;
+    name: () => string;
+    isSelected: (opt: RadioOption) => boolean;
+    isOptionDisabled: (opt: RadioOption) => boolean;
+    onNativeChange: (event: Event) => void;
+    onFocusOut: () => void;
+}
+export declare function setup(props: RadioGroupProps): RadioGroupContext;
+//# sourceMappingURL=radio.d.ts.map

package/dist/radio/radio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../src/radio/radio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvE,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gFAAgF;IAChF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,eAAO,MAAM,QAAQ,EAAE,MAWb,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,WAAW,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IAC1C,gBAAgB,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IAChD,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CA4C/D"}

package/dist/radio/radio.js

@@ -0,0 +1,81 @@
+/**
+ * `<RadioGroup>` — a single-select group of real `<input type=radio>` (Weave: a 20px
+ * circle, off = 1.5px ring, on = accent ring + an 8px accent dot). Items-prop API like
+ * `<ButtonToggle>` (leaner + more testable than a compound `<Radio>` child API). The
+ * inputs share a native `name`, so the browser gives **arrow-key navigation + roving
+ * tabindex + single-selection for free** — this component adds only value/forms binding
+ * and the visual.
+ *
+ * Binding follows the **Weave form-control convention** set by Checkbox (here the value
+ * is the selected key, a `string`):
+ *  - **Signal**: `value` (a getter) + `onChange`.
+ *  - **Forms**: `control` — a structurally-typed `Field<string>` (a real
+ *    `@weave-framework/forms` Field satisfies it; `@weave-framework/ui` stays decoupled).
+ *    `control` drives the value two-way, marks `touched` on blur, and reflects
+ *    `aria-invalid` on the group while touched **and** invalid. `control` wins over
+ *    `value`/`onChange`.
+ *
+ *   import RadioGroup from '@weave-framework/ui/radio';
+ *   <RadioGroup options={{ plans }} value={{ plan() }} onChange={{ setPlan }} label={{ 'Plan' }} />
+ *   <RadioGroup options={{ plans }} control={{ form.controls.plan }} />
+ */
+import { signal, effect } from '@weave-framework/runtime';
+let _uid = 0;
+export const template = '<div class={{ groupClass() }} ref={{ root }} role="radiogroup" aria-label={{ label() }}' +
+    ' on:change={{ onNativeChange }} on:focusout={{ onFocusOut }}>' +
+    '@for (opt of options(); track opt.value) {' +
+    '<label class="weave-radio">' +
+    '<input type="radio" class="weave-radio__input" name={{ name() }} value={{ opt.value }}' +
+    ' .checked={{ isSelected(opt) }} disabled={{ isOptionDisabled(opt) }} />' +
+    '<span class="weave-radio__box" aria-hidden="true"></span>' +
+    '<span class="weave-radio__label">{{ opt.label ?? opt.value }}</span>' +
+    '</label>' +
+    '}' +
+    '</div>';
+export function setup(props) {
+    const root = signal(null);
+    const groupName = props.name ?? `weave-radio-${(_uid += 1)}`;
+    const options = () => props.options ?? [];
+    const groupDisabled = () => !!props.disabled;
+    const isOptionDisabled = (opt) => groupDisabled() || !!opt.disabled;
+    const currentValue = () => (props.control ? props.control.value() : props.value ?? null);
+    // Source → DOM per input, via a `.checked` property binding in the template (each
+    // input binds itself, so it's reactive and needs no post-render child query).
+    const isSelected = (opt) => currentValue() === opt.value;
+    // Forms validity → aria-invalid on the group (touched AND invalid).
+    effect(() => {
+        const el = root();
+        if (!el)
+            return;
+        const c = props.control;
+        if (c && c.touched?.() && c.error?.())
+            el.setAttribute('aria-invalid', 'true');
+        else
+            el.removeAttribute('aria-invalid');
+    });
+    const onNativeChange = (event) => {
+        const target = event.target;
+        if (!target.classList?.contains('weave-radio__input'))
+            return;
+        const next = target.value;
+        if (props.control)
+            props.control.value.set(next);
+        else
+            props.onChange?.(next);
+    };
+    const onFocusOut = () => {
+        props.control?.touched?.set(true);
+    };
+    return {
+        root,
+        options,
+        groupClass: () => (props.class ? `weave-radio-group ${props.class}` : 'weave-radio-group'),
+        label: () => props.label,
+        name: () => groupName,
+        isSelected,
+        isOptionDisabled,
+        onNativeChange,
+        onFocusOut,
+    };
+}
+//# sourceMappingURL=radio.js.map

package/dist/radio/radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../src/radio/radio.ts"],"names":[],"mappings":"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"}

package/dist/ripple/ripple.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ripple — a click-feedback behavior, applied as a Weave `use:` action to any host:
+ *
+ *   <button use:ripple>Save</button>
+ *   <button use:ripple={{ { centered: true } }}>Enter-friendly</button>
+ *
+ * On pointerdown it appends an absolutely-positioned circle at the click point that
+ * scales up and fades out (Weave: currentColor, opacity .22, scale→4 over ~.55s),
+ * removed on animationend. The visual is driven by `ripple.styles()` (CSS + tokens);
+ * this file is only the behavior. Respects prefers-reduced-motion. Zero-dep.
+ */
+export interface RippleOptions {
+    /** Emanate from the host centre instead of the pointer (e.g. keyboard activation). */
+    centered?: boolean;
+    /** Suppress ripples without detaching the action. */
+    disabled?: boolean;
+}
+/** Weave `use:` action: `(el, options?) => cleanup`. */
+export declare function ripple(host: HTMLElement, options?: RippleOptions): () => void;
+//# sourceMappingURL=ripple.d.ts.map

package/dist/ripple/ripple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.d.ts","sourceRoot":"","sources":["../../src/ripple/ripple.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,IAAI,CA8BjF"}

package/dist/ripple/ripple.js

@@ -0,0 +1,41 @@
+/** Weave `use:` action: `(el, options?) => cleanup`. */
+export function ripple(host, options = {}) {
+    ensureHost(host);
+    const onPointerDown = (event) => {
+        if (options.disabled)
+            return;
+        const rect = host.getBoundingClientRect();
+        const x = options.centered ? rect.width / 2 : event.clientX - rect.left;
+        const y = options.centered ? rect.height / 2 : event.clientY - rect.top;
+        // Radius reaches the farthest corner so the circle covers the whole host.
+        const radius = Math.hypot(Math.max(x, rect.width - x), Math.max(y, rect.height - y));
+        const span = document.createElement('span');
+        span.className = 'weave-ripple';
+        span.setAttribute('aria-hidden', 'true');
+        span.style.left = `${x - radius}px`;
+        span.style.top = `${y - radius}px`;
+        span.style.width = `${radius * 2}px`;
+        span.style.height = `${radius * 2}px`;
+        host.appendChild(span);
+        if (prefersReducedMotion()) {
+            span.remove();
+            return;
+        }
+        span.addEventListener('animationend', () => span.remove(), { once: true });
+    };
+    host.addEventListener('pointerdown', onPointerDown);
+    return () => host.removeEventListener('pointerdown', onPointerDown);
+}
+// The ripple is absolutely positioned and must be clipped — nudge the host if the
+// author hasn't (also available as the `weave.ripple-host` mixin for authored styles).
+function ensureHost(host) {
+    const cs = getComputedStyle(host);
+    if (cs.position === 'static')
+        host.style.position = 'relative';
+    if (cs.overflow === 'visible')
+        host.style.overflow = 'hidden';
+}
+function prefersReducedMotion() {
+    return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+}
+//# sourceMappingURL=ripple.js.map

package/dist/ripple/ripple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripple.js","sourceRoot":"","sources":["../../src/ripple/ripple.ts"],"names":[],"mappings":"AAkBA,wDAAwD;AACxD,MAAM,UAAU,MAAM,CAAC,IAAiB,EAAE,UAAyB,EAAE;IACnE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjB,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAQ,EAAE;QAClD,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO;QAE7B,MAAM,IAAI,GAAY,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACnD,MAAM,CAAC,GAAW,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;QAChF,MAAM,CAAC,GAAW,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;QAChF,0EAA0E;QAC1E,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAE7F,MAAM,IAAI,GAAoB,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC;QACtC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvB,IAAI,oBAAoB,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;IAEF,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACpD,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,kFAAkF;AAClF,uFAAuF;AACvF,SAAS,UAAU,CAAC,IAAiB;IACnC,MAAM,EAAE,GAAwB,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,QAAQ,KAAK,QAAQ;QAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;IAC/D,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAChE,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO,OAAO,UAAU,KAAK,UAAU,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AACpG,CAAC"}

package/dist/select/select.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `<Select>` — a native-fidelity combobox/listbox form control (WAI-ARIA APG). A trigger
+ * field (with Input's prefix/suffix/clear) shows the current selection; clicking (or
+ * ↓/Enter) opens a CDK-overlay `role=listbox` panel of options anchored under it. Focus
+ * stays on the trigger; the active option is tracked with `aria-activedescendant` (native
+ * combobox behaviour), navigated with the CDK `listKeyManager` (typeahead, skip-disabled).
+ *
+ * - **Single or `multiple`** — multi keeps the panel open, shows check-marked options, and a
+ *   `"N selected"` summary; the value is an array.
+ * - **Any option shape** — the shared drop-list model: `optionValue`/`optionLabel`/
+ *   `optionDescription`/`optionDisabled` accessors (default `.value`/`.label`/…; plain
+ *   strings work), `emit: 'value'|'object'`, and a **description subtext** per row.
+ * - **Binding** — the Weave form-control convention: `value` (getter) + `onChange`, OR a
+ *   structural `control` (a forms `Field`). Compose with `<FormField>` for label/hint/error.
+ *
+ *   import Select from '@weave-framework/ui/select';
+ *   <Select control={{ form.controls.country }} options={{ countries }}
+ *           optionValue={{ (c) => c.code }} optionLabel={{ (c) => c.name }} />
+ */
+import { type Signal } from '@weave-framework/runtime';
+import { type OptionAccessors } from '../shared/options.js';
+import { type MenuPosition } from '../shared/positions.js';
+/** What a Select's value can be (single or multiple; value strings or whole objects). */
+export type SelectValue<T> = string | T | Array<string | T> | undefined;
+/** The subset of a forms `Field` a Select binds to. */
+export interface SelectControl<T> {
+    value: Signal<SelectValue<T>>;
+    touched?: Signal<boolean>;
+    error?: () => string | null;
+}
+export interface SelectProps<T = {
+    value: string;
+    label: string;
+}> extends OptionAccessors<T> {
+    /** The options — default shape, plain strings, or arbitrary objects (via accessors). */
+    options: T[];
+    /** Allow multiple selection (value becomes an array; the panel stays open). */
+    multiple?: boolean;
+    /** Controlled value (a getter). Ignored when `control` is set. */
+    value?: SelectValue<T>;
+    /** Called with the next value on change. Ignored when `control` is set. */
+    onChange?: (value: SelectValue<T>) => void;
+    /** A forms `Field` — two-way value + touched-on-close + error state. */
+    control?: SelectControl<T>;
+    /** Shown when nothing is selected. */
+    placeholder?: string;
+    /** Disable the control. */
+    disabled?: boolean;
+    /** Show a clear (`×`) button when something is selected. */
+    clearable?: boolean;
+    /** Mark required (aria). */
+    required?: boolean;
+    /** Accessible name (when not wrapped by a FormField label). */
+    label?: string;
+    /** Panel position relative to the trigger. Default `'bottom-start'`. */
+    position?: MenuPosition;
+    /** Accessible name for the clear button. Default 'Clear'. */
+    clearLabel?: string;
+    /** Extra classes, forwarded onto the root. */
+    class?: string;
+}
+export declare const template: string;
+export interface SelectContext<T> {
+    root: Signal<HTMLElement | null>;
+    trigger: Signal<HTMLElement | null>;
+    rootClass: () => string;
+    valueClass: () => string;
+    displayText: () => string;
+    tabindex: () => number;
+    label: () => string | undefined;
+    ariaRequired: () => 'true' | undefined;
+    ariaDisabled: () => 'true' | undefined;
+    showClear: () => boolean;
+    clearLabel: () => string;
+    onFieldClick: () => void;
+    onTriggerKeydown: (event: KeyboardEvent) => void;
+    onClearClick: (event: MouseEvent) => void;
+}
+export declare function setup<T = {
+    value: string;
+    label: string;
+}>(props: SelectProps<T>): SelectContext<T>;
+//# sourceMappingURL=select.d.ts.map

package/dist/select/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/select/select.ts"],"names":[],"mappings":"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"}