@vielzeug/scroll 2.0.0 → 2.0.2

package/dist/_adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"_adapter.cjs","names":[],"sources":["../src/_adapter.ts"],"sourcesContent":["import { type ScrollTarget, isWindowTarget } from './_utils';\n\n/** Single-axis read/write interface for either horizontal or vertical scroll. */\nexport type Axis = {\n  readOffset: () => number;\n  readViewportSize: () => number;\n  writeOffset: (offset: number, behavior: ScrollBehavior) => void;\n};\n\n/** Unified two-axis scroll adapter returned by `createScrollAdapter`. */\nexport type ScrollAdapter = {\n  /** Detach all listeners (scroll + resize). Call in _dispose(). */\n  detach: () => void;\n  /** Write both axes at once (avoids double scrollTo call). */\n  scrollTo: (left: number, top: number, behavior: ScrollBehavior) => void;\n  x: Axis;\n  y: Axis;\n};\n\n/**\n * Attach scroll and resize listeners on a `ScrollTarget` and return a\n * two-axis `ScrollAdapter`. Handles both `Window` and `HTMLElement` targets.\n */\nexport function createScrollAdapter(target: ScrollTarget, onScroll: () => void, onResize: () => void): ScrollAdapter {\n  if (isWindowTarget(target)) {\n    target.addEventListener('scroll', onScroll, { passive: true });\n    target.addEventListener('resize', onResize, { passive: true });\n\n    return {\n      detach() {\n        target.removeEventListener('scroll', onScroll);\n        target.removeEventListener('resize', onResize);\n      },\n      scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n      x: {\n        readOffset: () => target.scrollX,\n        readViewportSize: () => target.innerWidth,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n      },\n      y: {\n        readOffset: () => target.scrollY,\n        readViewportSize: () => target.innerHeight,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n      },\n    };\n  }\n\n  // ⚠️ ResizeObserver is assumed to exist (supported in all modern browsers).\n  // In SSR or older environments, callers must polyfill before constructing a virtualizer.\n  const resizeObserver = new ResizeObserver(onResize);\n\n  target.addEventListener('scroll', onScroll, { passive: true });\n  resizeObserver.observe(target);\n\n  return {\n    detach() {\n      target.removeEventListener('scroll', onScroll);\n      resizeObserver.disconnect();\n    },\n    scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n    x: {\n      readOffset: () => target.scrollLeft,\n      readViewportSize: () => target.clientWidth,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n    },\n    y: {\n      readOffset: () => target.scrollTop,\n      readViewportSize: () => target.clientHeight,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n    },\n  };\n}\n"],"mappings":"gCAuBA,SAAgB,EAAoB,EAAsB,EAAsB,EAAqC,CACnH,GAAI,EAAA,eAAe,CAAM,EAIvB,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAEtD,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAO,oBAAoB,SAAU,CAAQ,CAC/C,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,WAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,EAKF,IAAM,EAAiB,IAAI,eAAe,CAAQ,EAKlD,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAe,QAAQ,CAAM,EAEtB,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAe,WAAW,CAC5B,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,WACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,UACzB,qBAAwB,EAAO,aAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,CACF"}
+{"version":3,"file":"_adapter.cjs","names":[],"sources":["../src/_adapter.ts"],"sourcesContent":["import { isWindowTarget, type ScrollTarget } from './_utils';\n\n/** Single-axis read/write interface for either horizontal or vertical scroll. */\nexport type Axis = {\n  readOffset: () => number;\n  readViewportSize: () => number;\n  writeOffset: (offset: number, behavior: ScrollBehavior) => void;\n};\n\n/** Unified two-axis scroll adapter returned by `createScrollAdapter`. */\nexport type ScrollAdapter = {\n  /** Detach all listeners (scroll + resize). Call in _dispose(). */\n  detach: () => void;\n  /** Write both axes at once (avoids double scrollTo call). */\n  scrollTo: (left: number, top: number, behavior: ScrollBehavior) => void;\n  x: Axis;\n  y: Axis;\n};\n\n/**\n * Attach scroll and resize listeners on a `ScrollTarget` and return a\n * two-axis `ScrollAdapter`. Handles both `Window` and `HTMLElement` targets.\n */\nexport function createScrollAdapter(target: ScrollTarget, onScroll: () => void, onResize: () => void): ScrollAdapter {\n  if (isWindowTarget(target)) {\n    target.addEventListener('scroll', onScroll, { passive: true });\n    target.addEventListener('resize', onResize, { passive: true });\n\n    return {\n      detach() {\n        target.removeEventListener('scroll', onScroll);\n        target.removeEventListener('resize', onResize);\n      },\n      scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n      x: {\n        readOffset: () => target.scrollX,\n        readViewportSize: () => target.innerWidth,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n      },\n      y: {\n        readOffset: () => target.scrollY,\n        readViewportSize: () => target.innerHeight,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n      },\n    };\n  }\n\n  // ⚠️ ResizeObserver is assumed to exist (supported in all modern browsers).\n  // In SSR or older environments, callers must polyfill before constructing a virtualizer.\n  const resizeObserver = new ResizeObserver(onResize);\n\n  target.addEventListener('scroll', onScroll, { passive: true });\n  resizeObserver.observe(target);\n\n  return {\n    detach() {\n      target.removeEventListener('scroll', onScroll);\n      resizeObserver.disconnect();\n    },\n    scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n    x: {\n      readOffset: () => target.scrollLeft,\n      readViewportSize: () => target.clientWidth,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n    },\n    y: {\n      readOffset: () => target.scrollTop,\n      readViewportSize: () => target.clientHeight,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n    },\n  };\n}\n"],"mappings":"gCAuBA,SAAgB,EAAoB,EAAsB,EAAsB,EAAqC,CACnH,GAAI,EAAA,eAAe,CAAM,EAIvB,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAEtD,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAO,oBAAoB,SAAU,CAAQ,CAC/C,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,WAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,EAKF,IAAM,EAAiB,IAAI,eAAe,CAAQ,EAKlD,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAe,QAAQ,CAAM,EAEtB,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAe,WAAW,CAC5B,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,WACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,UACzB,qBAAwB,EAAO,aAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,CACF"}

