react-virtual-renderer 1.0.5 → 1.0.7

package/dist/core/VirtualizationEngine.js

@@ -1,11 +1,3 @@
-/**
- * Core virtualization engine
- * Handles:
- * - visible range calculation
- * - dynamic item sizing
- * - item measurements
- * - scroll positioning
- */
 export class VirtualizationEngine {
     constructor(estimatedItemSize = 35) {
         Object.defineProperty(this, "itemSizeMap", {
@@ -14,190 +6,115 @@ export class VirtualizationEngine {
             writable: true,
             value: {}
         });
-        Object.defineProperty(this, "itemOffsets", {
+        Object.defineProperty(this, "estimatedItemSize", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: [0]
+            value: void 0
         });
-        Object.defineProperty(this, "totalSize", {
+        Object.defineProperty(this, "itemCount", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 0
         });
-        Object.defineProperty(this, "estimatedItemSize", {
+        // 🔥 NEW: prefix sum cache (critical fix)
+        Object.defineProperty(this, "prefix", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: [0]
+        });
+        Object.defineProperty(this, "dirty", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
         });
         this.estimatedItemSize = estimatedItemSize;
     }
-    /**
-     * Record measured item size
-     */
+    setItemCount(count) {
+        this.itemCount = count;
+        this.dirty = true;
+    }
     recordItemSize(index, size) {
-        if (this.itemSizeMap[index] === size) {
+        if (this.itemSizeMap[index] === size)
             return;
-        }
         this.itemSizeMap[index] = size;
-        this.recalculateOffsets();
+        this.dirty = true;
     }
-    /**
-     * Recalculate item offsets
-     */
-    recalculateOffsets() {
-        let offset = 0;
-        this.itemOffsets = [0];
-        const indexes = Object.keys(this.itemSizeMap)
-            .map(Number)
-            .sort((a, b) => a - b);
-        for (const index of indexes) {
-            const size = this.itemSizeMap[index] ??
-                this.estimatedItemSize;
-            offset += size;
-            this.itemOffsets[index + 1] = offset;
+    rebuildPrefix() {
+        let sum = 0;
+        this.prefix = [0];
+        for (let i = 0; i < this.itemCount; i++) {
+            sum += this.itemSizeMap[i] ?? this.estimatedItemSize;
+            this.prefix[i + 1] = sum;
         }
-        this.totalSize = offset;
+        this.dirty = false;
     }
-    /**
-     * Get item size
-     */
     getItemSize(index) {
-        return (this.itemSizeMap[index] ??
-            this.estimatedItemSize);
+        return this.itemSizeMap[index] ?? this.estimatedItemSize;
     }
-    /**
-     * Get item offset
-     */
     getItemOffset(index) {
-        if (this.itemOffsets[index] !== undefined) {
-            return this.itemOffsets[index];
-        }
-        let offset = 0;
-        for (let i = 0; i < index; i++) {
-            offset += this.getItemSize(i);
-        }
-        return offset;
+        if (this.dirty)
+            this.rebuildPrefix();
+        return this.prefix[index] ?? 0;
     }
-    /**
-     * Get total size
-     */
     getTotalSize() {
-        return this.totalSize;
+        if (this.dirty)
+            this.rebuildPrefix();
+        return this.prefix[this.itemCount] || 0;
     }
-    /**
-     * Calculate visible range
-     */
-    getVisibleRange(scrollOffset, containerSize, itemCount, overscan = 5, scrollDirection = 'forward') {
-        /**
-         * Reverse scrolling support
-         */
-        if (scrollDirection === 'reverse') {
-            return this.getVisibleRangeReverse(scrollOffset, containerSize, itemCount, overscan);
-        }
-        let startIndex = 0;
-        let endIndex = itemCount - 1;
-        /**
-         * Find start index
-         */
-        for (let i = 0; i < itemCount; i++) {
-            const itemOffset = this.getItemOffset(i);
-            const itemSize = this.getItemSize(i);
-            if (itemOffset + itemSize >=
-                scrollOffset) {
-                startIndex = i;
-                break;
-            }
-        }
-        /**
-         * Find end index
-         */
-        for (let i = startIndex; i < itemCount; i++) {
-            const itemOffset = this.getItemOffset(i);
-            if (itemOffset >=
-                scrollOffset + containerSize) {
-                endIndex = i;
-                break;
-            }
+    binarySearch(offset) {
+        if (this.dirty)
+            this.rebuildPrefix();
+        let low = 0;
+        let high = this.itemCount - 1;
+        while (low <= high) {
+            const mid = (low + high) >> 1;
+            const value = this.prefix[mid];
+            if (value === offset)
+                return mid;
+            if (value < offset)
+                low = mid + 1;
+            else
+                high = mid - 1;
         }
+        return Math.max(0, low - 1);
+    }
+    getVisibleRange(scrollOffset, containerSize, itemCount, overscan = 5) {
+        this.setItemCount(itemCount);
+        const start = this.binarySearch(scrollOffset);
+        const end = this.binarySearch(scrollOffset + containerSize);
         return {
-            startIndex: Math.max(0, startIndex - overscan),
-            endIndex: Math.min(itemCount - 1, endIndex + overscan),
-            overscanStartIndex: startIndex,
-            overscanEndIndex: endIndex,
+            startIndex: Math.max(0, start - overscan),
+            endIndex: Math.min(itemCount - 1, end + overscan),
+            overscanStartIndex: start,
+            overscanEndIndex: end,
         };
     }
-    /**
-     * Reverse scrolling support
-     */
-    getVisibleRangeReverse(scrollOffset, containerSize, itemCount, overscan) {
-        const totalSize = this.getTotalSize();
-        const reversedScrollOffset = Math.max(0, totalSize -
-            scrollOffset -
-            containerSize);
-        return this.getVisibleRange(reversedScrollOffset, containerSize, itemCount, overscan, 'forward');
-    }
-    /**
-     * Get visible items
-     */
-    getVisibleItems(scrollOffset, containerSize, itemCount, overscan, scrollDirection = 'forward') {
-        const range = this.getVisibleRange(scrollOffset, containerSize, itemCount, overscan, scrollDirection);
-        const visibleItems = [];
-        for (let i = range.startIndex; i <= range.endIndex &&
-            i < itemCount; i++) {
-            visibleItems.push({
+    getVisibleItems(scrollOffset, containerSize, itemCount, overscan) {
+        const range = this.getVisibleRange(scrollOffset, containerSize, itemCount, overscan);
+        const items = [];
+        for (let i = range.startIndex; i <= range.endIndex; i++) {
+            items.push({
                 index: i,
                 size: this.getItemSize(i),
                 offset: this.getItemOffset(i),
             });
         }
-        return visibleItems;
+        return items;
     }
-    /**
-     * Scroll offset for item index
-     */
     getScrollOffsetForIndex(index, containerSize, alignment = 'start') {
-        const itemOffset = this.getItemOffset(index);
-        const itemSize = this.getItemSize(index);
-        switch (alignment) {
-            case 'center':
-                return Math.max(0, itemOffset -
-                    (containerSize -
-                        itemSize) /
-                        2);
-            case 'end':
-                return Math.max(0, itemOffset -
-                    containerSize +
-                    itemSize);
-            case 'start':
-            default:
-                return Math.max(0, itemOffset);
+        const offset = this.getItemOffset(index);
+        const size = this.getItemSize(index);
+        if (alignment === 'center') {
+            return Math.max(0, offset - (containerSize - size) / 2);
         }
-    }
-    /**
-     * Clear cache
-     */
-    clearCache() {
-        this.itemSizeMap = {};
-        this.itemOffsets = [0];
-        this.totalSize = 0;
-    }
-    /**
-     * Get cache
-     */
-    getCache() {
-        return {
-            ...this.itemSizeMap,
-        };
-    }
-    /**
-     * Adaptive overscan
-     */
-    getAdaptiveOverscan(scrollVelocity, baseOverscan = 5) {
-        const velocityFactor = Math.min(3, Math.max(1, scrollVelocity / 10));
-        return Math.ceil(baseOverscan * velocityFactor);
+        if (alignment === 'end') {
+            return Math.max(0, offset - containerSize + size);
+        }
+        return Math.max(0, offset);
     }
 }
 //# sourceMappingURL=VirtualizationEngine.js.map

package/dist/core/VirtualizationEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualizationEngine.js","sourceRoot":"","sources":["../../src/core/VirtualizationEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VirtualizationEngine.js","sourceRoot":"","sources":["../../src/core/VirtualizationEngine.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,oBAAoB;IAS7B,YAAY,iBAAiB,GAAG,EAAE;QAR1B;;;;mBAAgC,EAAE;WAAC;QACnC;;;;;WAA0B;QAC1B;;;;mBAAY,CAAC;WAAC;QAEtB,0CAA0C;QAClC;;;;mBAAmB,CAAC,CAAC,CAAC;WAAC;QACvB;;;;mBAAQ,IAAI;WAAC;QAGjB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,CAAC;IAED,YAAY,CAAC,KAAa;QACtB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,IAAY;QACtC,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,OAAO;QAE7C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAEO,aAAa;QACjB,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC;YACrD,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC;IAC7D,CAAC;IAED,aAAa,CAAC,KAAa;QACvB,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,YAAY;QACR,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAEO,YAAY,CAAC,MAAc;QAC/B,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAErC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAE9B,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAE/B,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,GAAG,CAAC;YACjC,IAAI,KAAK,GAAG,MAAM;gBAAE,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;;gBAC7B,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,eAAe,CACX,YAAoB,EACpB,aAAqB,EACrB,SAAiB,EACjB,QAAQ,GAAG,CAAC;QAEZ,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC;QAE5D,OAAO;YACH,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;YACzC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC;YACjD,kBAAkB,EAAE,KAAK;YACzB,gBAAgB,EAAE,GAAG;SACxB,CAAC;IACN,CAAC;IAED,eAAe,CACX,YAAoB,EACpB,aAAqB,EACrB,SAAiB,EACjB,QAAgB;QAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAC9B,YAAY,EACZ,aAAa,EACb,SAAS,EACT,QAAQ,CACX,CAAC;QAEF,MAAM,KAAK,GAAe,EAAE,CAAC;QAE7B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBACzB,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;aAChC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,uBAAuB,CAAC,KAAa,EAAE,aAAqB,EAAE,YAAwC,OAAO;QACzG,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAErC,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;CACJ"}

package/dist/hooks/useInfiniteScroll.d.ts

@@ -1,16 +1,34 @@
-interface UseInfiniteScrollParams {
-    onLoadMore: () => Promise<void>;
+export interface UseInfiniteScrollParams {
+    /**
+     * Callback triggered when user reaches threshold.
+     */
+    onLoadMore: () => void | Promise<void>;
+    /**
+     * Distance from bottom before triggering load.
+     * Default: 500px
+     */
     threshold?: number;
+    /**
+     * External loading state.
+     */
     isLoading?: boolean;
+    /**
+     * Enable/disable infinite scroll.
+     * Default: true
+     */
+    enabled?: boolean;
 }
-/**
- * Hook for infinite scroll pagination
- * Automatically loads more items when user scrolls near the bottom
- */
-export declare function useInfiniteScroll({ onLoadMore, threshold, isLoading, }: UseInfiniteScrollParams): {
-    containerRef: import("react").RefObject<HTMLDivElement>;
+export interface UseInfiniteScrollReturn<T extends HTMLElement = HTMLDivElement> {
+    containerRef: React.RefObject<T>;
     isAtBottom: boolean;
     isLoading: boolean;
-};
-export {};
+    checkIfAtBottom: () => void;
+}
+/**
+ * Infinite Scroll Hook
+ *
+ * Automatically triggers `onLoadMore`
+ * when user scrolls near the bottom.
+ */
+export declare function useInfiniteScroll<T extends HTMLElement = HTMLDivElement>({ onLoadMore, threshold, isLoading, enabled, }: UseInfiniteScrollParams): UseInfiniteScrollReturn<T>;
 //# sourceMappingURL=useInfiniteScroll.d.ts.map

package/dist/hooks/useInfiniteScroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInfiniteScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/useInfiniteScroll.ts"],"names":[],"mappings":"AAEA,UAAU,uBAAuB;IAC7B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAC9B,UAAU,EACV,SAAe,EACf,SAAiB,GACpB,EAAE,uBAAuB;;;;EAwCzB"}
+{"version":3,"file":"useInfiniteScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/useInfiniteScroll.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB,CACpC,CAAC,SAAS,WAAW,GAAG,cAAc;IAEtC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,CAAC,SAAS,WAAW,GAAG,cAAc,EACxC,EACE,UAAU,EACV,SAAe,EACf,SAAiB,EACjB,OAAc,GACjB,EAAE,uBAAuB,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAiFtD"}

package/dist/hooks/useInfiniteScroll.js

@@ -1,41 +1,58 @@
-import { useCallback, useRef, useEffect, useState } from 'react';
+import { useCallback, useRef, useEffect, useState, } from 'react';
 /**
- * Hook for infinite scroll pagination
- * Automatically loads more items when user scrolls near the bottom
+ * Infinite Scroll Hook
+ *
+ * Automatically triggers `onLoadMore`
+ * when user scrolls near the bottom.
  */
-export function useInfiniteScroll({ onLoadMore, threshold = 500, isLoading = false, }) {
+export function useInfiniteScroll({ onLoadMore, threshold = 500, isLoading = false, enabled = true, }) {
     const containerRef = useRef(null);
     const [isAtBottom, setIsAtBottom] = useState(false);
     const hasCalledRef = useRef(false);
+    const onLoadMoreRef = useRef(onLoadMore);
+    useEffect(() => {
+        onLoadMoreRef.current = onLoadMore;
+    }, [onLoadMore]);
     const checkIfAtBottom = useCallback(() => {
-        if (!containerRef.current || isLoading)
+        if (!enabled || isLoading)
+            return;
+        const container = containerRef.current;
+        if (!container)
             return;
-        const { scrollTop, scrollHeight, clientHeight } = containerRef.current;
+        const { scrollTop, scrollHeight, clientHeight, } = container;
         const distanceFromBottom = scrollHeight - scrollTop - clientHeight;
-        const atBottom = distanceFromBottom < threshold;
+        const atBottom = distanceFromBottom <= threshold;
         setIsAtBottom(atBottom);
-        // Trigger load when at bottom
-        if (atBottom && !hasCalledRef.current && !isLoading) {
+        if (atBottom &&
+            !hasCalledRef.current &&
+            !isLoading) {
             hasCalledRef.current = true;
-            onLoadMore().finally(() => {
+            Promise.resolve(onLoadMoreRef.current()).finally(() => {
                 hasCalledRef.current = false;
             });
         }
-    }, [onLoadMore, threshold, isLoading]);
+    }, [threshold, isLoading, enabled]);
     useEffect(() => {
+        if (!enabled)
+            return;
         const container = containerRef.current;
         if (!container)
             return;
         const handleScroll = () => {
             checkIfAtBottom();
         };
-        container.addEventListener('scroll', handleScroll);
-        return () => container.removeEventListener('scroll', handleScroll);
-    }, [checkIfAtBottom]);
+        container.addEventListener('scroll', handleScroll, { passive: true });
+        // Initial check
+        checkIfAtBottom();
+        return () => {
+            container.removeEventListener('scroll', handleScroll);
+        };
+    }, [checkIfAtBottom, enabled]);
     return {
         containerRef,
         isAtBottom,
         isLoading,
+        checkIfAtBottom,
     };
 }
 //# sourceMappingURL=useInfiniteScroll.js.map

package/dist/hooks/useInfiniteScroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInfiniteScroll.js","sourceRoot":"","sources":["../../src/hooks/useInfiniteScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQjE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAC9B,UAAU,EACV,SAAS,GAAG,GAAG,EACf,SAAS,GAAG,KAAK,GACK;IACtB,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,SAAS;YAAE,OAAO;QAE/C,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC;QACvE,MAAM,kBAAkB,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;QAEnE,MAAM,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAAC;QAChD,aAAa,CAAC,QAAQ,CAAC,CAAC;QAExB,8BAA8B;QAC9B,IAAI,QAAQ,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;YAClD,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAC5B,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;gBACtB,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;YACjC,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;QAEF,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACnD,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,OAAO;QACH,YAAY;QACZ,UAAU;QACV,SAAS;KACZ,CAAC;AACN,CAAC"}
+{"version":3,"file":"useInfiniteScroll.js","sourceRoot":"","sources":["../../src/hooks/useInfiniteScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,MAAM,EACN,SAAS,EACT,QAAQ,GACX,MAAM,OAAO,CAAC;AAmCf;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAE/B,EACE,UAAU,EACV,SAAS,GAAG,GAAG,EACf,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,IAAI,GACQ;IACtB,MAAM,YAAY,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IAE5C,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACX,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IACvC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC,OAAO,IAAI,SAAS;YAAE,OAAO;QAElC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QAEvC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,EACF,SAAS,EACT,YAAY,EACZ,YAAY,GACf,GAAG,SAAS,CAAC;QAEd,MAAM,kBAAkB,GACpB,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;QAE5C,MAAM,QAAQ,GAAG,kBAAkB,IAAI,SAAS,CAAC;QAEjD,aAAa,CAAC,QAAQ,CAAC,CAAC;QAExB,IACI,QAAQ;YACR,CAAC,YAAY,CAAC,OAAO;YACrB,CAAC,SAAS,EACZ,CAAC;YACC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAE5B,OAAO,CAAC,OAAO,CACX,aAAa,CAAC,OAAO,EAAE,CAC1B,CAAC,OAAO,CAAC,GAAG,EAAE;gBACX,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;YACjC,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpC,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QAEvC,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,YAAY,GAAG,GAAG,EAAE;YACtB,eAAe,EAAE,CAAC;QACtB,CAAC,CAAC;QAEF,SAAS,CAAC,gBAAgB,CACtB,QAAQ,EACR,YAAY,EACZ,EAAE,OAAO,EAAE,IAAI,EAAE,CACpB,CAAC;QAEF,gBAAgB;QAChB,eAAe,EAAE,CAAC;QAElB,OAAO,GAAG,EAAE;YACR,SAAS,CAAC,mBAAmB,CACzB,QAAQ,EACR,YAAY,CACf,CAAC;QACN,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/B,OAAO;QACH,YAAY;QACZ,UAAU;QACV,SAAS;QACT,eAAe;KAClB,CAAC;AACN,CAAC"}

package/dist/hooks/useLazyLoad.d.ts

@@ -1,15 +1,36 @@
-interface UseLazyLoadParams {
-    threshold?: number;
+import { RefObject } from 'react';
+export interface UseLazyLoadParams {
+    /**
+     * Percentage of element that must be visible.
+     * Default: 0.1
+     */
+    threshold?: number | number[];
+    /**
+     * Callback fired when element becomes visible.
+     */
     onVisible?: () => void;
+    /**
+     * Root element for intersection.
+     */
+    root?: Element | null;
+    /**
+     * Root margin.
+     */
+    rootMargin?: string;
+    /**
+     * Enable/disable observer.
+     */
+    enabled?: boolean;
+    /**
+     * Stop observing after first visibility.
+     * Default: true
+     */
+    once?: boolean;
 }
-/**
- * Hook for lazy loading items as they become visible
- * Integrates with IntersectionObserver for efficiency
- */
-export declare function useLazyLoad({ threshold, onVisible }: UseLazyLoadParams): {
-    ref: import("react").RefObject<HTMLDivElement>;
+export interface UseLazyLoadReturn<T extends HTMLElement = HTMLDivElement> {
+    ref: RefObject<T | null>;
     isVisible: boolean;
-    setupObserver: () => (() => void) | undefined;
-};
-export {};
+    entry: IntersectionObserverEntry | null;
+}
+export declare function useLazyLoad<T extends HTMLElement = HTMLDivElement>({ threshold, onVisible, root, rootMargin, enabled, once, }?: UseLazyLoadParams): UseLazyLoadReturn<T>;
 //# sourceMappingURL=useLazyLoad.d.ts.map

package/dist/hooks/useLazyLoad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLazyLoad.d.ts","sourceRoot":"","sources":["../../src/hooks/useLazyLoad.ts"],"names":[],"mappings":"AAEA,UAAU,iBAAiB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAe,EAAE,SAAS,EAAE,EAAE,iBAAiB;;;;EAmC5E"}
+{"version":3,"file":"useLazyLoad.d.ts","sourceRoot":"","sources":["../../src/hooks/useLazyLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,SAAS,EACZ,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAC9B,CAAC,SAAS,WAAW,GAAG,cAAc;IAEtC,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,WAAW,CACvB,CAAC,SAAS,WAAW,GAAG,cAAc,EACxC,EACE,SAAe,EACf,SAAS,EACT,IAAW,EACX,UAAkB,EAClB,OAAc,EACd,IAAW,GACd,GAAE,iBAAsB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAsE/C"}

package/dist/hooks/useLazyLoad.js

@@ -1,34 +1,57 @@
-import { useState, useCallback, useRef } from 'react';
-/**
- * Hook for lazy loading items as they become visible
- * Integrates with IntersectionObserver for efficiency
- */
-export function useLazyLoad({ threshold = 0.1, onVisible }) {
+import { useState, useEffect, useRef, } from 'react';
+export function useLazyLoad({ threshold = 0.1, onVisible, root = null, rootMargin = '0px', enabled = true, once = true, } = {}) {
     const [isVisible, setIsVisible] = useState(false);
+    const [entry, setEntry] = useState(null);
     const elementRef = useRef(null);
-    const setupObserver = useCallback(() => {
-        if (!elementRef.current || !('IntersectionObserver' in window)) {
-            // Fallback: consider visible if IntersectionObserver not supported
+    const callbackRef = useRef(onVisible);
+    useEffect(() => {
+        callbackRef.current = onVisible;
+    }, [onVisible]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const element = elementRef.current;
+        if (!element)
+            return;
+        // SSR / Legacy browser fallback
+        if (typeof window === 'undefined' ||
+            !('IntersectionObserver' in window)) {
             setIsVisible(true);
-            onVisible?.();
+            callbackRef.current?.();
             return;
         }
-        const observer = new IntersectionObserver(([entry]) => {
-            if (entry.isIntersecting) {
+        const observer = new IntersectionObserver(([observerEntry]) => {
+            setEntry(observerEntry);
+            if (observerEntry.isIntersecting) {
                 setIsVisible(true);
-                onVisible?.();
-                observer.unobserve(entry.target);
+                callbackRef.current?.();
+                if (once) {
+                    observer.unobserve(observerEntry.target);
+                }
+            }
+            else if (!once) {
+                setIsVisible(false);
             }
-        }, { threshold });
-        observer.observe(elementRef.current);
-        return () => observer.disconnect();
-    }, [threshold, onVisible]);
-    // Setup observer when component mounts
-    // (This would be in useEffect in actual usage)
+        }, {
+            threshold,
+            root,
+            rootMargin,
+        });
+        observer.observe(element);
+        return () => {
+            observer.disconnect();
+        };
+    }, [
+        threshold,
+        root,
+        rootMargin,
+        enabled,
+        once,
+    ]);
     return {
         ref: elementRef,
         isVisible,
-        setupObserver,
+        entry,
     };
 }
 //# sourceMappingURL=useLazyLoad.js.map

package/dist/hooks/useLazyLoad.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLazyLoad.js","sourceRoot":"","sources":["../../src/hooks/useLazyLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAOtD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE,SAAS,EAAqB;IACzE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEhD,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,EAAE,CAAC;YAC7D,mEAAmE;YACnE,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS,EAAE,EAAE,CAAC;YACd,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACrC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;YACR,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,SAAS,EAAE,EAAE,CAAC;gBACd,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC;QACL,CAAC,EACD,EAAE,SAAS,EAAE,CAChB,CAAC;QAEF,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAE3B,uCAAuC;IACvC,+CAA+C;IAC/C,OAAO;QACH,GAAG,EAAE,UAAU;QACf,SAAS;QACT,aAAa;KAChB,CAAC;AACN,CAAC"}
+{"version":3,"file":"useLazyLoad.js","sourceRoot":"","sources":["../../src/hooks/useLazyLoad.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,QAAQ,EACR,SAAS,EACT,MAAM,GAET,MAAM,OAAO,CAAC;AA4Cf,MAAM,UAAU,WAAW,CAEzB,EACE,SAAS,GAAG,GAAG,EACf,SAAS,EACT,IAAI,GAAG,IAAI,EACX,UAAU,GAAG,KAAK,EAClB,OAAO,GAAG,IAAI,EACd,IAAI,GAAG,IAAI,MACQ,EAAE;IACrB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GACnB,QAAQ,CAAmC,IAAI,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;IAEnC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACX,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC;IACpC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAEnC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,gCAAgC;QAChC,IACI,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,EACrC,CAAC;YACC,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACrC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE;YAChB,QAAQ,CAAC,aAAa,CAAC,CAAC;YAExB,IAAI,aAAa,CAAC,cAAc,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnB,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;gBAExB,IAAI,IAAI,EAAE,CAAC;oBACP,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBAC7C,CAAC;YACL,CAAC;iBAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACL,CAAC,EACD;YACI,SAAS;YACT,IAAI;YACJ,UAAU;SACb,CACJ,CAAC;QAEF,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1B,OAAO,GAAG,EAAE;YACR,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC,CAAC;IACN,CAAC,EAAE;QACC,SAAS;QACT,IAAI;QACJ,UAAU;QACV,OAAO;QACP,IAAI;KACP,CAAC,CAAC;IAEH,OAAO;QACH,GAAG,EAAE,UAAU;QACf,SAAS;QACT,KAAK;KACR,CAAC;AACN,CAAC"}

package/dist/hooks/useScrollRestoration.d.ts

@@ -1,8 +1,49 @@
-/**
- * Hook for restoring scroll position on navigation
- * Useful when navigating away and coming back to a list
- */
-export declare function useScrollRestoration(key: string, containerRef: React.RefObject<HTMLDivElement>): {
+export interface ScrollPosition {
+    key: string;
+    top: number;
+    left: number;
+    timestamp: number;
+}
+export interface UseScrollRestorationOptions {
+    /**
+     * Persist positions in storage.
+     * Default: true
+     */
+    persist?: boolean;
+    /**
+     * Storage key.
+     */
+    storageKey?: string;
+    /**
+     * Storage provider.
+     * Default: localStorage
+     */
+    storage?: Storage;
+    /**
+     * Automatically save during scrolling.
+     * Default: false (preserves existing behavior)
+     */
+    autoSave?: boolean;
+    /**
+     * Maximum entries retained.
+     * Default: 100
+     */
+    maxEntries?: number;
+    /**
+     * Delay restoration until next animation frame.
+     * Default: true
+     */
+    useRAF?: boolean;
+    /**
+     * Disable hook.
+     */
+    enabled?: boolean;
+    /**
+     * Error handler.
+     */
+    onError?: (error: unknown) => void;
+}
+export declare function useScrollRestoration<T extends HTMLElement = HTMLDivElement>(key: string, containerRef: React.RefObject<T | null>, { persist, storageKey, storage, autoSave, maxEntries, useRAF, enabled, onError, }?: UseScrollRestorationOptions): {
     savePosition: () => void;
     restorePosition: () => void;
 };

package/dist/hooks/useScrollRestoration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollRestoration.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollRestoration.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC;;;EA6D9F"}
+{"version":3,"file":"useScrollRestoration.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollRestoration.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAoBD,wBAAgB,oBAAoB,CAChC,CAAC,SAAS,WAAW,GAAG,cAAc,EAEtC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACvC,EACI,OAAc,EACd,UAAgC,EAChC,OAAO,EACP,QAAgB,EAChB,UAAgB,EAChB,MAAa,EACb,OAAc,EACd,OAAO,GACV,GAAE,2BAAgC;;;EA4MtC"}