@weave-framework/ui 0.2.107

package/dist/menu/menu.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Menu — a dropdown of actions, applied as a Weave `use:` action to a trigger element:
+ *
+ *   <button use:menu={{ { items: [{value:'edit',label:'Edit'}, {value:'del',label:'Delete'}],
+ *                        onSelect: (v) => run(v) } }}>Actions ▾</button>
+ *
+ * Click (or ArrowDown / Enter / Space) opens a CDK-overlay panel anchored under the
+ * trigger; keyboard, roving focus, typeahead, click-away and focus-return are handled by
+ * the shared menu core. The trigger carries `aria-haspopup=menu` + `aria-expanded`. The
+ * visual is `menu.styles()` (the `--weave-menu-*` republic). Zero-dep.
+ */
+import { type MenuItem, type MenuPosition, type OptionAccessors } from './menu-core.js';
+export type { MenuItem, MenuPosition, OptionAccessors } from './menu-core.js';
+export interface MenuOptions<T = MenuItem> extends OptionAccessors<T> {
+    /** The options — the default `{value,label,description?,disabled?,divider?}`, plain strings,
+     * or arbitrary objects (map their fields via the `option*` accessors). */
+    items: T[];
+    /** Called with the chosen option (value string, or the whole object — see `emit`). */
+    onSelect: (selected: string | T) => void;
+    /** Is this option a hairline separator? Default: `item.divider`. */
+    isDivider?: (item: T) => boolean;
+    /**
+     * Where the panel sits relative to the trigger; flips to the opposite on overflow.
+     * A preset (`'bottom-start'`, `'top'`, `'bottom-end'`, …) or an explicit anchor pair.
+     * Default `'bottom-start'` (below, left-aligned).
+     */
+    position?: MenuPosition;
+}
+/** Weave `use:` action: `(trigger, options) => cleanup`. */
+export declare function menu<T = MenuItem>(trigger: HTMLElement, options: MenuOptions<T>): () => void;
+//# sourceMappingURL=menu.d.ts.map

package/dist/menu/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/menu/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9E,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,QAAQ,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IACnE;8EAC0E;IAC1E,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,sFAAsF;IACtF,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC;IACzC,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,CAAC,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAoD5F"}

package/dist/menu/menu.js

@@ -0,0 +1,68 @@
+/**
+ * Menu — a dropdown of actions, applied as a Weave `use:` action to a trigger element:
+ *
+ *   <button use:menu={{ { items: [{value:'edit',label:'Edit'}, {value:'del',label:'Delete'}],
+ *                        onSelect: (v) => run(v) } }}>Actions ▾</button>
+ *
+ * Click (or ArrowDown / Enter / Space) opens a CDK-overlay panel anchored under the
+ * trigger; keyboard, roving focus, typeahead, click-away and focus-return are handled by
+ * the shared menu core. The trigger carries `aria-haspopup=menu` + `aria-expanded`. The
+ * visual is `menu.styles()` (the `--weave-menu-*` republic). Zero-dep.
+ */
+import { openMenuPanel, buildPositions, } from './menu-core.js';
+/** Weave `use:` action: `(trigger, options) => cleanup`. */
+export function menu(trigger, options) {
+    let handle = null;
+    trigger.setAttribute('aria-haspopup', 'menu');
+    trigger.setAttribute('aria-expanded', 'false');
+    function openMenu(focusFirst) {
+        if (handle)
+            return;
+        handle = openMenuPanel({
+            origin: trigger,
+            items: options.items,
+            positions: buildPositions(options.position, 'bottom-start'),
+            focusFirst,
+            isDivider: options.isDivider,
+            optionValue: options.optionValue,
+            optionLabel: options.optionLabel,
+            optionDescription: options.optionDescription,
+            optionDisabled: options.optionDisabled,
+            emit: options.emit,
+            onSelect: options.onSelect,
+            onClose: (returnFocus) => {
+                handle = null;
+                trigger.setAttribute('aria-expanded', 'false');
+                if (returnFocus)
+                    trigger.focus();
+            },
+        });
+        if (handle)
+            trigger.setAttribute('aria-expanded', 'true');
+    }
+    // Click = pointer open (no item pre-highlighted); ↓/Enter/Space = keyboard open (first item).
+    const onTriggerClick = () => {
+        if (handle)
+            handle.close(true);
+        else
+            openMenu(false);
+    };
+    const onTriggerKeydown = (event) => {
+        if (handle)
+            return; // once open, the panel owns the keyboard
+        if (event.key === 'ArrowDown' || event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            openMenu(true);
+        }
+    };
+    trigger.addEventListener('click', onTriggerClick);
+    trigger.addEventListener('keydown', onTriggerKeydown);
+    return () => {
+        handle?.close(false);
+        trigger.removeEventListener('click', onTriggerClick);
+        trigger.removeEventListener('keydown', onTriggerKeydown);
+        trigger.removeAttribute('aria-haspopup');
+        trigger.removeAttribute('aria-expanded');
+    };
+}
+//# sourceMappingURL=menu.js.map

