@legendapp/list 2.0.0-next.2 → 2.0.0-next.3

package/{dist/animated.d.mts → animated.d.mts}

@@ -65,6 +65,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/{dist/animated.d.ts → animated.d.ts}

@@ -65,6 +65,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<_legendapp_list.LegendListRef>) => React.ReactNode)>;
 
 export { AnimatedLegendList };

package/{dist/index.d.mts → index.d.mts}

@@ -5,7 +5,7 @@ import { View, ScrollView, Animated, StyleProp, ViewStyle, ScrollViewProps, Layo
 import Animated$1 from 'react-native-reanimated';
 import * as _legendapp_list_reanimated from '@legendapp/list/reanimated';
 
-type ListenerType = "numContainers" | "numContainersPooled" | `containerItemKey${number}` | `containerItemData${number}` | `containerPosition${number}` | `containerColumn${number}` | "containersDidLayout" | "extraData" | "numColumns" | "lastItemKeys" | "totalSize" | "alignItemsPaddingTop" | "stylePaddingTop" | "scrollAdjust" | "scrollAdjustUserOffset" | "headerSize" | "footerSize" | "maintainVisibleContentPosition" | "debugRawScroll" | "debugComputedScroll" | "otherAxisSize" | "scrollSize";
+type ListenerType = "numContainers" | "numContainersPooled" | `containerItemKey${number}` | `containerItemData${number}` | `containerPosition${number}` | `containerColumn${number}` | "containersDidLayout" | "extraData" | "numColumns" | "lastItemKeys" | "totalSize" | "alignItemsPaddingTop" | "stylePaddingTop" | "scrollAdjust" | "scrollAdjustUserOffset" | "headerSize" | "footerSize" | "maintainVisibleContentPosition" | "debugRawScroll" | "debugComputedScroll" | "otherAxisSize" | "snapToOffsets" | "scrollSize";
 interface StateContext {
     listeners: Map<ListenerType, Set<(value: any) => void>>;
     values: Map<ListenerType, any>;
@@ -232,6 +232,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 };
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -357,6 +358,7 @@ interface InternalState {
         numColumns: number;
         initialContainerPoolRatio: number;
         stylePaddingTop: number | undefined;
+        snapToIndices: number[] | undefined;
     };
 }
 interface ViewableRange<T> {
@@ -377,6 +379,7 @@ type ScrollState = {
     endBuffered: number;
     isAtEnd: boolean;
     isAtStart: boolean;
+    positions: Map<string, number>;
     scroll: number;
     scrollLength: number;
     start: number;
@@ -618,6 +621,7 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 interface LazyLegendListProps<ItemT, ListT> extends Omit<LegendListProps<ItemT>, "data" | "keyExtractor" | "renderItem"> {
@@ -686,6 +690,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: ColumnWrapperStyle;
@@ -748,6 +753,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React$1.Ref<LegendListRef>;
 }) => React$1.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -812,6 +818,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode>(props: LazyLegendListProps<ItemT, ListT> & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare function useViewability(callback: ViewabilityCallback, configId?: string): void;

package/{dist/index.d.ts → index.d.ts}

@@ -5,7 +5,7 @@ import { View, ScrollView, Animated, StyleProp, ViewStyle, ScrollViewProps, Layo
 import Animated$1 from 'react-native-reanimated';
 import * as _legendapp_list_reanimated from '@legendapp/list/reanimated';
 
-type ListenerType = "numContainers" | "numContainersPooled" | `containerItemKey${number}` | `containerItemData${number}` | `containerPosition${number}` | `containerColumn${number}` | "containersDidLayout" | "extraData" | "numColumns" | "lastItemKeys" | "totalSize" | "alignItemsPaddingTop" | "stylePaddingTop" | "scrollAdjust" | "scrollAdjustUserOffset" | "headerSize" | "footerSize" | "maintainVisibleContentPosition" | "debugRawScroll" | "debugComputedScroll" | "otherAxisSize" | "scrollSize";
+type ListenerType = "numContainers" | "numContainersPooled" | `containerItemKey${number}` | `containerItemData${number}` | `containerPosition${number}` | `containerColumn${number}` | "containersDidLayout" | "extraData" | "numColumns" | "lastItemKeys" | "totalSize" | "alignItemsPaddingTop" | "stylePaddingTop" | "scrollAdjust" | "scrollAdjustUserOffset" | "headerSize" | "footerSize" | "maintainVisibleContentPosition" | "debugRawScroll" | "debugComputedScroll" | "otherAxisSize" | "snapToOffsets" | "scrollSize";
 interface StateContext {
     listeners: Map<ListenerType, Set<(value: any) => void>>;
     values: Map<ListenerType, any>;
@@ -232,6 +232,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 };
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -357,6 +358,7 @@ interface InternalState {
         numColumns: number;
         initialContainerPoolRatio: number;
         stylePaddingTop: number | undefined;
+        snapToIndices: number[] | undefined;
     };
 }
 interface ViewableRange<T> {
@@ -377,6 +379,7 @@ type ScrollState = {
     endBuffered: number;
     isAtEnd: boolean;
     isAtStart: boolean;
+    positions: Map<string, number>;
     scroll: number;
     scrollLength: number;
     start: number;
@@ -618,6 +621,7 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 interface LazyLegendListProps<ItemT, ListT> extends Omit<LegendListProps<ItemT>, "data" | "keyExtractor" | "renderItem"> {
@@ -686,6 +690,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: ColumnWrapperStyle;
@@ -748,6 +753,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React$1.Ref<LegendListRef>;
 }) => React$1.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -812,6 +818,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode>(props: LazyLegendListProps<ItemT, ListT> & React$1.RefAttributes<LegendListRef>) => React$1.ReactNode;
 
 declare function useViewability(callback: ViewabilityCallback, configId?: string): void;

package/{dist/index.js → index.js}

@@ -573,6 +573,13 @@ function ScrollAdjust() {
     }
   );
 }
+
+// src/SnapWrapper.tsx
+function SnapWrapper({ ScrollComponent, ...props }) {
+  const [snapToOffsets] = useArr$(["snapToOffsets"]);
+  console.log("snapToOffsets", snapToOffsets);
+  return /* @__PURE__ */ React.createElement(ScrollComponent, { ...props, snapToOffsets });
+}
 function useSyncLayout({
   onChange
 }) {
@@ -647,6 +654,7 @@ var ListComponent = typedMemo(function ListComponent2({
   renderScrollComponent,
   scrollAdjustHandler,
   onLayoutHeader,
+  snapToIndices,
   ...rest
 }) {
   const ctx = useStateContext();
@@ -664,10 +672,12 @@ var ListComponent = typedMemo(function ListComponent2({
       }, 0);
     }
   }, [canRender]);
+  const SnapOrScroll = snapToIndices ? SnapWrapper : ScrollComponent;
   return /* @__PURE__ */ React3__namespace.createElement(
-    ScrollComponent,
+    SnapOrScroll,
     {
       ...rest,
+      ScrollComponent: snapToIndices ? ScrollComponent : void 0,
       style,
       maintainVisibleContentPosition: maintainVisibleContentPosition && !ListEmptyComponent ? { minIndexForVisible: 0 } : void 0,
       contentContainerStyle: [
@@ -1120,6 +1130,21 @@ function setDidLayout(ctx, state) {
   }
 }
 
+// src/updateSnapToOffsets.ts
+function updateSnapToOffsets(ctx, state) {
+  const {
+    positions,
+    props: { snapToIndices }
+  } = state;
+  const snapToOffsets = Array(snapToIndices.length);
+  for (let i = 0; i < snapToIndices.length; i++) {
+    const idx = snapToIndices[i];
+    const key = getId(state, idx);
+    snapToOffsets[i] = positions.get(key);
+  }
+  set$(ctx, "snapToOffsets", snapToOffsets);
+}
+
 // src/setPaddingTop.ts
 function setPaddingTop(ctx, { stylePaddingTop, alignItemsPaddingTop }) {
   if (stylePaddingTop !== void 0) {
@@ -1190,7 +1215,16 @@ function addTotalSize(ctx, state, key, add) {
 // src/updateAllPositions.ts
 function updateAllPositions(ctx, state, dataChanged) {
   var _a, _b, _c, _d, _e;
-  const { averageSizes, columns, indexByKey, positions, firstFullyOnScreenIndex, idCache, sizesKnown } = state;
+  const {
+    averageSizes,
+    columns,
+    indexByKey,
+    positions,
+    firstFullyOnScreenIndex,
+    idCache,
+    sizesKnown,
+    props: { snapToIndices }
+  } = state;
   const data = state.props.data;
   const numColumns = peek$(ctx, "numColumns");
   const indexByKeyForChecking = __DEV__ ? /* @__PURE__ */ new Map() : void 0;
@@ -1270,6 +1304,9 @@ function updateAllPositions(ctx, state, dataChanged) {
     }
   }
   updateTotalSize(ctx, state);
+  if (snapToIndices) {
+    updateSnapToOffsets(ctx, state);
+  }
 }
 
 // src/viewability.ts
@@ -2126,6 +2163,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     initialContainerPoolRatio = 2,
     viewabilityConfig,
     viewabilityConfigCallbackPairs,
+    snapToIndices,
     onViewableItemsChanged,
     onStartReached,
     onEndReached,
@@ -2227,7 +2265,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     viewabilityConfigCallbackPairs: void 0,
     numColumns: numColumnsProp,
     initialContainerPoolRatio,
-    stylePaddingTop: stylePaddingTopState
+    stylePaddingTop: stylePaddingTopState,
+    snapToIndices
   };
   state.refScroller = refScroller;
   const checkResetContainers = (isFirst2) => {
@@ -2322,6 +2361,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }
   }, []);
+  React3.useLayoutEffect(() => {
+    if (snapToIndices) {
+      updateSnapToOffsets(ctx, state);
+    }
+  }, [snapToIndices]);
   React3.useLayoutEffect(() => {
     const didAllocateContainers = doInitialAllocateContainersCallback();
     if (!didAllocateContainers) {
@@ -2396,6 +2440,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             endBuffered: state2.endBuffered,
             isAtEnd: state2.isAtEnd,
             isAtStart: state2.isAtStart,
+            positions: state2.positions,
             scroll: state2.scroll,
             scrollLength: state2.scrollLength,
             start: state2.startNoBuffer,
@@ -2499,7 +2544,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       style,
       contentContainerStyle,
       scrollAdjustHandler: (_a = refState.current) == null ? void 0 : _a.scrollAdjustHandler,
-      onLayoutHeader
+      onLayoutHeader,
+      snapToIndices
     }
   ), __DEV__ && ENABLE_DEBUG_VIEW && /* @__PURE__ */ React3__namespace.createElement(DebugView, { state: refState.current }));
 });

package/{dist/index.mjs → index.mjs}

@@ -552,6 +552,13 @@ function ScrollAdjust() {
     }
   );
 }
