@legendapp/list 1.0.0-beta.28 → 1.0.0-beta.29

package/index.d.mts

@@ -22,9 +22,9 @@ declare class ScrollAdjustHandler {
 
 type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices"> & {
     /**
-      * If true, aligns items at the end of the list.
-      * @default false
-      */
+     * If true, aligns items at the end of the list.
+     * @default false
+     */
     alignItemsAtEnd?: boolean;
     /**
      * Style applied to each column's wrapper view.
@@ -271,6 +271,7 @@ interface InternalState {
     queuedCalculateItemsInView: number | undefined;
     lastBatchingAction: number;
     ignoreScrollFromCalcTotal?: boolean;
+    didInitialScroll?: boolean;
     onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
 }
 interface ViewableRange<T> {
@@ -289,10 +290,21 @@ interface LegendListRenderItemProps<ItemT> {
     useRecyclingEffect: (effect: (info: LegendListRecyclingState<ItemT>) => void | (() => void)) => void;
     useRecyclingState: <T>(updateState: ((info: LegendListRecyclingState<ItemT>) => T) | T) => [T, React.Dispatch<T>];
 }
+type ScrollState = {
+    contentLength: number;
+    end: number;
+    endBuffered: number;
+    isAtEnd: boolean;
+    isAtStart: boolean;
+    scroll: number;
+    scrollLength: number;
+    start: number;
+    startBuffered: number;
+};
 type LegendListRef = {
     /**
-         * Displays the scroll indicators momentarily.
-         */
+     * Displays the scroll indicators momentarily.
+     */
     flashScrollIndicators(): void;
     /**
      * Returns the native ScrollView component reference.
@@ -306,6 +318,30 @@ type LegendListRef = {
      * Returns the ScrollResponderMixin for advanced scroll handling.
      */
     getScrollResponder(): ScrollResponderMixin;
+    /**
+     * Returns the internal state of the scroll virtualization.
+     */
+    getState(): ScrollState;
+    /**
+     * Scrolls a specific index into view.
+     * @param params - Parameters for scrolling.
+     * @param params.animated - If true, animates the scroll. Default: true.
+     * @param params.index - The index to scroll to.
+     */
+    scrollIndexIntoView(params: {
+        animated?: boolean | undefined;
+        index: number;
+    }): void;
+    /**
+     * Scrolls a specific index into view.
+     * @param params - Parameters for scrolling.
+     * @param params.animated - If true, animates the scroll. Default: true.
+     * @param params.item - The item to scroll to.
+     */
+    scrollItemIntoView(params: {
+        animated?: boolean | undefined;
+        item: any;
+    }): void;
     /**
      * Scrolls to the end of the list.
      * @param options - Options for scrolling.
@@ -477,4 +513,4 @@ declare function useViewabilityAmount(callback: ViewabilityAmountCallback): void
 declare function useRecyclingEffect(effect: (info: LegendListRecyclingState<unknown>) => void | (() => void)): void;
 declare function useRecyclingState(valueOrFun: ((info: LegendListRecyclingState<unknown>) => any) | any): [any, React$1.Dispatch<any>];
 
-export { type AnchoredPosition, type ColumnWrapperStyle, type InternalState, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };
+export { type AnchoredPosition, type ColumnWrapperStyle, type InternalState, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };

package/index.d.ts

@@ -22,9 +22,9 @@ declare class ScrollAdjustHandler {
 
 type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices"> & {
     /**
-      * If true, aligns items at the end of the list.
-      * @default false
-      */
+     * If true, aligns items at the end of the list.
+     * @default false
+     */
     alignItemsAtEnd?: boolean;
     /**
      * Style applied to each column's wrapper view.
@@ -271,6 +271,7 @@ interface InternalState {
     queuedCalculateItemsInView: number | undefined;
     lastBatchingAction: number;
     ignoreScrollFromCalcTotal?: boolean;
+    didInitialScroll?: boolean;
     onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
 }
 interface ViewableRange<T> {
@@ -289,10 +290,21 @@ interface LegendListRenderItemProps<ItemT> {
     useRecyclingEffect: (effect: (info: LegendListRecyclingState<ItemT>) => void | (() => void)) => void;
     useRecyclingState: <T>(updateState: ((info: LegendListRecyclingState<ItemT>) => T) | T) => [T, React.Dispatch<T>];
 }
+type ScrollState = {
+    contentLength: number;
+    end: number;
+    endBuffered: number;
+    isAtEnd: boolean;
+    isAtStart: boolean;
+    scroll: number;
+    scrollLength: number;
+    start: number;
+    startBuffered: number;
+};
 type LegendListRef = {
     /**
-         * Displays the scroll indicators momentarily.
-         */
+     * Displays the scroll indicators momentarily.
+     */
     flashScrollIndicators(): void;
     /**
      * Returns the native ScrollView component reference.
@@ -306,6 +318,30 @@ type LegendListRef = {
      * Returns the ScrollResponderMixin for advanced scroll handling.
      */
     getScrollResponder(): ScrollResponderMixin;
+    /**
+     * Returns the internal state of the scroll virtualization.
+     */
+    getState(): ScrollState;
+    /**
+     * Scrolls a specific index into view.
+     * @param params - Parameters for scrolling.
+     * @param params.animated - If true, animates the scroll. Default: true.
+     * @param params.index - The index to scroll to.
+     */
+    scrollIndexIntoView(params: {
+        animated?: boolean | undefined;
+        index: number;
+    }): void;
+    /**
+     * Scrolls a specific index into view.
+     * @param params - Parameters for scrolling.
+     * @param params.animated - If true, animates the scroll. Default: true.
+     * @param params.item - The item to scroll to.
+     */
+    scrollItemIntoView(params: {
+        animated?: boolean | undefined;
+        item: any;
+    }): void;
     /**
      * Scrolls to the end of the list.
      * @param options - Options for scrolling.
@@ -477,4 +513,4 @@ declare function useViewabilityAmount(callback: ViewabilityAmountCallback): void
 declare function useRecyclingEffect(effect: (info: LegendListRecyclingState<unknown>) => void | (() => void)): void;
 declare function useRecyclingState(valueOrFun: ((info: LegendListRecyclingState<unknown>) => any) | any): [any, React$1.Dispatch<any>];
 
-export { type AnchoredPosition, type ColumnWrapperStyle, type InternalState, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };
+export { type AnchoredPosition, type ColumnWrapperStyle, type InternalState, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };

package/index.js

@@ -831,7 +831,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   ctx.columnWrapperStyle = columnWrapperStyle;
   const refScroller = React6.useRef(null);
   const combinedRef = useCombinedRef(refScroller, refScrollView);
-  const scrollBuffer = drawDistance != null ? drawDistance : DEFAULT_DRAW_DISTANCE;
+  const scrollBuffer = (drawDistance != null ? drawDistance : DEFAULT_DRAW_DISTANCE) || 1;
   const keyExtractor = keyExtractorProp != null ? keyExtractorProp : (item, index) => index.toString();
   const refState = React6.useRef();
   const getId = (index) => {
@@ -1321,6 +1321,14 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       set$(ctx, "paddingTop", paddingTop);
     }
   };
+  const scrollTo = (offset, animated) => {
+    var _a2;
+    (_a2 = refScroller.current) == null ? void 0 : _a2.scrollTo({
+      x: horizontal ? offset : 0,
+      y: horizontal ? 0 : offset,
+      animated: !!animated
+    });
+  };
   const doMaintainScrollAtEnd = (animated) => {
     const state = refState.current;
     if ((state == null ? void 0 : state.isAtBottom) && maintainScrollAtEnd) {
@@ -1433,7 +1441,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     }
   };
   const calcTotalSizesAndPositions = ({ forgetPositions = false }) => {
-    var _a2, _b2, _c2, _d2;
+    var _a2, _b2;
     let totalSize = 0;
     let totalSizeBelowIndex = 0;
     const indexByKey = /* @__PURE__ */ new Map();
@@ -1470,7 +1478,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             };
             refState.current.anchorElement = newAnchorElement;
             (_b2 = refState.current.belowAnchorElementPositions) == null ? void 0 : _b2.clear();
