@vielzeug/scroll 2.3.0 → 26.10.0

package/README.md

@@ -1,52 +1,6 @@
 # @vielzeug/scroll
 
-> Lightweight, framework-agnostic virtual list engine with variable heights, sticky headers, grid support, and optional reactive integration.
-
-[![npm version](https://img.shields.io/npm/v/@vielzeug/scroll)](https://www.npmjs.com/package/@vielzeug/scroll) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-<details>
-<summary>Quick Reference</summary>
-
-**Package:** `@vielzeug/scroll` &nbsp;·&nbsp; **Category:** UI Performance
-
-**Key exports:** `createVirtualizer`, `createDomVirtualList`, `createVirtualScroller`, `createGroupedVirtualizer`, `createGridVirtualizer`
-
-**When to use:** Render only visible rows in large lists. Supports fixed heights, variable heights, sticky headers, grouped sections, grid virtualization, programmatic scrolling, and optional reactive signal integration.
-
-**Related:** [@vielzeug/dnd](https://vielzeug.dev/dnd/) · [@vielzeug/ore](https://vielzeug.dev/ore/) · [@vielzeug/refine](https://vielzeug.dev/refine/)
-
-</details>
-
-`@vielzeug/scroll` is part of Vielzeug and ships as a TypeScript package with ESM+CJS output. The only dependency is `@vielzeug/ripple`, used by the optional reactive signal integration.
-
-## Choosing a Factory
-
-Each factory serves a specific use case. Pick the one that matches your needs:
-
-| Factory | Use Case | Benefits | Trade-offs |
-|---------|----------|----------|-----------|
-| **`createVirtualizer`** | Low-level scroll optimization with manual DOM | Full control, minimal overhead | You manage layout and DOM updates |
-| **`createDomVirtualList`** | Rendering a data-bound list with automatic cleanup | Auto height management, item recycling, stick-to-bottom | Less control over container |
-| **`createVirtualScroller`** | Quick setup: auto-creates scroll + list containers | Minimal setup, self-contained | Less flexibility over structure |
-| **`createGroupedVirtualizer`** | Lists with grouped sections and sticky headers | Automatic sticky headers, section navigation | Not suitable for flat lists |
-| **`createGridVirtualizer`** | 2D grids (spreadsheets, photo galleries) | Row + column virtualization, automatic cell layout | More complex to render |
-
-### Quick Decision Tree
-
-```
-Do you need a 2D grid (rows AND columns)?
-├─ YES → createGridVirtualizer
-└─ NO
-   Do your items have sections with headers?
-   ├─ YES → createGroupedVirtualizer
-   └─ NO
-      Do you want scroll + list containers auto-created?
-      ├─ YES → createVirtualScroller
-      └─ NO
-         Do you have data items that need recycling?
-         ├─ YES → createDomVirtualList
-         └─ NO → createVirtualizer (full control)
-```
+> Virtual list engine for large datasets
 
 ## Installation
 
@@ -84,285 +38,13 @@ const virt = createVirtualizer(scrollEl, {
 virt.dispose();
 ```
 
-## DOM Adapter
-
-`createDomVirtualList` manages the virtualizer lifecycle and handles list-height styles automatically. Items are passed as enriched `VirtualRenderItem<T>` objects (layout fields + `.data`). Use `recycle` for efficient DOM node reuse.
-
-```ts
-import { createDomVirtualList } from '@vielzeug/scroll';
-
-type Option = { label: string; value: string };
-
-const dropdownEl = document.querySelector<HTMLElement>('.dropdown')!;
-const listEl = document.querySelector<HTMLElement>('.list')!;
-const options: Option[] = [{ label: 'Ada Lovelace', value: 'ada' }];
-const focusedIndex = 0;
-
-const domList = createDomVirtualList<Option>({
-  estimateSize: 36,
-  getItemKey: (_, opt) => opt.value,
-  listElement: listEl,
-  scrollElement: dropdownEl,
-  render: ({ items, listEl, recycle }) => {
-    for (const item of items) {
-      const el = recycle(item.data.value, () => document.createElement('div'));
-      el.style.cssText = `position:absolute;top:0;left:0;right:0;transform:translateY(${item.start}px);height:${item.size}px;`;
-      el.textContent = item.data.label;
-      listEl.appendChild(el);
-    }
-  },
-});
-
-domList.setItems(options);
-domList.scrollToIndex(focusedIndex, { align: 'auto' });
-domList.dispose();
-```
-
-## Self-Contained Scroller
-
-`createVirtualScroller` creates the scroll container and list element for you and appends them to a host element:
-
-```ts
-import { createVirtualScroller } from '@vielzeug/scroll';
-
-type Option = { label: string; value: string };
-
-const options: Option[] = [{ label: 'Ada Lovelace', value: 'ada' }];
-const list = createVirtualScroller<Option>(document.getElementById('root')!, {
-  estimateSize: 36,
-  render: ({ items, listEl, recycle }) => {
-    for (const item of items) {
-      const el = recycle(item.data.value, () => document.createElement('div'));
-      el.textContent = item.data.label;
-      el.style.cssText = `position:absolute;top:0;left:0;right:0;transform:translateY(${item.start}px);`;
-      listEl.appendChild(el);
-    }
-  },
-});
-
-list.setItems(options);
-list.dispose(); // also removes the generated scroll container
-```
-
-## Grouped Lists
-
-`createGroupedVirtualizer` handles sectioned data with sticky headers automatically:
-
-```ts
-import { createGroupedVirtualizer } from '@vielzeug/scroll';
-
-type Contact = { id: number; name: string };
-
-const virt = createGroupedVirtualizer<Contact>(scrollEl, {
-  estimateHeaderSize: 32,
-  estimateItemSize: 48,
-  sections: [
-    { label: 'A', items: [{ id: 1, name: 'Alice' }] },
-    { label: 'B', items: [{ id: 2, name: 'Bob' }] },
-  ],
-  onChange: ({ headers, items, stickyHeader, totalSize }) => {
-    // render headers and items from a flat offset table
-  },
-});
-
-virt.scrollToSection(1, { align: 'start' });
-virt.update(nextSections);
-virt.dispose();
-```
-
-## Grid Virtualization
-
-```ts
-import { createGridVirtualizer } from '@vielzeug/scroll';
-
-const grid = createGridVirtualizer(scrollEl, {
-  rowCount: 10_000,
-  colCount: 50,
-  estimateRowSize: 36,
-  estimateColSize: 120,
-  onChange: ({ rows, cols, totalHeight, totalWidth }) => {
-    // form the cross-product rows × cols and render each visible cell
-  },
-});
-
-grid.scrollToCell(500, 10, { rowAlign: 'center', colAlign: 'start' });
-grid.dispose();
-```
-
-## Measurement Methods
-
-Items can have variable heights. Measure them once, and the offset table updates automatically.
-
-### `measure(index, size)`
-Measure a single item. Use when one item's size changes (e.g., image loaded).
-```ts
-virt.measure(42, 120);  // Item 42 is now 120px tall
-```
-
-### `measureBatch(entries)`
-Measure multiple items in one operation. Coalesces updates into a single rebuild.
-```ts
-virt.measureBatch([
-  { index: 10, size: 150 },
-  { index: 11, size: 140 },
-  { index: 12, size: 160 },
-]);
-```
-
-### `measureEl(index, el)`
-Auto-observe an element's size with `ResizeObserver`. Useful for dynamic content (videos, expanding text).
-```ts
-const disconnect = virt.measureEl(42, videoElement);
-// Later:
-disconnect();  // Stop observing
-```
-
-## Migration Guide
-
-### Switching from `createVirtualizer` to `createDomVirtualList`
-
-If you're manually managing a list and want item recycling + auto-height:
-
-```ts
-// Before:
-const virt = createVirtualizer(scrollEl, {
-  count: items.length,
-  onChange: ({ items: renderItems, totalSize }) => {
-    listEl.style.height = `${totalSize}px`;
-    // manual DOM updates
-  },
-});
-
-// After:
-const virt = createDomVirtualList({
-  items,
-  scrollElement: scrollEl,
-  listElement: listEl,
-  render: ({ items: renderItems, recycle }) => {
-    // recycled DOM updates
-  },
-});
-virt.setItems(newItems);  // Auto-rebuilds
-```
-
-### Switching from flat list to grouped
-
-When your data gains structure (sections with headers):
-
-```ts
-// Before:
-const virt = createVirtualizer(scrollEl, { count: items.length });
-
-// After:
-const virt = createGroupedVirtualizer(scrollEl, {
-  sections: [
-    { label: 'Section A', items: itemsA },
-    { label: 'Section B', items: itemsB },
-  ],
-});
-```
-
-Changes needed in your render function:
-- Receive `headers` array in addition to `items`
-- Render headers with `.start`, `.size`, `.label`
-- Render items with `.data` field containing the item
-
-## Keyboard Navigation
-
-Enable keyboard-based scrolling with the `keyboardScroll` option:
-
-```ts
-const virt = createVirtualizer(scrollEl, {
-  count: 1000,
-  estimateSize: 40,
-  keyboardScroll: true,
-});
-```
-
-Supported keys:
-- **Arrow Up/Down** (or Left/Right for horizontal lists) — Scroll by one estimated item size
-- **Page Up/Down** — Scroll by ~80% of viewport height (configurable with Page Down/Up key modifiers)
-- **Home** — Jump to the start
-- **End** — Jump to the end
-
-**Requirements:**
-- The scroll container (or a descendant) must have focus for keyboard events to fire
-- Works with all factories: `createVirtualizer`, `createDomVirtualList`, `createGroupedVirtualizer`, `createGridVirtualizer`
-- Grid virtualization supports separate row/column scrolling (arrows navigate rows or columns independently)
-
-## Auto-Measurement
-
-For dynamic or user-generated content with variable sizes, enable `autoMeasure` to automatically measure visible items:
-
-```ts
-const virt = createVirtualizer(scrollEl, {
-  count: 1000,
-  estimateSize: 40,
-  autoMeasure: true,
-});
-```
-
-**How it works:**
-- Each rendered item is automatically measured via `ResizeObserver`
-- Measurements are cached and the virtualizer recomputes layout in real time
-- Useful for content that grows/shrinks (expanding text, loading spinners, videos)
-
-**Requirements:**
-- Every rendered item must have a `data-vz-key` attribute set to the item's key:
-  ```ts
-  const virt = createVirtualizer(scrollEl, {
-    count: items.length,
-    getItemKey: (i) => items[i].id,
-    onChange: ({ items: renderItems, totalSize }) => {
-      listEl.style.height = `${totalSize}px`;
-      for (const item of renderItems) {
-        const el = document.createElement('div');
-        el.setAttribute('data-vz-key', items[item.index].id);  // <-- Required
-        el.textContent = items[item.index].text;
-        listEl.appendChild(el);
-      }
-    },
-  });
-  ```
-- Must use a DOM scroll target (not `Window`)
-- For more control, use `measureEl()` manually instead
-
-**Caveats:**
-- `autoMeasure` queries the DOM every render cycle; avoid with very large visible windows (100+ items)
-- Elements are looked up in the scroll target; ensure elements are direct/indirect children
-- ResizeObserver cleanup is automatic on `dispose()`
-
-## Reactive Integration
-
-Any virtualizer can emit state to a reactive `Signal` from `@vielzeug/ripple` by providing a `toSignal` option:
-
-```ts
-import { createVirtualizer } from '@vielzeug/scroll';
-import { signal, effect } from '@vielzeug/ripple';
-
-const virt = createVirtualizer(scrollEl, {
-  count: 1000,
-  estimateSize: 40,
-  toSignal: (init) => signal(init),  // Create and emit to a signal
-});
-
-effect(() => {
-  const { items, totalSize } = virt.state.value;
-  listEl.style.height = `${totalSize}px`;
-  // render items...
-});
-
-virt.dispose();
-```
-
-The `toSignal` option works with all factories (`createDomVirtualList`, `createGroupedVirtualizer`, `createGridVirtualizer`, etc.) and works alongside the `onChange` callback if provided.
-
 ## Documentation
 
 - [Overview](https://vielzeug.dev/scroll/)
 - [Usage Guide](https://vielzeug.dev/scroll/usage)
 - [API Reference](https://vielzeug.dev/scroll/api)
 - [Examples](https://vielzeug.dev/scroll/examples)
+- [Migration Guide](https://vielzeug.dev/scroll/migration)
 
 ## License
 

package/dist/_utils.cjs

@@ -1,2 +1,2 @@
-require("./_dev.cjs");function e(){return new Map}var t=36,n=3;function r(e,t=0){return Number.isFinite(e)?Math.max(0,Math.floor(e)):t}function i(e,t){return!Number.isFinite(e)||e<=0||e>1e7?t:e}function a(e){return typeof Window<`u`&&e instanceof Window||typeof e.innerHeight==`number`&&typeof e.document==`object`}function o(e,t){if(typeof e==`number`){let n=r(e,t);return{end:n,start:n}}return{end:r(e?.end??t),start:r(e?.start??t)}}function s(e,t,n){let r=new ResizeObserver(e=>{for(let t of e)n(t)});return r.observe(t),e.addEventListener(`abort`,()=>r.disconnect(),{once:!0}),()=>r.disconnect()}function c(e,t){if(typeof e==`function`)return n=>{try{return i(e(n),t)}catch(e){return`${n}${e}`,t}};let n=typeof e==`number`?i(e,t):t;return()=>n}exports.DEFAULT_ESTIMATE_SIZE=t,exports.DEFAULT_OVERSCAN=n,exports.createMeasurementCache=e,exports.isWindowTarget=a,exports.normalizeOverscan=o,exports.observeResize=s,exports.resolveEstimateFn=c,exports.toNonNegativeInt=r,exports.toPositiveNumber=i;
+require("./_dev.cjs");function e(){return new Map}var t=36,n=3;function r(e){let t=new Set,n=e,r=!1;return{dispose(){r=!0,t.clear()},getSnapshot(){return n},publish(e){if(!r){n=e;for(let e of[...t])try{e()}catch(e){queueMicrotask(()=>{throw e})}}},subscribe(e){return r?()=>{}:(t.add(e),()=>t.delete(e))}}}function i(e,t=0){return Number.isFinite(e)?Math.max(0,Math.floor(e)):t}function a(e,t){return!Number.isFinite(e)||e<=0||e>1e7?t:e}function o(e){return typeof Window<`u`&&e instanceof Window||typeof e.innerHeight==`number`&&typeof e.document==`object`}function s(e,t){if(typeof e==`number`){let n=i(e,t);return{end:n,start:n}}return{end:i(e?.end??t),start:i(e?.start??t)}}function c(e,t,n){let r=new ResizeObserver(e=>{for(let t of e)n(t)});return r.observe(t),e.addEventListener(`abort`,()=>r.disconnect(),{once:!0}),()=>r.disconnect()}function l(e,t){if(typeof e==`function`)return n=>{try{return a(e(n),t)}catch(e){return`${n}${e}`,t}};let n=typeof e==`number`?a(e,t):t;return()=>n}exports.DEFAULT_ESTIMATE_SIZE=t,exports.DEFAULT_OVERSCAN=n,exports.createMeasurementCache=e,exports.createSnapshotStore=r,exports.isWindowTarget=o,exports.normalizeOverscan=s,exports.observeResize=c,exports.resolveEstimateFn=l,exports.toNonNegativeInt=i,exports.toPositiveNumber=a;
 //# sourceMappingURL=_utils.cjs.map

package/dist/_utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_utils.cjs","names":[],"sources":["../src/_utils.ts"],"sourcesContent":["import { warn } from './_dev';\n\nexport type ScrollTarget = HTMLElement | Window;\n\nexport type VirtualKey = number | string;\n\n/** Shared measurement cache. Pass the same instance to multiple virtualizers\n *  for scroll restoration or SSR pre-measurement. */\nexport type MeasurementCache = Map<VirtualKey, number>;\n\n/** Create a new, empty measurement cache. */\nexport function createMeasurementCache(): MeasurementCache {\n  return new Map();\n}\n\nexport type Overscan = number | { end?: number; start?: number };\n\nexport const DEFAULT_ESTIMATE_SIZE = 36;\nexport const DEFAULT_OVERSCAN = 3;\n\n// ─── Numeric helpers ───────────────────────────────────────────────────────────\n\nexport function toNonNegativeInt(value: number, fallback = 0): number {\n  if (!Number.isFinite(value)) return fallback;\n\n  return Math.max(0, Math.floor(value));\n}\n\nexport function toPositiveNumber(value: number, fallback: number): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) return fallback;\n\n  return value;\n}\n\nexport function isWindowTarget(target: ScrollTarget): target is Window {\n  return (\n    (typeof Window !== 'undefined' && target instanceof Window) ||\n    (typeof (target as Window).innerHeight === 'number' && typeof (target as Window).document === 'object')\n  );\n}\n\nexport function normalizeOverscan(overscan: Overscan | undefined, defaultVal: number): { end: number; start: number } {\n  if (typeof overscan === 'number') {\n    const n = toNonNegativeInt(overscan, defaultVal);\n\n    return { end: n, start: n };\n  }\n\n  return {\n    end: toNonNegativeInt(overscan?.end ?? defaultVal),\n    start: toNonNegativeInt(overscan?.start ?? defaultVal),\n  };\n}\n\n/**\n * Create a `ResizeObserver` that reports size changes on `el` via `onSize`, tied to\n * `signal` so it is disconnected automatically when the owning factory disposes —\n * even if the caller never calls the returned disconnect function.\n */\nexport function observeResize(\n  signal: AbortSignal,\n  el: HTMLElement,\n  onSize: (entry: ResizeObserverEntry) => void,\n): () => void {\n  const ro = new ResizeObserver((entries) => {\n    for (const entry of entries) onSize(entry);\n  });\n\n  ro.observe(el);\n  signal.addEventListener('abort', () => ro.disconnect(), { once: true });\n\n  return () => ro.disconnect();\n}\n\nexport function resolveEstimateFn(\n  estimate: number | ((index: number) => number) | undefined,\n  defaultSize: number,\n): (index: number) => number {\n  if (typeof estimate === 'function') {\n    return (index: number) => {\n      try {\n        return toPositiveNumber(estimate(index), defaultSize);\n      } catch (err) {\n        warn(`estimateSize threw for index ${index}: ${err}`);\n\n        return defaultSize;\n      }\n    };\n  }\n\n  const size = typeof estimate === 'number' ? toPositiveNumber(estimate, defaultSize) : defaultSize;\n\n  return () => size;\n}\n"],"mappings":"sBAWA,SAAgB,GAA2C,CACzD,OAAO,IAAI,GACb,CAIA,IAAa,EAAwB,GACxB,EAAmB,EAIhC,SAAgB,EAAiB,EAAe,EAAW,EAAW,CAGpE,OAFK,OAAO,SAAS,CAAK,EAEnB,KAAK,IAAI,EAAG,KAAK,MAAM,CAAK,CAAC,EAFA,CAGtC,CAEA,SAAgB,EAAiB,EAAe,EAA0B,CAGxE,MAFI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IAAY,EAE1D,CACT,CAEA,SAAgB,EAAe,EAAwC,CACrE,OACG,OAAO,OAAW,KAAe,aAAkB,QACnD,OAAQ,EAAkB,aAAgB,UAAY,OAAQ,EAAkB,UAAa,QAElG,CAEA,SAAgB,EAAkB,EAAgC,EAAoD,CACpH,GAAI,OAAO,GAAa,SAAU,CAChC,IAAM,EAAI,EAAiB,EAAU,CAAU,EAE/C,MAAO,CAAE,IAAK,EAAG,MAAO,CAAE,CAC5B,CAEA,MAAO,CACL,IAAK,EAAiB,GAAU,KAAO,CAAU,EACjD,MAAO,EAAiB,GAAU,OAAS,CAAU,CACvD,CACF,CAOA,SAAgB,EACd,EACA,EACA,EACY,CACZ,IAAM,EAAK,IAAI,eAAgB,GAAY,CACzC,IAAK,IAAM,KAAS,EAAS,EAAO,CAAK,CAC3C,CAAC,EAKD,OAHA,EAAG,QAAQ,CAAE,EACb,EAAO,iBAAiB,YAAe,EAAG,WAAW,EAAG,CAAE,KAAM,EAAK,CAAC,MAEzD,EAAG,WAAW,CAC7B,CAEA,SAAgB,EACd,EACA,EAC2B,CAC3B,GAAI,OAAO,GAAa,WACtB,MAAQ,IAAkB,CACxB,GAAI,CACF,OAAO,EAAiB,EAAS,CAAK,EAAG,CAAW,CACtD,OAAS,EAAK,CAGZ,MAFK,GAAgC,EAAhC,EAA0C,EAA1C,EAEE,CACT,CACF,EAGF,IAAM,EAAO,OAAO,GAAa,SAAW,EAAiB,EAAU,CAAW,EAAI,EAEtF,UAAa,CACf"}
+{"version":3,"file":"_utils.cjs","names":[],"sources":["../src/_utils.ts"],"sourcesContent":["import { warn } from './_dev';\n\nexport type ScrollTarget = HTMLElement | Window;\n\nexport type VirtualKey = number | string;\n\n/** Shared measurement cache. Pass the same instance to multiple virtualizers\n *  for scroll restoration or SSR pre-measurement. */\nexport type MeasurementCache = Map<VirtualKey, number>;\n\n/** Create a new, empty measurement cache. */\nexport function createMeasurementCache(): MeasurementCache {\n  return new Map();\n}\n\nexport type Overscan = number | { end?: number; start?: number };\n\nexport const DEFAULT_ESTIMATE_SIZE = 36;\nexport const DEFAULT_OVERSCAN = 3;\n\nexport function createSnapshotStore<T>(initialSnapshot: T): {\n  dispose: () => void;\n  getSnapshot: () => T;\n  publish: (snapshot: T) => void;\n  subscribe: (listener: () => void) => () => void;\n} {\n  const listeners = new Set<() => void>();\n  let snapshot = initialSnapshot;\n  let disposed = false;\n\n  return {\n    dispose() {\n      disposed = true;\n      listeners.clear();\n    },\n    getSnapshot() {\n      return snapshot;\n    },\n    publish(nextSnapshot) {\n      if (disposed) return;\n      snapshot = nextSnapshot;\n\n      for (const listener of [...listeners]) {\n        try {\n          listener();\n        } catch (error) {\n          queueMicrotask(() => {\n            throw error;\n          });\n        }\n      }\n    },\n    subscribe(listener) {\n      if (disposed) return () => {};\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n\n// ─── Numeric helpers ───────────────────────────────────────────────────────────\n\nexport function toNonNegativeInt(value: number, fallback = 0): number {\n  if (!Number.isFinite(value)) return fallback;\n\n  return Math.max(0, Math.floor(value));\n}\n\nexport function toPositiveNumber(value: number, fallback: number): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) return fallback;\n\n  return value;\n}\n\nexport function isWindowTarget(target: ScrollTarget): target is Window {\n  return (\n    (typeof Window !== 'undefined' && target instanceof Window) ||\n    (typeof (target as Window).innerHeight === 'number' && typeof (target as Window).document === 'object')\n  );\n}\n\nexport function normalizeOverscan(overscan: Overscan | undefined, defaultVal: number): { end: number; start: number } {\n  if (typeof overscan === 'number') {\n    const n = toNonNegativeInt(overscan, defaultVal);\n\n    return { end: n, start: n };\n  }\n\n  return {\n    end: toNonNegativeInt(overscan?.end ?? defaultVal),\n    start: toNonNegativeInt(overscan?.start ?? defaultVal),\n  };\n}\n\n/**\n * Create a `ResizeObserver` that reports size changes on `el` via `onSize`, tied to\n * `signal` so it is disconnected automatically when the owning factory disposes —\n * even if the caller never calls the returned disconnect function.\n */\nexport function observeResize(\n  signal: AbortSignal,\n  el: HTMLElement,\n  onSize: (entry: ResizeObserverEntry) => void,\n): () => void {\n  const ro = new ResizeObserver((entries) => {\n    for (const entry of entries) onSize(entry);\n  });\n\n  ro.observe(el);\n  signal.addEventListener('abort', () => ro.disconnect(), { once: true });\n\n  return () => ro.disconnect();\n}\n\nexport function resolveEstimateFn(\n  estimate: number | ((index: number) => number) | undefined,\n  defaultSize: number,\n): (index: number) => number {\n  if (typeof estimate === 'function') {\n    return (index: number) => {\n      try {\n        return toPositiveNumber(estimate(index), defaultSize);\n      } catch (err) {\n        warn(`estimateSize threw for index ${index}: ${err}`);\n\n        return defaultSize;\n      }\n    };\n  }\n\n  const size = typeof estimate === 'number' ? toPositiveNumber(estimate, defaultSize) : defaultSize;\n\n  return () => size;\n}\n"],"mappings":"sBAWA,SAAgB,GAA2C,CACzD,OAAO,IAAI,GACb,CAIA,IAAa,EAAwB,GACxB,EAAmB,EAEhC,SAAgB,EAAuB,EAKrC,CACA,IAAM,EAAY,IAAI,IAClB,EAAW,EACX,EAAW,GAEf,MAAO,CACL,SAAU,CACR,EAAW,GACX,EAAU,MAAM,CAClB,EACA,aAAc,CACZ,OAAO,CACT,EACA,QAAQ,EAAc,CAChB,MACJ,GAAW,EAEX,IAAK,IAAM,IAAY,CAAC,GAAG,CAAS,EAClC,GAAI,CACF,EAAS,CACX,OAAS,EAAO,CACd,mBAAqB,CACnB,MAAM,CACR,CAAC,CACH,CATS,CAWb,EACA,UAAU,EAAU,CAGlB,OAFI,MAAuB,CAAC,GAC5B,EAAU,IAAI,CAAQ,MACT,EAAU,OAAO,CAAQ,EACxC,CACF,CACF,CAIA,SAAgB,EAAiB,EAAe,EAAW,EAAW,CAGpE,OAFK,OAAO,SAAS,CAAK,EAEnB,KAAK,IAAI,EAAG,KAAK,MAAM,CAAK,CAAC,EAFA,CAGtC,CAEA,SAAgB,EAAiB,EAAe,EAA0B,CAGxE,MAFI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IAAY,EAE1D,CACT,CAEA,SAAgB,EAAe,EAAwC,CACrE,OACG,OAAO,OAAW,KAAe,aAAkB,QACnD,OAAQ,EAAkB,aAAgB,UAAY,OAAQ,EAAkB,UAAa,QAElG,CAEA,SAAgB,EAAkB,EAAgC,EAAoD,CACpH,GAAI,OAAO,GAAa,SAAU,CAChC,IAAM,EAAI,EAAiB,EAAU,CAAU,EAE/C,MAAO,CAAE,IAAK,EAAG,MAAO,CAAE,CAC5B,CAEA,MAAO,CACL,IAAK,EAAiB,GAAU,KAAO,CAAU,EACjD,MAAO,EAAiB,GAAU,OAAS,CAAU,CACvD,CACF,CAOA,SAAgB,EACd,EACA,EACA,EACY,CACZ,IAAM,EAAK,IAAI,eAAgB,GAAY,CACzC,IAAK,IAAM,KAAS,EAAS,EAAO,CAAK,CAC3C,CAAC,EAKD,OAHA,EAAG,QAAQ,CAAE,EACb,EAAO,iBAAiB,YAAe,EAAG,WAAW,EAAG,CAAE,KAAM,EAAK,CAAC,MAEzD,EAAG,WAAW,CAC7B,CAEA,SAAgB,EACd,EACA,EAC2B,CAC3B,GAAI,OAAO,GAAa,WACtB,MAAQ,IAAkB,CACxB,GAAI,CACF,OAAO,EAAiB,EAAS,CAAK,EAAG,CAAW,CACtD,OAAS,EAAK,CAGZ,MAFK,GAAgC,EAAhC,EAA0C,EAA1C,EAEE,CACT,CACF,EAGF,IAAM,EAAO,OAAO,GAAa,SAAW,EAAiB,EAAU,CAAW,EAAI,EAEtF,UAAa,CACf"}

package/dist/_utils.d.ts

@@ -11,6 +11,12 @@ export type Overscan = number | {
 };
 export declare const DEFAULT_ESTIMATE_SIZE = 36;
 export declare const DEFAULT_OVERSCAN = 3;
+export declare function createSnapshotStore<T>(initialSnapshot: T): {
+    dispose: () => void;
+    getSnapshot: () => T;
+    publish: (snapshot: T) => void;
+    subscribe: (listener: () => void) => () => void;
+};
 export declare function toNonNegativeInt(value: number, fallback?: number): number;
 export declare function toPositiveNumber(value: number, fallback: number): number;
 export declare function isWindowTarget(target: ScrollTarget): target is Window;

package/dist/_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../src/_utils.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC;qDACqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEvD,6CAA6C;AAC7C,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAIlC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAIpE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,MAAM,CAKrE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWpH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC3C,MAAM,IAAI,CASZ;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EAC1D,WAAW,EAAE,MAAM,GAClB,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAgB3B"}
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../src/_utils.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC;qDACqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEvD,6CAA6C;AAC7C,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,GAAG;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD,CAiCA;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAIpE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,MAAM,CAKrE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWpH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC3C,MAAM,IAAI,CASZ;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,EAC1D,WAAW,EAAE,MAAM,GAClB,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAgB3B"}

package/dist/_utils.js

@@ -1,2 +1,2 @@
-import"./_dev.js";function e(){return new Map}var t=36,n=3;function r(e,t=0){return Number.isFinite(e)?Math.max(0,Math.floor(e)):t}function i(e,t){return!Number.isFinite(e)||e<=0||e>1e7?t:e}function a(e){return typeof Window<`u`&&e instanceof Window||typeof e.innerHeight==`number`&&typeof e.document==`object`}function o(e,t){if(typeof e==`number`){let n=r(e,t);return{end:n,start:n}}return{end:r(e?.end??t),start:r(e?.start??t)}}function s(e,t,n){let r=new ResizeObserver(e=>{for(let t of e)n(t)});return r.observe(t),e.addEventListener(`abort`,()=>r.disconnect(),{once:!0}),()=>r.disconnect()}function c(e,t){if(typeof e==`function`)return n=>{try{return i(e(n),t)}catch(e){return`${n}${e}`,t}};let n=typeof e==`number`?i(e,t):t;return()=>n}export{t as DEFAULT_ESTIMATE_SIZE,n as DEFAULT_OVERSCAN,e as createMeasurementCache,a as isWindowTarget,o as normalizeOverscan,s as observeResize,c as resolveEstimateFn,r as toNonNegativeInt,i as toPositiveNumber};
+import"./_dev.js";function e(){return new Map}var t=36,n=3;function r(e){let t=new Set,n=e,r=!1;return{dispose(){r=!0,t.clear()},getSnapshot(){return n},publish(e){if(!r){n=e;for(let e of[...t])try{e()}catch(e){queueMicrotask(()=>{throw e})}}},subscribe(e){return r?()=>{}:(t.add(e),()=>t.delete(e))}}}function i(e,t=0){return Number.isFinite(e)?Math.max(0,Math.floor(e)):t}function a(e,t){return!Number.isFinite(e)||e<=0||e>1e7?t:e}function o(e){return typeof Window<`u`&&e instanceof Window||typeof e.innerHeight==`number`&&typeof e.document==`object`}function s(e,t){if(typeof e==`number`){let n=i(e,t);return{end:n,start:n}}return{end:i(e?.end??t),start:i(e?.start??t)}}function c(e,t,n){let r=new ResizeObserver(e=>{for(let t of e)n(t)});return r.observe(t),e.addEventListener(`abort`,()=>r.disconnect(),{once:!0}),()=>r.disconnect()}function l(e,t){if(typeof e==`function`)return n=>{try{return a(e(n),t)}catch(e){return`${n}${e}`,t}};let n=typeof e==`number`?a(e,t):t;return()=>n}export{t as DEFAULT_ESTIMATE_SIZE,n as DEFAULT_OVERSCAN,e as createMeasurementCache,r as createSnapshotStore,o as isWindowTarget,s as normalizeOverscan,c as observeResize,l as resolveEstimateFn,i as toNonNegativeInt,a as toPositiveNumber};
 //# sourceMappingURL=_utils.js.map

package/dist/_utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"_utils.js","names":[],"sources":["../src/_utils.ts"],"sourcesContent":["import { warn } from './_dev';\n\nexport type ScrollTarget = HTMLElement | Window;\n\nexport type VirtualKey = number | string;\n\n/** Shared measurement cache. Pass the same instance to multiple virtualizers\n *  for scroll restoration or SSR pre-measurement. */\nexport type MeasurementCache = Map<VirtualKey, number>;\n\n/** Create a new, empty measurement cache. */\nexport function createMeasurementCache(): MeasurementCache {\n  return new Map();\n}\n\nexport type Overscan = number | { end?: number; start?: number };\n\nexport const DEFAULT_ESTIMATE_SIZE = 36;\nexport const DEFAULT_OVERSCAN = 3;\n\n// ─── Numeric helpers ───────────────────────────────────────────────────────────\n\nexport function toNonNegativeInt(value: number, fallback = 0): number {\n  if (!Number.isFinite(value)) return fallback;\n\n  return Math.max(0, Math.floor(value));\n}\n\nexport function toPositiveNumber(value: number, fallback: number): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) return fallback;\n\n  return value;\n}\n\nexport function isWindowTarget(target: ScrollTarget): target is Window {\n  return (\n    (typeof Window !== 'undefined' && target instanceof Window) ||\n    (typeof (target as Window).innerHeight === 'number' && typeof (target as Window).document === 'object')\n  );\n}\n\nexport function normalizeOverscan(overscan: Overscan | undefined, defaultVal: number): { end: number; start: number } {\n  if (typeof overscan === 'number') {\n    const n = toNonNegativeInt(overscan, defaultVal);\n\n    return { end: n, start: n };\n  }\n\n  return {\n    end: toNonNegativeInt(overscan?.end ?? defaultVal),\n    start: toNonNegativeInt(overscan?.start ?? defaultVal),\n  };\n}\n\n/**\n * Create a `ResizeObserver` that reports size changes on `el` via `onSize`, tied to\n * `signal` so it is disconnected automatically when the owning factory disposes —\n * even if the caller never calls the returned disconnect function.\n */\nexport function observeResize(\n  signal: AbortSignal,\n  el: HTMLElement,\n  onSize: (entry: ResizeObserverEntry) => void,\n): () => void {\n  const ro = new ResizeObserver((entries) => {\n    for (const entry of entries) onSize(entry);\n  });\n\n  ro.observe(el);\n  signal.addEventListener('abort', () => ro.disconnect(), { once: true });\n\n  return () => ro.disconnect();\n}\n\nexport function resolveEstimateFn(\n  estimate: number | ((index: number) => number) | undefined,\n  defaultSize: number,\n): (index: number) => number {\n  if (typeof estimate === 'function') {\n    return (index: number) => {\n      try {\n        return toPositiveNumber(estimate(index), defaultSize);\n      } catch (err) {\n        warn(`estimateSize threw for index ${index}: ${err}`);\n\n        return defaultSize;\n      }\n    };\n  }\n\n  const size = typeof estimate === 'number' ? toPositiveNumber(estimate, defaultSize) : defaultSize;\n\n  return () => size;\n}\n"],"mappings":"kBAWA,SAAgB,GAA2C,CACzD,OAAO,IAAI,GACb,CAIA,IAAa,EAAwB,GACxB,EAAmB,EAIhC,SAAgB,EAAiB,EAAe,EAAW,EAAW,CAGpE,OAFK,OAAO,SAAS,CAAK,EAEnB,KAAK,IAAI,EAAG,KAAK,MAAM,CAAK,CAAC,EAFA,CAGtC,CAEA,SAAgB,EAAiB,EAAe,EAA0B,CAGxE,MAFI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IAAY,EAE1D,CACT,CAEA,SAAgB,EAAe,EAAwC,CACrE,OACG,OAAO,OAAW,KAAe,aAAkB,QACnD,OAAQ,EAAkB,aAAgB,UAAY,OAAQ,EAAkB,UAAa,QAElG,CAEA,SAAgB,EAAkB,EAAgC,EAAoD,CACpH,GAAI,OAAO,GAAa,SAAU,CAChC,IAAM,EAAI,EAAiB,EAAU,CAAU,EAE/C,MAAO,CAAE,IAAK,EAAG,MAAO,CAAE,CAC5B,CAEA,MAAO,CACL,IAAK,EAAiB,GAAU,KAAO,CAAU,EACjD,MAAO,EAAiB,GAAU,OAAS,CAAU,CACvD,CACF,CAOA,SAAgB,EACd,EACA,EACA,EACY,CACZ,IAAM,EAAK,IAAI,eAAgB,GAAY,CACzC,IAAK,IAAM,KAAS,EAAS,EAAO,CAAK,CAC3C,CAAC,EAKD,OAHA,EAAG,QAAQ,CAAE,EACb,EAAO,iBAAiB,YAAe,EAAG,WAAW,EAAG,CAAE,KAAM,EAAK,CAAC,MAEzD,EAAG,WAAW,CAC7B,CAEA,SAAgB,EACd,EACA,EAC2B,CAC3B,GAAI,OAAO,GAAa,WACtB,MAAQ,IAAkB,CACxB,GAAI,CACF,OAAO,EAAiB,EAAS,CAAK,EAAG,CAAW,CACtD,OAAS,EAAK,CAGZ,MAFK,GAAgC,EAAhC,EAA0C,EAA1C,EAEE,CACT,CACF,EAGF,IAAM,EAAO,OAAO,GAAa,SAAW,EAAiB,EAAU,CAAW,EAAI,EAEtF,UAAa,CACf"}
+{"version":3,"file":"_utils.js","names":[],"sources":["../src/_utils.ts"],"sourcesContent":["import { warn } from './_dev';\n\nexport type ScrollTarget = HTMLElement | Window;\n\nexport type VirtualKey = number | string;\n\n/** Shared measurement cache. Pass the same instance to multiple virtualizers\n *  for scroll restoration or SSR pre-measurement. */\nexport type MeasurementCache = Map<VirtualKey, number>;\n\n/** Create a new, empty measurement cache. */\nexport function createMeasurementCache(): MeasurementCache {\n  return new Map();\n}\n\nexport type Overscan = number | { end?: number; start?: number };\n\nexport const DEFAULT_ESTIMATE_SIZE = 36;\nexport const DEFAULT_OVERSCAN = 3;\n\nexport function createSnapshotStore<T>(initialSnapshot: T): {\n  dispose: () => void;\n  getSnapshot: () => T;\n  publish: (snapshot: T) => void;\n  subscribe: (listener: () => void) => () => void;\n} {\n  const listeners = new Set<() => void>();\n  let snapshot = initialSnapshot;\n  let disposed = false;\n\n  return {\n    dispose() {\n      disposed = true;\n      listeners.clear();\n    },\n    getSnapshot() {\n      return snapshot;\n    },\n    publish(nextSnapshot) {\n      if (disposed) return;\n      snapshot = nextSnapshot;\n\n      for (const listener of [...listeners]) {\n        try {\n          listener();\n        } catch (error) {\n          queueMicrotask(() => {\n            throw error;\n          });\n        }\n      }\n    },\n    subscribe(listener) {\n      if (disposed) return () => {};\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n\n// ─── Numeric helpers ───────────────────────────────────────────────────────────\n\nexport function toNonNegativeInt(value: number, fallback = 0): number {\n  if (!Number.isFinite(value)) return fallback;\n\n  return Math.max(0, Math.floor(value));\n}\n\nexport function toPositiveNumber(value: number, fallback: number): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) return fallback;\n\n  return value;\n}\n\nexport function isWindowTarget(target: ScrollTarget): target is Window {\n  return (\n    (typeof Window !== 'undefined' && target instanceof Window) ||\n    (typeof (target as Window).innerHeight === 'number' && typeof (target as Window).document === 'object')\n  );\n}\n\nexport function normalizeOverscan(overscan: Overscan | undefined, defaultVal: number): { end: number; start: number } {\n  if (typeof overscan === 'number') {\n    const n = toNonNegativeInt(overscan, defaultVal);\n\n    return { end: n, start: n };\n  }\n\n  return {\n    end: toNonNegativeInt(overscan?.end ?? defaultVal),\n    start: toNonNegativeInt(overscan?.start ?? defaultVal),\n  };\n}\n\n/**\n * Create a `ResizeObserver` that reports size changes on `el` via `onSize`, tied to\n * `signal` so it is disconnected automatically when the owning factory disposes —\n * even if the caller never calls the returned disconnect function.\n */\nexport function observeResize(\n  signal: AbortSignal,\n  el: HTMLElement,\n  onSize: (entry: ResizeObserverEntry) => void,\n): () => void {\n  const ro = new ResizeObserver((entries) => {\n    for (const entry of entries) onSize(entry);\n  });\n\n  ro.observe(el);\n  signal.addEventListener('abort', () => ro.disconnect(), { once: true });\n\n  return () => ro.disconnect();\n}\n\nexport function resolveEstimateFn(\n  estimate: number | ((index: number) => number) | undefined,\n  defaultSize: number,\n): (index: number) => number {\n  if (typeof estimate === 'function') {\n    return (index: number) => {\n      try {\n        return toPositiveNumber(estimate(index), defaultSize);\n      } catch (err) {\n        warn(`estimateSize threw for index ${index}: ${err}`);\n\n        return defaultSize;\n      }\n    };\n  }\n\n  const size = typeof estimate === 'number' ? toPositiveNumber(estimate, defaultSize) : defaultSize;\n\n  return () => size;\n}\n"],"mappings":"kBAWA,SAAgB,GAA2C,CACzD,OAAO,IAAI,GACb,CAIA,IAAa,EAAwB,GACxB,EAAmB,EAEhC,SAAgB,EAAuB,EAKrC,CACA,IAAM,EAAY,IAAI,IAClB,EAAW,EACX,EAAW,GAEf,MAAO,CACL,SAAU,CACR,EAAW,GACX,EAAU,MAAM,CAClB,EACA,aAAc,CACZ,OAAO,CACT,EACA,QAAQ,EAAc,CAChB,MACJ,GAAW,EAEX,IAAK,IAAM,IAAY,CAAC,GAAG,CAAS,EAClC,GAAI,CACF,EAAS,CACX,OAAS,EAAO,CACd,mBAAqB,CACnB,MAAM,CACR,CAAC,CACH,CATS,CAWb,EACA,UAAU,EAAU,CAGlB,OAFI,MAAuB,CAAC,GAC5B,EAAU,IAAI,CAAQ,MACT,EAAU,OAAO,CAAQ,EACxC,CACF,CACF,CAIA,SAAgB,EAAiB,EAAe,EAAW,EAAW,CAGpE,OAFK,OAAO,SAAS,CAAK,EAEnB,KAAK,IAAI,EAAG,KAAK,MAAM,CAAK,CAAC,EAFA,CAGtC,CAEA,SAAgB,EAAiB,EAAe,EAA0B,CAGxE,MAFI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IAAY,EAE1D,CACT,CAEA,SAAgB,EAAe,EAAwC,CACrE,OACG,OAAO,OAAW,KAAe,aAAkB,QACnD,OAAQ,EAAkB,aAAgB,UAAY,OAAQ,EAAkB,UAAa,QAElG,CAEA,SAAgB,EAAkB,EAAgC,EAAoD,CACpH,GAAI,OAAO,GAAa,SAAU,CAChC,IAAM,EAAI,EAAiB,EAAU,CAAU,EAE/C,MAAO,CAAE,IAAK,EAAG,MAAO,CAAE,CAC5B,CAEA,MAAO,CACL,IAAK,EAAiB,GAAU,KAAO,CAAU,EACjD,MAAO,EAAiB,GAAU,OAAS,CAAU,CACvD,CACF,CAOA,SAAgB,EACd,EACA,EACA,EACY,CACZ,IAAM,EAAK,IAAI,eAAgB,GAAY,CACzC,IAAK,IAAM,KAAS,EAAS,EAAO,CAAK,CAC3C,CAAC,EAKD,OAHA,EAAG,QAAQ,CAAE,EACb,EAAO,iBAAiB,YAAe,EAAG,WAAW,EAAG,CAAE,KAAM,EAAK,CAAC,MAEzD,EAAG,WAAW,CAC7B,CAEA,SAAgB,EACd,EACA,EAC2B,CAC3B,GAAI,OAAO,GAAa,WACtB,MAAQ,IAAkB,CACxB,GAAI,CACF,OAAO,EAAiB,EAAS,CAAK,EAAG,CAAW,CACtD,OAAS,EAAK,CAGZ,MAFK,GAAgC,EAAhC,EAA0C,EAA1C,EAEE,CACT,CACF,EAGF,IAAM,EAAO,OAAO,GAAa,SAAW,EAAiB,EAAU,CAAW,EAAI,EAEtF,UAAa,CACf"}

package/dist/_validation.cjs

@@ -1,2 +1,2 @@
-const e=require("./errors.cjs");function t(t,n){if(!Number.isFinite(t)||!Number.isInteger(t)||t<0)throw new e.ScrollConfigurationError(`${n} must be a finite non-negative integer.`);return t}function n(t,n){if(!Number.isFinite(t)||t<0)throw new e.ScrollConfigurationError(`${n} must be a finite non-negative number.`);return t}function r(t,n){if(!Number.isFinite(t)||t<=0||t>1e7)throw new e.ScrollConfigurationError(`${n} must be a finite positive number no greater than 10000000.`);return t}function i(n,r=`overscan`){if(typeof n==`number`){t(n,r);return}if(typeof n!=`object`||!n||Array.isArray(n))throw new e.ScrollConfigurationError(`${r} must be a finite non-negative integer or an overscan object.`);n.start!==void 0&&t(n.start,`${r}.start`),n.end!==void 0&&t(n.end,`${r}.end`)}exports.requireNonNegativeInteger=t,exports.requireNonNegativeNumber=n,exports.requirePositiveNumber=r,exports.validateOverscan=i;
+const e=require("./errors.cjs");function t(t,n){if(!Number.isFinite(t)||!Number.isInteger(t)||t<0)throw new e.ScrollConfigError(`${n} must be a finite non-negative integer.`);return t}function n(t,n){if(!Number.isFinite(t)||t<0)throw new e.ScrollConfigError(`${n} must be a finite non-negative number.`);return t}function r(t,n){if(!Number.isFinite(t)||t<=0||t>1e7)throw new e.ScrollConfigError(`${n} must be a finite positive number no greater than 10000000.`);return t}function i(n,r=`overscan`){if(typeof n==`number`){t(n,r);return}if(typeof n!=`object`||!n||Array.isArray(n))throw new e.ScrollConfigError(`${r} must be a finite non-negative integer or an overscan object.`);n.start!==void 0&&t(n.start,`${r}.start`),n.end!==void 0&&t(n.end,`${r}.end`)}exports.requireNonNegativeInteger=t,exports.requireNonNegativeNumber=n,exports.requirePositiveNumber=r,exports.validateOverscan=i;
 //# sourceMappingURL=_validation.cjs.map

package/dist/_validation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_validation.cjs","names":[],"sources":["../src/_validation.ts"],"sourcesContent":["import { ScrollConfigurationError } from './errors';\n\nexport function requireNonNegativeInteger(value: number, name: string): number {\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative integer.`);\n  }\n\n  return value;\n}\n\nexport function requireNonNegativeNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative number.`);\n  }\n\n  return value;\n}\n\nexport function requirePositiveNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) {\n    throw new ScrollConfigurationError(`${name} must be a finite positive number no greater than 10000000.`);\n  }\n\n  return value;\n}\n\nexport function validateOverscan(overscan: number | { end?: number; start?: number }, name = 'overscan'): void {\n  if (typeof overscan === 'number') {\n    requireNonNegativeInteger(overscan, name);\n\n    return;\n  }\n\n  if (overscan === null || typeof overscan !== 'object' || Array.isArray(overscan)) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative integer or an overscan object.`);\n  }\n\n  if (overscan.start !== undefined) requireNonNegativeInteger(overscan.start, `${name}.start`);\n\n  if (overscan.end !== undefined) requireNonNegativeInteger(overscan.end, `${name}.end`);\n}\n"],"mappings":"gCAEA,SAAgB,EAA0B,EAAe,EAAsB,CAC7E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,CAAC,OAAO,UAAU,CAAK,GAAK,EAAQ,EACjE,MAAM,IAAI,EAAA,yBAAyB,GAAG,EAAK,wCAAwC,EAGrF,OAAO,CACT,CAEA,SAAgB,EAAyB,EAAe,EAAsB,CAC5E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,EAAQ,EACrC,MAAM,IAAI,EAAA,yBAAyB,GAAG,EAAK,uCAAuC,EAGpF,OAAO,CACT,CAEA,SAAgB,EAAsB,EAAe,EAAsB,CACzE,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IACnD,MAAM,IAAI,EAAA,yBAAyB,GAAG,EAAK,4DAA4D,EAGzG,OAAO,CACT,CAEA,SAAgB,EAAiB,EAAqD,EAAO,WAAkB,CAC7G,GAAI,OAAO,GAAa,SAAU,CAChC,EAA0B,EAAU,CAAI,EAExC,MACF,CAEA,GAAyB,OAAO,GAAa,WAAzC,GAAqD,MAAM,QAAQ,CAAQ,EAC7E,MAAM,IAAI,EAAA,yBAAyB,GAAG,EAAK,8DAA8D,EAGvG,EAAS,QAAU,IAAA,IAAW,EAA0B,EAAS,MAAO,GAAG,EAAK,OAAO,EAEvF,EAAS,MAAQ,IAAA,IAAW,EAA0B,EAAS,IAAK,GAAG,EAAK,KAAK,CACvF"}
+{"version":3,"file":"_validation.cjs","names":[],"sources":["../src/_validation.ts"],"sourcesContent":["import { ScrollConfigError } from './errors';\n\nexport function requireNonNegativeInteger(value: number, name: string): number {\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative integer.`);\n  }\n\n  return value;\n}\n\nexport function requireNonNegativeNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative number.`);\n  }\n\n  return value;\n}\n\nexport function requirePositiveNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) {\n    throw new ScrollConfigError(`${name} must be a finite positive number no greater than 10000000.`);\n  }\n\n  return value;\n}\n\nexport function validateOverscan(overscan: number | { end?: number; start?: number }, name = 'overscan'): void {\n  if (typeof overscan === 'number') {\n    requireNonNegativeInteger(overscan, name);\n\n    return;\n  }\n\n  if (overscan === null || typeof overscan !== 'object' || Array.isArray(overscan)) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative integer or an overscan object.`);\n  }\n\n  if (overscan.start !== undefined) requireNonNegativeInteger(overscan.start, `${name}.start`);\n\n  if (overscan.end !== undefined) requireNonNegativeInteger(overscan.end, `${name}.end`);\n}\n"],"mappings":"gCAEA,SAAgB,EAA0B,EAAe,EAAsB,CAC7E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,CAAC,OAAO,UAAU,CAAK,GAAK,EAAQ,EACjE,MAAM,IAAI,EAAA,kBAAkB,GAAG,EAAK,wCAAwC,EAG9E,OAAO,CACT,CAEA,SAAgB,EAAyB,EAAe,EAAsB,CAC5E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,EAAQ,EACrC,MAAM,IAAI,EAAA,kBAAkB,GAAG,EAAK,uCAAuC,EAG7E,OAAO,CACT,CAEA,SAAgB,EAAsB,EAAe,EAAsB,CACzE,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IACnD,MAAM,IAAI,EAAA,kBAAkB,GAAG,EAAK,4DAA4D,EAGlG,OAAO,CACT,CAEA,SAAgB,EAAiB,EAAqD,EAAO,WAAkB,CAC7G,GAAI,OAAO,GAAa,SAAU,CAChC,EAA0B,EAAU,CAAI,EAExC,MACF,CAEA,GAAyB,OAAO,GAAa,WAAzC,GAAqD,MAAM,QAAQ,CAAQ,EAC7E,MAAM,IAAI,EAAA,kBAAkB,GAAG,EAAK,8DAA8D,EAGhG,EAAS,QAAU,IAAA,IAAW,EAA0B,EAAS,MAAO,GAAG,EAAK,OAAO,EAEvF,EAAS,MAAQ,IAAA,IAAW,EAA0B,EAAS,IAAK,GAAG,EAAK,KAAK,CACvF"}