+
+// src/SnapWrapper.tsx
+function SnapWrapper({ ScrollComponent, ...props }) {
+  const [snapToOffsets] = useArr$(["snapToOffsets"]);
+  console.log("snapToOffsets", snapToOffsets);
+  return /* @__PURE__ */ React.createElement(ScrollComponent, { ...props, snapToOffsets });
+}
 function useSyncLayout({
   onChange
 }) {
@@ -626,6 +633,7 @@ var ListComponent = typedMemo(function ListComponent2({
   renderScrollComponent,
   scrollAdjustHandler,
   onLayoutHeader,
+  snapToIndices,
   ...rest
 }) {
   const ctx = useStateContext();
@@ -643,10 +651,12 @@ var ListComponent = typedMemo(function ListComponent2({
       }, 0);
     }
   }, [canRender]);
+  const SnapOrScroll = snapToIndices ? SnapWrapper : ScrollComponent;
   return /* @__PURE__ */ React3.createElement(
-    ScrollComponent,
+    SnapOrScroll,
     {
       ...rest,
+      ScrollComponent: snapToIndices ? ScrollComponent : void 0,
       style,
       maintainVisibleContentPosition: maintainVisibleContentPosition && !ListEmptyComponent ? { minIndexForVisible: 0 } : void 0,
       contentContainerStyle: [
@@ -1099,6 +1109,21 @@ function setDidLayout(ctx, state) {
   }
 }
 
+// src/updateSnapToOffsets.ts
+function updateSnapToOffsets(ctx, state) {
+  const {
+    positions,
+    props: { snapToIndices }
+  } = state;
+  const snapToOffsets = Array(snapToIndices.length);
+  for (let i = 0; i < snapToIndices.length; i++) {
+    const idx = snapToIndices[i];
+    const key = getId(state, idx);
+    snapToOffsets[i] = positions.get(key);
+  }
+  set$(ctx, "snapToOffsets", snapToOffsets);
+}
+
 // src/setPaddingTop.ts
 function setPaddingTop(ctx, { stylePaddingTop, alignItemsPaddingTop }) {
   if (stylePaddingTop !== void 0) {
@@ -1169,7 +1194,16 @@ function addTotalSize(ctx, state, key, add) {
 // src/updateAllPositions.ts
 function updateAllPositions(ctx, state, dataChanged) {
   var _a, _b, _c, _d, _e;
-  const { averageSizes, columns, indexByKey, positions, firstFullyOnScreenIndex, idCache, sizesKnown } = state;
+  const {
+    averageSizes,
+    columns,
+    indexByKey,
+    positions,
+    firstFullyOnScreenIndex,
+    idCache,
+    sizesKnown,
+    props: { snapToIndices }
+  } = state;
   const data = state.props.data;
   const numColumns = peek$(ctx, "numColumns");
   const indexByKeyForChecking = __DEV__ ? /* @__PURE__ */ new Map() : void 0;
@@ -1249,6 +1283,9 @@ function updateAllPositions(ctx, state, dataChanged) {
     }
   }
   updateTotalSize(ctx, state);
+  if (snapToIndices) {
+    updateSnapToOffsets(ctx, state);
+  }
 }
 
 // src/viewability.ts
@@ -2105,6 +2142,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     initialContainerPoolRatio = 2,
     viewabilityConfig,
     viewabilityConfigCallbackPairs,
+    snapToIndices,
     onViewableItemsChanged,
     onStartReached,
     onEndReached,
@@ -2206,7 +2244,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     viewabilityConfigCallbackPairs: void 0,
     numColumns: numColumnsProp,
     initialContainerPoolRatio,
-    stylePaddingTop: stylePaddingTopState
+    stylePaddingTop: stylePaddingTopState,
+    snapToIndices
   };
   state.refScroller = refScroller;
   const checkResetContainers = (isFirst2) => {
@@ -2301,6 +2340,11 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       }
     }
   }, []);
+  useLayoutEffect(() => {
+    if (snapToIndices) {
+      updateSnapToOffsets(ctx, state);
+    }
+  }, [snapToIndices]);
   useLayoutEffect(() => {
     const didAllocateContainers = doInitialAllocateContainersCallback();
     if (!didAllocateContainers) {
@@ -2375,6 +2419,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
             endBuffered: state2.endBuffered,
             isAtEnd: state2.isAtEnd,
             isAtStart: state2.isAtStart,
+            positions: state2.positions,
             scroll: state2.scroll,
             scrollLength: state2.scrollLength,
             start: state2.startNoBuffer,
@@ -2478,7 +2523,8 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
       style,
       contentContainerStyle,
       scrollAdjustHandler: (_a = refState.current) == null ? void 0 : _a.scrollAdjustHandler,
-      onLayoutHeader
+      onLayoutHeader,
+      snapToIndices
     }
   ), __DEV__ && ENABLE_DEBUG_VIEW && /* @__PURE__ */ React3.createElement(DebugView, { state: refState.current }));
 });