-            (_c2 = refScroller.current) == null ? void 0 : _c2.scrollTo({ x: 0, y: 0, animated: false });
+            scrollTo(0, false);
             setTimeout(() => {
               calculateItemsInView();
             }, 0);
@@ -1485,7 +1493,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
           } else {
             refState.current.startBufferedId = void 0;
           }
-          (_d2 = refScroller.current) == null ? void 0 : _d2.scrollTo({ x: 0, y: 0, animated: false });
+          scrollTo(0, false);
           setTimeout(() => {
             calculateItemsInView();
           }, 0);
@@ -1686,6 +1694,19 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }
     if (needsCalculate) {
+      let fixingScroll = false;
+      if (needsUpdateContainersDidLayout && initialScrollIndex && !state.didInitialScroll) {
+        const updatedOffset = calculateOffsetForIndex(initialScrollIndex);
+        state.didInitialScroll = true;
+        if (updatedOffset !== initialContentOffset) {
+          fixingScroll = true;
+          scrollTo(updatedOffset, false);
+          requestAnimationFrame(() => {
+            const updatedOffset2 = calculateOffsetForIndex(initialScrollIndex);
+            scrollTo(updatedOffset2, false);
+          });
+        }
+      }
       const scrollVelocity = state.scrollVelocity;
       if ((Number.isNaN(scrollVelocity) || Math.abs(scrollVelocity) < 1) && (!waitForInitialLayout || state.numPendingInitialLayout < 0)) {
         const setDidLayout = () => {
@@ -1707,7 +1728,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         } else {
           calculateItemsInView();
           if (needsUpdateContainersDidLayout) {
-            queueMicrotask(setDidLayout);
+            if (fixingScroll) {
+              requestAnimationFrame(setDidLayout);
+            } else {
+              queueMicrotask(setDidLayout);
+            }
           }
         }
       }
@@ -1826,12 +1851,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         if (viewPosition) {
           firstIndexScrollPostion -= viewPosition * (state.scrollLength - getItemSize(getId(index), index, state.data[index]));
         }
-        const offset = horizontal ? { x: firstIndexScrollPostion, y: 0 } : { x: 0, y: firstIndexScrollPostion };
-        refScroller.current.scrollTo({ ...offset, animated });
+        scrollTo(firstIndexScrollPostion, animated);
         const totalSizeWithScrollAdjust = peek$(ctx, "totalSizeWithScrollAdjust");
         if (maintainVisibleContentPosition && totalSizeWithScrollAdjust - firstIndexScrollPostion < state.scrollLength) {
           const doScrollTo = () => {
-            refScroller.current.scrollTo({ ...offset, animated });
+            scrollTo(firstIndexScrollPostion, animated);
           };
           setTimeout(doScrollTo, animated ? 150 : 50);
           if (animated) {
@@ -1839,16 +1863,48 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
           }
         }
       };
