@weave-framework/ui 0.2.107

package/dist/select/select.js

@@ -0,0 +1,320 @@
+/**
+ * `<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 { signal, effect, onMount, onDispose } from '@weave-framework/runtime';
+import { createOverlay, connectedPosition, listKeyManager } from '../cdk/index.js';
+import { optValue, optLabel, optDescription, optDisabled, emitSelection } from '../shared/options.js';
+import { buildPositions } from '../shared/positions.js';
+export const template = '<div class={{ rootClass() }} ref={{ root }}>' +
+    '<div class="weave-select__field" ref={{ trigger }} role="combobox" tabindex={{ tabindex() }}' +
+    ' aria-haspopup="listbox" aria-expanded="false" aria-label={{ label() }} aria-required={{ ariaRequired() }}' +
+    ' aria-disabled={{ ariaDisabled() }} on:click={{ onFieldClick }} on:keydown={{ onTriggerKeydown }}>' +
+    '<span class="weave-select__prefix"><slot name="prefix"></slot></span>' +
+    '<span class={{ valueClass() }}>{{ displayText() }}</span>' +
+    '<span class="weave-select__spacer"></span>' +
+    '@if (showClear()) {' +
+    '<button type="button" class="weave-select__clear" tabindex="-1" aria-label={{ clearLabel() }} on:click={{ onClearClick }}>×</button>' +
+    '}' +
+    '<span class="weave-select__suffix"><slot name="suffix"></slot></span>' +
+    '<span class="weave-select__chevron" aria-hidden="true"></span>' +
+    '</div>' +
+    '</div>';
+let _seq = 0;
+export function setup(props) {
+    const id = ++_seq;
+    const root = signal(null);
+    const trigger = signal(null);
+    const open = signal(false);
+    let overlay = null;
+    let listbox = null;
+    const optionEls = new Map();
+    const isDisabled = () => !!props.disabled;
+    const enabledOptions = () => props.options.filter((o) => !optDisabled(o, props));
+    // Current selection, normalised to an array of the emitted items (string or object).
+    const currentSelection = () => {
+        const raw = props.control ? props.control.value() : props.value;
+        if (raw == null)
+            return [];
+        return Array.isArray(raw) ? raw : [raw];
+    };
+    const valueOf = (sel) => (typeof sel === 'string' ? sel : optValue(sel, props));
+    const selectedValues = () => new Set(currentSelection().map(valueOf));
+    const commit = (next) => {
+        if (props.control)
+            props.control.value.set(next);
+        else
+            props.onChange?.(next);
+    };
+    const labelForValue = (v) => {
+        const opt = props.options.find((o) => optValue(o, props) === v);
+        return opt ? optLabel(opt, props) : v;
+    };
+    const km = listKeyManager(enabledOptions, {
+        orientation: 'vertical',
+        wrap: true,
+        typeahead: true,
+        getLabel: (o) => optLabel(o, props),
+    });
+    function toggleOption(item) {
+        const v = optValue(item, props);
+        if (props.multiple) {
+            const has = selectedValues().has(v);
+            const kept = currentSelection().filter((s) => valueOf(s) !== v);
+            commit(has ? kept : [...kept, emitSelection(item, props)]);
+        }
+        else {
+            commit(emitSelection(item, props));
+            closePanel(true);
+        }
+    }
+    // Keep each rendered option's selected state + the active highlight in sync (reactive).
+    function syncSelected() {
+        const sel = selectedValues();
+        for (const [v, el] of optionEls) {
+            const on = sel.has(v);
+            el.setAttribute('aria-selected', on ? 'true' : 'false');
+            el.classList.toggle('weave-select__option--selected', on);
+        }
+    }
+    function syncActive() {
+        const active = km.activeItem();
+        const activeVal = active ? optValue(active, props) : null;
+        const t = trigger();
+        for (const [v, el] of optionEls) {
+            const on = v === activeVal;
+            el.classList.toggle('weave-select__option--active', on);
+            if (on) {
+                el.scrollIntoView({ block: 'nearest' });
+                t?.setAttribute('aria-activedescendant', el.id);
+            }
+        }
+        if (activeVal == null)
+            t?.removeAttribute('aria-activedescendant');
+    }
+    // (Re)populate a listbox element's option nodes from the CURRENT `props.options`. Reading
+    // `props.options` here means an effect that calls this while the panel is open re-tracks the list,
+    // so async-loaded / edited options reflect live (and every re-open renders fresh) — H3.
+    function renderOptions(box) {
+        box.textContent = '';
+        optionEls.clear();
+        for (const o of props.options) {
+            const v = optValue(o, props);
+            const opt = document.createElement('div');
+            opt.className = 'weave-select__option';
+            opt.id = `weave-select-${id}-opt-${optionEls.size}`;
+            opt.setAttribute('role', 'option');
+            const disabled = optDisabled(o, props);
+            if (disabled)
+                opt.setAttribute('aria-disabled', 'true');
+            const label = document.createElement('span');
+            label.className = 'weave-select__label';
+            label.textContent = optLabel(o, props);
+            opt.appendChild(label);
+            const desc = optDescription(o, props);
+            if (desc) {
+                const d = document.createElement('span');
+                d.className = 'weave-select__description';
+                d.textContent = desc;
+                opt.appendChild(d);
+            }
+            if (!disabled) {
+                opt.addEventListener('mousedown', (e) => {
+                    e.preventDefault(); // keep focus on the trigger
+                    km.setActiveItem(o);
+                    toggleOption(o);
+                });
+                optionEls.set(v, opt);
+            }
+            box.appendChild(opt);
+        }
+    }
+    function buildListbox() {
+        const box = document.createElement('div');
+        box.id = `weave-select-${id}-listbox`;
+        box.className = 'weave-select__panel';
+        box.setAttribute('role', 'listbox');
+        if (props.multiple)
+            box.setAttribute('aria-multiselectable', 'true');
+        return box; // options are filled by the reactive effect once the panel opens
+    }
+    function openPanel(seedActive) {
+        if (open() || isDisabled() || props.options.length === 0)
+            return;
+        const t = trigger();
+        if (!listbox)
+            listbox = buildListbox();
+        overlay = createOverlay({
+            hasBackdrop: true,
+            backdropClass: 'weave-overlay-backdrop--transparent',
+            positionStrategy: connectedPosition(t, { positions: buildPositions(props.position, 'bottom-start'), offset: 4 }),
+        });
+        overlay.onBackdropClick(() => closePanel(false));
+        overlay.attach(listbox);
+        t.setAttribute('aria-expanded', 'true');
+        t.setAttribute('aria-controls', listbox.id); // APG: combobox controls its listbox popup
+        open.set(true);
+        syncSelected();
+        // Seed the active option to the first selected (or first) when opening.
+        const firstSel = [...selectedValues()][0];
+        const seedItem = firstSel != null ? props.options.find((o) => optValue(o, props) === firstSel) : undefined;
+        if (seedItem && !optDisabled(seedItem, props))
+            km.setActiveItem(seedItem);
+        else if (seedActive)
+            km.first();
+        syncActive();
+    }
+    function closePanel(returnFocus) {
+        if (!open())
+            return;
+        overlay?.detach();
+        overlay = null;
+        const t = trigger();
+        t?.setAttribute('aria-expanded', 'false');
+        t?.removeAttribute('aria-controls'); // the listbox element is detached while closed
+        open.set(false);
+        props.control?.touched?.set(true);
+        if (returnFocus)
+            trigger()?.focus();
+    }
+    const onFieldClick = () => {
+        if (open())
+            closePanel(true);
+        else
+            openPanel(false);
+    };
+    const onTriggerKeydown = (event) => {
+        if (isDisabled())
+            return;
+        if (!open()) {
+            if (event.key === 'ArrowDown' || event.key === 'Enter' || event.key === ' ') {
+                event.preventDefault();
+                openPanel(true);
+            }
+            return;
+        }
+        if (event.key === 'Escape' || event.key === 'Tab') {
+            if (event.key === 'Escape')
+                event.preventDefault();
+            closePanel(event.key === 'Escape');
+            return;
+        }
+        // In the open listbox, both Enter and Space select/toggle the active option (WAI-ARIA APG
+        // listbox behaviour) — Space is a selection key here, not typeahead.
+        if (event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            const it = km.activeItem();
+            if (it)
+                toggleOption(it);
+            return;
+        }
+        if (km.onKeydown(event)) {
+            event.preventDefault();
+            syncActive();
+        }
+    };
+    const onClearClick = (event) => {
+        event.stopPropagation(); // don't toggle the panel
+        commit(props.multiple ? [] : undefined);
+    };
+    // Reflect external value changes (control/value) onto the option list + aria-invalid.
+    effect(() => {
+        currentSelection();
+        if (open())
+            syncSelected();
+    });
+    // Keep the OPEN panel's options in sync with a changing `options` (async loads / edits) and
+    // render fresh on every open — `renderOptions` reads `props.options`, tracked while open.
+    effect(() => {
+        if (open() && listbox) {
+            renderOptions(listbox);
+            syncSelected();
+            syncActive();
+        }
+    });
+    effect(() => {
+        const t = trigger();
+        if (!t)
+            return;
+        const c = props.control;
+        const invalid = !!(c && c.touched?.() && c.error?.());
+        if (invalid)
+            t.setAttribute('aria-invalid', 'true');
+        else
+            t.removeAttribute('aria-invalid');
+    });
+    // Tie the (lazily-created, event-scoped) overlay to the component's lifetime.
+    onDispose(() => {
+        overlay?.dispose();
+        overlay = null;
+    });
+    // Empty prefix/suffix slots collapse (no dead gap), like Input.
+    onMount(() => {
+        const el = root();
+        if (!el)
+            return;
+        for (const part of ['prefix', 'suffix']) {
+            const span = el.querySelector(`.weave-select__${part}`);
+            if (span && !span.querySelector('*') && !(span.textContent ?? '').trim()) {
+                span.classList.add(`weave-select__${part}--empty`);
+            }
+        }
+    });
+    const invalidNow = () => {
+        const c = props.control;
+        return !!(c && c.touched?.() && c.error?.());
+    };
+    return {
+        root,
+        trigger,
+        rootClass: () => {
+            const parts = ['weave-select'];
+            if (props.multiple)
+                parts.push('weave-select--multiple');
+            if (isDisabled())
+                parts.push('weave-select--disabled');
+            if (invalidNow())
+                parts.push('weave-select--invalid');
+            if (props.class)
+                parts.push(props.class);
+            return parts.join(' ');
+        },
+        valueClass: () => {
+            const empty = selectedValues().size === 0;
+            return empty ? 'weave-select__value weave-select__value--placeholder' : 'weave-select__value';
+        },
+        displayText: () => {
+            const sel = selectedValues();
+            if (sel.size === 0)
+                return props.placeholder ?? '';
+            if (props.multiple && sel.size > 1)
+                return `${sel.size} selected`;
+            return labelForValue([...sel][0]);
+        },
+        tabindex: () => (isDisabled() ? -1 : 0),
+        label: () => props.label,
+        ariaRequired: () => (props.required ? 'true' : undefined),
+        ariaDisabled: () => (isDisabled() ? 'true' : undefined),
+        showClear: () => !!props.clearable && !isDisabled() && selectedValues().size > 0,
+        clearLabel: () => props.clearLabel ?? 'Clear',
+        onFieldClick,
+        onTriggerKeydown,
+        onClearClick,
+    };
+}
+//# sourceMappingURL=select.js.map

package/dist/select/select.js.map

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

package/dist/shared/options.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared option model for every drop-list component (Menu, Select, Autocomplete). Options
+ * can be **any shape** — plain strings, the default `{value,label,description?,disabled?}`,
+ * or arbitrary data objects (e.g. an API row) — because the caller supplies **accessors**
+ * mapping each option to its value / label / description / disabled. Selection can **emit**
+ * either the value string or the whole option object. Zero-dep.
+ */
+/** The canonical fields every drop-list row needs, after accessor resolution. */
+export interface NormalizedOption<T> {
+    item: T;
+    value: string;
+    label: string;
+    description: string | undefined;
+    disabled: boolean;
+}
+/** Per-component accessors — omit to use the defaults (`.value`/`.label`/… or a string). */
+export interface OptionAccessors<T> {
+    /** Which field is the value. Default: the string itself, or `item.value`. */
+    optionValue?: (item: T) => string;
+    /** Which field to display. Default: the string itself, or `item.label` (falls back to value). */
+    optionLabel?: (item: T) => string;
+    /** Optional subtext under the label. Default: `item.description` (none for a string). */
+    optionDescription?: (item: T) => string | undefined;
+    /** Whether the option is disabled. Default: `item.disabled` (false for a string). */
+    optionDisabled?: (item: T) => boolean;
+    /**
+     * What a selection carries: `'value'` (the value string, default) or `'object'` (the whole
+     * option `T`). Drives the `onSelect`/`onChange` argument + the stored value.
+     */
+    emit?: 'value' | 'object';
+}
+/** Resolve an option's value using the accessor (or the default: string self / `.value`). */
+export declare function optValue<T>(item: T, acc: OptionAccessors<T>): string;
+/** Resolve an option's display label (default: string self / `.label` → `.value`). */
+export declare function optLabel<T>(item: T, acc: OptionAccessors<T>): string;
+/** Resolve an option's subtext (default: `.description`, none for a string). */
+export declare function optDescription<T>(item: T, acc: OptionAccessors<T>): string | undefined;
+/** Resolve an option's disabled flag (default: `.disabled`, false for a string). */
+export declare function optDisabled<T>(item: T, acc: OptionAccessors<T>): boolean;
+/** Normalize an option into its canonical fields. */
+export declare function normalize<T>(item: T, acc: OptionAccessors<T>): NormalizedOption<T>;
+/** What a selection of `item` emits, per the `emit` mode (default `'value'`). */
+export declare function emitSelection<T>(item: T, acc: OptionAccessors<T>): string | T;
+//# sourceMappingURL=options.d.ts.map

