@legendapp/list 3.0.0-beta.40 → 3.0.0-beta.41

package/index.js

@@ -1004,6 +1004,47 @@ var StyleSheet = {
   create: (styles) => styles,
   flatten: (style) => flattenStyles(style)
 };
+function useRafCoalescer(callback) {
+  const callbackRef = React3.useRef(callback);
+  const rafIdRef = React3.useRef(void 0);
+  callbackRef.current = callback;
+  const coalescer = React3.useMemo(
+    () => ({
+      cancel() {
+        if (rafIdRef.current !== void 0) {
+          cancelAnimationFrame(rafIdRef.current);
+          rafIdRef.current = void 0;
+        }
+      },
+      flush() {
+        coalescer.cancel();
+        callbackRef.current();
+      },
+      schedule() {
+        if (rafIdRef.current !== void 0) {
+          return false;
+        }
+        const rafId = requestAnimationFrame(() => {
+          if (rafIdRef.current !== rafId) {
+            return;
+          }
+          rafIdRef.current = void 0;
+          callbackRef.current();
+        });
+        rafIdRef.current = rafId;
+        return true;
+      }
+    }),
+    []
+  );
+  React3.useEffect(
+    () => () => {
+      coalescer.cancel();
+    },
+    [coalescer]
+  );
+  return coalescer;
+}
 
 // src/components/webScrollUtils.ts
 function getDocumentScrollerNode() {
@@ -1105,6 +1146,7 @@ var ListComponentScrollView = React3.forwardRef(function ListComponentScrollView
   onLayout,
   ...props
 }, ref) {
+  const ctx = useStateContext();
   const scrollRef = React3.useRef(null);
   const contentRef = React3.useRef(null);
   const isWindowScroll = useWindowScroll;
@@ -1198,37 +1240,46 @@ var ListComponentScrollView = React3.forwardRef(function ListComponentScrollView
     };
     return api;
   }, [getCurrentScrollOffset, getMaxScrollOffset, getScrollTarget, horizontal, isWindowScroll, scrollToLocalOffset]);
