@legendapp/list 3.3.1 → 3.3.3

package/reanimated.d.ts

@@ -9,12 +9,13 @@ interface MaintainVisibleContentPositionNormalized<ItemT = any> {
     shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
 
-type ListenerType = "activeStickyIndex" | "alignItemsAtEndPadding" | "anchoredEndSpaceSize" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | `containerColumn${number}` | `containerSpan${number}` | `containerItemData${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}`;
+type ListenerType = "activeStickyIndex" | "alignItemsAtEndPadding" | "anchoredEndSpaceSize" | "containerLayoutEpoch" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | `containerColumn${number}` | `containerSpan${number}` | `containerItemData${number}` | `containerItemIndex${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}`;
 type LegendListListenerType = Extract<ListenerType, "activeStickyIndex" | "anchoredEndSpaceSize" | "footerSize" | "headerSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | "lastItemKeys" | "lastPositionUpdate" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "snapToOffsets" | "totalSize">;
 type ListenerTypeValueMap = {
     activeStickyIndex: number;
     alignItemsAtEndPadding: number;
     anchoredEndSpaceSize: number;
+    containerLayoutEpoch: number;
     animatedScrollY: any;
     debugComputedScroll: number;
     debugRawScroll: number;
@@ -49,6 +50,8 @@ type ListenerTypeValueMap = {
     [K in ListenerType as K extends `containerItemKey${number}` ? K : never]: string;
 } & {
     [K in ListenerType as K extends `containerItemData${number}` ? K : never]: any;
+} & {
+    [K in ListenerType as K extends `containerItemIndex${number}` ? K : never]: number;
 } & {
     [K in ListenerType as K extends `containerPosition${number}` ? K : never]: number;
 } & {
@@ -561,6 +564,10 @@ type LegendListRef$1 = {
      * Returns the native ScrollView component reference.
      */
     getNativeScrollRef(): any;
+    /**
+     * Returns the underlying animatable scroll component reference.
+     */
+    getAnimatableRef(): any;
     /**
      * Returns the scroll responder instance for handling scroll events.
      */
@@ -720,7 +727,8 @@ type LegendListPropsOverrides<ItemT, TItemType extends string | undefined> = Omi
     ListFooterComponentStyle?: StyleProp$1<ViewStyle$1> | undefined;
 };
 type LegendListProps<ItemT = any, TItemType extends string | undefined = string | undefined> = LegendListPropsOverrides<ItemT, TItemType>;
-type LegendListRef = Omit<LegendListRef$1, "getNativeScrollRef" | "getScrollResponder" | "reportContentInset"> & {
+type LegendListRef = Omit<LegendListRef$1, "getAnimatableRef" | "getNativeScrollRef" | "getScrollResponder" | "reportContentInset"> & {
+    getAnimatableRef(): React.ElementRef<typeof ScrollViewComponent>;
     getNativeScrollRef(): React.ElementRef<typeof ScrollViewComponent>;
     getScrollResponder(): ScrollResponderMixin;
     reportContentInset(inset?: Partial<Insets$1> | null): void;

package/reanimated.js

@@ -41,6 +41,13 @@ var {
   getComponent
 } = reactNative.internal;
 var { peek$, useStateContext } = reactNative.internal;
+var ReanimatedScrollOffsetTracker = ({
+  animatedScrollRef,
+  scrollOffset
+}) => {
+  Reanimated.useScrollViewOffset(animatedScrollRef, scrollOffset);
+  return null;
+};
 var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent({
   forwardedRef,
   scrollOffset,
@@ -48,7 +55,6 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
   ...props
 }) {
   const animatedScrollRef = Reanimated.useAnimatedRef();
-  Reanimated.useScrollViewOffset(animatedScrollRef, scrollOffset);
   const combinedRef = useCombinedRef(animatedScrollRef, forwardedRef);
   const CustomScrollComponent = useStableRenderComponent(renderScrollComponent, (scrollViewProps, ref) => ({
     ...scrollViewProps,
@@ -56,7 +62,7 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
     scrollEventThrottle: 1
   }));
   const ScrollComponent = renderScrollComponent ? CustomScrollComponent : Reanimated__default.default.ScrollView;
-  return /* @__PURE__ */ React__namespace.createElement(ScrollComponent, { ...props, ref: combinedRef });
+  return /* @__PURE__ */ React__namespace.createElement(React__namespace.Fragment, null, scrollOffset && /* @__PURE__ */ React__namespace.createElement(ReanimatedScrollOffsetTracker, { animatedScrollRef, scrollOffset }), /* @__PURE__ */ React__namespace.createElement(ScrollComponent, { ...props, ref: combinedRef }));
 });
 var StickyOverlay = typedMemo(function StickyOverlayComponent({ stickyHeaderConfig }) {
   if (!(stickyHeaderConfig == null ? void 0 : stickyHeaderConfig.backdropComponent)) {
@@ -77,17 +83,18 @@ var StickyOverlay = typedMemo(function StickyOverlayComponent({ stickyHeaderConf
 var ReanimatedPositionViewSticky = typedMemo(function ReanimatedPositionViewStickyComponent(props) {
   var _a;
   const ctx = useStateContext();
-  const { id, horizontal, style, refView, stickyScrollOffset, stickyHeaderConfig, index, children, ...rest } = props;
-  const [position = POSITION_OUT_OF_VIEW, headerSize = 0, stylePaddingTop = 0, itemKey, _totalSize = 0] = useArr$([
+  const { id, horizontal, style, refView, stickyScrollOffset, stickyHeaderConfig, children, ...rest } = props;
+  const [position = POSITION_OUT_OF_VIEW, headerSize = 0, stylePaddingTop = 0, itemKey, itemIndex, _totalSize = 0] = useArr$([
     `containerPosition${id}`,
     "headerSize",
     "stylePaddingTop",
     `containerItemKey${id}`,
+    `containerItemIndex${id}`,
     "totalSize"
   ]);
   const pushLimit = React__namespace.useMemo(
-    () => getStickyPushLimit(ctx.state, index, itemKey),
-    [ctx.state, index, itemKey, _totalSize]
+    () => getStickyPushLimit(ctx.state, itemIndex, itemKey),
+    [ctx.state, itemIndex, itemKey, _totalSize]
   );
   const stickyOffset = (_a = stickyHeaderConfig == null ? void 0 : stickyHeaderConfig.offset) != null ? _a : 0;
   const stickyStart = position + headerSize + stylePaddingTop - stickyOffset;
@@ -98,8 +105,8 @@ var ReanimatedPositionViewSticky = typedMemo(function ReanimatedPositionViewStic
     return horizontal ? { transform: [{ translateX: resolvedPosition }] } : { transform: [{ translateY: resolvedPosition }] };
   }, [horizontal, position, pushLimit, stickyStart]);
   const viewStyle = React__namespace.useMemo(
-    () => [style, { zIndex: index + 1e3 }, stickyPositionStyle],
-    [index, stickyPositionStyle, style]
+    () => [style, { zIndex: itemIndex + 1e3 }, stickyPositionStyle],
+    [itemIndex, stickyPositionStyle, style]
   );
   return /* @__PURE__ */ React__namespace.createElement(Reanimated__default.default.View, { ref: refView, style: viewStyle, ...rest }, /* @__PURE__ */ React__namespace.createElement(StickyOverlay, { stickyHeaderConfig }), children);
 });
@@ -185,7 +192,7 @@ function useAnimatedLegendListSharedValuesSync(legendList, sharedValues) {
 var LegendListForwardedRef = typedMemo(
   // biome-ignore lint/nursery/noShadow: const function name shadowing is intentional
   React__namespace.forwardRef(function LegendListForwardedRef2(props, ref) {
-    var _a;
+    var _a, _b;
     const { itemLayoutAnimation, recycleItems, refLegendList, renderScrollComponent, sharedValues, ...rest } = props;
     const refFn = React.useCallback(
       (r) => {
@@ -195,6 +202,7 @@ var LegendListForwardedRef = typedMemo(
     );
     const internalScrollOffset = Reanimated.useSharedValue(0);
     const scrollOffset = (_a = sharedValues == null ? void 0 : sharedValues.scrollOffset) != null ? _a : internalScrollOffset;
+    const trackedScrollOffset = (sharedValues == null ? void 0 : sharedValues.scrollOffset) !== void 0 || ((_b = rest.stickyHeaderIndices) == null ? void 0 : _b.length) ? scrollOffset : void 0;
     const renderScrollComponentForBridge = React__namespace.useMemo(
       () => renderScrollComponent ? (scrollViewProps) => renderScrollComponent(scrollViewProps) : void 0,
       [renderScrollComponent]
@@ -208,11 +216,11 @@ var LegendListForwardedRef = typedMemo(
             ...restScrollViewProps,
             forwardedRef,
             renderScrollComponent: renderScrollComponentForBridge,
-            scrollOffset
+            scrollOffset: trackedScrollOffset
           }
         );
       },
-      [renderScrollComponentForBridge, scrollOffset]
+      [renderScrollComponentForBridge, trackedScrollOffset]
     );
     const stickyPositionComponentInternal = React__namespace.useMemo(
       () => function StickyPositionComponent(stickyProps) {

package/reanimated.mjs

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { useCallback } from 'react';
 import { View } from 'react-native';
-import Reanimated, { useAnimatedRef, useScrollViewOffset, useAnimatedStyle, useSharedValue } from 'react-native-reanimated';
+import Reanimated, { useAnimatedRef, useAnimatedStyle, useSharedValue, useScrollViewOffset } from 'react-native-reanimated';
 import { internal, LegendList } from '@legendapp/list/react-native';
 
 // src/integrations/reanimated.tsx
@@ -17,6 +17,13 @@ var {
   getComponent
 } = internal;
 var { peek$, useStateContext } = internal;
+var ReanimatedScrollOffsetTracker = ({
+  animatedScrollRef,
+  scrollOffset
+}) => {
+  useScrollViewOffset(animatedScrollRef, scrollOffset);
+  return null;
+};
 var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent({
   forwardedRef,
   scrollOffset,
@@ -24,7 +31,6 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
   ...props
 }) {
   const animatedScrollRef = useAnimatedRef();
-  useScrollViewOffset(animatedScrollRef, scrollOffset);
   const combinedRef = useCombinedRef(animatedScrollRef, forwardedRef);
   const CustomScrollComponent = useStableRenderComponent(renderScrollComponent, (scrollViewProps, ref) => ({
     ...scrollViewProps,
@@ -32,7 +38,7 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
     scrollEventThrottle: 1
   }));
   const ScrollComponent = renderScrollComponent ? CustomScrollComponent : Reanimated.ScrollView;
-  return /* @__PURE__ */ React.createElement(ScrollComponent, { ...props, ref: combinedRef });
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, scrollOffset && /* @__PURE__ */ React.createElement(ReanimatedScrollOffsetTracker, { animatedScrollRef, scrollOffset }), /* @__PURE__ */ React.createElement(ScrollComponent, { ...props, ref: combinedRef }));
 });
 var StickyOverlay = typedMemo(function StickyOverlayComponent({ stickyHeaderConfig }) {
   if (!(stickyHeaderConfig == null ? void 0 : stickyHeaderConfig.backdropComponent)) {
@@ -53,17 +59,18 @@ var StickyOverlay = typedMemo(function StickyOverlayComponent({ stickyHeaderConf
 var ReanimatedPositionViewSticky = typedMemo(function ReanimatedPositionViewStickyComponent(props) {
   var _a;
   const ctx = useStateContext();
-  const { id, horizontal, style, refView, stickyScrollOffset, stickyHeaderConfig, index, children, ...rest } = props;
-  const [position = POSITION_OUT_OF_VIEW, headerSize = 0, stylePaddingTop = 0, itemKey, _totalSize = 0] = useArr$([
+  const { id, horizontal, style, refView, stickyScrollOffset, stickyHeaderConfig, children, ...rest } = props;
+  const [position = POSITION_OUT_OF_VIEW, headerSize = 0, stylePaddingTop = 0, itemKey, itemIndex, _totalSize = 0] = useArr$([
     `containerPosition${id}`,
     "headerSize",
     "stylePaddingTop",
     `containerItemKey${id}`,
+    `containerItemIndex${id}`,
     "totalSize"
   ]);
   const pushLimit = React.useMemo(
-    () => getStickyPushLimit(ctx.state, index, itemKey),
-    [ctx.state, index, itemKey, _totalSize]
+    () => getStickyPushLimit(ctx.state, itemIndex, itemKey),
+    [ctx.state, itemIndex, itemKey, _totalSize]
   );
   const stickyOffset = (_a = stickyHeaderConfig == null ? void 0 : stickyHeaderConfig.offset) != null ? _a : 0;
   const stickyStart = position + headerSize + stylePaddingTop - stickyOffset;
@@ -74,8 +81,8 @@ var ReanimatedPositionViewSticky = typedMemo(function ReanimatedPositionViewStic
     return horizontal ? { transform: [{ translateX: resolvedPosition }] } : { transform: [{ translateY: resolvedPosition }] };
   }, [horizontal, position, pushLimit, stickyStart]);
   const viewStyle = React.useMemo(
-    () => [style, { zIndex: index + 1e3 }, stickyPositionStyle],
-    [index, stickyPositionStyle, style]
+    () => [style, { zIndex: itemIndex + 1e3 }, stickyPositionStyle],
+    [itemIndex, stickyPositionStyle, style]
   );
   return /* @__PURE__ */ React.createElement(Reanimated.View, { ref: refView, style: viewStyle, ...rest }, /* @__PURE__ */ React.createElement(StickyOverlay, { stickyHeaderConfig }), children);
 });
@@ -161,7 +168,7 @@ function useAnimatedLegendListSharedValuesSync(legendList, sharedValues) {
 var LegendListForwardedRef = typedMemo(
   // biome-ignore lint/nursery/noShadow: const function name shadowing is intentional
   React.forwardRef(function LegendListForwardedRef2(props, ref) {
-    var _a;
+    var _a, _b;
     const { itemLayoutAnimation, recycleItems, refLegendList, renderScrollComponent, sharedValues, ...rest } = props;
     const refFn = useCallback(
       (r) => {
@@ -171,6 +178,7 @@ var LegendListForwardedRef = typedMemo(
     );
     const internalScrollOffset = useSharedValue(0);
     const scrollOffset = (_a = sharedValues == null ? void 0 : sharedValues.scrollOffset) != null ? _a : internalScrollOffset;
+    const trackedScrollOffset = (sharedValues == null ? void 0 : sharedValues.scrollOffset) !== void 0 || ((_b = rest.stickyHeaderIndices) == null ? void 0 : _b.length) ? scrollOffset : void 0;
     const renderScrollComponentForBridge = React.useMemo(
       () => renderScrollComponent ? (scrollViewProps) => renderScrollComponent(scrollViewProps) : void 0,
       [renderScrollComponent]
@@ -184,11 +192,11 @@ var LegendListForwardedRef = typedMemo(
             ...restScrollViewProps,
             forwardedRef,
             renderScrollComponent: renderScrollComponentForBridge,
-            scrollOffset
+            scrollOffset: trackedScrollOffset
           }
         );
       },
-      [renderScrollComponentForBridge, scrollOffset]
+      [renderScrollComponentForBridge, trackedScrollOffset]
     );
     const stickyPositionComponentInternal = React.useMemo(
       () => function StickyPositionComponent(stickyProps) {

package/section-list.d.ts

@@ -65,12 +65,13 @@ interface MaintainVisibleContentPositionNormalized<ItemT = any> {
     shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
 
-type ListenerType = "activeStickyIndex" | "alignItemsAtEndPadding" | "anchoredEndSpaceSize" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | `containerColumn${number}` | `containerSpan${number}` | `containerItemData${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}`;
+type ListenerType = "activeStickyIndex" | "alignItemsAtEndPadding" | "anchoredEndSpaceSize" | "containerLayoutEpoch" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | `containerColumn${number}` | `containerSpan${number}` | `containerItemData${number}` | `containerItemIndex${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}`;
 type LegendListListenerType = Extract<ListenerType, "activeStickyIndex" | "anchoredEndSpaceSize" | "footerSize" | "headerSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "adaptiveRender" | "lastItemKeys" | "lastPositionUpdate" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "snapToOffsets" | "totalSize">;
 type ListenerTypeValueMap = {
     activeStickyIndex: number;
     alignItemsAtEndPadding: number;
     anchoredEndSpaceSize: number;
+    containerLayoutEpoch: number;
     animatedScrollY: any;
     debugComputedScroll: number;
     debugRawScroll: number;
@@ -105,6 +106,8 @@ type ListenerTypeValueMap = {
     [K in ListenerType as K extends `containerItemKey${number}` ? K : never]: string;
 } & {
     [K in ListenerType as K extends `containerItemData${number}` ? K : never]: any;
+} & {
+    [K in ListenerType as K extends `containerItemIndex${number}` ? K : never]: number;
 } & {
     [K in ListenerType as K extends `containerPosition${number}` ? K : never]: number;
 } & {
@@ -617,6 +620,10 @@ type LegendListRef$1 = {
      * Returns the native ScrollView component reference.
      */
     getNativeScrollRef(): any;
+    /**
+     * Returns the underlying animatable scroll component reference.
+     */
+    getAnimatableRef(): any;
     /**
      * Returns the scroll responder instance for handling scroll events.
      */
@@ -776,7 +783,8 @@ type LegendListPropsOverrides<ItemT, TItemType extends string | undefined> = Omi
     ListFooterComponentStyle?: StyleProp$1<ViewStyle$1> | undefined;
 };
 type LegendListProps<ItemT = any, TItemType extends string | undefined = string | undefined> = LegendListPropsOverrides<ItemT, TItemType>;
-type LegendListRef = Omit<LegendListRef$1, "getNativeScrollRef" | "getScrollResponder" | "reportContentInset"> & {
+type LegendListRef = Omit<LegendListRef$1, "getAnimatableRef" | "getNativeScrollRef" | "getScrollResponder" | "reportContentInset"> & {
+    getAnimatableRef(): React.ElementRef<typeof ScrollViewComponent>;
     getNativeScrollRef(): React.ElementRef<typeof ScrollViewComponent>;
     getScrollResponder(): ScrollResponderMixin;
     reportContentInset(inset?: Partial<Insets$1> | null): void;