react-simple-virtualize 1.0.0 → 2.0.0

package/README.md

@@ -51,6 +51,7 @@ const MyLargeList = () => {
     // Outer Container: Needs fixed height & overflow-y: auto
     <div
       onScroll={onScroll}
+      ref={scrollRef}
       style={{
         height: containerHeight,
         overflowY: 'auto',
@@ -65,6 +66,7 @@ const MyLargeList = () => {
         {virtualItems.map(({ index, offsetTop }) => (
           <div
             key={index}
+            ref={virtualItem.measureRef}
             style={{
               position: 'absolute',
               top: 0,
@@ -91,31 +93,64 @@ export default MyLargeList;
 
 ## ⚙️ API Reference
 
-### `useVirtualize(options)`
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `itemCount` | `number` | **Required** | Total number of items in the list. |
+| `itemHeight` | `number` | **Required** | Estimated height of an item. Used for initial rendering and unmeasured items. |
+| `overscan` | `number` | `3` | Number of extra items to render outside the visible viewport. |
+| `containerHeight` | `number` | `undefined` | Optional fixed height. If omitted, the hook uses `ResizeObserver` on `scrollRef` to measure it automatically. |
 
-| Option | Type | Required | Description |
-| :--- | :--- | :--- | :--- |
-| `itemCount` | `number` | Yes | Total number of items in the list. |
-| `itemHeight` | `number` | Yes | Height of a single item in pixels. |
-| `containerHeight` | `number` | Yes | Height of the visible scroll area (viewport). |
-| `overscan` | `number` | No | Number of extra items to render above/below the visible area (Default: 3). |
-
-### Returns
+### Return Values
 
 | Value | Type | Description |
-| :--- | :--- | :--- |
-| `virtualItems` | `array` | Array of items to be rendered. Each item contains `{ index, offsetTop }`. |
-| `totalHeight` | `number` | Total height of the list (used for the inner container). |
-| `onScroll` | `function` | Event handler to be attached to the outer container's `onScroll`. |
+|---|---|---|
+| `virtualItems` | `VirtualItem[]` | Array of items to be rendered in the current viewport. |
+| `totalHeight` | `number` | Total calculated height of the list (apply this to the inner container). |
+| `scrollRef` | `RefObject` | Ref to be attached to the scrollable container element (for auto-sizing). |
+| `onScroll` | `function` | Scroll handler to be attached to the scrollable container. |
+
+#### `VirtualItem` Interface
+```ts
+interface VirtualItem {
+  index: number;
+  offsetTop: number;
+  measureRef: (el: HTMLElement | null) => void; // Must be attached to the rendered element
+}
+```
+
+## Migration from v1 to v2
+
+v2 introduces support for **Dynamic Heights**. This is a breaking change.
+
+**Changes:**
+- You must now attach the `measureRef` to your rendered element.
+- `itemHeight` prop is now used as an **estimate** for unrendered items.
+
+```jsx
+// v1 (Old)
+<div style={{ transform: `translateY(${virtualItem.offsetTop}px)` }}>...</div>
+
+// v2 (New)
+<div 
+  ref={virtualItem.measureRef} // <--- Required!
+  style={{ transform: `translateY(${virtualItem.offsetTop}px)` }}
+>
+  ...
+</div>
+```
 
 ## 🗺️ Roadmap & Support
 
-Currently, this package is optimized for **Fixed Height** lists.
-I am actively working on the following features for the next major release:
+Here's what's planned for the future of `react-simple-virtualize`.
+
+- [x] **Fixed Height Lists:** Initial release with core virtualization logic. (v1.0)
+- [x] **Dynamic Height Lists:** Support for items with variable heights using a measurement ref. (v2.0) 🚀
+- [ ] **Horizontal Virtualization:** Support for row-based scrolling.
+- [ ] **Grid Virtualization:** Virtualize both rows and columns (spreadsheet style).
+- [ ] **Window Scrolling:** Support for using the browser's native scrollbar instead of a container.
+- [ ] **Infinite Loader:** Built-in support for loading more data as you scroll (Pagination).
 
-- [ ] **Dynamic Height Support:** For items with variable content (chat bubbles, feeds).
-- [ ] **Grid Virtualization:** Virtualizing both rows and columns.
-- [ ] **Horizontal Scrolling:** Support for X-axis virtualization.
+> **Note:** If you have a specific feature request, feel free to open an issue!
 
 ### ☕ Support the Development
 

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { UIEvent } from "react";
+export interface UseVirtualizeProps {
+    /** Total number of items in the list */
+    itemCount: number;
+    /** Estimated height of a single item (used for unmeasured items) */
+    itemHeight: number;
+    /** Number of extra items to render outside the visible view (default: 3) */
+    overscan?: number;
+    /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */
+    containerHeight?: number;
+}
+export interface VirtualItem {
+    /** The index of the item in the original data array */
+    index: number;
+    /** The calculated top position (px) for absolute positioning */
+    offsetTop: number;
+    /** Callback ref to measure the actual DOM height of the item */
+    measureRef: (el: HTMLElement | null) => void;
+}
+export declare function useVirtualize({ itemCount, itemHeight: estimatedItemHeight, overscan, containerHeight: propsContainerHeight, }: UseVirtualizeProps): {
+    virtualItems: VirtualItem[];
+    totalHeight: number;
+    scrollRef: import("react").RefObject<HTMLDivElement | null>;
+    measurementVersion: number;
+    onScroll: (e: UIEvent<HTMLElement>) => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,OAAO,EACR,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,UAAU,EAAE,mBAAmB,EAC/B,QAAY,EACZ,eAAe,EAAE,oBAAoB,GACtC,EAAE,kBAAkB;;;;;kBAyLH,QAAQ,WAAW,CAAC;EAGrC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-var t=require("react");exports.useVirtualize=function(e){var r=e.itemCount,o=e.itemHeight,a=e.containerHeight,i=e.overscan,n=void 0===i?3:i,u=t.useState(0),l=u[0],h=u[1],s=t.useMemo(function(){for(var t=Math.floor(l/o),e=Math.min(r-1,Math.floor((l+a)/o)),i=Math.max(0,t-n),u=Math.min(r-1,e+n),h=[],s=i;s<=u;s++)h.push({index:s,offsetTop:s*o});return{virtualItems:h,totalHeight:r*o}},[l,r,o,a,n]);return{virtualItems:s.virtualItems,totalHeight:s.totalHeight,onScroll:function(t){h(t.currentTarget.scrollTop)}}};
+var e=require("react");exports.useVirtualize=function(r){var t=r.itemCount,n=r.itemHeight,u=r.overscan,c=void 0===u?3:u,i=r.containerHeight,a=e.useState(0),o=a[0],f=a[1],s=e.useState(0),l=s[0],v=s[1],h=null!=i?i:l,R=e.useRef({}),m=e.useRef({}),g=e.useRef(-1),b=e.useRef(null),d=e.useRef(0),C=e.useRef(0),M=e.useState(0),k=M[0],p=M[1],x=e.useCallback(function(){return C.current>0?d.current/C.current:n},[n]);e.useLayoutEffect(function(){if(void 0===i){var e=b.current;if(e){var r=new ResizeObserver(function(e){var r=e[0];r.contentRect.height!==l&&v(r.contentRect.height)});return r.observe(e),function(){return r.disconnect()}}}},[i,l]);var S=e.useCallback(function(e){if(e<=g.current)return m.current[e]||0;var r=g.current;return(r>=0?m.current[r]:0)+(r>=0?R.current[r]:0)+(e-r-1)*x()},[n,x]),H=e.useCallback(function(e){for(var r=0,n=t-1;r<=n;){var u=Math.floor((r+n)/2),c=S(u),i=R.current[u]||x();if(c<=e&&c+i>e)return u;c<e?r=u+1:n=u-1}return Math.max(0,r-1)},[S,t,n]),T=e.useCallback(function(e){return function(r){if(r){var t=r.getBoundingClientRect().height,n=R.current[e];if(n!==t){if(void 0===n?(d.current+=t,C.current+=1):d.current+=t-n,R.current[e]=t,e>g.current){var u=S(e);m.current[e]=u,g.current=e}else g.current=Math.min(g.current,e-1);p(function(e){return e+1})}}}},[S]),z=H(o),V=Math.min(t-1,H(o+h)+c);return{virtualItems:e.useMemo(function(){for(var e=[],r=Math.max(0,z-c);r<=V;r++)e.push({index:r,offsetTop:S(r),measureRef:T(r)});return e},[z,V,S,T,c]),totalHeight:S(t),scrollRef:b,measurementVersion:k,onScroll:function(e){return f(e.currentTarget.scrollTop)}}};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.js"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nexport const useVirtualize = ({\n  itemCount,\n  itemHeight,\n  containerHeight,\n  overscan = 3\n}) => {\n  // Store the current scroll position\n  const [scrollTop, setScrollTop] = useState(0);\n\n  // Update scroll position on scroll event\n  const onScroll = (e) => {\n    setScrollTop(e.currentTarget.scrollTop);\n  };\n\n  // Memoize calculations to prevent unnecessary re-renders\n  const { virtualItems, totalHeight } = useMemo(() => {\n    // 1. Calculate the visible range based on scroll position\n    const rangeStart = Math.floor(scrollTop / itemHeight);\n    const rangeEnd = Math.min(\n      itemCount - 1,\n      Math.floor((scrollTop + containerHeight) / itemHeight)\n    );\n\n    // 2. Add overscan (buffer) to the range for smoother scrolling\n    const startIndex = Math.max(0, rangeStart - overscan);\n    const endIndex = Math.min(itemCount - 1, rangeEnd + overscan);\n\n    // 3. Generate the array of items to be rendered\n    const virtualItems = [];\n    for (let i = startIndex; i <= endIndex; i++) {\n      virtualItems.push({\n        index: i,\n        offsetTop: i * itemHeight, // Calculate absolute position for each item\n      });\n    }\n\n    // 4. Calculate total phantom height to maintain scrollbar size\n    const totalHeight = itemCount * itemHeight;\n\n    return { virtualItems, totalHeight };\n  }, [scrollTop, itemCount, itemHeight, containerHeight, overscan]);\n\n  return {\n    virtualItems,\n    totalHeight,\n    onScroll,\n  };\n};"],"names":["_ref","itemCount","itemHeight","containerHeight","_ref$overscan","overscan","_useState","useState","scrollTop","setScrollTop","_useMemo","useMemo","rangeStart","Math","floor","rangeEnd","min","startIndex","max","endIndex","virtualItems","i","push","index","offsetTop","totalHeight","onScroll","e","currentTarget"],"mappings":"6CAE6B,SAAHA,GAKpB,IAJJC,EAASD,EAATC,UACAC,EAAUF,EAAVE,WACAC,EAAeH,EAAfG,gBAAeC,EAAAJ,EACfK,SAAAA,OAAQ,IAAAD,EAAG,EAACA,EAGZE,EAAkCC,EAAQA,SAAC,GAApCC,EAASF,EAAEG,GAAAA,EAAYH,EAG9B,GAKAI,EAAsCC,EAAAA,QAAQ,WAc5C,IAZA,IAAMC,EAAaC,KAAKC,MAAMN,EAAYN,GACpCa,EAAWF,KAAKG,IACpBf,EAAY,EACZY,KAAKC,OAAON,EAAYL,GAAmBD,IAIvCe,EAAaJ,KAAKK,IAAI,EAAGN,EAAaP,GACtCc,EAAWN,KAAKG,IAAIf,EAAY,EAAGc,EAAWV,GAG9Ce,EAAe,GACZC,EAAIJ,EAAYI,GAAKF,EAAUE,IACtCD,EAAaE,KAAK,CAChBC,MAAOF,EACPG,UAAWH,EAAInB,IAOnB,MAAO,CAAEkB,aAAAA,EAAcK,YAFHxB,EAAYC,EAGlC,EAAG,CAACM,EAAWP,EAAWC,EAAYC,EAAiBE,IAEvD,MAAO,CACLe,aA5BkBV,EAAZU,aA6BNK,YA7B+Bf,EAAXe,YA8BpBC,SAnCe,SAACC,GAChBlB,EAAakB,EAAEC,cAAcpB,UAC/B,EAmCF"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import {\n  useState,\n  useRef,\n  useMemo,\n  useCallback,\n  useLayoutEffect,\n  UIEvent,\n} from \"react\";\n\nexport interface UseVirtualizeProps {\n  /** Total number of items in the list */\n  itemCount: number;\n  /** Estimated height of a single item (used for unmeasured items) */\n  itemHeight: number;\n  /** Number of extra items to render outside the visible view (default: 3) */\n  overscan?: number;\n  /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */\n  containerHeight?: number;\n}\n\nexport interface VirtualItem {\n  /** The index of the item in the original data array */\n  index: number;\n  /** The calculated top position (px) for absolute positioning */\n  offsetTop: number;\n  /** Callback ref to measure the actual DOM height of the item */\n  measureRef: (el: HTMLElement | null) => void;\n}\n\nexport function useVirtualize({\n  itemCount,\n  itemHeight: estimatedItemHeight,\n  overscan = 3,\n  containerHeight: propsContainerHeight,\n}: UseVirtualizeProps) {\n  const [scrollTop, setScrollTop] = useState(0);\n  const [observedHeight, setObservedHeight] = useState(0);\n\n  // Determine the effective container height:\n  // Use the prop if provided; otherwise, fall back to the measured height.\n  const height = propsContainerHeight ?? observedHeight;\n\n  // --- REFS (State that doesn't trigger re-renders) ---\n\n  // Stores the exact height of each measured item: { index: height }\n  const measurementCache = useRef({} as Record<number, number>);\n\n  // Stores the calculated total offset for each index: { index: offset }\n  // This acts as a Prefix Sum array to avoid recalculating from 0 every time.\n  const offsetCache = useRef({} as Record<number, number>);\n\n  // Tracks the last index that has a valid calculated offset in the cache.\n  const lastMeasuredIndex = useRef(-1);\n\n  // Reference to the scrollable container (used for ResizeObserver)\n  const scrollRef = useRef<HTMLDivElement>(null);\n\n  // Total measured height (Pixel)\n  const totalMeasuredSize = useRef(0);\n  // Total measured element?\n  const totalMeasuredCount = useRef(0);\n\n  const [measurementVersion, setMeasurementVersion] = useState(0);\n\n  // --- HELPER: GET ESTIMATED HEIGHT ---\n  // Zeka burada: Eğer hiç ölçüm yoksa senin verdiğin 'itemHeight'ı kullan.\n  // Ama ölçüm yaptıysak, gerçek ortalamayı kullan.\n  const getEstimatedItemHeight = useCallback(() => {\n    return totalMeasuredCount.current > 0\n      ? totalMeasuredSize.current / totalMeasuredCount.current\n      : estimatedItemHeight;\n  }, [estimatedItemHeight]);\n\n  // --- 1. AUTO-SIZER LOGIC ---\n  useLayoutEffect(() => {\n    // If the user provided a fixed height, skip observation to save resources.\n    if (propsContainerHeight !== undefined) return;\n\n    const scrollElement = scrollRef.current;\n    if (!scrollElement) return;\n\n    const observer = new ResizeObserver(([entry]) => {\n      // Update state only if dimensions actually changed\n      if (entry.contentRect.height !== observedHeight) {\n        setObservedHeight(entry.contentRect.height);\n      }\n    });\n\n    observer.observe(scrollElement);\n\n    return () => observer.disconnect();\n  }, [propsContainerHeight, observedHeight]);\n\n  // --- 2. OFFSET CALCULATOR (Core Logic) ---\n  // Returns the vertical position (px) of an item.\n  const getItemOffset = useCallback(\n    (index: number) => {\n      // If the offset for this index is already cached, return it directly.\n      if (index <= lastMeasuredIndex.current) {\n        return offsetCache.current[index] || 0;\n      }\n\n      // 1. Retrieve reference data from the last measured item.\n      const lastIndex = lastMeasuredIndex.current;\n\n      // If no items have been measured yet (-1), the starting offset is 0.\n      // Otherwise, retrieve the offset of the last measured item.\n      const lastOffset = lastIndex >= 0 ? offsetCache.current[lastIndex] : 0;\n\n      // Retrieve the height of the last measured item (default to 0 if none measured).\n      const lastHeight =\n        lastIndex >= 0 ? measurementCache.current[lastIndex] : 0;\n\n      // 2. Calculate the bottom position of the last measured item.\n      // This serves as the anchor point for estimating subsequent offsets.\n      const lastBottom = lastOffset + lastHeight;\n\n      // 3. Calculate how many unmeasured items exist between the last measured index and the target index.\n      const unmeasuredCount = index - lastIndex - 1;\n\n      // 4. Result: Anchor Point + (Number of Unmeasured Items * Estimated Height)\n      return lastBottom + unmeasuredCount * getEstimatedItemHeight();\n    },\n    [estimatedItemHeight, getEstimatedItemHeight]\n  );\n\n  // --- 3. BINARY SEARCH (Find Visible Index) ---\n  // Finds the index corresponding to the current scroll position.\n  // Performance: O(log N) - Crucial for large lists.\n  const getStartIndexForOffset = useCallback(\n    (offset: number) => {\n      let low = 0;\n      let high = itemCount - 1;\n\n      while (low <= high) {\n        const mid = Math.floor((low + high) / 2);\n        const currentOffset = getItemOffset(mid);\n        const currentHeight =\n          measurementCache.current[mid] || getEstimatedItemHeight();\n\n        if (currentOffset <= offset && currentOffset + currentHeight > offset) {\n          return mid;\n        } else if (currentOffset < offset) {\n          low = mid + 1;\n        } else {\n          high = mid - 1;\n        }\n      }\n\n      // Fallback to 0 if not found\n      return Math.max(0, low - 1);\n    },\n    [getItemOffset, itemCount, estimatedItemHeight]\n  );\n\n  // --- 4. MEASUREMENT CALLBACK (The \"Ref\" logic) ---\n  // This function is passed to the consumer to attach to their DOM elements.\n  const measureElement = useCallback(\n    (index: number) => (el: HTMLElement | null) => {\n      if (!el) return;\n\n      const measuredHeight = el.getBoundingClientRect().height;\n      const prevHeight = measurementCache.current[index];\n\n      if (prevHeight !== measuredHeight) {\n        if (prevHeight === undefined) {\n          totalMeasuredSize.current += measuredHeight;\n          totalMeasuredCount.current += 1;\n        } else {\n          totalMeasuredSize.current += measuredHeight - prevHeight;\n        }\n\n        measurementCache.current[index] = measuredHeight;\n\n        if (index > lastMeasuredIndex.current) {\n          const prevOffset = getItemOffset(index);\n          offsetCache.current[index] = prevOffset;\n          lastMeasuredIndex.current = index;\n        } else {\n          lastMeasuredIndex.current = Math.min(\n            lastMeasuredIndex.current,\n            index - 1\n          );\n        }\n\n        setMeasurementVersion(v => v + 1);\n      }\n    },\n    [getItemOffset]\n  );\n\n  // --- 5. RENDER RANGE CALCULATION ---\n  const startIndex = getStartIndexForOffset(scrollTop);\n  const endIndex = Math.min(\n    itemCount - 1,\n    getStartIndexForOffset(scrollTop + height) + overscan\n  );\n\n  // Generate the virtual items array to be rendered\n  const virtualItems = useMemo(() => {\n    const items: VirtualItem[] = [];\n    for (let i = Math.max(0, startIndex - overscan); i <= endIndex; i++) {\n      items.push({\n        index: i,\n        offsetTop: getItemOffset(i),\n        measureRef: measureElement(i),\n      });\n    }\n    return items;\n  }, [startIndex, endIndex, getItemOffset, measureElement, overscan]);\n\n  // Calculate total list height for the scrollbar\n  const totalHeight = getItemOffset(itemCount);\n\n  return {\n    virtualItems,\n    totalHeight,\n    scrollRef,\n    measurementVersion,\n    onScroll: (e: UIEvent<HTMLElement>) =>\n      setScrollTop(e.currentTarget.scrollTop),\n  };\n}\n"],"names":["_ref","itemCount","estimatedItemHeight","itemHeight","_ref$overscan","overscan","propsContainerHeight","containerHeight","_useState","useState","scrollTop","setScrollTop","_useState2","observedHeight","setObservedHeight","height","measurementCache","useRef","offsetCache","lastMeasuredIndex","scrollRef","totalMeasuredSize","totalMeasuredCount","_useState3","measurementVersion","setMeasurementVersion","getEstimatedItemHeight","useCallback","current","useLayoutEffect","undefined","scrollElement","observer","ResizeObserver","_ref2","entry","contentRect","observe","disconnect","getItemOffset","index","lastIndex","getStartIndexForOffset","offset","low","high","mid","Math","floor","currentOffset","currentHeight","max","measureElement","el","measuredHeight","getBoundingClientRect","prevHeight","prevOffset","min","v","startIndex","endIndex","virtualItems","useMemo","items","i","push","offsetTop","measureRef","totalHeight","onScroll","e","currentTarget"],"mappings":"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"}

package/dist/index.modern.mjs

@@ -1,2 +1,2 @@
-import{useState as t,useMemo as o}from"react";const e=({itemCount:e,itemHeight:r,containerHeight:a,overscan:i=3})=>{const[n,l]=t(0),{virtualItems:h,totalHeight:m}=o(()=>{const t=Math.floor(n/r),o=Math.min(e-1,Math.floor((n+a)/r)),l=Math.max(0,t-i),h=Math.min(e-1,o+i),m=[];for(let t=l;t<=h;t++)m.push({index:t,offsetTop:t*r});return{virtualItems:m,totalHeight:e*r}},[n,e,r,a,i]);return{virtualItems:h,totalHeight:m,onScroll:t=>{l(t.currentTarget.scrollTop)}}};export{e as useVirtualize};
+import{useState as r,useRef as t,useCallback as e,useLayoutEffect as n,useMemo as c}from"react";function u({itemCount:u,itemHeight:o,overscan:i=3,containerHeight:s}){const[l,f]=r(0),[a,h]=r(0),m=null!=s?s:a,g=t({}),v=t({}),R=t(-1),d=t(null),p=t(0),M=t(0),[x,H]=r(0),T=e(()=>M.current>0?p.current/M.current:o,[o]);n(()=>{if(void 0!==s)return;const r=d.current;if(!r)return;const t=new ResizeObserver(([r])=>{r.contentRect.height!==a&&h(r.contentRect.height)});return t.observe(r),()=>t.disconnect()},[s,a]);const b=e(r=>{if(r<=R.current)return v.current[r]||0;const t=R.current;return(t>=0?v.current[t]:0)+(t>=0?g.current[t]:0)+(r-t-1)*T()},[o,T]),C=e(r=>{let t=0,e=u-1;for(;t<=e;){const n=Math.floor((t+e)/2),c=b(n),u=g.current[n]||T();if(c<=r&&c+u>r)return n;c<r?t=n+1:e=n-1}return Math.max(0,t-1)},[b,u,o]),w=e(r=>t=>{if(!t)return;const e=t.getBoundingClientRect().height,n=g.current[r];if(n!==e){if(void 0===n?(p.current+=e,M.current+=1):p.current+=e-n,g.current[r]=e,r>R.current){const t=b(r);v.current[r]=t,R.current=r}else R.current=Math.min(R.current,r-1);H(r=>r+1)}},[b]),z=C(l),B=Math.min(u-1,C(l+m)+i);return{virtualItems:c(()=>{const r=[];for(let t=Math.max(0,z-i);t<=B;t++)r.push({index:t,offsetTop:b(t),measureRef:w(t)});return r},[z,B,b,w,i]),totalHeight:b(u),scrollRef:d,measurementVersion:x,onScroll:r=>f(r.currentTarget.scrollTop)}}export{u as useVirtualize};
 //# sourceMappingURL=index.modern.mjs.map

package/dist/index.modern.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.modern.mjs","sources":["../src/index.js"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nexport const useVirtualize = ({\n  itemCount,\n  itemHeight,\n  containerHeight,\n  overscan = 3\n}) => {\n  // Store the current scroll position\n  const [scrollTop, setScrollTop] = useState(0);\n\n  // Update scroll position on scroll event\n  const onScroll = (e) => {\n    setScrollTop(e.currentTarget.scrollTop);\n  };\n\n  // Memoize calculations to prevent unnecessary re-renders\n  const { virtualItems, totalHeight } = useMemo(() => {\n    // 1. Calculate the visible range based on scroll position\n    const rangeStart = Math.floor(scrollTop / itemHeight);\n    const rangeEnd = Math.min(\n      itemCount - 1,\n      Math.floor((scrollTop + containerHeight) / itemHeight)\n    );\n\n    // 2. Add overscan (buffer) to the range for smoother scrolling\n    const startIndex = Math.max(0, rangeStart - overscan);\n    const endIndex = Math.min(itemCount - 1, rangeEnd + overscan);\n\n    // 3. Generate the array of items to be rendered\n    const virtualItems = [];\n    for (let i = startIndex; i <= endIndex; i++) {\n      virtualItems.push({\n        index: i,\n        offsetTop: i * itemHeight, // Calculate absolute position for each item\n      });\n    }\n\n    // 4. Calculate total phantom height to maintain scrollbar size\n    const totalHeight = itemCount * itemHeight;\n\n    return { virtualItems, totalHeight };\n  }, [scrollTop, itemCount, itemHeight, containerHeight, overscan]);\n\n  return {\n    virtualItems,\n    totalHeight,\n    onScroll,\n  };\n};"],"names":["useVirtualize","itemCount","itemHeight","containerHeight","overscan","scrollTop","setScrollTop","useState","virtualItems","totalHeight","useMemo","rangeStart","Math","floor","rangeEnd","min","startIndex","max","endIndex","i","push","index","offsetTop","onScroll","e","currentTarget"],"mappings":"8CAEa,MAAAA,EAAgBA,EAC3BC,YACAC,aACAC,kBACAC,SAAAA,EAAW,MAGX,MAAOC,EAAWC,GAAgBC,EAAS,IAQrCC,aAAEA,EAAYC,YAAEA,GAAgBC,EAAQ,KAE5C,MAAMC,EAAaC,KAAKC,MAAMR,EAAYH,GACpCY,EAAWF,KAAKG,IACpBd,EAAY,EACZW,KAAKC,OAAOR,EAAYF,GAAmBD,IAIvCc,EAAaJ,KAAKK,IAAI,EAAGN,EAAaP,GACtCc,EAAWN,KAAKG,IAAId,EAAY,EAAGa,EAAWV,GAG9CI,EAAe,GACrB,IAAK,IAAIW,EAAIH,EAAYG,GAAKD,EAAUC,IACtCX,EAAaY,KAAK,CAChBC,MAAOF,EACPG,UAAWH,EAAIjB,IAOnB,MAAO,CAAEM,eAAcC,YAFHR,EAAYC,IAG/B,CAACG,EAAWJ,EAAWC,EAAYC,EAAiBC,IAEvD,MAAO,CACLI,eACAC,cACAc,SAnCgBC,IAChBlB,EAAakB,EAAEC,cAAcpB"}
+{"version":3,"file":"index.modern.mjs","sources":["../src/index.ts"],"sourcesContent":["import {\n  useState,\n  useRef,\n  useMemo,\n  useCallback,\n  useLayoutEffect,\n  UIEvent,\n} from \"react\";\n\nexport interface UseVirtualizeProps {\n  /** Total number of items in the list */\n  itemCount: number;\n  /** Estimated height of a single item (used for unmeasured items) */\n  itemHeight: number;\n  /** Number of extra items to render outside the visible view (default: 3) */\n  overscan?: number;\n  /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */\n  containerHeight?: number;\n}\n\nexport interface VirtualItem {\n  /** The index of the item in the original data array */\n  index: number;\n  /** The calculated top position (px) for absolute positioning */\n  offsetTop: number;\n  /** Callback ref to measure the actual DOM height of the item */\n  measureRef: (el: HTMLElement | null) => void;\n}\n\nexport function useVirtualize({\n  itemCount,\n  itemHeight: estimatedItemHeight,\n  overscan = 3,\n  containerHeight: propsContainerHeight,\n}: UseVirtualizeProps) {\n  const [scrollTop, setScrollTop] = useState(0);\n  const [observedHeight, setObservedHeight] = useState(0);\n\n  // Determine the effective container height:\n  // Use the prop if provided; otherwise, fall back to the measured height.\n  const height = propsContainerHeight ?? observedHeight;\n\n  // --- REFS (State that doesn't trigger re-renders) ---\n\n  // Stores the exact height of each measured item: { index: height }\n  const measurementCache = useRef({} as Record<number, number>);\n\n  // Stores the calculated total offset for each index: { index: offset }\n  // This acts as a Prefix Sum array to avoid recalculating from 0 every time.\n  const offsetCache = useRef({} as Record<number, number>);\n\n  // Tracks the last index that has a valid calculated offset in the cache.\n  const lastMeasuredIndex = useRef(-1);\n\n  // Reference to the scrollable container (used for ResizeObserver)\n  const scrollRef = useRef<HTMLDivElement>(null);\n\n  // Total measured height (Pixel)\n  const totalMeasuredSize = useRef(0);\n  // Total measured element?\n  const totalMeasuredCount = useRef(0);\n\n  const [measurementVersion, setMeasurementVersion] = useState(0);\n\n  // --- HELPER: GET ESTIMATED HEIGHT ---\n  // Zeka burada: Eğer hiç ölçüm yoksa senin verdiğin 'itemHeight'ı kullan.\n  // Ama ölçüm yaptıysak, gerçek ortalamayı kullan.\n  const getEstimatedItemHeight = useCallback(() => {\n    return totalMeasuredCount.current > 0\n      ? totalMeasuredSize.current / totalMeasuredCount.current\n      : estimatedItemHeight;\n  }, [estimatedItemHeight]);\n\n  // --- 1. AUTO-SIZER LOGIC ---\n  useLayoutEffect(() => {\n    // If the user provided a fixed height, skip observation to save resources.\n    if (propsContainerHeight !== undefined) return;\n\n    const scrollElement = scrollRef.current;\n    if (!scrollElement) return;\n\n    const observer = new ResizeObserver(([entry]) => {\n      // Update state only if dimensions actually changed\n      if (entry.contentRect.height !== observedHeight) {\n        setObservedHeight(entry.contentRect.height);\n      }\n    });\n\n    observer.observe(scrollElement);\n\n    return () => observer.disconnect();\n  }, [propsContainerHeight, observedHeight]);\n\n  // --- 2. OFFSET CALCULATOR (Core Logic) ---\n  // Returns the vertical position (px) of an item.\n  const getItemOffset = useCallback(\n    (index: number) => {\n      // If the offset for this index is already cached, return it directly.\n      if (index <= lastMeasuredIndex.current) {\n        return offsetCache.current[index] || 0;\n      }\n\n      // 1. Retrieve reference data from the last measured item.\n      const lastIndex = lastMeasuredIndex.current;\n\n      // If no items have been measured yet (-1), the starting offset is 0.\n      // Otherwise, retrieve the offset of the last measured item.\n      const lastOffset = lastIndex >= 0 ? offsetCache.current[lastIndex] : 0;\n\n      // Retrieve the height of the last measured item (default to 0 if none measured).\n      const lastHeight =\n        lastIndex >= 0 ? measurementCache.current[lastIndex] : 0;\n\n      // 2. Calculate the bottom position of the last measured item.\n      // This serves as the anchor point for estimating subsequent offsets.\n      const lastBottom = lastOffset + lastHeight;\n\n      // 3. Calculate how many unmeasured items exist between the last measured index and the target index.\n      const unmeasuredCount = index - lastIndex - 1;\n\n      // 4. Result: Anchor Point + (Number of Unmeasured Items * Estimated Height)\n      return lastBottom + unmeasuredCount * getEstimatedItemHeight();\n    },\n    [estimatedItemHeight, getEstimatedItemHeight]\n  );\n\n  // --- 3. BINARY SEARCH (Find Visible Index) ---\n  // Finds the index corresponding to the current scroll position.\n  // Performance: O(log N) - Crucial for large lists.\n  const getStartIndexForOffset = useCallback(\n    (offset: number) => {\n      let low = 0;\n      let high = itemCount - 1;\n\n      while (low <= high) {\n        const mid = Math.floor((low + high) / 2);\n        const currentOffset = getItemOffset(mid);\n        const currentHeight =\n          measurementCache.current[mid] || getEstimatedItemHeight();\n\n        if (currentOffset <= offset && currentOffset + currentHeight > offset) {\n          return mid;\n        } else if (currentOffset < offset) {\n          low = mid + 1;\n        } else {\n          high = mid - 1;\n        }\n      }\n\n      // Fallback to 0 if not found\n      return Math.max(0, low - 1);\n    },\n    [getItemOffset, itemCount, estimatedItemHeight]\n  );\n\n  // --- 4. MEASUREMENT CALLBACK (The \"Ref\" logic) ---\n  // This function is passed to the consumer to attach to their DOM elements.\n  const measureElement = useCallback(\n    (index: number) => (el: HTMLElement | null) => {\n      if (!el) return;\n\n      const measuredHeight = el.getBoundingClientRect().height;\n      const prevHeight = measurementCache.current[index];\n\n      if (prevHeight !== measuredHeight) {\n        if (prevHeight === undefined) {\n          totalMeasuredSize.current += measuredHeight;\n          totalMeasuredCount.current += 1;\n        } else {\n          totalMeasuredSize.current += measuredHeight - prevHeight;\n        }\n\n        measurementCache.current[index] = measuredHeight;\n\n        if (index > lastMeasuredIndex.current) {\n          const prevOffset = getItemOffset(index);\n          offsetCache.current[index] = prevOffset;\n          lastMeasuredIndex.current = index;\n        } else {\n          lastMeasuredIndex.current = Math.min(\n            lastMeasuredIndex.current,\n            index - 1\n          );\n        }\n\n        setMeasurementVersion(v => v + 1);\n      }\n    },\n    [getItemOffset]\n  );\n\n  // --- 5. RENDER RANGE CALCULATION ---\n  const startIndex = getStartIndexForOffset(scrollTop);\n  const endIndex = Math.min(\n    itemCount - 1,\n    getStartIndexForOffset(scrollTop + height) + overscan\n  );\n\n  // Generate the virtual items array to be rendered\n  const virtualItems = useMemo(() => {\n    const items: VirtualItem[] = [];\n    for (let i = Math.max(0, startIndex - overscan); i <= endIndex; i++) {\n      items.push({\n        index: i,\n        offsetTop: getItemOffset(i),\n        measureRef: measureElement(i),\n      });\n    }\n    return items;\n  }, [startIndex, endIndex, getItemOffset, measureElement, overscan]);\n\n  // Calculate total list height for the scrollbar\n  const totalHeight = getItemOffset(itemCount);\n\n  return {\n    virtualItems,\n    totalHeight,\n    scrollRef,\n    measurementVersion,\n    onScroll: (e: UIEvent<HTMLElement>) =>\n      setScrollTop(e.currentTarget.scrollTop),\n  };\n}\n"],"names":["useVirtualize","itemCount","itemHeight","estimatedItemHeight","overscan","containerHeight","propsContainerHeight","scrollTop","setScrollTop","useState","observedHeight","setObservedHeight","height","measurementCache","useRef","offsetCache","lastMeasuredIndex","scrollRef","totalMeasuredSize","totalMeasuredCount","measurementVersion","setMeasurementVersion","getEstimatedItemHeight","useCallback","current","useLayoutEffect","undefined","scrollElement","observer","ResizeObserver","entry","contentRect","observe","disconnect","getItemOffset","index","lastIndex","getStartIndexForOffset","offset","low","high","mid","Math","floor","currentOffset","currentHeight","max","measureElement","el","measuredHeight","getBoundingClientRect","prevHeight","prevOffset","min","v","startIndex","endIndex","virtualItems","useMemo","items","i","push","offsetTop","measureRef","totalHeight","onScroll","e","currentTarget"],"mappings":"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"}

package/dist/index.module.js

@@ -1,2 +1,2 @@
-import{useState as t,useMemo as o}from"react";var r=function(r){var e=r.itemCount,a=r.itemHeight,i=r.containerHeight,n=r.overscan,l=void 0===n?3:n,h=t(0),u=h[0],m=h[1],c=o(function(){for(var t=Math.floor(u/a),o=Math.min(e-1,Math.floor((u+i)/a)),r=Math.max(0,t-l),n=Math.min(e-1,o+l),h=[],m=r;m<=n;m++)h.push({index:m,offsetTop:m*a});return{virtualItems:h,totalHeight:e*a}},[u,e,a,i,l]);return{virtualItems:c.virtualItems,totalHeight:c.totalHeight,onScroll:function(t){m(t.currentTarget.scrollTop)}}};export{r as useVirtualize};
+import{useState as r,useRef as t,useCallback as n,useLayoutEffect as e,useMemo as u}from"react";function c(c){var i=c.itemCount,o=c.itemHeight,f=c.overscan,a=void 0===f?3:f,v=c.containerHeight,h=r(0),l=h[0],s=h[1],m=r(0),g=m[0],d=m[1],R=null!=v?v:g,p=t({}),M=t({}),x=t(-1),H=t(null),T=t(0),b=t(0),C=r(0),w=C[0],z=C[1],B=n(function(){return b.current>0?T.current/b.current:o},[o]);e(function(){if(void 0===v){var r=H.current;if(r){var t=new ResizeObserver(function(r){var t=r[0];t.contentRect.height!==g&&d(t.contentRect.height)});return t.observe(r),function(){return t.disconnect()}}}},[v,g]);var I=n(function(r){if(r<=x.current)return M.current[r]||0;var t=x.current;return(t>=0?M.current[t]:0)+(t>=0?p.current[t]:0)+(r-t-1)*B()},[o,B]),O=n(function(r){for(var t=0,n=i-1;t<=n;){var e=Math.floor((t+n)/2),u=I(e),c=p.current[e]||B();if(u<=r&&u+c>r)return e;u<r?t=e+1:n=e-1}return Math.max(0,t-1)},[I,i,o]),S=n(function(r){return function(t){if(t){var n=t.getBoundingClientRect().height,e=p.current[r];if(e!==n){if(void 0===e?(T.current+=n,b.current+=1):T.current+=n-e,p.current[r]=n,r>x.current){var u=I(r);M.current[r]=u,x.current=r}else x.current=Math.min(x.current,r-1);z(function(r){return r+1})}}}},[I]),V=O(l),j=Math.min(i-1,O(l+R)+a);return{virtualItems:u(function(){for(var r=[],t=Math.max(0,V-a);t<=j;t++)r.push({index:t,offsetTop:I(t),measureRef:S(t)});return r},[V,j,I,S,a]),totalHeight:I(i),scrollRef:H,measurementVersion:w,onScroll:function(r){return s(r.currentTarget.scrollTop)}}}export{c as useVirtualize};
 //# sourceMappingURL=index.module.js.map

package/dist/index.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.module.js","sources":["../src/index.js"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nexport const useVirtualize = ({\n  itemCount,\n  itemHeight,\n  containerHeight,\n  overscan = 3\n}) => {\n  // Store the current scroll position\n  const [scrollTop, setScrollTop] = useState(0);\n\n  // Update scroll position on scroll event\n  const onScroll = (e) => {\n    setScrollTop(e.currentTarget.scrollTop);\n  };\n\n  // Memoize calculations to prevent unnecessary re-renders\n  const { virtualItems, totalHeight } = useMemo(() => {\n    // 1. Calculate the visible range based on scroll position\n    const rangeStart = Math.floor(scrollTop / itemHeight);\n    const rangeEnd = Math.min(\n      itemCount - 1,\n      Math.floor((scrollTop + containerHeight) / itemHeight)\n    );\n\n    // 2. Add overscan (buffer) to the range for smoother scrolling\n    const startIndex = Math.max(0, rangeStart - overscan);\n    const endIndex = Math.min(itemCount - 1, rangeEnd + overscan);\n\n    // 3. Generate the array of items to be rendered\n    const virtualItems = [];\n    for (let i = startIndex; i <= endIndex; i++) {\n      virtualItems.push({\n        index: i,\n        offsetTop: i * itemHeight, // Calculate absolute position for each item\n      });\n    }\n\n    // 4. Calculate total phantom height to maintain scrollbar size\n    const totalHeight = itemCount * itemHeight;\n\n    return { virtualItems, totalHeight };\n  }, [scrollTop, itemCount, itemHeight, containerHeight, overscan]);\n\n  return {\n    virtualItems,\n    totalHeight,\n    onScroll,\n  };\n};"],"names":["useVirtualize","_ref","itemCount","itemHeight","containerHeight","_ref$overscan","overscan","_useState","useState","scrollTop","setScrollTop","_useMemo","useMemo","rangeStart","Math","floor","rangeEnd","min","startIndex","max","endIndex","virtualItems","i","push","index","offsetTop","totalHeight","onScroll","e","currentTarget"],"mappings":"8CAEa,IAAAA,EAAgB,SAAHC,GAKpB,IAJJC,EAASD,EAATC,UACAC,EAAUF,EAAVE,WACAC,EAAeH,EAAfG,gBAAeC,EAAAJ,EACfK,SAAAA,OAAQ,IAAAD,EAAG,EAACA,EAGZE,EAAkCC,EAAS,GAApCC,EAASF,EAAEG,GAAAA,EAAYH,EAG9B,GAKAI,EAAsCC,EAAQ,WAc5C,IAZA,IAAMC,EAAaC,KAAKC,MAAMN,EAAYN,GACpCa,EAAWF,KAAKG,IACpBf,EAAY,EACZY,KAAKC,OAAON,EAAYL,GAAmBD,IAIvCe,EAAaJ,KAAKK,IAAI,EAAGN,EAAaP,GACtCc,EAAWN,KAAKG,IAAIf,EAAY,EAAGc,EAAWV,GAG9Ce,EAAe,GACZC,EAAIJ,EAAYI,GAAKF,EAAUE,IACtCD,EAAaE,KAAK,CAChBC,MAAOF,EACPG,UAAWH,EAAInB,IAOnB,MAAO,CAAEkB,aAAAA,EAAcK,YAFHxB,EAAYC,EAGlC,EAAG,CAACM,EAAWP,EAAWC,EAAYC,EAAiBE,IAEvD,MAAO,CACLe,aA5BkBV,EAAZU,aA6BNK,YA7B+Bf,EAAXe,YA8BpBC,SAnCe,SAACC,GAChBlB,EAAakB,EAAEC,cAAcpB,UAC/B,EAmCF"}
+{"version":3,"file":"index.module.js","sources":["../src/index.ts"],"sourcesContent":["import {\n  useState,\n  useRef,\n  useMemo,\n  useCallback,\n  useLayoutEffect,\n  UIEvent,\n} from \"react\";\n\nexport interface UseVirtualizeProps {\n  /** Total number of items in the list */\n  itemCount: number;\n  /** Estimated height of a single item (used for unmeasured items) */\n  itemHeight: number;\n  /** Number of extra items to render outside the visible view (default: 3) */\n  overscan?: number;\n  /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */\n  containerHeight?: number;\n}\n\nexport interface VirtualItem {\n  /** The index of the item in the original data array */\n  index: number;\n  /** The calculated top position (px) for absolute positioning */\n  offsetTop: number;\n  /** Callback ref to measure the actual DOM height of the item */\n  measureRef: (el: HTMLElement | null) => void;\n}\n\nexport function useVirtualize({\n  itemCount,\n  itemHeight: estimatedItemHeight,\n  overscan = 3,\n  containerHeight: propsContainerHeight,\n}: UseVirtualizeProps) {\n  const [scrollTop, setScrollTop] = useState(0);\n  const [observedHeight, setObservedHeight] = useState(0);\n\n  // Determine the effective container height:\n  // Use the prop if provided; otherwise, fall back to the measured height.\n  const height = propsContainerHeight ?? observedHeight;\n\n  // --- REFS (State that doesn't trigger re-renders) ---\n\n  // Stores the exact height of each measured item: { index: height }\n  const measurementCache = useRef({} as Record<number, number>);\n\n  // Stores the calculated total offset for each index: { index: offset }\n  // This acts as a Prefix Sum array to avoid recalculating from 0 every time.\n  const offsetCache = useRef({} as Record<number, number>);\n\n  // Tracks the last index that has a valid calculated offset in the cache.\n  const lastMeasuredIndex = useRef(-1);\n\n  // Reference to the scrollable container (used for ResizeObserver)\n  const scrollRef = useRef<HTMLDivElement>(null);\n\n  // Total measured height (Pixel)\n  const totalMeasuredSize = useRef(0);\n  // Total measured element?\n  const totalMeasuredCount = useRef(0);\n\n  const [measurementVersion, setMeasurementVersion] = useState(0);\n\n  // --- HELPER: GET ESTIMATED HEIGHT ---\n  // Zeka burada: Eğer hiç ölçüm yoksa senin verdiğin 'itemHeight'ı kullan.\n  // Ama ölçüm yaptıysak, gerçek ortalamayı kullan.\n  const getEstimatedItemHeight = useCallback(() => {\n    return totalMeasuredCount.current > 0\n      ? totalMeasuredSize.current / totalMeasuredCount.current\n      : estimatedItemHeight;\n  }, [estimatedItemHeight]);\n\n  // --- 1. AUTO-SIZER LOGIC ---\n  useLayoutEffect(() => {\n    // If the user provided a fixed height, skip observation to save resources.\n    if (propsContainerHeight !== undefined) return;\n\n    const scrollElement = scrollRef.current;\n    if (!scrollElement) return;\n\n    const observer = new ResizeObserver(([entry]) => {\n      // Update state only if dimensions actually changed\n      if (entry.contentRect.height !== observedHeight) {\n        setObservedHeight(entry.contentRect.height);\n      }\n    });\n\n    observer.observe(scrollElement);\n\n    return () => observer.disconnect();\n  }, [propsContainerHeight, observedHeight]);\n\n  // --- 2. OFFSET CALCULATOR (Core Logic) ---\n  // Returns the vertical position (px) of an item.\n  const getItemOffset = useCallback(\n    (index: number) => {\n      // If the offset for this index is already cached, return it directly.\n      if (index <= lastMeasuredIndex.current) {\n        return offsetCache.current[index] || 0;\n      }\n\n      // 1. Retrieve reference data from the last measured item.\n      const lastIndex = lastMeasuredIndex.current;\n\n      // If no items have been measured yet (-1), the starting offset is 0.\n      // Otherwise, retrieve the offset of the last measured item.\n      const lastOffset = lastIndex >= 0 ? offsetCache.current[lastIndex] : 0;\n\n      // Retrieve the height of the last measured item (default to 0 if none measured).\n      const lastHeight =\n        lastIndex >= 0 ? measurementCache.current[lastIndex] : 0;\n\n      // 2. Calculate the bottom position of the last measured item.\n      // This serves as the anchor point for estimating subsequent offsets.\n      const lastBottom = lastOffset + lastHeight;\n\n      // 3. Calculate how many unmeasured items exist between the last measured index and the target index.\n      const unmeasuredCount = index - lastIndex - 1;\n\n      // 4. Result: Anchor Point + (Number of Unmeasured Items * Estimated Height)\n      return lastBottom + unmeasuredCount * getEstimatedItemHeight();\n    },\n    [estimatedItemHeight, getEstimatedItemHeight]\n  );\n\n  // --- 3. BINARY SEARCH (Find Visible Index) ---\n  // Finds the index corresponding to the current scroll position.\n  // Performance: O(log N) - Crucial for large lists.\n  const getStartIndexForOffset = useCallback(\n    (offset: number) => {\n      let low = 0;\n      let high = itemCount - 1;\n\n      while (low <= high) {\n        const mid = Math.floor((low + high) / 2);\n        const currentOffset = getItemOffset(mid);\n        const currentHeight =\n          measurementCache.current[mid] || getEstimatedItemHeight();\n\n        if (currentOffset <= offset && currentOffset + currentHeight > offset) {\n          return mid;\n        } else if (currentOffset < offset) {\n          low = mid + 1;\n        } else {\n          high = mid - 1;\n        }\n      }\n\n      // Fallback to 0 if not found\n      return Math.max(0, low - 1);\n    },\n    [getItemOffset, itemCount, estimatedItemHeight]\n  );\n\n  // --- 4. MEASUREMENT CALLBACK (The \"Ref\" logic) ---\n  // This function is passed to the consumer to attach to their DOM elements.\n  const measureElement = useCallback(\n    (index: number) => (el: HTMLElement | null) => {\n      if (!el) return;\n\n      const measuredHeight = el.getBoundingClientRect().height;\n      const prevHeight = measurementCache.current[index];\n\n      if (prevHeight !== measuredHeight) {\n        if (prevHeight === undefined) {\n          totalMeasuredSize.current += measuredHeight;\n          totalMeasuredCount.current += 1;\n        } else {\n          totalMeasuredSize.current += measuredHeight - prevHeight;\n        }\n\n        measurementCache.current[index] = measuredHeight;\n\n        if (index > lastMeasuredIndex.current) {\n          const prevOffset = getItemOffset(index);\n          offsetCache.current[index] = prevOffset;\n          lastMeasuredIndex.current = index;\n        } else {\n          lastMeasuredIndex.current = Math.min(\n            lastMeasuredIndex.current,\n            index - 1\n          );\n        }\n\n        setMeasurementVersion(v => v + 1);\n      }\n    },\n    [getItemOffset]\n  );\n\n  // --- 5. RENDER RANGE CALCULATION ---\n  const startIndex = getStartIndexForOffset(scrollTop);\n  const endIndex = Math.min(\n    itemCount - 1,\n    getStartIndexForOffset(scrollTop + height) + overscan\n  );\n\n  // Generate the virtual items array to be rendered\n  const virtualItems = useMemo(() => {\n    const items: VirtualItem[] = [];\n    for (let i = Math.max(0, startIndex - overscan); i <= endIndex; i++) {\n      items.push({\n        index: i,\n        offsetTop: getItemOffset(i),\n        measureRef: measureElement(i),\n      });\n    }\n    return items;\n  }, [startIndex, endIndex, getItemOffset, measureElement, overscan]);\n\n  // Calculate total list height for the scrollbar\n  const totalHeight = getItemOffset(itemCount);\n\n  return {\n    virtualItems,\n    totalHeight,\n    scrollRef,\n    measurementVersion,\n    onScroll: (e: UIEvent<HTMLElement>) =>\n      setScrollTop(e.currentTarget.scrollTop),\n  };\n}\n"],"names":["useVirtualize","_ref","itemCount","estimatedItemHeight","itemHeight","_ref$overscan","overscan","propsContainerHeight","containerHeight","_useState","useState","scrollTop","setScrollTop","_useState2","observedHeight","setObservedHeight","height","measurementCache","useRef","offsetCache","lastMeasuredIndex","scrollRef","totalMeasuredSize","totalMeasuredCount","_useState3","measurementVersion","setMeasurementVersion","getEstimatedItemHeight","useCallback","current","useLayoutEffect","undefined","scrollElement","observer","ResizeObserver","_ref2","entry","contentRect","observe","disconnect","getItemOffset","index","lastIndex","getStartIndexForOffset","offset","low","high","mid","Math","floor","currentOffset","currentHeight","max","measureElement","el","measuredHeight","getBoundingClientRect","prevHeight","prevOffset","min","v","startIndex","endIndex","virtualItems","useMemo","items","i","push","offsetTop","measureRef","totalHeight","onScroll","e","currentTarget"],"mappings":"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"}

package/dist/index.umd.js

@@ -1,2 +1,2 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],e):e((t||self).reactSimpleVirtualize={},t.react)}(this,function(t,e){t.useVirtualize=function(t){var o=t.itemCount,i=t.itemHeight,n=t.containerHeight,r=t.overscan,a=void 0===r?3:r,u=e.useState(0),f=u[0],l=u[1],s=e.useMemo(function(){for(var t=Math.floor(f/i),e=Math.min(o-1,Math.floor((f+n)/i)),r=Math.max(0,t-a),u=Math.min(o-1,e+a),l=[],s=r;s<=u;s++)l.push({index:s,offsetTop:s*i});return{virtualItems:l,totalHeight:o*i}},[f,o,i,n,a]);return{virtualItems:s.virtualItems,totalHeight:s.totalHeight,onScroll:function(t){l(t.currentTarget.scrollTop)}}}});
+!function(e,r){"object"==typeof exports&&"undefined"!=typeof module?r(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],r):r((e||self).reactSimpleVirtualize={},e.react)}(this,function(e,r){e.useVirtualize=function(e){var t=e.itemCount,n=e.itemHeight,u=e.overscan,c=void 0===u?3:u,i=e.containerHeight,o=r.useState(0),f=o[0],a=o[1],s=r.useState(0),l=s[0],h=s[1],v=null!=i?i:l,d=r.useRef({}),m=r.useRef({}),R=r.useRef(-1),g=r.useRef(null),p=r.useRef(0),b=r.useRef(0),x=r.useState(0),C=x[0],M=x[1],y=r.useCallback(function(){return b.current>0?p.current/b.current:n},[n]);r.useLayoutEffect(function(){if(void 0===i){var e=g.current;if(e){var r=new ResizeObserver(function(e){var r=e[0];r.contentRect.height!==l&&h(r.contentRect.height)});return r.observe(e),function(){return r.disconnect()}}}},[i,l]);var S=r.useCallback(function(e){if(e<=R.current)return m.current[e]||0;var r=R.current;return(r>=0?m.current[r]:0)+(r>=0?d.current[r]:0)+(e-r-1)*y()},[n,y]),T=r.useCallback(function(e){for(var r=0,n=t-1;r<=n;){var u=Math.floor((r+n)/2),c=S(u),i=d.current[u]||y();if(c<=e&&c+i>e)return u;c<e?r=u+1:n=u-1}return Math.max(0,r-1)},[S,t,n]),k=r.useCallback(function(e){return function(r){if(r){var t=r.getBoundingClientRect().height,n=d.current[e];if(n!==t){if(void 0===n?(p.current+=t,b.current+=1):p.current+=t-n,d.current[e]=t,e>R.current){var u=S(e);m.current[e]=u,R.current=e}else R.current=Math.min(R.current,e-1);M(function(e){return e+1})}}}},[S]),z=T(f),H=Math.min(t-1,T(f+v)+c);return{virtualItems:r.useMemo(function(){for(var e=[],r=Math.max(0,z-c);r<=H;r++)e.push({index:r,offsetTop:S(r),measureRef:k(r)});return e},[z,H,S,k,c]),totalHeight:S(t),scrollRef:g,measurementVersion:C,onScroll:function(e){return a(e.currentTarget.scrollTop)}}}});
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/index.js"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nexport const useVirtualize = ({\n  itemCount,\n  itemHeight,\n  containerHeight,\n  overscan = 3\n}) => {\n  // Store the current scroll position\n  const [scrollTop, setScrollTop] = useState(0);\n\n  // Update scroll position on scroll event\n  const onScroll = (e) => {\n    setScrollTop(e.currentTarget.scrollTop);\n  };\n\n  // Memoize calculations to prevent unnecessary re-renders\n  const { virtualItems, totalHeight } = useMemo(() => {\n    // 1. Calculate the visible range based on scroll position\n    const rangeStart = Math.floor(scrollTop / itemHeight);\n    const rangeEnd = Math.min(\n      itemCount - 1,\n      Math.floor((scrollTop + containerHeight) / itemHeight)\n    );\n\n    // 2. Add overscan (buffer) to the range for smoother scrolling\n    const startIndex = Math.max(0, rangeStart - overscan);\n    const endIndex = Math.min(itemCount - 1, rangeEnd + overscan);\n\n    // 3. Generate the array of items to be rendered\n    const virtualItems = [];\n    for (let i = startIndex; i <= endIndex; i++) {\n      virtualItems.push({\n        index: i,\n        offsetTop: i * itemHeight, // Calculate absolute position for each item\n      });\n    }\n\n    // 4. Calculate total phantom height to maintain scrollbar size\n    const totalHeight = itemCount * itemHeight;\n\n    return { virtualItems, totalHeight };\n  }, [scrollTop, itemCount, itemHeight, containerHeight, overscan]);\n\n  return {\n    virtualItems,\n    totalHeight,\n    onScroll,\n  };\n};"],"names":["_ref","itemCount","itemHeight","containerHeight","_ref$overscan","overscan","_useState","useState","scrollTop","setScrollTop","_useMemo","useMemo","rangeStart","Math","floor","rangeEnd","min","startIndex","max","endIndex","virtualItems","i","push","index","offsetTop","totalHeight","onScroll","e","currentTarget"],"mappings":"kSAE6B,SAAHA,GAKpB,IAJJC,EAASD,EAATC,UACAC,EAAUF,EAAVE,WACAC,EAAeH,EAAfG,gBAAeC,EAAAJ,EACfK,SAAAA,OAAQ,IAAAD,EAAG,EAACA,EAGZE,EAAkCC,EAAQA,SAAC,GAApCC,EAASF,EAAEG,GAAAA,EAAYH,EAG9B,GAKAI,EAAsCC,EAAAA,QAAQ,WAc5C,IAZA,IAAMC,EAAaC,KAAKC,MAAMN,EAAYN,GACpCa,EAAWF,KAAKG,IACpBf,EAAY,EACZY,KAAKC,OAAON,EAAYL,GAAmBD,IAIvCe,EAAaJ,KAAKK,IAAI,EAAGN,EAAaP,GACtCc,EAAWN,KAAKG,IAAIf,EAAY,EAAGc,EAAWV,GAG9Ce,EAAe,GACZC,EAAIJ,EAAYI,GAAKF,EAAUE,IACtCD,EAAaE,KAAK,CAChBC,MAAOF,EACPG,UAAWH,EAAInB,IAOnB,MAAO,CAAEkB,aAAAA,EAAcK,YAFHxB,EAAYC,EAGlC,EAAG,CAACM,EAAWP,EAAWC,EAAYC,EAAiBE,IAEvD,MAAO,CACLe,aA5BkBV,EAAZU,aA6BNK,YA7B+Bf,EAAXe,YA8BpBC,SAnCe,SAACC,GAChBlB,EAAakB,EAAEC,cAAcpB,UAC/B,EAmCF"}
+{"version":3,"file":"index.umd.js","sources":["../src/index.ts"],"sourcesContent":["import {\n  useState,\n  useRef,\n  useMemo,\n  useCallback,\n  useLayoutEffect,\n  UIEvent,\n} from \"react\";\n\nexport interface UseVirtualizeProps {\n  /** Total number of items in the list */\n  itemCount: number;\n  /** Estimated height of a single item (used for unmeasured items) */\n  itemHeight: number;\n  /** Number of extra items to render outside the visible view (default: 3) */\n  overscan?: number;\n  /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */\n  containerHeight?: number;\n}\n\nexport interface VirtualItem {\n  /** The index of the item in the original data array */\n  index: number;\n  /** The calculated top position (px) for absolute positioning */\n  offsetTop: number;\n  /** Callback ref to measure the actual DOM height of the item */\n  measureRef: (el: HTMLElement | null) => void;\n}\n\nexport function useVirtualize({\n  itemCount,\n  itemHeight: estimatedItemHeight,\n  overscan = 3,\n  containerHeight: propsContainerHeight,\n}: UseVirtualizeProps) {\n  const [scrollTop, setScrollTop] = useState(0);\n  const [observedHeight, setObservedHeight] = useState(0);\n\n  // Determine the effective container height:\n  // Use the prop if provided; otherwise, fall back to the measured height.\n  const height = propsContainerHeight ?? observedHeight;\n\n  // --- REFS (State that doesn't trigger re-renders) ---\n\n  // Stores the exact height of each measured item: { index: height }\n  const measurementCache = useRef({} as Record<number, number>);\n\n  // Stores the calculated total offset for each index: { index: offset }\n  // This acts as a Prefix Sum array to avoid recalculating from 0 every time.\n  const offsetCache = useRef({} as Record<number, number>);\n\n  // Tracks the last index that has a valid calculated offset in the cache.\n  const lastMeasuredIndex = useRef(-1);\n\n  // Reference to the scrollable container (used for ResizeObserver)\n  const scrollRef = useRef<HTMLDivElement>(null);\n\n  // Total measured height (Pixel)\n  const totalMeasuredSize = useRef(0);\n  // Total measured element?\n  const totalMeasuredCount = useRef(0);\n\n  const [measurementVersion, setMeasurementVersion] = useState(0);\n\n  // --- HELPER: GET ESTIMATED HEIGHT ---\n  // Zeka burada: Eğer hiç ölçüm yoksa senin verdiğin 'itemHeight'ı kullan.\n  // Ama ölçüm yaptıysak, gerçek ortalamayı kullan.\n  const getEstimatedItemHeight = useCallback(() => {\n    return totalMeasuredCount.current > 0\n      ? totalMeasuredSize.current / totalMeasuredCount.current\n      : estimatedItemHeight;\n  }, [estimatedItemHeight]);\n\n  // --- 1. AUTO-SIZER LOGIC ---\n  useLayoutEffect(() => {\n    // If the user provided a fixed height, skip observation to save resources.\n    if (propsContainerHeight !== undefined) return;\n\n    const scrollElement = scrollRef.current;\n    if (!scrollElement) return;\n\n    const observer = new ResizeObserver(([entry]) => {\n      // Update state only if dimensions actually changed\n      if (entry.contentRect.height !== observedHeight) {\n        setObservedHeight(entry.contentRect.height);\n      }\n    });\n\n    observer.observe(scrollElement);\n\n    return () => observer.disconnect();\n  }, [propsContainerHeight, observedHeight]);\n\n  // --- 2. OFFSET CALCULATOR (Core Logic) ---\n  // Returns the vertical position (px) of an item.\n  const getItemOffset = useCallback(\n    (index: number) => {\n      // If the offset for this index is already cached, return it directly.\n      if (index <= lastMeasuredIndex.current) {\n        return offsetCache.current[index] || 0;\n      }\n\n      // 1. Retrieve reference data from the last measured item.\n      const lastIndex = lastMeasuredIndex.current;\n\n      // If no items have been measured yet (-1), the starting offset is 0.\n      // Otherwise, retrieve the offset of the last measured item.\n      const lastOffset = lastIndex >= 0 ? offsetCache.current[lastIndex] : 0;\n\n      // Retrieve the height of the last measured item (default to 0 if none measured).\n      const lastHeight =\n        lastIndex >= 0 ? measurementCache.current[lastIndex] : 0;\n\n      // 2. Calculate the bottom position of the last measured item.\n      // This serves as the anchor point for estimating subsequent offsets.\n      const lastBottom = lastOffset + lastHeight;\n\n      // 3. Calculate how many unmeasured items exist between the last measured index and the target index.\n      const unmeasuredCount = index - lastIndex - 1;\n\n      // 4. Result: Anchor Point + (Number of Unmeasured Items * Estimated Height)\n      return lastBottom + unmeasuredCount * getEstimatedItemHeight();\n    },\n    [estimatedItemHeight, getEstimatedItemHeight]\n  );\n\n  // --- 3. BINARY SEARCH (Find Visible Index) ---\n  // Finds the index corresponding to the current scroll position.\n  // Performance: O(log N) - Crucial for large lists.\n  const getStartIndexForOffset = useCallback(\n    (offset: number) => {\n      let low = 0;\n      let high = itemCount - 1;\n\n      while (low <= high) {\n        const mid = Math.floor((low + high) / 2);\n        const currentOffset = getItemOffset(mid);\n        const currentHeight =\n          measurementCache.current[mid] || getEstimatedItemHeight();\n\n        if (currentOffset <= offset && currentOffset + currentHeight > offset) {\n          return mid;\n        } else if (currentOffset < offset) {\n          low = mid + 1;\n        } else {\n          high = mid - 1;\n        }\n      }\n\n      // Fallback to 0 if not found\n      return Math.max(0, low - 1);\n    },\n    [getItemOffset, itemCount, estimatedItemHeight]\n  );\n\n  // --- 4. MEASUREMENT CALLBACK (The \"Ref\" logic) ---\n  // This function is passed to the consumer to attach to their DOM elements.\n  const measureElement = useCallback(\n    (index: number) => (el: HTMLElement | null) => {\n      if (!el) return;\n\n      const measuredHeight = el.getBoundingClientRect().height;\n      const prevHeight = measurementCache.current[index];\n\n      if (prevHeight !== measuredHeight) {\n        if (prevHeight === undefined) {\n          totalMeasuredSize.current += measuredHeight;\n          totalMeasuredCount.current += 1;\n        } else {\n          totalMeasuredSize.current += measuredHeight - prevHeight;\n        }\n\n        measurementCache.current[index] = measuredHeight;\n\n        if (index > lastMeasuredIndex.current) {\n          const prevOffset = getItemOffset(index);\n          offsetCache.current[index] = prevOffset;\n          lastMeasuredIndex.current = index;\n        } else {\n          lastMeasuredIndex.current = Math.min(\n            lastMeasuredIndex.current,\n            index - 1\n          );\n        }\n\n        setMeasurementVersion(v => v + 1);\n      }\n    },\n    [getItemOffset]\n  );\n\n  // --- 5. RENDER RANGE CALCULATION ---\n  const startIndex = getStartIndexForOffset(scrollTop);\n  const endIndex = Math.min(\n    itemCount - 1,\n    getStartIndexForOffset(scrollTop + height) + overscan\n  );\n\n  // Generate the virtual items array to be rendered\n  const virtualItems = useMemo(() => {\n    const items: VirtualItem[] = [];\n    for (let i = Math.max(0, startIndex - overscan); i <= endIndex; i++) {\n      items.push({\n        index: i,\n        offsetTop: getItemOffset(i),\n        measureRef: measureElement(i),\n      });\n    }\n    return items;\n  }, [startIndex, endIndex, getItemOffset, measureElement, overscan]);\n\n  // Calculate total list height for the scrollbar\n  const totalHeight = getItemOffset(itemCount);\n\n  return {\n    virtualItems,\n    totalHeight,\n    scrollRef,\n    measurementVersion,\n    onScroll: (e: UIEvent<HTMLElement>) =>\n      setScrollTop(e.currentTarget.scrollTop),\n  };\n}\n"],"names":["_ref","itemCount","estimatedItemHeight","itemHeight","_ref$overscan","overscan","propsContainerHeight","containerHeight","_useState","useState","scrollTop","setScrollTop","_useState2","observedHeight","setObservedHeight","height","measurementCache","useRef","offsetCache","lastMeasuredIndex","scrollRef","totalMeasuredSize","totalMeasuredCount","_useState3","measurementVersion","setMeasurementVersion","getEstimatedItemHeight","useCallback","current","useLayoutEffect","undefined","scrollElement","observer","ResizeObserver","_ref2","entry","contentRect","observe","disconnect","getItemOffset","index","lastIndex","getStartIndexForOffset","offset","low","high","mid","Math","floor","currentOffset","currentHeight","max","measureElement","el","measuredHeight","getBoundingClientRect","prevHeight","prevOffset","min","v","startIndex","endIndex","virtualItems","useMemo","items","i","push","offsetTop","measureRef","totalHeight","onScroll","e","currentTarget"],"mappings":"2SA6B6BA,GAKR,IAJnBC,EAASD,EAATC,UACYC,EAAmBF,EAA/BG,WAAUC,EAAAJ,EACVK,SAAAA,OAAQ,IAAAD,EAAG,EAACA,EACKE,EAAoBN,EAArCO,gBAEAC,EAAkCC,EAAQA,SAAC,GAApCC,EAASF,EAAEG,GAAAA,EAAYH,EAAA,GAC9BI,EAA4CH,WAAS,GAA9CI,EAAcD,EAAEE,GAAAA,EAAiBF,EAAA,GAIlCG,EAAST,MAAAA,EAAAA,EAAwBO,EAKjCG,EAAmBC,SAAO,CAAA,GAI1BC,EAAcD,EAAAA,OAAO,CAA4B,GAGjDE,EAAoBF,EAAMA,QAAE,GAG5BG,EAAYH,SAAuB,MAGnCI,EAAoBJ,EAAAA,OAAO,GAE3BK,EAAqBL,EAAMA,OAAC,GAElCM,EAAoDd,EAAAA,SAAS,GAAtDe,EAAkBD,EAAEE,GAAAA,EAAqBF,KAK1CG,EAAyBC,EAAWA,YAAC,WACzC,OAAOL,EAAmBM,QAAU,EAChCP,EAAkBO,QAAUN,EAAmBM,QAC/C1B,CACN,EAAG,CAACA,IAGJ2B,EAAAA,gBAAgB,WAEd,QAA6BC,IAAzBxB,EAAJ,CAEA,IAAMyB,EAAgBX,EAAUQ,QAChC,GAAKG,EAAL,CAEA,IAAMC,EAAW,IAAIC,eAAe,SAAAC,GAAE,IAAAC,EAAKD,KAErCC,EAAMC,YAAYrB,SAAWF,GAC/BC,EAAkBqB,EAAMC,YAAYrB,OAExC,GAIA,OAFAiB,EAASK,QAAQN,GAEJ,WAAA,OAAAC,EAASM,YAAY,GACpC,EAAG,CAAChC,EAAsBO,IAI1B,IAAM0B,EAAgBZ,EAAAA,YACpB,SAACa,GAEC,GAAIA,GAASrB,EAAkBS,QAC7B,OAAOV,EAAYU,QAAQY,IAAU,EAIvC,IAAMC,EAAYtB,EAAkBS,QAkBpC,OAdmBa,GAAa,EAAIvB,EAAYU,QAAQa,GAAa,IAInEA,GAAa,EAAIzB,EAAiBY,QAAQa,GAAa,IAOjCD,EAAQC,EAAY,GAGNf,GACxC,EACA,CAACxB,EAAqBwB,IAMlBgB,EAAyBf,EAAAA,YAC7B,SAACgB,GAIC,IAHA,IAAIC,EAAM,EACNC,EAAO5C,EAAY,EAEhB2C,GAAOC,GAAM,CAClB,IAAMC,EAAMC,KAAKC,OAAOJ,EAAMC,GAAQ,GAChCI,EAAgBV,EAAcO,GAC9BI,EACJlC,EAAiBY,QAAQkB,IAAQpB,IAEnC,GAAIuB,GAAiBN,GAAUM,EAAgBC,EAAgBP,EAC7D,OAAOG,EACEG,EAAgBN,EACzBC,EAAME,EAAM,EAEZD,EAAOC,EAAM,CAEhB,CAGD,OAAOC,KAAKI,IAAI,EAAGP,EAAM,EAC3B,EACA,CAACL,EAAetC,EAAWC,IAKvBkD,EAAiBzB,cACrB,SAACa,GAAkB,OAAA,SAACa,GAClB,GAAKA,EAAL,CAEA,IAAMC,EAAiBD,EAAGE,wBAAwBxC,OAC5CyC,EAAaxC,EAAiBY,QAAQY,GAE5C,GAAIgB,IAAeF,EAAgB,CAUjC,QATmBxB,IAAf0B,GACFnC,EAAkBO,SAAW0B,EAC7BhC,EAAmBM,SAAW,GAE9BP,EAAkBO,SAAW0B,EAAiBE,EAGhDxC,EAAiBY,QAAQY,GAASc,EAE9Bd,EAAQrB,EAAkBS,QAAS,CACrC,IAAM6B,EAAalB,EAAcC,GACjCtB,EAAYU,QAAQY,GAASiB,EAC7BtC,EAAkBS,QAAUY,CAC7B,MACCrB,EAAkBS,QAAUmB,KAAKW,IAC/BvC,EAAkBS,QAClBY,EAAQ,GAIZf,EAAsB,SAAAkC,GAAK,OAAAA,EAAI,CAAC,EACjC,EACH,CAAC,EACD,CAACpB,IAIGqB,EAAalB,EAAuBhC,GACpCmD,EAAWd,KAAKW,IACpBzD,EAAY,EACZyC,EAAuBhC,EAAYK,GAAUV,GAmB/C,MAAO,CACLyD,aAhBmBC,EAAAA,QAAQ,WAE3B,IADA,IAAMC,EAAuB,GACpBC,EAAIlB,KAAKI,IAAI,EAAGS,EAAavD,GAAW4D,GAAKJ,EAAUI,IAC9DD,EAAME,KAAK,CACT1B,MAAOyB,EACPE,UAAW5B,EAAc0B,GACzBG,WAAYhB,EAAea,KAG/B,OAAOD,CACT,EAAG,CAACJ,EAAYC,EAAUtB,EAAea,EAAgB/C,IAOvDgE,YAJkB9B,EAActC,GAKhCmB,UAAAA,EACAI,mBAAAA,EACA8C,SAAU,SAACC,GACT,OAAA5D,EAAa4D,EAAEC,cAAc9D,UAAU,EAE7C"}