+  const emitScroll = React3.useCallback(() => {
+    if (!onScroll2 || !scrollRef.current) {
+      return;
+    }
+    const contentSize = getContentSize2(contentRef.current);
+    const layoutMeasurement = getLayoutMeasurement(scrollRef.current, isWindowScroll, horizontal);
+    const offset = getCurrentScrollOffset();
+    const scrollEvent = {
+      nativeEvent: {
+        contentOffset: {
+          x: horizontal ? offset : 0,
+          y: horizontal ? 0 : offset
+        },
+        contentSize: {
+          height: contentSize.height,
+          width: contentSize.width
+        },
+        layoutMeasurement: {
+          height: layoutMeasurement.height,
+          width: layoutMeasurement.width
+        }
+      }
+    };
+    onScroll2(scrollEvent);
+  }, [getCurrentScrollOffset, horizontal, isWindowScroll, onScroll2]);
+  const scrollEventCoalescer = useRafCoalescer(emitScroll);
   const handleScroll = React3.useCallback(
     (_event) => {
+      var _a3;
       if (!onScroll2) {
         return;
       }
-      const target = scrollRef.current;
-      if (!target) {
-        return;
+      const scrollingTo = (_a3 = ctx.state) == null ? void 0 : _a3.scrollingTo;
+      if (scrollingTo && !scrollingTo.animated) {
+        scrollEventCoalescer.flush();
+      } else {
+        scrollEventCoalescer.schedule();
       }
-      const contentSize = getContentSize2(contentRef.current);
-      const layoutMeasurement = getLayoutMeasurement(scrollRef.current, isWindowScroll, horizontal);
-      const offset = getCurrentScrollOffset();
-      const scrollEvent = {
-        nativeEvent: {
-          contentOffset: {
-            x: horizontal ? offset : 0,
-            y: horizontal ? 0 : offset
-          },
-          contentSize: {
-            height: contentSize.height,
-            width: contentSize.width
-          },
-          layoutMeasurement: {
-            height: layoutMeasurement.height,
-            width: layoutMeasurement.width
-          }
-        }
-      };
-      onScroll2(scrollEvent);
     },
-    [getCurrentScrollOffset, horizontal, isWindowScroll, onScroll2]
+    [onScroll2, scrollEventCoalescer]
   );
   React3.useLayoutEffect(() => {
     const target = getScrollTarget();
@@ -1236,8 +1287,9 @@ var ListComponentScrollView = React3.forwardRef(function ListComponentScrollView
     target.addEventListener("scroll", handleScroll, { passive: true });
     return () => {
       target.removeEventListener("scroll", handleScroll);
+      scrollEventCoalescer.cancel();
     };
-  }, [getScrollTarget, handleScroll]);
+  }, [getScrollTarget, handleScroll, scrollEventCoalescer]);
   React3.useEffect(() => {
     const doScroll = () => {
       if (contentOffset) {
@@ -1589,6 +1641,7 @@ function getItemSize(ctx, key, index, data, useAverageSize, preferCachedSize) {
 
 // src/core/calculateOffsetWithOffsetPosition.ts
 function calculateOffsetWithOffsetPosition(ctx, offsetParam, params) {
+  var _a3;
   const state = ctx.state;
   const { index, viewOffset, viewPosition } = params;
   let offset = offsetParam;
@@ -1602,10 +1655,16 @@ function calculateOffsetWithOffsetPosition(ctx, offsetParam, params) {
     }
   }
   if (viewPosition !== void 0 && index !== void 0) {
-    const itemSize = getItemSize(ctx, getId(state, index), index, state.props.data[index]);
+    const dataLength = state.props.data.length;
+    if (dataLength === 0) {
+      return offset;
+    }
+    const isOutOfBounds = index < 0 || index >= dataLength;
+    const fallbackEstimatedSize = (_a3 = state.props.estimatedItemSize) != null ? _a3 : 0;
+    const itemSize = isOutOfBounds ? fallbackEstimatedSize : getItemSize(ctx, getId(state, index), index, state.props.data[index]);
     const trailingInset = getContentInsetEnd(state);
     offset -= viewPosition * (state.scrollLength - trailingInset - itemSize);
-    if (index === state.props.data.length - 1) {
+    if (!isOutOfBounds && index === state.props.data.length - 1) {
       const footerSize = peek$(ctx, "footerSize") || 0;
       offset += footerSize;
     }
@@ -1807,7 +1866,9 @@ function finishScrollTo(ctx) {
     const scrollingTo = state.scrollingTo;
     state.scrollHistory.length = 0;
     state.initialScroll = void 0;
+    state.initialScrollUsesOffset = false;
     state.initialAnchor = void 0;
+    state.initialNativeScrollWatchdog = void 0;
     state.scrollingTo = void 0;
     if (state.pendingTotalSize !== void 0) {
       addTotalSize(ctx, null, state.pendingTotalSize);
@@ -1909,7 +1970,9 @@ function listenForScrollEnd(ctx, params) {
 }
 
 // src/core/scrollTo.ts
+var WATCHDOG_OFFSET_EPSILON = 1;
 function scrollTo(ctx, params) {
+  var _a3, _b;
   const state = ctx.state;
   const { noScrollingTo, forceScroll, ...scrollTarget } = params;
   const { animated, isInitialScroll, offset: scrollTargetOffset, precomputedWithViewOffset } = scrollTarget;
@@ -1926,9 +1989,23 @@ function scrollTo(ctx, params) {
   offset = clampScrollOffset(ctx, offset, scrollTarget);
   state.scrollHistory.length = 0;
   if (!noScrollingTo) {
-    state.scrollingTo = scrollTarget;
+    state.scrollingTo = {
+      ...scrollTarget,
+      targetOffset: offset
+    };
   }
   state.scrollPending = offset;
+  const shouldWatchInitialNativeScroll = !state.didFinishInitialScroll && (isInitialScroll || !!state.initialNativeScrollWatchdog) && offset > WATCHDOG_OFFSET_EPSILON;
+  const shouldClearInitialNativeScrollWatchdog = !state.didFinishInitialScroll && !!state.initialNativeScrollWatchdog && offset <= WATCHDOG_OFFSET_EPSILON;
+  if (shouldWatchInitialNativeScroll) {
+    state.hasScrolled = false;
+    state.initialNativeScrollWatchdog = {
+      startScroll: (_b = (_a3 = state.initialNativeScrollWatchdog) == null ? void 0 : _a3.startScroll) != null ? _b : state.scroll,
+      targetOffset: offset
+    };
+  } else if (shouldClearInitialNativeScrollWatchdog) {
+    state.initialNativeScrollWatchdog = void 0;
+  }
   if (forceScroll || !isInitialScroll || Platform.OS === "android") {
     doScrollTo(ctx, { animated, horizontal, offset });
   } else {
@@ -1936,91 +2013,52 @@ function scrollTo(ctx, params) {
   }
 }
 
-// src/core/updateScroll.ts
-function updateScroll(ctx, newScroll, forceUpdate) {
+// src/core/doMaintainScrollAtEnd.ts
+function doMaintainScrollAtEnd(ctx) {
   const state = ctx.state;
-  const { ignoreScrollFromMVCP, lastScrollAdjustForHistory, scrollAdjustHandler, scrollHistory, scrollingTo } = state;
-  const prevScroll = state.scroll;
-  state.hasScrolled = true;
-  state.lastBatchingAction = Date.now();
-  const currentTime = Date.now();
-  const adjust = scrollAdjustHandler.getAdjust();
-  const adjustChanged = lastScrollAdjustForHistory !== void 0 && Math.abs(adjust - lastScrollAdjustForHistory) > 0.1;
-  if (adjustChanged) {
-    scrollHistory.length = 0;
-  }
-  state.lastScrollAdjustForHistory = adjust;
-  if (scrollingTo === void 0 && !(scrollHistory.length === 0 && newScroll === state.scroll)) {
-    if (!adjustChanged) {
-      scrollHistory.push({ scroll: newScroll, time: currentTime });
-    }
-  }
-  if (scrollHistory.length > 5) {
-    scrollHistory.shift();
+  const {
+    didContainersLayout,
+    isAtEnd,
+    pendingNativeMVCPAdjust,
+    refScroller,
+    props: { maintainScrollAtEnd }
+  } = state;
+  const shouldMaintainScrollAtEnd = !!(isAtEnd && maintainScrollAtEnd && didContainersLayout);
+  if (pendingNativeMVCPAdjust) {
+    state.pendingMaintainScrollAtEnd = shouldMaintainScrollAtEnd;
+    return false;
   }
-  if (ignoreScrollFromMVCP && !scrollingTo) {
-    const { lt, gt } = ignoreScrollFromMVCP;
-    if (lt && newScroll < lt || gt && newScroll > gt) {
-      state.ignoreScrollFromMVCPIgnored = true;
-      return;
+  state.pendingMaintainScrollAtEnd = false;
+  if (shouldMaintainScrollAtEnd) {
+    const contentSize = getContentSize(ctx);
+    if (contentSize < state.scrollLength) {
+      state.scroll = 0;
     }
-  }
-  state.scrollPrev = prevScroll;
-  state.scrollPrevTime = state.scrollTime;
-  state.scroll = newScroll;
-  state.scrollTime = currentTime;
-  const scrollDelta = Math.abs(newScroll - prevScroll);
-  const scrollLength = state.scrollLength;
-  const lastCalculated = state.scrollLastCalculate;
-  const useAggressiveItemRecalculation = isInMVCPActiveMode(state);
-  const shouldUpdate = useAggressiveItemRecalculation || forceUpdate || lastCalculated === void 0 || Math.abs(state.scroll - lastCalculated) > 2;
-  if (shouldUpdate) {
-    state.scrollLastCalculate = state.scroll;
-    state.ignoreScrollFromMVCPIgnored = false;
-    state.lastScrollDelta = scrollDelta;
-    const runCalculateItems = () => {
+    requestAnimationFrame(() => {
       var _a3;
-      (_a3 = state.triggerCalculateItemsInView) == null ? void 0 : _a3.call(state, { doMVCP: scrollingTo !== void 0 });
-      checkThresholds(ctx);
-    };
-    if (scrollLength > 0 && scrollingTo === void 0 && scrollDelta > scrollLength) {
-      ReactDOM.flushSync(runCalculateItems);
-    } else {
-      runCalculateItems();
-    }
-    state.dataChangeNeedsScrollUpdate = false;
-    state.lastScrollDelta = 0;
-  }
-}
-
-// src/utils/requestAdjust.ts
-function requestAdjust(ctx, positionDiff, dataChanged) {
-  const state = ctx.state;
-  if (Math.abs(positionDiff) > 0.1) {
-    const doit = () => {
-      {
-        state.scrollAdjustHandler.requestAdjust(positionDiff);
-        if (state.adjustingFromInitialMount) {
-          state.adjustingFromInitialMount--;
-        }
+      if (state.isAtEnd) {
+        state.maintainingScrollAtEnd = true;
+        (_a3 = refScroller.current) == null ? void 0 : _a3.scrollToEnd({
+          animated: maintainScrollAtEnd.animated
+        });
+        setTimeout(
+          () => {
+            state.maintainingScrollAtEnd = false;
+          },
+          maintainScrollAtEnd.animated ? 500 : 0
+        );
       }
-    };
-    state.scroll += positionDiff;
-    state.scrollForNextCalculateItemsInView = void 0;
-    const readyToRender = peek$(ctx, "readyToRender");
-    if (readyToRender) {
-      doit();
-    } else {
-      state.adjustingFromInitialMount = (state.adjustingFromInitialMount || 0) + 1;
-      requestAnimationFrame(doit);
-    }
+    });
+    return true;
   }
+  return false;
 }
 
 // src/core/mvcp.ts
 var MVCP_POSITION_EPSILON = 0.1;
 var MVCP_ANCHOR_LOCK_TTL_MS = 300;
 var MVCP_ANCHOR_LOCK_QUIET_PASSES_TO_RELEASE = 2;
+var NATIVE_END_CLAMP_EPSILON = 1;
 function resolveAnchorLock(state, enableMVCPAnchorLock, mvcpData, now) {
   if (!enableMVCPAnchorLock) {
     state.mvcpAnchorLock = void 0;
@@ -2060,6 +2098,82 @@ function updateAnchorLock(state, params) {
     };
   }
 }
+function shouldQueueNativeMVCPAdjust(dataChanged, state, positionDiff, prevTotalSize, prevScroll, scrollTarget) {
+  {
+    return false;
+  }
+}
+function getPredictedNativeClamp(state, unresolvedAmount, totalSize) {
+  if (Math.abs(unresolvedAmount) <= MVCP_POSITION_EPSILON) {
+    return 0;
+  }
+  const maxScroll = Math.max(0, totalSize - state.scrollLength);
+  const clampDelta = maxScroll - state.scroll;
+  if (unresolvedAmount < 0) {
+    return Math.max(unresolvedAmount, Math.min(0, clampDelta));
+  }
+  if (unresolvedAmount > 0) {
+    return Math.min(unresolvedAmount, Math.max(0, clampDelta));
+  }
+  return 0;
+}
+function maybeApplyPredictedNativeMVCPAdjust(ctx) {
+  const state = ctx.state;
+  const pending = state.pendingNativeMVCPAdjust;
+  if (!pending || Math.abs(pending.manualApplied) > MVCP_POSITION_EPSILON) {
+    return;
+  }
+  const totalSize = getContentSize(ctx);
+  const predictedNativeClamp = getPredictedNativeClamp(state, pending.amount, totalSize);
+  if (Math.abs(predictedNativeClamp) <= MVCP_POSITION_EPSILON) {
+    return;
+  }
+  const manualDesired = pending.amount - predictedNativeClamp;
+  if (Math.abs(manualDesired) <= MVCP_POSITION_EPSILON) {
+    return;
+  }
+  pending.manualApplied = manualDesired;
+  requestAdjust(ctx, manualDesired);
+}
+function resolvePendingNativeMVCPAdjust(ctx, newScroll) {
+  const state = ctx.state;
+  const pending = state.pendingNativeMVCPAdjust;
+  if (!pending) {
+    return false;
+  }
+  const remainingAfterManual = pending.amount - pending.manualApplied;
+  const nativeDelta = newScroll - (pending.startScroll + pending.manualApplied);
+  const isWrongDirection = remainingAfterManual < 0 && nativeDelta > MVCP_POSITION_EPSILON || remainingAfterManual > 0 && nativeDelta < -MVCP_POSITION_EPSILON;
+  if (Math.abs(remainingAfterManual) <= MVCP_POSITION_EPSILON) {
+    state.pendingNativeMVCPAdjust = void 0;
+    return true;
+  }
+  if (isWrongDirection) {
+    state.pendingNativeMVCPAdjust = void 0;
+    return false;
+  }
+  const expectedNativeClampScroll = Math.max(0, getContentSize(ctx) - state.scrollLength);
+  const distanceToClamp = Math.abs(newScroll - expectedNativeClampScroll);
+  const didApproachClamp = distanceToClamp < pending.closestDistanceToClamp - MVCP_POSITION_EPSILON;
+  const didMoveAwayAfterApproach = pending.hasApproachedClamp && distanceToClamp > pending.closestDistanceToClamp + MVCP_POSITION_EPSILON;
+  if (didApproachClamp) {
+    pending.closestDistanceToClamp = distanceToClamp;
+    pending.hasApproachedClamp = true;
+  } else if (didMoveAwayAfterApproach) {
+    state.pendingNativeMVCPAdjust = void 0;
+    return false;
+  }
+  const isAtExpectedNativeClamp = distanceToClamp <= NATIVE_END_CLAMP_EPSILON;
+  if (!isAtExpectedNativeClamp) {
+    return false;
+  }
+  state.pendingNativeMVCPAdjust = void 0;
+  const remaining = remainingAfterManual - nativeDelta;
+  if (Math.abs(remaining) > MVCP_POSITION_EPSILON) {
+    requestAdjust(ctx, remaining);
+  }
+  return true;
+}
 function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
@@ -2078,6 +2192,8 @@ function prepareMVCP(ctx, dataChanged) {
   const isEndAnchoredScrollTarget = scrollTarget !== void 0 && state.props.data.length > 0 && scrollTarget >= state.props.data.length - 1 && (scrollingToViewPosition != null ? scrollingToViewPosition : 0) > 0;
   const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
+  const prevScroll = state.scroll;
+  getContentSize(ctx);
   if (shouldMVCP) {
     if (anchorLock && scrollTarget === void 0) {
       targetId = anchorLock.id;
@@ -2184,6 +2300,19 @@ function prepareMVCP(ctx, dataChanged) {
         now,
         positionDiff
       });
+      if (shouldQueueNativeMVCPAdjust()) {
+        state.pendingNativeMVCPAdjust = {
+          amount: positionDiff,
+          closestDistanceToClamp: Math.abs(
+            prevScroll - Math.max(0, getContentSize(ctx) - state.scrollLength)
+          ),
+          hasApproachedClamp: false,
+          manualApplied: 0,
+          startScroll: prevScroll
+        };
+        maybeApplyPredictedNativeMVCPAdjust(ctx);
+        return;
+      }
       if (Math.abs(positionDiff) > MVCP_POSITION_EPSILON) {
         requestAdjust(ctx, positionDiff);
       }
@@ -2191,6 +2320,94 @@ function prepareMVCP(ctx, dataChanged) {
   }
 }
 
+// src/core/updateScroll.ts
+function updateScroll(ctx, newScroll, forceUpdate) {
+  var _a3;
+  const state = ctx.state;
+  const { ignoreScrollFromMVCP, lastScrollAdjustForHistory, scrollAdjustHandler, scrollHistory, scrollingTo } = state;
+  const prevScroll = state.scroll;
+  state.hasScrolled = true;
+  state.lastBatchingAction = Date.now();
+  const currentTime = Date.now();
+  const adjust = scrollAdjustHandler.getAdjust();
+  const adjustChanged = lastScrollAdjustForHistory !== void 0 && Math.abs(adjust - lastScrollAdjustForHistory) > 0.1;
+  if (adjustChanged) {
+    scrollHistory.length = 0;
+  }
+  state.lastScrollAdjustForHistory = adjust;
+  if (scrollingTo === void 0 && !(scrollHistory.length === 0 && newScroll === state.scroll)) {
+    if (!adjustChanged) {
+      scrollHistory.push({ scroll: newScroll, time: currentTime });
+    }
+  }
+  if (scrollHistory.length > 5) {
+    scrollHistory.shift();
+  }
+  if (ignoreScrollFromMVCP && !scrollingTo) {
+    const { lt, gt } = ignoreScrollFromMVCP;
+    if (lt && newScroll < lt || gt && newScroll > gt) {
+      state.ignoreScrollFromMVCPIgnored = true;
+      return;
+    }
+  }
+  state.scrollPrev = prevScroll;
+  state.scrollPrevTime = state.scrollTime;
+  state.scroll = newScroll;
+  state.scrollTime = currentTime;
+  const scrollDelta = Math.abs(newScroll - prevScroll);
+  const didResolvePendingNativeMVCPAdjust = resolvePendingNativeMVCPAdjust(ctx, newScroll);
+  const scrollLength = state.scrollLength;
+  const lastCalculated = state.scrollLastCalculate;
+  const useAggressiveItemRecalculation = isInMVCPActiveMode(state);
+  const shouldUpdate = useAggressiveItemRecalculation || didResolvePendingNativeMVCPAdjust || forceUpdate || lastCalculated === void 0 || Math.abs(state.scroll - lastCalculated) > 2;
+  if (shouldUpdate) {
+    state.scrollLastCalculate = state.scroll;
+    state.ignoreScrollFromMVCPIgnored = false;
+    state.lastScrollDelta = scrollDelta;
+    const runCalculateItems = () => {
+      var _a4;
+      (_a4 = state.triggerCalculateItemsInView) == null ? void 0 : _a4.call(state, { doMVCP: scrollingTo !== void 0 });
+      checkThresholds(ctx);
+    };
+    if (scrollLength > 0 && scrollingTo === void 0 && scrollDelta > scrollLength) {
+      ReactDOM.flushSync(runCalculateItems);
+    } else {
+      runCalculateItems();
+    }
+    const shouldMaintainScrollAtEndAfterPendingSettle = !!state.pendingMaintainScrollAtEnd || !!((_a3 = state.props.maintainScrollAtEnd) == null ? void 0 : _a3.onDataChange);
+    if (didResolvePendingNativeMVCPAdjust && shouldMaintainScrollAtEndAfterPendingSettle) {
+      state.pendingMaintainScrollAtEnd = false;
+      doMaintainScrollAtEnd(ctx);
+    }
+    state.dataChangeNeedsScrollUpdate = false;
+    state.lastScrollDelta = 0;
+  }
+}
+
+// src/utils/requestAdjust.ts
+function requestAdjust(ctx, positionDiff, dataChanged) {
+  const state = ctx.state;
+  if (Math.abs(positionDiff) > 0.1) {
+    const doit = () => {
+      {
+        state.scrollAdjustHandler.requestAdjust(positionDiff);
+        if (state.adjustingFromInitialMount) {
+          state.adjustingFromInitialMount--;
+        }
+      }
+    };
+    state.scroll += positionDiff;
+    state.scrollForNextCalculateItemsInView = void 0;
+    const readyToRender = peek$(ctx, "readyToRender");
+    if (readyToRender) {
+      doit();
+    } else {
+      state.adjustingFromInitialMount = (state.adjustingFromInitialMount || 0) + 1;
+      requestAnimationFrame(doit);
+    }
+  }
+}
+
 // src/core/prepareColumnStartState.ts
 function prepareColumnStartState(ctx, startIndex, useAverageSize) {
   var _a3;
@@ -2844,7 +3061,14 @@ function comparatorByDistance(a, b) {
 }
 
 // src/core/scrollToIndex.ts
-function scrollToIndex(ctx, { index, viewOffset = 0, animated = true, viewPosition }) {
+function scrollToIndex(ctx, {
+  index,
+  viewOffset = 0,
+  animated = true,
+  forceScroll,
+  isInitialScroll,
+  viewPosition
+}) {
   const state = ctx.state;
   const { data } = state.props;
   if (index >= data.length) {
@@ -2862,7 +3086,9 @@ function scrollToIndex(ctx, { index, viewOffset = 0, animated = true, viewPositi
   const itemSize = getItemSize(ctx, targetId, index, state.props.data[index]);
   scrollTo(ctx, {
     animated,
+    forceScroll,
     index,
+    isInitialScroll,
     itemSize,
     offset: firstIndexOffset,
     viewOffset,
@@ -2870,15 +3096,58 @@ function scrollToIndex(ctx, { index, viewOffset = 0, animated = true, viewPositi
   });
 }
 
+// src/utils/performInitialScroll.ts
+function performInitialScroll(ctx, params) {
+  var _a3;
+  const { forceScroll, initialScrollUsesOffset, resolvedOffset, target } = params;
+  if (initialScrollUsesOffset || resolvedOffset !== void 0) {
+    scrollTo(ctx, {
+      animated: false,
+      forceScroll,
+      index: initialScrollUsesOffset ? void 0 : target.index,
+      isInitialScroll: true,
+      offset: (_a3 = resolvedOffset != null ? resolvedOffset : target.contentOffset) != null ? _a3 : 0,
+      precomputedWithViewOffset: resolvedOffset !== void 0
+    });
+    return;
+  }
+  if (target.index === void 0) {
+    return;
+  }
+  scrollToIndex(ctx, {
+    ...target,
+    animated: false,
+    forceScroll,
+    isInitialScroll: true
+  });
+}
+
 // src/utils/setDidLayout.ts
 function setDidLayout(ctx) {
   const state = ctx.state;
   const { initialScroll } = state;
   state.queuedInitialLayout = true;
   checkAtBottom(ctx);
-  if ((initialScroll == null ? void 0 : initialScroll.index) !== void 0) {
-    const target = initialScroll;
-    const runScroll = () => scrollToIndex(ctx, { ...target, animated: false });
+  if (initialScroll) {
+    const runScroll = () => {
+      var _a3, _b;
+      const target = state.initialScroll;
+      if (!target) {
+        return;
+      }
+      const activeInitialTargetOffset = ((_a3 = state.scrollingTo) == null ? void 0 : _a3.isInitialScroll) ? (_b = state.scrollingTo.targetOffset) != null ? _b : state.scrollingTo.offset : void 0;
+      const desiredInitialTargetOffset = state.initialScrollUsesOffset ? target.contentOffset : activeInitialTargetOffset;
+      const isAlreadyAtDesiredInitialTarget = desiredInitialTargetOffset !== void 0 && Math.abs(state.scroll - desiredInitialTargetOffset) <= 1 && Math.abs(state.scrollPending - desiredInitialTargetOffset) <= 1;
+      if (!isAlreadyAtDesiredInitialTarget) {
+        performInitialScroll(ctx, {
+          forceScroll: true,
+          initialScrollUsesOffset: state.initialScrollUsesOffset,
+          // Offset-based initial scrolls do not need item lookup, so they can run even before data exists.
+          // Re-run on the next frame to pick up measured viewport size without waiting for index resolution.
+          target
+        });
+      }
+    };
     runScroll();
     requestAnimationFrame(runScroll);
   }
@@ -2956,7 +3225,7 @@ function handleStickyRecycling(ctx, stickyArray, scroll, drawDistance, currentSt
 function calculateItemsInView(ctx, params = {}) {
   const state = ctx.state;
   batchedUpdates(() => {
-    var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
     const {
       columns,
       columnSpans,
@@ -2992,7 +3261,7 @@ function calculateItemsInView(ctx, params = {}) {
     if (!data || scrollLength === 0 || !prevNumContainers) {
       return;
     }
-    const totalSize = getContentSize(ctx);
+    let totalSize = getContentSize(ctx);
     const topPad = peek$(ctx, "stylePaddingTop") + peek$(ctx, "headerSize");
     const numColumns = peek$(ctx, "numColumns");
     const speed = getScrollVelocity(state);
@@ -3000,14 +3269,14 @@ function calculateItemsInView(ctx, params = {}) {
     const { queuedInitialLayout } = state;
     let { scroll: scrollState } = state;
     if (!queuedInitialLayout && initialScroll) {
-      const updatedOffset = calculateOffsetWithOffsetPosition(
+      const updatedOffset = state.initialScrollUsesOffset ? (_a3 = initialScroll.contentOffset) != null ? _a3 : 0 : calculateOffsetWithOffsetPosition(
         ctx,
         calculateOffsetForIndex(ctx, initialScroll.index),
         initialScroll
       );
       scrollState = updatedOffset;
     }
-    const scrollAdjustPending = (_a3 = peek$(ctx, "scrollAdjustPending")) != null ? _a3 : 0;
+    const scrollAdjustPending = (_b = peek$(ctx, "scrollAdjustPending")) != null ? _b : 0;
     const scrollAdjustPad = scrollAdjustPending - topPad;
     let scroll = Math.round(scrollState + scrollExtra + scrollAdjustPad);
     if (scroll + scrollLength > totalSize) {
@@ -3049,13 +3318,14 @@ function calculateItemsInView(ctx, params = {}) {
       columns.length = 0;
       columnSpans.length = 0;
     }
-    const startIndex = forceFullItemPositions || dataChanged ? 0 : (_b = minIndexSizeChanged != null ? minIndexSizeChanged : state.startBuffered) != null ? _b : 0;
+    const startIndex = forceFullItemPositions || dataChanged ? 0 : (_c = minIndexSizeChanged != null ? minIndexSizeChanged : state.startBuffered) != null ? _c : 0;
     updateItemPositions(ctx, dataChanged, {
       doMVCP,
       forceFullUpdate: !!forceFullItemPositions,
       scrollBottomBuffered,
       startIndex
     });
+    totalSize = getContentSize(ctx);
     if (minIndexSizeChanged !== void 0) {
       state.minIndexSizeChanged = void 0;
     }
@@ -3067,9 +3337,9 @@ function calculateItemsInView(ctx, params = {}) {
     let endBuffered = null;
     let loopStart = !dataChanged && startBufferedIdOrig ? indexByKey.get(startBufferedIdOrig) || 0 : 0;
     for (let i = loopStart; i >= 0; i--) {
-      const id = (_c = idCache[i]) != null ? _c : getId(state, i);
+      const id = (_d = idCache[i]) != null ? _d : getId(state, i);
       const top = positions[i];
-      const size = (_d = sizes.get(id)) != null ? _d : getItemSize(ctx, id, i, data[i]);
+      const size = (_e = sizes.get(id)) != null ? _e : getItemSize(ctx, id, i, data[i]);
       const bottom = top + size;
       if (bottom > scroll - scrollBufferTop) {
         loopStart = i;
@@ -3100,14 +3370,14 @@ function calculateItemsInView(ctx, params = {}) {
     let firstFullyOnScreenIndex;
     const dataLength = data.length;
     for (let i = Math.max(0, loopStart); i < dataLength && (!foundEnd || i <= maxIndexRendered); i++) {
-      const id = (_e = idCache[i]) != null ? _e : getId(state, i);
-      const size = (_f = sizes.get(id)) != null ? _f : getItemSize(ctx, id, i, data[i]);
+      const id = (_f = idCache[i]) != null ? _f : getId(state, i);
+      const size = (_g = sizes.get(id)) != null ? _g : getItemSize(ctx, id, i, data[i]);
       const top = positions[i];
       if (!foundEnd) {
         if (startNoBuffer === null && top + size > scroll) {
           startNoBuffer = i;
         }
-        if (firstFullyOnScreenIndex === void 0 && top >= scroll - 10) {
+        if (firstFullyOnScreenIndex === void 0 && top >= scroll - 10 && top <= scrollBottom) {
           firstFullyOnScreenIndex = i;
         }
         if (startBuffered === null && top + size > scrollTopBuffered) {
@@ -3137,9 +3407,12 @@ function calculateItemsInView(ctx, params = {}) {
       }
     }
     const idsInView = [];
-    for (let i = firstFullyOnScreenIndex; i <= endNoBuffer; i++) {
-      const id = (_g = idCache[i]) != null ? _g : getId(state, i);
-      idsInView.push(id);
+    const firstVisibleAnchorIndex = firstFullyOnScreenIndex != null ? firstFullyOnScreenIndex : startNoBuffer;
+    if (firstVisibleAnchorIndex !== null && firstVisibleAnchorIndex !== void 0 && endNoBuffer !== null) {
+      for (let i = firstVisibleAnchorIndex; i <= endNoBuffer; i++) {
+        const id = (_h = idCache[i]) != null ? _h : getId(state, i);
+        idsInView.push(id);
+      }
     }
     Object.assign(state, {
       endBuffered,
@@ -3170,7 +3443,7 @@ function calculateItemsInView(ctx, params = {}) {
       const needNewContainers = [];
       const needNewContainersSet = /* @__PURE__ */ new Set();
       for (let i = startBuffered; i <= endBuffered; i++) {
-        const id = (_h = idCache[i]) != null ? _h : getId(state, i);
+        const id = (_i = idCache[i]) != null ? _i : getId(state, i);
         if (!containerItemKeys.has(id)) {
           needNewContainersSet.add(i);
           needNewContainers.push(i);
@@ -3179,7 +3452,7 @@ function calculateItemsInView(ctx, params = {}) {
       if (alwaysRenderArr.length > 0) {
         for (const index of alwaysRenderArr) {
           if (index < 0 || index >= dataLength) continue;
-          const id = (_i = idCache[index]) != null ? _i : getId(state, index);
+          const id = (_j = idCache[index]) != null ? _j : getId(state, index);
           if (id && !containerItemKeys.has(id) && !needNewContainersSet.has(index)) {
             needNewContainersSet.add(index);
             needNewContainers.push(index);
@@ -3217,7 +3490,7 @@ function calculateItemsInView(ctx, params = {}) {
         for (let idx = 0; idx < needNewContainers.length; idx++) {
           const i = needNewContainers[idx];
           const containerIndex = availableContainers[idx];
-          const id = (_j = idCache[i]) != null ? _j : getId(state, i);
+          const id = (_k = idCache[i]) != null ? _k : getId(state, i);
           const oldKey = peek$(ctx, `containerItemKey${containerIndex}`);
           if (oldKey && oldKey !== id) {
             containerItemKeys.delete(oldKey);
@@ -3258,7 +3531,7 @@ function calculateItemsInView(ctx, params = {}) {
       if (alwaysRenderArr.length > 0) {
         for (const index of alwaysRenderArr) {
           if (index < 0 || index >= dataLength) continue;
-          const id = (_k = idCache[index]) != null ? _k : getId(state, index);
+          const id = (_l = idCache[index]) != null ? _l : getId(state, index);
           const containerIndex = containerItemKeys.get(id);
           if (containerIndex !== void 0) {
             state.stickyContainerPool.add(containerIndex);
@@ -3367,21 +3640,21 @@ function checkActualChange(state, dataProp, previousData) {
 }
 
 // src/core/checkFinishedScroll.ts
+var INITIAL_SCROLL_MIN_TARGET_OFFSET = 1;
+var INITIAL_SCROLL_MAX_FALLBACK_CHECKS = 20;
+var INITIAL_SCROLL_ZERO_TARGET_EPSILON = 1;
 function checkFinishedScroll(ctx) {
   ctx.state.animFrameCheckFinishedScroll = requestAnimationFrame(() => checkFinishedScrollFrame(ctx));
 }
 function checkFinishedScrollFrame(ctx) {
+  var _a3;
   const scrollingTo = ctx.state.scrollingTo;
   if (scrollingTo) {
     const { state } = ctx;
     state.animFrameCheckFinishedScroll = void 0;
     const scroll = state.scrollPending;
     const adjust = state.scrollAdjustHandler.getAdjust();
-    const clampedTargetOffset = clampScrollOffset(
-      ctx,
-      scrollingTo.offset - (scrollingTo.viewOffset || 0),
-      scrollingTo
-    );
+    const clampedTargetOffset = (_a3 = scrollingTo.targetOffset) != null ? _a3 : clampScrollOffset(ctx, scrollingTo.offset - (scrollingTo.viewOffset || 0), scrollingTo);
     const maxOffset = clampScrollOffset(ctx, scroll, scrollingTo);
     const diff1 = Math.abs(scroll - clampedTargetOffset);
     const diff2 = Math.abs(diff1 - adjust);
@@ -3395,17 +3668,33 @@ function checkFinishedScrollFrame(ctx) {
 function checkFinishedScrollFallback(ctx) {
   const state = ctx.state;
   const scrollingTo = state.scrollingTo;
-  const slowTimeout = (scrollingTo == null ? void 0 : scrollingTo.isInitialScroll) || !state.didContainersLayout;
+  const shouldFinishInitialZeroTarget = shouldFinishInitialZeroTargetScroll(ctx);
+  const slowTimeout = (scrollingTo == null ? void 0 : scrollingTo.isInitialScroll) && !shouldFinishInitialZeroTarget || !state.didContainersLayout;
   state.timeoutCheckFinishedScrollFallback = setTimeout(
     () => {
       let numChecks = 0;
       const checkHasScrolled = () => {
+        var _a3, _b;
         state.timeoutCheckFinishedScrollFallback = void 0;
         const isStillScrollingTo = state.scrollingTo;
         if (isStillScrollingTo) {
           numChecks++;
-          if (state.hasScrolled || numChecks > 5) {
+          const isNativeInitialPending = isNativeInitialNonZeroTarget(state) && !state.hasScrolled;
+          const maxChecks = isNativeInitialPending ? INITIAL_SCROLL_MAX_FALLBACK_CHECKS : 5;
+          const shouldFinishZeroTarget = shouldFinishInitialZeroTargetScroll(ctx);
+          if (shouldFinishZeroTarget || state.hasScrolled || numChecks > maxChecks) {
             finishScrollTo(ctx);
+          } else if (isNativeInitialPending && numChecks <= maxChecks) {
+            const targetOffset = (_b = (_a3 = state.initialNativeScrollWatchdog) == null ? void 0 : _a3.targetOffset) != null ? _b : state.scrollPending;
+            const scroller = state.refScroller.current;
+            if (scroller) {
+              scroller.scrollTo({
+                animated: false,
+                x: state.props.horizontal ? targetOffset : 0,
+                y: state.props.horizontal ? 0 : targetOffset
+              });
+            }
+            state.timeoutCheckFinishedScrollFallback = setTimeout(checkHasScrolled, 100);
           } else {
             state.timeoutCheckFinishedScrollFallback = setTimeout(checkHasScrolled, 100);
           }
@@ -3416,39 +3705,13 @@ function checkFinishedScrollFallback(ctx) {
     slowTimeout ? 500 : 100
   );
 }
-
-// src/core/doMaintainScrollAtEnd.ts
-function doMaintainScrollAtEnd(ctx, animated) {
-  const state = ctx.state;
-  const {
-    didContainersLayout,
-    isAtEnd,
-    refScroller,
-    props: { maintainScrollAtEnd }
-  } = state;
-  if (isAtEnd && maintainScrollAtEnd && didContainersLayout) {
-    const contentSize = getContentSize(ctx);
-    if (contentSize < state.scrollLength) {
-      state.scroll = 0;
-    }
-    requestAnimationFrame(() => {
-      var _a3;
-      if (state.isAtEnd) {
-        state.maintainingScrollAtEnd = true;
-        (_a3 = refScroller.current) == null ? void 0 : _a3.scrollToEnd({
-          animated
-        });
-        setTimeout(
-          () => {
-            state.maintainingScrollAtEnd = false;
-          },
-          0
-        );
-      }
-    });
-    return true;
-  }
-  return false;
+function isNativeInitialNonZeroTarget(state) {
+  return !state.didFinishInitialScroll && !!state.initialNativeScrollWatchdog && state.initialNativeScrollWatchdog.targetOffset > INITIAL_SCROLL_MIN_TARGET_OFFSET;
+}
+function shouldFinishInitialZeroTargetScroll(ctx) {
+  var _a3;
+  const { state } = ctx;
+  return !!((_a3 = state.scrollingTo) == null ? void 0 : _a3.isInitialScroll) && state.props.data.length > 0 && getContentSize(ctx) <= state.scrollLength && state.scrollPending <= INITIAL_SCROLL_ZERO_TARGET_EPSILON;
 }
 
 // src/utils/updateAveragesOnDataChange.ts
@@ -3512,8 +3775,8 @@ function checkResetContainers(ctx, dataProp) {
   }
   const { maintainScrollAtEnd } = state.props;
   calculateItemsInView(ctx, { dataChanged: true, doMVCP: true });
-  const shouldMaintainScrollAtEnd = maintainScrollAtEnd === true || maintainScrollAtEnd.onDataChange;
-  const didMaintainScrollAtEnd = shouldMaintainScrollAtEnd && doMaintainScrollAtEnd(ctx, false);
+  const shouldMaintainScrollAtEnd = maintainScrollAtEnd == null ? void 0 : maintainScrollAtEnd.onDataChange;
+  const didMaintainScrollAtEnd = shouldMaintainScrollAtEnd && doMaintainScrollAtEnd(ctx);
   if (!didMaintainScrollAtEnd && previousData && dataProp.length > previousData.length) {
     state.isEndReached = false;
   }
@@ -3621,8 +3884,8 @@ function handleLayout(ctx, layoutParam, setCanRender) {
     if (didChange || otherAxisSize !== prevOtherAxisSize) {
       set$(ctx, "scrollSize", { height: layout.height, width: layout.width });
     }
-    if (maintainScrollAtEnd === true || maintainScrollAtEnd.onLayout) {
-      doMaintainScrollAtEnd(ctx, false);
+    if (maintainScrollAtEnd == null ? void 0 : maintainScrollAtEnd.onLayout) {
+      doMaintainScrollAtEnd(ctx);
     }
     checkThresholds(ctx);
     if (state) {
@@ -3639,6 +3902,12 @@ function handleLayout(ctx, layoutParam, setCanRender) {
 }
 
 // src/core/onScroll.ts
+var INITIAL_SCROLL_PROGRESS_EPSILON = 1;
+function didObserveInitialScrollProgress(newScroll, watchdog) {
+  const previousDistance = Math.abs(watchdog.startScroll - watchdog.targetOffset);
+  const nextDistance = Math.abs(newScroll - watchdog.targetOffset);
+  return nextDistance <= INITIAL_SCROLL_PROGRESS_EPSILON || nextDistance + INITIAL_SCROLL_PROGRESS_EPSILON < previousDistance;
+}
 function onScroll(ctx, event) {
   var _a3, _b, _c, _d;
   const state = ctx.state;
@@ -3676,7 +3945,16 @@ function onScroll(ctx, event) {
     }
   }
   state.scrollPending = newScroll;
+  const initialNativeScrollWatchdog = state.initialNativeScrollWatchdog;
+  const didInitialScrollProgress = !!initialNativeScrollWatchdog && didObserveInitialScrollProgress(newScroll, initialNativeScrollWatchdog);
+  if (didInitialScrollProgress) {
+    state.initialNativeScrollWatchdog = void 0;
+  }
   updateScroll(ctx, newScroll, insetChanged);
+  if (initialNativeScrollWatchdog && !didInitialScrollProgress) {
+    state.hasScrolled = false;
+    state.initialNativeScrollWatchdog = initialNativeScrollWatchdog;
+  }
   if (state.scrollingTo) {
     checkFinishedScroll(ctx);
   }
@@ -3841,8 +4119,8 @@ function updateItemSize(ctx, itemKey, sizeObj) {
       runOrScheduleMVCPRecalculate(ctx);
     }
     if (shouldMaintainScrollAtEnd) {
-      if (maintainScrollAtEnd === true || maintainScrollAtEnd.onItemLayout) {
-        doMaintainScrollAtEnd(ctx, false);
+      if (maintainScrollAtEnd == null ? void 0 : maintainScrollAtEnd.onItemLayout) {
+        doMaintainScrollAtEnd(ctx);
       }
     }
   }
@@ -4192,6 +4470,34 @@ function getRenderedItem(ctx, key) {
   return { index, item: data[index], renderedItem };
 }
 
+// src/utils/normalizeMaintainScrollAtEnd.ts
+function normalizeMaintainScrollAtEndOn(on, hasExplicitOn) {
+  var _a3, _b, _c;
+  return {
+    animated: false,
+    onDataChange: hasExplicitOn ? (_a3 = on == null ? void 0 : on.dataChange) != null ? _a3 : false : true,
+    onItemLayout: hasExplicitOn ? (_b = on == null ? void 0 : on.itemLayout) != null ? _b : false : true,
+    onLayout: hasExplicitOn ? (_c = on == null ? void 0 : on.layout) != null ? _c : false : true
+  };
+}
+function normalizeMaintainScrollAtEnd(value) {
+  var _a3;
+  if (!value) {
+    return void 0;
+  }
+  if (value === true) {
+    return {
+      ...normalizeMaintainScrollAtEndOn(void 0, false),
+      animated: false
+    };
+  }
+  const normalizedTriggers = normalizeMaintainScrollAtEndOn(value.on, "on" in value);
+  return {
+    ...normalizedTriggers,
+    animated: (_a3 = value.animated) != null ? _a3 : false
+  };
+}
+
 // src/utils/normalizeMaintainVisibleContentPosition.ts
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
@@ -4293,7 +4599,7 @@ var LegendList = typedMemo(
   })
 );
 var LegendListInner = typedForwardRef(function LegendListInner2(props, forwardedRef) {
-  var _a3, _b, _c, _d, _e;
+  var _a3, _b, _c, _d, _e, _f, _g, _h;
   const {
     alignItemsAtEnd = false,
     alwaysRender,
@@ -4379,16 +4685,24 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   const style = { ...StyleSheet.flatten(styleProp) };
   const stylePaddingTopState = extractPadding(style, contentContainerStyle, "Top");
   const stylePaddingBottomState = extractPadding(style, contentContainerStyle, "Bottom");
+  const maintainScrollAtEndConfig = normalizeMaintainScrollAtEnd(maintainScrollAtEnd);
   const maintainVisibleContentPositionConfig = normalizeMaintainVisibleContentPosition(
     maintainVisibleContentPositionProp
   );
-  const initialScrollProp = initialScrollAtEnd ? { index: Math.max(0, dataProp.length - 1), viewOffset: -stylePaddingBottomState, viewPosition: 1 } : initialScrollIndexProp || initialScrollOffsetProp ? typeof initialScrollIndexProp === "object" ? {
-    index: initialScrollIndexProp.index || 0,
-    viewOffset: initialScrollIndexProp.viewOffset || (initialScrollIndexProp.viewPosition === 1 ? -stylePaddingBottomState : 0),
-    viewPosition: initialScrollIndexProp.viewPosition || 0
+  const hasInitialScrollIndex = initialScrollIndexProp !== void 0 && initialScrollIndexProp !== null;
+  const hasInitialScrollOffset = initialScrollOffsetProp !== void 0 && initialScrollOffsetProp !== null;
+  const initialScrollUsesOffsetOnly = !initialScrollAtEnd && !hasInitialScrollIndex && hasInitialScrollOffset;
+  const initialScrollProp = initialScrollAtEnd ? { index: Math.max(0, dataProp.length - 1), viewOffset: -stylePaddingBottomState, viewPosition: 1 } : hasInitialScrollIndex ? typeof initialScrollIndexProp === "object" ? {
+    index: (_a3 = initialScrollIndexProp.index) != null ? _a3 : 0,
+    viewOffset: (_b = initialScrollIndexProp.viewOffset) != null ? _b : initialScrollIndexProp.viewPosition === 1 ? -stylePaddingBottomState : 0,
+    viewPosition: (_c = initialScrollIndexProp.viewPosition) != null ? _c : 0
   } : {
-    index: initialScrollIndexProp || 0,
-    viewOffset: initialScrollOffsetProp || 0
+    index: initialScrollIndexProp != null ? initialScrollIndexProp : 0,
+    viewOffset: initialScrollOffsetProp != null ? initialScrollOffsetProp : 0
+  } : initialScrollUsesOffsetOnly ? {
+    contentOffset: initialScrollOffsetProp != null ? initialScrollOffsetProp : 0,
+    index: 0,
+    viewOffset: 0
   } : void 0;
   const [canRender, setCanRender] = React3__namespace.useState(false);
   const ctx = useStateContext();
@@ -4403,8 +4717,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   }, [
     alwaysRender == null ? void 0 : alwaysRender.top,
     alwaysRender == null ? void 0 : alwaysRender.bottom,
-    (_a3 = alwaysRender == null ? void 0 : alwaysRender.indices) == null ? void 0 : _a3.join(","),
-    (_b = alwaysRender == null ? void 0 : alwaysRender.keys) == null ? void 0 : _b.join(","),
+    (_d = alwaysRender == null ? void 0 : alwaysRender.indices) == null ? void 0 : _d.join(","),
+    (_e = alwaysRender == null ? void 0 : alwaysRender.keys) == null ? void 0 : _e.join(","),
     dataProp,
     dataVersion,
     keyExtractor
@@ -4448,14 +4762,22 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         idCache: [],
         idsInView: [],
         indexByKey: /* @__PURE__ */ new Map(),
-        initialAnchor: (initialScrollProp == null ? void 0 : initialScrollProp.index) !== void 0 && (initialScrollProp == null ? void 0 : initialScrollProp.viewPosition) !== void 0 ? {
+        initialAnchor: !initialScrollUsesOffsetOnly && (initialScrollProp == null ? void 0 : initialScrollProp.index) !== void 0 && (initialScrollProp == null ? void 0 : initialScrollProp.viewPosition) !== void 0 ? {
           attempts: 0,
           index: initialScrollProp.index,
           settledTicks: 0,
-          viewOffset: (_c = initialScrollProp.viewOffset) != null ? _c : 0,
+          viewOffset: (_f = initialScrollProp.viewOffset) != null ? _f : 0,
           viewPosition: initialScrollProp.viewPosition
         } : void 0,
+        initialNativeScrollWatchdog: void 0,
         initialScroll: initialScrollProp,
+        initialScrollLastDidFinish: false,
+        initialScrollLastTarget: initialScrollProp,
+        initialScrollLastTargetUsesOffset: initialScrollUsesOffsetOnly,
+        initialScrollPreviousDataLength: dataProp.length,
+        initialScrollRetryLastLength: void 0,
+        initialScrollRetryWindowUntil: 0,
+        initialScrollUsesOffset: initialScrollUsesOffsetOnly,
         isAtEnd: false,
         isAtStart: false,
         isEndReached: null,
@@ -4468,6 +4790,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         minIndexSizeChanged: 0,
         nativeContentInset: void 0,
         nativeMarginTop: 0,
+        pendingNativeMVCPAdjust: void 0,
         positions: [],
         props: {},
         queuedCalculateItemsInView: 0,
@@ -4505,7 +4828,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   const state = refState.current;
   const isFirstLocal = state.isFirst;
   state.didColumnsChange = numColumnsProp !== state.props.numColumns;
-  const didDataChangeLocal = state.props.dataVersion !== dataVersion || state.props.data !== dataProp && checkActualChange(state, dataProp, state.props.data);
+  const didDataReferenceChangeLocal = state.props.data !== dataProp;
+  const didDataVersionChangeLocal = state.props.dataVersion !== dataVersion;
+  const didDataChangeLocal = didDataVersionChangeLocal || didDataReferenceChangeLocal && checkActualChange(state, dataProp, state.props.data);
   if (didDataChangeLocal) {
     state.dataChangeEpoch += 1;
     state.dataChangeNeedsScrollUpdate = true;
@@ -4531,7 +4856,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     initialContainerPoolRatio,
     itemsAreEqual,
     keyExtractor: useWrapIfItem(keyExtractor),
-    maintainScrollAtEnd,
+    maintainScrollAtEnd: maintainScrollAtEndConfig,
     maintainScrollAtEndThreshold,
     maintainVisibleContentPosition: maintainVisibleContentPositionConfig,
     numColumns: numColumnsProp,
@@ -4582,29 +4907,93 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     );
   }
   const resolveInitialScrollOffset = React3.useCallback((initialScroll) => {
+    var _a4;
+    if (state.initialScrollUsesOffset) {
+      return clampScrollOffset(ctx, (_a4 = initialScroll.contentOffset) != null ? _a4 : 0);
+    }
     const baseOffset = initialScroll.index !== void 0 ? calculateOffsetForIndex(ctx, initialScroll.index) : 0;
     const resolvedOffset = calculateOffsetWithOffsetPosition(ctx, baseOffset, initialScroll);
     return clampScrollOffset(ctx, resolvedOffset, initialScroll);
   }, []);
+  const finishInitialScrollWithoutScroll = React3.useCallback(() => {
+    refState.current.initialAnchor = void 0;
+    refState.current.initialScroll = void 0;
+    state.initialAnchor = void 0;
+    state.initialScroll = void 0;
+    state.initialScrollUsesOffset = false;
+    state.initialScrollLastTarget = void 0;
+    state.initialScrollLastTargetUsesOffset = false;
+    setInitialRenderState(ctx, { didInitialScroll: true });
+  }, []);
+  const setActiveInitialScrollTarget = React3.useCallback(
+    (target, options) => {
+      const usesOffset = !!(options == null ? void 0 : options.usesOffset);
+      state.initialScrollUsesOffset = usesOffset;
+      state.initialScrollLastTarget = target;
+      state.initialScrollLastTargetUsesOffset = usesOffset;
+      refState.current.initialScroll = target;
+      state.initialScroll = target;
+      if ((options == null ? void 0 : options.resetDidFinish) && state.didFinishInitialScroll) {
+        state.didFinishInitialScroll = false;
+      }
+      if (!(options == null ? void 0 : options.syncAnchor)) {
+        return;
+      }
+    },
+    []
+  );
+  const shouldFinishInitialScrollAtOrigin = React3.useCallback(
+    (initialScroll, offset) => {
+      var _a4, _b2, _c2;
+      if (offset !== 0 || initialScrollAtEnd) {
+        return false;
+      }
+      if (state.initialScrollUsesOffset) {
+        return Math.abs((_a4 = initialScroll.contentOffset) != null ? _a4 : 0) <= 1;
+      }
+      return initialScroll.index === 0 && ((_b2 = initialScroll.viewPosition) != null ? _b2 : 0) === 0 && Math.abs((_c2 = initialScroll.viewOffset) != null ? _c2 : 0) <= 1;
+    },
+    [initialScrollAtEnd]
+  );
+  const shouldFinishEmptyInitialScrollAtEnd = React3.useCallback(
+    (initialScroll, offset) => {
+      return dataProp.length === 0 && initialScrollAtEnd && offset === 0 && initialScroll.viewPosition === 1;
+    },
+    [dataProp.length, initialScrollAtEnd]
+  );
+  const shouldRearmFinishedEmptyInitialScrollAtEnd = React3.useCallback(
+    (initialScroll) => {
+      var _a4;
+      return !!(state.didFinishInitialScroll && dataProp.length > 0 && initialScroll && !state.initialScrollUsesOffset && initialScroll.index === 0 && initialScroll.viewPosition === 1 && ((_a4 = initialScroll.contentOffset) != null ? _a4 : 0) === 0);
+    },
+    [dataProp.length]
+  );
   const initialContentOffset = React3.useMemo(() => {
     let value;
     const { initialScroll, initialAnchor } = refState.current;
     if (initialScroll) {
+      if (!state.initialScrollUsesOffset && false) ;
       if (initialScroll.contentOffset !== void 0) {
         value = initialScroll.contentOffset;
       } else {
         const clampedOffset = resolveInitialScrollOffset(initialScroll);
         const updatedInitialScroll = { ...initialScroll, contentOffset: clampedOffset };
-        refState.current.initialScroll = updatedInitialScroll;
-        state.initialScroll = updatedInitialScroll;
+        setActiveInitialScrollTarget(updatedInitialScroll, {
+          usesOffset: state.initialScrollUsesOffset
+        });
         value = clampedOffset;
       }
     } else {
       refState.current.initialAnchor = void 0;
       value = 0;
     }
-    if (!value) {
-      setInitialRenderState(ctx, { didInitialScroll: true });
+    const hasPendingDataDependentInitialScroll = !!initialScroll && dataProp.length === 0 && !shouldFinishInitialScrollAtOrigin(initialScroll, value) && !shouldFinishEmptyInitialScrollAtEnd(initialScroll, value);
+    if (!value && !hasPendingDataDependentInitialScroll) {
+      if (initialScroll && shouldFinishInitialScrollAtOrigin(initialScroll, value)) {
+        finishInitialScrollWithoutScroll();
+      } else {
+        setInitialRenderState(ctx, { didInitialScroll: true });
+      }
     }
     return value;
   }, []);
@@ -4621,24 +5010,131 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       set$(ctx, "totalSize", 0);
     }
   }
-  const doInitialScroll = React3.useCallback(() => {
-    const { initialScroll, didFinishInitialScroll, queuedInitialLayout, scrollingTo } = state;
-    if (initialScroll && !queuedInitialLayout && !didFinishInitialScroll && !scrollingTo) {
-      const offset = resolveInitialScrollOffset(initialScroll);
+  const doInitialScroll = React3.useCallback((options) => {
+    var _a4, _b2;
+    const allowPostFinishRetry = !!(options == null ? void 0 : options.allowPostFinishRetry);
+    const { didFinishInitialScroll, queuedInitialLayout, scrollingTo } = state;
+    const initialScroll = (_a4 = state.initialScroll) != null ? _a4 : allowPostFinishRetry ? state.initialScrollLastTarget : void 0;
+    const isInitialScrollInProgress = !!(scrollingTo == null ? void 0 : scrollingTo.isInitialScroll);
+    const needsContainerLayoutForInitialScroll = !state.initialScrollUsesOffset;
+    const shouldWaitForInitialLayout = waitForInitialLayout && needsContainerLayoutForInitialScroll && !queuedInitialLayout && !allowPostFinishRetry && !isInitialScrollInProgress;
+    if (!initialScroll || shouldWaitForInitialLayout || didFinishInitialScroll && !allowPostFinishRetry || scrollingTo && !isInitialScrollInProgress) {
+      return;
+    }
+    if (allowPostFinishRetry && state.initialScrollLastTargetUsesOffset) {
+      return;
+    }
+    const didMoveAwayFromInitialTarget = allowPostFinishRetry && initialScroll.contentOffset !== void 0 && Math.abs(state.scroll - initialScroll.contentOffset) > 1;
+    if (didMoveAwayFromInitialTarget) {
+      state.initialScrollRetryWindowUntil = 0;
+      return;
+    }
+    const offset = resolveInitialScrollOffset(initialScroll);
+    const activeInitialTargetOffset = isInitialScrollInProgress ? (_b2 = scrollingTo.targetOffset) != null ? _b2 : scrollingTo.offset : void 0;
+    const didOffsetChange = initialScroll.contentOffset === void 0 || Math.abs(initialScroll.contentOffset - offset) > 1;
+    const didActiveInitialTargetChange = activeInitialTargetOffset !== void 0 && Math.abs(activeInitialTargetOffset - offset) > 1;
+    if (!didOffsetChange && (allowPostFinishRetry || isInitialScrollInProgress && !didActiveInitialTargetChange)) {
+      return;
+    }
+    if (didOffsetChange) {
       const updatedInitialScroll = { ...initialScroll, contentOffset: offset };
-      refState.current.initialScroll = updatedInitialScroll;
-      state.initialScroll = updatedInitialScroll;
-      scrollTo(ctx, {
-        animated: false,
-        index: initialScroll.index,
-        isInitialScroll: true,
-        offset,
-        precomputedWithViewOffset: true
-      });
+      if (!state.initialScrollUsesOffset) {
+        state.initialScrollLastTarget = updatedInitialScroll;
+        state.initialScrollLastTargetUsesOffset = false;
+        if (state.initialScroll) {
+          refState.current.initialScroll = updatedInitialScroll;
+          state.initialScroll = updatedInitialScroll;
+        }
+      }
     }
+    const hasMeasuredScrollLayout = !!state.lastLayout && state.scrollLength > 0;
+    const shouldForceNativeInitialScroll = state.initialScrollUsesOffset && hasMeasuredScrollLayout || allowPostFinishRetry || !!queuedInitialLayout || isInitialScrollInProgress && didOffsetChange;
+    performInitialScroll(ctx, {
+      forceScroll: shouldForceNativeInitialScroll,
+      initialScrollUsesOffset: state.initialScrollUsesOffset,
+      resolvedOffset: offset,
+      target: initialScroll
+    });
   }, []);
+  React3.useLayoutEffect(() => {
+    var _a4;
+    const previousDataLength = state.initialScrollPreviousDataLength;
+    state.initialScrollPreviousDataLength = dataProp.length;
+    if (previousDataLength !== 0 || dataProp.length === 0 || !state.initialScroll || !state.queuedInitialLayout) {
+      return;
+    }
+    if (initialScrollAtEnd) {
+      const lastIndex = Math.max(0, dataProp.length - 1);
+      const initialScroll = state.initialScroll;
+      const shouldRearm = shouldRearmFinishedEmptyInitialScrollAtEnd(initialScroll);
+      if (state.didFinishInitialScroll && !shouldRearm) {
+        return;
+      }
+      if (initialScroll && !state.initialScrollUsesOffset && initialScroll.index === lastIndex && initialScroll.viewPosition === 1 && !shouldRearm) {
+        return;
+      }
+      const updatedInitialScroll = {
+        contentOffset: void 0,
+        index: lastIndex,
+        viewOffset: (_a4 = initialScroll == null ? void 0 : initialScroll.viewOffset) != null ? _a4 : -stylePaddingBottomState,
+        viewPosition: 1
+      };
+      setActiveInitialScrollTarget(updatedInitialScroll, {
+        resetDidFinish: shouldRearm,
+        syncAnchor: true
+      });
+      doInitialScroll();
+      return;
+    }
+    if (state.didFinishInitialScroll) {
+      return;
+    }
+    doInitialScroll();
+  }, [
+    dataProp.length,
+    doInitialScroll,
+    initialScrollAtEnd,
+    shouldRearmFinishedEmptyInitialScrollAtEnd,
+    stylePaddingBottomState
+  ]);
+  React3.useLayoutEffect(() => {
+    var _a4;
+    if (!initialScrollAtEnd) {
+      return;
+    }
+    const lastIndex = Math.max(0, dataProp.length - 1);
+    const initialScroll = state.initialScroll;
+    const shouldRearm = shouldRearmFinishedEmptyInitialScrollAtEnd(initialScroll);
+    if (state.didFinishInitialScroll && !shouldRearm) {
+      return;
+    }
+    if (shouldRearm) {
+      state.didFinishInitialScroll = false;
+    }
+    if (initialScroll && !state.initialScrollUsesOffset && initialScroll.index === lastIndex && initialScroll.viewPosition === 1 && !shouldRearm) {
+      return;
+    }
+    const updatedInitialScroll = {
+      contentOffset: void 0,
+      index: lastIndex,
+      viewOffset: (_a4 = initialScroll == null ? void 0 : initialScroll.viewOffset) != null ? _a4 : -stylePaddingBottomState,
+      viewPosition: 1
+    };
+    setActiveInitialScrollTarget(updatedInitialScroll, {
+      resetDidFinish: shouldRearm,
+      syncAnchor: true
+    });
+    doInitialScroll();
+  }, [
+    dataProp.length,
+    doInitialScroll,
+    initialScrollAtEnd,
+    shouldRearmFinishedEmptyInitialScrollAtEnd,
+    stylePaddingBottomState
+  ]);
   const onLayoutFooter = React3.useCallback(
     (layout) => {
+      var _a4;
       if (!initialScrollAtEnd) {
         return;
       }
@@ -4653,16 +5149,48 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       const footerSize = layout[horizontal ? "width" : "height"];
       const viewOffset = -stylePaddingBottomState - footerSize;
       if (initialScroll.viewOffset !== viewOffset) {
+        const previousTargetOffset = (_a4 = initialScroll.contentOffset) != null ? _a4 : resolveInitialScrollOffset(initialScroll);
+        const didMoveAwayFromFinishedInitialTarget = state.didFinishInitialScroll && Math.abs(state.scroll - previousTargetOffset) > 1;
+        if (didMoveAwayFromFinishedInitialTarget) {
+          return;
+        }
         const updatedInitialScroll = { ...initialScroll, viewOffset };
-        refState.current.initialScroll = updatedInitialScroll;
-        state.initialScroll = updatedInitialScroll;
+        setActiveInitialScrollTarget(updatedInitialScroll, {
+          resetDidFinish: true
+        });
+        doInitialScroll();
       }
     },
-    [dataProp.length, horizontal, initialScrollAtEnd, stylePaddingBottomState]
+    [
+      dataProp.length,
+      doInitialScroll,
+      horizontal,
+      initialScrollAtEnd,
+      resolveInitialScrollOffset,
+      stylePaddingBottomState
+    ]
   );
   const onLayoutChange = React3.useCallback((layout) => {
-    doInitialScroll();
+    var _a4;
     handleLayout(ctx, layout, setCanRender);
+    const SCROLL_LENGTH_RETRY_WINDOW_MS = 600;
+    const now = Date.now();
+    const didFinishInitialScroll = !!state.didFinishInitialScroll;
+    if (didFinishInitialScroll && !state.initialScrollLastDidFinish) {
+      state.initialScrollRetryWindowUntil = now + SCROLL_LENGTH_RETRY_WINDOW_MS;
+    }
+    state.initialScrollLastDidFinish = didFinishInitialScroll;
+    const previousScrollLength = state.initialScrollRetryLastLength;
+    const currentScrollLength = state.scrollLength;
+    const didScrollLengthChange = previousScrollLength === void 0 || Math.abs(currentScrollLength - previousScrollLength) > 1;
+    if (didScrollLengthChange) {
+      state.initialScrollRetryLastLength = currentScrollLength;
+    }
+    if (didFinishInitialScroll && didScrollLengthChange && now <= state.initialScrollRetryWindowUntil && !state.initialScrollLastTargetUsesOffset && ((_a4 = state.initialScrollLastTarget) == null ? void 0 : _a4.index) !== void 0) {
+      doInitialScroll({ allowPostFinishRetry: true });
+      return;
+    }
+    doInitialScroll();
   }, []);
   const { onLayout } = useOnLayoutSync({
     onLayoutChange,
@@ -4774,7 +5302,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       onScroll: onScrollHandler,
       recycleItems,
       refreshControl: refreshControlElement ? stylePaddingTopState > 0 ? React3__namespace.cloneElement(refreshControlElement, {
-        progressViewOffset: ((_d = refreshControlElement.props.progressViewOffset) != null ? _d : 0) + stylePaddingTopState
+        progressViewOffset: ((_g = refreshControlElement.props.progressViewOffset) != null ? _g : 0) + stylePaddingTopState
       }) : refreshControlElement : onRefresh && /* @__PURE__ */ React3__namespace.createElement(
         RefreshControl,
         {
@@ -4785,7 +5313,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       ),
       refScrollView: combinedRef,
       renderScrollComponent,
-      scrollAdjustHandler: (_e = refState.current) == null ? void 0 : _e.scrollAdjustHandler,
+      scrollAdjustHandler: (_h = refState.current) == null ? void 0 : _h.scrollAdjustHandler,
       scrollEventThrottle: 0,
       snapToIndices,
       stickyHeaderIndices,