@legendapp/list 3.0.0-beta.43 → 3.0.0-beta.44

package/index.mjs

@@ -916,7 +916,7 @@ var ContainersInner = typedMemo(function ContainersInner2({ horizontal, numColum
   const ref = useRef(null);
   const ctx = useStateContext();
   const columnWrapperStyle = ctx.columnWrapperStyle;
-  const [totalSize, otherAxisSize] = useArr$(["totalSize", "otherAxisSize"]);
+  const [otherAxisSize, totalSize] = useArr$(["otherAxisSize", "totalSize"]);
   useDOMOrder(ref);
   const style = horizontal ? { minHeight: otherAxisSize, position: "relative", width: totalSize } : { height: totalSize, minWidth: otherAxisSize, position: "relative" };
   if (columnWrapperStyle && numColumns > 1) {
@@ -945,7 +945,6 @@ var Containers = typedMemo(function Containers2({
   horizontal,
   recycleItems,
   ItemSeparatorComponent,
-  waitForInitialLayout,
   updateItemSize: updateItemSize2,
   getRenderedItem: getRenderedItem2,
   stickyHeaderConfig
@@ -969,7 +968,7 @@ var Containers = typedMemo(function Containers2({
       )
     );
   }
-  return /* @__PURE__ */ React3.createElement(ContainersInner, { horizontal, numColumns, waitForInitialLayout }, containers);
+  return /* @__PURE__ */ React3.createElement(ContainersInner, { horizontal, numColumns }, containers);
 });
 
 // src/platform/StyleSheet.tsx
@@ -1420,7 +1419,6 @@ var ListComponent = typedMemo(function ListComponent2({
   recycleItems,
   ItemSeparatorComponent,
   alignItemsAtEnd: _alignItemsAtEnd,
-  waitForInitialLayout,
   onScroll: onScroll2,
   onLayout,
   ListHeaderComponent,
@@ -1483,7 +1481,7 @@ var ListComponent = typedMemo(function ListComponent2({
           height: "100%"
         } : {}
       ],
-      contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
+      contentOffset: initialContentOffset !== void 0 ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
       maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
@@ -1503,8 +1501,7 @@ var ListComponent = typedMemo(function ListComponent2({
         ItemSeparatorComponent,
         recycleItems,
         stickyHeaderConfig,
-        updateItemSize: updateItemSize2,
-        waitForInitialLayout
+        updateItemSize: updateItemSize2
       }
     ),
     ListFooterComponent && /* @__PURE__ */ React3.createElement(LayoutView, { onLayoutChange: onLayoutFooterInternal, style: ListFooterComponentStyle }, getComponent(ListFooterComponent)),
@@ -1617,6 +1614,13 @@ function getItemSize(ctx, key, index, data, useAverageSize, preferCachedSize) {
   setSize(ctx, key, size);
   return size;
 }
+function getItemSizeAtIndex(ctx, index) {
+  if (index === void 0 || index < 0) {
+    return void 0;
+  }
+  const targetId = getId(ctx.state, index);
+  return getItemSize(ctx, targetId, index, ctx.state.props.data[index]);
+}
 
 // src/core/calculateOffsetWithOffsetPosition.ts
 function calculateOffsetWithOffsetPosition(ctx, offsetParam, params) {
@@ -1667,6 +1671,373 @@ function clampScrollOffset(ctx, offset, scrollTarget) {
   return clampedOffset;
 }
 
+// src/core/deferredPublicOnScroll.ts
+function withResolvedContentOffset(state, event, resolvedOffset) {
+  return {
+    ...event,
+    nativeEvent: {
+      ...event.nativeEvent,
+      contentOffset: state.props.horizontal ? { x: resolvedOffset, y: 0 } : { x: 0, y: resolvedOffset }
+    }
+  };
+}
+function releaseDeferredPublicOnScroll(ctx, resolvedOffset) {
+  var _a3, _b, _c, _d;
+  const state = ctx.state;
+  const deferredEvent = state.deferredPublicOnScrollEvent;
+  state.deferredPublicOnScrollEvent = void 0;
+  if (deferredEvent) {
+    (_d = (_c = state.props).onScroll) == null ? void 0 : _d.call(
+      _c,
+      withResolvedContentOffset(
+        state,
+        deferredEvent,
+        (_b = (_a3 = resolvedOffset != null ? resolvedOffset : state.scrollPending) != null ? _a3 : state.scroll) != null ? _b : 0
+      )
+    );
+  }
+}
+
+// src/core/initialScrollSession.ts
+var INITIAL_SCROLL_MIN_TARGET_OFFSET = 1;
+function hasInitialScrollSessionCompletion(completion) {
+  return !!((completion == null ? void 0 : completion.didDispatchNativeScroll) || (completion == null ? void 0 : completion.didRetrySilentInitialScroll) || (completion == null ? void 0 : completion.watchdog));
+}
+function clearInitialScrollSession(state) {
+  state.initialScrollSession = void 0;
+  return void 0;
+}
+function createInitialScrollSession(options) {
+  const { bootstrap, completion, kind, previousDataLength } = options;
+  return kind === "offset" ? {
+    completion,
+    kind,
+    previousDataLength
+  } : {
+    bootstrap,
+    completion,
+    kind,
+    previousDataLength
+  };
+}
+function ensureInitialScrollSessionCompletion(state, kind = ((_b) => (_b = ((_a3) => (_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind)()) != null ? _b : "bootstrap")()) {
+  var _a4, _b2;
+  if (!state.initialScrollSession) {
+    state.initialScrollSession = createInitialScrollSession({
+      completion: {},
+      kind,
+      previousDataLength: 0
+    });
+  } else if (state.initialScrollSession.kind !== kind) {
+    state.initialScrollSession = createInitialScrollSession({
+      bootstrap: state.initialScrollSession.kind === "bootstrap" ? state.initialScrollSession.bootstrap : void 0,
+      completion: state.initialScrollSession.completion,
+      kind,
+      previousDataLength: state.initialScrollSession.previousDataLength
+    });
+  }
+  (_b2 = (_a4 = state.initialScrollSession).completion) != null ? _b2 : _a4.completion = {};
+  return state.initialScrollSession.completion;
+}
+var initialScrollCompletion = {
+  didDispatchNativeScroll(state) {
+    var _a3, _b;
+    return !!((_b = (_a3 = state.initialScrollSession) == null ? void 0 : _a3.completion) == null ? void 0 : _b.didDispatchNativeScroll);
+  },
+  didRetrySilentInitialScroll(state) {
+    var _a3, _b;
+    return !!((_b = (_a3 = state.initialScrollSession) == null ? void 0 : _a3.completion) == null ? void 0 : _b.didRetrySilentInitialScroll);
+  },
+  markInitialScrollNativeDispatch(state) {
+    ensureInitialScrollSessionCompletion(state).didDispatchNativeScroll = true;
+  },
+  markSilentInitialScrollRetry(state) {
+    ensureInitialScrollSessionCompletion(state).didRetrySilentInitialScroll = true;
+  },
+  resetFlags(state) {
+    if (!state.initialScrollSession) {
+      return;
+    }
+    const completion = ensureInitialScrollSessionCompletion(state, state.initialScrollSession.kind);
+    completion.didDispatchNativeScroll = void 0;
+    completion.didRetrySilentInitialScroll = void 0;
+  }
+};
+var initialScrollWatchdog = {
+  clear(state) {
+    initialScrollWatchdog.set(state, void 0);
+  },
+  didObserveProgress(newScroll, watchdog) {
+    const previousDistance = Math.abs(watchdog.startScroll - watchdog.targetOffset);
+    const nextDistance = Math.abs(newScroll - watchdog.targetOffset);
+    return nextDistance <= INITIAL_SCROLL_MIN_TARGET_OFFSET || nextDistance + INITIAL_SCROLL_MIN_TARGET_OFFSET < previousDistance;
+  },
+  get(state) {
+    var _a3, _b;
+    return (_b = (_a3 = state.initialScrollSession) == null ? void 0 : _a3.completion) == null ? void 0 : _b.watchdog;
+  },
+  hasNonZeroTargetOffset(targetOffset) {
+    return targetOffset !== void 0 && targetOffset > INITIAL_SCROLL_MIN_TARGET_OFFSET;
+  },
+  isAtZeroTargetOffset(targetOffset) {
+    return targetOffset <= INITIAL_SCROLL_MIN_TARGET_OFFSET;
+  },
+  set(state, watchdog) {
+    var _a3, _b;
+    if (!watchdog && !((_b = (_a3 = state.initialScrollSession) == null ? void 0 : _a3.completion) == null ? void 0 : _b.watchdog)) {
+      return;
+    }
+    const completion = ensureInitialScrollSessionCompletion(state);
+    completion.watchdog = watchdog ? {
+      startScroll: watchdog.startScroll,
+      targetOffset: watchdog.targetOffset
+    } : void 0;
+  }
+};
+function setInitialScrollSession(state, options = {}) {
+  var _a3, _b, _c;
+  const existingSession = state.initialScrollSession;
+  const kind = (_a3 = options.kind) != null ? _a3 : existingSession == null ? void 0 : existingSession.kind;
+  const completion = existingSession == null ? void 0 : existingSession.completion;
+  const hasBootstrapOverride = Object.hasOwn(options, "bootstrap");
+  const bootstrap = kind === "bootstrap" ? hasBootstrapOverride ? options.bootstrap : (existingSession == null ? void 0 : existingSession.kind) === "bootstrap" ? existingSession.bootstrap : void 0 : void 0;
+  if (!kind) {
+    return clearInitialScrollSession(state);
+  }
+  if (!state.initialScroll && !bootstrap && !hasInitialScrollSessionCompletion(completion)) {
+    return clearInitialScrollSession(state);
+  }
+  const previousDataLength = (_c = (_b = options.previousDataLength) != null ? _b : existingSession == null ? void 0 : existingSession.previousDataLength) != null ? _c : 0;
+  state.initialScrollSession = createInitialScrollSession({
+    bootstrap,
+    completion,
+    kind,
+    previousDataLength
+  });
+  return state.initialScrollSession;
+}
+
+// src/core/finishScrollTo.ts
+function finishScrollTo(ctx) {
+  var _a3, _b;
+  const state = ctx.state;
+  if (state == null ? void 0 : state.scrollingTo) {
+    const resolvePendingScroll = state.pendingScrollResolve;
+    state.pendingScrollResolve = void 0;
+    const scrollingTo = state.scrollingTo;
+    state.scrollHistory.length = 0;
+    state.scrollingTo = void 0;
+    if (state.pendingTotalSize !== void 0) {
+      addTotalSize(ctx, null, state.pendingTotalSize);
+    }
+    {
+      state.scrollAdjustHandler.commitPendingAdjust(scrollingTo);
+    }
+    if (scrollingTo.isInitialScroll || state.initialScroll) {
+      const isOffsetSession = ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset";
+      finishInitialScroll(ctx, {
+        onFinished: resolvePendingScroll,
+        preserveTarget: isOffsetSession && state.props.data.length === 0 || !!scrollingTo.isInitialScroll && !!((_b = state.initialScroll) == null ? void 0 : _b.preserveForFooterLayout),
+        recalculateItems: true,
+        syncObservedOffset: isOffsetSession,
+        waitForCompletionFrame: !!scrollingTo.waitForInitialScrollCompletionFrame
+      });
+      return;
+    }
+    resolvePendingScroll == null ? void 0 : resolvePendingScroll();
+  }
+}
+
+// src/core/doScrollTo.ts
+var SCROLL_END_IDLE_MS = 80;
+var SCROLL_END_MAX_MS = 1500;
+var SMOOTH_SCROLL_DURATION_MS = 320;
+var SCROLL_END_TARGET_EPSILON = 1;
+function doScrollTo(ctx, params) {
+  const state = ctx.state;
+  const { animated, horizontal, offset } = params;
+  const scroller = state.refScroller.current;
+  const node = scroller == null ? void 0 : scroller.getScrollableNode();
+  if (!scroller || !node) {
+    return;
+  }
+  const isAnimated = !!animated;
+  const isHorizontal = !!horizontal;
+  const left = isHorizontal ? offset : 0;
+  const top = isHorizontal ? 0 : offset;
+  scroller.scrollTo({ animated: isAnimated, x: left, y: top });
+  if (isAnimated) {
+    const target = scroller.getScrollEventTarget();
+    listenForScrollEnd(ctx, {
+      readOffset: () => scroller.getCurrentScrollOffset(),
+      target,
+      targetOffset: offset
+    });
+  } else {
+    state.scroll = offset;
+    setTimeout(() => {
+      finishScrollTo(ctx);
+    }, 100);
+  }
+}
+function listenForScrollEnd(ctx, params) {
+  const { readOffset, target, targetOffset } = params;
+  if (!target) {
+    finishScrollTo(ctx);
+    return;
+  }
+  const supportsScrollEnd = "onscrollend" in target;
+  let idleTimeout;
+  let settled = false;
+  const targetToken = ctx.state.scrollingTo;
+  const maxTimeout = setTimeout(() => finish("max"), SCROLL_END_MAX_MS);
+  const cleanup = () => {
+    target.removeEventListener("scroll", onScroll2);
+    if (supportsScrollEnd) {
+      target.removeEventListener("scrollend", onScrollEnd);
+    }
+    if (idleTimeout) {
+      clearTimeout(idleTimeout);
+    }
+    clearTimeout(maxTimeout);
+  };
+  const finish = (reason) => {
+    if (settled) return;
+    if (targetToken !== ctx.state.scrollingTo) {
+      settled = true;
+      cleanup();
+      return;
+    }
+    const currentOffset = readOffset();
+    const isNearTarget = Math.abs(currentOffset - targetOffset) <= SCROLL_END_TARGET_EPSILON;
+    if (reason === "scrollend" && !isNearTarget) {
+      return;
+    }
+    settled = true;
+    cleanup();
+    finishScrollTo(ctx);
+  };
+  const onScroll2 = () => {
+    if (idleTimeout) {
+      clearTimeout(idleTimeout);
+    }
+    idleTimeout = setTimeout(() => finish("idle"), SCROLL_END_IDLE_MS);
+  };
+  const onScrollEnd = () => finish("scrollend");
+  target.addEventListener("scroll", onScroll2);
+  if (supportsScrollEnd) {
+    target.addEventListener("scrollend", onScrollEnd);
+  } else {
+    idleTimeout = setTimeout(() => finish("idle"), SMOOTH_SCROLL_DURATION_MS);
+  }
+}
+
+// src/core/scrollTo.ts
+function syncInitialScrollNativeWatchdog(state, options) {
+  var _a3;
+  const { isInitialScroll, requestedOffset, targetOffset } = options;
+  const existingWatchdog = initialScrollWatchdog.get(state);
+  const shouldWatchInitialNativeScroll = !state.didFinishInitialScroll && (isInitialScroll || !!existingWatchdog) && initialScrollWatchdog.hasNonZeroTargetOffset(targetOffset);
+  const shouldClearInitialNativeScrollWatchdog = !state.didFinishInitialScroll && !!existingWatchdog && initialScrollWatchdog.isAtZeroTargetOffset(requestedOffset);
+  if (shouldWatchInitialNativeScroll) {
+    state.hasScrolled = false;
+    initialScrollWatchdog.set(state, {
+      startScroll: (_a3 = existingWatchdog == null ? void 0 : existingWatchdog.startScroll) != null ? _a3 : state.scroll,
+      targetOffset
+    });
+    return;
+  }
+  if (shouldClearInitialNativeScrollWatchdog) {
+    initialScrollWatchdog.clear(state);
+  }
+}
+function scrollTo(ctx, params) {
+  var _a3;
+  const state = ctx.state;
+  const { noScrollingTo, forceScroll, ...scrollTarget } = params;
+  const {
+    animated,
+    isInitialScroll,
+    offset: scrollTargetOffset,
+    precomputedWithViewOffset,
+    waitForInitialScrollCompletionFrame
+  } = scrollTarget;
+  const {
+    props: { horizontal }
+  } = state;
+  if (state.animFrameCheckFinishedScroll) {
+    cancelAnimationFrame(ctx.state.animFrameCheckFinishedScroll);
+  }
+  if (state.timeoutCheckFinishedScrollFallback) {
+    clearTimeout(ctx.state.timeoutCheckFinishedScrollFallback);
+  }
+  const requestedOffset = precomputedWithViewOffset ? scrollTargetOffset : calculateOffsetWithOffsetPosition(ctx, scrollTargetOffset, scrollTarget);
+  const shouldPreserveRawInitialOffsetRequest = !!isInitialScroll && ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset";
+  const targetOffset = clampScrollOffset(ctx, requestedOffset, scrollTarget);
+  const offset = shouldPreserveRawInitialOffsetRequest ? requestedOffset : targetOffset;
+  state.scrollHistory.length = 0;
+  if (!noScrollingTo) {
+    if (isInitialScroll) {
+      initialScrollCompletion.resetFlags(state);
+    }
+    state.scrollingTo = {
+      ...scrollTarget,
+      targetOffset,
+      waitForInitialScrollCompletionFrame
+    };
+  }
+  state.scrollPending = targetOffset;
+  syncInitialScrollNativeWatchdog(state, { isInitialScroll, requestedOffset: offset, targetOffset });
+  if (forceScroll || !isInitialScroll || Platform.OS === "android") {
+    doScrollTo(ctx, { animated, horizontal, offset });
+  } else {
+    state.scroll = offset;
+  }
+}
+
+// src/core/scrollToIndex.ts
+function clampScrollIndex(index, dataLength) {
+  if (dataLength <= 0) {
+    return -1;
+  }
+  if (index >= dataLength) {
+    return dataLength - 1;
+  }
+  if (index < 0) {
+    return 0;
+  }
+  return index;
+}
+function scrollToIndex(ctx, {
+  index,
+  viewOffset = 0,
+  animated = true,
+  forceScroll,
+  isInitialScroll,
+  viewPosition
+}) {
+  const state = ctx.state;
+  const { data } = state.props;
+  index = clampScrollIndex(index, data.length);
+  const itemSize = getItemSizeAtIndex(ctx, index);
+  const firstIndexOffset = calculateOffsetForIndex(ctx, index);
+  const isLast = index === data.length - 1;
+  if (isLast && viewPosition === void 0) {
+    viewPosition = 1;
+  }
+  state.scrollForNextCalculateItemsInView = void 0;
+  scrollTo(ctx, {
+    animated,
+    forceScroll,
+    index,
+    isInitialScroll,
+    itemSize,
+    offset: firstIndexOffset,
+    viewOffset,
+    viewPosition: viewPosition != null ? viewPosition : 0
+  });
+}
+
 // src/utils/checkThreshold.ts
 var HYSTERESIS_MULTIPLIER = 1.3;
 var checkThreshold = (distance, atThreshold, threshold, wasReached, snapshot, context, onReached, setSnapshot, allowReentryOnChange) => {
@@ -1835,202 +2206,867 @@ function setInitialRenderState(ctx, {
   }
 }
 
-// src/core/finishScrollTo.ts
-function finishScrollTo(ctx) {
-  var _a3, _b;
+// src/core/initialScroll.ts
+function syncInitialScrollOffset(state, offset) {
+  state.scroll = offset;
+  state.scrollPending = offset;
+  state.scrollPrev = offset;
+}
+function dispatchInitialScroll(ctx, params) {
+  const { forceScroll, resolvedOffset, target, waitForCompletionFrame } = params;
+  const requestedIndex = target.index;
+  const index = requestedIndex !== void 0 ? clampScrollIndex(requestedIndex, ctx.state.props.data.length) : void 0;
+  const itemSize = getItemSizeAtIndex(ctx, index);
+  scrollTo(ctx, {
+    animated: false,
+    forceScroll,
+    index: index !== void 0 && index >= 0 ? index : void 0,
+    isInitialScroll: true,
+    itemSize,
+    offset: resolvedOffset,
+    precomputedWithViewOffset: true,
+    viewOffset: target.viewOffset,
+    viewPosition: target.viewPosition,
+    waitForInitialScrollCompletionFrame: waitForCompletionFrame
+  });
+}
+function setInitialScrollTarget(state, target, options) {
+  var _a3;
+  state.initialScroll = target;
+  if ((options == null ? void 0 : options.resetDidFinish) && state.didFinishInitialScroll) {
+    state.didFinishInitialScroll = false;
+  }
+  setInitialScrollSession(state, {
+    kind: ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset" ? "offset" : "bootstrap"
+  });
+}
+function finishInitialScroll(ctx, options) {
+  var _a3, _b, _c;
   const state = ctx.state;
-  if (state == null ? void 0 : state.scrollingTo) {
-    const resolvePendingScroll = state.pendingScrollResolve;
-    state.pendingScrollResolve = void 0;
-    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);
-    }
-    if ((_a3 = state.props) == null ? void 0 : _a3.data) {
-      (_b = state.triggerCalculateItemsInView) == null ? void 0 : _b.call(state, { forceFullItemPositions: true });
-    }
-    {
-      state.scrollAdjustHandler.commitPendingAdjust(scrollingTo);
+  if ((options == null ? void 0 : options.resolvedOffset) !== void 0) {
+    syncInitialScrollOffset(state, options.resolvedOffset);
+  } else if ((options == null ? void 0 : options.syncObservedOffset) && ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset") {
+    const observedOffset = (_c = (_b = state.refScroller.current) == null ? void 0 : _b.getCurrentScrollOffset) == null ? void 0 : _c.call(_b);
+    if (typeof observedOffset === "number" && Number.isFinite(observedOffset)) {
+      syncInitialScrollOffset(state, observedOffset);
+    }
+  }
+  const complete = () => {
+    var _a4, _b2, _c2, _d, _e, _f, _g;
+    const shouldReleaseDeferredPublicOnScroll = ((_a4 = state.initialScrollSession) == null ? void 0 : _a4.kind) === "bootstrap";
+    const finalScrollOffset = (_d = (_c2 = (_b2 = options == null ? void 0 : options.resolvedOffset) != null ? _b2 : state.scrollPending) != null ? _c2 : state.scroll) != null ? _d : 0;
+    initialScrollWatchdog.clear(state);
+    if (!(options == null ? void 0 : options.preserveTarget)) {
+      state.initialScroll = void 0;
+    }
+    setInitialScrollSession(state);
+    if ((options == null ? void 0 : options.recalculateItems) && ((_e = state.props) == null ? void 0 : _e.data)) {
+      (_f = state.triggerCalculateItemsInView) == null ? void 0 : _f.call(state, { forceFullItemPositions: true });
+    }
+    if (options == null ? void 0 : options.recalculateItems) {
+      checkThresholds(ctx);
     }
     setInitialRenderState(ctx, { didInitialScroll: true });
-    checkThresholds(ctx);
-    resolvePendingScroll == null ? void 0 : resolvePendingScroll();
+    if (shouldReleaseDeferredPublicOnScroll) {
+      releaseDeferredPublicOnScroll(ctx, finalScrollOffset);
+    }
+    (_g = options == null ? void 0 : options.onFinished) == null ? void 0 : _g.call(options);
+  };
+  if (options == null ? void 0 : options.waitForCompletionFrame) {
+    requestAnimationFrame(complete);
+    return;
   }
+  complete();
 }
-
-// src/core/doScrollTo.ts
-var SCROLL_END_IDLE_MS = 80;
-var SCROLL_END_MAX_MS = 1500;
-var SMOOTH_SCROLL_DURATION_MS = 320;
-var SCROLL_END_TARGET_EPSILON = 1;
-function doScrollTo(ctx, params) {
+function resolveInitialScrollOffset(ctx, initialScroll) {
+  var _a3, _b;
   const state = ctx.state;
-  const { animated, horizontal, offset } = params;
-  const scroller = state.refScroller.current;
-  const node = scroller == null ? void 0 : scroller.getScrollableNode();
-  if (!scroller || !node) {
+  if (((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset") {
+    return (_b = initialScroll.contentOffset) != null ? _b : 0;
+  }
+  const baseOffset = initialScroll.index !== void 0 ? calculateOffsetForIndex(ctx, initialScroll.index) : 0;
+  const resolvedOffset = calculateOffsetWithOffsetPosition(ctx, baseOffset, initialScroll);
+  return clampScrollOffset(ctx, resolvedOffset, initialScroll);
+}
+function getAdvanceableInitialScrollState(state, options) {
+  const { didFinishInitialScroll, queuedInitialLayout, scrollingTo } = state;
+  const initialScroll = state.initialScroll;
+  const isInitialScrollInProgress = !!(scrollingTo == null ? void 0 : scrollingTo.isInitialScroll);
+  const shouldWaitForInitialLayout = !!(options == null ? void 0 : options.requiresMeasuredLayout) && !queuedInitialLayout && !isInitialScrollInProgress;
+  if (!initialScroll || shouldWaitForInitialLayout || didFinishInitialScroll || scrollingTo && !isInitialScrollInProgress) {
+    return void 0;
+  }
+  return {
+    initialScroll,
+    isInitialScrollInProgress,
+    queuedInitialLayout,
+    scrollingTo
+  };
+}
+function advanceMeasuredInitialScroll(ctx, options) {
+  var _a3, _b, _c;
+  const state = ctx.state;
+  const advanceableState = getAdvanceableInitialScrollState(state, {
+    requiresMeasuredLayout: true
+  });
+  if (!advanceableState) {
+    return false;
+  }
+  const { initialScroll, isInitialScrollInProgress, queuedInitialLayout } = advanceableState;
+  const scrollingTo = isInitialScrollInProgress ? advanceableState.scrollingTo : void 0;
+  const resolvedOffset = resolveInitialScrollOffset(ctx, initialScroll);
+  const activeInitialTargetOffset = scrollingTo ? (_a3 = scrollingTo.targetOffset) != null ? _a3 : scrollingTo.offset : void 0;
+  const didOffsetChange = initialScroll.contentOffset === void 0 || Math.abs(initialScroll.contentOffset - resolvedOffset) > 1;
+  const didActiveInitialTargetChange = activeInitialTargetOffset !== void 0 && Math.abs(activeInitialTargetOffset - resolvedOffset) > 1;
+  const isAlreadyAtDesiredInitialTarget = activeInitialTargetOffset !== void 0 && Math.abs(state.scroll - activeInitialTargetOffset) <= 1 && Math.abs(state.scrollPending - activeInitialTargetOffset) <= 1;
+  if (!(options == null ? void 0 : options.forceScroll) && !didOffsetChange && isInitialScrollInProgress && !didActiveInitialTargetChange) {
+    return false;
+  }
+  if ((options == null ? void 0 : options.forceScroll) && isAlreadyAtDesiredInitialTarget) {
+    return false;
+  }
+  if (didOffsetChange && ((_b = state.initialScrollSession) == null ? void 0 : _b.kind) !== "offset") {
+    setInitialScrollTarget(state, { ...initialScroll, contentOffset: resolvedOffset });
+  }
+  const forceScroll = (_c = options == null ? void 0 : options.forceScroll) != null ? _c : !!queuedInitialLayout || isInitialScrollInProgress && didOffsetChange;
+  dispatchInitialScroll(ctx, {
+    forceScroll,
+    resolvedOffset,
+    target: initialScroll
+  });
+  return true;
+}
+function advanceOffsetInitialScroll(ctx, options) {
+  var _a3, _b;
+  const state = ctx.state;
+  const advanceableState = getAdvanceableInitialScrollState(state);
+  if (!advanceableState) {
+    return false;
+  }
+  const { initialScroll, queuedInitialLayout } = advanceableState;
+  const resolvedOffset = (_a3 = initialScroll.contentOffset) != null ? _a3 : 0;
+  const isAlreadyAtDesiredInitialTarget = Math.abs(state.scroll - resolvedOffset) <= 1 && Math.abs(state.scrollPending - resolvedOffset) <= 1;
+  if ((options == null ? void 0 : options.forceScroll) && isAlreadyAtDesiredInitialTarget) {
+    return false;
+  }
+  const hasMeasuredScrollLayout = !!state.lastLayout && state.scrollLength > 0;
+  const forceScroll = (_b = options == null ? void 0 : options.forceScroll) != null ? _b : hasMeasuredScrollLayout || !!queuedInitialLayout;
+  dispatchInitialScroll(ctx, {
+    forceScroll,
+    resolvedOffset,
+    target: initialScroll
+  });
+  return true;
+}
+function advanceCurrentInitialScrollSession(ctx, options) {
+  var _a3;
+  return ((_a3 = ctx.state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset" ? advanceOffsetInitialScroll(ctx, {
+    forceScroll: options == null ? void 0 : options.forceScroll
+  }) : advanceMeasuredInitialScroll(ctx, {
+    forceScroll: options == null ? void 0 : options.forceScroll
+  });
+}
+
+// src/utils/checkAllSizesKnown.ts
+function isNullOrUndefined2(value) {
+  return value === null || value === void 0;
+}
+function getMountedBufferedIndices(state) {
+  const { startBuffered, endBuffered } = state;
+  if (!isNullOrUndefined2(endBuffered) && !isNullOrUndefined2(startBuffered) && startBuffered >= 0 && endBuffered >= 0) {
+    return Array.from(state.containerItemKeys.keys()).map((key) => state.indexByKey.get(key)).filter((index) => index !== void 0 && index >= startBuffered && index <= endBuffered).sort((a, b) => a - b);
+  }
+  return [];
+}
+function checkAllSizesKnown(state, indices = getMountedBufferedIndices(state)) {
+  return indices.length > 0 && indices.every((index) => {
+    const key = getId(state, index);
+    return state.sizesKnown.has(key);
+  });
+}
+
+// src/core/bootstrapInitialScroll.ts
+var DEFAULT_BOOTSTRAP_REVEAL_EPSILON = 1;
+var DEFAULT_BOOTSTRAP_REVEAL_MAX_FRAMES = 8;
+var DEFAULT_BOOTSTRAP_REVEAL_MAX_PASSES = 24;
+var BOOTSTRAP_REVEAL_ABORT_WARNING = "LegendList bootstrap initial scroll aborted after exceeding convergence bounds.";
+function getBootstrapInitialScrollSession(state) {
+  var _a3;
+  return ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "bootstrap" ? state.initialScrollSession.bootstrap : void 0;
+}
+function isOffsetInitialScrollSession(state) {
+  var _a3;
+  return ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "offset";
+}
+function doVisibleIndicesMatch(previous, next) {
+  if (!previous || previous.length !== next.length) {
+    return false;
+  }
+  for (let i = 0; i < previous.length; i++) {
+    if (previous[i] !== next[i]) {
+      return false;
+    }
+  }
+  return true;
+}
+function getBootstrapRevealVisibleIndices(options) {
+  const { dataLength, getSize, offset, positions, scrollLength, startIndex: requestedStartIndex } = options;
+  const endOffset = offset + scrollLength;
+  const visibleIndices = [];
+  let index = requestedStartIndex !== void 0 ? Math.max(0, Math.min(dataLength - 1, requestedStartIndex)) : 0;
+  while (index > 0) {
+    const previousIndex = index - 1;
+    const previousPosition = positions[previousIndex];
+    if (previousPosition === void 0) {
+      index = previousIndex;
+      continue;
+    }
+    const previousSize = getSize(previousIndex);
+    if (previousSize === void 0) {
+      index = previousIndex;
+      continue;
+    }
+    if (previousPosition + previousSize <= offset) {
+      break;
+    }
+    index = previousIndex;
+  }
+  for (; index < dataLength; index++) {
+    const position = positions[index];
+    if (position === void 0) {
+      continue;
+    }
+    const size = getSize(index);
+    if (size === void 0) {
+      continue;
+    }
+    if (position < endOffset && position + size > offset) {
+      visibleIndices.push(index);
+    } else if (visibleIndices.length > 0 && position >= endOffset) {
+      break;
+    }
+  }
+  return visibleIndices;
+}
+function shouldAbortBootstrapReveal(options) {
+  const {
+    mountFrameCount,
+    maxFrames = DEFAULT_BOOTSTRAP_REVEAL_MAX_FRAMES,
+    maxPasses = DEFAULT_BOOTSTRAP_REVEAL_MAX_PASSES,
+    passCount
+  } = options;
+  return mountFrameCount >= maxFrames || passCount >= maxPasses;
+}
+function abortBootstrapRevealIfNeeded(ctx, options) {
+  if (!shouldAbortBootstrapReveal(options)) {
+    return false;
+  }
+  if (IS_DEV) {
+    console.warn(BOOTSTRAP_REVEAL_ABORT_WARNING);
+  }
+  abortBootstrapInitialScroll(ctx);
+  return true;
+}
+function clearBootstrapInitialScrollSession(state) {
+  var _a3;
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  const frameHandle = bootstrapInitialScroll == null ? void 0 : bootstrapInitialScroll.frameHandle;
+  if (frameHandle !== void 0 && typeof cancelAnimationFrame === "function") {
+    cancelAnimationFrame(frameHandle);
+  }
+  if (bootstrapInitialScroll) {
+    bootstrapInitialScroll.frameHandle = void 0;
+  }
+  setInitialScrollSession(state, {
+    bootstrap: void 0,
+    kind: (_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind
+  });
+}
+function startBootstrapInitialScrollSession(state, options) {
+  var _a3, _b, _c;
+  const previousBootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  setInitialScrollSession(state, {
+    bootstrap: {
+      frameHandle: previousBootstrapInitialScroll == null ? void 0 : previousBootstrapInitialScroll.frameHandle,
+      // Re-arming during the initial mount should spend from the same watchdog budget.
+      mountFrameCount: (_a3 = previousBootstrapInitialScroll == null ? void 0 : previousBootstrapInitialScroll.mountFrameCount) != null ? _a3 : 0,
+      passCount: 0,
+      previousResolvedOffset: void 0,
+      scroll: options.scroll,
+      seedContentOffset: (_c = (_b = options.seedContentOffset) != null ? _b : previousBootstrapInitialScroll == null ? void 0 : previousBootstrapInitialScroll.seedContentOffset) != null ? _c : options.scroll,
+      targetIndexSeed: options.targetIndexSeed,
+      visibleIndices: void 0
+    },
+    kind: "bootstrap"
+  });
+}
+function resetBootstrapInitialScrollSession(state, options) {
+  var _a3, _b, _c;
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  if (!bootstrapInitialScroll) {
+    if ((options == null ? void 0 : options.scroll) !== void 0) {
+      startBootstrapInitialScrollSession(state, {
+        scroll: options.scroll,
+        seedContentOffset: options.seedContentOffset,
+        targetIndexSeed: options.targetIndexSeed
+      });
+    }
+  } else {
+    bootstrapInitialScroll.passCount = 0;
+    bootstrapInitialScroll.previousResolvedOffset = void 0;
+    bootstrapInitialScroll.scroll = (_a3 = options == null ? void 0 : options.scroll) != null ? _a3 : bootstrapInitialScroll.scroll;
+    bootstrapInitialScroll.seedContentOffset = (_b = options == null ? void 0 : options.seedContentOffset) != null ? _b : bootstrapInitialScroll.seedContentOffset;
+    bootstrapInitialScroll.targetIndexSeed = (_c = options == null ? void 0 : options.targetIndexSeed) != null ? _c : bootstrapInitialScroll.targetIndexSeed;
+    bootstrapInitialScroll.visibleIndices = void 0;
+    setInitialScrollSession(state, {
+      bootstrap: bootstrapInitialScroll,
+      kind: "bootstrap"
+    });
+  }
+}
+function queueBootstrapInitialScrollReevaluation(state) {
+  requestAnimationFrame(() => {
+    var _a3;
+    if (getBootstrapInitialScrollSession(state)) {
+      (_a3 = state.triggerCalculateItemsInView) == null ? void 0 : _a3.call(state, { forceFullItemPositions: true });
+    }
+  });
+}
+function ensureBootstrapInitialScrollFrameTicker(ctx) {
+  const state = ctx.state;
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  if (!bootstrapInitialScroll || bootstrapInitialScroll.frameHandle !== void 0) {
     return;
   }
-  const isAnimated = !!animated;
-  const isHorizontal = !!horizontal;
-  const left = isHorizontal ? offset : 0;
-  const top = isHorizontal ? 0 : offset;
-  scroller.scrollTo({ animated: isAnimated, x: left, y: top });
-  if (isAnimated) {
-    const target = scroller.getScrollEventTarget();
-    listenForScrollEnd(ctx, {
-      readOffset: () => scroller.getCurrentScrollOffset(),
-      target,
-      targetOffset: offset
+  const tick = () => {
+    const activeBootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+    if (!activeBootstrapInitialScroll) {
+      return;
+    }
+    activeBootstrapInitialScroll.frameHandle = void 0;
+    activeBootstrapInitialScroll.mountFrameCount += 1;
+    if (abortBootstrapRevealIfNeeded(ctx, {
+      mountFrameCount: activeBootstrapInitialScroll.mountFrameCount,
+      passCount: activeBootstrapInitialScroll.passCount
+    })) {
+      return;
+    }
+    ensureBootstrapInitialScrollFrameTicker(ctx);
+  };
+  bootstrapInitialScroll.frameHandle = requestAnimationFrame(tick);
+}
+function rearmBootstrapInitialScroll(ctx, options) {
+  resetBootstrapInitialScrollSession(ctx.state, options);
+  ensureBootstrapInitialScrollFrameTicker(ctx);
+  queueBootstrapInitialScrollReevaluation(ctx.state);
+}
+function createInitialScrollAtEndTarget(options) {
+  const { dataLength, footerSize, preserveForFooterLayout, stylePaddingBottom } = options;
+  return {
+    contentOffset: void 0,
+    index: Math.max(0, dataLength - 1),
+    preserveForBottomPadding: true,
+    preserveForFooterLayout,
+    viewOffset: -stylePaddingBottom - footerSize,
+    viewPosition: 1
+  };
+}
+function shouldPreserveInitialScrollForBottomPadding(target) {
+  return !!(target == null ? void 0 : target.preserveForBottomPadding);
+}
+function shouldPreserveInitialScrollForFooterLayout(target) {
+  return !!(target == null ? void 0 : target.preserveForFooterLayout);
+}
+function isRetargetableBottomAlignedInitialScrollTarget(target) {
+  return !!(target && target.viewPosition === 1 && (shouldPreserveInitialScrollForBottomPadding(target) || shouldPreserveInitialScrollForFooterLayout(target)));
+}
+function createRetargetedBottomAlignedInitialScroll(options) {
+  const { dataLength, footerSize, initialScrollAtEnd, stylePaddingBottom, target } = options;
+  const preserveForFooterLayout = shouldPreserveInitialScrollForFooterLayout(target);
+  return {
+    ...target,
+    contentOffset: void 0,
+    index: initialScrollAtEnd ? Math.max(0, dataLength - 1) : target.index,
+    preserveForBottomPadding: true,
+    preserveForFooterLayout,
+    viewOffset: -stylePaddingBottom - (preserveForFooterLayout ? footerSize : 0),
+    viewPosition: 1
+  };
+}
+function areEquivalentBootstrapInitialScrollTargets(current, next) {
+  return current.index === next.index && current.preserveForBottomPadding === next.preserveForBottomPadding && current.preserveForFooterLayout === next.preserveForFooterLayout && current.viewOffset === next.viewOffset && current.viewPosition === next.viewPosition;
+}
+function clearPendingInitialScrollFooterLayout(state, target) {
+  if (!shouldPreserveInitialScrollForFooterLayout(target)) {
+    return;
+  }
+  if (state.didFinishInitialScroll && !getBootstrapInitialScrollSession(state)) {
+    state.initialScroll = void 0;
+    setInitialScrollSession(state);
+    return;
+  }
+  setInitialScrollTarget(state, { ...target, preserveForFooterLayout: void 0 });
+}
+function didFinishedInitialScrollMoveAwayFromTarget(ctx, target, epsilon = DEFAULT_BOOTSTRAP_REVEAL_EPSILON) {
+  const state = ctx.state;
+  if (!state.didFinishInitialScroll) {
+    return false;
+  }
+  const currentOffset = getObservedBootstrapInitialScrollOffset(state);
+  return Math.abs(currentOffset - resolveInitialScrollOffset(ctx, target)) > epsilon;
+}
+function getObservedBootstrapInitialScrollOffset(state) {
+  var _a3, _b, _c, _d;
+  const observedOffset = (_b = (_a3 = state.refScroller.current) == null ? void 0 : _a3.getCurrentScrollOffset) == null ? void 0 : _b.call(_a3);
+  return typeof observedOffset === "number" && Number.isFinite(observedOffset) ? observedOffset : (_d = (_c = state.scrollPending) != null ? _c : state.scroll) != null ? _d : 0;
+}
+function startBootstrapInitialScrollOnMount(ctx, options) {
+  var _a3, _b, _c;
+  const { initialScrollAtEnd, target } = options;
+  const state = ctx.state;
+  const offset = resolveInitialScrollOffset(ctx, target);
+  const shouldFinishAtOrigin = offset === 0 && !initialScrollAtEnd && (isOffsetInitialScrollSession(state) ? Math.abs((_a3 = target.contentOffset) != null ? _a3 : 0) <= 1 : target.index === 0 && ((_b = target.viewPosition) != null ? _b : 0) === 0 && Math.abs((_c = target.viewOffset) != null ? _c : 0) <= 1);
+  const shouldFinishWithPreservedTarget = state.props.data.length === 0 && target.index !== void 0;
+  if (shouldFinishAtOrigin) {
+    clearBootstrapInitialScrollSession(state);
+    finishInitialScroll(ctx, {
+      resolvedOffset: offset
+    });
+  } else if (shouldFinishWithPreservedTarget) {
+    clearBootstrapInitialScrollSession(state);
+    finishInitialScroll(ctx, {
+      preserveTarget: true,
+      resolvedOffset: offset
     });
   } else {
-    state.scroll = offset;
-    setTimeout(() => {
-      finishScrollTo(ctx);
-    }, 100);
+    startBootstrapInitialScrollSession(state, {
+      scroll: offset,
+      seedContentOffset: 0 ,
+      targetIndexSeed: target.index
+    });
+    ensureBootstrapInitialScrollFrameTicker(ctx);
   }
 }
-function listenForScrollEnd(ctx, params) {
-  const { readOffset, target, targetOffset } = params;
-  if (!target) {
-    finishScrollTo(ctx);
+function handleBootstrapInitialScrollDataChange(ctx, options) {
+  const { dataLength, didDataChange, initialScrollAtEnd, previousDataLength, stylePaddingBottom } = options;
+  const state = ctx.state;
+  const initialScroll = state.initialScroll;
+  if (isOffsetInitialScrollSession(state) || !initialScroll) {
     return;
   }
-  const supportsScrollEnd = "onscrollend" in target;
-  let idleTimeout;
-  let settled = false;
-  const targetToken = ctx.state.scrollingTo;
-  const maxTimeout = setTimeout(() => finish("max"), SCROLL_END_MAX_MS);
-  const cleanup = () => {
-    target.removeEventListener("scroll", onScroll2);
-    if (supportsScrollEnd) {
-      target.removeEventListener("scrollend", onScrollEnd);
+  const shouldResetDidFinish = !!(state.didFinishInitialScroll && previousDataLength === 0 && dataLength > 0 && initialScroll.index !== void 0);
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  const shouldRetargetBottomAligned = dataLength > 0 && (initialScrollAtEnd || isRetargetableBottomAlignedInitialScrollTarget(initialScroll));
+  if (!didDataChange && !shouldResetDidFinish && !shouldRetargetBottomAligned) {
+    return;
+  }
+  if (shouldRetargetBottomAligned) {
+    if (!shouldResetDidFinish && didFinishedInitialScrollMoveAwayFromTarget(ctx, initialScroll)) {
+      clearPendingInitialScrollFooterLayout(state, initialScroll);
+      return;
     }
-    if (idleTimeout) {
-      clearTimeout(idleTimeout);
+    const updatedInitialScroll = initialScrollAtEnd ? createInitialScrollAtEndTarget({
+      dataLength,
+      footerSize: peek$(ctx, "footerSize") || 0,
+      preserveForFooterLayout: shouldPreserveInitialScrollForFooterLayout(initialScroll),
+      stylePaddingBottom
+    }) : createRetargetedBottomAlignedInitialScroll({
+      dataLength,
+      footerSize: peek$(ctx, "footerSize") || 0,
+      initialScrollAtEnd,
+      stylePaddingBottom,
+      target: initialScroll
+    });
+    if (!areEquivalentBootstrapInitialScrollTargets(initialScroll, updatedInitialScroll) || !!bootstrapInitialScroll || shouldResetDidFinish || didDataChange) {
+      setInitialScrollTarget(state, updatedInitialScroll, {
+        resetDidFinish: shouldResetDidFinish
+      });
+      rearmBootstrapInitialScroll(ctx, {
+        scroll: resolveInitialScrollOffset(ctx, updatedInitialScroll),
+        seedContentOffset: shouldResetDidFinish && !bootstrapInitialScroll ? getObservedBootstrapInitialScrollOffset(state) : void 0,
+        targetIndexSeed: updatedInitialScroll.index
+      });
+      return;
     }
-    clearTimeout(maxTimeout);
-  };
-  const finish = (reason) => {
-    if (settled) return;
-    if (targetToken !== ctx.state.scrollingTo) {
-      settled = true;
-      cleanup();
+  }
+  if (!didDataChange) {
+    return;
+  }
+  if (bootstrapInitialScroll || shouldResetDidFinish) {
+    setInitialScrollTarget(state, initialScroll, {
+      resetDidFinish: shouldResetDidFinish
+    });
+    rearmBootstrapInitialScroll(ctx, {
+      scroll: resolveInitialScrollOffset(ctx, initialScroll),
+      seedContentOffset: shouldResetDidFinish && !bootstrapInitialScroll ? getObservedBootstrapInitialScrollOffset(state) : void 0,
+      targetIndexSeed: initialScroll.index
+    });
+  }
+}
+function handleBootstrapInitialScrollFooterLayout(ctx, options) {
+  const { dataLength, footerSize, initialScrollAtEnd, stylePaddingBottom } = options;
+  const state = ctx.state;
+  if (!initialScrollAtEnd) {
+    return;
+  }
+  const initialScroll = state.initialScroll;
+  if (isOffsetInitialScrollSession(state) || dataLength === 0 || !initialScroll) {
+    return;
+  }
+  const shouldProcessFooterLayout = !!getBootstrapInitialScrollSession(state) || shouldPreserveInitialScrollForFooterLayout(initialScroll);
+  if (!shouldProcessFooterLayout) {
+    return;
+  }
+  if (didFinishedInitialScrollMoveAwayFromTarget(ctx, initialScroll)) {
+    clearPendingInitialScrollFooterLayout(state, initialScroll);
+  } else {
+    const updatedInitialScroll = createInitialScrollAtEndTarget({
+      dataLength,
+      footerSize,
+      preserveForFooterLayout: shouldPreserveInitialScrollForFooterLayout(initialScroll),
+      stylePaddingBottom
+    });
+    const didTargetChange = initialScroll.index !== updatedInitialScroll.index || initialScroll.viewPosition !== updatedInitialScroll.viewPosition || initialScroll.viewOffset !== updatedInitialScroll.viewOffset;
+    if (!didTargetChange) {
+      clearPendingInitialScrollFooterLayout(state, initialScroll);
+    } else {
+      setInitialScrollTarget(state, updatedInitialScroll, {
+        resetDidFinish: !!state.didFinishInitialScroll
+      });
+      rearmBootstrapInitialScroll(ctx, {
+        scroll: resolveInitialScrollOffset(ctx, updatedInitialScroll),
+        targetIndexSeed: updatedInitialScroll.index
+      });
+    }
+  }
+}
+function evaluateBootstrapInitialScroll(ctx) {
+  var _a3, _b;
+  const state = ctx.state;
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  const initialScroll = state.initialScroll;
+  if (!bootstrapInitialScroll || !initialScroll || isOffsetInitialScrollSession(state) || ((_a3 = state.scrollingTo) == null ? void 0 : _a3.isInitialScroll)) {
+    return;
+  }
+  bootstrapInitialScroll.passCount += 1;
+  if (abortBootstrapRevealIfNeeded(ctx, {
+    mountFrameCount: bootstrapInitialScroll.mountFrameCount,
+    passCount: bootstrapInitialScroll.passCount
+  })) {
+    return;
+  }
+  if (initialScroll.index !== void 0 && state.startBuffered >= 0 && state.endBuffered >= 0 && initialScroll.index >= state.startBuffered && initialScroll.index <= state.endBuffered) {
+    bootstrapInitialScroll.targetIndexSeed = void 0;
+  }
+  const resolvedOffset = resolveInitialScrollOffset(ctx, initialScroll);
+  const mountedBufferedIndices = getMountedBufferedIndices(state);
+  const areMountedBufferedIndicesMeasured = checkAllSizesKnown(state, mountedBufferedIndices);
+  const didResolvedOffsetChange = Math.abs(bootstrapInitialScroll.scroll - resolvedOffset) > 1;
+  const { data } = state.props;
+  const visibleIndices = getBootstrapRevealVisibleIndices({
+    dataLength: data.length,
+    getSize: (index) => {
+      var _a4, _b2;
+      const id = (_a4 = state.idCache[index]) != null ? _a4 : getId(state, index);
+      return (_b2 = state.sizes.get(id)) != null ? _b2 : getItemSize(ctx, id, index, data[index]);
+    },
+    offset: resolvedOffset,
+    positions: state.positions,
+    scrollLength: state.scrollLength,
+    startIndex: (_b = bootstrapInitialScroll.targetIndexSeed) != null ? _b : state.startBuffered >= 0 ? state.startBuffered : void 0
+  });
+  const areVisibleIndicesMeasured = visibleIndices.length > 0 && visibleIndices.every((index) => {
+    var _a4;
+    const id = (_a4 = state.idCache[index]) != null ? _a4 : getId(state, index);
+    return state.sizesKnown.has(id);
+  });
+  const previousResolvedOffset = bootstrapInitialScroll.previousResolvedOffset;
+  const previousVisibleIndices = bootstrapInitialScroll.visibleIndices;
+  bootstrapInitialScroll.previousResolvedOffset = resolvedOffset;
+  bootstrapInitialScroll.visibleIndices = visibleIndices;
+  if (didResolvedOffsetChange) {
+    bootstrapInitialScroll.scroll = resolvedOffset;
+    queueBootstrapInitialScrollReevaluation(state);
+    return;
+  }
+  if (!areMountedBufferedIndicesMeasured || !areVisibleIndicesMeasured) {
+    return;
+  }
+  const didRevealSettle = previousResolvedOffset !== void 0 && Math.abs(previousResolvedOffset - resolvedOffset) <= DEFAULT_BOOTSTRAP_REVEAL_EPSILON && doVisibleIndicesMatch(previousVisibleIndices, visibleIndices);
+  if (!didRevealSettle) {
+    queueBootstrapInitialScrollReevaluation(state);
+    return;
+  }
+  {
+    clearBootstrapInitialScrollSession(state);
+    dispatchInitialScroll(ctx, {
+      forceScroll: true,
+      resolvedOffset,
+      target: initialScroll,
+      waitForCompletionFrame: Platform.OS === "web"
+    });
+  }
+}
+function finishBootstrapInitialScrollWithoutScroll(ctx, resolvedOffset) {
+  const state = ctx.state;
+  clearBootstrapInitialScrollSession(state);
+  finishInitialScroll(ctx, {
+    preserveTarget: shouldPreserveInitialScrollForFooterLayout(state.initialScroll),
+    recalculateItems: true,
+    resolvedOffset
+  });
+}
+function abortBootstrapInitialScroll(ctx) {
+  var _a3, _b, _c, _d;
+  const state = ctx.state;
+  const bootstrapInitialScroll = getBootstrapInitialScrollSession(state);
+  const initialScroll = state.initialScroll;
+  if (bootstrapInitialScroll && initialScroll && !isOffsetInitialScrollSession(state) && state.refScroller.current) {
+    clearBootstrapInitialScrollSession(state);
+    dispatchInitialScroll(ctx, {
+      forceScroll: true,
+      resolvedOffset: bootstrapInitialScroll.scroll,
+      target: initialScroll,
+      waitForCompletionFrame: Platform.OS === "web"
+    });
+  } else {
+    finishBootstrapInitialScrollWithoutScroll(
+      ctx,
+      (_d = (_c = (_b = (_a3 = getBootstrapInitialScrollSession(state)) == null ? void 0 : _a3.scroll) != null ? _b : state.scrollPending) != null ? _c : state.scroll) != null ? _d : 0
+    );
+  }
+}
+
+// src/core/checkFinishedScroll.ts
+var INITIAL_SCROLL_MAX_FALLBACK_CHECKS = 20;
+var INITIAL_SCROLL_COMPLETION_TARGET_EPSILON = 1;
+var INITIAL_SCROLL_ZERO_TARGET_EPSILON = 1;
+var SILENT_INITIAL_SCROLL_RETRY_DELAY_MS = 16;
+function checkFinishedScroll(ctx, options) {
+  const scrollingTo = ctx.state.scrollingTo;
+  if (options == null ? void 0 : options.onlyIfAligned) {
+    if (!(scrollingTo == null ? void 0 : scrollingTo.isInitialScroll) || scrollingTo.animated) {
       return;
     }
-    const currentOffset = readOffset();
-    const isNearTarget = Math.abs(currentOffset - targetOffset) <= SCROLL_END_TARGET_EPSILON;
-    if (reason === "scrollend" && !isNearTarget) {
+    if (!getResolvedScrollCompletionState(ctx, scrollingTo).isAtResolvedTarget) {
       return;
     }
-    settled = true;
-    cleanup();
-    finishScrollTo(ctx);
+  }
+  ctx.state.animFrameCheckFinishedScroll = requestAnimationFrame(() => checkFinishedScrollFrame(ctx));
+}
+function hasScrollCompletionOwnership(state, options) {
+  const { clampedTargetOffset, scrollingTo } = options;
+  return !scrollingTo.isInitialScroll || state.hasScrolled || clampedTargetOffset <= INITIAL_SCROLL_COMPLETION_TARGET_EPSILON;
+}
+function isSilentInitialDispatch(state, scrollingTo) {
+  return !!(scrollingTo == null ? void 0 : scrollingTo.isInitialScroll) && initialScrollCompletion.didDispatchNativeScroll(state) && !state.hasScrolled;
+}
+function getInitialScrollWatchdogTargetOffset(state) {
+  var _a3;
+  return (_a3 = initialScrollWatchdog.get(state)) == null ? void 0 : _a3.targetOffset;
+}
+function isNativeInitialNonZeroTarget(state) {
+  const targetOffset = getInitialScrollWatchdogTargetOffset(state);
+  return !state.didFinishInitialScroll && initialScrollWatchdog.hasNonZeroTargetOffset(targetOffset);
+}
+function shouldFinishInitialScrollWithoutNativeProgress(state, scrollingTo) {
+  var _a3, _b;
+  if (!scrollingTo.isInitialScroll || scrollingTo.animated || !state.didContainersLayout) {
+    return false;
+  }
+  if (((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "bootstrap") {
+    return false;
+  }
+  const targetOffset = (_b = scrollingTo.targetOffset) != null ? _b : scrollingTo.offset;
+  if (initialScrollWatchdog.hasNonZeroTargetOffset(targetOffset) && initialScrollCompletion.didDispatchNativeScroll(state) && !state.hasScrolled) {
+    return false;
+  }
+  if (initialScrollWatchdog.isAtZeroTargetOffset(targetOffset) || Math.abs(state.scroll - targetOffset) > 1 || Math.abs(state.scrollPending - targetOffset) > 1) {
+    return false;
+  }
+  return !!scrollingTo.waitForInitialScrollCompletionFrame || isNativeInitialNonZeroTarget(state);
+}
+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;
+}
+function getResolvedScrollCompletionState(ctx, scrollingTo) {
+  var _a3;
+  const { state } = ctx;
+  const scroll = state.scrollPending;
+  const adjust = state.scrollAdjustHandler.getAdjust();
+  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);
+  return {
+    clampedTargetOffset,
+    isAtResolvedTarget: Math.abs(scroll - maxOffset) < 1 && (diff1 < 1 || !scrollingTo.animated && diff2 < 1)
   };
-  const onScroll2 = () => {
-    if (idleTimeout) {
-      clearTimeout(idleTimeout);
+}
+function checkFinishedScrollFrame(ctx) {
+  const scrollingTo = ctx.state.scrollingTo;
+  if (!scrollingTo) {
+    return;
+  }
+  const { state } = ctx;
+  state.animFrameCheckFinishedScroll = void 0;
+  const completionState = getResolvedScrollCompletionState(ctx, scrollingTo);
+  if (completionState.isAtResolvedTarget && hasScrollCompletionOwnership(state, {
+    clampedTargetOffset: completionState.clampedTargetOffset,
+    scrollingTo
+  })) {
+    finishScrollTo(ctx);
+  }
+}
+function scrollToFallbackOffset(ctx, offset) {
+  var _a3;
+  (_a3 = ctx.state.refScroller.current) == null ? void 0 : _a3.scrollTo({
+    animated: false,
+    x: ctx.state.props.horizontal ? offset : 0,
+    y: ctx.state.props.horizontal ? 0 : offset
+  });
+}
+function checkFinishedScrollFallback(ctx) {
+  const state = ctx.state;
+  const scrollingTo = state.scrollingTo;
+  const shouldFinishInitialZeroTarget = shouldFinishInitialZeroTargetScroll(ctx);
+  const silentInitialDispatch = isSilentInitialDispatch(state, scrollingTo);
+  const canFinishInitialWithoutNativeProgress = scrollingTo !== void 0 ? shouldFinishInitialScrollWithoutNativeProgress(state, scrollingTo) : false;
+  const slowTimeout = (scrollingTo == null ? void 0 : scrollingTo.isInitialScroll) && !shouldFinishInitialZeroTarget && !canFinishInitialWithoutNativeProgress || !state.didContainersLayout;
+  const initialDelay = shouldFinishInitialZeroTarget || canFinishInitialWithoutNativeProgress ? 0 : silentInitialDispatch ? SILENT_INITIAL_SCROLL_RETRY_DELAY_MS : slowTimeout ? 500 : 100;
+  state.timeoutCheckFinishedScrollFallback = setTimeout(() => {
+    let numChecks = 0;
+    const scheduleFallbackCheck = (delay) => {
+      state.timeoutCheckFinishedScrollFallback = setTimeout(checkHasScrolled, delay);
+    };
+    const checkHasScrolled = () => {
+      var _c;
+      state.timeoutCheckFinishedScrollFallback = void 0;
+      const isStillScrollingTo = state.scrollingTo;
+      if (isStillScrollingTo) {
+        numChecks++;
+        const isNativeInitialPending = isNativeInitialNonZeroTarget(state) && !state.hasScrolled;
+        const maxChecks = silentInitialDispatch ? 5 : isNativeInitialPending ? INITIAL_SCROLL_MAX_FALLBACK_CHECKS : 5;
+        const shouldFinishZeroTarget = shouldFinishInitialZeroTargetScroll(ctx);
+        const canFinishInitialScrollWithoutNativeProgress = shouldFinishInitialScrollWithoutNativeProgress(
+          state,
+          isStillScrollingTo
+        );
+        const completionState = getResolvedScrollCompletionState(ctx, isStillScrollingTo);
+        const canFinishAfterSilentNativeDispatch = silentInitialDispatch && completionState.isAtResolvedTarget && numChecks >= 1;
+        if (shouldFinishZeroTarget || state.hasScrolled || canFinishInitialScrollWithoutNativeProgress || canFinishAfterSilentNativeDispatch || numChecks > maxChecks) {
+          finishScrollTo(ctx);
+        } else if (isNativeInitialPending && numChecks <= maxChecks) {
+          const targetOffset = (_c = getInitialScrollWatchdogTargetOffset(state)) != null ? _c : state.scrollPending;
+          scrollToFallbackOffset(ctx, targetOffset);
+          scheduleFallbackCheck(silentInitialDispatch ? SILENT_INITIAL_SCROLL_RETRY_DELAY_MS : 100);
+        } else {
+          scheduleFallbackCheck(silentInitialDispatch ? SILENT_INITIAL_SCROLL_RETRY_DELAY_MS : 100);
+        }
+      }
+    };
+    checkHasScrolled();
+  }, initialDelay);
+}
+
+// src/core/initialScrollLifecycle.ts
+function handleInitialScrollLayoutReady(ctx) {
+  var _a3;
+  if (!ctx.state.initialScroll) {
+    return;
+  }
+  const runScroll = () => advanceCurrentInitialScrollSession(ctx, { forceScroll: true });
+  runScroll();
+  if (((_a3 = ctx.state.initialScrollSession) == null ? void 0 : _a3.kind) !== "offset") {
+    requestAnimationFrame(runScroll);
+  }
+  checkFinishedScroll(ctx, { onlyIfAligned: true });
+}
+function initializeInitialScrollOnMount(ctx, options) {
+  var _a3, _b;
+  const { dataLength, hasFooterComponent, initialContentOffset, initialScrollAtEnd, useBootstrapInitialScroll } = options;
+  const state = ctx.state;
+  const initialScroll = state.initialScroll;
+  const resolvedInitialContentOffset = initialContentOffset != null ? initialContentOffset : 0;
+  const preserveForFooterLayout = useBootstrapInitialScroll && initialScrollAtEnd && hasFooterComponent;
+  if (initialScroll && (initialScroll.contentOffset === void 0 || !!initialScroll.preserveForFooterLayout !== preserveForFooterLayout && ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) !== "offset")) {
+    setInitialScrollTarget(state, {
+      ...initialScroll,
+      contentOffset: resolvedInitialContentOffset,
+      preserveForFooterLayout
+    });
+  }
+  if (useBootstrapInitialScroll && initialScroll && ((_b = state.initialScrollSession) == null ? void 0 : _b.kind) !== "offset") {
+    startBootstrapInitialScrollOnMount(ctx, {
+      initialScrollAtEnd,
+      target: state.initialScroll
+    });
+    return;
+  }
+  const hasPendingDataDependentInitialScroll = !!initialScroll && dataLength === 0 && !(resolvedInitialContentOffset === 0 && !initialScrollAtEnd);
+  if (!resolvedInitialContentOffset && !hasPendingDataDependentInitialScroll) {
+    if (initialScroll && !initialScrollAtEnd) {
+      finishInitialScroll(ctx, {
+        resolvedOffset: resolvedInitialContentOffset
+      });
+    } else {
+      setInitialRenderState(ctx, { didInitialScroll: true });
     }
-    idleTimeout = setTimeout(() => finish("idle"), SCROLL_END_IDLE_MS);
-  };
-  const onScrollEnd = () => finish("scrollend");
-  target.addEventListener("scroll", onScroll2);
-  if (supportsScrollEnd) {
-    target.addEventListener("scrollend", onScrollEnd);
-  } else {
-    idleTimeout = setTimeout(() => finish("idle"), SMOOTH_SCROLL_DURATION_MS);
   }
 }
-
-// src/core/scrollTo.ts
-var WATCHDOG_OFFSET_EPSILON = 1;
-function scrollTo(ctx, params) {
-  var _a3, _b;
+function handleInitialScrollDataChange(ctx, options) {
+  var _a3, _b, _c;
+  const { dataLength, didDataChange, initialScrollAtEnd, stylePaddingBottom, useBootstrapInitialScroll } = options;
   const state = ctx.state;
-  const { noScrollingTo, forceScroll, ...scrollTarget } = params;
-  const { animated, isInitialScroll, offset: scrollTargetOffset, precomputedWithViewOffset } = scrollTarget;
-  const {
-    props: { horizontal }
-  } = state;
-  if (state.animFrameCheckFinishedScroll) {
-    cancelAnimationFrame(ctx.state.animFrameCheckFinishedScroll);
-  }
-  if (state.timeoutCheckFinishedScrollFallback) {
-    clearTimeout(ctx.state.timeoutCheckFinishedScrollFallback);
+  const previousDataLength = (_b = (_a3 = state.initialScrollSession) == null ? void 0 : _a3.previousDataLength) != null ? _b : 0;
+  if (state.initialScrollSession) {
+    state.initialScrollSession.previousDataLength = dataLength;
   }
-  let offset = precomputedWithViewOffset ? scrollTargetOffset : calculateOffsetWithOffsetPosition(ctx, scrollTargetOffset, scrollTarget);
-  offset = clampScrollOffset(ctx, offset, scrollTarget);
-  state.scrollHistory.length = 0;
-  if (!noScrollingTo) {
-    state.scrollingTo = {
-      ...scrollTarget,
-      targetOffset: offset
-    };
+  setInitialScrollSession(state);
+  if (useBootstrapInitialScroll) {
+    handleBootstrapInitialScrollDataChange(ctx, {
+      dataLength,
+      didDataChange,
+      initialScrollAtEnd,
+      previousDataLength,
+      stylePaddingBottom
+    });
+    return;
   }
-  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;
+  const shouldReplayFinishedOffsetInitialScroll = previousDataLength === 0 && dataLength > 0 && !!state.initialScroll && ((_c = ctx.state.initialScrollSession) == null ? void 0 : _c.kind) === "offset" && !!state.didFinishInitialScroll;
+  if (previousDataLength !== 0 || dataLength === 0 || !state.initialScroll || !state.queuedInitialLayout || state.didFinishInitialScroll && !shouldReplayFinishedOffsetInitialScroll) {
+    return;
   }
-  if (forceScroll || !isInitialScroll || Platform.OS === "android") {
-    doScrollTo(ctx, { animated, horizontal, offset });
-  } else {
-    state.scroll = offset;
+  if (shouldReplayFinishedOffsetInitialScroll) {
+    state.didFinishInitialScroll = false;
   }
+  advanceCurrentInitialScrollSession(ctx);
 }
 
-// src/core/doMaintainScrollAtEnd.ts
-function doMaintainScrollAtEnd(ctx) {
+// src/utils/requestAdjust.ts
+function requestAdjust(ctx, positionDiff, dataChanged) {
   const state = ctx.state;
-  const {
-    didContainersLayout,
-    isAtEnd,
-    pendingNativeMVCPAdjust,
-    refScroller,
-    props: { maintainScrollAtEnd }
-  } = state;
-  const shouldMaintainScrollAtEnd = !!(isAtEnd && maintainScrollAtEnd && didContainersLayout);
-  if (pendingNativeMVCPAdjust) {
-    state.pendingMaintainScrollAtEnd = shouldMaintainScrollAtEnd;
-    return false;
-  }
-  state.pendingMaintainScrollAtEnd = false;
-  if (shouldMaintainScrollAtEnd) {
-    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: maintainScrollAtEnd.animated
-        });
-        setTimeout(
-          () => {
-            state.maintainingScrollAtEnd = false;
-          },
-          maintainScrollAtEnd.animated ? 500 : 0
-        );
+  if (Math.abs(positionDiff) > 0.1) {
+    const doit = () => {
+      {
+        state.scrollAdjustHandler.requestAdjust(positionDiff);
+        if (state.adjustingFromInitialMount) {
+          state.adjustingFromInitialMount--;
+        }
       }
-    });
-    return true;
+    };
+    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 false;
 }
 
 // src/core/mvcp.ts
@@ -2312,94 +3348,6 @@ 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) {
-      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;
@@ -2913,23 +3861,6 @@ function maybeUpdateViewabilityCallback(ctx, configId, containerId, viewToken) {
 var unstableBatchedUpdates = ReactDOM.unstable_batchedUpdates;
 var batchedUpdates = typeof unstableBatchedUpdates === "function" ? unstableBatchedUpdates : (fn) => fn();
 
-// src/utils/checkAllSizesKnown.ts
-function isNullOrUndefined2(value) {
-  return value === null || value === void 0;
-}
-function checkAllSizesKnown(state) {
-  const { startBuffered, endBuffered, sizesKnown } = state;
-  if (!isNullOrUndefined2(endBuffered) && !isNullOrUndefined2(startBuffered) && startBuffered >= 0 && endBuffered >= 0) {
-    let areAllKnown = true;
-    for (let i = startBuffered; areAllKnown && i <= endBuffered; i++) {
-      const key = getId(state, i);
-      areAllKnown && (areAllKnown = sizesKnown.has(key));
-    }
-    return areAllKnown;
-  }
-  return false;
-}
-
 // src/utils/findAvailableContainers.ts
 function findAvailableContainers(ctx, numNeeded, startBuffered, endBuffered, pendingRemoval, requiredItemTypes, needNewContainers) {
   const numContainers = peek$(ctx, "numContainers");
@@ -3052,97 +3983,11 @@ function comparatorByDistance(a, b) {
   return b.distance - a.distance;
 }
 
-// src/core/scrollToIndex.ts
-function scrollToIndex(ctx, {
-  index,
-  viewOffset = 0,
-  animated = true,
-  forceScroll,
-  isInitialScroll,
-  viewPosition
-}) {
-  const state = ctx.state;
-  const { data } = state.props;
-  if (index >= data.length) {
-    index = data.length - 1;
-  } else if (index < 0) {
-    index = 0;
-  }
-  const firstIndexOffset = calculateOffsetForIndex(ctx, index);
-  const isLast = index === data.length - 1;
-  if (isLast && viewPosition === void 0) {
-    viewPosition = 1;
-  }
-  state.scrollForNextCalculateItemsInView = void 0;
-  const targetId = getId(state, index);
-  const itemSize = getItemSize(ctx, targetId, index, state.props.data[index]);
-  scrollTo(ctx, {
-    animated,
-    forceScroll,
-    index,
-    isInitialScroll,
-    itemSize,
-    offset: firstIndexOffset,
-    viewOffset,
-    viewPosition: viewPosition != null ? viewPosition : 0
-  });
-}
-
-// 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) {
-    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);
-  }
   setInitialRenderState(ctx, { didLayout: true });
 }
 
@@ -3217,7 +4062,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, _l;
+    var _a3, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
     const {
       columns,
       columnSpans,
@@ -3225,7 +4070,6 @@ function calculateItemsInView(ctx, params = {}) {
       enableScrollForNextCalculateItemsInView,
       idCache,
       indexByKey,
-      initialScroll,
       minIndexSizeChanged,
       positions,
       props: {
@@ -3249,6 +4093,8 @@ function calculateItemsInView(ctx, params = {}) {
     const alwaysRenderArr = alwaysRenderIndicesArr || [];
     const alwaysRenderSet = alwaysRenderIndicesSet || /* @__PURE__ */ new Set();
     const { dataChanged, doMVCP, forceFullItemPositions } = params;
+    const bootstrapInitialScrollState = ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "bootstrap" ? state.initialScrollSession.bootstrap : void 0;
+    const suppressInitialScrollSideEffects = !!bootstrapInitialScrollState;
     const prevNumContainers = peek$(ctx, "numContainers");
     if (!data || scrollLength === 0 || !prevNumContainers) {
       return;
@@ -3259,16 +4105,12 @@ function calculateItemsInView(ctx, params = {}) {
     const speed = getScrollVelocity(state);
     const scrollExtra = 0;
     const { queuedInitialLayout } = state;
-    let { scroll: scrollState } = state;
-    if (!queuedInitialLayout && initialScroll) {
-      const updatedOffset = state.initialScrollUsesOffset ? (_a3 = initialScroll.contentOffset) != null ? _a3 : 0 : calculateOffsetWithOffsetPosition(
-        ctx,
-        calculateOffsetForIndex(ctx, initialScroll.index),
-        initialScroll
-      );
-      scrollState = updatedOffset;
-    }
-    const scrollAdjustPending = (_b = peek$(ctx, "scrollAdjustPending")) != null ? _b : 0;
+    const scrollState = suppressInitialScrollSideEffects ? (_b = bootstrapInitialScrollState == null ? void 0 : bootstrapInitialScrollState.scroll) != null ? _b : state.scroll : !queuedInitialLayout && state.initialScroll ? (
+      // Before the initial layout settles, keep viewport math anchored to the
+      // current initial-scroll target instead of transient native adjustments.
+      resolveInitialScrollOffset(ctx, state.initialScroll)
+    ) : state.scroll;
+    const scrollAdjustPending = (_c = peek$(ctx, "scrollAdjustPending")) != null ? _c : 0;
     const scrollAdjustPad = scrollAdjustPending - topPad;
     let scroll = Math.round(scrollState + scrollExtra + scrollAdjustPad);
     if (scroll + scrollLength > totalSize) {
@@ -3292,7 +4134,7 @@ function calculateItemsInView(ctx, params = {}) {
     const scrollTopBuffered = scroll - scrollBufferTop;
     const scrollBottom = scroll + scrollLength + (scroll < 0 ? -scroll : 0);
     const scrollBottomBuffered = scrollBottom + scrollBufferBottom;
-    if (!dataChanged && !forceFullItemPositions && scrollForNextCalculateItemsInView) {
+    if (!suppressInitialScrollSideEffects && !dataChanged && !forceFullItemPositions && scrollForNextCalculateItemsInView) {
       const { top, bottom } = scrollForNextCalculateItemsInView;
       if (top === null && bottom === null) {
         state.scrollForNextCalculateItemsInView = void 0;
@@ -3302,7 +4144,7 @@ function calculateItemsInView(ctx, params = {}) {
         }
       }
     }
-    const checkMVCP = doMVCP ? prepareMVCP(ctx, dataChanged) : void 0;
+    const checkMVCP = doMVCP && !suppressInitialScrollSideEffects ? prepareMVCP(ctx, dataChanged) : void 0;
     if (dataChanged) {
       indexByKey.clear();
       idCache.length = 0;
@@ -3310,7 +4152,7 @@ function calculateItemsInView(ctx, params = {}) {
       columns.length = 0;
       columnSpans.length = 0;
     }
-    const startIndex = forceFullItemPositions || dataChanged ? 0 : (_c = minIndexSizeChanged != null ? minIndexSizeChanged : state.startBuffered) != null ? _c : 0;
+    const startIndex = forceFullItemPositions || dataChanged ? 0 : (_d = minIndexSizeChanged != null ? minIndexSizeChanged : state.startBuffered) != null ? _d : 0;
     updateItemPositions(ctx, dataChanged, {
       doMVCP,
       forceFullUpdate: !!forceFullItemPositions,
@@ -3327,11 +4169,11 @@ function calculateItemsInView(ctx, params = {}) {
     let startBufferedId = null;
     let endNoBuffer = null;
     let endBuffered = null;
-    let loopStart = !dataChanged && startBufferedIdOrig ? indexByKey.get(startBufferedIdOrig) || 0 : 0;
+    let loopStart = (_e = suppressInitialScrollSideEffects ? bootstrapInitialScrollState == null ? void 0 : bootstrapInitialScrollState.targetIndexSeed : void 0) != null ? _e : !dataChanged && startBufferedIdOrig ? indexByKey.get(startBufferedIdOrig) || 0 : 0;
     for (let i = loopStart; i >= 0; i--) {
-      const id = (_d = idCache[i]) != null ? _d : getId(state, i);
+      const id = (_f = idCache[i]) != null ? _f : getId(state, i);
       const top = positions[i];
-      const size = (_e = sizes.get(id)) != null ? _e : getItemSize(ctx, id, i, data[i]);
+      const size = (_g = sizes.get(id)) != null ? _g : getItemSize(ctx, id, i, data[i]);
       const bottom = top + size;
       if (bottom > scroll - scrollBufferTop) {
         loopStart = i;
@@ -3362,8 +4204,8 @@ 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 = (_f = idCache[i]) != null ? _f : getId(state, i);
-      const size = (_g = sizes.get(id)) != null ? _g : getItemSize(ctx, id, i, data[i]);
+      const id = (_h = idCache[i]) != null ? _h : getId(state, i);
+      const size = (_i = sizes.get(id)) != null ? _i : getItemSize(ctx, id, i, data[i]);
       const top = positions[i];
       if (!foundEnd) {
         if (startNoBuffer === null && top + size > scroll) {
@@ -3402,7 +4244,7 @@ function calculateItemsInView(ctx, params = {}) {
     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);
+        const id = (_j = idCache[i]) != null ? _j : getId(state, i);
         idsInView.push(id);
       }
     }
@@ -3435,7 +4277,7 @@ function calculateItemsInView(ctx, params = {}) {
       const needNewContainers = [];
       const needNewContainersSet = /* @__PURE__ */ new Set();
       for (let i = startBuffered; i <= endBuffered; i++) {
-        const id = (_i = idCache[i]) != null ? _i : getId(state, i);
+        const id = (_k = idCache[i]) != null ? _k : getId(state, i);
         if (!containerItemKeys.has(id)) {
           needNewContainersSet.add(i);
           needNewContainers.push(i);
@@ -3444,7 +4286,7 @@ function calculateItemsInView(ctx, params = {}) {
       if (alwaysRenderArr.length > 0) {
         for (const index of alwaysRenderArr) {
           if (index < 0 || index >= dataLength) continue;
-          const id = (_j = idCache[index]) != null ? _j : getId(state, index);
+          const id = (_l = idCache[index]) != null ? _l : getId(state, index);
           if (id && !containerItemKeys.has(id) && !needNewContainersSet.has(index)) {
             needNewContainersSet.add(index);
             needNewContainers.push(index);
@@ -3482,7 +4324,7 @@ function calculateItemsInView(ctx, params = {}) {
         for (let idx = 0; idx < needNewContainers.length; idx++) {
           const i = needNewContainers[idx];
           const containerIndex = availableContainers[idx];
-          const id = (_k = idCache[i]) != null ? _k : getId(state, i);
+          const id = (_m = idCache[i]) != null ? _m : getId(state, i);
           const oldKey = peek$(ctx, `containerItemKey${containerIndex}`);
           if (oldKey && oldKey !== id) {
             containerItemKeys.delete(oldKey);
@@ -3523,7 +4365,7 @@ function calculateItemsInView(ctx, params = {}) {
       if (alwaysRenderArr.length > 0) {
         for (const index of alwaysRenderArr) {
           if (index < 0 || index >= dataLength) continue;
-          const id = (_l = idCache[index]) != null ? _l : getId(state, index);
+          const id = (_n = idCache[index]) != null ? _n : getId(state, index);
           const containerIndex = containerItemKeys.get(id);
           if (containerIndex !== void 0) {
             state.stickyContainerPool.add(containerIndex);
@@ -3594,13 +4436,23 @@ function calculateItemsInView(ctx, params = {}) {
     if (didChangePositions) {
       set$(ctx, "lastPositionUpdate", Date.now());
     }
-    if (!queuedInitialLayout && endBuffered !== null) {
-      if (checkAllSizesKnown(state)) {
-        setDidLayout(ctx);
-      }
+    if (suppressInitialScrollSideEffects) {
+      evaluateBootstrapInitialScroll(ctx);
+      return;
     }
-    if (viewabilityConfigCallbackPairs) {
-      updateViewableItems(state, ctx, viewabilityConfigCallbackPairs, scrollLength, startNoBuffer, endNoBuffer);
+    if (!queuedInitialLayout && endBuffered !== null && checkAllSizesKnown(state)) {
+      setDidLayout(ctx);
+      handleInitialScrollLayoutReady(ctx);
+    }
+    if (viewabilityConfigCallbackPairs && startNoBuffer !== null && endNoBuffer !== null) {
+      updateViewableItems(
+        ctx.state,
+        ctx,
+        viewabilityConfigCallbackPairs,
+        scrollLength,
+        startNoBuffer,
+        endNoBuffer
+      );
     }
     if (onStickyHeaderChange && stickyIndicesArr.length > 0 && nextActiveStickyIndex !== void 0 && nextActiveStickyIndex !== previousStickyIndex) {
       const item = data[nextActiveStickyIndex];
@@ -3631,79 +4483,45 @@ function checkActualChange(state, dataProp, previousData) {
   return false;
 }
 
-// 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 = (_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);
-    const isNotOverscrolled = Math.abs(scroll - maxOffset) < 1;
-    const isAtTarget = diff1 < 1 || !scrollingTo.animated && diff2 < 1;
-    if (isNotOverscrolled && isAtTarget) {
-      finishScrollTo(ctx);
+// src/core/doMaintainScrollAtEnd.ts
+function doMaintainScrollAtEnd(ctx) {
+  const state = ctx.state;
+  const {
+    didContainersLayout,
+    isAtEnd,
+    pendingNativeMVCPAdjust,
+    refScroller,
+    props: { maintainScrollAtEnd }
+  } = state;
+  const shouldMaintainScrollAtEnd = !!(isAtEnd && maintainScrollAtEnd && didContainersLayout);
+  if (pendingNativeMVCPAdjust) {
+    state.pendingMaintainScrollAtEnd = shouldMaintainScrollAtEnd;
+    return false;
+  }
+  state.pendingMaintainScrollAtEnd = false;
+  if (shouldMaintainScrollAtEnd) {
+    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: maintainScrollAtEnd.animated
+        });
+        setTimeout(
+          () => {
+            state.maintainingScrollAtEnd = false;
+          },
+          maintainScrollAtEnd.animated ? 500 : 0
+        );
+      }
+    });
+    return true;
   }
-}
-function checkFinishedScrollFallback(ctx) {
-  const state = ctx.state;
-  const scrollingTo = state.scrollingTo;
-  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++;
-          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);
-          }
-        }
-      };
-      checkHasScrolled();
-    },
-    slowTimeout ? 500 : 100
-  );
-}
-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;
+  return false;
 }
 
 // src/utils/updateAveragesOnDataChange.ts
@@ -3893,20 +4711,102 @@ function handleLayout(ctx, layoutParam, setCanRender) {
   setCanRender(true);
 }
 
+// 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) {
+      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/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 trackInitialScrollNativeProgress(state, newScroll) {
+  const initialNativeScrollWatchdog = initialScrollWatchdog.get(state);
+  const didInitialScrollProgress = !!initialNativeScrollWatchdog && initialScrollWatchdog.didObserveProgress(newScroll, initialNativeScrollWatchdog);
+  if (didInitialScrollProgress) {
+    initialScrollWatchdog.clear(state);
+    return;
+  }
+  if (initialNativeScrollWatchdog) {
+    state.hasScrolled = false;
+    initialScrollWatchdog.set(state, {
+      startScroll: initialNativeScrollWatchdog.startScroll,
+      targetOffset: initialNativeScrollWatchdog.targetOffset
+    });
+  }
+}
+function shouldDeferPublicOnScroll(state) {
+  var _a3;
+  return !!state.initialScroll && ((_a3 = state.initialScrollSession) == null ? void 0 : _a3.kind) === "bootstrap" && !state.didFinishInitialScroll;
+}
+function cloneScrollEvent(event) {
+  return {
+    ...event,
+    nativeEvent: {
+      ...event.nativeEvent
+    }
+  };
 }
 function onScroll(ctx, event) {
   var _a3, _b, _c, _d;
   const state = ctx.state;
-  const {
-    scrollProcessingEnabled,
-    props: { onScroll: onScrollProp }
-  } = state;
+  const { scrollProcessingEnabled } = state;
   if (scrollProcessingEnabled === false) {
     return;
   }
@@ -3937,20 +4837,18 @@ 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;
-  }
+  trackInitialScrollNativeProgress(state, newScroll);
   if (state.scrollingTo) {
     checkFinishedScroll(ctx);
   }
-  onScrollProp == null ? void 0 : onScrollProp(event);
+  if (state.props.onScroll) {
+    if (shouldDeferPublicOnScroll(state)) {
+      state.deferredPublicOnScrollEvent = cloneScrollEvent(event);
+    } else {
+      state.props.onScroll(event);
+    }
+  }
 }
 
 // src/core/ScrollAdjustHandler.ts
@@ -4591,7 +5489,7 @@ var LegendList = typedMemo(
   })
 );
 var LegendListInner = typedForwardRef(function LegendListInner2(props, forwardedRef) {
-  var _a3, _b, _c, _d, _e, _f, _g, _h;
+  var _a3, _b, _c, _d, _e, _f, _g;
   const {
     alignItemsAtEnd = false,
     alwaysRender,
@@ -4615,6 +5513,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     itemsAreEqual,
     keyExtractor: keyExtractorProp,
     ListEmptyComponent,
+    ListFooterComponent,
+    ListFooterComponentStyle,
     ListHeaderComponent,
     maintainScrollAtEnd = false,
     maintainScrollAtEndThreshold = 0.1,
@@ -4651,7 +5551,6 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     useWindowScroll = false,
     viewabilityConfig,
     viewabilityConfigCallbackPairs,
-    waitForInitialLayout = true,
     ...rest
   } = props;
   const animatedPropsInternal = props.animatedPropsInternal;
@@ -4684,8 +5583,15 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   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" ? {
+  const usesBootstrapInitialScroll = initialScrollAtEnd || hasInitialScrollIndex;
+  const initialScrollProp = initialScrollAtEnd ? {
+    index: Math.max(0, dataProp.length - 1),
+    preserveForBottomPadding: true,
+    viewOffset: -stylePaddingBottomState,
+    viewPosition: 1
+  } : hasInitialScrollIndex ? typeof initialScrollIndexProp === "object" ? {
     index: (_a3 = initialScrollIndexProp.index) != null ? _a3 : 0,
+    preserveForBottomPadding: initialScrollIndexProp.viewOffset === void 0 && initialScrollIndexProp.viewPosition === 1 ? true : void 0,
     viewOffset: (_b = initialScrollIndexProp.viewOffset) != null ? _b : initialScrollIndexProp.viewPosition === 1 ? -stylePaddingBottomState : 0,
     viewPosition: (_c = initialScrollIndexProp.viewPosition) != null ? _c : 0
   } : {
@@ -4754,22 +5660,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         idCache: [],
         idsInView: [],
         indexByKey: /* @__PURE__ */ new Map(),
-        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: (_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,
+        initialScrollSession: initialScrollProp ? {
+          kind: initialScrollUsesOffsetOnly ? "offset" : "bootstrap",
+          previousDataLength: dataProp.length
+        } : void 0,
         isAtEnd: false,
         isAtStart: false,
         isEndReached: null,
@@ -4812,6 +5707,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       };
       const internalState = ctx.state;
       internalState.triggerCalculateItemsInView = (params) => calculateItemsInView(ctx, params);
+      internalState.reprocessCurrentScroll = () => updateScroll(ctx, internalState.scroll, true);
       set$(ctx, "maintainVisibleContentPosition", maintainVisibleContentPositionConfig);
       set$(ctx, "extraData", extraData);
     }
@@ -4898,96 +5794,23 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       true
     );
   }
-  const resolveInitialScrollOffset = 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 = 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 = 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 = 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 = useCallback(
-    (initialScroll, offset) => {
-      return dataProp.length === 0 && initialScrollAtEnd && offset === 0 && initialScroll.viewPosition === 1;
-    },
-    [dataProp.length, initialScrollAtEnd]
-  );
-  const shouldRearmFinishedEmptyInitialScrollAtEnd = 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 = 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 };
-        setActiveInitialScrollTarget(updatedInitialScroll, {
-          usesOffset: state.initialScrollUsesOffset
-        });
-        value = clampedOffset;
-      }
-    } else {
-      refState.current.initialAnchor = void 0;
-      value = 0;
-    }
-    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 });
-      }
+    var _a4, _b2;
+    const initialScroll = state.initialScroll;
+    if (!initialScroll) {
+      return void 0;
     }
-    return value;
+    const resolvedOffset = (_a4 = initialScroll.contentOffset) != null ? _a4 : resolveInitialScrollOffset(ctx, initialScroll);
+    return usesBootstrapInitialScroll && ((_b2 = state.initialScrollSession) == null ? void 0 : _b2.kind) === "bootstrap" && Platform.OS === "web" ? void 0 : resolvedOffset;
+  }, [usesBootstrapInitialScroll]);
+  useLayoutEffect(() => {
+    initializeInitialScrollOnMount(ctx, {
+      dataLength: dataProp.length,
+      hasFooterComponent: !!ListFooterComponent,
+      initialContentOffset,
+      initialScrollAtEnd,
+      useBootstrapInitialScroll: usesBootstrapInitialScroll
+    });
   }, []);
   if (isFirstLocal || didDataChangeLocal || numColumnsProp !== peek$(ctx, "numColumns")) {
     refState.current.lastBatchingAction = Date.now();
@@ -5002,188 +5825,39 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       set$(ctx, "totalSize", 0);
     }
   }
-  const doInitialScroll = 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 };
-      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
-    });
-  }, []);
-  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
-  ]);
   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
+    handleInitialScrollDataChange(ctx, {
+      dataLength: dataProp.length,
+      didDataChange: didDataChangeLocal,
+      initialScrollAtEnd,
+      stylePaddingBottom: stylePaddingBottomState,
+      useBootstrapInitialScroll: usesBootstrapInitialScroll
     });
-    doInitialScroll();
-  }, [
-    dataProp.length,
-    doInitialScroll,
-    initialScrollAtEnd,
-    shouldRearmFinishedEmptyInitialScrollAtEnd,
-    stylePaddingBottomState
-  ]);
+  }, [dataProp.length, didDataChangeLocal, initialScrollAtEnd, stylePaddingBottomState, usesBootstrapInitialScroll]);
   const onLayoutFooter = useCallback(
     (layout) => {
-      var _a4;
-      if (!initialScrollAtEnd) {
-        return;
-      }
-      const { initialScroll } = state;
-      if (!initialScroll) {
+      if (!usesBootstrapInitialScroll) {
         return;
       }
-      const lastIndex = Math.max(0, dataProp.length - 1);
-      if (initialScroll.index !== lastIndex || initialScroll.viewPosition !== 1) {
+      handleBootstrapInitialScrollFooterLayout(ctx, {
+        dataLength: dataProp.length,
+        footerSize: layout[horizontal ? "width" : "height"],
+        initialScrollAtEnd,
+        stylePaddingBottom: stylePaddingBottomState
+      });
+    },
+    [dataProp.length, initialScrollAtEnd, horizontal, stylePaddingBottomState, usesBootstrapInitialScroll]
+  );
+  const onLayoutChange = useCallback(
+    (layout) => {
+      handleLayout(ctx, layout, setCanRender);
+      if (usesBootstrapInitialScroll) {
         return;
       }
-      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 };
-        setActiveInitialScrollTarget(updatedInitialScroll, {
-          resetDidFinish: true
-        });
-        doInitialScroll();
-      }
+      advanceCurrentInitialScrollSession(ctx);
     },
-    [
-      dataProp.length,
-      doInitialScroll,
-      horizontal,
-      initialScrollAtEnd,
-      resolveInitialScrollOffset,
-      stylePaddingBottomState
-    ]
+    [usesBootstrapInitialScroll]
   );
-  const onLayoutChange = useCallback((layout) => {
-    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,
     onLayoutProp,
@@ -5257,7 +5931,12 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   }, [viewabilityConfig, viewabilityConfigCallbackPairs, onViewableItemsChanged]);
   useImperativeHandle(forwardedRef, () => createImperativeHandle(ctx), []);
   {
-    useEffect(doInitialScroll, []);
+    useEffect(() => {
+      if (usesBootstrapInitialScroll) {
+        return;
+      }
+      advanceCurrentInitialScrollSession(ctx);
+    }, [usesBootstrapInitialScroll]);
   }
   const fns = useMemo(
     () => ({
@@ -5287,6 +5966,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       horizontal,
       initialContentOffset,
       ListEmptyComponent: dataProp.length === 0 ? ListEmptyComponent : void 0,
+      ListFooterComponent,
+      ListFooterComponentStyle,
       ListHeaderComponent,
       onLayout,
       onLayoutFooter,
@@ -5294,7 +5975,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       onScroll: onScrollHandler,
       recycleItems,
       refreshControl: refreshControlElement ? stylePaddingTopState > 0 ? React3.cloneElement(refreshControlElement, {
-        progressViewOffset: ((_g = refreshControlElement.props.progressViewOffset) != null ? _g : 0) + stylePaddingTopState
+        progressViewOffset: ((_f = refreshControlElement.props.progressViewOffset) != null ? _f : 0) + stylePaddingTopState
       }) : refreshControlElement : onRefresh && /* @__PURE__ */ React3.createElement(
         RefreshControl,
         {
@@ -5305,14 +5986,13 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       ),
       refScrollView: combinedRef,
       renderScrollComponent,
-      scrollAdjustHandler: (_h = refState.current) == null ? void 0 : _h.scrollAdjustHandler,
+      scrollAdjustHandler: (_g = refState.current) == null ? void 0 : _g.scrollAdjustHandler,
       scrollEventThrottle: 0,
       snapToIndices,
       stickyHeaderIndices,
       style,
       updateItemSize: fns.updateItemSize,
-      useWindowScroll: useWindowScrollResolved,
-      waitForInitialLayout
+      useWindowScroll: useWindowScrollResolved
     }
   ), IS_DEV && ENABLE_DEBUG_VIEW);
 });