package/dist/_adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_adapter.d.ts","sourceRoot":"","sources":["../src/_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,UAAU,CAAC;AAE7D,iFAAiF;AACjF,MAAM,MAAM,IAAI,GAAG;IACjB,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG;IAC1B,kEAAkE;IAClE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IACxE,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,IAAI,CAAC;CACT,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,aAAa,CAgDnH"}
+{"version":3,"file":"_adapter.d.ts","sourceRoot":"","sources":["../src/_adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,iFAAiF;AACjF,MAAM,MAAM,IAAI,GAAG;IACjB,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG;IAC1B,kEAAkE;IAClE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IACxE,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,IAAI,CAAC;CACT,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,aAAa,CAgDnH"}

package/dist/_adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"_adapter.js","names":[],"sources":["../src/_adapter.ts"],"sourcesContent":["import { type ScrollTarget, isWindowTarget } from './_utils';\n\n/** Single-axis read/write interface for either horizontal or vertical scroll. */\nexport type Axis = {\n  readOffset: () => number;\n  readViewportSize: () => number;\n  writeOffset: (offset: number, behavior: ScrollBehavior) => void;\n};\n\n/** Unified two-axis scroll adapter returned by `createScrollAdapter`. */\nexport type ScrollAdapter = {\n  /** Detach all listeners (scroll + resize). Call in _dispose(). */\n  detach: () => void;\n  /** Write both axes at once (avoids double scrollTo call). */\n  scrollTo: (left: number, top: number, behavior: ScrollBehavior) => void;\n  x: Axis;\n  y: Axis;\n};\n\n/**\n * Attach scroll and resize listeners on a `ScrollTarget` and return a\n * two-axis `ScrollAdapter`. Handles both `Window` and `HTMLElement` targets.\n */\nexport function createScrollAdapter(target: ScrollTarget, onScroll: () => void, onResize: () => void): ScrollAdapter {\n  if (isWindowTarget(target)) {\n    target.addEventListener('scroll', onScroll, { passive: true });\n    target.addEventListener('resize', onResize, { passive: true });\n\n    return {\n      detach() {\n        target.removeEventListener('scroll', onScroll);\n        target.removeEventListener('resize', onResize);\n      },\n      scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n      x: {\n        readOffset: () => target.scrollX,\n        readViewportSize: () => target.innerWidth,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n      },\n      y: {\n        readOffset: () => target.scrollY,\n        readViewportSize: () => target.innerHeight,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n      },\n    };\n  }\n\n  // ⚠️ ResizeObserver is assumed to exist (supported in all modern browsers).\n  // In SSR or older environments, callers must polyfill before constructing a virtualizer.\n  const resizeObserver = new ResizeObserver(onResize);\n\n  target.addEventListener('scroll', onScroll, { passive: true });\n  resizeObserver.observe(target);\n\n  return {\n    detach() {\n      target.removeEventListener('scroll', onScroll);\n      resizeObserver.disconnect();\n    },\n    scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n    x: {\n      readOffset: () => target.scrollLeft,\n      readViewportSize: () => target.clientWidth,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n    },\n    y: {\n      readOffset: () => target.scrollTop,\n      readViewportSize: () => target.clientHeight,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n    },\n  };\n}\n"],"mappings":"6CAuBA,SAAgB,EAAoB,EAAsB,EAAsB,EAAqC,CACnH,GAAI,EAAe,CAAM,EAIvB,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAEtD,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAO,oBAAoB,SAAU,CAAQ,CAC/C,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,WAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,EAKF,IAAM,EAAiB,IAAI,eAAe,CAAQ,EAKlD,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAe,QAAQ,CAAM,EAEtB,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAe,WAAW,CAC5B,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,WACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,UACzB,qBAAwB,EAAO,aAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,CACF"}
+{"version":3,"file":"_adapter.js","names":[],"sources":["../src/_adapter.ts"],"sourcesContent":["import { isWindowTarget, type ScrollTarget } from './_utils';\n\n/** Single-axis read/write interface for either horizontal or vertical scroll. */\nexport type Axis = {\n  readOffset: () => number;\n  readViewportSize: () => number;\n  writeOffset: (offset: number, behavior: ScrollBehavior) => void;\n};\n\n/** Unified two-axis scroll adapter returned by `createScrollAdapter`. */\nexport type ScrollAdapter = {\n  /** Detach all listeners (scroll + resize). Call in _dispose(). */\n  detach: () => void;\n  /** Write both axes at once (avoids double scrollTo call). */\n  scrollTo: (left: number, top: number, behavior: ScrollBehavior) => void;\n  x: Axis;\n  y: Axis;\n};\n\n/**\n * Attach scroll and resize listeners on a `ScrollTarget` and return a\n * two-axis `ScrollAdapter`. Handles both `Window` and `HTMLElement` targets.\n */\nexport function createScrollAdapter(target: ScrollTarget, onScroll: () => void, onResize: () => void): ScrollAdapter {\n  if (isWindowTarget(target)) {\n    target.addEventListener('scroll', onScroll, { passive: true });\n    target.addEventListener('resize', onResize, { passive: true });\n\n    return {\n      detach() {\n        target.removeEventListener('scroll', onScroll);\n        target.removeEventListener('resize', onResize);\n      },\n      scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n      x: {\n        readOffset: () => target.scrollX,\n        readViewportSize: () => target.innerWidth,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n      },\n      y: {\n        readOffset: () => target.scrollY,\n        readViewportSize: () => target.innerHeight,\n        writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n      },\n    };\n  }\n\n  // ⚠️ ResizeObserver is assumed to exist (supported in all modern browsers).\n  // In SSR or older environments, callers must polyfill before constructing a virtualizer.\n  const resizeObserver = new ResizeObserver(onResize);\n\n  target.addEventListener('scroll', onScroll, { passive: true });\n  resizeObserver.observe(target);\n\n  return {\n    detach() {\n      target.removeEventListener('scroll', onScroll);\n      resizeObserver.disconnect();\n    },\n    scrollTo: (left, top, behavior) => target.scrollTo({ behavior, left, top }),\n    x: {\n      readOffset: () => target.scrollLeft,\n      readViewportSize: () => target.clientWidth,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, left: offset }),\n    },\n    y: {\n      readOffset: () => target.scrollTop,\n      readViewportSize: () => target.clientHeight,\n      writeOffset: (offset, behavior) => target.scrollTo({ behavior, top: offset }),\n    },\n  };\n}\n"],"mappings":"6CAuBA,SAAgB,EAAoB,EAAsB,EAAsB,EAAqC,CACnH,GAAI,EAAe,CAAM,EAIvB,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAEtD,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAO,oBAAoB,SAAU,CAAQ,CAC/C,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,WAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,QACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,EAKF,IAAM,EAAiB,IAAI,eAAe,CAAQ,EAKlD,OAHA,EAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,EAC7D,EAAe,QAAQ,CAAM,EAEtB,CACL,QAAS,CACP,EAAO,oBAAoB,SAAU,CAAQ,EAC7C,EAAe,WAAW,CAC5B,EACA,UAAW,EAAM,EAAK,IAAa,EAAO,SAAS,CAAE,WAAU,OAAM,KAAI,CAAC,EAC1E,EAAG,CACD,eAAkB,EAAO,WACzB,qBAAwB,EAAO,YAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,KAAM,CAAO,CAAC,CAC/E,EACA,EAAG,CACD,eAAkB,EAAO,UACzB,qBAAwB,EAAO,aAC/B,aAAc,EAAQ,IAAa,EAAO,SAAS,CAAE,WAAU,IAAK,CAAO,CAAC,CAC9E,CACF,CACF"}