package/package.json

@@ -1,39 +1,45 @@
 {
-  "name": "react-simple-virtualize",
-  "version": "1.0.0",
-  "description": "A lightweight, dependency-free virtualization hook for React.",
-  "source": "src/index.js",
-  "main": "dist/index.js",
-  "module": "dist/index.module.js",
-  "unpkg": "dist/index.umd.js",
-  "types": "src/index.d.ts",
-  "scripts": {
-    "build": "microbundle",
-    "dev": "microbundle watch",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "react",
-    "virtual-list",
-    "virtualization",
-    "scroll",
-    "performance",
-    "hook"
-  ],
-  "author": "Ozan Batuhan Ceylan",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ozanbatuhanceylan/react-simple-virtualize"
-  },
-  "funding": {
-    "type": "buymeacoffee",
-    "url": "https://www.buymeacoffee.com/obceylan"
-  },
-  "peerDependencies": {
-    "react": ">=16.8.0"
-  },
-  "devDependencies": {
-    "microbundle": "^0.15.1"
-  }
-}
+    "name": "react-simple-virtualize",
+    "version": "2.0.0",
+    "description": "A lightweight, dependency-free virtualization hook for React.",
+    "source": "src/index.ts",
+    "main": "dist/index.js",
+    "module": "dist/index.module.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        "types": "./dist/index.d.ts",
+        "require": "./dist/index.js",
+        "default": "./dist/index.module.js"
+    },
+    "unpkg": "dist/index.umd.js",
+    "scripts": {
+        "build": "microbundle",
+        "dev": "microbundle watch",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "react",
+        "virtual-list",
+        "virtualization",
+        "scroll",
+        "performance",
+        "hook"
+    ],
+    "author": "Ozan Batuhan Ceylan",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/ozanbatuhanceylan/react-simple-virtualize"
+    },
+    "funding": {
+        "type": "buymeacoffee",
+        "url": "https://www.buymeacoffee.com/obceylan"
+    },
+    "peerDependencies": {
+        "react": ">=16.8.0"
+    },
+    "devDependencies": {
+        "@types/react": "^19.2.8",
+        "microbundle": "^0.15.1"
+    }
+}

