@weave-framework/ui 0.2.107

package/dist/cdk/positioning.js

@@ -0,0 +1,140 @@
+/**
+ * Connected positioning — the in-house "floating" engine (our @floating-ui / Material
+ * `FlexibleConnectedPositionStrategy`, zero-dep). Anchors an overlay panel to an origin
+ * element via a list of preferred connected positions, then:
+ *   • picks the first preferred position that fully fits the viewport,
+ *   • **flips** to a fallback when the preferred one overflows,
+ *   • **shifts** (clamps) along the axes to keep the panel on-screen if none fit,
+ *   • reports the position it actually applied (for arrow placement / transform-origin),
+ *   • repositions on scroll/resize while attached.
+ *
+ * Pure geometry against `getBoundingClientRect` + the viewport. RTL-aware: `start`/`end`
+ * resolve through `activeDirection()`. Plugs into the overlay as a `PositionStrategy`.
+ */
+import { signal } from '@weave-framework/runtime';
+import { activeDirection } from './bidi.js';
+import { isBrowser } from './platform.js';
+/** Map a preset to an explicit pairing, baking the `offset` onto the connection axis. */
+function presetToPosition(name, offset) {
+    switch (name) {
+        case 'bottom': return { originX: 'center', originY: 'bottom', overlayX: 'center', overlayY: 'top', offsetY: offset };
+        case 'bottom-start': return { originX: 'start', originY: 'bottom', overlayX: 'start', overlayY: 'top', offsetY: offset };
+        case 'bottom-end': return { originX: 'end', originY: 'bottom', overlayX: 'end', overlayY: 'top', offsetY: offset };
+        case 'top': return { originX: 'center', originY: 'top', overlayX: 'center', overlayY: 'bottom', offsetY: -offset };
+        case 'top-start': return { originX: 'start', originY: 'top', overlayX: 'start', overlayY: 'bottom', offsetY: -offset };
+        case 'top-end': return { originX: 'end', originY: 'top', overlayX: 'end', overlayY: 'bottom', offsetY: -offset };
+        case 'right': return { originX: 'end', originY: 'center', overlayX: 'start', overlayY: 'center', offsetX: offset };
+        case 'right-start': return { originX: 'end', originY: 'top', overlayX: 'start', overlayY: 'top', offsetX: offset };
+        case 'right-end': return { originX: 'end', originY: 'bottom', overlayX: 'start', overlayY: 'bottom', offsetX: offset };
+        case 'left': return { originX: 'start', originY: 'center', overlayX: 'end', overlayY: 'center', offsetX: -offset };
+        case 'left-start': return { originX: 'start', originY: 'top', overlayX: 'end', overlayY: 'top', offsetX: -offset };
+        case 'left-end': return { originX: 'start', originY: 'bottom', overlayX: 'end', overlayY: 'bottom', offsetX: -offset };
+    }
+}
+function resolve(pos, offset) {
+    return typeof pos === 'string' ? presetToPosition(pos, offset) : pos;
+}
+/** X coordinate of an origin anchor (RTL resolves start↔end to right↔left). */
+function originPointX(rect, x, rtl) {
+    if (x === 'center')
+        return rect.left + rect.width / 2;
+    const atStart = (x === 'start') !== rtl;
+    return atStart ? rect.left : rect.right;
+}
+function originPointY(rect, y) {
+    if (y === 'center')
+        return rect.top + rect.height / 2;
+    return y === 'top' ? rect.top : rect.bottom;
+}
+/** Fraction of the overlay width its anchor edge sits at (0 = left … 1 = right). */
+function overlayFracX(x, rtl) {
+    if (x === 'center')
+        return 0.5;
+    const atStart = (x === 'start') !== rtl;
+    return atStart ? 0 : 1;
+}
+function overlayFracY(y) {
+    return y === 'top' ? 0 : y === 'center' ? 0.5 : 1;
+}
+function clamp(v, lo, hi) {
+    return Math.min(Math.max(v, lo), Math.max(lo, hi));
+}
+/**
+ * Create a connected position strategy anchoring the overlay to `origin`. Pass it as
+ * `createOverlay({ positionStrategy })`, or call `apply(el)` directly on an attached
+ * element.
+ */
+export function connectedPosition(origin, options = {}) {
+    const offset = options.offset ?? 0;
+    const margin = options.viewportMargin ?? 8;
+    const autoUpdate = options.autoUpdate !== false;
+    const positions = (options.positions ?? ['bottom-start', 'top-start']).map((p) => resolve(p, offset));
+    const _applied = signal(null);
+    let currentEl = null;
+    let listening = false;
+    function place(el, pos, rtl, vw, vh) {
+        const rect = origin.getBoundingClientRect();
+        const w = el.offsetWidth;
+        const h = el.offsetHeight;
+        const left = originPointX(rect, pos.originX, rtl) - overlayFracX(pos.overlayX, rtl) * w + (pos.offsetX ?? 0);
+        const top = originPointY(rect, pos.originY) - overlayFracY(pos.overlayY) * h + (pos.offsetY ?? 0);
+        const overflow = Math.max(0, margin - left) +
+            Math.max(0, left + w - (vw - margin)) +
+            Math.max(0, margin - top) +
+            Math.max(0, top + h - (vh - margin));
+        return { left, top, overflow, pos };
+    }
+    function apply(el) {
+        currentEl = el;
+        const rtl = activeDirection() === 'rtl';
+        const vw = isBrowser ? window.innerWidth : 0;
+        const vh = isBrowser ? window.innerHeight : 0;
+        // First fully-fitting position wins; else the least-overflowing one, then shift.
+        let best = null;
+        for (const pos of positions) {
+            const p = place(el, pos, rtl, vw, vh);
+            if (p.overflow === 0) {
+                best = p;
+                break;
+            }
+            if (!best || p.overflow < best.overflow)
+                best = p;
+        }
+        if (!best)
+            return;
+        const w = el.offsetWidth;
+        const h = el.offsetHeight;
+        const left = clamp(best.left, margin, vw - margin - w);
+        const top = clamp(best.top, margin, vh - margin - h);
+        el.style.position = 'absolute';
+        el.style.left = `${Math.round(left)}px`;
+        el.style.top = `${Math.round(top)}px`;
+        el.style.right = '';
+        el.style.bottom = '';
+        el.style.transform = '';
+        _applied.set(best.pos);
+        if (autoUpdate && isBrowser && !listening) {
+            listening = true;
+            window.addEventListener('scroll', reposition, { passive: true, capture: true });
+            window.addEventListener('resize', reposition, { passive: true });
+        }
+    }
+    function reposition() {
+        if (currentEl && currentEl.isConnected)
+            apply(currentEl);
+    }
+    function dispose() {
+        if (listening && isBrowser) {
+            window.removeEventListener('scroll', reposition, { capture: true });
+            window.removeEventListener('resize', reposition);
+            listening = false;
+        }
+        currentEl = null;
+    }
+    return {
+        apply,
+        dispose,
+        appliedPosition: () => _applied(),
+    };
+}
+//# sourceMappingURL=positioning.js.map