package/{dist/keyboard-controller.d.mts → keyboard-controller.d.mts}

@@ -66,6 +66,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -128,6 +129,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -192,6 +194,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -254,6 +257,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/{dist/keyboard-controller.d.ts → keyboard-controller.d.ts}

@@ -66,6 +66,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode) | react_native.Animated.AnimatedComponent<(<T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -128,6 +129,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode)> | (<ItemT_1>(props: _legendapp_list_reanimated.AnimatedLegendListProps<ItemT_1> & {
     ref?: React.Ref<LegendListRef>;
 }) => React.ReactElement | null) = <T>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
@@ -192,6 +194,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & React.RefAttributes<LegendListRef>) => React.ReactNode>(props: Omit<Omit<react_native.ScrollViewProps, "scrollEventThrottle">, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     alignItemsAtEnd?: boolean;
     columnWrapperStyle?: _legendapp_list.ColumnWrapperStyle;
@@ -254,6 +257,7 @@ declare const LegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_nati
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    snapToIndices?: number[];
 } & {
     LegendList?: ListT;
 } & React.RefAttributes<LegendListRef>) => React.ReactNode;

package/package.json

@@ -1,89 +1,35 @@
 {
-    "name": "@legendapp/list",
-    "version": "2.0.0-next.2",
-    "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
-    "sideEffects": false,
-    "private": false,
-    "main": "./index.js",
-    "module": "./index.mjs",
-    "types": "./index.d.ts",
-    "files": [
-        "**"
-    ],
-    "exports": {
-        "./package.json": "./package.json",
-        ".": {
-            "types": "./index.d.ts",
-            "import": "./index.mjs",
-            "require": "./index.js"
-        },
-        "./animated": {
-            "types": "./animated.d.ts",
-            "import": "./animated.mjs",
-            "require": "./animated.js"
-        },
-        "./reanimated": {
-            "types": "./reanimated.d.ts",
-            "import": "./reanimated.mjs",
-            "require": "./reanimated.js"
-        },
-        "./keyboard-controller": {
-            "types": "./keyboard-controller.d.ts",
-            "import": "./keyboard-controller.mjs",
-            "require": "./keyboard-controller.js"
-        }
-    },
-    "engines": {
-        "node": ">=16.6.0",
-        "npm": ">=8.11.0"
-    },
-    "scripts": {
-        "build": "tsup && bun run posttsup.ts",
-        "publish": "bun run build && cd dist && npm publish",
-        "publish:next": "bun run build && cd dist && npm publish --tag next",
-        "publish:beta": "bun run build && cd dist && npm publish --tag beta",
-        "lint": "bunx biome check ./src && bunx biome format ./src && bun run lint:example",
-        "lint:example": "bunx biome check ./example/app && bunx biome format ./example/app",
-        "lint:fix": "bunx biome lint --write ./src && bunx biome format --write ./src && bunx biome check --write ./src && bun run lint:fix:example",
-        "lint:fix:example": "bunx biome lint --write ./example/app && bunx biome format --write ./example/app && bunx biome check --write ./example/app"
-    },
-    "peerDependencies": {
-        "react": "*",
-        "react-native": "*"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "^1.9.4",
-        "@types/bun": "^1.1.13",
-        "@types/react": "^18.3.12",
-        "@types/use-sync-external-store": "^1.5.0",
-        "react": "^18.3.1",
-        "react-native": "^0.76.2",
-        "react-native-keyboard-controller": "^1.17.0",
-        "react-native-reanimated": "^3.16.6",
-        "tsup": "^8.3.5",
-        "typescript": "^5.8.3"
-    },
-    "author": "Legend <contact@legendapp.com> (https://github.com/LegendApp)",
-    "keywords": [
-        "react",
-        "react-native",
-        "list"
-    ],
-    "repository": "github:LegendApp/legend-list",
-    "license": "MIT",
-    "bugs": {
-        "url": "https://github.com/LegendApp/legend-list/issues"
-    },
-    "homepage": "https://github.com/LegendApp/legend-list#readme",
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org/"
-    },
-    "commitlint": {
-        "extends": [
-            "@commitlint/config-conventional"
-        ]
-    },
-    "dependencies": {
-        "use-sync-external-store": "^1.5.0"
-    }
-}
+  "name": "@legendapp/list",
+  "version": "2.0.0-next.3",
+  "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
+  "sideEffects": false,
+  "private": false,
+  "main": "./index.js",
+  "module": "./index.mjs",
+  "types": "./index.d.ts",
+  "files": [
+    "**"
+  ],
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "author": "Legend <contact@legendapp.com> (https://github.com/LegendApp)",
+  "keywords": [
+    "react",
+    "react-native",
+    "list"
+  ],
+  "repository": "github:LegendApp/legend-list",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/LegendApp/legend-list/issues"
+  },
+  "homepage": "https://github.com/LegendApp/legend-list#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "use-sync-external-store": "^1.5.0"
+  }
+}

