@legendapp/list 2.0.0-next.15 → 2.0.0-next.17

package/animated.d.mts

@@ -69,6 +69,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/animated.d.ts

@@ -69,6 +69,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/index.d.mts

@@ -243,6 +243,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
     stickyIndices?: number[];
     getItemType?: (item: ItemT, index: number) => TItemType;
     getFixedItemSize?: (index: number, item: ItemT, type: TItemType) => number;
+    itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 };
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -339,6 +340,7 @@ interface InternalState {
     activeStickyIndex: number | undefined;
     stickyContainers: Map<number, number>;
     stickyContainerPool: Set<number>;
+    scrollProcessingEnabled: boolean;
     props: {
         alignItemsAtEnd: boolean;
         data: readonly any[];
@@ -374,6 +376,7 @@ interface InternalState {
         snapToIndices: number[] | undefined;
         stickyIndicesSet: Set<number>;
         stickyIndicesArr: number[];
+        itemsAreEqual: LegendListProps["itemsAreEqual"];
     };
 }
 interface ViewableRange<T> {
@@ -500,6 +503,11 @@ type LegendListRef = {
      * @param animated - If true, uses Animated to animate the change.
      */
     setVisibleContentAnchorOffset(value: number | ((value: number) => number)): void;
+    /**
+     * Sets whether scroll processing is enabled.
+     * @param enabled - If true, scroll processing is enabled.
+     */
+    setScrollProcessingEnabled(enabled: boolean): void;
 };
 interface ViewToken<ItemT = any> {
     item: ItemT;
@@ -649,6 +657,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: ColumnWrapperStyle;
@@ -715,6 +724,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React$1.Ref<LegendListRef>;
 }) => React$1.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -783,6 +793,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode>(props: LazyLegendListProps<ItemT, ListT> & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -851,6 +862,7 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare function useViewability(callback: ViewabilityCallback, configId?: string): void;

package/index.d.ts

@@ -243,6 +243,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
     stickyIndices?: number[];
     getItemType?: (item: ItemT, index: number) => TItemType;
     getFixedItemSize?: (index: number, item: ItemT, type: TItemType) => number;
+    itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 };
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -339,6 +340,7 @@ interface InternalState {
     activeStickyIndex: number | undefined;
     stickyContainers: Map<number, number>;
     stickyContainerPool: Set<number>;
+    scrollProcessingEnabled: boolean;
     props: {
         alignItemsAtEnd: boolean;
         data: readonly any[];
@@ -374,6 +376,7 @@ interface InternalState {
         snapToIndices: number[] | undefined;
         stickyIndicesSet: Set<number>;
         stickyIndicesArr: number[];
+        itemsAreEqual: LegendListProps["itemsAreEqual"];
     };
 }
 interface ViewableRange<T> {
@@ -500,6 +503,11 @@ type LegendListRef = {
      * @param animated - If true, uses Animated to animate the change.
      */
     setVisibleContentAnchorOffset(value: number | ((value: number) => number)): void;
+    /**
+     * Sets whether scroll processing is enabled.
+     * @param enabled - If true, scroll processing is enabled.
+     */
+    setScrollProcessingEnabled(enabled: boolean): void;
 };
 interface ViewToken<ItemT = any> {
     item: ItemT;
@@ -649,6 +657,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: ColumnWrapperStyle;
@@ -715,6 +724,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React$1.Ref<LegendListRef>;
 }) => React$1.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -783,6 +793,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode>(props: LazyLegendListProps<ItemT, ListT> & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -851,6 +862,7 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare function useViewability(callback: ViewabilityCallback, configId?: string): void;

package/index.js

@@ -298,7 +298,6 @@ var PositionViewSticky = typedMemo(function PositionViewSticky2({
       return horizontal ? [{ translateX: stickyPosition }] : [{ translateY: stickyPosition }];
     }
   }, [position, horizontal, animatedScrollY, stickyOffset]);
-  console.log("index", index, position, transform);
   const viewStyle = React3__namespace.useMemo(() => [style, { zIndex: index + 1e3 }, { transform }], [style, transform]);
   return /* @__PURE__ */ React3__namespace.createElement(reactNative.Animated.View, { ref: refView, style: viewStyle, ...rest });
 });
@@ -1188,11 +1187,6 @@ function updateAllPositions(ctx, state, dataChanged) {
   const numColumns = peek$(ctx, "numColumns");
   const indexByKeyForChecking = __DEV__ ? /* @__PURE__ */ new Map() : void 0;
   const scrollVelocity = getScrollVelocity(state);
-  if (dataChanged) {
-    indexByKey.clear();
-    idCache.clear();
-    positions.clear();
-  }
   const useAverageSize = false;
   const itemType = "";
   let averageSize = (_a = averageSizes[itemType]) == null ? void 0 : _a.avg;
@@ -1708,9 +1702,11 @@ function setDidLayout(ctx, state) {
 // src/core/calculateItemsInView.ts
 function findCurrentStickyIndex(stickyArray, scroll, state) {
   var _a;
+  const idCache = state.idCache;
+  const positions = state.positions;
   for (let i = stickyArray.length - 1; i >= 0; i--) {
-    const stickyId = (_a = state.idCache.get(stickyArray[i])) != null ? _a : getId(state, stickyArray[i]);
-    const stickyPos = stickyId ? state.positions.get(stickyId) : void 0;
+    const stickyId = (_a = idCache.get(stickyArray[i])) != null ? _a : getId(state, stickyArray[i]);
+    const stickyPos = stickyId ? positions.get(stickyId) : void 0;
     if (stickyPos !== void 0 && scroll >= stickyPos) {
       return i;
     }
@@ -1770,17 +1766,19 @@ function calculateItemsInView(ctx, state, params = {}) {
   reactNative.unstable_batchedUpdates(() => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     const {
-      scrollLength,
-      startBufferedId: startBufferedIdOrig,
-      positions,
       columns,
       containerItemKeys,
+      enableScrollForNextCalculateItemsInView,
       idCache,
-      sizes,
       indexByKey,
+      minIndexSizeChanged,
+      positions,
       scrollForNextCalculateItemsInView,
-      enableScrollForNextCalculateItemsInView,
-      minIndexSizeChanged
+      scrollLength,
+      sizes,
+      startBufferedId: startBufferedIdOrig,
+      viewabilityConfigCallbackPairs,
+      props: { getItemType, initialScroll, itemsAreEqual, keyExtractor, scrollBuffer }
     } = state;
     const { data, stickyIndicesArr, stickyIndicesSet } = state.props;
     const prevNumContainers = peek$(ctx, "numContainers");
@@ -1795,13 +1793,17 @@ function calculateItemsInView(ctx, state, params = {}) {
     const speed = getScrollVelocity(state);
     if (doMVCP || dataChanged) {
       const checkMVCP = doMVCP ? prepareMVCP(ctx, state, dataChanged) : void 0;
+      if (dataChanged) {
+        indexByKey.clear();
+        idCache.clear();
+        positions.clear();
+      }
       updateAllPositions(ctx, state, dataChanged);
       checkMVCP == null ? void 0 : checkMVCP();
     }
     const scrollExtra = 0;
     const { queuedInitialLayout } = state;
     let { scroll: scrollState } = state;
-    const initialScroll = state.props.initialScroll;
     if (!queuedInitialLayout && initialScroll) {
       const updatedOffset = calculateOffsetWithOffsetPosition(
         state,
@@ -1813,13 +1815,12 @@ function calculateItemsInView(ctx, state, params = {}) {
     const scrollAdjustPad = -previousScrollAdjust - topPad;
     let scroll = scrollState + scrollExtra + scrollAdjustPad;
     if (scroll + scrollLength > totalSize) {
-      scroll = totalSize - scrollLength;
+      scroll = Math.max(0, totalSize - scrollLength);
     }
     if (ENABLE_DEBUG_VIEW) {
       set$(ctx, "debugRawScroll", scrollState);
       set$(ctx, "debugComputedScroll", scroll);
     }
-    const scrollBuffer = state.props.scrollBuffer;
     let scrollBufferTop = scrollBuffer;
     let scrollBufferBottom = scrollBuffer;
     if (speed > 0) {
@@ -1830,7 +1831,7 @@ function calculateItemsInView(ctx, state, params = {}) {
       scrollBufferBottom = scrollBuffer * 0.5;
     }
     const scrollTopBuffered = scroll - scrollBufferTop;
-    const scrollBottom = scroll + scrollLength;
+    const scrollBottom = scroll + scrollLength + (scroll < 0 ? -scroll : 0);
     const scrollBottomBuffered = scrollBottom + scrollBufferBottom;
     if (scrollForNextCalculateItemsInView) {
       const { top, bottom } = scrollForNextCalculateItemsInView;
@@ -1930,7 +1931,7 @@ function calculateItemsInView(ctx, state, params = {}) {
     if (dataChanged) {
       for (let i = 0; i < numContainers; i++) {
         const itemKey = peek$(ctx, `containerItemKey${i}`);
-        if (!state.props.keyExtractor || itemKey && indexByKey.get(itemKey) === void 0) {
+        if (!keyExtractor || itemKey && indexByKey.get(itemKey) === void 0) {
           pendingRemoval.push(i);
         }
       }
@@ -1945,11 +1946,20 @@ function calculateItemsInView(ctx, state, params = {}) {
         }
       }
       if (stickyIndicesArr.length > 0) {
-        handleStickyActivation(ctx, state, stickyIndicesSet, stickyIndicesArr, scroll, needNewContainers, startBuffered, endBuffered);
+        handleStickyActivation(
+          ctx,
+          state,
+          stickyIndicesSet,
+          stickyIndicesArr,
+          scroll,
+          needNewContainers,
+          startBuffered,
+          endBuffered
+        );
       }
       if (needNewContainers.length > 0) {
-        const requiredItemTypes = state.props.getItemType ? needNewContainers.map((i) => {
-          const itemType = state.props.getItemType(data[i], i);
+        const requiredItemTypes = getItemType ? needNewContainers.map((i) => {
+          const itemType = getItemType(data[i], i);
           return itemType ? String(itemType) : "";
         }) : void 0;
         const availableContainers = findAvailableContainers(
@@ -2034,7 +2044,7 @@ function calculateItemsInView(ctx, state, params = {}) {
             if (column >= 0 && column !== prevColumn) {
               set$(ctx, `containerColumn${i}`, column);
             }
-            if (prevData !== item) {
+            if (prevData !== item && (itemsAreEqual ? !itemsAreEqual(prevData, item, itemIndex, data) : true)) {
               set$(ctx, `containerItemData${i}`, data[itemIndex]);
             }
           }
@@ -2046,15 +2056,8 @@ function calculateItemsInView(ctx, state, params = {}) {
         setDidLayout(ctx, state);
       }
     }
-    if (state.viewabilityConfigCallbackPairs) {
-      updateViewableItems(
-        state,
-        ctx,
-        state.viewabilityConfigCallbackPairs,
-        scrollLength,
-        startNoBuffer,
-        endNoBuffer
-      );
+    if (viewabilityConfigCallbackPairs) {
+      updateViewableItems(state, ctx, viewabilityConfigCallbackPairs, scrollLength, startNoBuffer, endNoBuffer);
     }
   });
 }
@@ -2191,6 +2194,9 @@ function handleLayout(ctx, state, layout, setCanRender) {
 // src/core/onScroll.ts
 function onScroll(ctx, state, event) {
   var _a, _b, _c, _d, _e;
+  if (!state.scrollProcessingEnabled) {
+    return;
+  }
   if (((_b = (_a = event.nativeEvent) == null ? void 0 : _a.contentSize) == null ? void 0 : _b.height) === 0 && ((_c = event.nativeEvent.contentSize) == null ? void 0 : _c.width) === 0) {
     return;
   }
@@ -2359,7 +2365,8 @@ function updateItemSize(ctx, state, itemKey, sizeObj) {
     }
   }
   const containersDidLayout = peek$(ctx, "containersDidLayout");
-  if (!containersDidLayout || !queuedItemSizeUpdatesWaiting) {
+  const speed = getScrollVelocity(state);
+  if (!containersDidLayout || !queuedItemSizeUpdatesWaiting || Math.abs(speed) < 1) {
     updateItemSizes(ctx, state, [{ itemKey, sizeObj }]);
     if (containersDidLayout) {
       state.queuedItemSizeUpdatesWaiting = true;
@@ -2453,11 +2460,63 @@ function getRenderedItem(ctx, state, key) {
       item: data[index],
       type: getItemType ? (_a = getItemType(data[index], index)) != null ? _a : "" : ""
     };
-    renderedItem = React3__namespace.default.createElement(renderItem2, itemProps);
+    renderedItem = isFunction(renderItem2) ? renderItem2(itemProps) : React3__namespace.default.createElement(renderItem2, itemProps);
   }
   return { index, item: data[index], renderedItem };
 }
 
+// src/utils/updateAveragesOnDataChange.ts
+function updateAveragesOnDataChange(state, oldData, newData) {
+  var _a;
+  const {
+    averageSizes,
+    sizesKnown,
+    indexByKey,
+    props: { itemsAreEqual, getItemType, keyExtractor }
+  } = state;
+  if (!itemsAreEqual || !oldData.length || !newData.length) {
+    for (const key in averageSizes) {
+      delete averageSizes[key];
+    }
+    return;
+  }
+  const itemTypesToPreserve = {};
+  const newDataLength = newData.length;
+  const oldDataLength = oldData.length;
+  for (let newIndex = 0; newIndex < newDataLength; newIndex++) {
+    const newItem = newData[newIndex];
+    const id = keyExtractor ? keyExtractor(newItem, newIndex) : String(newIndex);
+    const oldIndex = indexByKey.get(id);
+    if (oldIndex !== void 0 && oldIndex < oldDataLength) {
+      const knownSize = sizesKnown.get(id);
+      if (knownSize === void 0) continue;
+      const oldItem = oldData[oldIndex];
+      const areEqual = itemsAreEqual(oldItem, newItem, newIndex, newData);
+      if (areEqual) {
+        const itemType = getItemType ? (_a = getItemType(newItem, newIndex)) != null ? _a : "" : "";
+        let typeData = itemTypesToPreserve[itemType];
+        if (!typeData) {
+          typeData = itemTypesToPreserve[itemType] = { count: 0, totalSize: 0 };
+        }
+        typeData.totalSize += knownSize;
+        typeData.count++;
+      }
+    }
+  }
+  for (const key in averageSizes) {
+    delete averageSizes[key];
+  }
+  for (const itemType in itemTypesToPreserve) {
+    const { totalSize, count } = itemTypesToPreserve[itemType];
+    if (count > 0) {
+      averageSizes[itemType] = {
+        avg: totalSize / count,
+        num: count
+      };
+    }
+  }
+}
+
 // src/components/LegendList.tsx
 var DEFAULT_DRAW_DISTANCE = 250;
 var DEFAULT_ITEM_SIZE = 100;
@@ -2482,6 +2541,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     initialContainerPoolRatio = 2,
     initialScrollIndex: initialScrollIndexProp,
     initialScrollOffset,
+    itemsAreEqual,
     keyExtractor: keyExtractorProp,
     ListEmptyComponent,
     ListHeaderComponent,
@@ -2571,6 +2631,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       scrollPending: 0,
       scrollPrev: 0,
       scrollPrevTime: 0,
+      scrollProcessingEnabled: true,
       scrollTime: 0,
       sizes: /* @__PURE__ */ new Map(),
       sizesKnown: /* @__PURE__ */ new Map(),
@@ -2600,6 +2661,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     horizontal: !!horizontal,
     initialContainerPoolRatio,
     initialScroll,
+    itemsAreEqual,
     keyExtractor,
     maintainScrollAtEnd,
     maintainScrollAtEndThreshold,
@@ -2626,6 +2688,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   const checkResetContainers = (isFirst2) => {
     const state2 = refState.current;
     if (state2) {
+      if (!isFirst2 && state2.props.data !== dataProp) {
+        updateAveragesOnDataChange(state2, state2.props.data, dataProp);
+      }
       state2.props.data = dataProp;
       if (!isFirst2) {
         calculateItemsInView(ctx, state2, { dataChanged: true, doMVCP: true });
@@ -2833,6 +2898,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         }
       },
       scrollToOffset: (params) => scrollTo(state, params),
+      setScrollProcessingEnabled: (enabled) => {
+        refState.current.scrollProcessingEnabled = enabled;
+      },
       setVisibleContentAnchorOffset: (value) => {
         const val = typeof value === "function" ? value(peek$(ctx, "scrollAdjustUserOffset") || 0) : value;
         set$(ctx, "scrollAdjustUserOffset", val);

package/index.mjs

@@ -277,7 +277,6 @@ var PositionViewSticky = typedMemo(function PositionViewSticky2({
       return horizontal ? [{ translateX: stickyPosition }] : [{ translateY: stickyPosition }];
     }
   }, [position, horizontal, animatedScrollY, stickyOffset]);
-  console.log("index", index, position, transform);
   const viewStyle = React3.useMemo(() => [style, { zIndex: index + 1e3 }, { transform }], [style, transform]);
   return /* @__PURE__ */ React3.createElement(Animated.View, { ref: refView, style: viewStyle, ...rest });
 });
@@ -1167,11 +1166,6 @@ function updateAllPositions(ctx, state, dataChanged) {
   const numColumns = peek$(ctx, "numColumns");
   const indexByKeyForChecking = __DEV__ ? /* @__PURE__ */ new Map() : void 0;
   const scrollVelocity = getScrollVelocity(state);
-  if (dataChanged) {
-    indexByKey.clear();
-    idCache.clear();
-    positions.clear();
-  }
   const useAverageSize = false;
   const itemType = "";
   let averageSize = (_a = averageSizes[itemType]) == null ? void 0 : _a.avg;
@@ -1687,9 +1681,11 @@ function setDidLayout(ctx, state) {
 // src/core/calculateItemsInView.ts
 function findCurrentStickyIndex(stickyArray, scroll, state) {
   var _a;
+  const idCache = state.idCache;
+  const positions = state.positions;
   for (let i = stickyArray.length - 1; i >= 0; i--) {
-    const stickyId = (_a = state.idCache.get(stickyArray[i])) != null ? _a : getId(state, stickyArray[i]);
-    const stickyPos = stickyId ? state.positions.get(stickyId) : void 0;
+    const stickyId = (_a = idCache.get(stickyArray[i])) != null ? _a : getId(state, stickyArray[i]);
+    const stickyPos = stickyId ? positions.get(stickyId) : void 0;
     if (stickyPos !== void 0 && scroll >= stickyPos) {
       return i;
     }
@@ -1749,17 +1745,19 @@ function calculateItemsInView(ctx, state, params = {}) {
   unstable_batchedUpdates(() => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     const {
-      scrollLength,
-      startBufferedId: startBufferedIdOrig,
-      positions,
       columns,
       containerItemKeys,
+      enableScrollForNextCalculateItemsInView,
       idCache,
-      sizes,
       indexByKey,
+      minIndexSizeChanged,
+      positions,
       scrollForNextCalculateItemsInView,
-      enableScrollForNextCalculateItemsInView,
-      minIndexSizeChanged
+      scrollLength,
+      sizes,
+      startBufferedId: startBufferedIdOrig,
+      viewabilityConfigCallbackPairs,
+      props: { getItemType, initialScroll, itemsAreEqual, keyExtractor, scrollBuffer }
     } = state;
     const { data, stickyIndicesArr, stickyIndicesSet } = state.props;
     const prevNumContainers = peek$(ctx, "numContainers");
@@ -1774,13 +1772,17 @@ function calculateItemsInView(ctx, state, params = {}) {
     const speed = getScrollVelocity(state);
     if (doMVCP || dataChanged) {
       const checkMVCP = doMVCP ? prepareMVCP(ctx, state, dataChanged) : void 0;
+      if (dataChanged) {
+        indexByKey.clear();
+        idCache.clear();
+        positions.clear();
+      }
       updateAllPositions(ctx, state, dataChanged);
       checkMVCP == null ? void 0 : checkMVCP();
     }
     const scrollExtra = 0;
     const { queuedInitialLayout } = state;
     let { scroll: scrollState } = state;
-    const initialScroll = state.props.initialScroll;
     if (!queuedInitialLayout && initialScroll) {
       const updatedOffset = calculateOffsetWithOffsetPosition(
         state,
@@ -1792,13 +1794,12 @@ function calculateItemsInView(ctx, state, params = {}) {
     const scrollAdjustPad = -previousScrollAdjust - topPad;
     let scroll = scrollState + scrollExtra + scrollAdjustPad;
     if (scroll + scrollLength > totalSize) {
-      scroll = totalSize - scrollLength;
+      scroll = Math.max(0, totalSize - scrollLength);
     }
     if (ENABLE_DEBUG_VIEW) {
       set$(ctx, "debugRawScroll", scrollState);
       set$(ctx, "debugComputedScroll", scroll);
     }
-    const scrollBuffer = state.props.scrollBuffer;
     let scrollBufferTop = scrollBuffer;
     let scrollBufferBottom = scrollBuffer;
     if (speed > 0) {
@@ -1809,7 +1810,7 @@ function calculateItemsInView(ctx, state, params = {}) {
       scrollBufferBottom = scrollBuffer * 0.5;
     }
     const scrollTopBuffered = scroll - scrollBufferTop;
-    const scrollBottom = scroll + scrollLength;
+    const scrollBottom = scroll + scrollLength + (scroll < 0 ? -scroll : 0);
     const scrollBottomBuffered = scrollBottom + scrollBufferBottom;
     if (scrollForNextCalculateItemsInView) {
       const { top, bottom } = scrollForNextCalculateItemsInView;
@@ -1909,7 +1910,7 @@ function calculateItemsInView(ctx, state, params = {}) {
     if (dataChanged) {
       for (let i = 0; i < numContainers; i++) {
         const itemKey = peek$(ctx, `containerItemKey${i}`);
-        if (!state.props.keyExtractor || itemKey && indexByKey.get(itemKey) === void 0) {
+        if (!keyExtractor || itemKey && indexByKey.get(itemKey) === void 0) {
           pendingRemoval.push(i);
         }
       }
@@ -1924,11 +1925,20 @@ function calculateItemsInView(ctx, state, params = {}) {
         }
       }
       if (stickyIndicesArr.length > 0) {
-        handleStickyActivation(ctx, state, stickyIndicesSet, stickyIndicesArr, scroll, needNewContainers, startBuffered, endBuffered);
+        handleStickyActivation(
+          ctx,
+          state,
+          stickyIndicesSet,
+          stickyIndicesArr,
+          scroll,
+          needNewContainers,
+          startBuffered,
+          endBuffered
+        );
       }
       if (needNewContainers.length > 0) {
-        const requiredItemTypes = state.props.getItemType ? needNewContainers.map((i) => {
-          const itemType = state.props.getItemType(data[i], i);
+        const requiredItemTypes = getItemType ? needNewContainers.map((i) => {
+          const itemType = getItemType(data[i], i);
           return itemType ? String(itemType) : "";
         }) : void 0;
         const availableContainers = findAvailableContainers(
@@ -2013,7 +2023,7 @@ function calculateItemsInView(ctx, state, params = {}) {
             if (column >= 0 && column !== prevColumn) {
               set$(ctx, `containerColumn${i}`, column);
             }
-            if (prevData !== item) {
+            if (prevData !== item && (itemsAreEqual ? !itemsAreEqual(prevData, item, itemIndex, data) : true)) {
               set$(ctx, `containerItemData${i}`, data[itemIndex]);
             }
           }
@@ -2025,15 +2035,8 @@ function calculateItemsInView(ctx, state, params = {}) {
         setDidLayout(ctx, state);
       }
     }
-    if (state.viewabilityConfigCallbackPairs) {
-      updateViewableItems(
-        state,
-        ctx,
-        state.viewabilityConfigCallbackPairs,
-        scrollLength,
-        startNoBuffer,
-        endNoBuffer
-      );
+    if (viewabilityConfigCallbackPairs) {
+      updateViewableItems(state, ctx, viewabilityConfigCallbackPairs, scrollLength, startNoBuffer, endNoBuffer);
     }
   });
 }
@@ -2170,6 +2173,9 @@ function handleLayout(ctx, state, layout, setCanRender) {
 // src/core/onScroll.ts
 function onScroll(ctx, state, event) {
   var _a, _b, _c, _d, _e;
+  if (!state.scrollProcessingEnabled) {
+    return;
+  }
   if (((_b = (_a = event.nativeEvent) == null ? void 0 : _a.contentSize) == null ? void 0 : _b.height) === 0 && ((_c = event.nativeEvent.contentSize) == null ? void 0 : _c.width) === 0) {
     return;
   }
@@ -2338,7 +2344,8 @@ function updateItemSize(ctx, state, itemKey, sizeObj) {
     }
   }
   const containersDidLayout = peek$(ctx, "containersDidLayout");
-  if (!containersDidLayout || !queuedItemSizeUpdatesWaiting) {
+  const speed = getScrollVelocity(state);
+  if (!containersDidLayout || !queuedItemSizeUpdatesWaiting || Math.abs(speed) < 1) {
     updateItemSizes(ctx, state, [{ itemKey, sizeObj }]);
     if (containersDidLayout) {
       state.queuedItemSizeUpdatesWaiting = true;
@@ -2432,11 +2439,63 @@ function getRenderedItem(ctx, state, key) {
       item: data[index],
       type: getItemType ? (_a = getItemType(data[index], index)) != null ? _a : "" : ""
     };
-    renderedItem = React3__default.createElement(renderItem2, itemProps);
+    renderedItem = isFunction(renderItem2) ? renderItem2(itemProps) : React3__default.createElement(renderItem2, itemProps);
   }
   return { index, item: data[index], renderedItem };
 }
 
+// src/utils/updateAveragesOnDataChange.ts
+function updateAveragesOnDataChange(state, oldData, newData) {
+  var _a;
+  const {
+    averageSizes,
+    sizesKnown,
+    indexByKey,
+    props: { itemsAreEqual, getItemType, keyExtractor }
+  } = state;
+  if (!itemsAreEqual || !oldData.length || !newData.length) {
+    for (const key in averageSizes) {
+      delete averageSizes[key];
+    }
+    return;
+  }
+  const itemTypesToPreserve = {};
+  const newDataLength = newData.length;
+  const oldDataLength = oldData.length;
+  for (let newIndex = 0; newIndex < newDataLength; newIndex++) {
+    const newItem = newData[newIndex];
+    const id = keyExtractor ? keyExtractor(newItem, newIndex) : String(newIndex);
+    const oldIndex = indexByKey.get(id);
+    if (oldIndex !== void 0 && oldIndex < oldDataLength) {
+      const knownSize = sizesKnown.get(id);
+      if (knownSize === void 0) continue;
+      const oldItem = oldData[oldIndex];
+      const areEqual = itemsAreEqual(oldItem, newItem, newIndex, newData);
+      if (areEqual) {
+        const itemType = getItemType ? (_a = getItemType(newItem, newIndex)) != null ? _a : "" : "";
+        let typeData = itemTypesToPreserve[itemType];
+        if (!typeData) {
+          typeData = itemTypesToPreserve[itemType] = { count: 0, totalSize: 0 };
+        }
+        typeData.totalSize += knownSize;
+        typeData.count++;
+      }
+    }
+  }
+  for (const key in averageSizes) {
+    delete averageSizes[key];
+  }
+  for (const itemType in itemTypesToPreserve) {
+    const { totalSize, count } = itemTypesToPreserve[itemType];
+    if (count > 0) {
+      averageSizes[itemType] = {
+        avg: totalSize / count,
+        num: count
+      };
+    }
+  }
+}
+
 // src/components/LegendList.tsx
 var DEFAULT_DRAW_DISTANCE = 250;
 var DEFAULT_ITEM_SIZE = 100;
@@ -2461,6 +2520,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     initialContainerPoolRatio = 2,
     initialScrollIndex: initialScrollIndexProp,
     initialScrollOffset,
+    itemsAreEqual,
     keyExtractor: keyExtractorProp,
     ListEmptyComponent,
     ListHeaderComponent,
@@ -2550,6 +2610,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       scrollPending: 0,
       scrollPrev: 0,
       scrollPrevTime: 0,
+      scrollProcessingEnabled: true,
       scrollTime: 0,
       sizes: /* @__PURE__ */ new Map(),
       sizesKnown: /* @__PURE__ */ new Map(),
@@ -2579,6 +2640,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     horizontal: !!horizontal,
     initialContainerPoolRatio,
     initialScroll,
+    itemsAreEqual,
     keyExtractor,
     maintainScrollAtEnd,
     maintainScrollAtEndThreshold,
@@ -2605,6 +2667,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   const checkResetContainers = (isFirst2) => {
     const state2 = refState.current;
     if (state2) {
+      if (!isFirst2 && state2.props.data !== dataProp) {
+        updateAveragesOnDataChange(state2, state2.props.data, dataProp);
+      }
       state2.props.data = dataProp;
       if (!isFirst2) {
         calculateItemsInView(ctx, state2, { dataChanged: true, doMVCP: true });
@@ -2812,6 +2877,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         }
       },
       scrollToOffset: (params) => scrollTo(state, params),
+      setScrollProcessingEnabled: (enabled) => {
+        refState.current.scrollProcessingEnabled = enabled;
+      },
       setVisibleContentAnchorOffset: (value) => {
         const val = typeof value === "function" ? value(peek$(ctx, "scrollAdjustUserOffset") || 0) : value;
         set$(ctx, "scrollAdjustUserOffset", val);

package/keyboard-controller.d.mts

@@ -70,6 +70,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -136,6 +137,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -204,6 +206,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -270,6 +273,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: ItemT, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: ItemT, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean) | undefined;
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/keyboard-controller.d.ts

@@ -70,6 +70,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -136,6 +137,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -204,6 +206,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: T, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: T, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: T, item: T, index: number, data: readonly T[]) => boolean) | undefined;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -270,6 +273,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     stickyIndices?: number[];
     getItemType?: ((item: ItemT, index: number) => string | undefined) | undefined;
     getFixedItemSize?: ((index: number, item: ItemT, type: string | undefined) => number) | undefined;
+    itemsAreEqual?: ((itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean) | undefined;
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/list",
-  "version": "2.0.0-next.15",
+  "version": "2.0.0-next.17",
   "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
   "sideEffects": false,
   "private": false,

package/reanimated.d.mts

@@ -2,7 +2,7 @@ import React__default, { ComponentProps } from 'react';
 import Animated from 'react-native-reanimated';
 import { LegendListPropsBase, LegendListRef } from '@legendapp/list';
 
-type KeysToOmit = "getEstimatedItemSize" | "getFixedItemSize" | "getItemType" | "keyExtractor" | "animatedProps" | "renderItem" | "onItemSizeChanged" | "ItemSeparatorComponent";
+type KeysToOmit = "getEstimatedItemSize" | "getFixedItemSize" | "getItemType" | "keyExtractor" | "animatedProps" | "renderItem" | "onItemSizeChanged" | "itemsAreEqual" | "ItemSeparatorComponent";
 type PropsBase<ItemT> = LegendListPropsBase<ItemT, ComponentProps<typeof Animated.ScrollView>>;
 interface AnimatedLegendListPropsBase<ItemT> extends Omit<PropsBase<ItemT>, KeysToOmit> {
     refScrollView?: React__default.Ref<Animated.ScrollView>;

package/reanimated.d.ts

@@ -2,7 +2,7 @@ import React__default, { ComponentProps } from 'react';
 import Animated from 'react-native-reanimated';
 import { LegendListPropsBase, LegendListRef } from '@legendapp/list';
 
-type KeysToOmit = "getEstimatedItemSize" | "getFixedItemSize" | "getItemType" | "keyExtractor" | "animatedProps" | "renderItem" | "onItemSizeChanged" | "ItemSeparatorComponent";
+type KeysToOmit = "getEstimatedItemSize" | "getFixedItemSize" | "getItemType" | "keyExtractor" | "animatedProps" | "renderItem" | "onItemSizeChanged" | "itemsAreEqual" | "ItemSeparatorComponent";
 type PropsBase<ItemT> = LegendListPropsBase<ItemT, ComponentProps<typeof Animated.ScrollView>>;
 interface AnimatedLegendListPropsBase<ItemT> extends Omit<PropsBase<ItemT>, KeysToOmit> {
     refScrollView?: React__default.Ref<Animated.ScrollView>;