package/dist/cdk/positioning.js.map

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

package/dist/cdk/scroll.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Scroll strategies — how an open overlay reacts when the page (or a scrollable
+ * ancestor) scrolls. Four behaviors, plus a shared scroll dispatcher so every
+ * overlay listens through **one** capture-phase window listener rather than N.
+ *
+ *   • `repositionScroll` — recompute the panel's position (anchored dropdowns).
+ *   • `closeScroll`      — detach the overlay (menus / tooltips).
+ *   • `blockScroll`      — lock body scroll while open (dialogs), no layout jump.
+ *   • `noopScroll`       — do nothing.
+ *
+ * Each is a factory `(ref) => ScrollStrategy`, so it drops straight into
+ * `createOverlay({ scrollStrategy })`. Zero-dep, signal-friendly. (Note: a
+ * `connectedPosition` with `autoUpdate` already repositions on scroll — use that OR
+ * `repositionScroll`, not both.)
+ */
+import type { OverlayRef } from './overlay.js';
+/** Enable/disable hook an overlay calls on attach/detach. */
+export interface ScrollStrategy {
+    enable(): void;
+    disable(): void;
+}
+/** A factory the overlay invokes with its own ref. */
+export type ScrollStrategyFactory = (ref: OverlayRef) => ScrollStrategy;
+type Handler = () => void;
+/**
+ * Subscribe to scrolls anywhere in the document (capture phase catches scrollable
+ * ancestors, not just `window`). Returns an unsubscribe. One shared listener backs
+ * all subscribers.
+ */
+export declare function onScroll(handler: Handler): () => void;
+/** Do nothing on scroll. */
+export declare function noopScroll(_ref?: OverlayRef): ScrollStrategy;
+/** Recompute the overlay's position on every scroll. */
+export declare function repositionScroll(ref: OverlayRef): ScrollStrategy;
+/** Detach the overlay on the first scroll (typical for menus / tooltips). */
+export declare function closeScroll(ref: OverlayRef): ScrollStrategy;
+/**
+ * Lock `<body>` scroll while the overlay is open, compensating for the scrollbar
+ * width so the page doesn't shift. Restores the exact prior inline styles on disable.
+ */
+export declare function blockScroll(_ref?: OverlayRef): ScrollStrategy;
+export {};
+//# sourceMappingURL=scroll.d.ts.map

