@fluentui/react-virtualizer 9.0.0-alpha.21 → 9.0.0-alpha.23

package/lib/components/Virtualizer/useVirtualizer.js

@@ -1,368 +1,432 @@
+import { useEffect, useRef, useCallback, useReducer, useImperativeHandle, useState } from 'react';
 import { useIntersectionObserver } from '../../hooks/useIntersectionObserver';
-import { useEffect, useRef, useCallback, useReducer } from 'react';
 import { resolveShorthand } from '@fluentui/react-utilities';
 import { flushSync } from 'react-dom';
 import { useVirtualizerContextState_unstable } from '../../Utilities';
 import { renderVirtualizerChildPlaceholder } from './renderVirtualizer';
 export function useVirtualizer_unstable(props) {
-  const {
-    itemSize,
-    numItems,
-    virtualizerLength,
-    children: renderChild,
-    getItemSize,
-    bufferItems = Math.round(virtualizerLength / 4.0),
-    bufferSize = Math.floor(bufferItems / 2.0) * itemSize,
-    scrollViewRef,
-    axis = 'vertical',
-    reversed = false,
-    virtualizerContext
-  } = props;
-  /* The context is optional, it's useful for injecting additional index logic, or performing uniform state updates*/
-  const _virtualizerContext = useVirtualizerContextState_unstable(virtualizerContext);
-  const actualIndex = _virtualizerContext.contextIndex;
-  const setActualIndex = _virtualizerContext.setContextIndex;
-  // Store ref to before padding element
-  const beforeElementRef = useRef(null);
-  // Store ref to before padding element
-  const afterElementRef = useRef(null);
-  // We need to store an array to track dynamic sizes, we can use this to incrementally update changes
-  const childSizes = useRef(new Array(getItemSize ? numItems : 0));
-  /* We keep track of the progressive sizing/placement down the list,
-  this helps us skip re-calculations unless children/size changes */
-  const childProgressiveSizes = useRef(new Array(getItemSize ? numItems : 0));
-  // The internal tracking REF for child array (updates often).
-  const childArray = useRef(new Array(virtualizerLength));
-  // We want to be methodical about updating the render with child reference array
-  const forceUpdate = useReducer(() => ({}), {})[1];
-  const horizontal = axis === 'horizontal';
-  const populateSizeArrays = () => {
-    if (!getItemSize) {
-      // Static sizes, never mind!
-      return;
-    }
-    if (numItems !== childSizes.current.length) {
-      childSizes.current = new Array(numItems);
-    }
-    if (numItems !== childProgressiveSizes.current.length) {
-      childProgressiveSizes.current = new Array(numItems);
-    }
-    for (let index = 0; index < numItems; index++) {
-      childSizes.current[index] = getItemSize(index);
-      if (index === 0) {
-        childProgressiveSizes.current[index] = childSizes.current[index];
-      } else {
-        childProgressiveSizes.current[index] = childProgressiveSizes.current[index - 1] + childSizes.current[index];
-      }
-    }
-  };
-  const batchUpdateNewIndex = index => {
-    // Local updates
-    updateChildRows(index);
-    updateCurrentItemSizes(index);
-    // State setters
-    setActualIndex(index);
-  };
-  // Observe intersections of virtualized components
-  const {
-    setObserverList
-  } = useIntersectionObserver((entries, observer) => {
-    /* Sanity check - do we even need virtualization? */if (virtualizerLength > numItems) {
-      if (actualIndex !== 0) {
-        batchUpdateNewIndex(0);
-      }
-      // No-op
-      return;
-    }
-    /* IO initiates this function when needed (bookend entering view) */
-    let measurementPos = 0;
-    let bufferCount = bufferItems;
-    // Grab latest entry that is intersecting
-    const latestEntry = entries.length === 1 ? entries[0] : entries.sort((entry1, entry2) => entry2.time - entry1.time).find(entry => {
-      return entry.intersectionRatio > 0;
-    });
-    if (!latestEntry) {
-      // If we don't find an intersecting area, ignore for now.
-      return;
-    }
-    if (latestEntry.target === afterElementRef.current) {
-      // We need to inverse the buffer count
-      bufferCount = virtualizerLength - bufferItems;
-      measurementPos = reversed ? calculateAfter() : calculateTotalSize() - calculateAfter();
-      if (!horizontal) {
-        if (reversed) {
-          // Scrolling 'up' and hit the after element below
-          measurementPos -= Math.abs(latestEntry.boundingClientRect.bottom);
-        } else if (latestEntry.boundingClientRect.top < 0) {
-          // Scrolling 'down' and hit the after element above top: 0
-          measurementPos -= latestEntry.boundingClientRect.top;
+    const { itemSize , numItems , virtualizerLength , children: renderChild , getItemSize , bufferItems =Math.round(virtualizerLength / 4.0) , bufferSize =Math.floor(bufferItems / 2.0) * itemSize , scrollViewRef , axis ='vertical' , reversed =false , virtualizerContext , onRenderedFlaggedIndex , imperativeVirtualizerRef  } = props;
+    /* The context is optional, it's useful for injecting additional index logic, or performing uniform state updates*/ const _virtualizerContext = useVirtualizerContextState_unstable(virtualizerContext);
+    const flaggedIndex = useRef(null);
+    const actualIndex = _virtualizerContext.contextIndex;
+    const setActualIndex = _virtualizerContext.setContextIndex;
+    // Store ref to before padding element
+    const beforeElementRef = useRef(null);
+    // Store ref to before padding element
+    const afterElementRef = useRef(null);
+    // We need to store an array to track dynamic sizes, we can use this to incrementally update changes
+    const childSizes = useRef(new Array(getItemSize ? numItems : 0));
+    /* We keep track of the progressive sizing/placement down the list,
+  this helps us skip re-calculations unless children/size changes */ const childProgressiveSizes = useRef(new Array(getItemSize ? numItems : 0));
+    // The internal tracking REF for child array (updates often).
+    const childArray = useRef(new Array(virtualizerLength));
+    // We want to be methodical about updating the render with child reference array
+    const forceUpdate = useReducer(()=>({}), {})[1];
+    const horizontal = axis === 'horizontal';
+    const populateSizeArrays = ()=>{
+        if (!getItemSize) {
+            // Static sizes, never mind!
+            return;
+        }
+        if (numItems !== childSizes.current.length) {
+            childSizes.current = new Array(numItems);
+        }
+        if (numItems !== childProgressiveSizes.current.length) {
+            childProgressiveSizes.current = new Array(numItems);
+        }
+        for(let index = 0; index < numItems; index++){
+            childSizes.current[index] = getItemSize(index);
+            if (index === 0) {
+                childProgressiveSizes.current[index] = childSizes.current[index];
+            } else {
+                childProgressiveSizes.current[index] = childProgressiveSizes.current[index - 1] + childSizes.current[index];
+            }
+        }
+    };
+    const [isScrolling, setIsScrolling] = useState(false);
+    const scrollTimer = useRef();
+    const scrollCounter = useRef(0);
+    const initializeScrollingTimer = ()=>{
+        /*
+     * This can be considered the 'velocity' required to start 'isScrolling'
+     * INIT_SCROLL_FLAG_REQ: Number of renders required to activate isScrolling
+     * INIT_SCROLL_FLAG_DELAY: Amount of time (ms) before current number of renders is reset
+     *  - Maybe we should let users customize these in the future.
+     */ const INIT_SCROLL_FLAG_REQ = 10;
+        const INIT_SCROLL_FLAG_DELAY = 100;
+        scrollCounter.current++;
+        if (scrollCounter.current >= INIT_SCROLL_FLAG_REQ) {
+            setIsScrolling(true);
+        }
+        if (scrollTimer.current) {
+            clearTimeout(scrollTimer.current);
+        }
+        scrollTimer.current = setTimeout(()=>{
+            setIsScrolling(false);
+            scrollCounter.current = 0;
+        }, INIT_SCROLL_FLAG_DELAY);
+    };
+    useEffect(()=>{
+        initializeScrollingTimer();
+    }, [
+        actualIndex
+    ]);
+    const batchUpdateNewIndex = (index)=>{
+        // Local updates
+        updateChildRows(index);
+        updateCurrentItemSizes(index);
+        // State setters
+        setActualIndex(index);
+    };
+    // Observe intersections of virtualized components
+    const { setObserverList  } = useIntersectionObserver((entries, observer)=>{
+        /* Sanity check - do we even need virtualization? */ if (virtualizerLength > numItems) {
+            if (actualIndex !== 0) {
+                batchUpdateNewIndex(0);
+            }
+            // No-op
+            return;
+        }
+        /* IO initiates this function when needed (bookend entering view) */ let measurementPos = 0;
+        let bufferCount = bufferItems;
+        // Grab latest entry that is intersecting
+        const latestEntry = entries.length === 1 ? entries[0] : entries.sort((entry1, entry2)=>entry2.time - entry1.time).find((entry)=>{
+            return entry.intersectionRatio > 0;
+        });
+        if (!latestEntry) {
+            // If we don't find an intersecting area, ignore for now.
+            return;
+        }
+        if (latestEntry.target === afterElementRef.current) {
+            // We need to inverse the buffer count
+            bufferCount = virtualizerLength - bufferItems;
+            measurementPos = reversed ? calculateAfter() : calculateTotalSize() - calculateAfter();
+            if (!horizontal) {
+                if (reversed) {
+                    // Scrolling 'up' and hit the after element below
+                    measurementPos -= Math.abs(latestEntry.boundingClientRect.bottom);
+                } else if (latestEntry.boundingClientRect.top < 0) {
+                    // Scrolling 'down' and hit the after element above top: 0
+                    measurementPos -= latestEntry.boundingClientRect.top;
+                }
+            } else {
+                if (reversed) {
+                    // Scrolling 'left' and hit the after element
+                    measurementPos -= Math.abs(latestEntry.boundingClientRect.right);
+                } else if (latestEntry.boundingClientRect.left < 0) {
+                    // Scrolling 'right' and hit the after element
+                    measurementPos -= latestEntry.boundingClientRect.left;
+                }
+            }
+        } else if (latestEntry.target === beforeElementRef.current) {
+            measurementPos = reversed ? calculateTotalSize() - calculateBefore() : calculateBefore();
+            if (!horizontal) {
+                if (!reversed) {
+                    measurementPos -= Math.abs(latestEntry.boundingClientRect.bottom);
+                } else if (latestEntry.boundingClientRect.top < 0) {
+                    // Scrolling 'down' in reverse order and hit the before element above top: 0
+                    measurementPos -= latestEntry.boundingClientRect.top;
+                }
+            } else {
+                if (!reversed) {
+                    measurementPos -= Math.abs(latestEntry.boundingClientRect.right);
+                } else if (latestEntry.boundingClientRect.left < 0) {
+                    // Scrolling 'left' and hit before element
+                    measurementPos -= latestEntry.boundingClientRect.left;
+                }
+            }
         }
-      } else {
         if (reversed) {
-          // Scrolling 'left' and hit the after element
-          measurementPos -= Math.abs(latestEntry.boundingClientRect.right);
-        } else if (latestEntry.boundingClientRect.left < 0) {
-          // Scrolling 'right' and hit the after element
-          measurementPos -= latestEntry.boundingClientRect.left;
-        }
-      }
-    } else if (latestEntry.target === beforeElementRef.current) {
-      measurementPos = reversed ? calculateTotalSize() - calculateBefore() : calculateBefore();
-      if (!horizontal) {
-        if (!reversed) {
-          measurementPos -= Math.abs(latestEntry.boundingClientRect.bottom);
-        } else if (latestEntry.boundingClientRect.top < 0) {
-          // Scrolling 'down' in reverse order and hit the before element above top: 0
-          measurementPos -= latestEntry.boundingClientRect.top;
-        }
-      } else {
-        if (!reversed) {
-          measurementPos -= Math.abs(latestEntry.boundingClientRect.right);
-        } else if (latestEntry.boundingClientRect.left < 0) {
-          // Scrolling 'left' and hit before element
-          measurementPos -= latestEntry.boundingClientRect.left;
-        }
-      }
-    }
-    if (reversed) {
-      // We're reversed, up is down, left is right, invert the scroll measure.
-      measurementPos = Math.max(calculateTotalSize() - Math.abs(measurementPos), 0);
-    }
-    // For now lets use hardcoded size to assess current element to paginate on
-    const startIndex = getIndexFromScrollPosition(measurementPos);
-    const bufferedIndex = Math.max(startIndex - bufferCount, 0);
-    // Safety limits
-    const maxIndex = Math.max(numItems - virtualizerLength, 0);
-    const newStartIndex = Math.min(Math.max(bufferedIndex, 0), maxIndex);
-    if (actualIndex !== newStartIndex) {
-      // We flush sync this and perform an immediate state update
-      flushSync(() => {
-        batchUpdateNewIndex(newStartIndex);
-      });
-    }
-  }, {
-    root: scrollViewRef ? scrollViewRef === null || scrollViewRef === void 0 ? void 0 : scrollViewRef.current : null,
-    rootMargin: '0px',
-    threshold: 0
-  });
-  const findIndexRecursive = (scrollPos, lowIndex, highIndex) => {
-    if (lowIndex > highIndex) {
-      // We shouldn't get here - but no-op the index if we do.
-      return actualIndex;
-    }
-    const midpoint = Math.floor((lowIndex + highIndex) / 2);
-    const iBefore = Math.max(midpoint - 1, 0);
-    const iAfter = Math.min(midpoint + 1, childProgressiveSizes.current.length - 1);
-    const indexValue = childProgressiveSizes.current[midpoint];
-    const afterIndexValue = childProgressiveSizes.current[iAfter];
-    const beforeIndexValue = childProgressiveSizes.current[iBefore];
-    if (scrollPos <= afterIndexValue && scrollPos >= beforeIndexValue) {
-      /* We've found our index - if we are exactly matching before/after index that's ok,
-      better to reduce checks if it's right on the boundary. */
-      return midpoint;
-    }
-    if (indexValue > scrollPos) {
-      return findIndexRecursive(scrollPos, lowIndex, midpoint - 1);
-    } else {
-      return findIndexRecursive(scrollPos, midpoint + 1, highIndex);
-    }
-  };
-  const getIndexFromSizeArray = scrollPos => {
-    /* Quick searches our progressive height array */if (scrollPos === 0 || childProgressiveSizes.current.length === 0 || scrollPos <= childProgressiveSizes.current[0]) {
-      // Check start
-      return 0;
-    }
-    if (scrollPos >= childProgressiveSizes.current[childProgressiveSizes.current.length - 1]) {
-      // Check end
-      return childProgressiveSizes.current.length - 1;
-    }
-    return findIndexRecursive(scrollPos, 0, childProgressiveSizes.current.length - 1);
-  };
-  const getIndexFromScrollPosition = scrollPos => {
-    if (!getItemSize) {
-      return Math.round(scrollPos / itemSize);
-    }
-    return getIndexFromSizeArray(scrollPos);
-  };
-  const calculateTotalSize = () => {
-    if (!getItemSize) {
-      return itemSize * numItems;
-    }
-    // Time for custom size calcs
-    return childProgressiveSizes.current[numItems - 1];
-  };
-  const calculateBefore = () => {
-    const currentIndex = Math.min(actualIndex, numItems);
-    if (!getItemSize) {
-      // The missing items from before virtualization starts height
-      return currentIndex * itemSize;
-    }
-    if (currentIndex <= 0) {
-      return 0;
-    }
-    // Time for custom size calcs
-    return childProgressiveSizes.current[currentIndex - 1];
-  };
-  const calculateAfter = () => {
-    if (numItems === 0) {
-      return 0;
-    }
-    const lastItemIndex = Math.min(actualIndex + virtualizerLength, numItems - 1);
-    if (!getItemSize) {
-      // The missing items from after virtualization ends height
-      const remainingItems = numItems - lastItemIndex - 1;
-      return remainingItems * itemSize;
-    }
-    // Time for custom size calcs
-    return childProgressiveSizes.current[numItems - 1] - childProgressiveSizes.current[lastItemIndex];
-  };
-  const updateChildRows = useCallback(newIndex => {
-    if (numItems === 0) {
-      /* Nothing to virtualize */return [];
-    }
-    if (childArray.current.length !== numItems) {
-      childArray.current = new Array(virtualizerLength);
-    }
-    const _actualIndex = Math.max(newIndex, 0);
-    const end = Math.min(_actualIndex + virtualizerLength, numItems);
-    for (let i = _actualIndex; i < end; i++) {
-      childArray.current[i - _actualIndex] = renderVirtualizerChildPlaceholder(renderChild(i), i);
-    }
-  }, [numItems, renderChild, virtualizerLength]);
-  const setBeforeRef = useCallback(element => {
-    if (!element || beforeElementRef.current === element) {
-      return;
-    }
-    beforeElementRef.current = element;
-    const newList = [];
-    newList.push(beforeElementRef.current);
-    if (afterElementRef.current) {
-      newList.push(afterElementRef.current);
-    }
-    // Ensure we update array if before element changed
-    setObserverList(newList);
-  }, [setObserverList]);
-  const setAfterRef = useCallback(element => {
-    if (!element || afterElementRef.current === element) {
-      return;
-    }
-    afterElementRef.current = element;
-    const newList = [];
-    if (beforeElementRef.current) {
-      newList.push(beforeElementRef.current);
-    }
-    newList.push(afterElementRef.current);
-    // Ensure we update array if after element changed
-    setObserverList(newList);
-  }, [setObserverList]);
-  const updateCurrentItemSizes = newIndex => {
-    if (!getItemSize) {
-      // Static sizes, not required.
-      return;
-    }
-    // We should always call our size function on index change (only for the items that will be rendered)
-    // This ensures we request the latest data for incoming items in case sizing has changed.
-    const endIndex = Math.min(newIndex + virtualizerLength, numItems);
-    const startIndex = Math.max(newIndex, 0);
-    let didUpdate = false;
-    for (let i = startIndex; i < endIndex; i++) {
-      const newSize = getItemSize(i);
-      if (newSize !== childSizes.current[i]) {
-        childSizes.current[i] = newSize;
-        didUpdate = true;
-      }
-    }
-    if (didUpdate) {
-      // Update our progressive size array
-      for (let i = startIndex; i < numItems; i++) {
-        const prevSize = i > 0 ? childProgressiveSizes.current[i - 1] : 0;
-        childProgressiveSizes.current[i] = prevSize + childSizes.current[i];
-      }
-    }
-  };
-  // Initialize the size array before first render.
-  const hasInitialized = useRef(false);
-  const initializeSizeArray = () => {
-    if (hasInitialized.current === false) {
-      hasInitialized.current = true;
-      populateSizeArrays();
-    }
-  };
-  // Initialization on mount - update array index to 0 (ready state).
-  // Only fire on mount (no deps).
-  useEffect(() => {
-    if (actualIndex < 0) {
-      batchUpdateNewIndex(0);
-    }
+            // We're reversed, up is down, left is right, invert the scroll measure.
+            measurementPos = Math.max(calculateTotalSize() - Math.abs(measurementPos), 0);
+        }
+        // For now lets use hardcoded size to assess current element to paginate on
+        const startIndex = getIndexFromScrollPosition(measurementPos);
+        const bufferedIndex = Math.max(startIndex - bufferCount, 0);
+        // Safety limits
+        const maxIndex = Math.max(numItems - virtualizerLength, 0);
+        const newStartIndex = Math.min(Math.max(bufferedIndex, 0), maxIndex);
+        if (actualIndex !== newStartIndex) {
+            // We flush sync this and perform an immediate state update
+            flushSync(()=>{
+                batchUpdateNewIndex(newStartIndex);
+            });
+        }
+    }, {
+        root: scrollViewRef ? scrollViewRef === null || scrollViewRef === void 0 ? void 0 : scrollViewRef.current : null,
+        rootMargin: '0px',
+        threshold: 0
+    });
+    const findIndexRecursive = (scrollPos, lowIndex, highIndex)=>{
+        if (lowIndex > highIndex) {
+            // We shouldn't get here - but no-op the index if we do.
+            return actualIndex;
+        }
+        const midpoint = Math.floor((lowIndex + highIndex) / 2);
+        const iBefore = Math.max(midpoint - 1, 0);
+        const iAfter = Math.min(midpoint + 1, childProgressiveSizes.current.length - 1);
+        const indexValue = childProgressiveSizes.current[midpoint];
+        const afterIndexValue = childProgressiveSizes.current[iAfter];
+        const beforeIndexValue = childProgressiveSizes.current[iBefore];
+        if (scrollPos <= afterIndexValue && scrollPos >= beforeIndexValue) {
+            /* We've found our index - if we are exactly matching before/after index that's ok,
+      better to reduce checks if it's right on the boundary. */ return midpoint;
+        }
+        if (indexValue > scrollPos) {
+            return findIndexRecursive(scrollPos, lowIndex, midpoint - 1);
+        } else {
+            return findIndexRecursive(scrollPos, midpoint + 1, highIndex);
+        }
+    };
+    const getIndexFromSizeArray = (scrollPos)=>{
+        /* Quick searches our progressive height array */ if (scrollPos === 0 || childProgressiveSizes.current.length === 0 || scrollPos <= childProgressiveSizes.current[0]) {
+            // Check start
+            return 0;
+        }
+        if (scrollPos >= childProgressiveSizes.current[childProgressiveSizes.current.length - 1]) {
+            // Check end
+            return childProgressiveSizes.current.length - 1;
+        }
+        return findIndexRecursive(scrollPos, 0, childProgressiveSizes.current.length - 1);
+    };
+    const getIndexFromScrollPosition = (scrollPos)=>{
+        if (!getItemSize) {
+            return Math.round(scrollPos / itemSize);
+        }
+        return getIndexFromSizeArray(scrollPos);
+    };
+    const calculateTotalSize = useCallback(()=>{
+        if (!getItemSize) {
+            return itemSize * numItems;
+        }
+        // Time for custom size calcs
+        return childProgressiveSizes.current[numItems - 1];
+    }, [
+        getItemSize,
+        itemSize,
+        numItems
+    ]);
+    const calculateBefore = useCallback(()=>{
+        const currentIndex = Math.min(actualIndex, numItems);
+        if (!getItemSize) {
+            // The missing items from before virtualization starts height
+            return currentIndex * itemSize;
+        }
+        if (currentIndex <= 0) {
+            return 0;
+        }
+        // Time for custom size calcs
+        return childProgressiveSizes.current[currentIndex - 1];
+    }, [
+        actualIndex,
+        getItemSize,
+        itemSize,
+        numItems
+    ]);
+    const calculateAfter = useCallback(()=>{
+        if (numItems === 0) {
+            return 0;
+        }
+        const lastItemIndex = Math.min(actualIndex + virtualizerLength, numItems - 1);
+        if (!getItemSize) {
+            // The missing items from after virtualization ends height
+            const remainingItems = numItems - lastItemIndex - 1;
+            return remainingItems * itemSize;
+        }
+        // Time for custom size calcs
+        return childProgressiveSizes.current[numItems - 1] - childProgressiveSizes.current[lastItemIndex];
+    }, [
+        actualIndex,
+        getItemSize,
+        itemSize,
+        numItems,
+        virtualizerLength
+    ]);
+    const updateChildRows = useCallback((newIndex)=>{
+        if (numItems === 0) {
+            /* Nothing to virtualize */ return;
+        }
+        /*
+        We reset the array every time to ensure children are re-rendered
+        This function should only be called when update is nessecary
+       */ childArray.current = new Array(virtualizerLength);
+        const _actualIndex = Math.max(newIndex, 0);
+        const end = Math.min(_actualIndex + virtualizerLength, numItems);
+        for(let i = _actualIndex; i < end; i++){
+            childArray.current[i - _actualIndex] = renderVirtualizerChildPlaceholder(renderChild(i, isScrolling), i);
+        }
+    }, [
+        isScrolling,
+        numItems,
+        renderChild,
+        virtualizerLength
+    ]);
+    const setBeforeRef = useCallback((element)=>{
+        if (!element || beforeElementRef.current === element) {
+            return;
+        }
+        beforeElementRef.current = element;
+        const newList = [];
+        newList.push(beforeElementRef.current);
+        if (afterElementRef.current) {
+            newList.push(afterElementRef.current);
+        }
+        // Ensure we update array if before element changed
+        setObserverList(newList);
+    }, [
+        setObserverList
+    ]);
+    const setAfterRef = useCallback((element)=>{
+        if (!element || afterElementRef.current === element) {
+            return;
+        }
+        afterElementRef.current = element;
+        const newList = [];
+        if (beforeElementRef.current) {
+            newList.push(beforeElementRef.current);
+        }
+        newList.push(afterElementRef.current);
+        // Ensure we update array if after element changed
+        setObserverList(newList);
+    }, [
+        setObserverList
+    ]);
+    const updateCurrentItemSizes = (newIndex)=>{
+        if (!getItemSize) {
+            // Static sizes, not required.
+            return;
+        }
+        // We should always call our size function on index change (only for the items that will be rendered)
+        // This ensures we request the latest data for incoming items in case sizing has changed.
+        const endIndex = Math.min(newIndex + virtualizerLength, numItems);
+        const startIndex = Math.max(newIndex, 0);
+        let didUpdate = false;
+        for(let i = startIndex; i < endIndex; i++){
+            const newSize = getItemSize(i);
+            if (newSize !== childSizes.current[i]) {
+                childSizes.current[i] = newSize;
+                didUpdate = true;
+            }
+        }
+        if (didUpdate) {
+            // Update our progressive size array
+            for(let i = startIndex; i < numItems; i++){
+                const prevSize = i > 0 ? childProgressiveSizes.current[i - 1] : 0;
+                childProgressiveSizes.current[i] = prevSize + childSizes.current[i];
+            }
+        }
+    };
+    // Initialize the size array before first render.
+    const hasInitialized = useRef(false);
+    const initializeSizeArray = ()=>{
+        if (hasInitialized.current === false) {
+            hasInitialized.current = true;
+            populateSizeArrays();
+        }
+    };
+    useImperativeHandle(imperativeVirtualizerRef, ()=>{
+        return {
+            progressiveSizes: childProgressiveSizes,
+            nodeSizes: childSizes,
+            setFlaggedIndex: (index)=>flaggedIndex.current = index
+        };
+    }, [
+        childProgressiveSizes,
+        childSizes
+    ]);
+    // Initialization on mount - update array index to 0 (ready state).
+    // Only fire on mount (no deps).
+    useEffect(()=>{
+        if (actualIndex < 0) {
+            batchUpdateNewIndex(0);
+        }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-  // If the user passes in an updated renderChild function - update current children
-  useEffect(() => {
-    if (actualIndex >= 0) {
-      updateChildRows(actualIndex);
-      forceUpdate();
-    }
+    }, []);
+    // If the user passes in an updated renderChild function - update current children
+    useEffect(()=>{
+        if (actualIndex >= 0) {
+            updateChildRows(actualIndex);
+            forceUpdate();
+        }
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [renderChild, updateChildRows]);
-  useEffect(() => {
-    // Ensure we repopulate if getItemSize callback changes
-    populateSizeArrays();
+    }, [
+        renderChild,
+        updateChildRows
+    ]);
+    useEffect(()=>{
+        // Ensure we repopulate if getItemSize callback changes
+        populateSizeArrays();
     // We only run this effect on getItemSize change (recalc dynamic sizes)
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [getItemSize]);
-  // Ensure we have run through and updated the whole size list array at least once.
-  initializeSizeArray();
-  if (getItemSize && (numItems !== childSizes.current.length || numItems !== childProgressiveSizes.current.length)) {
-    // Child length mismatch, repopulate size arrays.
-    populateSizeArrays();
-  }
-  // Ensure we recalc if virtualizer length changes
-  const maxCompare = Math.min(virtualizerLength, numItems);
-  if (childArray.current.length !== maxCompare && actualIndex + childArray.current.length < numItems) {
-    updateChildRows(actualIndex);
-  }
-  const isFullyInitialized = hasInitialized.current && actualIndex >= 0;
-  return {
-    components: {
-      before: 'div',
-      after: 'div',
-      beforeContainer: 'div',
-      afterContainer: 'div'
-    },
-    virtualizedChildren: childArray.current,
-    before: resolveShorthand(props.before, {
-      required: true,
-      defaultProps: {
-        ref: setBeforeRef,
-        role: 'none'
-      }
-    }),
-    after: resolveShorthand(props.after, {
-      required: true,
-      defaultProps: {
-        ref: setAfterRef,
-        role: 'none'
-      }
-    }),
-    beforeContainer: resolveShorthand(props.beforeContainer, {
-      required: true,
-      defaultProps: {
-        role: 'none'
-      }
-    }),
-    afterContainer: resolveShorthand(props.afterContainer, {
-      required: true,
-      defaultProps: {
-        role: 'none'
-      }
-    }),
-    beforeBufferHeight: isFullyInitialized ? calculateBefore() : 0,
-    afterBufferHeight: isFullyInitialized ? calculateAfter() : 0,
-    totalVirtualizerHeight: isFullyInitialized ? calculateTotalSize() : virtualizerLength * itemSize,
-    virtualizerStartIndex: actualIndex,
-    axis,
-    bufferSize,
-    reversed
-  };
+    }, [
+        getItemSize
+    ]);
+    // Effect to check flag index on updates
+    useEffect(()=>{
+        if (!onRenderedFlaggedIndex || flaggedIndex.current === null) {
+            return;
+        }
+        if (actualIndex <= flaggedIndex.current && actualIndex + virtualizerLength >= flaggedIndex.current) {
+            onRenderedFlaggedIndex(flaggedIndex.current);
+            flaggedIndex.current = null;
+        }
+    }, [
+        actualIndex,
+        onRenderedFlaggedIndex,
+        virtualizerLength
+    ]);
+    // Ensure we have run through and updated the whole size list array at least once.
+    initializeSizeArray();
+    if (getItemSize && (numItems !== childSizes.current.length || numItems !== childProgressiveSizes.current.length)) {
+        // Child length mismatch, repopulate size arrays.
+        populateSizeArrays();
+    }
+    // Ensure we recalc if virtualizer length changes
+    const maxCompare = Math.min(virtualizerLength, numItems);
+    if (childArray.current.length !== maxCompare && actualIndex + childArray.current.length < numItems) {
+        updateChildRows(actualIndex);
+    }
+    const isFullyInitialized = hasInitialized.current && actualIndex >= 0;
+    return {
+        components: {
+            before: 'div',
+            after: 'div',
+            beforeContainer: 'div',
+            afterContainer: 'div'
+        },
+        virtualizedChildren: childArray.current,
+        before: resolveShorthand(props.before, {
+            required: true,
+            defaultProps: {
+                ref: setBeforeRef,
+                role: 'none'
+            }
+        }),
+        after: resolveShorthand(props.after, {
+            required: true,
+            defaultProps: {
+                ref: setAfterRef,
+                role: 'none'
+            }
+        }),
+        beforeContainer: resolveShorthand(props.beforeContainer, {
+            required: true,
+            defaultProps: {
+                role: 'none'
+            }
+        }),
+        afterContainer: resolveShorthand(props.afterContainer, {
+            required: true,
+            defaultProps: {
+                role: 'none'
+            }
+        }),
+        beforeBufferHeight: isFullyInitialized ? calculateBefore() : 0,
+        afterBufferHeight: isFullyInitialized ? calculateAfter() : 0,
+        totalVirtualizerHeight: isFullyInitialized ? calculateTotalSize() : virtualizerLength * itemSize,
+        virtualizerStartIndex: actualIndex,
+        axis,
+        bufferSize,
+        reversed
+    };
 }
-//# sourceMappingURL=useVirtualizer.js.map