package/dist/menu/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/menu/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,aAAa,EACb,cAAc,GAKf,MAAM,gBAAgB,CAAC;AAoBxB,4DAA4D;AAC5D,MAAM,UAAU,IAAI,CAAe,OAAoB,EAAE,OAAuB;IAC9E,IAAI,MAAM,GAAsB,IAAI,CAAC;IAErC,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAE/C,SAAS,QAAQ,CAAC,UAAmB;QACnC,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,aAAa,CAAI;YACxB,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC;YAC3D,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,CAAC,WAAoB,EAAQ,EAAE;gBACtC,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBAC/C,IAAI,WAAW;oBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;QACH,IAAI,MAAM;YAAE,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,8FAA8F;IAC9F,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,IAAI,MAAM;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;YAC1B,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,KAAoB,EAAQ,EAAE;QACtD,IAAI,MAAM;YAAE,OAAO,CAAC,yCAAyC;QAC7D,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YAC5E,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAClD,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAEtD,OAAO,GAAS,EAAE;QAChB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACrD,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACzD,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QACzC,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC"}

package/dist/menubar/menubar.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `<Menubar>` — an app menu bar (File / Edit / View …), the WAI-ARIA **menubar** pattern. A
+ * `role=menubar` row of top-level `<button role=menuitem>`s; activating one opens a dropdown
+ * **Menu** — the same panel as the U3 `use:menu` (composed via `menu-core.openMenuPanel`, so
+ * the panel chrome, roving focus, typeahead, Esc/backdrop are all reused, not re-created).
+ *
+ * Keyboard (APG menubar): Left/Right rove the top items (wrap), Home/End jump, typeahead;
+ * **ArrowDown / Enter / Space open** the active menu (focused on its first item); while a menu
+ * is open, **Left/Right switch to the neighbour's menu** (the classic menubar feel); Esc closes
+ * and returns focus to the top item. A single roving tab stop.
+ *
+ *   import Menubar from '@weave-framework/ui/menubar';
+ *   <Menubar menus={{ [{ label: 'File', items: [{ value: 'new', label: 'New' }] }] }}
+ *            onSelect={{ (v) => run(v) }} />
+ */
+import { type Signal } from '@weave-framework/runtime';
+import { type MenuItem } from '../menu/menu-core.js';
+export interface MenubarMenu {
+    /** Top-level label. */
+    label: string;
+    /** The dropdown items (reuses the Menu item model — `divider`, `disabled`, `description`). */
+    items: MenuItem[];
+    /** Disable this whole top item. */
+    disabled?: boolean;
+}
+export interface MenubarProps {
+    /** The top-level menus, left to right. */
+    menus: MenubarMenu[];
+    /** Called with the chosen item's value (or the whole item object). */
+    onSelect?: (value: string | MenuItem) => void;
+    /** Accessible name for the menubar. */
+    label?: string;
+    /** Extra classes, forwarded onto the container. */
+    class?: string;
+}
+export declare const template: string;
+export interface MenubarContext {
+    host: Signal<HTMLElement | null>;
+    menus: () => MenubarMenu[];
+    rootClass: () => string;
+    label: () => string | undefined;
+    expandedAttr: (index: number) => 'true' | 'false';
+    disabledAttr: (menu: MenubarMenu) => 'true' | undefined;
+    tabindexFor: (index: number) => number;
+    onTopClick: (index: number) => void;
+    onKeydown: (event: KeyboardEvent) => void;
+}
+export declare function setup(props: MenubarProps): MenubarContext;
+//# sourceMappingURL=menubar.d.ts.map