package/dist/cdk/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/cdk/scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,cAAc,CAAC;AAIxE,KAAK,OAAO,GAAG,MAAM,IAAI,CAAC;AAQ1B;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,IAAI,CASrD;AAID,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,cAAc,CAE5D;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAWhE;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAW3D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,cAAc,CAoB7D"}

package/dist/cdk/scroll.js

@@ -0,0 +1,97 @@
+/**
+ * Scroll strategies — how an open overlay reacts when the page (or a scrollable
+ * ancestor) scrolls. Four behaviors, plus a shared scroll dispatcher so every
+ * overlay listens through **one** capture-phase window listener rather than N.
+ *
+ *   • `repositionScroll` — recompute the panel's position (anchored dropdowns).
+ *   • `closeScroll`      — detach the overlay (menus / tooltips).
+ *   • `blockScroll`      — lock body scroll while open (dialogs), no layout jump.
+ *   • `noopScroll`       — do nothing.
+ *
+ * Each is a factory `(ref) => ScrollStrategy`, so it drops straight into
+ * `createOverlay({ scrollStrategy })`. Zero-dep, signal-friendly. (Note: a
+ * `connectedPosition` with `autoUpdate` already repositions on scroll — use that OR
+ * `repositionScroll`, not both.)
+ */
+import { isBrowser } from './platform.js';
+const handlers = new Set();
+let installed = false;
+function fanout() {
+    for (const h of [...handlers])
+        h();
+}
+/**
+ * Subscribe to scrolls anywhere in the document (capture phase catches scrollable
+ * ancestors, not just `window`). Returns an unsubscribe. One shared listener backs
+ * all subscribers.
+ */
+export function onScroll(handler) {
+    if (!installed && isBrowser) {
+        window.addEventListener('scroll', fanout, { capture: true, passive: true });
+        installed = true;
+    }
+    handlers.add(handler);
+    return () => {
+        handlers.delete(handler);
+    };
+}
+/* ─────────────────────── strategies ─────────────────────── */
+/** Do nothing on scroll. */
+export function noopScroll(_ref) {
+    return { enable: () => { }, disable: () => { } };
+}
+/** Recompute the overlay's position on every scroll. */
+export function repositionScroll(ref) {
+    let off = null;
+    return {
+        enable: () => {
+            off ??= onScroll(() => ref.updatePosition());
+        },
+        disable: () => {
+            off?.();
+            off = null;
+        },
+    };
+}
+/** Detach the overlay on the first scroll (typical for menus / tooltips). */
+export function closeScroll(ref) {
+    let off = null;
+    return {
+        enable: () => {
+            off ??= onScroll(() => ref.detach());
+        },
+        disable: () => {
+            off?.();
+            off = null;
+        },
+    };
+}
+/**
+ * Lock `<body>` scroll while the overlay is open, compensating for the scrollbar
+ * width so the page doesn't shift. Restores the exact prior inline styles on disable.
+ */
+export function blockScroll(_ref) {
+    let prev = null;
+    return {
+        enable: () => {
+            if (!isBrowser || prev)
+                return;
+            const scrollbar = window.innerWidth - document.documentElement.clientWidth;
+            prev = {
+                overflow: document.body.style.overflow,
+                paddingRight: document.body.style.paddingRight,
+            };
+            document.body.style.overflow = 'hidden';
+            if (scrollbar > 0)
+                document.body.style.paddingRight = `${scrollbar}px`;
+        },
+        disable: () => {
+            if (!prev)
+                return;
+            document.body.style.overflow = prev.overflow;
+            document.body.style.paddingRight = prev.paddingRight;
+            prev = null;
+        },
+    };
+}
+//# sourceMappingURL=scroll.js.map