package/dist/shared/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/shared/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,iGAAiG;IACjG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,qFAAqF;IACrF,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC3B;AAaD,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAIpE;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAKpE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAKtF;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAIxE;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAQlF;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAE7E"}

package/dist/shared/options.js

@@ -0,0 +1,59 @@
+/**
+ * Shared option model for every drop-list component (Menu, Select, Autocomplete). Options
+ * can be **any shape** — plain strings, the default `{value,label,description?,disabled?}`,
+ * or arbitrary data objects (e.g. an API row) — because the caller supplies **accessors**
+ * mapping each option to its value / label / description / disabled. Selection can **emit**
+ * either the value string or the whole option object. Zero-dep.
+ */
+function isString(v) {
+    return typeof v === 'string';
+}
+/** Resolve an option's value using the accessor (or the default: string self / `.value`). */
+export function optValue(item, acc) {
+    if (acc.optionValue)
+        return acc.optionValue(item);
+    if (isString(item))
+        return item;
+    return String(item.value);
+}
+/** Resolve an option's display label (default: string self / `.label` → `.value`). */
+export function optLabel(item, acc) {
+    if (acc.optionLabel)
+        return acc.optionLabel(item);
+    if (isString(item))
+        return item;
+    const o = item;
+    return String(o.label ?? o.value);
+}
+/** Resolve an option's subtext (default: `.description`, none for a string). */
+export function optDescription(item, acc) {
+    if (acc.optionDescription)
+        return acc.optionDescription(item);
+    if (isString(item))
+        return undefined;
+    const d = item.description;
+    return d == null ? undefined : String(d);
+}
+/** Resolve an option's disabled flag (default: `.disabled`, false for a string). */
+export function optDisabled(item, acc) {
+    if (acc.optionDisabled)
+        return acc.optionDisabled(item);
+    if (isString(item))
+        return false;
+    return Boolean(item.disabled);
+}
+/** Normalize an option into its canonical fields. */
+export function normalize(item, acc) {
+    return {
+        item,
+        value: optValue(item, acc),
+        label: optLabel(item, acc),
+        description: optDescription(item, acc),
+        disabled: optDisabled(item, acc),
+    };
+}
+/** What a selection of `item` emits, per the `emit` mode (default `'value'`). */
+export function emitSelection(item, acc) {
+    return acc.emit === 'object' ? item : optValue(item, acc);
+}
+//# sourceMappingURL=options.js.map

