@tanstack/virtual-core 3.5.0 → 3.6.0

package/dist/cjs/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sources":["../../src/utils.ts"],"sourcesContent":["export type NoInfer<A extends any> = [A][A extends any ? 0 : never]\n\nexport type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>\n\nexport function memo<TDeps extends readonly any[], TResult>(\n  getDeps: () => [...TDeps],\n  fn: (...args: NoInfer<[...TDeps]>) => TResult,\n  opts: {\n    key: false | string\n    debug?: () => any\n    onChange?: (result: TResult) => void\n    initialDeps?: TDeps\n  },\n) {\n  let deps = opts.initialDeps ?? []\n  let result: TResult | undefined\n\n  return (): TResult => {\n    let depTime: number\n    if (opts.key && opts.debug?.()) depTime = Date.now()\n\n    const newDeps = getDeps()\n\n    const depsChanged =\n      newDeps.length !== deps.length ||\n      newDeps.some((dep: any, index: number) => deps[index] !== dep)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    let resultTime: number\n    if (opts.key && opts.debug?.()) resultTime = Date.now()\n\n    result = fn(...newDeps)\n\n    if (opts.key && opts.debug?.()) {\n      const depEndTime = Math.round((Date.now() - depTime!) * 100) / 100\n      const resultEndTime = Math.round((Date.now() - resultTime!) * 100) / 100\n      const resultFpsPercentage = resultEndTime / 16\n\n      const pad = (str: number | string, num: number) => {\n        str = String(str)\n        while (str.length < num) {\n          str = ' ' + str\n        }\n        return str\n      }\n\n      console.info(\n        `%c⏱ ${pad(resultEndTime, 5)} /${pad(depEndTime, 5)} ms`,\n        `\n            font-size: .6rem;\n            font-weight: bold;\n            color: hsl(${Math.max(\n              0,\n              Math.min(120 - 120 * resultFpsPercentage, 120),\n            )}deg 100% 31%);`,\n        opts?.key,\n      )\n    }\n\n    opts?.onChange?.(result)\n\n    return result!\n  }\n}\n\nexport function notUndefined<T>(value: T | undefined, msg?: string): T {\n  if (value === undefined) {\n    throw new Error(`Unexpected undefined${msg ? `: ${msg}` : ''}`)\n  } else {\n    return value\n  }\n}\n\nexport const approxEqual = (a: number, b: number) => Math.abs(a - b) < 1\n\nexport const debounce = (fn: Function, ms: number) => {\n  let timeoutId: ReturnType<typeof setTimeout>\n  return function (this: any, ...args: any[]) {\n    clearTimeout(timeoutId)\n    timeoutId = setTimeout(() => fn.apply(this, args), ms)\n  }\n}\n"],"names":[],"mappings":";;AAIgB,SAAA,KACd,SACA,IACA,MAMA;AACI,MAAA,OAAO,KAAK,eAAe;AAC3B,MAAA;AAEJ,SAAO,MAAe;;AAChB,QAAA;AACA,QAAA,KAAK,SAAO,UAAK,UAAL;AAAgB,gBAAU,KAAK;AAE/C,UAAM,UAAU;AAEhB,UAAM,cACJ,QAAQ,WAAW,KAAK,UACxB,QAAQ,KAAK,CAAC,KAAU,UAAkB,KAAK,KAAK,MAAM,GAAG;AAE/D,QAAI,CAAC,aAAa;AACT,aAAA;AAAA,IACT;AAEO,WAAA;AAEH,QAAA;AACA,QAAA,KAAK,SAAO,UAAK,UAAL;AAAgB,mBAAa,KAAK;AAEzC,aAAA,GAAG,GAAG,OAAO;AAEtB,QAAI,KAAK,SAAO,UAAK,UAAL,gCAAgB;AACxB,YAAA,aAAa,KAAK,OAAO,KAAK,QAAQ,WAAY,GAAG,IAAI;AACzD,YAAA,gBAAgB,KAAK,OAAO,KAAK,QAAQ,cAAe,GAAG,IAAI;AACrE,YAAM,sBAAsB,gBAAgB;AAEtC,YAAA,MAAM,CAAC,KAAsB,QAAgB;AACjD,cAAM,OAAO,GAAG;AACT,eAAA,IAAI,SAAS,KAAK;AACvB,gBAAM,MAAM;AAAA,QACd;AACO,eAAA;AAAA,MAAA;AAGD,cAAA;AAAA,QACN,OAAO,IAAI,eAAe,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;AAAA,QACnD;AAAA;AAAA;AAAA,yBAGiB,KAAK;AAAA,UAChB;AAAA,UACA,KAAK,IAAI,MAAM,MAAM,qBAAqB,GAAG;AAAA,QAC9C,CAAA;AAAA,QACL,6BAAM;AAAA,MAAA;AAAA,IAEV;AAEA,uCAAM,aAAN,8BAAiB;AAEV,WAAA;AAAA,EAAA;AAEX;AAEgB,SAAA,aAAgB,OAAsB,KAAiB;AACrE,MAAI,UAAU,QAAW;AACjB,UAAA,IAAI,MAAM,uBAAuB,MAAM,KAAK,GAAG,KAAK,EAAE,EAAE;AAAA,EAAA,OACzD;AACE,WAAA;AAAA,EACT;AACF;AAEa,MAAA,cAAc,CAAC,GAAW,MAAc,KAAK,IAAI,IAAI,CAAC,IAAI;AAE1D,MAAA,WAAW,CAAC,IAAc,OAAe;AAChD,MAAA;AACJ,SAAO,YAAwB,MAAa;AAC1C,iBAAa,SAAS;AACtB,gBAAY,WAAW,MAAM,GAAG,MAAM,MAAM,IAAI,GAAG,EAAE;AAAA,EAAA;AAEzD;;;;;"}
+{"version":3,"file":"utils.cjs","sources":["../../src/utils.ts"],"sourcesContent":["export type NoInfer<A extends any> = [A][A extends any ? 0 : never]\n\nexport type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>\n\nexport function memo<TDeps extends readonly any[], TResult>(\n  getDeps: () => [...TDeps],\n  fn: (...args: NoInfer<[...TDeps]>) => TResult,\n  opts: {\n    key: false | string\n    debug?: () => any\n    onChange?: (result: TResult) => void\n    initialDeps?: TDeps\n  },\n) {\n  let deps = opts.initialDeps ?? []\n  let result: TResult | undefined\n\n  return (): TResult => {\n    let depTime: number\n    if (opts.key && opts.debug?.()) depTime = Date.now()\n\n    const newDeps = getDeps()\n\n    const depsChanged =\n      newDeps.length !== deps.length ||\n      newDeps.some((dep: any, index: number) => deps[index] !== dep)\n\n    if (!depsChanged) {\n      return result!\n    }\n\n    deps = newDeps\n\n    let resultTime: number\n    if (opts.key && opts.debug?.()) resultTime = Date.now()\n\n    result = fn(...newDeps)\n\n    if (opts.key && opts.debug?.()) {\n      const depEndTime = Math.round((Date.now() - depTime!) * 100) / 100\n      const resultEndTime = Math.round((Date.now() - resultTime!) * 100) / 100\n      const resultFpsPercentage = resultEndTime / 16\n\n      const pad = (str: number | string, num: number) => {\n        str = String(str)\n        while (str.length < num) {\n          str = ' ' + str\n        }\n        return str\n      }\n\n      console.info(\n        `%c⏱ ${pad(resultEndTime, 5)} /${pad(depEndTime, 5)} ms`,\n        `\n            font-size: .6rem;\n            font-weight: bold;\n            color: hsl(${Math.max(\n              0,\n              Math.min(120 - 120 * resultFpsPercentage, 120),\n            )}deg 100% 31%);`,\n        opts?.key,\n      )\n    }\n\n    opts?.onChange?.(result)\n\n    return result!\n  }\n}\n\nexport function notUndefined<T>(value: T | undefined, msg?: string): T {\n  if (value === undefined) {\n    throw new Error(`Unexpected undefined${msg ? `: ${msg}` : ''}`)\n  } else {\n    return value\n  }\n}\n\nexport const approxEqual = (a: number, b: number) => Math.abs(a - b) < 1\n\nexport const debounce = (\n  targetWindow: Window & typeof globalThis,\n  fn: Function,\n  ms: number,\n) => {\n  let timeoutId: number\n  return function (this: any, ...args: any[]) {\n    targetWindow.clearTimeout(timeoutId)\n    timeoutId = targetWindow.setTimeout(() => fn.apply(this, args), ms)\n  }\n}\n"],"names":[],"mappings":";;AAIgB,SAAA,KACd,SACA,IACA,MAMA;AACI,MAAA,OAAO,KAAK,eAAe;AAC3B,MAAA;AAEJ,SAAO,MAAe;;AAChB,QAAA;AACA,QAAA,KAAK,SAAO,UAAK,UAAL;AAAgB,gBAAU,KAAK;AAE/C,UAAM,UAAU;AAEhB,UAAM,cACJ,QAAQ,WAAW,KAAK,UACxB,QAAQ,KAAK,CAAC,KAAU,UAAkB,KAAK,KAAK,MAAM,GAAG;AAE/D,QAAI,CAAC,aAAa;AACT,aAAA;AAAA,IACT;AAEO,WAAA;AAEH,QAAA;AACA,QAAA,KAAK,SAAO,UAAK,UAAL;AAAgB,mBAAa,KAAK;AAEzC,aAAA,GAAG,GAAG,OAAO;AAEtB,QAAI,KAAK,SAAO,UAAK,UAAL,gCAAgB;AACxB,YAAA,aAAa,KAAK,OAAO,KAAK,QAAQ,WAAY,GAAG,IAAI;AACzD,YAAA,gBAAgB,KAAK,OAAO,KAAK,QAAQ,cAAe,GAAG,IAAI;AACrE,YAAM,sBAAsB,gBAAgB;AAEtC,YAAA,MAAM,CAAC,KAAsB,QAAgB;AACjD,cAAM,OAAO,GAAG;AACT,eAAA,IAAI,SAAS,KAAK;AACvB,gBAAM,MAAM;AAAA,QACd;AACO,eAAA;AAAA,MAAA;AAGD,cAAA;AAAA,QACN,OAAO,IAAI,eAAe,CAAC,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;AAAA,QACnD;AAAA;AAAA;AAAA,yBAGiB,KAAK;AAAA,UAChB;AAAA,UACA,KAAK,IAAI,MAAM,MAAM,qBAAqB,GAAG;AAAA,QAC9C,CAAA;AAAA,QACL,6BAAM;AAAA,MAAA;AAAA,IAEV;AAEA,uCAAM,aAAN,8BAAiB;AAEV,WAAA;AAAA,EAAA;AAEX;AAEgB,SAAA,aAAgB,OAAsB,KAAiB;AACrE,MAAI,UAAU,QAAW;AACjB,UAAA,IAAI,MAAM,uBAAuB,MAAM,KAAK,GAAG,KAAK,EAAE,EAAE;AAAA,EAAA,OACzD;AACE,WAAA;AAAA,EACT;AACF;AAEa,MAAA,cAAc,CAAC,GAAW,MAAc,KAAK,IAAI,IAAI,CAAC,IAAI;AAEhE,MAAM,WAAW,CACtB,cACA,IACA,OACG;AACC,MAAA;AACJ,SAAO,YAAwB,MAAa;AAC1C,iBAAa,aAAa,SAAS;AACvB,gBAAA,aAAa,WAAW,MAAM,GAAG,MAAM,MAAM,IAAI,GAAG,EAAE;AAAA,EAAA;AAEtE;;;;;"}