package/dist/cdk/scroll.js.map

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

package/dist/cdk/selection-model.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SelectionModel — the signal-native selection engine under Table rows, Tree nodes and
+ * List/Select multi-select. Tracks a set of selected values (insertion-ordered) with
+ * `select`/`deselect`/`toggle`/`clear`, `single` vs `multiple` modes, an optional identity
+ * comparator (so object copies match by key), and a `changed` callback carrying the
+ * added/removed delta. Headless: no DOM, no ARIA — a component maps `selected()` /
+ * `isSelected()` onto `aria-selected`/checkboxes itself. Zero-dep.
+ */
+/** The delta emitted after a selection change. */
+export interface SelectionChange<T> {
+    /** Values added to the selection by this change. */
+    added: T[];
+    /** Values removed from the selection by this change. */
+    removed: T[];
+}
+export interface SelectionModelOptions<T> {
+    /** Allow more than one selected value. Default false (single-select). */
+    multiple?: boolean;
+    /** Values selected up-front (deduped, and truncated to one in single mode). */
+    initial?: T[];
+    /** Identity comparator (default `===`) — lets distinct object copies match by key. */
+    compareWith?: (a: T, b: T) => boolean;
+    /** Called after every actual change with the added/removed delta. */
+    onChange?: (change: SelectionChange<T>) => void;
+}
+export interface SelectionModel<T> {
+    /** The selected values, insertion-ordered. Reactive (stable ref until it changes). */
+    selected(): T[];
+    /** Whether nothing is selected. Reactive. */
+    isEmpty(): boolean;
+    /** How many values are selected. Reactive. */
+    count(): number;
+    /** Whether `value` is currently selected. Reactive. */
+    isSelected(value: T): boolean;
+    /** Add value(s) to the selection (single mode keeps only the last given). */
+    select(...values: T[]): void;
+    /** Remove value(s) from the selection. */
+    deselect(...values: T[]): void;
+    /** Flip a single value's selected state. */
+    toggle(value: T): void;
+    /** Replace the whole selection with exactly these value(s). */
+    setSelection(...values: T[]): void;
+    /** Clear the selection. */
+    clear(): void;
+    /** True when this model allows multiple selected values. */
+    readonly multiple: boolean;
+}
+/** Create a selection model. */
+export declare function selectionModel<T>(options?: SelectionModelOptions<T>): SelectionModel<T>;
+//# sourceMappingURL=selection-model.d.ts.map