package/dist/shared/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/shared/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmCH,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAI,IAAO,EAAE,GAAuB;IAC1D,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,MAAM,CAAE,IAAkB,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAI,IAAO,EAAE,GAAuB;IAC1D,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAc,IAAiB,CAAC;IACvC,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAI,IAAO,EAAE,GAAuB;IAChE,IAAI,GAAG,CAAC,iBAAiB;QAAE,OAAO,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,CAAC,GAAa,IAAkB,CAAC,WAAW,CAAC;IACnD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAI,IAAO,EAAE,GAAuB;IAC7D,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,OAAO,CAAE,IAAkB,CAAC,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAI,IAAO,EAAE,GAAuB;IAC3D,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;QAC1B,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;QAC1B,WAAW,EAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;QACtC,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAI,IAAO,EAAE,GAAuB;IAC/D,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/dist/shared/positions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared connected-position vocabulary for anchored panels (Menu, Select, Autocomplete).
+ * A position is a named preset (RTL-aware `-start`/`-end`) or an explicit anchor pair.
+ */
+import type { ConnectedPosition, PositionName } from '../cdk/index.js';
+/**
+ * Where a panel sits relative to its object. Either a named preset or an explicit
+ * origin↔overlay anchor pair for full 3×3 control. Presets map to the mental model:
+ *   below:  `bottom-start` (left) · `bottom` (centre) · `bottom-end` (right)
+ *   above:  `top-start`    (left) · `top`    (centre) · `top-end`    (right)
+ *   side:   `left` / `right` (+ `-start`/`-end` for top/bottom-aligned)
+ */
+export type MenuPosition = PositionName | ConnectedPosition;
+/**
+ * Build the flip-fallback list from a requested position. A preset gets its opposite
+ * appended (so it flips on overflow); an explicit pair is used as-is (shift-clamps to fit);
+ * nothing requested falls back to the component default (+ its opposite).
+ */
+export declare function buildPositions(position: MenuPosition | undefined, fallback: PositionName): MenuPosition[];
+//# sourceMappingURL=positions.d.ts.map

