@vielzeug/scroll 1.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom-virtual-list.js","names":[],"sources":["../src/dom-virtual-list.ts"],"sourcesContent":["import { DEFAULT_ESTIMATE_SIZE, DEFAULT_OVERSCAN, type MeasurementCache, type Overscan } from './_utils';\nimport { 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 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  /** 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  let currentItems: T[] = [];\n  let isDestroyed = false;\n  const ac = new AbortController();\n  const listEl = options.listElement;\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  function spawnVirtualizer(): void {\n    virtualizer = 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: handleChange,\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    listEl.style.position = 'relative';\n    listEl.style.contain = 'layout';\n  }\n\n  function _dispose(): void {\n    if (isDestroyed) return;\n\n    isDestroyed = 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 isDestroyed;\n    },\n\n    invalidate() {\n      if (isDestroyed) return;\n\n      virtualizer?.invalidate();\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 (isDestroyed) return;\n\n      virtualizer?.measure(index, size);\n    },\n\n    measureBatch(entries) {\n      if (isDestroyed) return;\n\n      virtualizer?.measureBatch(entries);\n    },\n\n    measureEl(index, el) {\n      if (isDestroyed) return () => {};\n\n      return virtualizer?.measureEl(index, el) ?? (() => {});\n    },\n\n    refresh() {\n      if (isDestroyed) return;\n\n      virtualizer?.refresh();\n    },\n\n    get scrollOffset() {\n      return virtualizer?.scrollOffset ?? 0;\n    },\n\n    scrollToBottom(scrollOptions) {\n      if (isDestroyed) return;\n\n      virtualizer?.scrollToBottom(scrollOptions);\n    },\n\n    scrollToIndex(index, scrollOptions) {\n      if (isDestroyed) return;\n\n      virtualizer?.scrollToIndex(index, scrollOptions);\n    },\n\n    scrollToOffset(offset, scrollOptions) {\n      if (isDestroyed) return;\n\n      virtualizer?.scrollToOffset(offset, scrollOptions);\n    },\n\n    scrollToTop(scrollOptions) {\n      if (isDestroyed) return;\n\n      virtualizer?.scrollToTop(scrollOptions);\n    },\n\n    // ── DomVirtualList-specific ────────────────────────────────────────────\n    setItems(items) {\n      if (isDestroyed) return;\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        spawnVirtualizer();\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\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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"}

package/dist/errors.cjs

@@ -0,0 +1,2 @@
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{};exports.ScrollError=e,exports.ScrollRangeError=t;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all scroll errors. */\nexport class ScrollError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ScrollError {\n    return err instanceof ScrollError;\n  }\n}\n\n/** Thrown when a virtual-list index is out of bounds. */\nexport class ScrollRangeError extends ScrollError {}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAoB,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAkC,CAC1C,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAsC,CAAY,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+/** Base class for all scroll errors. */
+export declare class ScrollError extends Error {
+    constructor(message: string, opts?: ErrorOptions);
+    static is(err: unknown): err is ScrollError;
+}
+/** Thrown when a virtual-list index is out of bounds. */
+export declare class ScrollRangeError extends ScrollError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;IAMhD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW;CAG5C;AAED,yDAAyD;AACzD,qBAAa,gBAAiB,SAAQ,WAAW;CAAG"}

package/dist/errors.js

@@ -0,0 +1,2 @@
+var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{};export{e as ScrollError,t as ScrollRangeError};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all scroll errors. */\nexport class ScrollError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  static is(err: unknown): err is ScrollError {\n    return err instanceof ScrollError;\n  }\n}\n\n/** Thrown when a virtual-list index is out of bounds. */\nexport class ScrollRangeError extends ScrollError {}\n"],"mappings":"AACA,IAAa,EAAb,MAAa,UAAoB,KAAM,CACrC,YAAY,EAAiB,EAAqB,CAChD,MAAM,EAAS,CAAI,EACnB,KAAK,KAAO,IAAI,OAAO,KACvB,OAAO,eAAe,KAAM,IAAI,OAAO,SAAS,CAClD,CAEA,OAAO,GAAG,EAAkC,CAC1C,OAAO,aAAe,CACxB,CACF,EAGa,EAAb,cAAsC,CAAY,CAAC"}

package/dist/grid-virtualizer.cjs

@@ -0,0 +1,2 @@
+const e=require("./_utils.cjs"),t=require("./_adapter.cjs"),n=require("./_axis1d.cjs");function r(e,t,n,r,i,a){return a===`start`?e:a===`end`?t-i:a===`center`?e-(i-n)/2:e>=r&&t<=r+i?null:e<r?e:t-i}function i(i,a){let o=e.toNonNegativeInt(a.rowCount),s=e.toNonNegativeInt(a.colCount),c=e.resolveEstimateFn(a.estimateRowSize,36),l=e.resolveEstimateFn(a.estimateColSize,36),u=e.normalizeOverscan(a.overscanY,3),d=e.normalizeOverscan(a.overscanX,3),f=a.onChange,p=a.onRangeChange,m=a.rowMeasurementCache??new Map,h=a.colMeasurementCache??new Map,g=0,_=0,v=0,y=0,b=[],x=[],S=!1,C=n.createAxis1D(o,e=>m.get(e)??c(e),e.toNonNegativeInt(a.rowGap??0)),w=n.createAxis1D(s,e=>h.get(e)??l(e),e.toNonNegativeInt(a.colGap??0)),T=!1;function E(e){let t=Number.isFinite(e)?e:0;return Math.min(Math.max(0,C.totalSize-v),Math.max(0,t))}function D(e){let t=Number.isFinite(e)?e:0;return Math.min(Math.max(0,w.totalSize-y),Math.max(0,t))}function O(){if(S)return;let e=C.totalSize,t=w.totalSize;if(o===0||s===0||v<=0||y<=0){C.prevStart===-1&&C.prevTotalSize===e&&w.prevTotalSize===t||(C.commitDedup(-1,-1),w.commitDedup(-1,-1),b=[],x=[],f?.({cols:[],rows:[],totalHeight:e,totalWidth:t}));return}let{renderEnd:n,renderStart:r}=C.computeRange(g,g+v,u.start,u.end),{renderEnd:i,renderStart:a}=w.computeRange(_,_+y,d.start,d.end),c=C.isDedupSame(r,n),l=w.isDedupSame(a,i);if(c&&l)return;C.commitDedup(r,n),w.commitDedup(a,i),(!c||!l)&&p&&p({firstCol:a,firstRow:r,lastCol:i,lastRow:n});let m=[];for(let e=r;e<=n;e++)m.push(C.itemAt(e));let h=[];for(let e=a;e<=i;e++)h.push(w.itemAt(e));b=m,x=h,f?.({cols:x,rows:b,totalHeight:e,totalWidth:t})}function k(t,n){if(!Number.isFinite(t))return!1;let r=Math.floor(t);if(r<0||r>=o)return!1;let i=e.toPositiveNumber(n,-1);return i<=0||m.get(r)===i?!1:(m.set(r,i),C.markChanged(r),!0)}function A(t,n){if(!Number.isFinite(t))return!1;let r=Math.floor(t);if(r<0||r>=s)return!1;let i=e.toPositiveNumber(n,-1);return i<=0||h.get(r)===i?!1:(h.set(r,i),w.markChanged(r),!0)}function j(){T||(T=!0,queueMicrotask(()=>{T=!1;let e=C.consumeMinChangedIndex();e!==1/0&&C.rebuildFrom(e);let t=w.consumeMinChangedIndex();t!==1/0&&w.rebuildFrom(t),O()}))}function M(e,t){S||k(e,t)&&j()}function N(e,t){S||A(e,t)&&j()}function P(e,t){if(S)return;let n=!1;for(let{index:t,size:r}of e)k(t,r)&&(n=!0);for(let{index:e,size:r}of t)A(e,r)&&(n=!0);n&&j()}function F(t,n){return S?()=>{}:e.observeResize(W.signal,n,e=>M(t,e.contentRect.height))}function I(t,n){return S?()=>{}:e.observeResize(W.signal,n,e=>N(t,e.contentRect.width))}function L(){S||(m.clear(),h.clear(),C.rebuild(!0),w.rebuild(!0),O())}function R(){S||(C.rebuild(!0),w.rebuild(!0),O())}function z(t){if(S)return;let n=e.toNonNegativeInt(t);if(n===0)return;o+=n,C.setCount(o),C.rebuild(!0);let r=C.startAt(n),i=E(g+r);J.scrollTo(_,i,`auto`),g=i,O()}function B(e,t={}){if(S||o===0)return;let n=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),o-1)),i=t.behavior??`auto`,a=C.startAt(n),s=C.sizeAt(n),c=r(a,a+s,s,g,v,t.rowAlign??`auto`);c!==null&&J.scrollTo(_,E(c),i)}function V(e,t={}){if(S||s===0)return;let n=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),s-1)),i=t.behavior??`auto`,a=w.startAt(n),o=w.sizeAt(n),c=r(a,a+o,o,_,y,t.colAlign??`auto`);c!==null&&J.scrollTo(D(c),g,i)}function H(e,t,n={}){if(S||o===0||s===0)return;let i=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),o-1)),a=Math.max(0,Math.min(Math.floor(Number.isFinite(t)?t:0),s-1)),c=n.behavior??`auto`,l=C.startAt(i),u=C.sizeAt(i),d=w.startAt(a),f=w.sizeAt(a),p=r(l,l+u,u,g,v,n.rowAlign??`auto`),m=r(d,d+f,f,_,y,n.colAlign??`auto`);p===null&&m===null||J.scrollTo(m===null?_:D(m),p===null?g:E(p),c)}function U(t){if(S)return;let n=!1,r=!1,i=!1;if(t.rowCount!==void 0){let r=e.toNonNegativeInt(t.rowCount);r!==o&&(o=r,C.setCount(o),n=!0)}if(t.colCount!==void 0){let n=e.toNonNegativeInt(t.colCount);n!==s&&(s=n,w.setCount(s),r=!0)}if(t.rowGap!==void 0){let r=e.toNonNegativeInt(t.rowGap);r!==C.gap&&(C.setGap(r),n=!0)}if(t.colGap!==void 0){let n=e.toNonNegativeInt(t.colGap);n!==w.gap&&(w.setGap(n),r=!0)}if(`estimateRowSize`in t&&(c=e.resolveEstimateFn(t.estimateRowSize,36),m.clear(),n=!0),`estimateColSize`in t&&(l=e.resolveEstimateFn(t.estimateColSize,36),h.clear(),r=!0),t.overscanY!==void 0){let n=e.normalizeOverscan(t.overscanY,3);(n.start!==u.start||n.end!==u.end)&&(u=n,i=!0)}if(t.overscanX!==void 0){let n=e.normalizeOverscan(t.overscanX,3);(n.start!==d.start||n.end!==d.end)&&(d=n,i=!0)}n&&C.rebuild(!0),r&&w.rebuild(!0),(n||r||i)&&O()}let W=new AbortController;function G(){S||(S=!0,W.abort(),J.detach())}function K(){g=E(J.y.readOffset()),_=D(J.x.readOffset()),O()}function q(){v=J.y.readViewportSize(),y=J.x.readViewportSize(),O()}let J=t.createScrollAdapter(i,K,q);return C.rebuild(!0),w.rebuild(!0),v=J.y.readViewportSize(),y=J.x.readViewportSize(),a.initialScrollTop===void 0?a.initialScrollLeft!==void 0&&J.scrollTo(D(a.initialScrollLeft),0,`auto`):J.scrollTo(a.initialScrollLeft??0,E(a.initialScrollTop),`auto`),g=E(J.y.readOffset()),_=D(J.x.readOffset()),O(),{get cols(){return x},get disposalSignal(){return W.signal},dispose:G,get disposed(){return S},invalidate:L,measureBatch:P,measureColEl:I,measureColumn:N,measureRow:M,measureRowEl:F,prependRows:z,refresh:R,get rows(){return b},get scrollLeft(){return _},scrollToCell:H,scrollToColumn:V,get scrollTop(){return g},scrollToRow:B,[Symbol.dispose]:G,get totalHeight(){return C.totalSize},get totalWidth(){return w.totalSize},update:U}}exports.createGridVirtualizer=i;
+//# sourceMappingURL=grid-virtualizer.cjs.map