package/dist/cjs/utils.d.cts

@@ -8,4 +8,4 @@ export declare function memo<TDeps extends readonly any[], TResult>(getDeps: ()
 }): () => TResult;
 export declare function notUndefined<T>(value: T | undefined, msg?: string): T;
 export declare const approxEqual: (a: number, b: number) => boolean;
-export declare const debounce: (fn: Function, ms: number) => (this: any, ...args: any[]) => void;
+export declare const debounce: (targetWindow: Window & typeof globalThis, fn: Function, ms: number) => (this: any, ...args: any[]) => void;

package/dist/esm/index.d.ts

@@ -71,18 +71,20 @@ export interface VirtualizerOptions<TScrollElement extends Element | Window, TIt
     initialMeasurementsCache?: VirtualItem[];
     lanes?: number;
     isScrollingResetDelay?: number;
+    enabled?: boolean;
 }
 export declare class Virtualizer<TScrollElement extends Element | Window, TItemElement extends Element> {
     private unsubs;
     options: Required<VirtualizerOptions<TScrollElement, TItemElement>>;
     scrollElement: TScrollElement | null;
+    targetWindow: (Window & typeof globalThis) | null;
     isScrolling: boolean;
     private scrollToIndexTimeoutId;
     measurementsCache: VirtualItem[];
     private itemSizeCache;
     private pendingMeasuredCacheIndexes;
-    scrollRect: Rect;
-    scrollOffset: number;
+    scrollRect: Rect | null;
+    scrollOffset: number | null;
     scrollDirection: ScrollDirection | null;
     private scrollAdjustments;
     shouldAdjustScrollPositionOnItemSizeChange: undefined | ((item: VirtualItem, delta: number, instance: Virtualizer<TScrollElement, TItemElement>) => boolean);
@@ -99,8 +101,9 @@ export declare class Virtualizer<TScrollElement extends Element | Window, TItemE
     _didMount: () => () => void;
     _willUpdate: () => void;
     private getSize;
-    private getMeasurementOptions;
+    private getScrollOffset;
     private getFurthestMeasurement;
+    private getMeasurementOptions;
     private getMeasurements;
     calculateRange: () => {
         startIndex: number;
@@ -112,9 +115,9 @@ export declare class Virtualizer<TScrollElement extends Element | Window, TItemE
     resizeItem: (item: VirtualItem, size: number) => void;
     measureElement: (node: TItemElement | null) => void;
     getVirtualItems: () => VirtualItem[];
-    getVirtualItemForOffset: (offset: number) => VirtualItem;
+    getVirtualItemForOffset: (offset: number) => VirtualItem | undefined;
     getOffsetForAlignment: (toOffset: number, align: ScrollAlignment) => number;
-    getOffsetForIndex: (index: number, align?: ScrollAlignment) => readonly [number, "auto"] | readonly [number, "start" | "center" | "end"];
+    getOffsetForIndex: (index: number, align?: ScrollAlignment) => readonly [number, "auto"] | readonly [number, "start" | "center" | "end"] | undefined;
     private isDynamicMode;
     private cancelScrollToIndex;
     scrollToOffset: (toOffset: number, { align, behavior }?: ScrollToOffsetOptions) => void;

package/dist/esm/index.js

@@ -14,16 +14,20 @@ const observeElementRect = (instance, cb) => {
   if (!element) {
     return;
   }
+  const targetWindow = instance.targetWindow;
+  if (!targetWindow) {
+    return;
+  }
   const handler = (rect) => {
     const { width, height } = rect;
     cb({ width: Math.round(width), height: Math.round(height) });
   };
   handler(element.getBoundingClientRect());
-  if (typeof ResizeObserver === "undefined") {
+  if (!targetWindow.ResizeObserver) {
     return () => {
     };
   }
-  const observer = new ResizeObserver((entries) => {
+  const observer = new targetWindow.ResizeObserver((entries) => {
     const entry = entries[0];
     if (entry == null ? void 0 : entry.borderBoxSize) {
       const box = entry.borderBoxSize[0];
@@ -62,10 +66,18 @@ const observeElementOffset = (instance, cb) => {
   if (!element) {
     return;
   }
+  const targetWindow = instance.targetWindow;
+  if (!targetWindow) {
+    return;
+  }
   let offset = 0;
-  const fallback = supportsScrollend ? () => void 0 : debounce(() => {
-    cb(offset, false);
-  }, instance.options.isScrollingResetDelay);
+  const fallback = supportsScrollend ? () => void 0 : debounce(
+    targetWindow,
+    () => {
+      cb(offset, false);
+    },
+    instance.options.isScrollingResetDelay
+  );
   const createHandler = (isScrolling) => () => {
     offset = element[instance.options.horizontal ? "scrollLeft" : "scrollTop"];
     fallback();
@@ -86,10 +98,18 @@ const observeWindowOffset = (instance, cb) => {
   if (!element) {
     return;
   }
+  const targetWindow = instance.targetWindow;
+  if (!targetWindow) {
+    return;
+  }
   let offset = 0;
-  const fallback = supportsScrollend ? () => void 0 : debounce(() => {
-    cb(offset, false);
-  }, instance.options.isScrollingResetDelay);
+  const fallback = supportsScrollend ? () => void 0 : debounce(
+    targetWindow,
+    () => {
+      cb(offset, false);
+    },
+    instance.options.isScrollingResetDelay
+  );
   const createHandler = (isScrolling) => () => {
     offset = element[instance.options.horizontal ? "scrollX" : "scrollY"];
     fallback();
@@ -145,11 +165,14 @@ class Virtualizer {
   constructor(opts) {
     this.unsubs = [];
     this.scrollElement = null;
+    this.targetWindow = null;
     this.isScrolling = false;
     this.scrollToIndexTimeoutId = null;
     this.measurementsCache = [];
     this.itemSizeCache = /* @__PURE__ */ new Map();
     this.pendingMeasuredCacheIndexes = [];
+    this.scrollRect = null;
+    this.scrollOffset = null;
     this.scrollDirection = null;
     this.scrollAdjustments = 0;
     this.measureElementCache = /* @__PURE__ */ new Map();
@@ -158,15 +181,15 @@ class Virtualizer {
       const get = () => {
         if (_ro) {
           return _ro;
-        } else if (typeof ResizeObserver !== "undefined") {
-          return _ro = new ResizeObserver((entries) => {
-            entries.forEach((entry) => {
-              this._measureElement(entry.target, entry);
-            });
-          });
-        } else {
+        }
+        if (!this.targetWindow || !this.targetWindow.ResizeObserver) {
           return null;
         }
+        return _ro = new this.targetWindow.ResizeObserver((entries) => {
+          entries.forEach((entry) => {
+            this._measureElement(entry.target, entry);
+          });
+        });
       };
       return {
         disconnect: () => {
@@ -210,6 +233,7 @@ class Virtualizer {
         initialMeasurementsCache: [],
         lanes: 1,
         isScrollingResetDelay: 150,
+        enabled: true,
         ...opts2
       };
     };
@@ -228,20 +252,31 @@ class Virtualizer {
       this.unsubs.filter(Boolean).forEach((d) => d());
       this.unsubs = [];
       this.scrollElement = null;
+      this.targetWindow = null;
+      this.observer.disconnect();
+      this.measureElementCache.clear();
     };
     this._didMount = () => {
-      this.measureElementCache.forEach(this.observer.observe);
       return () => {
-        this.observer.disconnect();
         this.cleanup();
       };
     };
     this._willUpdate = () => {
-      const scrollElement = this.options.getScrollElement();
+      var _a;
+      const scrollElement = this.options.enabled ? this.options.getScrollElement() : null;
       if (this.scrollElement !== scrollElement) {
         this.cleanup();
+        if (!scrollElement) {
+          this.notify(false, false);
+          return;
+        }
         this.scrollElement = scrollElement;
-        this._scrollToOffset(this.scrollOffset, {
+        if (this.scrollElement && "ownerDocument" in this.scrollElement) {
+          this.targetWindow = this.scrollElement.ownerDocument.defaultView;
+        } else {
+          this.targetWindow = ((_a = this.scrollElement) == null ? void 0 : _a.window) ?? null;
+        }
+        this._scrollToOffset(this.getScrollOffset(), {
           adjustments: void 0,
           behavior: void 0
         });
@@ -254,7 +289,7 @@ class Virtualizer {
         this.unsubs.push(
           this.options.observeElementOffset(this, (offset, isScrolling) => {
             this.scrollAdjustments = 0;
-            this.scrollDirection = isScrolling ? this.scrollOffset < offset ? "forward" : "backward" : null;
+            this.scrollDirection = isScrolling ? this.getScrollOffset() < offset ? "forward" : "backward" : null;
             this.scrollOffset = offset;
             const prevIsScrolling = this.isScrolling;
             this.isScrolling = isScrolling;
@@ -264,28 +299,21 @@ class Virtualizer {
       }
     };
     this.getSize = () => {
+      if (!this.options.enabled) {
+        this.scrollRect = null;
+        return 0;
+      }
+      this.scrollRect = this.scrollRect ?? this.options.initialRect;
       return this.scrollRect[this.options.horizontal ? "width" : "height"];
     };
-    this.getMeasurementOptions = memo(
-      () => [
-        this.options.count,
-        this.options.paddingStart,
-        this.options.scrollMargin,
-        this.options.getItemKey
-      ],
-      (count, paddingStart, scrollMargin, getItemKey) => {
-        this.pendingMeasuredCacheIndexes = [];
-        return {
-          count,
-          paddingStart,
-          scrollMargin,
-          getItemKey
-        };
-      },
-      {
-        key: false
+    this.getScrollOffset = () => {
+      if (!this.options.enabled) {
+        this.scrollOffset = null;
+        return 0;
       }
-    );
+      this.scrollOffset = this.scrollOffset ?? (typeof this.options.initialOffset === "function" ? this.options.initialOffset() : this.options.initialOffset);
+      return this.scrollOffset;
+    };
     this.getFurthestMeasurement = (measurements, index) => {
       const furthestMeasurementsFound = /* @__PURE__ */ new Map();
       const furthestMeasurements = /* @__PURE__ */ new Map();
@@ -313,9 +341,42 @@ class Virtualizer {
         return a.end - b.end;
       })[0] : void 0;
     };
+    this.getMeasurementOptions = memo(
+      () => [
+        this.options.count,
+        this.options.paddingStart,
+        this.options.scrollMargin,
+        this.options.getItemKey,
+        this.options.enabled
+      ],
+      (count, paddingStart, scrollMargin, getItemKey, enabled) => {
+        this.pendingMeasuredCacheIndexes = [];
+        return {
+          count,
+          paddingStart,
+          scrollMargin,
+          getItemKey,
+          enabled
+        };
+      },
+      {
+        key: false
+      }
+    );
     this.getMeasurements = memo(
       () => [this.getMeasurementOptions(), this.itemSizeCache],
-      ({ count, paddingStart, scrollMargin, getItemKey }, itemSizeCache) => {
+      ({ count, paddingStart, scrollMargin, getItemKey, enabled }, itemSizeCache) => {
+        if (!enabled) {
+          this.measurementsCache = [];
+          this.itemSizeCache.clear();
+          return [];
+        }
+        if (this.measurementsCache.length === 0) {
+          this.measurementsCache = this.options.initialMeasurementsCache;
+          this.measurementsCache.forEach((item) => {
+            this.itemSizeCache.set(item.key, item.size);
+          });
+        }
         const min = this.pendingMeasuredCacheIndexes.length > 0 ? Math.min(...this.pendingMeasuredCacheIndexes) : 0;
         this.pendingMeasuredCacheIndexes = [];
         const measurements = this.measurementsCache.slice(0, min);
@@ -345,7 +406,7 @@ class Virtualizer {
       }
     );
     this.calculateRange = memo(
-      () => [this.getMeasurements(), this.getSize(), this.scrollOffset],
+      () => [this.getMeasurements(), this.getSize(), this.getScrollOffset()],
       (measurements, outerSize, scrollOffset) => {
         return this.range = measurements.length > 0 && outerSize > 0 ? calculateRange({
           measurements,
@@ -390,7 +451,7 @@ class Virtualizer {
       return parseInt(indexStr, 10);
     };
     this._measureElement = (node, entry) => {
-      const item = this.measurementsCache[this.indexFromElement(node)];
+      const item = this.getMeasurements()[this.indexFromElement(node)];
       if (!item || !node.isConnected) {
         this.measureElementCache.forEach((cached, key) => {
           if (cached === node) {
@@ -415,11 +476,11 @@ class Virtualizer {
       const itemSize = this.itemSizeCache.get(item.key) ?? item.size;
       const delta = size - itemSize;
       if (delta !== 0) {
-        if (this.shouldAdjustScrollPositionOnItemSizeChange !== void 0 ? this.shouldAdjustScrollPositionOnItemSizeChange(item, delta, this) : item.start < this.scrollOffset + this.scrollAdjustments) {
+        if (this.shouldAdjustScrollPositionOnItemSizeChange !== void 0 ? this.shouldAdjustScrollPositionOnItemSizeChange(item, delta, this) : item.start < this.getScrollOffset() + this.scrollAdjustments) {
           if (process.env.NODE_ENV !== "production" && this.options.debug) {
             console.info("correction", delta);
           }
-          this._scrollToOffset(this.scrollOffset, {
+          this._scrollToOffset(this.getScrollOffset(), {
             adjustments: this.scrollAdjustments += delta,
             behavior: void 0
           });
@@ -453,6 +514,9 @@ class Virtualizer {
     );
     this.getVirtualItemForOffset = (offset) => {
       const measurements = this.getMeasurements();
+      if (measurements.length === 0) {
+        return void 0;
+      }
       return notUndefined(
         measurements[findNearestBinarySearch(
           0,
@@ -464,10 +528,11 @@ class Virtualizer {
     };
     this.getOffsetForAlignment = (toOffset, align) => {
       const size = this.getSize();
+      const scrollOffset = this.getScrollOffset();
       if (align === "auto") {
-        if (toOffset <= this.scrollOffset) {
+        if (toOffset <= scrollOffset) {
           align = "start";
-        } else if (toOffset >= this.scrollOffset + size) {
+        } else if (toOffset >= scrollOffset + size) {
           align = "end";
         } else {
           align = "start";
@@ -482,28 +547,33 @@ class Virtualizer {
       }
       const scrollSizeProp = this.options.horizontal ? "scrollWidth" : "scrollHeight";
       const scrollSize = this.scrollElement ? "document" in this.scrollElement ? this.scrollElement.document.documentElement[scrollSizeProp] : this.scrollElement[scrollSizeProp] : 0;
-      const maxOffset = scrollSize - this.getSize();
+      const maxOffset = scrollSize - size;
       return Math.max(Math.min(maxOffset, toOffset), 0);
     };
     this.getOffsetForIndex = (index, align = "auto") => {
       index = Math.max(0, Math.min(index, this.options.count - 1));
-      const measurement = notUndefined(this.getMeasurements()[index]);
+      const item = this.getMeasurements()[index];
+      if (!item) {
+        return void 0;
+      }
+      const size = this.getSize();
+      const scrollOffset = this.getScrollOffset();
       if (align === "auto") {
-        if (measurement.end >= this.scrollOffset + this.getSize() - this.options.scrollPaddingEnd) {
+        if (item.end >= scrollOffset + size - this.options.scrollPaddingEnd) {
           align = "end";
-        } else if (measurement.start <= this.scrollOffset + this.options.scrollPaddingStart) {
+        } else if (item.start <= scrollOffset + this.options.scrollPaddingStart) {
           align = "start";
         } else {
-          return [this.scrollOffset, align];
+          return [scrollOffset, align];
         }
       }
-      const toOffset = align === "end" ? measurement.end + this.options.scrollPaddingEnd : measurement.start - this.options.scrollPaddingStart;
+      const toOffset = align === "end" ? item.end + this.options.scrollPaddingEnd : item.start - this.options.scrollPaddingStart;
       return [this.getOffsetForAlignment(toOffset, align), align];
     };
     this.isDynamicMode = () => this.measureElementCache.size > 0;
     this.cancelScrollToIndex = () => {
-      if (this.scrollToIndexTimeoutId !== null) {
-        clearTimeout(this.scrollToIndexTimeoutId);
+      if (this.scrollToIndexTimeoutId !== null && this.targetWindow) {
+        this.targetWindow.clearTimeout(this.scrollToIndexTimeoutId);
         this.scrollToIndexTimeoutId = null;
       }
     };
@@ -527,17 +597,22 @@ class Virtualizer {
           "The `smooth` scroll behavior is not fully supported with dynamic size."
         );
       }
-      const [toOffset, align] = this.getOffsetForIndex(index, initialAlign);
-      this._scrollToOffset(toOffset, { adjustments: void 0, behavior });
-      if (behavior !== "smooth" && this.isDynamicMode()) {
-        this.scrollToIndexTimeoutId = setTimeout(() => {
+      const offsetAndAlign = this.getOffsetForIndex(index, initialAlign);
+      if (!offsetAndAlign)
+        return;
+      const [offset, align] = offsetAndAlign;
+      this._scrollToOffset(offset, { adjustments: void 0, behavior });
+      if (behavior !== "smooth" && this.isDynamicMode() && this.targetWindow) {
+        this.scrollToIndexTimeoutId = this.targetWindow.setTimeout(() => {
           this.scrollToIndexTimeoutId = null;
           const elementInDOM = this.measureElementCache.has(
             this.options.getItemKey(index)
           );
           if (elementInDOM) {
-            const [toOffset2] = this.getOffsetForIndex(index, align);
-            if (!approxEqual(toOffset2, this.scrollOffset)) {
+            const [latestOffset] = notUndefined(
+              this.getOffsetForIndex(index, align)
+            );
+            if (!approxEqual(latestOffset, this.getScrollOffset())) {
               this.scrollToIndex(index, { align, behavior });
             }
           } else {
@@ -553,7 +628,7 @@ class Virtualizer {
           "The `smooth` scroll behavior is not fully supported with dynamic size."
         );
       }
-      this._scrollToOffset(this.scrollOffset + delta, {
+      this._scrollToOffset(this.getScrollOffset() + delta, {
         adjustments: void 0,
         behavior
       });
@@ -583,13 +658,6 @@ class Virtualizer {
       (_b = (_a = this.options).onChange) == null ? void 0 : _b.call(_a, this, false);
     };
     this.setOptions(opts);
-    this.scrollRect = this.options.initialRect;
-    this.scrollOffset = typeof this.options.initialOffset === "function" ? this.options.initialOffset() : this.options.initialOffset;
-    this.measurementsCache = this.options.initialMeasurementsCache;
-    this.measurementsCache.forEach((item) => {
-      this.itemSizeCache.set(item.key, item.size);
-    });
-    this.notify(false, false);
   }
 }
 const findNearestBinarySearch = (low, high, getCurrentValue, value) => {