package/dist/shared/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../src/shared/positions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAiB5D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAIzG"}

package/dist/shared/positions.js

@@ -0,0 +1,27 @@
+const OPPOSITE = {
+    top: 'bottom',
+    bottom: 'top',
+    left: 'right',
+    right: 'left',
+    'top-start': 'bottom-start',
+    'bottom-start': 'top-start',
+    'top-end': 'bottom-end',
+    'bottom-end': 'top-end',
+    'left-start': 'right-start',
+    'right-start': 'left-start',
+    'left-end': 'right-end',
+    'right-end': 'left-end',
+};
+/**
+ * Build the flip-fallback list from a requested position. A preset gets its opposite
+ * appended (so it flips on overflow); an explicit pair is used as-is (shift-clamps to fit);
+ * nothing requested falls back to the component default (+ its opposite).
+ */
+export function buildPositions(position, fallback) {
+    if (position == null)
+        return [fallback, OPPOSITE[fallback]];
+    if (typeof position === 'string')
+        return [position, OPPOSITE[position]];
+    return [position];
+}
+//# sourceMappingURL=positions.js.map

package/dist/shared/positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.js","sourceRoot":"","sources":["../../src/shared/positions.ts"],"names":[],"mappings":"AAeA,MAAM,QAAQ,GAAuC;IACnD,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,WAAW;IAC3B,SAAS,EAAE,YAAY;IACvB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,YAAY;IAC3B,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,UAAU;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAkC,EAAE,QAAsB;IACvF,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC"}