package/dist/grid-virtualizer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-virtualizer.cjs","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import { createScrollAdapter } from './_adapter';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  observeResize,\n  type Overscan,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\n\nexport { type VirtualItem };\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport interface GridVirtualizerState {\n  /**\n   * Visible column descriptors.\n   * Callers form the cross-product `rows × cols` as needed — no O(r×c) Cell\n   * allocation per scroll tick (R8).\n   */\n  readonly cols: VirtualItem[];\n  /** Visible row descriptors. */\n  readonly rows: VirtualItem[];\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n}\n\nexport interface GridRangeChangeEvent {\n  firstCol: number;\n  firstRow: number;\n  lastCol: number;\n  lastRow: number;\n}\n\nexport interface ScrollToCellOptions {\n  behavior?: ScrollBehavior;\n  colAlign?: 'auto' | 'center' | 'end' | 'start';\n  rowAlign?: 'auto' | 'center' | 'end' | 'start';\n}\n\nexport interface GridVirtualizerOptions {\n  colCount: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /**\n   * Called after every render cycle with the new state.\n   * **Fixed at construction** \\u2014 cannot be changed after creation.\n   */\n  onChange?: (state: GridVirtualizerState) => void;\n  /** Zero-allocation alternative to onChange for range-based consumers. */\n  onRangeChange?: (range: GridRangeChangeEvent) => void;\n  overscanX?: Overscan;\n  overscanY?: Overscan;\n  rowCount: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  rowGap?: number;\n}\n\n/**\n * Options accepted by `update()`. Explicit interface instead of\n * `Partial<Omit<...>>` for better IDE hover (R7).\n */\nexport interface GridVirtualizerUpdateOptions {\n  colCount?: number;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  overscanX?: Overscan;\n  overscanY?: Overscan;\n  rowCount?: number;\n  rowGap?: number;\n}\n\nexport interface GridVirtualizer {\n  readonly cols: VirtualItem[];\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\n  readonly scrollTop: number;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  dispose: () => void;\n  invalidate: () => void;\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  measureBatch: (rows: Array<{ index: number; size: number }>, cols: Array<{ index: number; size: number }>) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the column width on resize. Returns disconnect fn. */\n  measureColEl: (col: number, el: HTMLElement) => () => void;\n  measureColumn: (col: number, size: number) => void;\n  measureRow: (row: number, size: number) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the row height on resize. Returns disconnect fn. */\n  measureRowEl: (row: number, el: HTMLElement) => () => void;\n  /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */\n  prependRows: (additionalRowCount: number) => void;\n  refresh: () => void;\n  scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;\n  /** Scroll to bring a row into view without changing the horizontal position. */\n  scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Align helper ─────────────────────────────────────────────────────────────\n\nfunction alignOffset(\n  itemStart: number,\n  itemEnd: number,\n  itemSize: number,\n  currentOffset: number,\n  viewportSize: number,\n  align: 'auto' | 'center' | 'end' | 'start',\n): number | null {\n  if (align === 'start') return itemStart;\n\n  if (align === 'end') return itemEnd - viewportSize;\n\n  if (align === 'center') return itemStart - (viewportSize - itemSize) / 2;\n\n  // auto: no-op when already fully visible\n  if (itemStart >= currentOffset && itemEnd <= currentOffset + viewportSize) return null;\n\n  return itemStart < currentOffset ? itemStart : itemEnd - viewportSize;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  let rowCount = toNonNegativeInt(options.rowCount);\n  let colCount = toNonNegativeInt(options.colCount);\n  let estimateRowFn = resolveEstimateFn(options.estimateRowSize, DEFAULT_ESTIMATE_SIZE);\n  let estimateColFn = resolveEstimateFn(options.estimateColSize, DEFAULT_ESTIMATE_SIZE);\n  let overscanY = normalizeOverscan(options.overscanY, DEFAULT_OVERSCAN);\n  let overscanX = normalizeOverscan(options.overscanX, DEFAULT_OVERSCAN);\n\n  // Callbacks fixed at construction.\n  const onChange = options.onChange;\n  const onRangeChange = options.onRangeChange;\n\n  // External or internal measurement caches (numeric row/col index keys).\n  const measuredRows: Map<number, number> = options.rowMeasurementCache ?? new Map();\n  const measuredCols: Map<number, number> = options.colMeasurementCache ?? new Map();\n\n  let scrollTop = 0;\n  let scrollLeft = 0;\n  let viewportHeight = 0;\n  let viewportWidth = 0;\n  let rows: VirtualItem[] = [];\n  let cols: VirtualItem[] = [];\n  let disposed = false;\n\n  // ─── Axis1D instances (R1) ─────────────────────────────────────────────────\n  // sizeAt closures capture live `measuredRows/Cols` and `estimateFn` vars.\n\n  const rowAx = createAxis1D(\n    rowCount,\n    (r) => measuredRows.get(r) ?? estimateRowFn(r),\n    toNonNegativeInt(options.rowGap ?? 0),\n  );\n\n  const colAx = createAxis1D(\n    colCount,\n    (c) => measuredCols.get(c) ?? estimateColFn(c),\n    toNonNegativeInt(options.colGap ?? 0),\n  );\n\n  // R4: Single coordinated flush flag — prevents two separate microtasks.\n  let pendingBatchBuild = false;\n\n  // ─── Clamping ──────────────────────────────────────────────────────────────\n\n  function clampTop(offset: number): number {\n    const safe = Number.isFinite(offset) ? offset : 0;\n\n    return Math.min(Math.max(0, rowAx.totalSize - viewportHeight), Math.max(0, safe));\n  }\n\n  function clampLeft(offset: number): number {\n    const safe = Number.isFinite(offset) ? offset : 0;\n\n    return Math.min(Math.max(0, colAx.totalSize - viewportWidth), Math.max(0, safe));\n  }\n\n  // ─── Compute and emit ──────────────────────────────────────────────────────\n\n  function computeVisible(): void {\n    if (disposed) return;\n\n    const totalHeight = rowAx.totalSize;\n    const totalWidth = colAx.totalSize;\n\n    if (rowCount === 0 || colCount === 0 || viewportHeight <= 0 || viewportWidth <= 0) {\n      const wasEmpty =\n        rowAx.prevStart === -1 && rowAx.prevTotalSize === totalHeight && colAx.prevTotalSize === totalWidth;\n\n      if (!wasEmpty) {\n        // commitDedup(-1, -1) captures the current totalSize so the guard doesn't\n        // fire on every subsequent event while the empty state persists (Bug 2).\n        rowAx.commitDedup(-1, -1);\n        colAx.commitDedup(-1, -1);\n        rows = [];\n        cols = [];\n        onChange?.({ cols: [], rows: [], totalHeight, totalWidth });\n      }\n\n      return;\n    }\n\n    const { renderEnd: renderLastRow, renderStart: renderFirstRow } = rowAx.computeRange(\n      scrollTop,\n      scrollTop + viewportHeight,\n      overscanY.start,\n      overscanY.end,\n    );\n\n    const { renderEnd: renderLastCol, renderStart: renderFirstCol } = colAx.computeRange(\n      scrollLeft,\n      scrollLeft + viewportWidth,\n      overscanX.start,\n      overscanX.end,\n    );\n\n    const rowSame = rowAx.isDedupSame(renderFirstRow, renderLastRow);\n    const colSame = colAx.isDedupSame(renderFirstCol, renderLastCol);\n\n    if (rowSame && colSame) return;\n\n    rowAx.commitDedup(renderFirstRow, renderLastRow);\n    colAx.commitDedup(renderFirstCol, renderLastCol);\n\n    const rangeChanged = !rowSame || !colSame;\n\n    if (rangeChanged && onRangeChange) {\n      onRangeChange({\n        firstCol: renderFirstCol,\n        firstRow: renderFirstRow,\n        lastCol: renderLastCol,\n        lastRow: renderLastRow,\n      });\n    }\n\n    // R8: Build rows[] and cols[] separately — no cross-product VirtualCell[].\n    const nextRows: VirtualItem[] = [];\n\n    for (let r = renderFirstRow; r <= renderLastRow; r++) {\n      nextRows.push(rowAx.itemAt(r));\n    }\n\n    const nextCols: VirtualItem[] = [];\n\n    for (let c = renderFirstCol; c <= renderLastCol; c++) {\n      nextCols.push(colAx.itemAt(c));\n    }\n\n    rows = nextRows;\n    cols = nextCols;\n\n    onChange?.({ cols, rows, totalHeight, totalWidth });\n  }\n\n  // ─── Measurement helpers ───────────────────────────────────────────────────\n\n  function recordRowMeasurement(row: number, size: number): boolean {\n    if (!Number.isFinite(row)) return false;\n\n    const r = Math.floor(row);\n\n    if (r < 0 || r >= rowCount) return false;\n\n    const s = toPositiveNumber(size, -1);\n\n    if (s <= 0) return false;\n\n    if (measuredRows.get(r) === s) return false;\n\n    measuredRows.set(r, s);\n    rowAx.markChanged(r);\n\n    return true;\n  }\n\n  function recordColMeasurement(col: number, size: number): boolean {\n    if (!Number.isFinite(col)) return false;\n\n    const c = Math.floor(col);\n\n    if (c < 0 || c >= colCount) return false;\n\n    const s = toPositiveNumber(size, -1);\n\n    if (s <= 0) return false;\n\n    if (measuredCols.get(c) === s) return false;\n\n    measuredCols.set(c, s);\n    colAx.markChanged(c);\n\n    return true;\n  }\n\n  /**\n   * R4: Single coordinated flush for both axes.\n   * Replaces the previous two independent microtask schedules.\n   */\n  function scheduleFlush(): void {\n    if (pendingBatchBuild) return;\n\n    pendingBatchBuild = true;\n    queueMicrotask(() => {\n      pendingBatchBuild = false;\n\n      // consumeMinChangedIndex() atomically reads and resets minChangedIndex.\n      // Without the reset, every subsequent flush would rebuild from index 0\n      // instead of the actual earliest changed index (Bug 3).\n      const fromRow = rowAx.consumeMinChangedIndex();\n\n      if (fromRow !== Infinity) rowAx.rebuildFrom(fromRow);\n\n      const fromCol = colAx.consumeMinChangedIndex();\n\n      if (fromCol !== Infinity) colAx.rebuildFrom(fromCol);\n\n      computeVisible();\n    });\n  }\n\n  // ─── Public measurement API ────────────────────────────────────────────────\n\n  function measureRow(row: number, size: number): void {\n    if (disposed) return;\n\n    if (recordRowMeasurement(row, size)) scheduleFlush();\n  }\n\n  function measureColumn(col: number, size: number): void {\n    if (disposed) return;\n\n    if (recordColMeasurement(col, size)) scheduleFlush();\n  }\n\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  function measureBatch(\n    rowEntries: Array<{ index: number; size: number }>,\n    colEntries: Array<{ index: number; size: number }>,\n  ): void {\n    if (disposed) return;\n\n    let changed = false;\n\n    for (const { index, size } of rowEntries) {\n      if (recordRowMeasurement(index, size)) changed = true;\n    }\n\n    for (const { index, size } of colEntries) {\n      if (recordColMeasurement(index, size)) changed = true;\n    }\n\n    if (changed) scheduleFlush();\n  }\n\n  function measureRowEl(row: number, el: HTMLElement): () => void {\n    if (disposed) return () => {};\n\n    return observeResize(ac.signal, el, (entry) => measureRow(row, entry.contentRect.height));\n  }\n\n  function measureColEl(col: number, el: HTMLElement): () => void {\n    if (disposed) return () => {};\n\n    return observeResize(ac.signal, el, (entry) => measureColumn(col, entry.contentRect.width));\n  }\n\n  function invalidate(): void {\n    if (disposed) return;\n\n    measuredRows.clear();\n    measuredCols.clear();\n    rowAx.rebuild(true);\n    colAx.rebuild(true);\n    computeVisible();\n  }\n\n  function refresh(): void {\n    if (disposed) return;\n\n    rowAx.rebuild(true);\n    colAx.rebuild(true);\n    computeVisible();\n  }\n\n  function prependRows(additionalRowCount: number): void {\n    if (disposed) return;\n\n    const n = toNonNegativeInt(additionalRowCount);\n\n    if (n === 0) return;\n\n    rowCount += n;\n    rowAx.setCount(rowCount);\n    rowAx.rebuild(true);\n\n    const prependedHeight = rowAx.startAt(n);\n    const newScrollTop = clampTop(scrollTop + prependedHeight);\n\n    adapter.scrollTo(scrollLeft, newScrollTop, 'auto');\n    scrollTop = newScrollTop;\n\n    computeVisible();\n  }\n\n  function scrollToRow(row: number, opts: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'> = {}): void {\n    if (disposed || rowCount === 0) return;\n\n    const safeRow = Math.max(0, Math.min(Math.floor(Number.isFinite(row) ? row : 0), rowCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n    const rowStart = rowAx.startAt(safeRow);\n    const rowSize = rowAx.sizeAt(safeRow);\n    const targetTop = alignOffset(\n      rowStart,\n      rowStart + rowSize,\n      rowSize,\n      scrollTop,\n      viewportHeight,\n      opts.rowAlign ?? 'auto',\n    );\n\n    if (targetTop === null) return;\n\n    adapter.scrollTo(scrollLeft, clampTop(targetTop), behavior);\n  }\n\n  function scrollToColumn(col: number, opts: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'> = {}): void {\n    if (disposed || colCount === 0) return;\n\n    const safeCol = Math.max(0, Math.min(Math.floor(Number.isFinite(col) ? col : 0), colCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n    const colStart = colAx.startAt(safeCol);\n    const colSize = colAx.sizeAt(safeCol);\n    const targetLeft = alignOffset(\n      colStart,\n      colStart + colSize,\n      colSize,\n      scrollLeft,\n      viewportWidth,\n      opts.colAlign ?? 'auto',\n    );\n\n    if (targetLeft === null) return;\n\n    adapter.scrollTo(clampLeft(targetLeft), scrollTop, behavior);\n  }\n\n  function scrollToCell(row: number, col: number, opts: ScrollToCellOptions = {}): void {\n    if (disposed || rowCount === 0 || colCount === 0) return;\n\n    const safeRow = Math.max(0, Math.min(Math.floor(Number.isFinite(row) ? row : 0), rowCount - 1));\n    const safeCol = Math.max(0, Math.min(Math.floor(Number.isFinite(col) ? col : 0), colCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n\n    const rowStart = rowAx.startAt(safeRow);\n    const rowSize = rowAx.sizeAt(safeRow);\n    const colStart = colAx.startAt(safeCol);\n    const colSize = colAx.sizeAt(safeCol);\n\n    const targetTop = alignOffset(\n      rowStart,\n      rowStart + rowSize,\n      rowSize,\n      scrollTop,\n      viewportHeight,\n      opts.rowAlign ?? 'auto',\n    );\n    const targetLeft = alignOffset(\n      colStart,\n      colStart + colSize,\n      colSize,\n      scrollLeft,\n      viewportWidth,\n      opts.colAlign ?? 'auto',\n    );\n\n    if (targetTop === null && targetLeft === null) return;\n\n    adapter.scrollTo(\n      targetLeft !== null ? clampLeft(targetLeft) : scrollLeft,\n      targetTop !== null ? clampTop(targetTop) : scrollTop,\n      behavior,\n    );\n  }\n\n  function update(next: GridVirtualizerUpdateOptions): void {\n    if (disposed) return;\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (next.rowCount !== undefined) {\n      const n = toNonNegativeInt(next.rowCount);\n\n      if (n !== rowCount) {\n        rowCount = n;\n        rowAx.setCount(rowCount);\n        rebuildRows = true;\n      }\n    }\n\n    if (next.colCount !== undefined) {\n      const n = toNonNegativeInt(next.colCount);\n\n      if (n !== colCount) {\n        colCount = n;\n        colAx.setCount(colCount);\n        rebuildCols = true;\n      }\n    }\n\n    if (next.rowGap !== undefined) {\n      const n = toNonNegativeInt(next.rowGap);\n\n      if (n !== rowAx.gap) {\n        rowAx.setGap(n);\n        rebuildRows = true;\n      }\n    }\n\n    if (next.colGap !== undefined) {\n      const n = toNonNegativeInt(next.colGap);\n\n      if (n !== colAx.gap) {\n        colAx.setGap(n);\n        rebuildCols = true;\n      }\n    }\n\n    if ('estimateRowSize' in next) {\n      estimateRowFn = resolveEstimateFn(next.estimateRowSize, DEFAULT_ESTIMATE_SIZE);\n      measuredRows.clear();\n      rebuildRows = true;\n    }\n\n    if ('estimateColSize' in next) {\n      estimateColFn = resolveEstimateFn(next.estimateColSize, DEFAULT_ESTIMATE_SIZE);\n      measuredCols.clear();\n      rebuildCols = true;\n    }\n\n    if (next.overscanY !== undefined) {\n      const n = normalizeOverscan(next.overscanY, DEFAULT_OVERSCAN);\n\n      if (n.start !== overscanY.start || n.end !== overscanY.end) {\n        overscanY = n;\n        needsCompute = true;\n      }\n    }\n\n    if (next.overscanX !== undefined) {\n      const n = normalizeOverscan(next.overscanX, DEFAULT_OVERSCAN);\n\n      if (n.start !== overscanX.start || n.end !== overscanX.end) {\n        overscanX = n;\n        needsCompute = true;\n      }\n    }\n\n    if (rebuildRows) rowAx.rebuild(true);\n\n    if (rebuildCols) colAx.rebuild(true);\n\n    if (rebuildRows || rebuildCols || needsCompute) computeVisible();\n  }\n\n  const ac = new AbortController();\n\n  function disposeImpl(): void {\n    if (disposed) return;\n\n    disposed = true;\n    ac.abort();\n    adapter.detach();\n  }\n\n  // ─── Bootstrap (R9: read viewport BEFORE writing initial scroll) ───────────\n\n  function handleScroll(): void {\n    scrollTop = clampTop(adapter.y.readOffset());\n    scrollLeft = clampLeft(adapter.x.readOffset());\n    computeVisible();\n  }\n\n  function handleResize(): void {\n    viewportHeight = adapter.y.readViewportSize();\n    viewportWidth = adapter.x.readViewportSize();\n    computeVisible();\n  }\n\n  const adapter = createScrollAdapter(target, handleScroll, handleResize);\n\n  rowAx.rebuild(true);\n  colAx.rebuild(true);\n\n  // R9: Read viewport dimensions BEFORE writing initial scroll positions so that\n  // computeVisible() sees a valid viewport on the very first call.\n  viewportHeight = adapter.y.readViewportSize();\n  viewportWidth = adapter.x.readViewportSize();\n\n  if (options.initialScrollTop !== undefined) {\n    adapter.scrollTo(options.initialScrollLeft ?? 0, clampTop(options.initialScrollTop), 'auto');\n  } else if (options.initialScrollLeft !== undefined) {\n    adapter.scrollTo(clampLeft(options.initialScrollLeft), 0, 'auto');\n  }\n\n  scrollTop = clampTop(adapter.y.readOffset());\n  scrollLeft = clampLeft(adapter.x.readOffset());\n\n  computeVisible();\n\n  return {\n    get cols() {\n      return cols;\n    },\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose: disposeImpl,\n    get disposed() {\n      return disposed;\n    },\n    invalidate,\n    measureBatch,\n    measureColEl,\n    measureColumn,\n    measureRow,\n    measureRowEl,\n    prependRows,\n    refresh,\n    get rows() {\n      return rows;\n    },\n    get scrollLeft() {\n      return scrollLeft;\n    },\n    scrollToCell,\n    scrollToColumn,\n    get scrollTop() {\n      return scrollTop;\n    },\n    scrollToRow,\n    [Symbol.dispose]: disposeImpl,\n    get totalHeight() {\n      return rowAx.totalSize;\n    },\n    get totalWidth() {\n      return colAx.totalSize;\n    },\n    update,\n  };\n}\n"],"mappings":"uFAoHA,SAAS,EACP,EACA,EACA,EACA,EACA,EACA,EACe,CAUf,OATI,IAAU,QAAgB,EAE1B,IAAU,MAAc,EAAU,EAElC,IAAU,SAAiB,GAAa,EAAe,GAAY,EAGnE,GAAa,GAAiB,GAAW,EAAgB,EAAqB,KAE3E,EAAY,EAAgB,EAAY,EAAU,CAC3D,CAIA,SAAgB,EAAsB,EAAsB,EAAkD,CAC5G,IAAI,EAAW,EAAA,iBAAiB,EAAQ,QAAQ,EAC5C,EAAW,EAAA,iBAAiB,EAAQ,QAAQ,EAC5C,EAAgB,EAAA,kBAAkB,EAAQ,gBAAA,EAAsC,EAChF,EAAgB,EAAA,kBAAkB,EAAQ,gBAAA,EAAsC,EAChF,EAAY,EAAA,kBAAkB,EAAQ,UAAA,CAA2B,EACjE,EAAY,EAAA,kBAAkB,EAAQ,UAAA,CAA2B,EAG/D,EAAW,EAAQ,SACnB,EAAgB,EAAQ,cAGxB,EAAoC,EAAQ,qBAAuB,IAAI,IACvE,EAAoC,EAAQ,qBAAuB,IAAI,IAEzE,EAAY,EACZ,EAAa,EACb,EAAiB,EACjB,EAAgB,EAChB,EAAsB,CAAC,EACvB,EAAsB,CAAC,EACvB,EAAW,GAKT,EAAQ,EAAA,aACZ,EACC,GAAM,EAAa,IAAI,CAAC,GAAK,EAAc,CAAC,EAC7C,EAAA,iBAAiB,EAAQ,QAAU,CAAC,CACtC,EAEM,EAAQ,EAAA,aACZ,EACC,GAAM,EAAa,IAAI,CAAC,GAAK,EAAc,CAAC,EAC7C,EAAA,iBAAiB,EAAQ,QAAU,CAAC,CACtC,EAGI,EAAoB,GAIxB,SAAS,EAAS,EAAwB,CACxC,IAAM,EAAO,OAAO,SAAS,CAAM,EAAI,EAAS,EAEhD,OAAO,KAAK,IAAI,KAAK,IAAI,EAAG,EAAM,UAAY,CAAc,EAAG,KAAK,IAAI,EAAG,CAAI,CAAC,CAClF,CAEA,SAAS,EAAU,EAAwB,CACzC,IAAM,EAAO,OAAO,SAAS,CAAM,EAAI,EAAS,EAEhD,OAAO,KAAK,IAAI,KAAK,IAAI,EAAG,EAAM,UAAY,CAAa,EAAG,KAAK,IAAI,EAAG,CAAI,CAAC,CACjF,CAIA,SAAS,GAAuB,CAC9B,GAAI,EAAU,OAEd,IAAM,EAAc,EAAM,UACpB,EAAa,EAAM,UAEzB,GAAI,IAAa,GAAK,IAAa,GAAK,GAAkB,GAAK,GAAiB,EAAG,CAE/E,EAAM,YAAc,IAAM,EAAM,gBAAkB,GAAe,EAAM,gBAAkB,IAKzF,EAAM,YAAY,GAAI,EAAE,EACxB,EAAM,YAAY,GAAI,EAAE,EACxB,EAAO,CAAC,EACR,EAAO,CAAC,EACR,IAAW,CAAE,KAAM,CAAC,EAAG,KAAM,CAAC,EAAG,cAAa,YAAW,CAAC,GAG5D,MACF,CAEA,GAAM,CAAE,UAAW,EAAe,YAAa,GAAmB,EAAM,aACtE,EACA,EAAY,EACZ,EAAU,MACV,EAAU,GACZ,EAEM,CAAE,UAAW,EAAe,YAAa,GAAmB,EAAM,aACtE,EACA,EAAa,EACb,EAAU,MACV,EAAU,GACZ,EAEM,EAAU,EAAM,YAAY,EAAgB,CAAa,EACzD,EAAU,EAAM,YAAY,EAAgB,CAAa,EAE/D,GAAI,GAAW,EAAS,OAExB,EAAM,YAAY,EAAgB,CAAa,EAC/C,EAAM,YAAY,EAAgB,CAAa,GAE1B,CAAC,GAAW,CAAC,IAEd,GAClB,EAAc,CACZ,SAAU,EACV,SAAU,EACV,QAAS,EACT,QAAS,CACX,CAAC,EAIH,IAAM,EAA0B,CAAC,EAEjC,IAAK,IAAI,EAAI,EAAgB,GAAK,EAAe,IAC/C,EAAS,KAAK,EAAM,OAAO,CAAC,CAAC,EAG/B,IAAM,EAA0B,CAAC,EAEjC,IAAK,IAAI,EAAI,EAAgB,GAAK,EAAe,IAC/C,EAAS,KAAK,EAAM,OAAO,CAAC,CAAC,EAG/B,EAAO,EACP,EAAO,EAEP,IAAW,CAAE,OAAM,OAAM,cAAa,YAAW,CAAC,CACpD,CAIA,SAAS,EAAqB,EAAa,EAAuB,CAChE,GAAI,CAAC,OAAO,SAAS,CAAG,EAAG,MAAO,GAElC,IAAM,EAAI,KAAK,MAAM,CAAG,EAExB,GAAI,EAAI,GAAK,GAAK,EAAU,MAAO,GAEnC,IAAM,EAAI,EAAA,iBAAiB,EAAM,EAAE,EASnC,OAPI,GAAK,GAEL,EAAa,IAAI,CAAC,IAAM,EAAU,IAEtC,EAAa,IAAI,EAAG,CAAC,EACrB,EAAM,YAAY,CAAC,EAEZ,GACT,CAEA,SAAS,EAAqB,EAAa,EAAuB,CAChE,GAAI,CAAC,OAAO,SAAS,CAAG,EAAG,MAAO,GAElC,IAAM,EAAI,KAAK,MAAM,CAAG,EAExB,GAAI,EAAI,GAAK,GAAK,EAAU,MAAO,GAEnC,IAAM,EAAI,EAAA,iBAAiB,EAAM,EAAE,EASnC,OAPI,GAAK,GAEL,EAAa,IAAI,CAAC,IAAM,EAAU,IAEtC,EAAa,IAAI,EAAG,CAAC,EACrB,EAAM,YAAY,CAAC,EAEZ,GACT,CAMA,SAAS,GAAsB,CACzB,IAEJ,EAAoB,GACpB,mBAAqB,CACnB,EAAoB,GAKpB,IAAM,EAAU,EAAM,uBAAuB,EAEzC,IAAY,KAAU,EAAM,YAAY,CAAO,EAEnD,IAAM,EAAU,EAAM,uBAAuB,EAEzC,IAAY,KAAU,EAAM,YAAY,CAAO,EAEnD,EAAe,CACjB,CAAC,EACH,CAIA,SAAS,EAAW,EAAa,EAAoB,CAC/C,GAEA,EAAqB,EAAK,CAAI,GAAG,EAAc,CACrD,CAEA,SAAS,EAAc,EAAa,EAAoB,CAClD,GAEA,EAAqB,EAAK,CAAI,GAAG,EAAc,CACrD,CAGA,SAAS,EACP,EACA,EACM,CACN,GAAI,EAAU,OAEd,IAAI,EAAU,GAEd,IAAK,GAAM,CAAE,QAAO,UAAU,EACxB,EAAqB,EAAO,CAAI,IAAG,EAAU,IAGnD,IAAK,GAAM,CAAE,QAAO,UAAU,EACxB,EAAqB,EAAO,CAAI,IAAG,EAAU,IAG/C,GAAS,EAAc,CAC7B,CAEA,SAAS,EAAa,EAAa,EAA6B,CAG9D,OAFI,MAAuB,CAAC,EAErB,EAAA,cAAc,EAAG,OAAQ,EAAK,GAAU,EAAW,EAAK,EAAM,YAAY,MAAM,CAAC,CAC1F,CAEA,SAAS,EAAa,EAAa,EAA6B,CAG9D,OAFI,MAAuB,CAAC,EAErB,EAAA,cAAc,EAAG,OAAQ,EAAK,GAAU,EAAc,EAAK,EAAM,YAAY,KAAK,CAAC,CAC5F,CAEA,SAAS,GAAmB,CACtB,IAEJ,EAAa,MAAM,EACnB,EAAa,MAAM,EACnB,EAAM,QAAQ,EAAI,EAClB,EAAM,QAAQ,EAAI,EAClB,EAAe,EACjB,CAEA,SAAS,GAAgB,CACnB,IAEJ,EAAM,QAAQ,EAAI,EAClB,EAAM,QAAQ,EAAI,EAClB,EAAe,EACjB,CAEA,SAAS,EAAY,EAAkC,CACrD,GAAI,EAAU,OAEd,IAAM,EAAI,EAAA,iBAAiB,CAAkB,EAE7C,GAAI,IAAM,EAAG,OAEb,GAAY,EACZ,EAAM,SAAS,CAAQ,EACvB,EAAM,QAAQ,EAAI,EAElB,IAAM,EAAkB,EAAM,QAAQ,CAAC,EACjC,EAAe,EAAS,EAAY,CAAe,EAEzD,EAAQ,SAAS,EAAY,EAAc,MAAM,EACjD,EAAY,EAEZ,EAAe,CACjB,CAEA,SAAS,EAAY,EAAa,EAA2D,CAAC,EAAS,CACrG,GAAI,GAAY,IAAa,EAAG,OAEhC,IAAM,EAAU,KAAK,IAAI,EAAG,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,CAAG,EAAI,EAAM,CAAC,EAAG,EAAW,CAAC,CAAC,EACxF,EAAW,EAAK,UAAY,OAC5B,EAAW,EAAM,QAAQ,CAAO,EAChC,EAAU,EAAM,OAAO,CAAO,EAC9B,EAAY,EAChB,EACA,EAAW,EACX,EACA,EACA,EACA,EAAK,UAAY,MACnB,EAEI,IAAc,MAElB,EAAQ,SAAS,EAAY,EAAS,CAAS,EAAG,CAAQ,CAC5D,CAEA,SAAS,EAAe,EAAa,EAA2D,CAAC,EAAS,CACxG,GAAI,GAAY,IAAa,EAAG,OAEhC,IAAM,EAAU,KAAK,IAAI,EAAG,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,CAAG,EAAI,EAAM,CAAC,EAAG,EAAW,CAAC,CAAC,EACxF,EAAW,EAAK,UAAY,OAC5B,EAAW,EAAM,QAAQ,CAAO,EAChC,EAAU,EAAM,OAAO,CAAO,EAC9B,EAAa,EACjB,EACA,EAAW,EACX,EACA,EACA,EACA,EAAK,UAAY,MACnB,EAEI,IAAe,MAEnB,EAAQ,SAAS,EAAU,CAAU,EAAG,EAAW,CAAQ,CAC7D,CAEA,SAAS,EAAa,EAAa,EAAa,EAA4B,CAAC,EAAS,CACpF,GAAI,GAAY,IAAa,GAAK,IAAa,EAAG,OAElD,IAAM,EAAU,KAAK,IAAI,EAAG,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,CAAG,EAAI,EAAM,CAAC,EAAG,EAAW,CAAC,CAAC,EACxF,EAAU,KAAK,IAAI,EAAG,KAAK,IAAI,KAAK,MAAM,OAAO,SAAS,CAAG,EAAI,EAAM,CAAC,EAAG,EAAW,CAAC,CAAC,EACxF,EAAW,EAAK,UAAY,OAE5B,EAAW,EAAM,QAAQ,CAAO,EAChC,EAAU,EAAM,OAAO,CAAO,EAC9B,EAAW,EAAM,QAAQ,CAAO,EAChC,EAAU,EAAM,OAAO,CAAO,EAE9B,EAAY,EAChB,EACA,EAAW,EACX,EACA,EACA,EACA,EAAK,UAAY,MACnB,EACM,EAAa,EACjB,EACA,EAAW,EACX,EACA,EACA,EACA,EAAK,UAAY,MACnB,EAEI,IAAc,MAAQ,IAAe,MAEzC,EAAQ,SACN,IAAe,KAA+B,EAAxB,EAAU,CAAU,EAC1C,IAAc,KAA6B,EAAtB,EAAS,CAAS,EACvC,CACF,CACF,CAEA,SAAS,EAAO,EAA0C,CACxD,GAAI,EAAU,OAEd,IAAI,EAAc,GACd,EAAc,GACd,EAAe,GAEnB,GAAI,EAAK,WAAa,IAAA,GAAW,CAC/B,IAAM,EAAI,EAAA,iBAAiB,EAAK,QAAQ,EAEpC,IAAM,IACR,EAAW,EACX,EAAM,SAAS,CAAQ,EACvB,EAAc,GAElB,CAEA,GAAI,EAAK,WAAa,IAAA,GAAW,CAC/B,IAAM,EAAI,EAAA,iBAAiB,EAAK,QAAQ,EAEpC,IAAM,IACR,EAAW,EACX,EAAM,SAAS,CAAQ,EACvB,EAAc,GAElB,CAEA,GAAI,EAAK,SAAW,IAAA,GAAW,CAC7B,IAAM,EAAI,EAAA,iBAAiB,EAAK,MAAM,EAElC,IAAM,EAAM,MACd,EAAM,OAAO,CAAC,EACd,EAAc,GAElB,CAEA,GAAI,EAAK,SAAW,IAAA,GAAW,CAC7B,IAAM,EAAI,EAAA,iBAAiB,EAAK,MAAM,EAElC,IAAM,EAAM,MACd,EAAM,OAAO,CAAC,EACd,EAAc,GAElB,CAcA,GAZI,oBAAqB,IACvB,EAAgB,EAAA,kBAAkB,EAAK,gBAAA,EAAsC,EAC7E,EAAa,MAAM,EACnB,EAAc,IAGZ,oBAAqB,IACvB,EAAgB,EAAA,kBAAkB,EAAK,gBAAA,EAAsC,EAC7E,EAAa,MAAM,EACnB,EAAc,IAGZ,EAAK,YAAc,IAAA,GAAW,CAChC,IAAM,EAAI,EAAA,kBAAkB,EAAK,UAAA,CAA2B,GAExD,EAAE,QAAU,EAAU,OAAS,EAAE,MAAQ,EAAU,OACrD,EAAY,EACZ,EAAe,GAEnB,CAEA,GAAI,EAAK,YAAc,IAAA,GAAW,CAChC,IAAM,EAAI,EAAA,kBAAkB,EAAK,UAAA,CAA2B,GAExD,EAAE,QAAU,EAAU,OAAS,EAAE,MAAQ,EAAU,OACrD,EAAY,EACZ,EAAe,GAEnB,CAEI,GAAa,EAAM,QAAQ,EAAI,EAE/B,GAAa,EAAM,QAAQ,EAAI,GAE/B,GAAe,GAAe,IAAc,EAAe,CACjE,CAEA,IAAM,EAAK,IAAI,gBAEf,SAAS,GAAoB,CACvB,IAEJ,EAAW,GACX,EAAG,MAAM,EACT,EAAQ,OAAO,EACjB,CAIA,SAAS,GAAqB,CAC5B,EAAY,EAAS,EAAQ,EAAE,WAAW,CAAC,EAC3C,EAAa,EAAU,EAAQ,EAAE,WAAW,CAAC,EAC7C,EAAe,CACjB,CAEA,SAAS,GAAqB,CAC5B,EAAiB,EAAQ,EAAE,iBAAiB,EAC5C,EAAgB,EAAQ,EAAE,iBAAiB,EAC3C,EAAe,CACjB,CAEA,IAAM,EAAU,EAAA,oBAAoB,EAAQ,EAAc,CAAY,EAqBtE,OAnBA,EAAM,QAAQ,EAAI,EAClB,EAAM,QAAQ,EAAI,EAIlB,EAAiB,EAAQ,EAAE,iBAAiB,EAC5C,EAAgB,EAAQ,EAAE,iBAAiB,EAEvC,EAAQ,mBAAqB,IAAA,GAEtB,EAAQ,oBAAsB,IAAA,IACvC,EAAQ,SAAS,EAAU,EAAQ,iBAAiB,EAAG,EAAG,MAAM,EAFhE,EAAQ,SAAS,EAAQ,mBAAqB,EAAG,EAAS,EAAQ,gBAAgB,EAAG,MAAM,EAK7F,EAAY,EAAS,EAAQ,EAAE,WAAW,CAAC,EAC3C,EAAa,EAAU,EAAQ,EAAE,WAAW,CAAC,EAE7C,EAAe,EAER,CACL,IAAI,MAAO,CACT,OAAO,CACT,EACA,IAAI,gBAAiB,CACnB,OAAO,EAAG,MACZ,EACA,QAAS,EACT,IAAI,UAAW,CACb,OAAO,CACT,EACA,aACA,eACA,eACA,gBACA,aACA,eACA,cACA,UACA,IAAI,MAAO,CACT,OAAO,CACT,EACA,IAAI,YAAa,CACf,OAAO,CACT,EACA,eACA,iBACA,IAAI,WAAY,CACd,OAAO,CACT,EACA,eACC,OAAO,SAAU,EAClB,IAAI,aAAc,CAChB,OAAO,EAAM,SACf,EACA,IAAI,YAAa,CACf,OAAO,EAAM,SACf,EACA,QACF,CACF"}

package/dist/grid-virtualizer.d.ts

@@ -0,0 +1,101 @@
+import { type VirtualItem } from './_axis1d';
+import { type Overscan, type ScrollTarget } from './_utils';
+export { type VirtualItem };
+export interface GridVirtualizerState {
+    /**
+     * Visible column descriptors.
+     * Callers form the cross-product `rows × cols` as needed — no O(r×c) Cell
+     * allocation per scroll tick (R8).
+     */
+    readonly cols: VirtualItem[];
+    /** Visible row descriptors. */
+    readonly rows: VirtualItem[];
+    readonly totalHeight: number;
+    readonly totalWidth: number;
+}
+export interface GridRangeChangeEvent {
+    firstCol: number;
+    firstRow: number;
+    lastCol: number;
+    lastRow: number;
+}
+export interface ScrollToCellOptions {
+    behavior?: ScrollBehavior;
+    colAlign?: 'auto' | 'center' | 'end' | 'start';
+    rowAlign?: 'auto' | 'center' | 'end' | 'start';
+}
+export interface GridVirtualizerOptions {
+    colCount: number;
+    /** External measurement cache for columns. Share across instances for scroll restoration. */
+    colMeasurementCache?: Map<number, number>;
+    colGap?: number;
+    estimateColSize?: number | ((col: number) => number);
+    estimateRowSize?: number | ((row: number) => number);
+    initialScrollLeft?: number;
+    initialScrollTop?: number;
+    /**
+     * Called after every render cycle with the new state.
+     * **Fixed at construction** \u2014 cannot be changed after creation.
+     */
+    onChange?: (state: GridVirtualizerState) => void;
+    /** Zero-allocation alternative to onChange for range-based consumers. */
+    onRangeChange?: (range: GridRangeChangeEvent) => void;
+    overscanX?: Overscan;
+    overscanY?: Overscan;
+    rowCount: number;
+    /** External measurement cache for rows. Share across instances for scroll restoration. */
+    rowMeasurementCache?: Map<number, number>;
+    rowGap?: number;
+}
+/**
+ * Options accepted by `update()`. Explicit interface instead of
+ * `Partial<Omit<...>>` for better IDE hover (R7).
+ */
+export interface GridVirtualizerUpdateOptions {
+    colCount?: number;
+    colGap?: number;
+    estimateColSize?: number | ((col: number) => number);
+    estimateRowSize?: number | ((row: number) => number);
+    overscanX?: Overscan;
+    overscanY?: Overscan;
+    rowCount?: number;
+    rowGap?: number;
+}
+export interface GridVirtualizer {
+    readonly cols: VirtualItem[];
+    readonly disposalSignal: AbortSignal;
+    readonly disposed: boolean;
+    readonly rows: VirtualItem[];
+    readonly scrollLeft: number;
+    readonly scrollTop: number;
+    readonly totalHeight: number;
+    readonly totalWidth: number;
+    dispose: () => void;
+    invalidate: () => void;
+    /** Measure rows and columns in a single coordinated rebuild pass (R4). */
+    measureBatch: (rows: Array<{
+        index: number;
+        size: number;
+    }>, cols: Array<{
+        index: number;
+        size: number;
+    }>) => void;
+    /** Attach a ResizeObserver to `el` to auto-measure the column width on resize. Returns disconnect fn. */
+    measureColEl: (col: number, el: HTMLElement) => () => void;
+    measureColumn: (col: number, size: number) => void;
+    measureRow: (row: number, size: number) => void;
+    /** Attach a ResizeObserver to `el` to auto-measure the row height on resize. Returns disconnect fn. */
+    measureRowEl: (row: number, el: HTMLElement) => () => void;
+    /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */
+    prependRows: (additionalRowCount: number) => void;
+    refresh: () => void;
+    scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;
+    /** Scroll to bring a row into view without changing the horizontal position. */
+    scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;
+    /** Scroll to bring a column into view without changing the vertical position. */
+    scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;
+    update: (next: GridVirtualizerUpdateOptions) => void;
+    [Symbol.dispose]: () => void;
+}
+export declare function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer;
+//# sourceMappingURL=grid-virtualizer.d.ts.map

package/dist/grid-virtualizer.d.ts.map

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

package/dist/grid-virtualizer.js

@@ -0,0 +1,2 @@
+import{normalizeOverscan as e,observeResize as t,resolveEstimateFn as n,toNonNegativeInt as r,toPositiveNumber as i}from"./_utils.js";import{createScrollAdapter as a}from"./_adapter.js";import{createAxis1D as o}from"./_axis1d.js";function s(e,t,n,r,i,a){return a===`start`?e:a===`end`?t-i:a===`center`?e-(i-n)/2:e>=r&&t<=r+i?null:e<r?e:t-i}function c(c,l){let u=r(l.rowCount),d=r(l.colCount),f=n(l.estimateRowSize,36),p=n(l.estimateColSize,36),m=e(l.overscanY,3),h=e(l.overscanX,3),g=l.onChange,_=l.onRangeChange,v=l.rowMeasurementCache??new Map,y=l.colMeasurementCache??new Map,b=0,x=0,S=0,C=0,w=[],T=[],E=!1,D=o(u,e=>v.get(e)??f(e),r(l.rowGap??0)),O=o(d,e=>y.get(e)??p(e),r(l.colGap??0)),k=!1;function A(e){let t=Number.isFinite(e)?e:0;return Math.min(Math.max(0,D.totalSize-S),Math.max(0,t))}function j(e){let t=Number.isFinite(e)?e:0;return Math.min(Math.max(0,O.totalSize-C),Math.max(0,t))}function M(){if(E)return;let e=D.totalSize,t=O.totalSize;if(u===0||d===0||S<=0||C<=0){D.prevStart===-1&&D.prevTotalSize===e&&O.prevTotalSize===t||(D.commitDedup(-1,-1),O.commitDedup(-1,-1),w=[],T=[],g?.({cols:[],rows:[],totalHeight:e,totalWidth:t}));return}let{renderEnd:n,renderStart:r}=D.computeRange(b,b+S,m.start,m.end),{renderEnd:i,renderStart:a}=O.computeRange(x,x+C,h.start,h.end),o=D.isDedupSame(r,n),s=O.isDedupSame(a,i);if(o&&s)return;D.commitDedup(r,n),O.commitDedup(a,i),(!o||!s)&&_&&_({firstCol:a,firstRow:r,lastCol:i,lastRow:n});let c=[];for(let e=r;e<=n;e++)c.push(D.itemAt(e));let l=[];for(let e=a;e<=i;e++)l.push(O.itemAt(e));w=c,T=l,g?.({cols:T,rows:w,totalHeight:e,totalWidth:t})}function N(e,t){if(!Number.isFinite(e))return!1;let n=Math.floor(e);if(n<0||n>=u)return!1;let r=i(t,-1);return r<=0||v.get(n)===r?!1:(v.set(n,r),D.markChanged(n),!0)}function P(e,t){if(!Number.isFinite(e))return!1;let n=Math.floor(e);if(n<0||n>=d)return!1;let r=i(t,-1);return r<=0||y.get(n)===r?!1:(y.set(n,r),O.markChanged(n),!0)}function F(){k||(k=!0,queueMicrotask(()=>{k=!1;let e=D.consumeMinChangedIndex();e!==1/0&&D.rebuildFrom(e);let t=O.consumeMinChangedIndex();t!==1/0&&O.rebuildFrom(t),M()}))}function I(e,t){E||N(e,t)&&F()}function L(e,t){E||P(e,t)&&F()}function R(e,t){if(E)return;let n=!1;for(let{index:t,size:r}of e)N(t,r)&&(n=!0);for(let{index:e,size:r}of t)P(e,r)&&(n=!0);n&&F()}function z(e,n){return E?()=>{}:t(J.signal,n,t=>I(e,t.contentRect.height))}function B(e,n){return E?()=>{}:t(J.signal,n,t=>L(e,t.contentRect.width))}function V(){E||(v.clear(),y.clear(),D.rebuild(!0),O.rebuild(!0),M())}function H(){E||(D.rebuild(!0),O.rebuild(!0),M())}function U(e){if(E)return;let t=r(e);if(t===0)return;u+=t,D.setCount(u),D.rebuild(!0);let n=D.startAt(t),i=A(b+n);Q.scrollTo(x,i,`auto`),b=i,M()}function W(e,t={}){if(E||u===0)return;let n=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),u-1)),r=t.behavior??`auto`,i=D.startAt(n),a=D.sizeAt(n),o=s(i,i+a,a,b,S,t.rowAlign??`auto`);o!==null&&Q.scrollTo(x,A(o),r)}function G(e,t={}){if(E||d===0)return;let n=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),d-1)),r=t.behavior??`auto`,i=O.startAt(n),a=O.sizeAt(n),o=s(i,i+a,a,x,C,t.colAlign??`auto`);o!==null&&Q.scrollTo(j(o),b,r)}function K(e,t,n={}){if(E||u===0||d===0)return;let r=Math.max(0,Math.min(Math.floor(Number.isFinite(e)?e:0),u-1)),i=Math.max(0,Math.min(Math.floor(Number.isFinite(t)?t:0),d-1)),a=n.behavior??`auto`,o=D.startAt(r),c=D.sizeAt(r),l=O.startAt(i),f=O.sizeAt(i),p=s(o,o+c,c,b,S,n.rowAlign??`auto`),m=s(l,l+f,f,x,C,n.colAlign??`auto`);p===null&&m===null||Q.scrollTo(m===null?x:j(m),p===null?b:A(p),a)}function q(t){if(E)return;let i=!1,a=!1,o=!1;if(t.rowCount!==void 0){let e=r(t.rowCount);e!==u&&(u=e,D.setCount(u),i=!0)}if(t.colCount!==void 0){let e=r(t.colCount);e!==d&&(d=e,O.setCount(d),a=!0)}if(t.rowGap!==void 0){let e=r(t.rowGap);e!==D.gap&&(D.setGap(e),i=!0)}if(t.colGap!==void 0){let e=r(t.colGap);e!==O.gap&&(O.setGap(e),a=!0)}if(`estimateRowSize`in t&&(f=n(t.estimateRowSize,36),v.clear(),i=!0),`estimateColSize`in t&&(p=n(t.estimateColSize,36),y.clear(),a=!0),t.overscanY!==void 0){let n=e(t.overscanY,3);(n.start!==m.start||n.end!==m.end)&&(m=n,o=!0)}if(t.overscanX!==void 0){let n=e(t.overscanX,3);(n.start!==h.start||n.end!==h.end)&&(h=n,o=!0)}i&&D.rebuild(!0),a&&O.rebuild(!0),(i||a||o)&&M()}let J=new AbortController;function Y(){E||(E=!0,J.abort(),Q.detach())}function X(){b=A(Q.y.readOffset()),x=j(Q.x.readOffset()),M()}function Z(){S=Q.y.readViewportSize(),C=Q.x.readViewportSize(),M()}let Q=a(c,X,Z);return D.rebuild(!0),O.rebuild(!0),S=Q.y.readViewportSize(),C=Q.x.readViewportSize(),l.initialScrollTop===void 0?l.initialScrollLeft!==void 0&&Q.scrollTo(j(l.initialScrollLeft),0,`auto`):Q.scrollTo(l.initialScrollLeft??0,A(l.initialScrollTop),`auto`),b=A(Q.y.readOffset()),x=j(Q.x.readOffset()),M(),{get cols(){return T},get disposalSignal(){return J.signal},dispose:Y,get disposed(){return E},invalidate:V,measureBatch:R,measureColEl:B,measureColumn:L,measureRow:I,measureRowEl:z,prependRows:U,refresh:H,get rows(){return w},get scrollLeft(){return x},scrollToCell:K,scrollToColumn:G,get scrollTop(){return b},scrollToRow:W,[Symbol.dispose]:Y,get totalHeight(){return D.totalSize},get totalWidth(){return O.totalSize},update:q}}export{c as createGridVirtualizer};
+//# sourceMappingURL=grid-virtualizer.js.map