package/dist/cdk/selection-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-model.d.ts","sourceRoot":"","sources":["../../src/cdk/selection-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,kDAAkD;AAClD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,oDAAoD;IACpD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,wDAAwD;IACxD,OAAO,EAAE,CAAC,EAAE,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,IAAI,CAAC,EAAE,CAAC;IAChB,6CAA6C;IAC7C,OAAO,IAAI,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,IAAI,MAAM,CAAC;IAChB,uDAAuD;IACvD,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC/B,4CAA4C;IAC5C,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,+DAA+D;IAC/D,YAAY,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,gCAAgC;AAChC,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAE,qBAAqB,CAAC,CAAC,CAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAiE3F"}

package/dist/cdk/selection-model.js

@@ -0,0 +1,77 @@
+/**
+ * SelectionModel — the signal-native selection engine under Table rows, Tree nodes and
+ * List/Select multi-select. Tracks a set of selected values (insertion-ordered) with
+ * `select`/`deselect`/`toggle`/`clear`, `single` vs `multiple` modes, an optional identity
+ * comparator (so object copies match by key), and a `changed` callback carrying the
+ * added/removed delta. Headless: no DOM, no ARIA — a component maps `selected()` /
+ * `isSelected()` onto `aria-selected`/checkboxes itself. Zero-dep.
+ */
+import { signal } from '@weave-framework/runtime';
+/** Create a selection model. */
+export function selectionModel(options = {}) {
+    const multiple = options.multiple ?? false;
+    const compareWith = options.compareWith ?? ((a, b) => a === b);
+    const onChange = options.onChange;
+    const has = (arr, v) => arr.some((x) => compareWith(x, v));
+    /** Dedupe with the comparator, preserving first-seen order. */
+    const dedupe = (arr) => {
+        const out = [];
+        for (const v of arr)
+            if (!has(out, v))
+                out.push(v);
+        return out;
+    };
+    const seedAll = dedupe(options.initial ?? []);
+    const seed = multiple ? seedAll : seedAll.slice(-1);
+    const _selected = signal(seed);
+    /** Commit `next` if it differs from the current set, emitting the delta. */
+    const commit = (next) => {
+        const cur = _selected();
+        const added = next.filter((v) => !has(cur, v));
+        const removed = cur.filter((v) => !has(next, v));
+        if (added.length === 0 && removed.length === 0)
+            return;
+        _selected.set(next);
+        onChange?.({ added, removed });
+    };
+    return {
+        multiple,
+        selected: () => _selected(),
+        isEmpty: () => _selected().length === 0,
+        count: () => _selected().length,
+        isSelected: (value) => has(_selected(), value),
+        select: (...values) => {
+            const add = dedupe(values);
+            if (add.length === 0)
+                return;
+            if (multiple) {
+                const cur = _selected();
+                commit([...cur, ...add.filter((v) => !has(cur, v))]);
+            }
+            else {
+                commit([add[add.length - 1]]);
+            }
+        },
+        deselect: (...values) => {
+            if (values.length === 0)
+                return;
+            const cur = _selected();
+            commit(cur.filter((x) => !has(values, x)));
+        },
+        toggle: (value) => {
+            const cur = _selected();
+            if (has(cur, value))
+                commit(cur.filter((x) => !compareWith(x, value)));
+            else if (multiple)
+                commit([...cur, value]);
+            else
+                commit([value]);
+        },
+        setSelection: (...values) => {
+            const next = dedupe(values);
+            commit(multiple ? next : next.slice(-1));
+        },
+        clear: () => commit([]),
+    };
+}
+//# sourceMappingURL=selection-model.js.map

package/dist/cdk/selection-model.js.map

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