package/dist/_validation.js

@@ -1,2 +1,2 @@
-import{ScrollConfigurationError as e}from"./errors.js";function t(t,n){if(!Number.isFinite(t)||!Number.isInteger(t)||t<0)throw new e(`${n} must be a finite non-negative integer.`);return t}function n(t,n){if(!Number.isFinite(t)||t<0)throw new e(`${n} must be a finite non-negative number.`);return t}function r(t,n){if(!Number.isFinite(t)||t<=0||t>1e7)throw new e(`${n} must be a finite positive number no greater than 10000000.`);return t}function i(n,r=`overscan`){if(typeof n==`number`){t(n,r);return}if(typeof n!=`object`||!n||Array.isArray(n))throw new e(`${r} must be a finite non-negative integer or an overscan object.`);n.start!==void 0&&t(n.start,`${r}.start`),n.end!==void 0&&t(n.end,`${r}.end`)}export{t as requireNonNegativeInteger,n as requireNonNegativeNumber,r as requirePositiveNumber,i as validateOverscan};
+import{ScrollConfigError as e}from"./errors.js";function t(t,n){if(!Number.isFinite(t)||!Number.isInteger(t)||t<0)throw new e(`${n} must be a finite non-negative integer.`);return t}function n(t,n){if(!Number.isFinite(t)||t<0)throw new e(`${n} must be a finite non-negative number.`);return t}function r(t,n){if(!Number.isFinite(t)||t<=0||t>1e7)throw new e(`${n} must be a finite positive number no greater than 10000000.`);return t}function i(n,r=`overscan`){if(typeof n==`number`){t(n,r);return}if(typeof n!=`object`||!n||Array.isArray(n))throw new e(`${r} must be a finite non-negative integer or an overscan object.`);n.start!==void 0&&t(n.start,`${r}.start`),n.end!==void 0&&t(n.end,`${r}.end`)}export{t as requireNonNegativeInteger,n as requireNonNegativeNumber,r as requirePositiveNumber,i as validateOverscan};
 //# sourceMappingURL=_validation.js.map