package/dist/sidenav/sidenav.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `<Sidenav>` — the responsive layout shell: a `__drawer` beside a `__content`, in one of
+ * three modes:
+ *
+ * - **`side`** — the drawer is in flow and pushes the content (always-visible on wide screens).
+ * - **`over`** — the drawer floats over the content with a dimming backdrop; it becomes a focus
+ *   context (focus-trap in, Esc + backdrop-click close). This is the off-canvas mobile drawer.
+ * - **`push`** — the drawer floats but also shifts the content over by its width (both slide).
+ *
+ * **Responsive:** omit `mode` and the Sidenav consumes the CDK `breakpointSignal` — below the
+ * Weave `Narrow` breakpoint (900px) it auto-switches to `over` + closed; above, `side` + open.
+ * This fulfils the off-canvas drawer deferred from the U2 Toolbar (a Toolbar hamburger toggles it).
+ *
+ * **Open state** is the Weave convention: controlled `opened` (getter) + `onOpenedChange`, OR
+ * uncontrolled `defaultOpened`. Imperative `open()`/`close()`/`toggle()` are exposed via the
+ * `api` ref callback (like Input's `onInputRef`).
+ *
+ *   import Sidenav from '@weave-framework/ui/sidenav';
+ *   <Sidenav opened={{ nav() }} onOpenedChange={{ nav.set }}>
+ *     <nav slot="drawer">…links…</nav>
+ *     <main>…page…</main>
+ *   </Sidenav>
+ */
+import { type Signal } from '@weave-framework/runtime';
+/** The drawer layout mode. Omit to derive it responsively from the breakpoint. */
+export type SidenavMode = 'side' | 'over' | 'push';
+/** Imperative handle exposed via the `api` ref callback. */
+export interface SidenavApi {
+    open(): void;
+    close(): void;
+    toggle(): void;
+    /** Reactive — the current open state. */
+    opened(): boolean;
+}
+export interface SidenavProps {
+    /** Fixed mode. Omit for responsive behaviour (over+closed when narrow, side+open when wide). */
+    mode?: SidenavMode;
+    /** Controlled open state (a getter). Ignored for the internal state when omitted. */
+    opened?: boolean;
+    /** Called with the next open state whenever it changes (backdrop/Esc/api/responsive). */
+    onOpenedChange?: (opened: boolean) => void;
+    /** Uncontrolled initial open state (explicit mode only; responsive mode derives it). */
+    defaultOpened?: boolean;
+    /** Which edge the drawer docks to. Default `'start'`. */
+    position?: 'start' | 'end';
+    /** The media query that drives responsive mode. Default the Weave `Narrow` breakpoint (900px). */
+    breakpoint?: string;
+    /** Force the backdrop on/off. Default: shown only in `over` mode. */
+    backdrop?: boolean;
+    /** Receives the imperative `{ open, close, toggle, opened }` handle once mounted. */
+    api?: (api: SidenavApi) => void;
+    /** Extra classes, forwarded onto the root. */
+    class?: string;
+}
+export declare const template: string;
+export interface SidenavContext {
+    root: Signal<HTMLElement | null>;
+    drawer: Signal<HTMLElement | null>;
+    rootClass: () => string;
+    drawerModal: () => 'true' | undefined;
+    onKeydown: (event: KeyboardEvent) => void;
+    onBackdropClick: () => void;
+}
+export declare function setup(props: SidenavProps): SidenavContext;
+//# sourceMappingURL=sidenav.d.ts.map

package/dist/sidenav/sidenav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidenav.d.ts","sourceRoot":"","sources":["../../src/sidenav/sidenav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAsC,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAG3F,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,yCAAyC;IACzC,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,gGAAgG;IAChG,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,wFAAwF;IACxF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC3B,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,EAAE,MAKb,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CA8FzD"}