package/dist/cdk/virtual-scroll.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Virtual Scroll — the headless rendered-window engine under large Table/Tree bodies and
+ * long lists. Given a scroll viewport + a fixed row height + a total count, it computes the
+ * slice of items to actually render (a buffered window around the visible range) plus the
+ * top/bottom spacer sizes that keep the scrollbar honest — all as signals. The consumer
+ * renders only `items.slice(renderedRange().start, renderedRange().end)`, pads the top with
+ * `scrollOffset()` px and the bottom with `endOffset()` px, and the native scrollbar behaves
+ * as if the whole list were present.
+ *
+ * Fixed-size strategy first (`itemSize`); an autosize/variable-height strategy is a follow-on.
+ * Built on the U1 `onScroll` dispatcher + `resizeSignal` (viewport height). Zero styling, zero-dep.
+ *
+ *   const vs = virtualScroll({ itemSize: 32, total: () => rows().length, viewport: () => elRef() });
+ *   effect(() => { const { start, end } = vs.renderedRange(); render(rows().slice(start, end)); });
+ *   // spacer top = vs.scrollOffset(), spacer bottom = vs.endOffset(), scroller height = vs.totalSize()
+ */
+/** The rendered item index range, `[start, end)` (end exclusive). */
+export interface RenderedRange {
+    start: number;
+    end: number;
+}
+export interface VirtualScrollOptions {
+    /** Fixed row height in px (the fixed-size strategy). */
+    itemSize: number;
+    /** Total number of items — a number, or a getter for a reactive count. */
+    total: number | (() => number);
+    /** The scroll viewport element, or a getter (so a ref set after render is picked up). */
+    viewport: HTMLElement | (() => HTMLElement | null);
+    /** Rows rendered above + below the visible window (overscan). Default 4. */
+    buffer?: number;
+}
+export interface VirtualScroller {
+    /** The item index range to render, `[start, end)`. Reactive; only changes when the window does. */
+    renderedRange(): RenderedRange;
+    /** Top spacer height in px — the offset of the first rendered item. Reactive. */
+    scrollOffset(): number;
+    /** Bottom spacer height in px — space below the last rendered item. Reactive. */
+    endOffset(): number;
+    /** Total scrollable height in px (`itemSize * total`). Reactive. */
+    totalSize(): number;
+    /** Scroll the viewport so `index` sits at the top (clamped to range). */
+    scrollToIndex(index: number): void;
+    /** Force a resync of scroll position + viewport height (after a manual layout change). */
+    measure(): void;
+    /** Tear down listeners (also runs automatically on owner disposal). */
+    destroy(): void;
+}
+/** Create a virtual-scroll engine over a fixed-height list. */
+export declare function virtualScroll(options: VirtualScrollOptions): VirtualScroller;
+//# sourceMappingURL=virtual-scroll.d.ts.map

package/dist/cdk/virtual-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-scroll.d.ts","sourceRoot":"","sources":["../../src/cdk/virtual-scroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,yFAAyF;IACzF,QAAQ,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC;IACnD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,mGAAmG;IACnG,aAAa,IAAI,aAAa,CAAC;IAC/B,iFAAiF;IACjF,YAAY,IAAI,MAAM,CAAC;IACvB,iFAAiF;IACjF,SAAS,IAAI,MAAM,CAAC;IACpB,oEAAoE;IACpE,SAAS,IAAI,MAAM,CAAC;IACpB,yEAAyE;IACzE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,0FAA0F;IAC1F,OAAO,IAAI,IAAI,CAAC;IAChB,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CA+E5E"}

package/dist/cdk/virtual-scroll.js