package/src/index.ts

@@ -0,0 +1,223 @@
+import {
+  useState,
+  useRef,
+  useMemo,
+  useCallback,
+  useLayoutEffect,
+  UIEvent,
+} from "react";
+
+export interface UseVirtualizeProps {
+  /** Total number of items in the list */
+  itemCount: number;
+  /** Estimated height of a single item (used for unmeasured items) */
+  itemHeight: number;
+  /** Number of extra items to render outside the visible view (default: 3) */
+  overscan?: number;
+  /** Fixed container height. If not provided, it will be measured automatically via ResizeObserver */
+  containerHeight?: number;
+}
+
+export interface VirtualItem {
+  /** The index of the item in the original data array */
+  index: number;
+  /** The calculated top position (px) for absolute positioning */
+  offsetTop: number;
+  /** Callback ref to measure the actual DOM height of the item */
+  measureRef: (el: HTMLElement | null) => void;
+}
+
+export function useVirtualize({
+  itemCount,
+  itemHeight: estimatedItemHeight,
+  overscan = 3,
+  containerHeight: propsContainerHeight,
+}: UseVirtualizeProps) {
+  const [scrollTop, setScrollTop] = useState(0);
+  const [observedHeight, setObservedHeight] = useState(0);
+
+  // Determine the effective container height:
+  // Use the prop if provided; otherwise, fall back to the measured height.
+  const height = propsContainerHeight ?? observedHeight;
+
+  // --- REFS (State that doesn't trigger re-renders) ---
+
+  // Stores the exact height of each measured item: { index: height }
+  const measurementCache = useRef({} as Record<number, number>);
+
+  // Stores the calculated total offset for each index: { index: offset }
+  // This acts as a Prefix Sum array to avoid recalculating from 0 every time.
+  const offsetCache = useRef({} as Record<number, number>);
+
+  // Tracks the last index that has a valid calculated offset in the cache.
+  const lastMeasuredIndex = useRef(-1);
+
+  // Reference to the scrollable container (used for ResizeObserver)
+  const scrollRef = useRef<HTMLDivElement>(null);
+
+  // Total measured height (Pixel)
+  const totalMeasuredSize = useRef(0);
+  // Total measured element?
+  const totalMeasuredCount = useRef(0);
+
+  const [measurementVersion, setMeasurementVersion] = useState(0);
+
+  // --- HELPER: GET ESTIMATED HEIGHT ---
+  // Zeka burada: Eğer hiç ölçüm yoksa senin verdiğin 'itemHeight'ı kullan.
+  // Ama ölçüm yaptıysak, gerçek ortalamayı kullan.
+  const getEstimatedItemHeight = useCallback(() => {
+    return totalMeasuredCount.current > 0
+      ? totalMeasuredSize.current / totalMeasuredCount.current
+      : estimatedItemHeight;
+  }, [estimatedItemHeight]);
+
+  // --- 1. AUTO-SIZER LOGIC ---
+  useLayoutEffect(() => {
+    // If the user provided a fixed height, skip observation to save resources.
+    if (propsContainerHeight !== undefined) return;
+
+    const scrollElement = scrollRef.current;
+    if (!scrollElement) return;
+
+    const observer = new ResizeObserver(([entry]) => {
+      // Update state only if dimensions actually changed
+      if (entry.contentRect.height !== observedHeight) {
+        setObservedHeight(entry.contentRect.height);
+      }
+    });
+
+    observer.observe(scrollElement);
+
+    return () => observer.disconnect();
+  }, [propsContainerHeight, observedHeight]);
+
+  // --- 2. OFFSET CALCULATOR (Core Logic) ---
+  // Returns the vertical position (px) of an item.
+  const getItemOffset = useCallback(
+    (index: number) => {
+      // If the offset for this index is already cached, return it directly.
+      if (index <= lastMeasuredIndex.current) {
+        return offsetCache.current[index] || 0;
+      }
+
+      // 1. Retrieve reference data from the last measured item.
+      const lastIndex = lastMeasuredIndex.current;
+
+      // If no items have been measured yet (-1), the starting offset is 0.
+      // Otherwise, retrieve the offset of the last measured item.
+      const lastOffset = lastIndex >= 0 ? offsetCache.current[lastIndex] : 0;
+
+      // Retrieve the height of the last measured item (default to 0 if none measured).
+      const lastHeight =
+        lastIndex >= 0 ? measurementCache.current[lastIndex] : 0;
+
+      // 2. Calculate the bottom position of the last measured item.
+      // This serves as the anchor point for estimating subsequent offsets.
+      const lastBottom = lastOffset + lastHeight;
+
+      // 3. Calculate how many unmeasured items exist between the last measured index and the target index.
+      const unmeasuredCount = index - lastIndex - 1;
+
+      // 4. Result: Anchor Point + (Number of Unmeasured Items * Estimated Height)
+      return lastBottom + unmeasuredCount * getEstimatedItemHeight();
+    },
+    [estimatedItemHeight, getEstimatedItemHeight]
+  );
+
+  // --- 3. BINARY SEARCH (Find Visible Index) ---
+  // Finds the index corresponding to the current scroll position.
+  // Performance: O(log N) - Crucial for large lists.
+  const getStartIndexForOffset = useCallback(
+    (offset: number) => {
+      let low = 0;
+      let high = itemCount - 1;
+
+      while (low <= high) {
+        const mid = Math.floor((low + high) / 2);
+        const currentOffset = getItemOffset(mid);
+        const currentHeight =
+          measurementCache.current[mid] || getEstimatedItemHeight();
+
+        if (currentOffset <= offset && currentOffset + currentHeight > offset) {
+          return mid;
+        } else if (currentOffset < offset) {
+          low = mid + 1;
+        } else {
+          high = mid - 1;
+        }
+      }
+
+      // Fallback to 0 if not found
+      return Math.max(0, low - 1);
+    },
+    [getItemOffset, itemCount, estimatedItemHeight]
+  );
+
+  // --- 4. MEASUREMENT CALLBACK (The "Ref" logic) ---
+  // This function is passed to the consumer to attach to their DOM elements.
+  const measureElement = useCallback(
+    (index: number) => (el: HTMLElement | null) => {
+      if (!el) return;
+
+      const measuredHeight = el.getBoundingClientRect().height;
+      const prevHeight = measurementCache.current[index];
+
+      if (prevHeight !== measuredHeight) {
+        if (prevHeight === undefined) {
+          totalMeasuredSize.current += measuredHeight;
+          totalMeasuredCount.current += 1;
+        } else {
+          totalMeasuredSize.current += measuredHeight - prevHeight;
+        }
+
+        measurementCache.current[index] = measuredHeight;
+
+        if (index > lastMeasuredIndex.current) {
+          const prevOffset = getItemOffset(index);
+          offsetCache.current[index] = prevOffset;
+          lastMeasuredIndex.current = index;
+        } else {
+          lastMeasuredIndex.current = Math.min(
+            lastMeasuredIndex.current,
+            index - 1
+          );
+        }
+
+        setMeasurementVersion(v => v + 1);
+      }
+    },
+    [getItemOffset]
+  );
+
+  // --- 5. RENDER RANGE CALCULATION ---
+  const startIndex = getStartIndexForOffset(scrollTop);
+  const endIndex = Math.min(
+    itemCount - 1,
+    getStartIndexForOffset(scrollTop + height) + overscan
+  );
+
+  // Generate the virtual items array to be rendered
+  const virtualItems = useMemo(() => {
+    const items: VirtualItem[] = [];
+    for (let i = Math.max(0, startIndex - overscan); i <= endIndex; i++) {
+      items.push({
+        index: i,
+        offsetTop: getItemOffset(i),
+        measureRef: measureElement(i),
+      });
+    }
+    return items;
+  }, [startIndex, endIndex, getItemOffset, measureElement, overscan]);
+
+  // Calculate total list height for the scrollbar
+  const totalHeight = getItemOffset(itemCount);
+
+  return {
+    virtualItems,
+    totalHeight,
+    scrollRef,
+    measurementVersion,
+    onScroll: (e: UIEvent<HTMLElement>) =>
+      setScrollTop(e.currentTarget.scrollTop),
+  };
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": ["DOM", "ESNext"],
+    "moduleResolution": "node",
+    "jsx": "react-jsx",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/src/index.js

@@ -1,50 +0,0 @@
-import { useState, useMemo } from 'react';
-
-export const useVirtualize = ({
-  itemCount,
-  itemHeight,
-  containerHeight,
-  overscan = 3
-}) => {
-  // Store the current scroll position
-  const [scrollTop, setScrollTop] = useState(0);
-
-  // Update scroll position on scroll event
-  const onScroll = (e) => {
-    setScrollTop(e.currentTarget.scrollTop);
-  };
-
-  // Memoize calculations to prevent unnecessary re-renders
-  const { virtualItems, totalHeight } = useMemo(() => {
-    // 1. Calculate the visible range based on scroll position
-    const rangeStart = Math.floor(scrollTop / itemHeight);
-    const rangeEnd = Math.min(
-      itemCount - 1,
-      Math.floor((scrollTop + containerHeight) / itemHeight)
-    );
-
-    // 2. Add overscan (buffer) to the range for smoother scrolling
-    const startIndex = Math.max(0, rangeStart - overscan);
-    const endIndex = Math.min(itemCount - 1, rangeEnd + overscan);
-
-    // 3. Generate the array of items to be rendered
-    const virtualItems = [];
-    for (let i = startIndex; i <= endIndex; i++) {
-      virtualItems.push({
-        index: i,
-        offsetTop: i * itemHeight, // Calculate absolute position for each item
-      });
-    }
-
-    // 4. Calculate total phantom height to maintain scrollbar size
-    const totalHeight = itemCount * itemHeight;
-
-    return { virtualItems, totalHeight };
-  }, [scrollTop, itemCount, itemHeight, containerHeight, overscan]);
-
-  return {
-    virtualItems,
-    totalHeight,
-    onScroll,
-  };
-};