package/dist/menubar/menubar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menubar.d.ts","sourceRoot":"","sources":["../../src/menubar/menubar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAiC,KAAK,QAAQ,EAAmB,MAAM,sBAAsB,CAAC;AAErG,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC9C,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,QAAQ,EAAE,MASb,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,WAAW,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAC;IACxD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3C;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAuIzD"}

package/dist/menubar/menubar.js

@@ -0,0 +1,162 @@
+/**
+ * `<Menubar>` — an app menu bar (File / Edit / View …), the WAI-ARIA **menubar** pattern. A
+ * `role=menubar` row of top-level `<button role=menuitem>`s; activating one opens a dropdown
+ * **Menu** — the same panel as the U3 `use:menu` (composed via `menu-core.openMenuPanel`, so
+ * the panel chrome, roving focus, typeahead, Esc/backdrop are all reused, not re-created).
+ *
+ * Keyboard (APG menubar): Left/Right rove the top items (wrap), Home/End jump, typeahead;
+ * **ArrowDown / Enter / Space open** the active menu (focused on its first item); while a menu
+ * is open, **Left/Right switch to the neighbour's menu** (the classic menubar feel); Esc closes
+ * and returns focus to the top item. A single roving tab stop.
+ *
+ *   import Menubar from '@weave-framework/ui/menubar';
+ *   <Menubar menus={{ [{ label: 'File', items: [{ value: 'new', label: 'New' }] }] }}
+ *            onSelect={{ (v) => run(v) }} />
+ */
+import { signal, onMount, onDispose } from '@weave-framework/runtime';
+import { listKeyManager } from '../cdk/index.js';
+import { openMenuPanel, buildPositions } from '../menu/menu-core.js';
+export const template = '<div class={{ rootClass() }} role="menubar" aria-label={{ label() }} ref={{ host }} on:keydown={{ onKeydown }}>' +
+    '@for (menu of menus(); track $index) {' +
+    '<button class="weave-menubar__item" type="button" role="menuitem" aria-haspopup="menu"' +
+    ' aria-expanded={{ expandedAttr($index) }} aria-disabled={{ disabledAttr(menu) }}' +
+    ' tabindex={{ tabindexFor($index) }} on:click={{ () => onTopClick($index) }}>' +
+    '{{ menu.label }}' +
+    '</button>' +
+    '}' +
+    '</div>';
+export function setup(props) {
+    const host = signal(null);
+    const openIndex = signal(-1);
+    let handle = null;
+    let arrowListener = null;
+    const menus = () => props.menus ?? [];
+    const isDisabled = (menu) => !!menu.disabled;
+    const manager = listKeyManager(menus, {
+        orientation: 'horizontal',
+        wrap: true,
+        skipDisabled: true,
+        isDisabled,
+        typeahead: true,
+        getLabel: (m) => m.label,
+    });
+    const rovingIndex = () => {
+        const active = manager.activeIndex();
+        if (active >= 0)
+            return active;
+        const first = menus().findIndex((m) => !isDisabled(m));
+        return first >= 0 ? first : 0;
+    };
+    const topButtons = () => Array.from(host()?.querySelectorAll('.weave-menubar__item') ?? []);
+    const focusTop = (index) => {
+        topButtons()[index]?.focus();
+    };
+    // Next enabled top index in a direction, wrapping.
+    const nextEnabled = (from, step) => {
+        const list = menus();
+        const n = list.length;
+        for (let k = 1; k <= n; k++) {
+            const i = (((from + step * k) % n) + n) % n;
+            if (!isDisabled(list[i]))
+                return i;
+        }
+        return from;
+    };
+    // While a menu is open, Left/Right switch to the neighbour's menu. The dropdown panel is
+    // portaled (not a menubar descendant), so we catch these at the document (capture) level;
+    // the menu core ignores Left/Right, so there's no conflict.
+    const addArrowSwitch = () => {
+        if (arrowListener)
+            return;
+        arrowListener = (event) => {
+            if (openIndex() < 0)
+                return;
+            if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
+                event.preventDefault();
+                openMenu(nextEnabled(openIndex(), event.key === 'ArrowRight' ? 1 : -1));
+            }
+        };
+        document.addEventListener('keydown', arrowListener, true);
+    };
+    const removeArrowSwitch = () => {
+        if (arrowListener)
+            document.removeEventListener('keydown', arrowListener, true);
+        arrowListener = null;
+    };
+    function closeMenu(returnFocus) {
+        handle?.close(returnFocus);
+    }
+    function openMenu(index) {
+        const menu = menus()[index];
+        if (!menu || isDisabled(menu))
+            return;
+        handle?.close(false); // close any currently-open menu first (no focus bounce)
+        const btn = topButtons()[index];
+        if (!btn)
+            return;
+        manager.setActiveItem(index);
+        handle = openMenuPanel({
+            origin: btn,
+            items: menu.items,
+            positions: buildPositions('bottom-start', 'bottom-start'),
+            focusFirst: true, // a menubar always opens focused on the first item
+            onSelect: (value) => props.onSelect?.(value),
+            onClose: (returnFocus) => {
+                handle = null;
+                openIndex.set(-1);
+                removeArrowSwitch();
+                if (returnFocus)
+                    focusTop(index);
+            },
+        });
+        if (handle) {
+            openIndex.set(index);
+            addArrowSwitch();
+        }
+    }
+    const onTopClick = (index) => {
+        if (openIndex() === index)
+            closeMenu(true);
+        else
+            openMenu(index);
+    };
+    const onKeydown = (event) => {
+        if (manager.activeIndex() < 0)
+            manager.setActiveItem(rovingIndex());
+        if (event.key === 'ArrowDown' || event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            openMenu(manager.activeIndex());
+            return;
+        }
+        if (manager.onKeydown(event)) {
+            event.preventDefault();
+            focusTop(manager.activeIndex());
+        }
+    };
+    onMount(() => {
+        // Seed the roving tab stop to the first enabled item.
+        manager.setActiveItem(rovingIndex());
+    });
+    // Close any open dropdown when the menubar unmounts (the panel overlay is created outside
+    // the owner scope, so tie its teardown here — else panels leak across renders/tests).
+    onDispose(() => {
+        handle?.close(false);
+        removeArrowSwitch();
+    });
+    return {
+        host,
+        menus,
+        rootClass: () => (props.class ? `weave-menubar ${props.class}` : 'weave-menubar'),
+        label: () => props.label,
+        expandedAttr: (index) => (openIndex() === index ? 'true' : 'false'),
+        disabledAttr: (menu) => (isDisabled(menu) ? 'true' : undefined),
+        tabindexFor: (index) => {
+            if (isDisabled(menus()[index]))
+                return -1;
+            return index === rovingIndex() ? 0 : -1;
+        },
+        onTopClick,
+        onKeydown,
+    };
+}
+//# sourceMappingURL=menubar.js.map