+      const scrollIndexIntoView = (options) => {
+        if (refState.current) {
+          const { index, ...rest2 } = options;
+          const { startNoBuffer, endNoBuffer } = refState.current;
+          if (index < startNoBuffer || index > endNoBuffer) {
+            const viewPosition = index < startNoBuffer ? 0 : 1;
+            scrollToIndex({
+              ...rest2,
+              viewPosition,
+              index
+            });
+          }
+        }
+      };
       return {
+        flashScrollIndicators: () => refScroller.current.flashScrollIndicators(),
         getNativeScrollRef: () => refScroller.current,
         getScrollableNode: () => refScroller.current.getScrollableNode(),
         getScrollResponder: () => refScroller.current.getScrollResponder(),
-        flashScrollIndicators: () => refScroller.current.flashScrollIndicators(),
-        scrollToIndex,
-        scrollToOffset: ({ offset, animated }) => {
-          const offsetObj = horizontal ? { x: offset, y: 0 } : { x: 0, y: offset };
-          refScroller.current.scrollTo({ ...offsetObj, animated });
+        getState: () => {
+          const state = refState.current;
+          return state ? {
+            contentLength: state.totalSize,
+            end: state.endNoBuffer,
+            endBuffered: state.endBuffered,
+            isAtEnd: state.isAtBottom,
+            isAtStart: state.isAtTop,
+            scroll: state.scroll,
+            scrollLength: state.scrollLength,
+            start: state.startNoBuffer,
+            startBuffered: state.startBuffered
+          } : {};
+        },
+        scrollIndexIntoView,
+        scrollItemIntoView: ({ item, ...props2 }) => {
+          const { data } = refState.current;
+          const index = data.indexOf(item);
+          if (index !== -1) {
+            scrollIndexIntoView({ index, ...props2 });
+          }
         },
+        scrollToIndex,
         scrollToItem: ({ item, ...props2 }) => {
           const { data } = refState.current;
           const index = data.indexOf(item);
@@ -1856,6 +1912,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             scrollToIndex({ index, ...props2 });
           }
         },
+        scrollToOffset: ({ offset, animated }) => {
+          scrollTo(offset, animated);
+        },
         scrollToEnd: (options) => refScroller.current.scrollToEnd(options)
       };
     },