package/dist/grid-virtualizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-virtualizer.js","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import { createScrollAdapter } from './_adapter';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  observeResize,\n  type Overscan,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\n\nexport { type VirtualItem };\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport interface GridVirtualizerState {\n  /**\n   * Visible column descriptors.\n   * Callers form the cross-product `rows × cols` as needed — no O(r×c) Cell\n   * allocation per scroll tick (R8).\n   */\n  readonly cols: VirtualItem[];\n  /** Visible row descriptors. */\n  readonly rows: VirtualItem[];\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n}\n\nexport interface GridRangeChangeEvent {\n  firstCol: number;\n  firstRow: number;\n  lastCol: number;\n  lastRow: number;\n}\n\nexport interface ScrollToCellOptions {\n  behavior?: ScrollBehavior;\n  colAlign?: 'auto' | 'center' | 'end' | 'start';\n  rowAlign?: 'auto' | 'center' | 'end' | 'start';\n}\n\nexport interface GridVirtualizerOptions {\n  colCount: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /**\n   * Called after every render cycle with the new state.\n   * **Fixed at construction** \\u2014 cannot be changed after creation.\n   */\n  onChange?: (state: GridVirtualizerState) => void;\n  /** Zero-allocation alternative to onChange for range-based consumers. */\n  onRangeChange?: (range: GridRangeChangeEvent) => void;\n  overscanX?: Overscan;\n  overscanY?: Overscan;\n  rowCount: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  rowGap?: number;\n}\n\n/**\n * Options accepted by `update()`. Explicit interface instead of\n * `Partial<Omit<...>>` for better IDE hover (R7).\n */\nexport interface GridVirtualizerUpdateOptions {\n  colCount?: number;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  overscanX?: Overscan;\n  overscanY?: Overscan;\n  rowCount?: number;\n  rowGap?: number;\n}\n\nexport interface GridVirtualizer {\n  readonly cols: VirtualItem[];\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\n  readonly scrollTop: number;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  dispose: () => void;\n  invalidate: () => void;\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  measureBatch: (rows: Array<{ index: number; size: number }>, cols: Array<{ index: number; size: number }>) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the column width on resize. Returns disconnect fn. */\n  measureColEl: (col: number, el: HTMLElement) => () => void;\n  measureColumn: (col: number, size: number) => void;\n  measureRow: (row: number, size: number) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the row height on resize. Returns disconnect fn. */\n  measureRowEl: (row: number, el: HTMLElement) => () => void;\n  /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */\n  prependRows: (additionalRowCount: number) => void;\n  refresh: () => void;\n  scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;\n  /** Scroll to bring a row into view without changing the horizontal position. */\n  scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Align helper ─────────────────────────────────────────────────────────────\n\nfunction alignOffset(\n  itemStart: number,\n  itemEnd: number,\n  itemSize: number,\n  currentOffset: number,\n  viewportSize: number,\n  align: 'auto' | 'center' | 'end' | 'start',\n): number | null {\n  if (align === 'start') return itemStart;\n\n  if (align === 'end') return itemEnd - viewportSize;\n\n  if (align === 'center') return itemStart - (viewportSize - itemSize) / 2;\n\n  // auto: no-op when already fully visible\n  if (itemStart >= currentOffset && itemEnd <= currentOffset + viewportSize) return null;\n\n  return itemStart < currentOffset ? itemStart : itemEnd - viewportSize;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  let rowCount = toNonNegativeInt(options.rowCount);\n  let colCount = toNonNegativeInt(options.colCount);\n  let estimateRowFn = resolveEstimateFn(options.estimateRowSize, DEFAULT_ESTIMATE_SIZE);\n  let estimateColFn = resolveEstimateFn(options.estimateColSize, DEFAULT_ESTIMATE_SIZE);\n  let overscanY = normalizeOverscan(options.overscanY, DEFAULT_OVERSCAN);\n  let overscanX = normalizeOverscan(options.overscanX, DEFAULT_OVERSCAN);\n\n  // Callbacks fixed at construction.\n  const onChange = options.onChange;\n  const onRangeChange = options.onRangeChange;\n\n  // External or internal measurement caches (numeric row/col index keys).\n  const measuredRows: Map<number, number> = options.rowMeasurementCache ?? new Map();\n  const measuredCols: Map<number, number> = options.colMeasurementCache ?? new Map();\n\n  let scrollTop = 0;\n  let scrollLeft = 0;\n  let viewportHeight = 0;\n  let viewportWidth = 0;\n  let rows: VirtualItem[] = [];\n  let cols: VirtualItem[] = [];\n  let disposed = false;\n\n  // ─── Axis1D instances (R1) ─────────────────────────────────────────────────\n  // sizeAt closures capture live `measuredRows/Cols` and `estimateFn` vars.\n\n  const rowAx = createAxis1D(\n    rowCount,\n    (r) => measuredRows.get(r) ?? estimateRowFn(r),\n    toNonNegativeInt(options.rowGap ?? 0),\n  );\n\n  const colAx = createAxis1D(\n    colCount,\n    (c) => measuredCols.get(c) ?? estimateColFn(c),\n    toNonNegativeInt(options.colGap ?? 0),\n  );\n\n  // R4: Single coordinated flush flag — prevents two separate microtasks.\n  let pendingBatchBuild = false;\n\n  // ─── Clamping ──────────────────────────────────────────────────────────────\n\n  function clampTop(offset: number): number {\n    const safe = Number.isFinite(offset) ? offset : 0;\n\n    return Math.min(Math.max(0, rowAx.totalSize - viewportHeight), Math.max(0, safe));\n  }\n\n  function clampLeft(offset: number): number {\n    const safe = Number.isFinite(offset) ? offset : 0;\n\n    return Math.min(Math.max(0, colAx.totalSize - viewportWidth), Math.max(0, safe));\n  }\n\n  // ─── Compute and emit ──────────────────────────────────────────────────────\n\n  function computeVisible(): void {\n    if (disposed) return;\n\n    const totalHeight = rowAx.totalSize;\n    const totalWidth = colAx.totalSize;\n\n    if (rowCount === 0 || colCount === 0 || viewportHeight <= 0 || viewportWidth <= 0) {\n      const wasEmpty =\n        rowAx.prevStart === -1 && rowAx.prevTotalSize === totalHeight && colAx.prevTotalSize === totalWidth;\n\n      if (!wasEmpty) {\n        // commitDedup(-1, -1) captures the current totalSize so the guard doesn't\n        // fire on every subsequent event while the empty state persists (Bug 2).\n        rowAx.commitDedup(-1, -1);\n        colAx.commitDedup(-1, -1);\n        rows = [];\n        cols = [];\n        onChange?.({ cols: [], rows: [], totalHeight, totalWidth });\n      }\n\n      return;\n    }\n\n    const { renderEnd: renderLastRow, renderStart: renderFirstRow } = rowAx.computeRange(\n      scrollTop,\n      scrollTop + viewportHeight,\n      overscanY.start,\n      overscanY.end,\n    );\n\n    const { renderEnd: renderLastCol, renderStart: renderFirstCol } = colAx.computeRange(\n      scrollLeft,\n      scrollLeft + viewportWidth,\n      overscanX.start,\n      overscanX.end,\n    );\n\n    const rowSame = rowAx.isDedupSame(renderFirstRow, renderLastRow);\n    const colSame = colAx.isDedupSame(renderFirstCol, renderLastCol);\n\n    if (rowSame && colSame) return;\n\n    rowAx.commitDedup(renderFirstRow, renderLastRow);\n    colAx.commitDedup(renderFirstCol, renderLastCol);\n\n    const rangeChanged = !rowSame || !colSame;\n\n    if (rangeChanged && onRangeChange) {\n      onRangeChange({\n        firstCol: renderFirstCol,\n        firstRow: renderFirstRow,\n        lastCol: renderLastCol,\n        lastRow: renderLastRow,\n      });\n    }\n\n    // R8: Build rows[] and cols[] separately — no cross-product VirtualCell[].\n    const nextRows: VirtualItem[] = [];\n\n    for (let r = renderFirstRow; r <= renderLastRow; r++) {\n      nextRows.push(rowAx.itemAt(r));\n    }\n\n    const nextCols: VirtualItem[] = [];\n\n    for (let c = renderFirstCol; c <= renderLastCol; c++) {\n      nextCols.push(colAx.itemAt(c));\n    }\n\n    rows = nextRows;\n    cols = nextCols;\n\n    onChange?.({ cols, rows, totalHeight, totalWidth });\n  }\n\n  // ─── Measurement helpers ───────────────────────────────────────────────────\n\n  function recordRowMeasurement(row: number, size: number): boolean {\n    if (!Number.isFinite(row)) return false;\n\n    const r = Math.floor(row);\n\n    if (r < 0 || r >= rowCount) return false;\n\n    const s = toPositiveNumber(size, -1);\n\n    if (s <= 0) return false;\n\n    if (measuredRows.get(r) === s) return false;\n\n    measuredRows.set(r, s);\n    rowAx.markChanged(r);\n\n    return true;\n  }\n\n  function recordColMeasurement(col: number, size: number): boolean {\n    if (!Number.isFinite(col)) return false;\n\n    const c = Math.floor(col);\n\n    if (c < 0 || c >= colCount) return false;\n\n    const s = toPositiveNumber(size, -1);\n\n    if (s <= 0) return false;\n\n    if (measuredCols.get(c) === s) return false;\n\n    measuredCols.set(c, s);\n    colAx.markChanged(c);\n\n    return true;\n  }\n\n  /**\n   * R4: Single coordinated flush for both axes.\n   * Replaces the previous two independent microtask schedules.\n   */\n  function scheduleFlush(): void {\n    if (pendingBatchBuild) return;\n\n    pendingBatchBuild = true;\n    queueMicrotask(() => {\n      pendingBatchBuild = false;\n\n      // consumeMinChangedIndex() atomically reads and resets minChangedIndex.\n      // Without the reset, every subsequent flush would rebuild from index 0\n      // instead of the actual earliest changed index (Bug 3).\n      const fromRow = rowAx.consumeMinChangedIndex();\n\n      if (fromRow !== Infinity) rowAx.rebuildFrom(fromRow);\n\n      const fromCol = colAx.consumeMinChangedIndex();\n\n      if (fromCol !== Infinity) colAx.rebuildFrom(fromCol);\n\n      computeVisible();\n    });\n  }\n\n  // ─── Public measurement API ────────────────────────────────────────────────\n\n  function measureRow(row: number, size: number): void {\n    if (disposed) return;\n\n    if (recordRowMeasurement(row, size)) scheduleFlush();\n  }\n\n  function measureColumn(col: number, size: number): void {\n    if (disposed) return;\n\n    if (recordColMeasurement(col, size)) scheduleFlush();\n  }\n\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  function measureBatch(\n    rowEntries: Array<{ index: number; size: number }>,\n    colEntries: Array<{ index: number; size: number }>,\n  ): void {\n    if (disposed) return;\n\n    let changed = false;\n\n    for (const { index, size } of rowEntries) {\n      if (recordRowMeasurement(index, size)) changed = true;\n    }\n\n    for (const { index, size } of colEntries) {\n      if (recordColMeasurement(index, size)) changed = true;\n    }\n\n    if (changed) scheduleFlush();\n  }\n\n  function measureRowEl(row: number, el: HTMLElement): () => void {\n    if (disposed) return () => {};\n\n    return observeResize(ac.signal, el, (entry) => measureRow(row, entry.contentRect.height));\n  }\n\n  function measureColEl(col: number, el: HTMLElement): () => void {\n    if (disposed) return () => {};\n\n    return observeResize(ac.signal, el, (entry) => measureColumn(col, entry.contentRect.width));\n  }\n\n  function invalidate(): void {\n    if (disposed) return;\n\n    measuredRows.clear();\n    measuredCols.clear();\n    rowAx.rebuild(true);\n    colAx.rebuild(true);\n    computeVisible();\n  }\n\n  function refresh(): void {\n    if (disposed) return;\n\n    rowAx.rebuild(true);\n    colAx.rebuild(true);\n    computeVisible();\n  }\n\n  function prependRows(additionalRowCount: number): void {\n    if (disposed) return;\n\n    const n = toNonNegativeInt(additionalRowCount);\n\n    if (n === 0) return;\n\n    rowCount += n;\n    rowAx.setCount(rowCount);\n    rowAx.rebuild(true);\n\n    const prependedHeight = rowAx.startAt(n);\n    const newScrollTop = clampTop(scrollTop + prependedHeight);\n\n    adapter.scrollTo(scrollLeft, newScrollTop, 'auto');\n    scrollTop = newScrollTop;\n\n    computeVisible();\n  }\n\n  function scrollToRow(row: number, opts: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'> = {}): void {\n    if (disposed || rowCount === 0) return;\n\n    const safeRow = Math.max(0, Math.min(Math.floor(Number.isFinite(row) ? row : 0), rowCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n    const rowStart = rowAx.startAt(safeRow);\n    const rowSize = rowAx.sizeAt(safeRow);\n    const targetTop = alignOffset(\n      rowStart,\n      rowStart + rowSize,\n      rowSize,\n      scrollTop,\n      viewportHeight,\n      opts.rowAlign ?? 'auto',\n    );\n\n    if (targetTop === null) return;\n\n    adapter.scrollTo(scrollLeft, clampTop(targetTop), behavior);\n  }\n\n  function scrollToColumn(col: number, opts: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'> = {}): void {\n    if (disposed || colCount === 0) return;\n\n    const safeCol = Math.max(0, Math.min(Math.floor(Number.isFinite(col) ? col : 0), colCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n    const colStart = colAx.startAt(safeCol);\n    const colSize = colAx.sizeAt(safeCol);\n    const targetLeft = alignOffset(\n      colStart,\n      colStart + colSize,\n      colSize,\n      scrollLeft,\n      viewportWidth,\n      opts.colAlign ?? 'auto',\n    );\n\n    if (targetLeft === null) return;\n\n    adapter.scrollTo(clampLeft(targetLeft), scrollTop, behavior);\n  }\n\n  function scrollToCell(row: number, col: number, opts: ScrollToCellOptions = {}): void {\n    if (disposed || rowCount === 0 || colCount === 0) return;\n\n    const safeRow = Math.max(0, Math.min(Math.floor(Number.isFinite(row) ? row : 0), rowCount - 1));\n    const safeCol = Math.max(0, Math.min(Math.floor(Number.isFinite(col) ? col : 0), colCount - 1));\n    const behavior = opts.behavior ?? 'auto';\n\n    const rowStart = rowAx.startAt(safeRow);\n    const rowSize = rowAx.sizeAt(safeRow);\n    const colStart = colAx.startAt(safeCol);\n    const colSize = colAx.sizeAt(safeCol);\n\n    const targetTop = alignOffset(\n      rowStart,\n      rowStart + rowSize,\n      rowSize,\n      scrollTop,\n      viewportHeight,\n      opts.rowAlign ?? 'auto',\n    );\n    const targetLeft = alignOffset(\n      colStart,\n      colStart + colSize,\n      colSize,\n      scrollLeft,\n      viewportWidth,\n      opts.colAlign ?? 'auto',\n    );\n\n    if (targetTop === null && targetLeft === null) return;\n\n    adapter.scrollTo(\n      targetLeft !== null ? clampLeft(targetLeft) : scrollLeft,\n      targetTop !== null ? clampTop(targetTop) : scrollTop,\n      behavior,\n    );\n  }\n\n  function update(next: GridVirtualizerUpdateOptions): void {\n    if (disposed) return;\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (next.rowCount !== undefined) {\n      const n = toNonNegativeInt(next.rowCount);\n\n      if (n !== rowCount) {\n        rowCount = n;\n        rowAx.setCount(rowCount);\n        rebuildRows = true;\n      }\n    }\n\n    if (next.colCount !== undefined) {\n      const n = toNonNegativeInt(next.colCount);\n\n      if (n !== colCount) {\n        colCount = n;\n        colAx.setCount(colCount);\n        rebuildCols = true;\n      }\n    }\n\n    if (next.rowGap !== undefined) {\n      const n = toNonNegativeInt(next.rowGap);\n\n      if (n !== rowAx.gap) {\n        rowAx.setGap(n);\n        rebuildRows = true;\n      }\n    }\n\n    if (next.colGap !== undefined) {\n      const n = toNonNegativeInt(next.colGap);\n\n      if (n !== colAx.gap) {\n        colAx.setGap(n);\n        rebuildCols = true;\n      }\n    }\n\n    if ('estimateRowSize' in next) {\n      estimateRowFn = resolveEstimateFn(next.estimateRowSize, DEFAULT_ESTIMATE_SIZE);\n      measuredRows.clear();\n      rebuildRows = true;\n    }\n\n    if ('estimateColSize' in next) {\n      estimateColFn = resolveEstimateFn(next.estimateColSize, DEFAULT_ESTIMATE_SIZE);\n      measuredCols.clear();\n      rebuildCols = true;\n    }\n\n    if (next.overscanY !== undefined) {\n      const n = normalizeOverscan(next.overscanY, DEFAULT_OVERSCAN);\n\n      if (n.start !== overscanY.start || n.end !== overscanY.end) {\n        overscanY = n;\n        needsCompute = true;\n      }\n    }\n\n    if (next.overscanX !== undefined) {\n      const n = normalizeOverscan(next.overscanX, DEFAULT_OVERSCAN);\n\n      if (n.start !== overscanX.start || n.end !== overscanX.end) {\n        overscanX = n;\n        needsCompute = true;\n      }\n    }\n\n    if (rebuildRows) rowAx.rebuild(true);\n\n    if (rebuildCols) colAx.rebuild(true);\n\n    if (rebuildRows || rebuildCols || needsCompute) computeVisible();\n  }\n\n  const ac = new AbortController();\n\n  function disposeImpl(): void {\n    if (disposed) return;\n\n    disposed = true;\n    ac.abort();\n    adapter.detach();\n  }\n\n  // ─── Bootstrap (R9: read viewport BEFORE writing initial scroll) ───────────\n\n  function handleScroll(): void {\n    scrollTop = clampTop(adapter.y.readOffset());\n    scrollLeft = clampLeft(adapter.x.readOffset());\n    computeVisible();\n  }\n\n  function handleResize(): void {\n    viewportHeight = adapter.y.readViewportSize();\n    viewportWidth = adapter.x.readViewportSize();\n    computeVisible();\n  }\n\n  const adapter = createScrollAdapter(target, handleScroll, handleResize);\n\n  rowAx.rebuild(true);\n  colAx.rebuild(true);\n\n  // R9: Read viewport dimensions BEFORE writing initial scroll positions so that\n  // computeVisible() sees a valid viewport on the very first call.\n  viewportHeight = adapter.y.readViewportSize();\n  viewportWidth = adapter.x.readViewportSize();\n\n  if (options.initialScrollTop !== undefined) {\n    adapter.scrollTo(options.initialScrollLeft ?? 0, clampTop(options.initialScrollTop), 'auto');\n  } else if (options.initialScrollLeft !== undefined) {\n    adapter.scrollTo(clampLeft(options.initialScrollLeft), 0, 'auto');\n  }\n\n  scrollTop = clampTop(adapter.y.readOffset());\n  scrollLeft = clampLeft(adapter.x.readOffset());\n\n  computeVisible();\n\n  return {\n    get cols() {\n      return cols;\n    },\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose: disposeImpl,\n    get disposed() {\n      return disposed;\n    },\n    invalidate,\n    measureBatch,\n    measureColEl,\n    measureColumn,\n    measureRow,\n    measureRowEl,\n    prependRows,\n    refresh,\n    get rows() {\n      return rows;\n    },\n    get scrollLeft() {\n      return scrollLeft;\n    },\n    scrollToCell,\n    scrollToColumn,\n    get scrollTop() {\n      return scrollTop;\n    },\n    scrollToRow,\n    [Symbol.dispose]: disposeImpl,\n    get totalHeight() {\n      return rowAx.totalSize;\n    },\n    get totalWidth() {\n      return colAx.totalSize;\n    },\n    update,\n  };\n}\n"],"mappings":"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"}

package/dist/grouped-virtualizer.cjs

@@ -0,0 +1,2 @@
+const e=require("./_utils.cjs"),t=require("./virtualizer.cjs");function n(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n];t.push({isHeader:!0,itemIndex:-1,label:r.label,sectionIndex:n});for(let e=0;e<r.items.length;e++)t.push({isHeader:!1,item:r.items[e],itemIndex:e,sectionIndex:n})}return t}function r(r,i){let a=i.sections,o=n(a);function s(t){return typeof t==`function`?e=>{let n=o[e];return t(a[n.sectionIndex],n.sectionIndex)}:e.resolveEstimateFn(typeof t==`number`?t:void 0,36)}let c=s(i.estimateHeaderSize),l=typeof i.estimateItemSize==`function`?i.estimateItemSize:null,u=l?null:e.resolveEstimateFn(typeof i.estimateItemSize==`number`?i.estimateItemSize:void 0,36),d=i.getItemKey;function f(e){let t=o[e];return t?t.isHeader?c(e):l?l(t.item,t.itemIndex,t.sectionIndex):u(e):36}function p(e){let t=o[e];return t?t.isHeader?`__header_${t.sectionIndex}`:d?d(t.item,t.itemIndex,t.sectionIndex):e:e}let m=!1,h=[];function g(e){let t=[],n=[],r=null;for(let r of e.items){let e=o[r.index];e&&(e.isHeader?n.push({...r,label:e.label??``,sectionIndex:e.sectionIndex}):t.push({...r,data:e.item,itemIndex:e.itemIndex,sectionIndex:e.sectionIndex}))}if(e.stickyItems.length>0){let t=e.stickyItems[0],n=o[t.index];n?.isHeader&&(r={...t,label:n.label??``,sectionIndex:n.sectionIndex})}return h=t,{headers:n,items:t,stickyHeader:r,totalSize:e.totalSize}}let _=t.createVirtualizer(r,{count:o.length,estimateSize:f,getItemKey:p,horizontal:i.horizontal,measurementCache:i.measurementCache,onChange:e=>{let t=g(e);i.onChange?.(t)},onScrollEnd:i.onScrollEnd,onScrollingChange:i.onScrollingChange,overscan:i.overscan??3,scrollEndDelay:i.scrollEndDelay,sticky:e=>o[e]?.isHeader??!1}),v=new AbortController;function y(){m||(m=!0,v.abort(),_.dispose())}function b(e,t){if(e<0||e>=a.length)return-1;let n=0;for(let r=0;r<a.length;r++){if(r===e)return t===void 0?n:n+1+t;n+=1+a[r].items.length}return-1}return{get count(){return _.count},get disposalSignal(){return v.signal},dispose:y,get disposed(){return m},invalidate(){m||_.invalidate()},get isScrolling(){return _.isScrolling},get items(){return h},measure(e,t){m||_.measure(e,t)},measureBatch(e){m||_.measureBatch(e)},measureEl(e,t){return m?()=>{}:_.measureEl(e,t)},refresh(){m||_.refresh()},get scrollOffset(){return _.scrollOffset},scrollToBottom(e){m||_.scrollToBottom(e)},scrollToIndex(e,t){m||_.scrollToIndex(e,t)},scrollToItem(e,t,n={}){if(m)return;let r=b(e,t);r<0||_.scrollToIndex(r,n)},scrollToOffset(e,t){m||_.scrollToOffset(e,t)},scrollToSection(e,t={}){if(m)return;let n=b(e);n<0||_.scrollToIndex(n,t)},scrollToTop(e){m||_.scrollToTop(e)},get stickyItems(){return _.stickyItems},[Symbol.dispose]:y,get totalSize(){return _.totalSize},update(t,r){if(m)return;r&&(r.estimateHeaderSize!==void 0&&(c=s(r.estimateHeaderSize)),r.estimateItemSize!==void 0&&(l=typeof r.estimateItemSize==`function`?r.estimateItemSize:null,u=l?null:e.resolveEstimateFn(typeof r.estimateItemSize==`number`?r.estimateItemSize:void 0,36)),r.getItemKey!==void 0&&(d=r.getItemKey)),a=t;let i=o.length;o=n(a);let f={count:o.length};r?.measurementCache!==void 0&&(f.measurementCache=r.measurementCache),r?.overscan!==void 0&&(f.overscan=r.overscan),o.length!==i||r?.measurementCache!==void 0||r?.overscan!==void 0?_.update(f):_.refresh()}}}exports.createGroupedVirtualizer=r;
+//# sourceMappingURL=grouped-virtualizer.cjs.map