package/dist/menubar/menubar.js.map

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

package/dist/paginator/paginator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `<Paginator>` — page navigation over a total item count.
+ *
+ * Prev / next arrows around a **windowed** run of page buttons: the first and last
+ * page are always shown, a window of `siblingCount` pages surrounds the current one,
+ * and the gaps collapse to an ellipsis (…) — so 100 pages read as `‹ 1 … 5 6 7 … 100 ›`.
+ * The active page takes the ink fill. A **"N–M of T" range label**, a **manual
+ * "go to page" input**, and an optional **page-size menu** round it out.
+ *
+ * Pure + controlled: pass `length` (total items), `pageSize`, and `pageIndex` (0-based);
+ * every action calls `onPage({ pageIndex, pageSize, length })` — the paginator computes
+ * the page count, the window and the range label, and never fetches data itself.
+ *
+ *   import Paginator from '@weave-framework/ui/paginator';
+ *   <Paginator length={{ 973 }} pageSize={{ 12 }} pageIndex={{ page() }}
+ *              pageSizeOptions={{ [12, 24, 48] }} onPage={{ (e) => setPage(e.pageIndex) }} />
+ */
+import { type Signal } from '@weave-framework/runtime';
+/** A page-size option shown in the composed Select. */
+interface SizeOption {
+    value: string;
+    label: string;
+}
+export interface PageEvent {
+    pageIndex: number;
+    pageSize: number;
+    length: number;
+}
+export interface PaginatorProps {
+    /** Total number of items. */
+    length: number;
+    /** Items per page. */
+    pageSize: number;
+    /** Current page, 0-based. */
+    pageIndex: number;
+    /** Called with the next state on any navigation / size change. */
+    onPage?: (event: PageEvent) => void;
+    /** If set, shows a page-size menu with these options. */
+    pageSizeOptions?: number[];
+    /** Pages shown on each side of the current one before an ellipsis. Default 1. */
+    siblingCount?: number;
+    /** Pages pinned at each end. Default 1. */
+    boundaryCount?: number;
+    /** Show the "N–M of T" range label. Default true. */
+    showRange?: boolean;
+    /** Show the manual "go to page" input. Default true. */
+    showJump?: boolean;
+    /** Disable the whole paginator. */
+    disabled?: boolean;
+    /** Accessible name for the nav landmark. Default "Pagination". */
+    label?: string;
+    /** Label before the jump input. Default "Go to". */
+    jumpLabel?: string;
+    /** Extra classes, forwarded onto the nav. */
+    class?: string;
+}
+type PageCell = number | 'ellipsis';
+export declare const template: string;
+export interface PaginatorContext {
+    host: Signal<Element | null>;
+    rootClass: () => string;
+    navLabel: () => string;
+    cells: () => PageCell[];
+    isPage: (cell: PageCell) => boolean;
+    pageLabel: (cell: PageCell) => string;
+    pageCurrent: (cell: PageCell) => string | undefined;
+    pageVariant: (cell: PageCell) => string;
+    isDisabled: () => boolean;
+    goTo: (page: number) => void;
+    prev: () => void;
+    next: () => void;
+    prevDisabled: () => boolean;
+    nextDisabled: () => boolean;
+    showRange: () => boolean;
+    rangeText: () => string;
+    showJump: () => boolean;
+    jumpLabel: () => string;
+    jumpValue: () => string;
+    pageCount: () => number;
+    currentPage: () => number;
+    onJumpKeydown: (event: KeyboardEvent) => void;
+    hasSizeOptions: () => boolean;
+    sizeOptions: () => SizeOption[];
+    sizeValue: () => string;
+    onSizeChange: (value: string) => void;
+}
+export declare function setup(props: PaginatorProps): PaginatorContext;
+export {};
+//# sourceMappingURL=paginator.d.ts.map