package/dist/dom-virtual-list.cjs

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

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

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

package/dist/dom-virtual-list.js

@@ -1,2 +1,2 @@
-import{ScrollConfigurationError as e,ScrollRangeError as t}from"./errors.js";import"./_utils.js";import{requireNonNegativeInteger as n,requireNonNegativeNumber as r,requirePositiveNumber as i,validateOverscan as a}from"./_validation.js";import{createVirtualizer as o}from"./virtualizer.js";function s(){let e=new Map,t=new Map,n=[],r=!1;return{acquire(i,a){if(!r)return a();let o=e.get(i);if(o)return t.set(i,o),o;let s=n.pop()??a();return t.set(i,s),s},beginCycle(){t=new Map,r=!0},clear(){for(let t of e.values())t.remove();e.clear(),t.clear(),n.length=0,r=!1},endCycle(){if(r){r=!1;for(let[r,i]of e)t.has(r)||(i.remove(),n.push(i));e=t}}}}function c(c){if(typeof c.estimateSize==`number`&&i(c.estimateSize,`estimateSize`),c.gap!==void 0&&n(c.gap,`gap`),c.overscan!==void 0&&a(c.overscan),c.stickToBottom!==void 0&&typeof c.stickToBottom!=`boolean`){if(c.stickToBottom===null||Array.isArray(c.stickToBottom))throw new e(`stickToBottom must be a boolean or options object.`);c.stickToBottom.threshold!==void 0&&r(c.stickToBottom.threshold,`stickToBottom.threshold`)}let l=[],u=!1,d=new AbortController,f=c.listElement,p=s(),m=null;function h(e){let t=l[e];return t!==void 0&&c.getItemKey?c.getItemKey(e,t):e}function g(e){if(c.estimateSize===void 0)return 36;if(typeof c.estimateSize==`number`)return c.estimateSize;let t=l[e];return t===void 0?36:c.estimateSize(e,t)}function _(e){c.horizontal?(f.style.height=``,f.style.width=`${e}px`):(f.style.height=`${e}px`,f.style.width=``)}function v(e){let n=l[e.index];if(n===void 0)throw new t(`toRenderItem: index ${e.index} is out of range (currentItems.length=${l.length})`);return{...e,data:n}}function y(e){_(e.totalSize),p.beginCycle();try{c.render({items:e.items.map(v),listEl:f,recycle:(e,t)=>p.acquire(e,t),stickyItems:e.stickyItems.map(v),totalSize:e.totalSize})}finally{p.endCycle()}}function b(){p.clear(),c.clear?c.clear(f):f.textContent=``,f.style.height=``,f.style.width=``,f.style.position=``,f.style.contain=``}function x(){let e=c.stickToBottom;return e?e===!0?{enabled:!0,threshold:48}:{enabled:e.enabled??!0,threshold:e.threshold??48}:{enabled:!1,threshold:48}}function S(){let e=o(c.scrollElement,{count:l.length,estimateSize:g,gap:c.gap,getItemKey:h,horizontal:c.horizontal,measurementCache:c.measurementCache,onChange:y,overscan:c.overscan??3,sticky:c.sticky?e=>{let t=l[e];return t!==void 0&&c.sticky(e,t)}:void 0});return m=e,f.style.position=`relative`,f.style.contain=`layout`,e}function C(){u||(u=!0,d.abort(),m?.dispose(),m=null,b())}return{get count(){return m?.count??0},get disposalSignal(){return d.signal},dispose:C,get disposed(){return u},invalidate(){u||m?.invalidate()},isAtEnd(e){return m?.isAtEnd(e)??!0},get isScrolling(){return m?.isScrolling??!1},get items(){return m?.items??[]},measure(e,t){u||m?.measure(e,t)},measureBatch(e){u||m?.measureBatch(e)},measureEl(e,t){return u?()=>{}:m?.measureEl(e,t)??(()=>{})},refresh(){u||m?.refresh()},get scrollOffset(){return m?.scrollOffset??0},scrollToBottom(e){u||m?.scrollToBottom(e)},scrollToIndex(e,t){u||m?.scrollToIndex(e,t)},scrollToOffset(e,t){u||m?.scrollToOffset(e,t)},scrollToTop(e){u||m?.scrollToTop(e)},setItems(e){if(u)return;let t=x(),n=t.enabled&&(m?.isAtEnd(t.threshold)??!0);if(l=e,e.length===0){m?.dispose(),m=null,b();return}if(!m){let e=S();n&&e.scrollToBottom();return}let r=e.length!==m.count;m.update({count:e.length}),r?c.getItemKey||m.invalidate():c.getItemKey?m.refresh():m.invalidate(),n&&m.scrollToBottom()},get stickyItems(){return m?.stickyItems??[]},[Symbol.dispose]:C,get totalSize(){return m?.totalSize??0}}}function l(e,t){let n=document.createElement(`div`);n.style.cssText=t.horizontal?`overflow: auto hidden; width: 100%; height: 100%;`:`overflow: hidden auto; width: 100%; height: 100%;`,t.containerClass&&(n.className=t.containerClass);let r=document.createElement(`div`);n.appendChild(r),e.appendChild(n);let i;try{i=c({...t,listElement:r,scrollElement:n})}catch(e){throw n.remove(),e}let a=i.dispose.bind(i);return Object.assign(i,{dispose(){a(),n.remove()},[Symbol.dispose](){a(),n.remove()}})}export{c as createDomVirtualList,l as createVirtualScroller};
+import"./_utils.js";import{ScrollConfigurationError as e,ScrollRangeError as t}from"./errors.js";import{requireNonNegativeInteger as n,requireNonNegativeNumber as r,requirePositiveNumber as i,validateOverscan as a}from"./_validation.js";import{createVirtualizer as o}from"./virtualizer.js";function s(){let e=new Map,t=new Map,n=[],r=!1;return{acquire(i,a){if(!r)return a();let o=e.get(i);if(o)return t.set(i,o),o;let s=n.pop()??a();return t.set(i,s),s},beginCycle(){t=new Map,r=!0},clear(){for(let t of e.values())t.remove();e.clear(),t.clear(),n.length=0,r=!1},endCycle(){if(r){r=!1;for(let[r,i]of e)t.has(r)||(i.remove(),n.push(i));e=t}}}}function c(c){if(typeof c.estimateSize==`number`&&i(c.estimateSize,`estimateSize`),c.gap!==void 0&&n(c.gap,`gap`),c.overscan!==void 0&&a(c.overscan),c.stickToBottom!==void 0&&typeof c.stickToBottom!=`boolean`){if(c.stickToBottom===null||Array.isArray(c.stickToBottom))throw new e(`stickToBottom must be a boolean or options object.`);c.stickToBottom.threshold!==void 0&&r(c.stickToBottom.threshold,`stickToBottom.threshold`)}let l=[],u=!1,d=new AbortController,f=c.listElement,p=s(),m=null;function h(e){let t=l[e];return t!==void 0&&c.getItemKey?c.getItemKey(e,t):e}function g(e){if(c.estimateSize===void 0)return 36;if(typeof c.estimateSize==`number`)return c.estimateSize;let t=l[e];return t===void 0?36:c.estimateSize(e,t)}function _(e){c.horizontal?(f.style.height=``,f.style.width=`${e}px`):(f.style.height=`${e}px`,f.style.width=``)}function v(e){let n=l[e.index];if(n===void 0)throw new t(`toRenderItem: index ${e.index} is out of range (currentItems.length=${l.length})`);return{...e,data:n}}function y(e){_(e.totalSize),p.beginCycle();try{c.render({items:e.items.map(v),listEl:f,recycle:(e,t)=>p.acquire(e,t),stickyItems:e.stickyItems.map(v),totalSize:e.totalSize})}finally{p.endCycle()}}function b(){p.clear(),c.clear?c.clear(f):f.textContent=``,f.style.height=``,f.style.width=``,f.style.position=``,f.style.contain=``}function x(){let e=c.stickToBottom;return e?e===!0?{enabled:!0,threshold:48}:{enabled:e.enabled??!0,threshold:e.threshold??48}:{enabled:!1,threshold:48}}function S(){let e=o(c.scrollElement,{count:l.length,estimateSize:g,gap:c.gap,getItemKey:h,horizontal:c.horizontal,measurementCache:c.measurementCache,onChange:y,overscan:c.overscan??3,sticky:c.sticky?e=>{let t=l[e];return t!==void 0&&c.sticky(e,t)}:void 0});return m=e,f.style.position=`relative`,f.style.contain=`layout`,e}function C(){u||(u=!0,d.abort(),m?.dispose(),m=null,b())}return{get count(){return m?.count??0},get disposalSignal(){return d.signal},dispose:C,get disposed(){return u},invalidate(){u||m?.invalidate()},isAtEnd(e){return m?.isAtEnd(e)??!0},get isScrolling(){return m?.isScrolling??!1},get items(){return m?.items??[]},measure(e,t){u||m?.measure(e,t)},measureBatch(e){u||m?.measureBatch(e)},measureEl(e,t){return u?()=>{}:m?.measureEl(e,t)??(()=>{})},refresh(){u||m?.refresh()},get scrollOffset(){return m?.scrollOffset??0},scrollToBottom(e){u||m?.scrollToBottom(e)},scrollToIndex(e,t){u||m?.scrollToIndex(e,t)},scrollToOffset(e,t){u||m?.scrollToOffset(e,t)},scrollToTop(e){u||m?.scrollToTop(e)},setItems(e){if(u)return;let t=x(),n=t.enabled&&(m?.isAtEnd(t.threshold)??!0);if(l=e,e.length===0){m?.dispose(),m=null,b();return}if(!m){let e=S();n&&e.scrollToBottom();return}let r=e.length!==m.count;m.update({count:e.length}),r?c.getItemKey||m.invalidate():c.getItemKey?m.refresh():m.invalidate(),n&&m.scrollToBottom()},get stickyItems(){return m?.stickyItems??[]},[Symbol.dispose]:C,get totalSize(){return m?.totalSize??0}}}function l(e,t){let n=document.createElement(`div`);n.style.cssText=t.horizontal?`overflow: auto hidden; width: 100%; height: 100%;`:`overflow: hidden auto; width: 100%; height: 100%;`,t.containerClass&&(n.className=t.containerClass);let r=document.createElement(`div`);n.appendChild(r),e.appendChild(n);let i;try{i=c({...t,listElement:r,scrollElement:n})}catch(e){throw n.remove(),e}let a=i.dispose.bind(i);return Object.assign(i,{dispose(){a(),n.remove()},[Symbol.dispose](){a(),n.remove()}})}export{c as createDomVirtualList,l as createVirtualScroller};
 //# sourceMappingURL=dom-virtual-list.js.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  observeResize,\n  type Overscan,\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  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** 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  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  rowGap?: number;\n}\n\n/**\n * Options accepted by `update()`. Explicit interface instead of\n * `Partial<Omit<...>>` for better IDE hover (R7).\n */\nexport interface GridVirtualizerUpdateOptions {\n  colCount?: number;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  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  readonly disposed: boolean;\n  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\n  readonly scrollTop: number;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  dispose: () => void;\n  invalidate: () => void;\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  measureBatch: (rows: Array<{ index: number; size: number }>, cols: Array<{ index: number; size: number }>) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the column width on resize. Returns disconnect fn. */\n  measureColEl: (col: number, el: HTMLElement) => () => void;\n  measureColumn: (col: number, size: number) => void;\n  measureRow: (row: number, size: number) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the row height on resize. Returns disconnect fn. */\n  measureRowEl: (row: number, el: HTMLElement) => () => void;\n  /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */\n  prependRows: (additionalRowCount: number) => void;\n  refresh: () => void;\n  scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;\n  /** Scroll to bring a row into view without changing the horizontal position. */\n  scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── 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 { 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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"}