package/dist/grouped-virtualizer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-virtualizer.cjs","names":[],"sources":["../src/grouped-virtualizer.ts"],"sourcesContent":["import { resolveEstimateFn } from './_utils';\nimport {\n  createVirtualizer,\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  type MeasurementCache,\n  type Overscan,\n  type ScrollTarget,\n  type ScrollToIndexOptions,\n  type VirtualItem,\n  type VirtualizerState,\n  type VirtualizerUpdateOptions,\n  type VirtualKey,\n} from './virtualizer';\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport interface GroupSection<T> {\n  items: T[];\n  label: string;\n}\n\nexport interface GroupVirtualItem<T> extends VirtualItem {\n  /** Item data. */\n  data: T;\n  /** Index within the section. */\n  itemIndex: number;\n  sectionIndex: number;\n}\n\nexport interface GroupVirtualHeader extends VirtualItem {\n  label: string;\n  sectionIndex: number;\n}\n\nexport interface GroupVirtualizerState<T> {\n  readonly headers: GroupVirtualHeader[];\n  readonly items: Array<GroupVirtualItem<T>>;\n  readonly stickyHeader: GroupVirtualHeader | null;\n  readonly totalSize: number;\n}\n\n/**\n * Options accepted by `GroupVirtualizer.update()`. Overrides are applied\n * together with the new sections on the next render cycle.\n *\n * Intentionally excludes: `horizontal` (axis cannot change at runtime),\n * `initialOffset` (one-time bootstrap), `onChange`/`onScrollEnd`/`onScrollingChange`\n * (fixed at construction).\n */\nexport interface GroupVirtualizerUpdateOptions<T> {\n  estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);\n  estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);\n  getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;\n  measurementCache?: MeasurementCache;\n  overscan?: Overscan;\n}\n\nexport interface GroupVirtualizerOptions<T> {\n  estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);\n  estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);\n  getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;\n  horizontal?: boolean;\n  measurementCache?: MeasurementCache;\n  /**\n   * Called after every render cycle with the new state.\n   * **Fixed at construction** \\u2014 cannot be changed after creation.\n   */\n  onChange?: (state: GroupVirtualizerState<T>) => void;\n  /**\n   * Called when scrolling has settled. Fixed at construction.\n   * See `VirtualizerOptions.onScrollEnd` for details.\n   */\n  onScrollEnd?: (offset: number) => void;\n  /**\n   * Called when the scrolling state changes. Fixed at construction.\n   */\n  onScrollingChange?: (isScrolling: boolean) => void;\n  overscan?: Overscan;\n  /**\n   * Debounce delay (ms) for scroll-end detection. Defaults to 150.\n   * See `VirtualizerOptions.scrollEndDelay` for details.\n   */\n  scrollEndDelay?: number;\n  sections: Array<GroupSection<T>>;\n}\n\nexport interface GroupVirtualizer<T> {\n  readonly count: number;\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  /** `true` while the user is actively scrolling; `false` once scroll has settled. */\n  readonly isScrolling: boolean;\n  readonly items: ReadonlyArray<GroupVirtualItem<T>>;\n  readonly scrollOffset: number;\n  readonly stickyItems: VirtualItem[];\n  readonly totalSize: number;\n  dispose: () => void;\n  invalidate: () => void;\n  measure: (index: number, size: number) => void;\n  measureBatch: (entries: Array<{ index: number; size: number }>) => void;\n  measureEl: (index: number, el: HTMLElement) => () => void;\n  refresh: () => void;\n  scrollToBottom: (options?: { behavior?: ScrollBehavior }) => void;\n  scrollToIndex: (index: number, options?: ScrollToIndexOptions) => void;\n  scrollToItem: (sectionIndex: number, itemIndex: number, options?: ScrollToIndexOptions) => void;\n  scrollToOffset: (offset: number, options?: { behavior?: ScrollBehavior }) => void;\n  scrollToSection: (sectionIndex: number, options?: ScrollToIndexOptions) => void;\n  scrollToTop: (options?: { behavior?: ScrollBehavior }) => void;\n  update: (sections: Array<GroupSection<T>>, opts?: GroupVirtualizerUpdateOptions<T>) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Flat entry map ───────────────────────────────────────────────────────────\n\ntype FlatHeader = { isHeader: true; itemIndex: -1; label: string; sectionIndex: number };\ntype FlatItem<T> = { isHeader: false; item: T; itemIndex: number; sectionIndex: number };\ntype FlatEntry<T> = FlatHeader | FlatItem<T>;\n\nfunction buildFlatEntries<T>(sections: Array<GroupSection<T>>): FlatEntry<T>[] {\n  const flat: FlatEntry<T>[] = [];\n\n  for (let s = 0; s < sections.length; s++) {\n    const section = sections[s]!;\n\n    flat.push({ isHeader: true, itemIndex: -1, label: section.label, sectionIndex: s });\n\n    for (let i = 0; i < section.items.length; i++) {\n      flat.push({ isHeader: false, item: section.items[i]!, itemIndex: i, sectionIndex: s });\n    }\n  }\n\n  return flat;\n}\n\n// ─── Implementation ───────────────────────────────────────────────────────────\n\nexport function createGroupedVirtualizer<T>(\n  target: ScrollTarget,\n  options: GroupVirtualizerOptions<T>,\n): GroupVirtualizer<T> {\n  let sections = options.sections;\n  let flat = buildFlatEntries(sections);\n\n  function buildEstimateHeader(\n    estimateHeaderSize: GroupVirtualizerOptions<T>['estimateHeaderSize'],\n  ): (index: number) => number {\n    return typeof estimateHeaderSize === 'function'\n      ? (index: number) => {\n          const entry = flat[index]!;\n\n          return (estimateHeaderSize as (section: GroupSection<T>, sectionIndex: number) => number)(\n            sections[entry.sectionIndex]!,\n            entry.sectionIndex,\n          );\n        }\n      : resolveEstimateFn(\n          typeof estimateHeaderSize === 'number' ? estimateHeaderSize : undefined,\n          DEFAULT_ESTIMATE_SIZE,\n        );\n  }\n\n  let estimateHeaderFn = buildEstimateHeader(options.estimateHeaderSize);\n  let estimateItemUserFn: ((item: T, itemIndex: number, sectionIndex: number) => number) | null =\n    typeof options.estimateItemSize === 'function' ? options.estimateItemSize : null;\n  let estimateItemFixedFn: ((index: number) => number) | null = estimateItemUserFn\n    ? null\n    : resolveEstimateFn(\n        typeof options.estimateItemSize === 'number' ? options.estimateItemSize : undefined,\n        DEFAULT_ESTIMATE_SIZE,\n      );\n  let userGetItemKey = options.getItemKey;\n\n  function estimateFn(globalIndex: number): number {\n    const entry = flat[globalIndex];\n\n    if (!entry) return DEFAULT_ESTIMATE_SIZE;\n\n    if (entry.isHeader) return estimateHeaderFn(globalIndex);\n\n    if (estimateItemUserFn) return estimateItemUserFn(entry.item, entry.itemIndex, entry.sectionIndex);\n\n    return estimateItemFixedFn!(globalIndex);\n  }\n\n  function getItemKey(globalIndex: number): VirtualKey {\n    const entry = flat[globalIndex];\n\n    if (!entry) return globalIndex;\n\n    if (entry.isHeader) return `__header_${entry.sectionIndex}`;\n\n    if (userGetItemKey) return userGetItemKey(entry.item, entry.itemIndex, entry.sectionIndex);\n\n    return globalIndex;\n  }\n\n  let destroyed = false;\n  let lastItems: Array<GroupVirtualItem<T>> = [];\n\n  function mapState(state: VirtualizerState): GroupVirtualizerState<T> {\n    const items: Array<GroupVirtualItem<T>> = [];\n    const headers: GroupVirtualHeader[] = [];\n    let stickyHeader: GroupVirtualHeader | null = null;\n\n    for (const vi of state.items) {\n      const entry = flat[vi.index];\n\n      if (!entry) continue;\n\n      if (entry.isHeader) {\n        headers.push({ ...vi, label: entry.label ?? '', sectionIndex: entry.sectionIndex });\n      } else {\n        items.push({ ...vi, data: entry.item, itemIndex: entry.itemIndex, sectionIndex: entry.sectionIndex });\n      }\n    }\n\n    if (state.stickyItems.length > 0) {\n      const svi = state.stickyItems[0]!;\n      const entry = flat[svi.index];\n\n      if (entry?.isHeader) {\n        stickyHeader = { ...svi, label: entry.label ?? '', sectionIndex: entry.sectionIndex };\n      }\n    }\n\n    lastItems = items;\n\n    return { headers, items, stickyHeader, totalSize: state.totalSize };\n  }\n\n  const virtualizer = createVirtualizer(target, {\n    count: flat.length,\n    estimateSize: estimateFn,\n    getItemKey,\n    horizontal: options.horizontal,\n    measurementCache: options.measurementCache,\n    onChange: (state) => {\n      const mapped = mapState(state);\n\n      options.onChange?.(mapped);\n    },\n    onScrollEnd: options.onScrollEnd,\n    onScrollingChange: options.onScrollingChange,\n    overscan: options.overscan ?? DEFAULT_OVERSCAN,\n    scrollEndDelay: options.scrollEndDelay,\n    sticky: (i) => flat[i]?.isHeader ?? false,\n  });\n\n  const ac = new AbortController();\n\n  function _dispose(): void {\n    if (destroyed) return;\n\n    destroyed = true;\n    ac.abort();\n    virtualizer.dispose();\n  }\n\n  // Build a flat-index lookup: [sectionIndex, itemIndex] → flat index.\n  // Returns -1 when sectionIndex is out of range so callers can no-op safely.\n  function flatIndexOf(sectionIndex: number, itemIndex?: number): number {\n    if (sectionIndex < 0 || sectionIndex >= sections.length) return -1;\n\n    let pos = 0;\n\n    for (let s = 0; s < sections.length; s++) {\n      if (s === sectionIndex) {\n        if (itemIndex === undefined) return pos; // header\n\n        return pos + 1 + itemIndex;\n      }\n\n      pos += 1 + sections[s]!.items.length;\n    }\n\n    return -1; // unreachable\n  }\n\n  return {\n    get count() {\n      return virtualizer.count;\n    },\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose: _dispose,\n    get disposed() {\n      return destroyed;\n    },\n    invalidate() {\n      if (destroyed) return;\n\n      virtualizer.invalidate();\n    },\n    get isScrolling() {\n      return virtualizer.isScrolling;\n    },\n    get items() {\n      return lastItems;\n    },\n    measure(index: number, size: number) {\n      if (destroyed) return;\n\n      virtualizer.measure(index, size);\n    },\n    measureBatch(entries: Array<{ index: number; size: number }>) {\n      if (destroyed) return;\n\n      virtualizer.measureBatch(entries);\n    },\n    measureEl(index: number, el: HTMLElement) {\n      if (destroyed) return () => {};\n\n      return virtualizer.measureEl(index, el);\n    },\n    refresh() {\n      if (destroyed) return;\n\n      virtualizer.refresh();\n    },\n    get scrollOffset() {\n      return virtualizer.scrollOffset;\n    },\n    scrollToBottom(opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToBottom(opts);\n    },\n    scrollToIndex(index: number, opts?: ScrollToIndexOptions) {\n      if (destroyed) return;\n\n      virtualizer.scrollToIndex(index, opts);\n    },\n    scrollToItem(sectionIndex, itemIndex, opts = {}) {\n      if (destroyed) return;\n\n      const globalIndex = flatIndexOf(sectionIndex, itemIndex);\n\n      if (globalIndex < 0) return;\n\n      virtualizer.scrollToIndex(globalIndex, opts);\n    },\n    scrollToOffset(offset: number, opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToOffset(offset, opts);\n    },\n    scrollToSection(sectionIndex, opts = {}) {\n      if (destroyed) return;\n\n      const globalIndex = flatIndexOf(sectionIndex);\n\n      if (globalIndex < 0) return;\n\n      virtualizer.scrollToIndex(globalIndex, opts);\n    },\n    scrollToTop(opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToTop(opts);\n    },\n    get stickyItems() {\n      return virtualizer.stickyItems;\n    },\n    [Symbol.dispose]: _dispose,\n    get totalSize() {\n      return virtualizer.totalSize;\n    },\n    /**\n     * Replace all sections. Closures for estimateFn and getItemKey already\n     * capture the live `flat`/`sections` references — only count is passed to\n     * the underlying virtualizer to avoid discarding measured sizes on every\n     * data refresh. `refresh()` rebuilds offsets while preserving the cache.\n     */\n    update(nextSections, opts?: GroupVirtualizerUpdateOptions<T>) {\n      if (destroyed) return;\n\n      // Apply option overrides before rebuilding flat entries.\n      if (opts) {\n        if (opts.estimateHeaderSize !== undefined) {\n          estimateHeaderFn = buildEstimateHeader(opts.estimateHeaderSize);\n        }\n\n        if (opts.estimateItemSize !== undefined) {\n          estimateItemUserFn = typeof opts.estimateItemSize === 'function' ? opts.estimateItemSize : null;\n          estimateItemFixedFn = estimateItemUserFn\n            ? null\n            : resolveEstimateFn(\n                typeof opts.estimateItemSize === 'number' ? opts.estimateItemSize : undefined,\n                DEFAULT_ESTIMATE_SIZE,\n              );\n        }\n\n        if (opts.getItemKey !== undefined) userGetItemKey = opts.getItemKey;\n      }\n\n      sections = nextSections;\n\n      const prevCount = flat.length;\n\n      flat = buildFlatEntries(sections);\n\n      const virtUpdateOpts: VirtualizerUpdateOptions = { count: flat.length };\n\n      if (opts?.measurementCache !== undefined) virtUpdateOpts.measurementCache = opts.measurementCache;\n\n      if (opts?.overscan !== undefined) virtUpdateOpts.overscan = opts.overscan;\n\n      if (flat.length !== prevCount || opts?.measurementCache !== undefined || opts?.overscan !== undefined) {\n        virtualizer.update(virtUpdateOpts);\n      } else {\n        virtualizer.refresh();\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/grouped-virtualizer.d.ts

@@ -0,0 +1,101 @@
+import { type MeasurementCache, type Overscan, type ScrollTarget, type ScrollToIndexOptions, type VirtualItem, type VirtualKey } from './virtualizer';
+export interface GroupSection<T> {
+    items: T[];
+    label: string;
+}
+export interface GroupVirtualItem<T> extends VirtualItem {
+    /** Item data. */
+    data: T;
+    /** Index within the section. */
+    itemIndex: number;
+    sectionIndex: number;
+}
+export interface GroupVirtualHeader extends VirtualItem {
+    label: string;
+    sectionIndex: number;
+}
+export interface GroupVirtualizerState<T> {
+    readonly headers: GroupVirtualHeader[];
+    readonly items: Array<GroupVirtualItem<T>>;
+    readonly stickyHeader: GroupVirtualHeader | null;
+    readonly totalSize: number;
+}
+/**
+ * Options accepted by `GroupVirtualizer.update()`. Overrides are applied
+ * together with the new sections on the next render cycle.
+ *
+ * Intentionally excludes: `horizontal` (axis cannot change at runtime),
+ * `initialOffset` (one-time bootstrap), `onChange`/`onScrollEnd`/`onScrollingChange`
+ * (fixed at construction).
+ */
+export interface GroupVirtualizerUpdateOptions<T> {
+    estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);
+    estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);
+    getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;
+    measurementCache?: MeasurementCache;
+    overscan?: Overscan;
+}
+export interface GroupVirtualizerOptions<T> {
+    estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);
+    estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);
+    getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;
+    horizontal?: boolean;
+    measurementCache?: MeasurementCache;
+    /**
+     * Called after every render cycle with the new state.
+     * **Fixed at construction** \u2014 cannot be changed after creation.
+     */
+    onChange?: (state: GroupVirtualizerState<T>) => void;
+    /**
+     * Called when scrolling has settled. Fixed at construction.
+     * See `VirtualizerOptions.onScrollEnd` for details.
+     */
+    onScrollEnd?: (offset: number) => void;
+    /**
+     * Called when the scrolling state changes. Fixed at construction.
+     */
+    onScrollingChange?: (isScrolling: boolean) => void;
+    overscan?: Overscan;
+    /**
+     * Debounce delay (ms) for scroll-end detection. Defaults to 150.
+     * See `VirtualizerOptions.scrollEndDelay` for details.
+     */
+    scrollEndDelay?: number;
+    sections: Array<GroupSection<T>>;
+}
+export interface GroupVirtualizer<T> {
+    readonly count: number;
+    readonly disposalSignal: AbortSignal;
+    readonly disposed: boolean;
+    /** `true` while the user is actively scrolling; `false` once scroll has settled. */
+    readonly isScrolling: boolean;
+    readonly items: ReadonlyArray<GroupVirtualItem<T>>;
+    readonly scrollOffset: number;
+    readonly stickyItems: VirtualItem[];
+    readonly totalSize: number;
+    dispose: () => void;
+    invalidate: () => void;
+    measure: (index: number, size: number) => void;
+    measureBatch: (entries: Array<{
+        index: number;
+        size: number;
+    }>) => void;
+    measureEl: (index: number, el: HTMLElement) => () => void;
+    refresh: () => void;
+    scrollToBottom: (options?: {
+        behavior?: ScrollBehavior;
+    }) => void;
+    scrollToIndex: (index: number, options?: ScrollToIndexOptions) => void;
+    scrollToItem: (sectionIndex: number, itemIndex: number, options?: ScrollToIndexOptions) => void;
+    scrollToOffset: (offset: number, options?: {
+        behavior?: ScrollBehavior;
+    }) => void;
+    scrollToSection: (sectionIndex: number, options?: ScrollToIndexOptions) => void;
+    scrollToTop: (options?: {
+        behavior?: ScrollBehavior;
+    }) => void;
+    update: (sections: Array<GroupSection<T>>, opts?: GroupVirtualizerUpdateOptions<T>) => void;
+    [Symbol.dispose]: () => void;
+}
+export declare function createGroupedVirtualizer<T>(target: ScrollTarget, options: GroupVirtualizerOptions<T>): GroupVirtualizer<T>;
+//# sourceMappingURL=grouped-virtualizer.d.ts.map