package/dist/paginator/paginator.d.ts.map

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

package/dist/paginator/paginator.js

@@ -0,0 +1,159 @@
+/**
+ * `<Paginator>` — page navigation over a total item count.
+ *
+ * Prev / next arrows around a **windowed** run of page buttons: the first and last
+ * page are always shown, a window of `siblingCount` pages surrounds the current one,
+ * and the gaps collapse to an ellipsis (…) — so 100 pages read as `‹ 1 … 5 6 7 … 100 ›`.
+ * The active page takes the ink fill. A **"N–M of T" range label**, a **manual
+ * "go to page" input**, and an optional **page-size menu** round it out.
+ *
+ * Pure + controlled: pass `length` (total items), `pageSize`, and `pageIndex` (0-based);
+ * every action calls `onPage({ pageIndex, pageSize, length })` — the paginator computes
+ * the page count, the window and the range label, and never fetches data itself.
+ *
+ *   import Paginator from '@weave-framework/ui/paginator';
+ *   <Paginator length={{ 973 }} pageSize={{ 12 }} pageIndex={{ page() }}
+ *              pageSizeOptions={{ [12, 24, 48] }} onPage={{ (e) => setPage(e.pageIndex) }} />
+ */
+import { signal } from '@weave-framework/runtime';
+export const template = '<nav class={{ rootClass() }} ref={{ host }} aria-label={{ navLabel() }}>' +
+    '<Button variant="ghost" class="weave-paginator__nav" label="Previous page"' +
+    ' disabled={{ prevDisabled() }} on:click={{ prev }}>‹</Button>' +
+    '@for (cell of cells(); track $index) {' +
+    '@if (isPage(cell)) {' +
+    '<Button variant={{ pageVariant(cell) }} class="weave-paginator__page" label={{ pageLabel(cell) }}' +
+    ' ariaCurrent={{ pageCurrent(cell) }} disabled={{ isDisabled() }}' +
+    ' on:click={{ () => goTo(cell) }}>{{ cell }}</Button>' +
+    '}' +
+    '@if (!isPage(cell)) {<span class="weave-paginator__ellipsis" aria-hidden="true">…</span>}' +
+    '}' +
+    '<Button variant="ghost" class="weave-paginator__nav" label="Next page"' +
+    ' disabled={{ nextDisabled() }} on:click={{ next }}>›</Button>' +
+    '@if (showRange()) {<span class="weave-paginator__range">{{ rangeText() }}</span>}' +
+    '@if (showJump()) {' +
+    '<span class="weave-paginator__jump">' +
+    '<label class="weave-paginator__jump-label">{{ jumpLabel() }}</label>' +
+    '<Input type="number" value={{ jumpValue() }} disabled={{ isDisabled() }} label="Go to page"' +
+    ' class="weave-paginator__jump-field" on:keydown={{ onJumpKeydown }} />' +
+    '</span>' +
+    '}' +
+    '@if (hasSizeOptions()) {' +
+    '<Select options={{ sizeOptions() }} value={{ sizeValue() }} onChange={{ onSizeChange }}' +
+    ' disabled={{ isDisabled() }} label="Items per page" class="weave-paginator__size" />' +
+    '}' +
+    '</nav>';
+function range(start, end) {
+    const out = [];
+    for (let i = start; i <= end; i += 1)
+        out.push(i);
+    return out;
+}
+// The windowed page run: boundary pages pinned at each end, `siblings` around the
+// current page, gaps collapsed to a single 'ellipsis'. A one-page gap shows the page
+// instead of an ellipsis (never "1 … 3" when "1 2 3" fits).
+function buildCells(current, total, siblings, boundary) {
+    const totalNumbers = siblings * 2 + 3 + boundary * 2;
+    if (total <= totalNumbers + 2)
+        return range(1, total);
+    const leftSibling = Math.max(current - siblings, boundary + 2);
+    const rightSibling = Math.min(current + siblings, total - boundary - 1);
+    const showLeftEllipsis = leftSibling > boundary + 2;
+    const showRightEllipsis = rightSibling < total - boundary - 1;
+    const cells = [...range(1, boundary)];
+    if (showLeftEllipsis)
+        cells.push('ellipsis');
+    else
+        cells.push(...range(boundary + 1, leftSibling - 1));
+    cells.push(...range(leftSibling, rightSibling));
+    if (showRightEllipsis)
+        cells.push('ellipsis');
+    else
+        cells.push(...range(rightSibling + 1, total - boundary));
+    cells.push(...range(total - boundary + 1, total));
+    return cells;
+}
+export function setup(props) {
+    const host = signal(null);
+    const length = () => Math.max(0, props.length ?? 0);
+    const pageSize = () => Math.max(1, props.pageSize ?? 1);
+    const pageCount = () => Math.max(1, Math.ceil(length() / pageSize()));
+    // Clamp the incoming index to the valid range.
+    const pageIndex = () => Math.min(Math.max(0, props.pageIndex ?? 0), pageCount() - 1);
+    const currentPage = () => pageIndex() + 1;
+    const disabled = () => !!props.disabled;
+    const emit = (nextIndex, nextSize) => {
+        props.onPage?.({ pageIndex: nextIndex, pageSize: nextSize, length: length() });
+    };
+    const goToIndex = (index) => {
+        if (disabled())
+            return;
+        const clamped = Math.min(Math.max(0, index), pageCount() - 1);
+        if (clamped === pageIndex())
+            return;
+        emit(clamped, pageSize());
+    };
+    const changeSize = (size) => {
+        if (disabled() || size === pageSize())
+            return;
+        // Keep the first visible item on screen when the page size changes.
+        const firstItem = pageIndex() * pageSize();
+        const nextIndex = Math.floor(firstItem / size);
+        props.onPage?.({ pageIndex: nextIndex, pageSize: size, length: length() });
+    };
+    return {
+        host,
+        rootClass: () => {
+            const parts = ['weave-paginator'];
+            if (disabled())
+                parts.push('weave-paginator--disabled');
+            if (props.class)
+                parts.push(props.class);
+            return parts.join(' ');
+        },
+        navLabel: () => props.label ?? 'Pagination',
+        cells: () => buildCells(currentPage(), pageCount(), props.siblingCount ?? 1, props.boundaryCount ?? 1),
+        isPage: (cell) => typeof cell === 'number',
+        pageLabel: (cell) => `Go to page ${cell}`,
+        pageCurrent: (cell) => (cell === currentPage() ? 'page' : undefined),
+        // Active page = the Button's ink-fill primary variant; others = ghost.
+        pageVariant: (cell) => (cell === currentPage() ? 'primary' : 'ghost'),
+        isDisabled: () => disabled(),
+        goTo: (page) => goToIndex(page - 1),
+        prev: () => goToIndex(pageIndex() - 1),
+        next: () => goToIndex(pageIndex() + 1),
+        prevDisabled: () => disabled() || pageIndex() <= 0,
+        nextDisabled: () => disabled() || pageIndex() >= pageCount() - 1,
+        showRange: () => props.showRange !== false,
+        rangeText: () => {
+            const total = length();
+            if (total === 0)
+                return '0 of 0';
+            const start = pageIndex() * pageSize() + 1;
+            const end = Math.min(total, (pageIndex() + 1) * pageSize());
+            return `${start}–${end} of ${total}`;
+        },
+        showJump: () => props.showJump !== false,
+        jumpLabel: () => props.jumpLabel ?? 'Go to',
+        jumpValue: () => String(currentPage()),
+        pageCount,
+        currentPage,
+        // The jump field is a composed <Input>; on Enter, read the typed value off the
+        // native input the event bubbled from and navigate (clamped).
+        onJumpKeydown: (event) => {
+            if (event.key !== 'Enter')
+                return;
+            const input = event.target.closest('.weave-input')?.querySelector('input') ?? null;
+            const raw = input ? input.value : event.target.value;
+            const target = parseInt(raw, 10);
+            if (Number.isFinite(target))
+                goToIndex(target - 1);
+            event.preventDefault();
+        },
+        hasSizeOptions: () => (props.pageSizeOptions?.length ?? 0) > 0,
+        // Page-size options + value for the composed <Select>.
+        sizeOptions: () => (props.pageSizeOptions ?? []).map((n) => ({ value: String(n), label: `${n} / page` })),
+        sizeValue: () => String(pageSize()),
+        onSizeChange: (value) => changeSize(Number(value)),
+    };
+}
+//# sourceMappingURL=paginator.js.map