package/dist/_validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"_validation.js","names":[],"sources":["../src/_validation.ts"],"sourcesContent":["import { ScrollConfigurationError } from './errors';\n\nexport function requireNonNegativeInteger(value: number, name: string): number {\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative integer.`);\n  }\n\n  return value;\n}\n\nexport function requireNonNegativeNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative number.`);\n  }\n\n  return value;\n}\n\nexport function requirePositiveNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) {\n    throw new ScrollConfigurationError(`${name} must be a finite positive number no greater than 10000000.`);\n  }\n\n  return value;\n}\n\nexport function validateOverscan(overscan: number | { end?: number; start?: number }, name = 'overscan'): void {\n  if (typeof overscan === 'number') {\n    requireNonNegativeInteger(overscan, name);\n\n    return;\n  }\n\n  if (overscan === null || typeof overscan !== 'object' || Array.isArray(overscan)) {\n    throw new ScrollConfigurationError(`${name} must be a finite non-negative integer or an overscan object.`);\n  }\n\n  if (overscan.start !== undefined) requireNonNegativeInteger(overscan.start, `${name}.start`);\n\n  if (overscan.end !== undefined) requireNonNegativeInteger(overscan.end, `${name}.end`);\n}\n"],"mappings":"uDAEA,SAAgB,EAA0B,EAAe,EAAsB,CAC7E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,CAAC,OAAO,UAAU,CAAK,GAAK,EAAQ,EACjE,MAAM,IAAI,EAAyB,GAAG,EAAK,wCAAwC,EAGrF,OAAO,CACT,CAEA,SAAgB,EAAyB,EAAe,EAAsB,CAC5E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,EAAQ,EACrC,MAAM,IAAI,EAAyB,GAAG,EAAK,uCAAuC,EAGpF,OAAO,CACT,CAEA,SAAgB,EAAsB,EAAe,EAAsB,CACzE,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IACnD,MAAM,IAAI,EAAyB,GAAG,EAAK,4DAA4D,EAGzG,OAAO,CACT,CAEA,SAAgB,EAAiB,EAAqD,EAAO,WAAkB,CAC7G,GAAI,OAAO,GAAa,SAAU,CAChC,EAA0B,EAAU,CAAI,EAExC,MACF,CAEA,GAAyB,OAAO,GAAa,WAAzC,GAAqD,MAAM,QAAQ,CAAQ,EAC7E,MAAM,IAAI,EAAyB,GAAG,EAAK,8DAA8D,EAGvG,EAAS,QAAU,IAAA,IAAW,EAA0B,EAAS,MAAO,GAAG,EAAK,OAAO,EAEvF,EAAS,MAAQ,IAAA,IAAW,EAA0B,EAAS,IAAK,GAAG,EAAK,KAAK,CACvF"}
+{"version":3,"file":"_validation.js","names":[],"sources":["../src/_validation.ts"],"sourcesContent":["import { ScrollConfigError } from './errors';\n\nexport function requireNonNegativeInteger(value: number, name: string): number {\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative integer.`);\n  }\n\n  return value;\n}\n\nexport function requireNonNegativeNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative number.`);\n  }\n\n  return value;\n}\n\nexport function requirePositiveNumber(value: number, name: string): number {\n  if (!Number.isFinite(value) || value <= 0 || value > 1e7) {\n    throw new ScrollConfigError(`${name} must be a finite positive number no greater than 10000000.`);\n  }\n\n  return value;\n}\n\nexport function validateOverscan(overscan: number | { end?: number; start?: number }, name = 'overscan'): void {\n  if (typeof overscan === 'number') {\n    requireNonNegativeInteger(overscan, name);\n\n    return;\n  }\n\n  if (overscan === null || typeof overscan !== 'object' || Array.isArray(overscan)) {\n    throw new ScrollConfigError(`${name} must be a finite non-negative integer or an overscan object.`);\n  }\n\n  if (overscan.start !== undefined) requireNonNegativeInteger(overscan.start, `${name}.start`);\n\n  if (overscan.end !== undefined) requireNonNegativeInteger(overscan.end, `${name}.end`);\n}\n"],"mappings":"gDAEA,SAAgB,EAA0B,EAAe,EAAsB,CAC7E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,CAAC,OAAO,UAAU,CAAK,GAAK,EAAQ,EACjE,MAAM,IAAI,EAAkB,GAAG,EAAK,wCAAwC,EAG9E,OAAO,CACT,CAEA,SAAgB,EAAyB,EAAe,EAAsB,CAC5E,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,EAAQ,EACrC,MAAM,IAAI,EAAkB,GAAG,EAAK,uCAAuC,EAG7E,OAAO,CACT,CAEA,SAAgB,EAAsB,EAAe,EAAsB,CACzE,GAAI,CAAC,OAAO,SAAS,CAAK,GAAK,GAAS,GAAK,EAAQ,IACnD,MAAM,IAAI,EAAkB,GAAG,EAAK,4DAA4D,EAGlG,OAAO,CACT,CAEA,SAAgB,EAAiB,EAAqD,EAAO,WAAkB,CAC7G,GAAI,OAAO,GAAa,SAAU,CAChC,EAA0B,EAAU,CAAI,EAExC,MACF,CAEA,GAAyB,OAAO,GAAa,WAAzC,GAAqD,MAAM,QAAQ,CAAQ,EAC7E,MAAM,IAAI,EAAkB,GAAG,EAAK,8DAA8D,EAGhG,EAAS,QAAU,IAAA,IAAW,EAA0B,EAAS,MAAO,GAAG,EAAK,OAAO,EAEvF,EAAS,MAAQ,IAAA,IAAW,EAA0B,EAAS,IAAK,GAAG,EAAK,KAAK,CACvF"}