package/dist/grid-virtualizer.d.ts

@@ -1,6 +1,6 @@
 import { type VirtualItem } from './_axis1d';
 import { type Overscan, type ScrollTarget } from './_utils';
-export { type VirtualItem };
+export type { VirtualItem };
 export interface GridVirtualizerState {
     /**
      * Visible column descriptors.
@@ -26,9 +26,9 @@ export interface ScrollToCellOptions {
 }
 export interface GridVirtualizerOptions {
     colCount: number;
+    colGap?: number;
     /** External measurement cache for columns. Share across instances for scroll restoration. */
     colMeasurementCache?: Map<number, number>;
-    colGap?: number;
     estimateColSize?: number | ((col: number) => number);
     estimateRowSize?: number | ((row: number) => number);
     initialScrollLeft?: number;
@@ -40,9 +40,9 @@ export interface GridVirtualizerOptions {
     overscanX?: Overscan;
     overscanY?: Overscan;
     rowCount: number;
+    rowGap?: number;
     /** External measurement cache for rows. Share across instances for scroll restoration. */
     rowMeasurementCache?: Map<number, number>;
-    rowGap?: number;
 }
 /**
  * Options accepted by `update()`. Explicit interface instead of
@@ -63,13 +63,8 @@ export interface GridVirtualizerUpdateOptions {
 export interface GridVirtualizer {
     readonly cols: VirtualItem[];
     readonly disposalSignal: AbortSignal;
-    readonly disposed: boolean;
-    readonly rows: VirtualItem[];
-    readonly scrollLeft: number;
-    readonly scrollTop: number;
-    readonly totalHeight: number;
-    readonly totalWidth: number;
     dispose: () => void;
+    readonly disposed: boolean;
     invalidate: () => void;
     /** Measure rows and columns in a single coordinated rebuild pass (R4). */
     measureBatch: (rows: Array<{
@@ -88,11 +83,16 @@ export interface GridVirtualizer {
     /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */
     prependRows: (additionalRowCount: number) => void;
     refresh: () => void;
+    readonly rows: VirtualItem[];
+    readonly scrollLeft: number;
     scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;
     /** Scroll to bring a row into view without changing the horizontal position. */
     scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;
+    readonly scrollTop: number;
     /** Scroll to bring a column into view without changing the vertical position. */
     scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;
+    readonly totalHeight: number;
+    readonly totalWidth: number;
     update: (next: GridVirtualizerUpdateOptions) => void;
     [Symbol.dispose]: () => void;
 }

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.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  observeResize,\n  type Overscan,\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  /** External measurement cache for columns. Share across instances for scroll restoration. */\n  colMeasurementCache?: Map<number, number>;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  initialScrollLeft?: number;\n  initialScrollTop?: number;\n  /** 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  /** External measurement cache for rows. Share across instances for scroll restoration. */\n  rowMeasurementCache?: Map<number, number>;\n  rowGap?: number;\n}\n\n/**\n * Options accepted by `update()`. Explicit interface instead of\n * `Partial<Omit<...>>` for better IDE hover (R7).\n */\nexport interface GridVirtualizerUpdateOptions {\n  colCount?: number;\n  colGap?: number;\n  estimateColSize?: number | ((col: number) => number);\n  estimateRowSize?: number | ((row: number) => number);\n  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  readonly disposed: boolean;\n  readonly rows: VirtualItem[];\n  readonly scrollLeft: number;\n  readonly scrollTop: number;\n  readonly totalHeight: number;\n  readonly totalWidth: number;\n  dispose: () => void;\n  invalidate: () => void;\n  /** Measure rows and columns in a single coordinated rebuild pass (R4). */\n  measureBatch: (rows: Array<{ index: number; size: number }>, cols: Array<{ index: number; size: number }>) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the column width on resize. Returns disconnect fn. */\n  measureColEl: (col: number, el: HTMLElement) => () => void;\n  measureColumn: (col: number, size: number) => void;\n  measureRow: (row: number, size: number) => void;\n  /** Attach a ResizeObserver to `el` to auto-measure the row height on resize. Returns disconnect fn. */\n  measureRowEl: (row: number, el: HTMLElement) => () => void;\n  /** Prepend `additionalRowCount` rows at the top while keeping the viewport visually stable. */\n  prependRows: (additionalRowCount: number) => void;\n  refresh: () => void;\n  scrollToCell: (row: number, col: number, options?: ScrollToCellOptions) => void;\n  /** Scroll to bring a row into view without changing the horizontal position. */\n  scrollToColumn: (col: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'colAlign'>) => void;\n  /** Scroll to bring a column into view without changing the vertical position. */\n  scrollToRow: (row: number, options?: Pick<ScrollToCellOptions, 'behavior' | 'rowAlign'>) => void;\n  update: (next: GridVirtualizerUpdateOptions) => void;\n  [Symbol.dispose]: () => void;\n}\n\n// ─── 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 { 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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"}