clear-virtualizer 0.1.1 → 0.1.2

package/README.md

@@ -232,11 +232,14 @@ If the row is far away and its neighbors were never measured, the hook first jum
 
 `estimateSize` is only a starting guess until real measurements arrive. The closer it is to reality, the less rows visually shift on fast scroll through unmeasured regions: underestimated rows overlap until measured, overestimated ones leave temporary gaps. Pass a value near your average row height.
 
+## SSR
+
+Server-side rendering is supported: on the server the hook renders an empty container (`virtualItems: []`, `scrollHeight: 0`) without touching browser APIs. Rows appear after hydration once the scroll container is attached and `ResizeObserver` reports real heights.
+
 ## Limitations
 
 -   Vertical scrolling only — no horizontal virtualization, no sticky columns.
 -   The internal offset tree keeps one `float64` per row (~8 MB per million rows).
--   Server-side rendering is not covered by tests.
 
 ## License
 

package/lib/index.cjs

@@ -204,6 +204,8 @@ function useVirtualizer({ count, estimateSize, overscan = DEFAULT_OVERSCAN }) {
       existing.observer.disconnect();
       observersRef.current.delete(index);
     }
+    if (typeof ResizeObserver === "undefined")
+      return;
     const observer = new ResizeObserver(([entry]) => {
       const height = entry?.borderBoxSize[0]?.blockSize;
       if (height == null || !fenwickRef.current)
@@ -371,6 +373,21 @@ function useVirtualizer({ count, estimateSize, overscan = DEFAULT_OVERSCAN }) {
     },
     [handleScroll]
   );
+  react.useEffect(
+    () => () => {
+      if (rafRef.current !== null)
+        cancelAnimationFrame(rafRef.current);
+      if (tickRafRef.current !== null)
+        cancelAnimationFrame(tickRafRef.current);
+      observersRef.current.forEach((entry) => entry.observer.disconnect());
+      observersRef.current.clear();
+      containerObserverRef.current?.disconnect();
+      containerObserverRef.current = null;
+      scrollElementRef.current?.removeEventListener("scroll", handleScroll);
+      refCacheRef.current.clear();
+    },
+    [handleScroll]
+  );
   const { virtualItems, scrollHeight } = react.useMemo(
     () => computeItems(scrollOffset.value),
     [computeItems, scrollOffset]

package/lib/index.js

@@ -202,6 +202,8 @@ function useVirtualizer({ count, estimateSize, overscan = DEFAULT_OVERSCAN }) {
       existing.observer.disconnect();
       observersRef.current.delete(index);
     }
+    if (typeof ResizeObserver === "undefined")
+      return;
     const observer = new ResizeObserver(([entry]) => {
       const height = entry?.borderBoxSize[0]?.blockSize;
       if (height == null || !fenwickRef.current)
@@ -369,6 +371,21 @@ function useVirtualizer({ count, estimateSize, overscan = DEFAULT_OVERSCAN }) {
     },
     [handleScroll]
   );
+  useEffect(
+    () => () => {
+      if (rafRef.current !== null)
+        cancelAnimationFrame(rafRef.current);
+      if (tickRafRef.current !== null)
+        cancelAnimationFrame(tickRafRef.current);
+      observersRef.current.forEach((entry) => entry.observer.disconnect());
+      observersRef.current.clear();
+      containerObserverRef.current?.disconnect();
+      containerObserverRef.current = null;
+      scrollElementRef.current?.removeEventListener("scroll", handleScroll);
+      refCacheRef.current.clear();
+    },
+    [handleScroll]
+  );
   const { virtualItems, scrollHeight } = useMemo(
     () => computeItems(scrollOffset.value),
     [computeItems, scrollOffset]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-virtualizer",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A lightweight React hook for virtualized lists and tables with dynamic row heights, measured automatically",
   "type": "module",
   "main": "./lib/index.cjs",