package/.claude/settings.local.json

@@ -1,8 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(bun run:*)"
-    ],
-    "deny": []
-  }
-}

package/.cursor/rules/changelog.mdc

@@ -1,60 +0,0 @@
----
-description:
-globs: CHANGELOG.md
-alwaysApply: false
----
-# Changelog Update Rules
-
-## Process for Adding Git Changes to Changelog
-
-When updating the changelog with recent git commits, follow these guidelines:
-
-### 1. Identify Relevant Commits
-- Get all commits since the last version using: `git log --oneline --since="$(git log --grep="X.X.X" --format="%cd" --date=iso | head -1)" --reverse`
-- Exclude non-user-facing commits like:
-  - "Update changelog"
-  - "chore:" commits
-  - Internal refactoring that doesn't affect API
-  - "Refactor*" commits
-
-### 2. Categorize Changes
-Organize changes by type with these prefixes, in this order:
-- **Feat:** New features and capabilities
-- **Fix:** Bug fixes and corrections
-- **Perf:** Performance improvements
-- **Improvement:** Enhancements to existing functionality
-
-Skip **Refactor:**, they don't need to be in the changelog
-
-### 3. Format Guidelines
-- Write user-friendly descriptions, not raw commit messages
-- Focus on the impact/benefit to users
-- Be concise but descriptive
-- Use present tense ("Fix X" not "Fixed X")
-- Group similar changes together when possible
-
-### 4. Version Organization
-- Add changes to the current version in package.json
-- If significant changes warrant a new version, bump version first
-- List most important changes (breaking changes, major features) first
-- Group fixes and minor improvements at the end
-
-### 5. Example Format
-```markdown
-## X.X.X
-- Fix: [Issue description and impact]
-- Fix: [Another bug fix]
-- Feat: [New feature description]
-- Refactor: [API change description]
-- Perf: [Performance improvement description]
-- Improvement: [Enhancement description]
-```
-
-### 6. Quality Check
-- Ensure all user-facing changes are documented
-- Verify technical accuracy of descriptions
-- Check that breaking changes are clearly marked
-- Review for consistency in tone and format
-
-### 7. Update package version
-If a specific version number is requested and it is newer than the version in package.json, update package.json