package/dist/dom-virtual-list.cjs

@@ -1,2 +1,2 @@
-require("./_utils.cjs");const e=require("./errors.cjs"),t=require("./_validation.cjs"),n=require("./virtualizer.cjs");function r(){let e=new Map,t=new Map,n=[],r=!1;return{acquire(i,a){if(!r)return a();let o=e.get(i);if(o)return t.set(i,o),o;let s=n.pop()??a();return t.set(i,s),s},beginCycle(){t=new Map,r=!0},clear(){for(let t of e.values())t.remove();e.clear(),t.clear(),n.length=0,r=!1},endCycle(){if(r){r=!1;for(let[r,i]of e)t.has(r)||(i.remove(),n.push(i));e=t}}}}function i(i){if(typeof i.estimateSize==`number`&&t.requirePositiveNumber(i.estimateSize,`estimateSize`),i.gap!==void 0&&t.requireNonNegativeInteger(i.gap,`gap`),i.overscan!==void 0&&t.validateOverscan(i.overscan),i.stickToBottom!==void 0&&typeof i.stickToBottom!=`boolean`){if(i.stickToBottom===null||Array.isArray(i.stickToBottom))throw new e.ScrollConfigurationError(`stickToBottom must be a boolean or options object.`);i.stickToBottom.threshold!==void 0&&t.requireNonNegativeNumber(i.stickToBottom.threshold,`stickToBottom.threshold`)}let a=[],o=!1,s=new AbortController,c=i.listElement,l=null;i.toSignal&&(l=i.toSignal({items:[],stickyItems:[],totalSize:0}));function u(e){l&&(l.value=e),_(e)}let d=r(),f=null;function p(e){let t=a[e];return t!==void 0&&i.getItemKey?i.getItemKey(e,t):e}function m(e){if(i.estimateSize===void 0)return 36;if(typeof i.estimateSize==`number`)return i.estimateSize;let t=a[e];return t===void 0?36:i.estimateSize(e,t)}function h(e){i.horizontal?(c.style.height=``,c.style.width=`${e}px`):(c.style.height=`${e}px`,c.style.width=``)}function g(t){let n=a[t.index];if(n===void 0)throw new e.ScrollRangeError(`toRenderItem: index ${t.index} is out of range (currentItems.length=${a.length})`);return{...t,data:n}}function _(e){h(e.totalSize),d.beginCycle();try{i.render({items:e.items.map(g),listEl:c,recycle:(e,t)=>d.acquire(e,t),stickyItems:e.stickyItems.map(g),totalSize:e.totalSize})}finally{d.endCycle()}}function v(){d.clear(),i.clear?i.clear(c):c.textContent=``,c.style.height=``,c.style.width=``,c.style.position=``,c.style.contain=``}function y(){let e=i.stickToBottom;return e?e===!0?{enabled:!0,threshold:48}:{enabled:e.enabled??!0,threshold:e.threshold??48}:{enabled:!1,threshold:48}}function b(){let e=n.createVirtualizer(i.scrollElement,{count:a.length,estimateSize:m,gap:i.gap,getItemKey:p,horizontal:i.horizontal,keyboardScroll:i.keyboardScroll,measurementCache:i.measurementCache,onChange:u,overscan:i.overscan??3,sticky:i.sticky?e=>{let t=a[e];return t!==void 0&&i.sticky(e,t)}:void 0});return f=e,c.style.position=`relative`,c.style.contain=`layout`,e}function x(){o||(o=!0,s.abort(),f?.dispose(),f=null,v())}return{get count(){return f?.count??0},get disposalSignal(){return s.signal},dispose:x,get disposed(){return o},invalidate(){o||f?.invalidate()},isAtEnd(e){return f?.isAtEnd(e)??!0},get isScrolling(){return f?.isScrolling??!1},get items(){return f?.items??[]},measure(e,t){o||f?.measure(e,t)},measureBatch(e){o||f?.measureBatch(e)},measureEl(e,t){return o?()=>{}:f?.measureEl(e,t)??(()=>{})},refresh(){o||f?.refresh()},get scrollOffset(){return f?.scrollOffset??0},scrollToBottom(e){o||f?.scrollToBottom(e)},scrollToIndex(e,t){o||f?.scrollToIndex(e,t)},scrollToOffset(e,t){o||f?.scrollToOffset(e,t)},scrollToTop(e){o||f?.scrollToTop(e)},setItems(e){if(o)return;let t=y(),n=t.enabled&&(f?.isAtEnd(t.threshold)??!0);if(a=e,e.length===0){f?.dispose(),f=null,v();return}if(!f){let e=b();n&&e.scrollToBottom();return}let r=e.length!==f.count;f.update({count:e.length}),r?i.getItemKey||f.invalidate():i.getItemKey?f.refresh():f.invalidate(),n&&f.scrollToBottom()},get stickyItems(){return f?.stickyItems??[]},[Symbol.dispose]:x,get totalSize(){return f?.totalSize??0}}}function a(e,t){let n=document.createElement(`div`);n.style.cssText=t.horizontal?`overflow: auto hidden; width: 100%; height: 100%;`:`overflow: hidden auto; width: 100%; height: 100%;`,t.containerClass&&(n.className=t.containerClass);let r=document.createElement(`div`);n.appendChild(r),e.appendChild(n);let a;try{a=i({...t,listElement:r,scrollElement:n})}catch(e){throw n.remove(),e}let o=a.dispose.bind(a);return Object.assign(a,{dispose(){o(),n.remove()},[Symbol.dispose](){o(),n.remove()}})}exports.createDomVirtualList=i,exports.createVirtualScroller=a;
+const e=require("./_utils.cjs"),t=require("./errors.cjs"),n=require("./_validation.cjs"),r=require("./virtualizer.cjs");function i(){let e=new Map,t=new Map,n=[],r=!1;return{acquire(i,a){if(!r)return a();let o=e.get(i);if(o)return t.set(i,o),o;let s=n.pop()??a();return t.set(i,s),s},beginCycle(){t=new Map,r=!0},clear(){for(let t of e.values())t.remove();e.clear(),t.clear(),n.length=0,r=!1},endCycle(){if(r){r=!1;for(let[r,i]of e)t.has(r)||(i.remove(),n.push(i));e=t}}}}function a(a){if(typeof a.estimateSize==`number`&&n.requirePositiveNumber(a.estimateSize,`estimateSize`),a.gap!==void 0&&n.requireNonNegativeInteger(a.gap,`gap`),a.overscan!==void 0&&n.validateOverscan(a.overscan),a.stickToBottom!==void 0&&typeof a.stickToBottom!=`boolean`){if(a.stickToBottom===null||Array.isArray(a.stickToBottom))throw new t.ScrollConfigError(`stickToBottom must be a boolean or options object.`);a.stickToBottom.threshold!==void 0&&n.requireNonNegativeNumber(a.stickToBottom.threshold,`stickToBottom.threshold`)}let o=[],s=!1,c=new AbortController,l=a.listElement,u=e.createSnapshotStore({items:[],stickyItems:[],totalSize:0});function d(e){u.publish(e),v(e)}let f=i(),p=null;function m(e){let t=o[e];return t!==void 0&&a.getItemKey?a.getItemKey(e,t):e}function h(e){if(a.estimateSize===void 0)return 36;if(typeof a.estimateSize==`number`)return a.estimateSize;let t=o[e];return t===void 0?36:a.estimateSize(e,t)}function g(e){a.horizontal?(l.style.height=``,l.style.width=`${e}px`):(l.style.height=`${e}px`,l.style.width=``)}function _(e){let n=o[e.index];if(n===void 0)throw new t.ScrollRangeError(`toRenderItem: index ${e.index} is out of range (currentItems.length=${o.length})`);return{...e,data:n}}function v(e){g(e.totalSize),f.beginCycle();try{a.render({items:e.items.map(_),listEl:l,recycle:(e,t)=>f.acquire(e,t),stickyItems:e.stickyItems.map(_),totalSize:e.totalSize})}finally{f.endCycle()}}function y(){f.clear(),a.clear?a.clear(l):l.textContent=``,l.style.height=``,l.style.width=``,l.style.position=``,l.style.contain=``}function b(){let e=a.stickToBottom;return e?e===!0?{enabled:!0,threshold:48}:{enabled:e.enabled??!0,threshold:e.threshold??48}:{enabled:!1,threshold:48}}function x(){let e=r.createVirtualizer(a.scrollElement,{count:o.length,estimateSize:h,gap:a.gap,getItemKey:m,horizontal:a.horizontal,measurementCache:a.measurementCache,onChange:d,overscan:a.overscan??3,sticky:a.sticky?e=>{let t=o[e];return t!==void 0&&a.sticky(e,t)}:void 0});return p=e,l.style.position=`relative`,l.style.contain=`layout`,e}function S(){s||(s=!0,u.dispose(),c.abort(),p?.dispose(),p=null,y())}return{get count(){return p?.count??0},get disposalSignal(){return c.signal},dispose:S,get disposed(){return s},getSnapshot:u.getSnapshot,invalidate(){s||p?.invalidate()},isAtEnd(e){return p?.isAtEnd(e)??!0},get isScrolling(){return p?.isScrolling??!1},get items(){return p?.items??[]},measure(e,t){s||p?.measure(e,t)},measureBatch(e){s||p?.measureBatch(e)},measureEl(e,t){return s?()=>{}:p?.measureEl(e,t)??(()=>{})},refresh(){s||p?.refresh()},remeasure(){s||p?.remeasure()},get scrollOffset(){return p?.scrollOffset??0},scrollToBottom(e){s||p?.scrollToBottom(e)},scrollToIndex(e,t){s||p?.scrollToIndex(e,t)},scrollToOffset(e,t){s||p?.scrollToOffset(e,t)},scrollToTop(e){s||p?.scrollToTop(e)},setItems(e){if(s)return;let t=b(),n=t.enabled&&(p?.isAtEnd(t.threshold)??!0);if(o=e,e.length===0){p?.dispose(),p=null,u.publish({items:[],stickyItems:[],totalSize:0}),y();return}if(!p){let e=x();n&&e.scrollToBottom();return}let r=e.length!==p.count;p.update({count:e.length}),r?a.getItemKey||p.invalidate():a.getItemKey?p.refresh():p.invalidate(),n&&p.scrollToBottom()},get stickyItems(){return p?.stickyItems??[]},subscribe:u.subscribe,[Symbol.dispose]:S,get totalSize(){return p?.totalSize??0}}}function o(e,t){let n=document.createElement(`div`);n.style.cssText=t.horizontal?`overflow: auto hidden; width: 100%; height: 100%;`:`overflow: hidden auto; width: 100%; height: 100%;`,t.containerClass&&(n.className=t.containerClass);let r=document.createElement(`div`);n.appendChild(r),e.appendChild(n);let i;try{i=a({...t,listElement:r,scrollElement:n})}catch(e){throw n.remove(),e}let o=i.dispose.bind(i);return Object.assign(i,{dispose(){o(),n.remove()},[Symbol.dispose](){o(),n.remove()}})}exports.createDomVirtualList=a,exports.createVirtualScroller=o;
 //# sourceMappingURL=dom-virtual-list.cjs.map