@@ -0,0 +1,92 @@
+/**
+ * Virtual Scroll — the headless rendered-window engine under large Table/Tree bodies and
+ * long lists. Given a scroll viewport + a fixed row height + a total count, it computes the
+ * slice of items to actually render (a buffered window around the visible range) plus the
+ * top/bottom spacer sizes that keep the scrollbar honest — all as signals. The consumer
+ * renders only `items.slice(renderedRange().start, renderedRange().end)`, pads the top with
+ * `scrollOffset()` px and the bottom with `endOffset()` px, and the native scrollbar behaves
+ * as if the whole list were present.
+ *
+ * Fixed-size strategy first (`itemSize`); an autosize/variable-height strategy is a follow-on.
+ * Built on the U1 `onScroll` dispatcher + `resizeSignal` (viewport height). Zero styling, zero-dep.
+ *
+ *   const vs = virtualScroll({ itemSize: 32, total: () => rows().length, viewport: () => elRef() });
+ *   effect(() => { const { start, end } = vs.renderedRange(); render(rows().slice(start, end)); });
+ *   // spacer top = vs.scrollOffset(), spacer bottom = vs.endOffset(), scroller height = vs.totalSize()
+ */
+import { signal, computed, effect, onDispose } from '@weave-framework/runtime';
+import { onScroll } from './scroll.js';
+import { resizeSignal } from './observers.js';
+/** Create a virtual-scroll engine over a fixed-height list. */
+export function virtualScroll(options) {
+    const itemSize = options.itemSize;
+    const buffer = options.buffer ?? 4;
+    const totalFn = typeof options.total === 'function' ? options.total : () => options.total;
+    const getViewport = typeof options.viewport === 'function' ? options.viewport : () => options.viewport;
+    const scrollTop = signal(0);
+    // Bumped when the viewport attaches, so `viewportHeight` re-pulls the (lazy) resize signal
+    // into the reactive graph.
+    const ready = signal(0);
+    let el = null;
+    let size = null;
+    let unsub = null;
+    const attach = (v) => {
+        el = v;
+        scrollTop.set(v.scrollTop);
+        size = resizeSignal(v); // seeds from getBoundingClientRect, then ResizeObserver-driven
+        unsub = onScroll(() => {
+            if (el)
+                scrollTop.set(el.scrollTop);
+        });
+        ready.set(ready.peek() + 1);
+    };
+    // Attach once, as soon as the viewport element is available (a ref may set it post-render).
+    effect(() => {
+        const v = getViewport();
+        if (v && !el)
+            attach(v);
+    });
+    const viewportHeight = () => {
+        ready();
+        return size ? size().height : 0;
+    };
+    const renderedRange = computed(() => {
+        const n = Math.max(0, totalFn());
+        if (n === 0)
+            return { start: 0, end: 0 };
+        const first = Math.max(0, Math.floor(scrollTop() / itemSize));
+        const visible = Math.max(1, Math.ceil(viewportHeight() / itemSize));
+        const start = Math.max(0, first - buffer);
+        const end = Math.min(n, first + visible + buffer);
+        return { start, end };
+    }, { equals: (a, b) => !!a && !!b && a.start === b.start && a.end === b.end });
+    const totalSize = () => Math.max(0, totalFn()) * itemSize;
+    const scrollOffset = () => renderedRange().start * itemSize;
+    const endOffset = () => totalSize() - renderedRange().end * itemSize;
+    const destroy = () => {
+        unsub?.();
+        unsub = null;
+    };
+    onDispose(destroy);
+    return {
+        renderedRange: () => renderedRange(),
+        scrollOffset,
+        endOffset,
+        totalSize,
+        scrollToIndex: (index) => {
+            const n = Math.max(0, totalFn());
+            const clamped = Math.max(0, Math.min(index, n - 1));
+            if (el) {
+                el.scrollTop = clamped * itemSize;
+                scrollTop.set(el.scrollTop);
+            }
+        },
+        measure: () => {
+            if (el)
+                scrollTop.set(el.scrollTop);
+            ready.set(ready.peek() + 1);
+        },
+        destroy,
+    };
+}
+//# sourceMappingURL=virtual-scroll.js.map

package/dist/cdk/virtual-scroll.js.map

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