@@ -1863,14 +1922,10 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   );
   if (reactNative.Platform.OS === "web") {
     React6.useEffect(() => {
-      var _a2, _b2;
+      var _a2;
       if (initialContentOffset) {
         (_a2 = refState.current) == null ? void 0 : _a2.scrollAdjustHandler.setDisableAdjust(true);
-        (_b2 = refScroller.current) == null ? void 0 : _b2.scrollTo({
-          x: horizontal ? initialContentOffset : 0,
-          y: horizontal ? 0 : initialContentOffset,
-          animated: false
-        });
+        scrollTo(initialContentOffset, false);
         setTimeout(() => {
           var _a3;
           (_a3 = refState.current) == null ? void 0 : _a3.scrollAdjustHandler.setDisableAdjust(false);
@@ -1878,31 +1933,6 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }, []);
   }
-  if (isFirst) {
-    refState.current.scrollAdjustHandler.setDisableAdjust(true);
-  }
-  React6.useEffect(() => {
-    setTimeout(
-      () => {
-        var _a2;
-        return (_a2 = refState.current) == null ? void 0 : _a2.scrollAdjustHandler.setDisableAdjust(false);
-      },
-      initialContentOffset ? 1e3 : 0
-    );
-    if (initialContentOffset) {
-      const doScrollTo = () => {
-        var _a2;
-        (_a2 = refScroller.current) == null ? void 0 : _a2.scrollTo({
-          x: horizontal ? initialContentOffset : 0,
-          y: horizontal ? 0 : initialContentOffset,
-          animated: false
-        });
-        calculateItemsInView();
-      };
-      setTimeout(doScrollTo, 32);
-      setTimeout(doScrollTo, 300);
-    }
-  }, []);
   return /* @__PURE__ */ React6__namespace.createElement(React6__namespace.Fragment, null, /* @__PURE__ */ React6__namespace.createElement(
     ListComponent,
     {

package/index.mjs

@@ -810,7 +810,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   ctx.columnWrapperStyle = columnWrapperStyle;
   const refScroller = useRef(null);
   const combinedRef = useCombinedRef(refScroller, refScrollView);
-  const scrollBuffer = drawDistance != null ? drawDistance : DEFAULT_DRAW_DISTANCE;
+  const scrollBuffer = (drawDistance != null ? drawDistance : DEFAULT_DRAW_DISTANCE) || 1;
   const keyExtractor = keyExtractorProp != null ? keyExtractorProp : (item, index) => index.toString();
   const refState = useRef();
   const getId = (index) => {
@@ -1300,6 +1300,14 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       set$(ctx, "paddingTop", paddingTop);
     }
   };
+  const scrollTo = (offset, animated) => {
+    var _a2;
+    (_a2 = refScroller.current) == null ? void 0 : _a2.scrollTo({
+      x: horizontal ? offset : 0,
+      y: horizontal ? 0 : offset,
+      animated: !!animated
+    });
+  };
   const doMaintainScrollAtEnd = (animated) => {
     const state = refState.current;
     if ((state == null ? void 0 : state.isAtBottom) && maintainScrollAtEnd) {
@@ -1412,7 +1420,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     }
   };
   const calcTotalSizesAndPositions = ({ forgetPositions = false }) => {
-    var _a2, _b2, _c2, _d2;
+    var _a2, _b2;
     let totalSize = 0;
     let totalSizeBelowIndex = 0;
     const indexByKey = /* @__PURE__ */ new Map();
@@ -1449,7 +1457,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             };
             refState.current.anchorElement = newAnchorElement;
             (_b2 = refState.current.belowAnchorElementPositions) == null ? void 0 : _b2.clear();
-            (_c2 = refScroller.current) == null ? void 0 : _c2.scrollTo({ x: 0, y: 0, animated: false });
+            scrollTo(0, false);
             setTimeout(() => {
               calculateItemsInView();
             }, 0);
@@ -1464,7 +1472,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
           } else {
             refState.current.startBufferedId = void 0;
           }
-          (_d2 = refScroller.current) == null ? void 0 : _d2.scrollTo({ x: 0, y: 0, animated: false });
+          scrollTo(0, false);
           setTimeout(() => {
             calculateItemsInView();
           }, 0);
@@ -1665,6 +1673,19 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }
     if (needsCalculate) {
+      let fixingScroll = false;
+      if (needsUpdateContainersDidLayout && initialScrollIndex && !state.didInitialScroll) {
+        const updatedOffset = calculateOffsetForIndex(initialScrollIndex);
+        state.didInitialScroll = true;
+        if (updatedOffset !== initialContentOffset) {
+          fixingScroll = true;
+          scrollTo(updatedOffset, false);
+          requestAnimationFrame(() => {
+            const updatedOffset2 = calculateOffsetForIndex(initialScrollIndex);
+            scrollTo(updatedOffset2, false);
+          });
+        }
+      }
       const scrollVelocity = state.scrollVelocity;
       if ((Number.isNaN(scrollVelocity) || Math.abs(scrollVelocity) < 1) && (!waitForInitialLayout || state.numPendingInitialLayout < 0)) {
         const setDidLayout = () => {
@@ -1686,7 +1707,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         } else {
           calculateItemsInView();
           if (needsUpdateContainersDidLayout) {
-            queueMicrotask(setDidLayout);
+            if (fixingScroll) {
+              requestAnimationFrame(setDidLayout);
+            } else {
+              queueMicrotask(setDidLayout);
+            }
           }
         }
       }
@@ -1805,12 +1830,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
         if (viewPosition) {
           firstIndexScrollPostion -= viewPosition * (state.scrollLength - getItemSize(getId(index), index, state.data[index]));
         }
-        const offset = horizontal ? { x: firstIndexScrollPostion, y: 0 } : { x: 0, y: firstIndexScrollPostion };
-        refScroller.current.scrollTo({ ...offset, animated });
+        scrollTo(firstIndexScrollPostion, animated);
         const totalSizeWithScrollAdjust = peek$(ctx, "totalSizeWithScrollAdjust");
         if (maintainVisibleContentPosition && totalSizeWithScrollAdjust - firstIndexScrollPostion < state.scrollLength) {
           const doScrollTo = () => {
-            refScroller.current.scrollTo({ ...offset, animated });
+            scrollTo(firstIndexScrollPostion, animated);
           };
           setTimeout(doScrollTo, animated ? 150 : 50);
           if (animated) {
@@ -1818,16 +1842,48 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
           }
         }
       };
+      const scrollIndexIntoView = (options) => {
+        if (refState.current) {
+          const { index, ...rest2 } = options;
+          const { startNoBuffer, endNoBuffer } = refState.current;
+          if (index < startNoBuffer || index > endNoBuffer) {
+            const viewPosition = index < startNoBuffer ? 0 : 1;
+            scrollToIndex({
+              ...rest2,
+              viewPosition,
+              index
+            });
+          }
+        }
+      };
       return {
+        flashScrollIndicators: () => refScroller.current.flashScrollIndicators(),
         getNativeScrollRef: () => refScroller.current,
         getScrollableNode: () => refScroller.current.getScrollableNode(),
         getScrollResponder: () => refScroller.current.getScrollResponder(),
-        flashScrollIndicators: () => refScroller.current.flashScrollIndicators(),
-        scrollToIndex,
-        scrollToOffset: ({ offset, animated }) => {
-          const offsetObj = horizontal ? { x: offset, y: 0 } : { x: 0, y: offset };
-          refScroller.current.scrollTo({ ...offsetObj, animated });
+        getState: () => {
+          const state = refState.current;
+          return state ? {
+            contentLength: state.totalSize,
+            end: state.endNoBuffer,
+            endBuffered: state.endBuffered,
+            isAtEnd: state.isAtBottom,
+            isAtStart: state.isAtTop,
+            scroll: state.scroll,
+            scrollLength: state.scrollLength,
+            start: state.startNoBuffer,
+            startBuffered: state.startBuffered
+          } : {};
+        },
+        scrollIndexIntoView,
+        scrollItemIntoView: ({ item, ...props2 }) => {
+          const { data } = refState.current;
+          const index = data.indexOf(item);
+          if (index !== -1) {
+            scrollIndexIntoView({ index, ...props2 });
+          }
         },
+        scrollToIndex,
         scrollToItem: ({ item, ...props2 }) => {
           const { data } = refState.current;
           const index = data.indexOf(item);
@@ -1835,6 +1891,9 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             scrollToIndex({ index, ...props2 });
           }
         },
+        scrollToOffset: ({ offset, animated }) => {
+          scrollTo(offset, animated);
+        },
         scrollToEnd: (options) => refScroller.current.scrollToEnd(options)
       };
     },
@@ -1842,14 +1901,10 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
   );
   if (Platform.OS === "web") {
     useEffect(() => {
-      var _a2, _b2;
+      var _a2;
       if (initialContentOffset) {
         (_a2 = refState.current) == null ? void 0 : _a2.scrollAdjustHandler.setDisableAdjust(true);
-        (_b2 = refScroller.current) == null ? void 0 : _b2.scrollTo({
-          x: horizontal ? initialContentOffset : 0,
-          y: horizontal ? 0 : initialContentOffset,
-          animated: false
-        });
+        scrollTo(initialContentOffset, false);
         setTimeout(() => {
           var _a3;
           (_a3 = refState.current) == null ? void 0 : _a3.scrollAdjustHandler.setDisableAdjust(false);
@@ -1857,31 +1912,6 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }, []);
   }
-  if (isFirst) {
-    refState.current.scrollAdjustHandler.setDisableAdjust(true);
-  }
-  useEffect(() => {
-    setTimeout(
-      () => {
-        var _a2;
-        return (_a2 = refState.current) == null ? void 0 : _a2.scrollAdjustHandler.setDisableAdjust(false);
-      },
-      initialContentOffset ? 1e3 : 0
-    );
-    if (initialContentOffset) {
-      const doScrollTo = () => {
-        var _a2;
-        (_a2 = refScroller.current) == null ? void 0 : _a2.scrollTo({
-          x: horizontal ? initialContentOffset : 0,
-          y: horizontal ? 0 : initialContentOffset,
-          animated: false
-        });
-        calculateItemsInView();
-      };
-      setTimeout(doScrollTo, 32);
-      setTimeout(doScrollTo, 300);
-    }
-  }, []);
   return /* @__PURE__ */ React6.createElement(React6.Fragment, null, /* @__PURE__ */ React6.createElement(
     ListComponent,
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/list",
-  "version": "1.0.0-beta.28",
+  "version": "1.0.0-beta.29",
   "description": "Legend List aims to be a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
   "sideEffects": false,
   "private": false,