@vielzeug/scroll 2.0.2 → 2.1.0

package/dist/grid-virtualizer.cjs

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

package/dist/grid-virtualizer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"grid-virtualizer.cjs","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import { createScrollAdapter } from './_adapter';\nimport { alignOffset } from './_alignment';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  type Overscan,\n  observeResize,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\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  colGap?: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** Called after every render cycle with the new state. Replace through `update()`. */\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  rowGap?: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, 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  onChange?: ((state: GridVirtualizerState) => void) | undefined;\n  onRangeChange?: ((range: GridRangeChangeEvent) => void) | undefined;\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  dispose: () => void;\n  readonly disposed: boolean;\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  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\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  readonly scrollTop: number;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  if (typeof options.estimateRowSize === 'number') requirePositiveNumber(options.estimateRowSize, 'estimateRowSize');\n\n  if (typeof options.estimateColSize === 'number') requirePositiveNumber(options.estimateColSize, 'estimateColSize');\n\n  if (options.initialScrollTop !== undefined) requireNonNegativeNumber(options.initialScrollTop, 'initialScrollTop');\n\n  if (options.initialScrollLeft !== undefined) requireNonNegativeNumber(options.initialScrollLeft, 'initialScrollLeft');\n\n  if (options.rowGap !== undefined) requireNonNegativeInteger(options.rowGap, 'rowGap');\n\n  if (options.colGap !== undefined) requireNonNegativeInteger(options.colGap, 'colGap');\n\n  if (options.overscanY !== undefined) validateOverscan(options.overscanY, 'overscanY');\n\n  if (options.overscanX !== undefined) validateOverscan(options.overscanX, 'overscanX');\n\n  let rowCount = requireNonNegativeInteger(options.rowCount, 'rowCount');\n  let colCount = requireNonNegativeInteger(options.colCount, '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  let onChange = options.onChange;\n  let 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    if (next.rowCount !== undefined) requireNonNegativeInteger(next.rowCount, 'rowCount');\n\n    if (next.colCount !== undefined) requireNonNegativeInteger(next.colCount, 'colCount');\n\n    if (typeof next.estimateRowSize === 'number') requirePositiveNumber(next.estimateRowSize, 'estimateRowSize');\n\n    if (typeof next.estimateColSize === 'number') requirePositiveNumber(next.estimateColSize, 'estimateColSize');\n\n    if (next.rowGap !== undefined) requireNonNegativeInteger(next.rowGap, 'rowGap');\n\n    if (next.colGap !== undefined) requireNonNegativeInteger(next.colGap, 'colGap');\n\n    if (next.overscanY !== undefined) validateOverscan(next.overscanY, 'overscanY');\n\n    if (next.overscanX !== undefined) validateOverscan(next.overscanX, 'overscanX');\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (Object.hasOwn(next, 'onChange')) onChange = next.onChange;\n\n    if (Object.hasOwn(next, 'onRangeChange')) onRangeChange = next.onRangeChange;\n\n    if (next.rowCount !== undefined) {\n      const n = 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 = 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 = 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 = 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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"}
+{"version":3,"file":"grid-virtualizer.cjs","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import type { Signal } from '@vielzeug/ripple';\n\nimport { createScrollAdapter } from './_adapter';\nimport { alignOffset } from './_alignment';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  type Overscan,\n  observeResize,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\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  colGap?: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** Enable keyboard navigation (Arrow/Page/Home/End keys). */\n  keyboardScroll?: boolean;\n  /** Called after every render cycle with the new state. Replace through `update()`. */\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  rowGap?: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  /** Optional signal factory for reactive state. */\n  signal?: (init: GridVirtualizerState) => Signal<GridVirtualizerState>;\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  keyboardScroll?: boolean;\n  onChange?: ((state: GridVirtualizerState) => void) | undefined;\n  onRangeChange?: ((range: GridRangeChangeEvent) => void) | undefined;\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  dispose: () => void;\n  readonly disposed: boolean;\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  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\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  readonly scrollTop: number;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  if (typeof options.estimateRowSize === 'number') requirePositiveNumber(options.estimateRowSize, 'estimateRowSize');\n\n  if (typeof options.estimateColSize === 'number') requirePositiveNumber(options.estimateColSize, 'estimateColSize');\n\n  if (options.initialScrollTop !== undefined) requireNonNegativeNumber(options.initialScrollTop, 'initialScrollTop');\n\n  if (options.initialScrollLeft !== undefined) requireNonNegativeNumber(options.initialScrollLeft, 'initialScrollLeft');\n\n  if (options.rowGap !== undefined) requireNonNegativeInteger(options.rowGap, 'rowGap');\n\n  if (options.colGap !== undefined) requireNonNegativeInteger(options.colGap, 'colGap');\n\n  if (options.overscanY !== undefined) validateOverscan(options.overscanY, 'overscanY');\n\n  if (options.overscanX !== undefined) validateOverscan(options.overscanX, 'overscanX');\n\n  let rowCount = requireNonNegativeInteger(options.rowCount, 'rowCount');\n  let colCount = requireNonNegativeInteger(options.colCount, '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  let keyboardScrollEnabled = options.keyboardScroll ?? false;\n\n  let onChange = options.onChange;\n  let onRangeChange = options.onRangeChange;\n\n  // Optional signal for reactive state\n  let stateSignal: Signal<GridVirtualizerState> | null = null;\n  if (options.signal) {\n    const initialState: GridVirtualizerState = { cols: [], rows: [], totalHeight: 0, totalWidth: 0 };\n    stateSignal = options.signal(initialState);\n  }\n\n  // Helper to emit state to both callback and signal\n  function emitState(state: GridVirtualizerState): void {\n    if (stateSignal) stateSignal.value = state;\n    onChange?.(state);\n  }\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        emitState({ 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    emitState({ 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    if (next.rowCount !== undefined) requireNonNegativeInteger(next.rowCount, 'rowCount');\n\n    if (next.colCount !== undefined) requireNonNegativeInteger(next.colCount, 'colCount');\n\n    if (typeof next.estimateRowSize === 'number') requirePositiveNumber(next.estimateRowSize, 'estimateRowSize');\n\n    if (typeof next.estimateColSize === 'number') requirePositiveNumber(next.estimateColSize, 'estimateColSize');\n\n    if (next.rowGap !== undefined) requireNonNegativeInteger(next.rowGap, 'rowGap');\n\n    if (next.colGap !== undefined) requireNonNegativeInteger(next.colGap, 'colGap');\n\n    if (next.overscanY !== undefined) validateOverscan(next.overscanY, 'overscanY');\n\n    if (next.overscanX !== undefined) validateOverscan(next.overscanX, 'overscanX');\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (Object.hasOwn(next, 'onChange')) onChange = next.onChange;\n\n    if (Object.hasOwn(next, 'onRangeChange')) onRangeChange = next.onRangeChange;\n\n    if (next.rowCount !== undefined) {\n      const n = 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 = 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 = 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 = 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 (Object.hasOwn(next, 'keyboardScroll')) {\n      keyboardScrollEnabled = next.keyboardScroll ?? false;\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  // ─── Keyboard scroll support ──────────────────────────────────────────────────\n\n  if (keyboardScrollEnabled) {\n    const handleKeyDown = (e: Event): void => {\n      if (disposed) return;\n      if (!(e instanceof KeyboardEvent)) return;\n      if (rowCount === 0 || colCount === 0) return;\n\n      let handled = false;\n      let newTop = scrollTop;\n      let newLeft = scrollLeft;\n      const pageScrollSize = Math.max(viewportHeight * 0.8, viewportHeight - 100);\n      const rowStepSize =\n        (typeof estimateRowFn(0) === 'number' ? estimateRowFn(0) : DEFAULT_ESTIMATE_SIZE) +\n        toNonNegativeInt(options.rowGap ?? 0);\n      const colStepSize =\n        (typeof estimateColFn(0) === 'number' ? estimateColFn(0) : DEFAULT_ESTIMATE_SIZE) +\n        toNonNegativeInt(options.colGap ?? 0);\n\n      switch (e.key) {\n        case 'ArrowUp':\n          newTop = Math.max(0, scrollTop - rowStepSize);\n          handled = true;\n          break;\n        case 'ArrowDown':\n          newTop = Math.min(rowAx.totalSize - viewportHeight, scrollTop + rowStepSize);\n          handled = true;\n          break;\n        case 'ArrowLeft':\n          newLeft = Math.max(0, scrollLeft - colStepSize);\n          handled = true;\n          break;\n        case 'ArrowRight':\n          newLeft = Math.min(colAx.totalSize - viewportWidth, scrollLeft + colStepSize);\n          handled = true;\n          break;\n        case 'PageUp':\n          newTop = Math.max(0, scrollTop - pageScrollSize);\n          handled = true;\n          break;\n        case 'PageDown':\n          newTop = Math.min(rowAx.totalSize - viewportHeight, scrollTop + pageScrollSize);\n          handled = true;\n          break;\n        case 'Home':\n          newTop = 0;\n          handled = true;\n          break;\n        case 'End':\n          newTop = Math.max(0, rowAx.totalSize - viewportHeight);\n          handled = true;\n          break;\n      }\n\n      if (handled) {\n        e.preventDefault();\n        adapter.scrollTo(newLeft, newTop, 'auto');\n        scrollTop = clampTop(newTop);\n        scrollLeft = clampLeft(newLeft);\n        if (!disposed) computeVisible();\n      }\n    };\n\n    if (typeof target === 'object' && target !== null && 'addEventListener' in target) {\n      (target as EventTarget).addEventListener('keydown', handleKeyDown);\n      ac.signal.addEventListener('abort', () => {\n        (target as EventTarget).removeEventListener('keydown', handleKeyDown);\n      });\n    }\n  }\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/grid-virtualizer.d.ts

@@ -1,3 +1,4 @@
+import type { Signal } from '@vielzeug/ripple';
 import { type VirtualItem } from './_axis1d';
 import { type Overscan, type ScrollTarget } from './_utils';
 export type { VirtualItem };
@@ -33,6 +34,8 @@ export interface GridVirtualizerOptions {
     estimateRowSize?: number | ((row: number) => number);
     initialScrollLeft?: number;
     initialScrollTop?: number;
+    /** Enable keyboard navigation (Arrow/Page/Home/End keys). */
+    keyboardScroll?: boolean;
     /** Called after every render cycle with the new state. Replace through `update()`. */
     onChange?: (state: GridVirtualizerState) => void;
     /** Zero-allocation alternative to onChange for range-based consumers. */
@@ -43,6 +46,8 @@ export interface GridVirtualizerOptions {
     rowGap?: number;
     /** External measurement cache for rows. Share across instances for scroll restoration. */
     rowMeasurementCache?: Map<number, number>;
+    /** Optional signal factory for reactive state. */
+    signal?: (init: GridVirtualizerState) => Signal<GridVirtualizerState>;
 }
 /**
  * Options accepted by `update()`. Explicit interface instead of
@@ -53,6 +58,7 @@ export interface GridVirtualizerUpdateOptions {
     colGap?: number;
     estimateColSize?: number | ((col: number) => number);
     estimateRowSize?: number | ((row: number) => number);
+    keyboardScroll?: boolean;
     onChange?: ((state: GridVirtualizerState) => void) | undefined;
     onRangeChange?: ((range: GridRangeChangeEvent) => void) | undefined;
     overscanX?: Overscan;

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

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

package/dist/grid-virtualizer.js

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

package/dist/grid-virtualizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-virtualizer.js","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import { createScrollAdapter } from './_adapter';\nimport { alignOffset } from './_alignment';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  type Overscan,\n  observeResize,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\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  colGap?: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** Called after every render cycle with the new state. Replace through `update()`. */\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  rowGap?: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, 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  onChange?: ((state: GridVirtualizerState) => void) | undefined;\n  onRangeChange?: ((range: GridRangeChangeEvent) => void) | undefined;\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  dispose: () => void;\n  readonly disposed: boolean;\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  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\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  readonly scrollTop: number;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  if (typeof options.estimateRowSize === 'number') requirePositiveNumber(options.estimateRowSize, 'estimateRowSize');\n\n  if (typeof options.estimateColSize === 'number') requirePositiveNumber(options.estimateColSize, 'estimateColSize');\n\n  if (options.initialScrollTop !== undefined) requireNonNegativeNumber(options.initialScrollTop, 'initialScrollTop');\n\n  if (options.initialScrollLeft !== undefined) requireNonNegativeNumber(options.initialScrollLeft, 'initialScrollLeft');\n\n  if (options.rowGap !== undefined) requireNonNegativeInteger(options.rowGap, 'rowGap');\n\n  if (options.colGap !== undefined) requireNonNegativeInteger(options.colGap, 'colGap');\n\n  if (options.overscanY !== undefined) validateOverscan(options.overscanY, 'overscanY');\n\n  if (options.overscanX !== undefined) validateOverscan(options.overscanX, 'overscanX');\n\n  let rowCount = requireNonNegativeInteger(options.rowCount, 'rowCount');\n  let colCount = requireNonNegativeInteger(options.colCount, '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  let onChange = options.onChange;\n  let 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    if (next.rowCount !== undefined) requireNonNegativeInteger(next.rowCount, 'rowCount');\n\n    if (next.colCount !== undefined) requireNonNegativeInteger(next.colCount, 'colCount');\n\n    if (typeof next.estimateRowSize === 'number') requirePositiveNumber(next.estimateRowSize, 'estimateRowSize');\n\n    if (typeof next.estimateColSize === 'number') requirePositiveNumber(next.estimateColSize, 'estimateColSize');\n\n    if (next.rowGap !== undefined) requireNonNegativeInteger(next.rowGap, 'rowGap');\n\n    if (next.colGap !== undefined) requireNonNegativeInteger(next.colGap, 'colGap');\n\n    if (next.overscanY !== undefined) validateOverscan(next.overscanY, 'overscanY');\n\n    if (next.overscanX !== undefined) validateOverscan(next.overscanX, 'overscanX');\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (Object.hasOwn(next, 'onChange')) onChange = next.onChange;\n\n    if (Object.hasOwn(next, 'onRangeChange')) onRangeChange = next.onRangeChange;\n\n    if (next.rowCount !== undefined) {\n      const n = 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 = 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 = 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 = 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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"}
+{"version":3,"file":"grid-virtualizer.js","names":[],"sources":["../src/grid-virtualizer.ts"],"sourcesContent":["import type { Signal } from '@vielzeug/ripple';\n\nimport { createScrollAdapter } from './_adapter';\nimport { alignOffset } from './_alignment';\nimport { createAxis1D, type VirtualItem } from './_axis1d';\nimport {\n  DEFAULT_ESTIMATE_SIZE,\n  DEFAULT_OVERSCAN,\n  normalizeOverscan,\n  type Overscan,\n  observeResize,\n  resolveEstimateFn,\n  type ScrollTarget,\n  toNonNegativeInt,\n  toPositiveNumber,\n} from './_utils';\nimport {\n  requireNonNegativeInteger,\n  requireNonNegativeNumber,\n  requirePositiveNumber,\n  validateOverscan,\n} from './_validation';\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  colGap?: number;\n  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** Enable keyboard navigation (Arrow/Page/Home/End keys). */\n  keyboardScroll?: boolean;\n  /** Called after every render cycle with the new state. Replace through `update()`. */\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  rowGap?: number;\n  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  /** Optional signal factory for reactive state. */\n  signal?: (init: GridVirtualizerState) => Signal<GridVirtualizerState>;\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  keyboardScroll?: boolean;\n  onChange?: ((state: GridVirtualizerState) => void) | undefined;\n  onRangeChange?: ((range: GridRangeChangeEvent) => void) | undefined;\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  dispose: () => void;\n  readonly disposed: boolean;\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  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\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  readonly scrollTop: number;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── Implementation ────────────────────────────────────────────────────────────\n\nexport function createGridVirtualizer(target: ScrollTarget, options: GridVirtualizerOptions): GridVirtualizer {\n  if (typeof options.estimateRowSize === 'number') requirePositiveNumber(options.estimateRowSize, 'estimateRowSize');\n\n  if (typeof options.estimateColSize === 'number') requirePositiveNumber(options.estimateColSize, 'estimateColSize');\n\n  if (options.initialScrollTop !== undefined) requireNonNegativeNumber(options.initialScrollTop, 'initialScrollTop');\n\n  if (options.initialScrollLeft !== undefined) requireNonNegativeNumber(options.initialScrollLeft, 'initialScrollLeft');\n\n  if (options.rowGap !== undefined) requireNonNegativeInteger(options.rowGap, 'rowGap');\n\n  if (options.colGap !== undefined) requireNonNegativeInteger(options.colGap, 'colGap');\n\n  if (options.overscanY !== undefined) validateOverscan(options.overscanY, 'overscanY');\n\n  if (options.overscanX !== undefined) validateOverscan(options.overscanX, 'overscanX');\n\n  let rowCount = requireNonNegativeInteger(options.rowCount, 'rowCount');\n  let colCount = requireNonNegativeInteger(options.colCount, '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  let keyboardScrollEnabled = options.keyboardScroll ?? false;\n\n  let onChange = options.onChange;\n  let onRangeChange = options.onRangeChange;\n\n  // Optional signal for reactive state\n  let stateSignal: Signal<GridVirtualizerState> | null = null;\n  if (options.signal) {\n    const initialState: GridVirtualizerState = { cols: [], rows: [], totalHeight: 0, totalWidth: 0 };\n    stateSignal = options.signal(initialState);\n  }\n\n  // Helper to emit state to both callback and signal\n  function emitState(state: GridVirtualizerState): void {\n    if (stateSignal) stateSignal.value = state;\n    onChange?.(state);\n  }\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        emitState({ 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    emitState({ 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    if (next.rowCount !== undefined) requireNonNegativeInteger(next.rowCount, 'rowCount');\n\n    if (next.colCount !== undefined) requireNonNegativeInteger(next.colCount, 'colCount');\n\n    if (typeof next.estimateRowSize === 'number') requirePositiveNumber(next.estimateRowSize, 'estimateRowSize');\n\n    if (typeof next.estimateColSize === 'number') requirePositiveNumber(next.estimateColSize, 'estimateColSize');\n\n    if (next.rowGap !== undefined) requireNonNegativeInteger(next.rowGap, 'rowGap');\n\n    if (next.colGap !== undefined) requireNonNegativeInteger(next.colGap, 'colGap');\n\n    if (next.overscanY !== undefined) validateOverscan(next.overscanY, 'overscanY');\n\n    if (next.overscanX !== undefined) validateOverscan(next.overscanX, 'overscanX');\n\n    let rebuildRows = false;\n    let rebuildCols = false;\n    let needsCompute = false;\n\n    if (Object.hasOwn(next, 'onChange')) onChange = next.onChange;\n\n    if (Object.hasOwn(next, 'onRangeChange')) onRangeChange = next.onRangeChange;\n\n    if (next.rowCount !== undefined) {\n      const n = 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 = 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 = 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 = 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 (Object.hasOwn(next, 'keyboardScroll')) {\n      keyboardScrollEnabled = next.keyboardScroll ?? false;\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  // ─── Keyboard scroll support ──────────────────────────────────────────────────\n\n  if (keyboardScrollEnabled) {\n    const handleKeyDown = (e: Event): void => {\n      if (disposed) return;\n      if (!(e instanceof KeyboardEvent)) return;\n      if (rowCount === 0 || colCount === 0) return;\n\n      let handled = false;\n      let newTop = scrollTop;\n      let newLeft = scrollLeft;\n      const pageScrollSize = Math.max(viewportHeight * 0.8, viewportHeight - 100);\n      const rowStepSize =\n        (typeof estimateRowFn(0) === 'number' ? estimateRowFn(0) : DEFAULT_ESTIMATE_SIZE) +\n        toNonNegativeInt(options.rowGap ?? 0);\n      const colStepSize =\n        (typeof estimateColFn(0) === 'number' ? estimateColFn(0) : DEFAULT_ESTIMATE_SIZE) +\n        toNonNegativeInt(options.colGap ?? 0);\n\n      switch (e.key) {\n        case 'ArrowUp':\n          newTop = Math.max(0, scrollTop - rowStepSize);\n          handled = true;\n          break;\n        case 'ArrowDown':\n          newTop = Math.min(rowAx.totalSize - viewportHeight, scrollTop + rowStepSize);\n          handled = true;\n          break;\n        case 'ArrowLeft':\n          newLeft = Math.max(0, scrollLeft - colStepSize);\n          handled = true;\n          break;\n        case 'ArrowRight':\n          newLeft = Math.min(colAx.totalSize - viewportWidth, scrollLeft + colStepSize);\n          handled = true;\n          break;\n        case 'PageUp':\n          newTop = Math.max(0, scrollTop - pageScrollSize);\n          handled = true;\n          break;\n        case 'PageDown':\n          newTop = Math.min(rowAx.totalSize - viewportHeight, scrollTop + pageScrollSize);\n          handled = true;\n          break;\n        case 'Home':\n          newTop = 0;\n          handled = true;\n          break;\n        case 'End':\n          newTop = Math.max(0, rowAx.totalSize - viewportHeight);\n          handled = true;\n          break;\n      }\n\n      if (handled) {\n        e.preventDefault();\n        adapter.scrollTo(newLeft, newTop, 'auto');\n        scrollTop = clampTop(newTop);\n        scrollLeft = clampLeft(newLeft);\n        if (!disposed) computeVisible();\n      }\n    };\n\n    if (typeof target === 'object' && target !== null && 'addEventListener' in target) {\n      (target as EventTarget).addEventListener('keydown', handleKeyDown);\n      ac.signal.addEventListener('abort', () => {\n        (target as EventTarget).removeEventListener('keydown', handleKeyDown);\n      });\n    }\n  }\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

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