package/dist/dom-virtual-list.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dom-virtual-list.cjs","names":[],"sources":["../src/dom-virtual-list.ts"],"sourcesContent":["import type { Signal } from '@vielzeug/ripple';\n\nimport { DEFAULT_ESTIMATE_SIZE, DEFAULT_OVERSCAN, type MeasurementCache, type Overscan } from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\nimport { ScrollConfigurationError, ScrollRangeError } from './errors';\nimport {\n  createVirtualizer,\n  type ScrollToIndexOptions,\n  type VirtualItem,\n  type Virtualizer,\n  type VirtualizerState,\n  type VirtualKey,\n} from './virtualizer';\n\nexport type {\n  MeasurementCache,\n  Overscan,\n  ScrollToIndexOptions,\n  VirtualItem,\n  Virtualizer,\n  VirtualizerState,\n  VirtualKey,\n};\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/** A `VirtualItem` enriched with the corresponding data record. */\nexport type VirtualRenderItem<T> = VirtualItem & { readonly data: T };\n\n/**\n * Recycle a DOM node by key. If the pool has a live node for `key`, it is\n * returned and reused; otherwise `create()` is called to produce a new one.\n */\nexport type RecycleFn = (key: VirtualKey, create: () => HTMLElement) => HTMLElement;\n\nexport type DomVirtualListRenderArgs<T> = {\n  items: Array<VirtualRenderItem<T>>;\n  listEl: HTMLElement;\n  recycle: RecycleFn;\n  /** Sticky items from the underlying virtualizer, enriched with data. */\n  stickyItems: Array<VirtualRenderItem<T>>;\n  totalSize: number;\n};\n\nexport type StickToBottomOptions = {\n  /** Enable/disable the behavior. Default: `true` once this object is provided. */\n  enabled?: boolean;\n  /**\n   * Distance in pixels from the end still considered \"at the end\" — the bottom edge in\n   * vertical mode, the trailing edge in horizontal mode. Default: `48`.\n   */\n  threshold?: number;\n};\n\nexport type DomVirtualListOptions<T> = {\n  /** Custom teardown that clears listEl. Defaults to `listEl.textContent = ''`. */\n  clear?: (listEl: HTMLElement) => void;\n  estimateSize?: number | ((index: number, item: T) => number);\n  gap?: number;\n  getItemKey?: (index: number, item: T) => VirtualKey;\n  horizontal?: boolean;\n  /** Enable keyboard navigation (Arrow/Page/Home/End keys). */\n  keyboardScroll?: boolean;\n  listElement: HTMLElement;\n  /** External measurement cache for scroll restoration. */\n  measurementCache?: MeasurementCache;\n  overscan?: Overscan;\n  render: (args: DomVirtualListRenderArgs<T>) => void;\n  scrollElement: HTMLElement | Window;\n  /**\n   * Auto-scroll to the end after `setItems()` whenever the list was already at (or near) the\n   * end just before the update — the chat \"stick to bottom on new message\" pattern. Fires on\n   * *any* update while at the end, not just growth, so it also follows a streaming last\n   * item that grows in place without changing `items.length`. Does nothing while the user\n   * has scrolled away from the end. Pass `true` for defaults, or an options object.\n   */\n  stickToBottom?: boolean | StickToBottomOptions;\n  /** Mark items as sticky headers. Receives the item index and the item data. */\n  sticky?: (index: number, item: T) => boolean;\n  /** Optional signal factory for reactive state. */\n  toSignal?: (init: VirtualizerState) => Signal<VirtualizerState>;\n};\n\n/**\n * R11: Controller extends Virtualizer so all methods (scrollToIndex, refresh,\n * scrollToOffset, etc.) are accessible directly on the controller without\n * needing to unwrap an inner virtualizer handle.\n *\n * `prepend` and `update` are omitted — use `setItems()` for item updates and\n * there is no direct `prepend` concept in DomVirtualList.\n */\nexport type DomVirtualListController<T> = Omit<Virtualizer, 'prepend' | 'update'> & {\n  setItems: (items: T[]) => void;\n};\n\nexport type VirtualScrollerOptions<T> = Omit<DomVirtualListOptions<T>, 'listElement' | 'scrollElement'> & {\n  /** Additional CSS class names on the generated scroll container. */\n  containerClass?: string;\n};\n\n// ─── Node pool ────────────────────────────────────────────────────────────────\n\nfunction createNodePool() {\n  let live = new Map<VirtualKey, HTMLElement>();\n  let nextLive = new Map<VirtualKey, HTMLElement>();\n  const stale: HTMLElement[] = [];\n  let inCycle = false;\n\n  return {\n    acquire(key: VirtualKey, create: () => HTMLElement): HTMLElement {\n      if (!inCycle) return create();\n\n      const existing = live.get(key);\n\n      if (existing) {\n        nextLive.set(key, existing);\n\n        return existing;\n      }\n\n      const node = stale.pop() ?? create();\n\n      nextLive.set(key, node);\n\n      return node;\n    },\n\n    beginCycle(): void {\n      nextLive = new Map();\n      inCycle = true;\n    },\n\n    clear(): void {\n      for (const node of live.values()) node.remove();\n\n      live.clear();\n      nextLive.clear();\n      stale.length = 0;\n      inCycle = false;\n    },\n\n    endCycle(): void {\n      if (!inCycle) return;\n\n      inCycle = false;\n\n      for (const [key, node] of live) {\n        if (!nextLive.has(key)) {\n          node.remove();\n          stale.push(node);\n        }\n      }\n\n      live = nextLive;\n    },\n  };\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createDomVirtualList<T>(options: DomVirtualListOptions<T>): DomVirtualListController<T> {\n  if (typeof options.estimateSize === 'number') requirePositiveNumber(options.estimateSize, 'estimateSize');\n\n  if (options.gap !== undefined) requireNonNegativeInteger(options.gap, 'gap');\n\n  if (options.overscan !== undefined) validateOverscan(options.overscan);\n\n  if (options.stickToBottom !== undefined && typeof options.stickToBottom !== 'boolean') {\n    if (options.stickToBottom === null || Array.isArray(options.stickToBottom)) {\n      throw new ScrollConfigurationError('stickToBottom must be a boolean or options object.');\n    }\n\n    if (options.stickToBottom.threshold !== undefined) {\n      requireNonNegativeNumber(options.stickToBottom.threshold, 'stickToBottom.threshold');\n    }\n  }\n\n  let currentItems: T[] = [];\n  let disposed = false;\n  const ac = new AbortController();\n  const listEl = options.listElement;\n\n  // Optional signal for reactive state\n  let stateSignal: Signal<VirtualizerState> | null = null;\n  if (options.toSignal) {\n    const initialState: VirtualizerState = { items: [], stickyItems: [], totalSize: 0 };\n    stateSignal = options.toSignal(initialState);\n  }\n\n  // Helper to emit state to both callback and signal\n  function emitState(state: VirtualizerState): void {\n    if (stateSignal) stateSignal.value = state;\n    handleChange(state);\n  }\n\n  // Pool must be declared before virtualizer since handleChange (passed as onChange)\n  // is invoked during createVirtualizer initialization via computeVisible.\n  const pool = createNodePool();\n\n  // Virtualizer is lazily created on the first non-empty setItems call.\n  let virtualizer: Virtualizer | null = null;\n\n  function resolveKey(index: number): VirtualKey {\n    const item = currentItems[index];\n\n    if (item !== undefined && options.getItemKey) return options.getItemKey(index, item);\n\n    return index;\n  }\n\n  function resolveEstimate(index: number): number {\n    if (options.estimateSize === undefined) return DEFAULT_ESTIMATE_SIZE;\n\n    if (typeof options.estimateSize === 'number') return options.estimateSize;\n\n    const item = currentItems[index];\n\n    return item !== undefined ? options.estimateSize(index, item) : DEFAULT_ESTIMATE_SIZE;\n  }\n\n  function applyListSize(totalSize: number): void {\n    if (options.horizontal) {\n      listEl.style.height = '';\n      listEl.style.width = `${totalSize}px`;\n    } else {\n      listEl.style.height = `${totalSize}px`;\n      listEl.style.width = '';\n    }\n  }\n\n  /**\n   * R10: Throw rather than silently produce `undefined as T`.\n   * This catches bugs where `vi.index` is out of range for `currentItems`.\n   */\n  function toRenderItem(vi: VirtualItem): VirtualRenderItem<T> {\n    const data = currentItems[vi.index];\n\n    if (data === undefined) {\n      throw new ScrollRangeError(\n        `toRenderItem: index ${vi.index} is out of range (currentItems.length=${currentItems.length})`,\n      );\n    }\n\n    return { ...vi, data };\n  }\n\n  function handleChange(state: VirtualizerState): void {\n    applyListSize(state.totalSize);\n\n    pool.beginCycle();\n\n    // R5: try/finally ensures endCycle() runs even if render() throws, keeping\n    // the pool in a consistent state.\n    try {\n      options.render({\n        items: state.items.map(toRenderItem),\n        listEl,\n        recycle: (key, create) => pool.acquire(key, create),\n        stickyItems: state.stickyItems.map(toRenderItem),\n        totalSize: state.totalSize,\n      });\n    } finally {\n      pool.endCycle();\n    }\n  }\n\n  function clearAndReset(): void {\n    pool.clear();\n\n    if (options.clear) {\n      options.clear(listEl);\n    } else {\n      listEl.textContent = '';\n    }\n\n    listEl.style.height = '';\n    listEl.style.width = '';\n    listEl.style.position = '';\n    listEl.style.contain = '';\n  }\n\n  const DEFAULT_STICK_THRESHOLD = 48;\n\n  function resolveStickToBottom(): { enabled: boolean; threshold: number } {\n    const opt = options.stickToBottom;\n\n    if (!opt) return { enabled: false, threshold: DEFAULT_STICK_THRESHOLD };\n\n    if (opt === true) return { enabled: true, threshold: DEFAULT_STICK_THRESHOLD };\n\n    return { enabled: opt.enabled ?? true, threshold: opt.threshold ?? DEFAULT_STICK_THRESHOLD };\n  }\n\n  function spawnVirtualizer(): Virtualizer {\n    const v = createVirtualizer(options.scrollElement, {\n      count: currentItems.length,\n      estimateSize: resolveEstimate,\n      gap: options.gap,\n      getItemKey: resolveKey,\n      horizontal: options.horizontal,\n      keyboardScroll: options.keyboardScroll,\n      measurementCache: options.measurementCache,\n      onChange: emitState,\n      overscan: options.overscan ?? DEFAULT_OVERSCAN,\n      sticky: options.sticky\n        ? (index) => {\n            const item = currentItems[index];\n\n            return item !== undefined && options.sticky!(index, item);\n          }\n        : undefined,\n    });\n\n    virtualizer = v;\n    listEl.style.position = 'relative';\n    listEl.style.contain = 'layout';\n\n    return v;\n  }\n\n  function _dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    ac.abort();\n    virtualizer?.dispose();\n    virtualizer = null;\n    clearAndReset();\n  }\n\n  return {\n    // ── Virtualizer passthrough (R11) ──────────────────────────────────────\n    get count() {\n      return virtualizer?.count ?? 0;\n    },\n\n    get disposalSignal() {\n      return ac.signal;\n    },\n\n    dispose: _dispose,\n\n    get disposed() {\n      return disposed;\n    },\n\n    invalidate() {\n      if (disposed) return;\n\n      virtualizer?.invalidate();\n    },\n\n    isAtEnd(threshold) {\n      return virtualizer?.isAtEnd(threshold) ?? true;\n    },\n\n    get isScrolling() {\n      return virtualizer?.isScrolling ?? false;\n    },\n\n    get items() {\n      return virtualizer?.items ?? [];\n    },\n\n    measure(index, size) {\n      if (disposed) return;\n\n      virtualizer?.measure(index, size);\n    },\n\n    measureBatch(entries) {\n      if (disposed) return;\n\n      virtualizer?.measureBatch(entries);\n    },\n\n    measureEl(index, el) {\n      if (disposed) return () => {};\n\n      return virtualizer?.measureEl(index, el) ?? (() => {});\n    },\n\n    refresh() {\n      if (disposed) return;\n\n      virtualizer?.refresh();\n    },\n\n    get scrollOffset() {\n      return virtualizer?.scrollOffset ?? 0;\n    },\n\n    scrollToBottom(scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToBottom(scrollOptions);\n    },\n\n    scrollToIndex(index, scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToIndex(index, scrollOptions);\n    },\n\n    scrollToOffset(offset, scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToOffset(offset, scrollOptions);\n    },\n\n    scrollToTop(scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToTop(scrollOptions);\n    },\n\n    // ── DomVirtualList-specific ────────────────────────────────────────────\n    setItems(items) {\n      if (disposed) return;\n\n      // Read *before* mutating state — the \"was the list already at the end?\" check must\n      // reflect the pre-update layout, not the one `render()` is about to produce below.\n      const stick = resolveStickToBottom();\n      const wasAtEnd = stick.enabled && (virtualizer?.isAtEnd(stick.threshold) ?? true);\n\n      currentItems = items;\n\n      if (items.length === 0) {\n        virtualizer?.dispose();\n        virtualizer = null;\n        clearAndReset();\n\n        return;\n      }\n\n      if (!virtualizer) {\n        const v = spawnVirtualizer();\n\n        if (wasAtEnd) v.scrollToBottom();\n\n        return;\n      }\n\n      const countChanged = items.length !== virtualizer.count;\n\n      // Only count needs explicit update — estimateSize and getItemKey are\n      // closures that already reflect the latest currentItems automatically.\n      virtualizer.update({ count: items.length });\n\n      // When count changed, update() already triggered rebuild + computeVisible().\n      // Only force re-emission when count is unchanged (data changed, count same).\n      if (!countChanged) {\n        // refresh() re-emits with current sizes for stable keys;\n        // invalidate() clears position-based measurements when no stable keys.\n        if (options.getItemKey) {\n          virtualizer.refresh();\n        } else {\n          virtualizer.invalidate();\n        }\n      } else if (!options.getItemKey) {\n        // Count changed AND no stable keys: position-based measurements are now\n        // stale. Clear them so the next render remeasures from fresh estimates.\n        virtualizer.invalidate();\n      }\n\n      if (wasAtEnd) virtualizer.scrollToBottom();\n    },\n\n    get stickyItems() {\n      return virtualizer?.stickyItems ?? [];\n    },\n\n    [Symbol.dispose]: _dispose,\n\n    get totalSize() {\n      return virtualizer?.totalSize ?? 0;\n    },\n  };\n}\n\n// ─── F5: createVirtualScroller ────────────────────────────────────────────────\n\n/**\n * High-level factory that creates the scroll container and inner list element,\n * appends them to `container`, and returns a fully wired `DomVirtualListController`.\n *\n * @example\n * ```ts\n * const list = createVirtualScroller(document.getElementById('root')!, {\n *   render({ items, listEl, recycle }) { … },\n * });\n * list.setItems(data);\n * ```\n */\nexport function createVirtualScroller<T>(\n  container: HTMLElement,\n  options: VirtualScrollerOptions<T>,\n): DomVirtualListController<T> {\n  const scrollEl = document.createElement('div');\n\n  scrollEl.style.cssText = options.horizontal\n    ? 'overflow: auto hidden; width: 100%; height: 100%;'\n    : 'overflow: hidden auto; width: 100%; height: 100%;';\n\n  if (options.containerClass) scrollEl.className = options.containerClass;\n\n  const listEl = document.createElement('div');\n\n  scrollEl.appendChild(listEl);\n  container.appendChild(scrollEl);\n\n  let ctrl: DomVirtualListController<T>;\n\n  try {\n    ctrl = createDomVirtualList<T>({\n      ...options,\n      listElement: listEl,\n      scrollElement: scrollEl,\n    });\n  } catch (e) {\n    // Remove the scroll container if construction fails so we don't leak DOM nodes.\n    scrollEl.remove();\n    throw e;\n  }\n\n  // Override dispose and [Symbol.dispose] to also remove the scroll container.\n  // Capture the original dispose before overwriting so there's no self-reference.\n  const innerDispose = ctrl.dispose.bind(ctrl);\n\n  return Object.assign(ctrl, {\n    dispose() {\n      innerDispose();\n      scrollEl.remove();\n    },\n    [Symbol.dispose]() {\n      innerDispose();\n      scrollEl.remove();\n    },\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"dom-virtual-list.cjs","names":[],"sources":["../src/dom-virtual-list.ts"],"sourcesContent":["import {\n  createSnapshotStore,\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  type MeasurementCache,\n  type Overscan,\n} from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\nimport { ScrollConfigError, ScrollRangeError } from './errors';\nimport {\n  createVirtualizer,\n  type ScrollToIndexOptions,\n  type VirtualItem,\n  type Virtualizer,\n  type VirtualizerState,\n  type VirtualKey,\n} from './virtualizer';\n\nexport type {\n  MeasurementCache,\n  Overscan,\n  ScrollToIndexOptions,\n  VirtualItem,\n  Virtualizer,\n  VirtualizerState,\n  VirtualKey,\n};\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/** A `VirtualItem` enriched with the corresponding data record. */\nexport type VirtualRenderItem<T> = VirtualItem & { readonly data: T };\n\n/**\n * Recycle a DOM node by key. If the pool has a live node for `key`, it is\n * returned and reused; otherwise `create()` is called to produce a new one.\n */\nexport type RecycleFn = (key: VirtualKey, create: () => HTMLElement) => HTMLElement;\n\nexport type DomVirtualListRenderArgs<T> = {\n  items: Array<VirtualRenderItem<T>>;\n  listEl: HTMLElement;\n  recycle: RecycleFn;\n  /** Sticky items from the underlying virtualizer, enriched with data. */\n  stickyItems: Array<VirtualRenderItem<T>>;\n  totalSize: number;\n};\n\nexport type StickToBottomOptions = {\n  /** Enable/disable the behavior. Default: `true` once this object is provided. */\n  enabled?: boolean;\n  /**\n   * Distance in pixels from the end still considered \"at the end\" — the bottom edge in\n   * vertical mode, the trailing edge in horizontal mode. Default: `48`.\n   */\n  threshold?: number;\n};\n\nexport type DomVirtualListOptions<T> = {\n  /** Custom teardown that clears listEl. Defaults to `listEl.textContent = ''`. */\n  clear?: (listEl: HTMLElement) => void;\n  estimateSize?: number | ((index: number, item: T) => number);\n  gap?: number;\n  getItemKey?: (index: number, item: T) => VirtualKey;\n  horizontal?: boolean;\n  listElement: HTMLElement;\n  /** External measurement cache for scroll restoration. */\n  measurementCache?: MeasurementCache;\n  overscan?: Overscan;\n  render: (args: DomVirtualListRenderArgs<T>) => void;\n  scrollElement: HTMLElement | Window;\n  /**\n   * Auto-scroll to the end after `setItems()` whenever the list was already at (or near) the\n   * end just before the update — the chat \"stick to bottom on new message\" pattern. Fires on\n   * *any* update while at the end, not just growth, so it also follows a streaming last\n   * item that grows in place without changing `items.length`. Does nothing while the user\n   * has scrolled away from the end. Pass `true` for defaults, or an options object.\n   */\n  stickToBottom?: boolean | StickToBottomOptions;\n  /** Mark items as sticky headers. Receives the item index and the item data. */\n  sticky?: (index: number, item: T) => boolean;\n};\n\n/**\n * R11: Controller extends Virtualizer so all methods (scrollToIndex, refresh,\n * scrollToOffset, etc.) are accessible directly on the controller without\n * needing to unwrap an inner virtualizer handle.\n *\n * `prepend` and `update` are omitted — use `setItems()` for item updates and\n * there is no direct `prepend` concept in DomVirtualList.\n */\nexport type DomVirtualListController<T> = Omit<Virtualizer, 'prepend' | 'update'> & {\n  setItems: (items: T[]) => void;\n};\n\nexport type VirtualScrollerOptions<T> = Omit<DomVirtualListOptions<T>, 'listElement' | 'scrollElement'> & {\n  /** Additional CSS class names on the generated scroll container. */\n  containerClass?: string;\n};\n\n// ─── Node pool ────────────────────────────────────────────────────────────────\n\nfunction createNodePool() {\n  let live = new Map<VirtualKey, HTMLElement>();\n  let nextLive = new Map<VirtualKey, HTMLElement>();\n  const stale: HTMLElement[] = [];\n  let inCycle = false;\n\n  return {\n    acquire(key: VirtualKey, create: () => HTMLElement): HTMLElement {\n      if (!inCycle) return create();\n\n      const existing = live.get(key);\n\n      if (existing) {\n        nextLive.set(key, existing);\n\n        return existing;\n      }\n\n      const node = stale.pop() ?? create();\n\n      nextLive.set(key, node);\n\n      return node;\n    },\n\n    beginCycle(): void {\n      nextLive = new Map();\n      inCycle = true;\n    },\n\n    clear(): void {\n      for (const node of live.values()) node.remove();\n\n      live.clear();\n      nextLive.clear();\n      stale.length = 0;\n      inCycle = false;\n    },\n\n    endCycle(): void {\n      if (!inCycle) return;\n\n      inCycle = false;\n\n      for (const [key, node] of live) {\n        if (!nextLive.has(key)) {\n          node.remove();\n          stale.push(node);\n        }\n      }\n\n      live = nextLive;\n    },\n  };\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createDomVirtualList<T>(options: DomVirtualListOptions<T>): DomVirtualListController<T> {\n  if (typeof options.estimateSize === 'number') requirePositiveNumber(options.estimateSize, 'estimateSize');\n\n  if (options.gap !== undefined) requireNonNegativeInteger(options.gap, 'gap');\n\n  if (options.overscan !== undefined) validateOverscan(options.overscan);\n\n  if (options.stickToBottom !== undefined && typeof options.stickToBottom !== 'boolean') {\n    if (options.stickToBottom === null || Array.isArray(options.stickToBottom)) {\n      throw new ScrollConfigError('stickToBottom must be a boolean or options object.');\n    }\n\n    if (options.stickToBottom.threshold !== undefined) {\n      requireNonNegativeNumber(options.stickToBottom.threshold, 'stickToBottom.threshold');\n    }\n  }\n\n  let currentItems: T[] = [];\n  let disposed = false;\n  const ac = new AbortController();\n  const listEl = options.listElement;\n  const stateStore = createSnapshotStore<VirtualizerState>({ items: [], stickyItems: [], totalSize: 0 });\n\n  // Publish state before invoking the render callback.\n  function emitState(state: VirtualizerState): void {\n    stateStore.publish(state);\n    handleChange(state);\n  }\n\n  // Pool must be declared before virtualizer since handleChange (passed as onChange)\n  // is invoked during createVirtualizer initialization via computeVisible.\n  const pool = createNodePool();\n\n  // Virtualizer is lazily created on the first non-empty setItems call.\n  let virtualizer: Virtualizer | null = null;\n\n  function resolveKey(index: number): VirtualKey {\n    const item = currentItems[index];\n\n    if (item !== undefined && options.getItemKey) return options.getItemKey(index, item);\n\n    return index;\n  }\n\n  function resolveEstimate(index: number): number {\n    if (options.estimateSize === undefined) return DEFAULT_ESTIMATE_SIZE;\n\n    if (typeof options.estimateSize === 'number') return options.estimateSize;\n\n    const item = currentItems[index];\n\n    return item !== undefined ? options.estimateSize(index, item) : DEFAULT_ESTIMATE_SIZE;\n  }\n\n  function applyListSize(totalSize: number): void {\n    if (options.horizontal) {\n      listEl.style.height = '';\n      listEl.style.width = `${totalSize}px`;\n    } else {\n      listEl.style.height = `${totalSize}px`;\n      listEl.style.width = '';\n    }\n  }\n\n  /**\n   * R10: Throw rather than silently produce `undefined as T`.\n   * This catches bugs where `vi.index` is out of range for `currentItems`.\n   */\n  function toRenderItem(vi: VirtualItem): VirtualRenderItem<T> {\n    const data = currentItems[vi.index];\n\n    if (data === undefined) {\n      throw new ScrollRangeError(\n        `toRenderItem: index ${vi.index} is out of range (currentItems.length=${currentItems.length})`,\n      );\n    }\n\n    return { ...vi, data };\n  }\n\n  function handleChange(state: VirtualizerState): void {\n    applyListSize(state.totalSize);\n\n    pool.beginCycle();\n\n    // R5: try/finally ensures endCycle() runs even if render() throws, keeping\n    // the pool in a consistent state.\n    try {\n      options.render({\n        items: state.items.map(toRenderItem),\n        listEl,\n        recycle: (key, create) => pool.acquire(key, create),\n        stickyItems: state.stickyItems.map(toRenderItem),\n        totalSize: state.totalSize,\n      });\n    } finally {\n      pool.endCycle();\n    }\n  }\n\n  function clearAndReset(): void {\n    pool.clear();\n\n    if (options.clear) {\n      options.clear(listEl);\n    } else {\n      listEl.textContent = '';\n    }\n\n    listEl.style.height = '';\n    listEl.style.width = '';\n    listEl.style.position = '';\n    listEl.style.contain = '';\n  }\n\n  const DEFAULT_STICK_THRESHOLD = 48;\n\n  function resolveStickToBottom(): { enabled: boolean; threshold: number } {\n    const opt = options.stickToBottom;\n\n    if (!opt) return { enabled: false, threshold: DEFAULT_STICK_THRESHOLD };\n\n    if (opt === true) return { enabled: true, threshold: DEFAULT_STICK_THRESHOLD };\n\n    return { enabled: opt.enabled ?? true, threshold: opt.threshold ?? DEFAULT_STICK_THRESHOLD };\n  }\n\n  function spawnVirtualizer(): Virtualizer {\n    const v = createVirtualizer(options.scrollElement, {\n      count: currentItems.length,\n      estimateSize: resolveEstimate,\n      gap: options.gap,\n      getItemKey: resolveKey,\n      horizontal: options.horizontal,\n      measurementCache: options.measurementCache,\n      onChange: emitState,\n      overscan: options.overscan ?? DEFAULT_OVERSCAN,\n      sticky: options.sticky\n        ? (index) => {\n            const item = currentItems[index];\n\n            return item !== undefined && options.sticky!(index, item);\n          }\n        : undefined,\n    });\n\n    virtualizer = v;\n    listEl.style.position = 'relative';\n    listEl.style.contain = 'layout';\n\n    return v;\n  }\n\n  function _dispose(): void {\n    if (disposed) return;\n\n    disposed = true;\n    stateStore.dispose();\n    ac.abort();\n    virtualizer?.dispose();\n    virtualizer = null;\n    clearAndReset();\n  }\n\n  return {\n    // ── Virtualizer passthrough (R11) ──────────────────────────────────────\n    get count() {\n      return virtualizer?.count ?? 0;\n    },\n\n    get disposalSignal() {\n      return ac.signal;\n    },\n\n    dispose: _dispose,\n\n    get disposed() {\n      return disposed;\n    },\n\n    getSnapshot: stateStore.getSnapshot,\n\n    invalidate() {\n      if (disposed) return;\n\n      virtualizer?.invalidate();\n    },\n\n    isAtEnd(threshold) {\n      return virtualizer?.isAtEnd(threshold) ?? true;\n    },\n\n    get isScrolling() {\n      return virtualizer?.isScrolling ?? false;\n    },\n\n    get items() {\n      return virtualizer?.items ?? [];\n    },\n\n    measure(index, size) {\n      if (disposed) return;\n\n      virtualizer?.measure(index, size);\n    },\n\n    measureBatch(entries) {\n      if (disposed) return;\n\n      virtualizer?.measureBatch(entries);\n    },\n\n    measureEl(index, el) {\n      if (disposed) return () => {};\n\n      return virtualizer?.measureEl(index, el) ?? (() => {});\n    },\n\n    refresh() {\n      if (disposed) return;\n\n      virtualizer?.refresh();\n    },\n\n    remeasure() {\n      if (disposed) return;\n\n      virtualizer?.remeasure();\n    },\n\n    get scrollOffset() {\n      return virtualizer?.scrollOffset ?? 0;\n    },\n\n    scrollToBottom(scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToBottom(scrollOptions);\n    },\n\n    scrollToIndex(index, scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToIndex(index, scrollOptions);\n    },\n\n    scrollToOffset(offset, scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToOffset(offset, scrollOptions);\n    },\n\n    scrollToTop(scrollOptions) {\n      if (disposed) return;\n\n      virtualizer?.scrollToTop(scrollOptions);\n    },\n\n    // ── DomVirtualList-specific ────────────────────────────────────────────\n    setItems(items) {\n      if (disposed) return;\n\n      // Read *before* mutating state — the \"was the list already at the end?\" check must\n      // reflect the pre-update layout, not the one `render()` is about to produce below.\n      const stick = resolveStickToBottom();\n      const wasAtEnd = stick.enabled && (virtualizer?.isAtEnd(stick.threshold) ?? true);\n\n      currentItems = items;\n\n      if (items.length === 0) {\n        virtualizer?.dispose();\n        virtualizer = null;\n        stateStore.publish({ items: [], stickyItems: [], totalSize: 0 });\n        clearAndReset();\n\n        return;\n      }\n\n      if (!virtualizer) {\n        const v = spawnVirtualizer();\n\n        if (wasAtEnd) v.scrollToBottom();\n\n        return;\n      }\n\n      const countChanged = items.length !== virtualizer.count;\n\n      // Only count needs explicit update — estimateSize and getItemKey are\n      // closures that already reflect the latest currentItems automatically.\n      virtualizer.update({ count: items.length });\n\n      // When count changed, update() already triggered rebuild + computeVisible().\n      // Only force re-emission when count is unchanged (data changed, count same).\n      if (!countChanged) {\n        // refresh() re-emits with current sizes for stable keys;\n        // invalidate() clears position-based measurements when no stable keys.\n        if (options.getItemKey) {\n          virtualizer.refresh();\n        } else {\n          virtualizer.invalidate();\n        }\n      } else if (!options.getItemKey) {\n        // Count changed AND no stable keys: position-based measurements are now\n        // stale. Clear them so the next render remeasures from fresh estimates.\n        virtualizer.invalidate();\n      }\n\n      if (wasAtEnd) virtualizer.scrollToBottom();\n    },\n\n    get stickyItems() {\n      return virtualizer?.stickyItems ?? [];\n    },\n\n    subscribe: stateStore.subscribe,\n\n    [Symbol.dispose]: _dispose,\n\n    get totalSize() {\n      return virtualizer?.totalSize ?? 0;\n    },\n  };\n}\n\n// ─── F5: createVirtualScroller ────────────────────────────────────────────────\n\n/**\n * High-level factory that creates the scroll container and inner list element,\n * appends them to `container`, and returns a fully wired `DomVirtualListController`.\n *\n * @example\n * ```ts\n * const list = createVirtualScroller(document.getElementById('root')!, {\n *   render({ items, listEl, recycle }) { … },\n * });\n * list.setItems(data);\n * ```\n */\nexport function createVirtualScroller<T>(\n  container: HTMLElement,\n  options: VirtualScrollerOptions<T>,\n): DomVirtualListController<T> {\n  const scrollEl = document.createElement('div');\n\n  scrollEl.style.cssText = options.horizontal\n    ? 'overflow: auto hidden; width: 100%; height: 100%;'\n    : 'overflow: hidden auto; width: 100%; height: 100%;';\n\n  if (options.containerClass) scrollEl.className = options.containerClass;\n\n  const listEl = document.createElement('div');\n\n  scrollEl.appendChild(listEl);\n  container.appendChild(scrollEl);\n\n  let ctrl: DomVirtualListController<T>;\n\n  try {\n    ctrl = createDomVirtualList<T>({\n      ...options,\n      listElement: listEl,\n      scrollElement: scrollEl,\n    });\n  } catch (e) {\n    // Remove the scroll container if construction fails so we don't leak DOM nodes.\n    scrollEl.remove();\n    throw e;\n  }\n\n  // Override dispose and [Symbol.dispose] to also remove the scroll container.\n  // Capture the original dispose before overwriting so there's no self-reference.\n  const innerDispose = ctrl.dispose.bind(ctrl);\n\n  return Object.assign(ctrl, {\n    dispose() {\n      innerDispose();\n      scrollEl.remove();\n    },\n    [Symbol.dispose]() {\n      innerDispose();\n      scrollEl.remove();\n    },\n  });\n}\n"],"mappings":"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"}