package/dist/grouped-virtualizer.d.ts.map

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

package/dist/grouped-virtualizer.js

@@ -0,0 +1,2 @@
+import{resolveEstimateFn as e}from"./_utils.js";import{createVirtualizer as t}from"./virtualizer.js";function n(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n];t.push({isHeader:!0,itemIndex:-1,label:r.label,sectionIndex:n});for(let e=0;e<r.items.length;e++)t.push({isHeader:!1,item:r.items[e],itemIndex:e,sectionIndex:n})}return t}function r(r,i){let a=i.sections,o=n(a);function s(t){return typeof t==`function`?e=>{let n=o[e];return t(a[n.sectionIndex],n.sectionIndex)}:e(typeof t==`number`?t:void 0,36)}let c=s(i.estimateHeaderSize),l=typeof i.estimateItemSize==`function`?i.estimateItemSize:null,u=l?null:e(typeof i.estimateItemSize==`number`?i.estimateItemSize:void 0,36),d=i.getItemKey;function f(e){let t=o[e];return t?t.isHeader?c(e):l?l(t.item,t.itemIndex,t.sectionIndex):u(e):36}function p(e){let t=o[e];return t?t.isHeader?`__header_${t.sectionIndex}`:d?d(t.item,t.itemIndex,t.sectionIndex):e:e}let m=!1,h=[];function g(e){let t=[],n=[],r=null;for(let r of e.items){let e=o[r.index];e&&(e.isHeader?n.push({...r,label:e.label??``,sectionIndex:e.sectionIndex}):t.push({...r,data:e.item,itemIndex:e.itemIndex,sectionIndex:e.sectionIndex}))}if(e.stickyItems.length>0){let t=e.stickyItems[0],n=o[t.index];n?.isHeader&&(r={...t,label:n.label??``,sectionIndex:n.sectionIndex})}return h=t,{headers:n,items:t,stickyHeader:r,totalSize:e.totalSize}}let _=t(r,{count:o.length,estimateSize:f,getItemKey:p,horizontal:i.horizontal,measurementCache:i.measurementCache,onChange:e=>{let t=g(e);i.onChange?.(t)},onScrollEnd:i.onScrollEnd,onScrollingChange:i.onScrollingChange,overscan:i.overscan??3,scrollEndDelay:i.scrollEndDelay,sticky:e=>o[e]?.isHeader??!1}),v=new AbortController;function y(){m||(m=!0,v.abort(),_.dispose())}function b(e,t){if(e<0||e>=a.length)return-1;let n=0;for(let r=0;r<a.length;r++){if(r===e)return t===void 0?n:n+1+t;n+=1+a[r].items.length}return-1}return{get count(){return _.count},get disposalSignal(){return v.signal},dispose:y,get disposed(){return m},invalidate(){m||_.invalidate()},get isScrolling(){return _.isScrolling},get items(){return h},measure(e,t){m||_.measure(e,t)},measureBatch(e){m||_.measureBatch(e)},measureEl(e,t){return m?()=>{}:_.measureEl(e,t)},refresh(){m||_.refresh()},get scrollOffset(){return _.scrollOffset},scrollToBottom(e){m||_.scrollToBottom(e)},scrollToIndex(e,t){m||_.scrollToIndex(e,t)},scrollToItem(e,t,n={}){if(m)return;let r=b(e,t);r<0||_.scrollToIndex(r,n)},scrollToOffset(e,t){m||_.scrollToOffset(e,t)},scrollToSection(e,t={}){if(m)return;let n=b(e);n<0||_.scrollToIndex(n,t)},scrollToTop(e){m||_.scrollToTop(e)},get stickyItems(){return _.stickyItems},[Symbol.dispose]:y,get totalSize(){return _.totalSize},update(t,r){if(m)return;r&&(r.estimateHeaderSize!==void 0&&(c=s(r.estimateHeaderSize)),r.estimateItemSize!==void 0&&(l=typeof r.estimateItemSize==`function`?r.estimateItemSize:null,u=l?null:e(typeof r.estimateItemSize==`number`?r.estimateItemSize:void 0,36)),r.getItemKey!==void 0&&(d=r.getItemKey)),a=t;let i=o.length;o=n(a);let f={count:o.length};r?.measurementCache!==void 0&&(f.measurementCache=r.measurementCache),r?.overscan!==void 0&&(f.overscan=r.overscan),o.length!==i||r?.measurementCache!==void 0||r?.overscan!==void 0?_.update(f):_.refresh()}}}export{r as createGroupedVirtualizer};
+//# sourceMappingURL=grouped-virtualizer.js.map