package/dist/paginator/paginator.js.map

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

package/dist/popover-edit/popover-edit.d.ts

@@ -0,0 +1,33 @@
+import { type MenuPosition } from '../shared/positions.js';
+/** A custom editor: build the DOM + expose how to read its value + which element to focus. */
+export interface PopoverEditor {
+    element: HTMLElement;
+    /** Read the current editor value (called on commit). */
+    read: () => string;
+    /** The element to focus on open (defaults to `element`). */
+    focusTarget?: HTMLElement;
+}
+export interface PopoverEditConfig {
+    /** Current value getter (seeds the editor on open). */
+    value: () => string;
+    /** Called with the next value on commit (Enter / click-away). */
+    onCommit: (next: string) => void;
+    /** Build a custom editor (default: a text field). */
+    editor?: (value: string) => PopoverEditor;
+    /** Placeholder for the default text editor. */
+    placeholder?: string;
+    /** Accessible name for the default editor. */
+    label?: string;
+    /** Popover position relative to the host. Default `'bottom-start'`. */
+    position?: MenuPosition;
+    /** Disable editing (boolean or a reactive getter). */
+    disabled?: boolean | (() => boolean);
+}
+export interface PopoverEditRef {
+    open(): void;
+    close(): void;
+    destroy(): void;
+}
+/** Attach inline popover editing to `host`. Returns a ref (also a cleanup contract for Weave). */
+export declare function popoverEdit(host: HTMLElement, config: PopoverEditConfig): PopoverEditRef;
+//# sourceMappingURL=popover-edit.d.ts.map

package/dist/popover-edit/popover-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-edit.d.ts","sourceRoot":"","sources":["../../src/popover-edit/popover-edit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3E,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,wDAAwD;IACxD,IAAI,EAAE,MAAM,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC;IAC1C,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAG,cAAc,CA4FxF"}