package/dist/grouped-virtualizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-virtualizer.js","names":[],"sources":["../src/grouped-virtualizer.ts"],"sourcesContent":["import { resolveEstimateFn } from './_utils';\nimport {\n  createVirtualizer,\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  type MeasurementCache,\n  type Overscan,\n  type ScrollTarget,\n  type ScrollToIndexOptions,\n  type VirtualItem,\n  type VirtualizerState,\n  type VirtualizerUpdateOptions,\n  type VirtualKey,\n} from './virtualizer';\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport interface GroupSection<T> {\n  items: T[];\n  label: string;\n}\n\nexport interface GroupVirtualItem<T> extends VirtualItem {\n  /** Item data. */\n  data: T;\n  /** Index within the section. */\n  itemIndex: number;\n  sectionIndex: number;\n}\n\nexport interface GroupVirtualHeader extends VirtualItem {\n  label: string;\n  sectionIndex: number;\n}\n\nexport interface GroupVirtualizerState<T> {\n  readonly headers: GroupVirtualHeader[];\n  readonly items: Array<GroupVirtualItem<T>>;\n  readonly stickyHeader: GroupVirtualHeader | null;\n  readonly totalSize: number;\n}\n\n/**\n * Options accepted by `GroupVirtualizer.update()`. Overrides are applied\n * together with the new sections on the next render cycle.\n *\n * Intentionally excludes: `horizontal` (axis cannot change at runtime),\n * `initialOffset` (one-time bootstrap), `onChange`/`onScrollEnd`/`onScrollingChange`\n * (fixed at construction).\n */\nexport interface GroupVirtualizerUpdateOptions<T> {\n  estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);\n  estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);\n  getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;\n  measurementCache?: MeasurementCache;\n  overscan?: Overscan;\n}\n\nexport interface GroupVirtualizerOptions<T> {\n  estimateHeaderSize?: number | ((section: GroupSection<T>, sectionIndex: number) => number);\n  estimateItemSize?: number | ((item: T, itemIndex: number, sectionIndex: number) => number);\n  getItemKey?: (item: T, itemIndex: number, sectionIndex: number) => VirtualKey;\n  horizontal?: boolean;\n  measurementCache?: MeasurementCache;\n  /**\n   * Called after every render cycle with the new state.\n   * **Fixed at construction** \\u2014 cannot be changed after creation.\n   */\n  onChange?: (state: GroupVirtualizerState<T>) => void;\n  /**\n   * Called when scrolling has settled. Fixed at construction.\n   * See `VirtualizerOptions.onScrollEnd` for details.\n   */\n  onScrollEnd?: (offset: number) => void;\n  /**\n   * Called when the scrolling state changes. Fixed at construction.\n   */\n  onScrollingChange?: (isScrolling: boolean) => void;\n  overscan?: Overscan;\n  /**\n   * Debounce delay (ms) for scroll-end detection. Defaults to 150.\n   * See `VirtualizerOptions.scrollEndDelay` for details.\n   */\n  scrollEndDelay?: number;\n  sections: Array<GroupSection<T>>;\n}\n\nexport interface GroupVirtualizer<T> {\n  readonly count: number;\n  readonly disposalSignal: AbortSignal;\n  readonly disposed: boolean;\n  /** `true` while the user is actively scrolling; `false` once scroll has settled. */\n  readonly isScrolling: boolean;\n  readonly items: ReadonlyArray<GroupVirtualItem<T>>;\n  readonly scrollOffset: number;\n  readonly stickyItems: VirtualItem[];\n  readonly totalSize: number;\n  dispose: () => void;\n  invalidate: () => void;\n  measure: (index: number, size: number) => void;\n  measureBatch: (entries: Array<{ index: number; size: number }>) => void;\n  measureEl: (index: number, el: HTMLElement) => () => void;\n  refresh: () => void;\n  scrollToBottom: (options?: { behavior?: ScrollBehavior }) => void;\n  scrollToIndex: (index: number, options?: ScrollToIndexOptions) => void;\n  scrollToItem: (sectionIndex: number, itemIndex: number, options?: ScrollToIndexOptions) => void;\n  scrollToOffset: (offset: number, options?: { behavior?: ScrollBehavior }) => void;\n  scrollToSection: (sectionIndex: number, options?: ScrollToIndexOptions) => void;\n  scrollToTop: (options?: { behavior?: ScrollBehavior }) => void;\n  update: (sections: Array<GroupSection<T>>, opts?: GroupVirtualizerUpdateOptions<T>) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Flat entry map ───────────────────────────────────────────────────────────\n\ntype FlatHeader = { isHeader: true; itemIndex: -1; label: string; sectionIndex: number };\ntype FlatItem<T> = { isHeader: false; item: T; itemIndex: number; sectionIndex: number };\ntype FlatEntry<T> = FlatHeader | FlatItem<T>;\n\nfunction buildFlatEntries<T>(sections: Array<GroupSection<T>>): FlatEntry<T>[] {\n  const flat: FlatEntry<T>[] = [];\n\n  for (let s = 0; s < sections.length; s++) {\n    const section = sections[s]!;\n\n    flat.push({ isHeader: true, itemIndex: -1, label: section.label, sectionIndex: s });\n\n    for (let i = 0; i < section.items.length; i++) {\n      flat.push({ isHeader: false, item: section.items[i]!, itemIndex: i, sectionIndex: s });\n    }\n  }\n\n  return flat;\n}\n\n// ─── Implementation ───────────────────────────────────────────────────────────\n\nexport function createGroupedVirtualizer<T>(\n  target: ScrollTarget,\n  options: GroupVirtualizerOptions<T>,\n): GroupVirtualizer<T> {\n  let sections = options.sections;\n  let flat = buildFlatEntries(sections);\n\n  function buildEstimateHeader(\n    estimateHeaderSize: GroupVirtualizerOptions<T>['estimateHeaderSize'],\n  ): (index: number) => number {\n    return typeof estimateHeaderSize === 'function'\n      ? (index: number) => {\n          const entry = flat[index]!;\n\n          return (estimateHeaderSize as (section: GroupSection<T>, sectionIndex: number) => number)(\n            sections[entry.sectionIndex]!,\n            entry.sectionIndex,\n          );\n        }\n      : resolveEstimateFn(\n          typeof estimateHeaderSize === 'number' ? estimateHeaderSize : undefined,\n          DEFAULT_ESTIMATE_SIZE,\n        );\n  }\n\n  let estimateHeaderFn = buildEstimateHeader(options.estimateHeaderSize);\n  let estimateItemUserFn: ((item: T, itemIndex: number, sectionIndex: number) => number) | null =\n    typeof options.estimateItemSize === 'function' ? options.estimateItemSize : null;\n  let estimateItemFixedFn: ((index: number) => number) | null = estimateItemUserFn\n    ? null\n    : resolveEstimateFn(\n        typeof options.estimateItemSize === 'number' ? options.estimateItemSize : undefined,\n        DEFAULT_ESTIMATE_SIZE,\n      );\n  let userGetItemKey = options.getItemKey;\n\n  function estimateFn(globalIndex: number): number {\n    const entry = flat[globalIndex];\n\n    if (!entry) return DEFAULT_ESTIMATE_SIZE;\n\n    if (entry.isHeader) return estimateHeaderFn(globalIndex);\n\n    if (estimateItemUserFn) return estimateItemUserFn(entry.item, entry.itemIndex, entry.sectionIndex);\n\n    return estimateItemFixedFn!(globalIndex);\n  }\n\n  function getItemKey(globalIndex: number): VirtualKey {\n    const entry = flat[globalIndex];\n\n    if (!entry) return globalIndex;\n\n    if (entry.isHeader) return `__header_${entry.sectionIndex}`;\n\n    if (userGetItemKey) return userGetItemKey(entry.item, entry.itemIndex, entry.sectionIndex);\n\n    return globalIndex;\n  }\n\n  let destroyed = false;\n  let lastItems: Array<GroupVirtualItem<T>> = [];\n\n  function mapState(state: VirtualizerState): GroupVirtualizerState<T> {\n    const items: Array<GroupVirtualItem<T>> = [];\n    const headers: GroupVirtualHeader[] = [];\n    let stickyHeader: GroupVirtualHeader | null = null;\n\n    for (const vi of state.items) {\n      const entry = flat[vi.index];\n\n      if (!entry) continue;\n\n      if (entry.isHeader) {\n        headers.push({ ...vi, label: entry.label ?? '', sectionIndex: entry.sectionIndex });\n      } else {\n        items.push({ ...vi, data: entry.item, itemIndex: entry.itemIndex, sectionIndex: entry.sectionIndex });\n      }\n    }\n\n    if (state.stickyItems.length > 0) {\n      const svi = state.stickyItems[0]!;\n      const entry = flat[svi.index];\n\n      if (entry?.isHeader) {\n        stickyHeader = { ...svi, label: entry.label ?? '', sectionIndex: entry.sectionIndex };\n      }\n    }\n\n    lastItems = items;\n\n    return { headers, items, stickyHeader, totalSize: state.totalSize };\n  }\n\n  const virtualizer = createVirtualizer(target, {\n    count: flat.length,\n    estimateSize: estimateFn,\n    getItemKey,\n    horizontal: options.horizontal,\n    measurementCache: options.measurementCache,\n    onChange: (state) => {\n      const mapped = mapState(state);\n\n      options.onChange?.(mapped);\n    },\n    onScrollEnd: options.onScrollEnd,\n    onScrollingChange: options.onScrollingChange,\n    overscan: options.overscan ?? DEFAULT_OVERSCAN,\n    scrollEndDelay: options.scrollEndDelay,\n    sticky: (i) => flat[i]?.isHeader ?? false,\n  });\n\n  const ac = new AbortController();\n\n  function _dispose(): void {\n    if (destroyed) return;\n\n    destroyed = true;\n    ac.abort();\n    virtualizer.dispose();\n  }\n\n  // Build a flat-index lookup: [sectionIndex, itemIndex] → flat index.\n  // Returns -1 when sectionIndex is out of range so callers can no-op safely.\n  function flatIndexOf(sectionIndex: number, itemIndex?: number): number {\n    if (sectionIndex < 0 || sectionIndex >= sections.length) return -1;\n\n    let pos = 0;\n\n    for (let s = 0; s < sections.length; s++) {\n      if (s === sectionIndex) {\n        if (itemIndex === undefined) return pos; // header\n\n        return pos + 1 + itemIndex;\n      }\n\n      pos += 1 + sections[s]!.items.length;\n    }\n\n    return -1; // unreachable\n  }\n\n  return {\n    get count() {\n      return virtualizer.count;\n    },\n    get disposalSignal() {\n      return ac.signal;\n    },\n    dispose: _dispose,\n    get disposed() {\n      return destroyed;\n    },\n    invalidate() {\n      if (destroyed) return;\n\n      virtualizer.invalidate();\n    },\n    get isScrolling() {\n      return virtualizer.isScrolling;\n    },\n    get items() {\n      return lastItems;\n    },\n    measure(index: number, size: number) {\n      if (destroyed) return;\n\n      virtualizer.measure(index, size);\n    },\n    measureBatch(entries: Array<{ index: number; size: number }>) {\n      if (destroyed) return;\n\n      virtualizer.measureBatch(entries);\n    },\n    measureEl(index: number, el: HTMLElement) {\n      if (destroyed) return () => {};\n\n      return virtualizer.measureEl(index, el);\n    },\n    refresh() {\n      if (destroyed) return;\n\n      virtualizer.refresh();\n    },\n    get scrollOffset() {\n      return virtualizer.scrollOffset;\n    },\n    scrollToBottom(opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToBottom(opts);\n    },\n    scrollToIndex(index: number, opts?: ScrollToIndexOptions) {\n      if (destroyed) return;\n\n      virtualizer.scrollToIndex(index, opts);\n    },\n    scrollToItem(sectionIndex, itemIndex, opts = {}) {\n      if (destroyed) return;\n\n      const globalIndex = flatIndexOf(sectionIndex, itemIndex);\n\n      if (globalIndex < 0) return;\n\n      virtualizer.scrollToIndex(globalIndex, opts);\n    },\n    scrollToOffset(offset: number, opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToOffset(offset, opts);\n    },\n    scrollToSection(sectionIndex, opts = {}) {\n      if (destroyed) return;\n\n      const globalIndex = flatIndexOf(sectionIndex);\n\n      if (globalIndex < 0) return;\n\n      virtualizer.scrollToIndex(globalIndex, opts);\n    },\n    scrollToTop(opts?: { behavior?: ScrollBehavior }) {\n      if (destroyed) return;\n\n      virtualizer.scrollToTop(opts);\n    },\n    get stickyItems() {\n      return virtualizer.stickyItems;\n    },\n    [Symbol.dispose]: _dispose,\n    get totalSize() {\n      return virtualizer.totalSize;\n    },\n    /**\n     * Replace all sections. Closures for estimateFn and getItemKey already\n     * capture the live `flat`/`sections` references — only count is passed to\n     * the underlying virtualizer to avoid discarding measured sizes on every\n     * data refresh. `refresh()` rebuilds offsets while preserving the cache.\n     */\n    update(nextSections, opts?: GroupVirtualizerUpdateOptions<T>) {\n      if (destroyed) return;\n\n      // Apply option overrides before rebuilding flat entries.\n      if (opts) {\n        if (opts.estimateHeaderSize !== undefined) {\n          estimateHeaderFn = buildEstimateHeader(opts.estimateHeaderSize);\n        }\n\n        if (opts.estimateItemSize !== undefined) {\n          estimateItemUserFn = typeof opts.estimateItemSize === 'function' ? opts.estimateItemSize : null;\n          estimateItemFixedFn = estimateItemUserFn\n            ? null\n            : resolveEstimateFn(\n                typeof opts.estimateItemSize === 'number' ? opts.estimateItemSize : undefined,\n                DEFAULT_ESTIMATE_SIZE,\n              );\n        }\n\n        if (opts.getItemKey !== undefined) userGetItemKey = opts.getItemKey;\n      }\n\n      sections = nextSections;\n\n      const prevCount = flat.length;\n\n      flat = buildFlatEntries(sections);\n\n      const virtUpdateOpts: VirtualizerUpdateOptions = { count: flat.length };\n\n      if (opts?.measurementCache !== undefined) virtUpdateOpts.measurementCache = opts.measurementCache;\n\n      if (opts?.overscan !== undefined) virtUpdateOpts.overscan = opts.overscan;\n\n      if (flat.length !== prevCount || opts?.measurementCache !== undefined || opts?.overscan !== undefined) {\n        virtualizer.update(virtUpdateOpts);\n      } else {\n        virtualizer.refresh();\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./_utils.cjs"),n=require("./virtualizer.cjs"),r=require("./dom-virtual-list.cjs"),i=require("./grid-virtualizer.cjs"),a=require("./grouped-virtualizer.cjs"),o=require("./reactive.cjs");exports.DEFAULT_ESTIMATE_SIZE=t.DEFAULT_ESTIMATE_SIZE,exports.DEFAULT_OVERSCAN=t.DEFAULT_OVERSCAN,exports.ScrollError=e.ScrollError,exports.ScrollRangeError=e.ScrollRangeError,exports.createDomVirtualList=r.createDomVirtualList,exports.createGridVirtualizer=i.createGridVirtualizer,exports.createGroupedVirtualizer=a.createGroupedVirtualizer,exports.createMeasurementCache=t.createMeasurementCache,exports.createReactiveGroupedVirtualizer=o.createReactiveGroupedVirtualizer,exports.createReactiveVirtualizer=o.createReactiveVirtualizer,exports.createVirtualScroller=r.createVirtualScroller,exports.createVirtualizer=n.createVirtualizer;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { ScrollError, ScrollRangeError } from './errors';
+export { createDomVirtualList, createVirtualScroller } from './dom-virtual-list';
+export type { DomVirtualListController, DomVirtualListOptions, DomVirtualListRenderArgs, RecycleFn, VirtualRenderItem, VirtualScrollerOptions, } from './dom-virtual-list';
+export { createGridVirtualizer } from './grid-virtualizer';
+export type { GridRangeChangeEvent, GridVirtualizer, GridVirtualizerOptions, GridVirtualizerState, GridVirtualizerUpdateOptions, ScrollToCellOptions, } from './grid-virtualizer';
+export { createGroupedVirtualizer } from './grouped-virtualizer';
+export type { GroupSection, GroupVirtualHeader, GroupVirtualItem, GroupVirtualizer, GroupVirtualizerOptions, GroupVirtualizerState, GroupVirtualizerUpdateOptions, } from './grouped-virtualizer';
+export { createReactiveGroupedVirtualizer, createReactiveVirtualizer } from './reactive';
+export type { ReactiveGroupVirtualizer, ReactiveVirtualizer, Signal } from './reactive';
+export { createMeasurementCache, createVirtualizer, DEFAULT_ESTIMATE_SIZE, DEFAULT_OVERSCAN } from './virtualizer';
+export type { MeasurementCache, Overscan, ScrollTarget, ScrollToIndexOptions, VirtualItem, Virtualizer, VirtualizerOptions, VirtualizerState, VirtualizerUpdateOptions, VirtualKey, } from './virtualizer';
+//# sourceMappingURL=index.d.ts.map