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

package/bunfig.toml

@@ -0,0 +1,2 @@
+[install]
+saveTextLockfile = true

package/dist/CHANGELOG.md

@@ -0,0 +1,119 @@
+## 1.1.4
+- Feat: Add sizes to getState()
+
+## 1.1.3
+- Fix: scrollToEnd was not always setting `viewPosition: 1` correctly
+
+## 1.1.2
+- Fix: Adding items in a list with item separators had a small layout jump as the previously last item re-rendered with a separator
+
+## 1.1.1
+- Fix: scrollTo accuracy when paddingTop changes
+
+## 1.1.0
+- Feat: Add LazyLegendList component for virtualizing regular children
+- Feat: Support initialScrollIndex with viewOffset and viewPosition
+- Feat: Add estimatedListSize prop for better initial size estimation
+
+## 1.0.20
+- Types: Fix type of ref in Reanimated LegendList
+
+## 1.0.19
+- Fix: scrollToEnd not including footerSize
+
+## 1.0.18
+- Feat: Add a useListScrollSize hook
+- Fix: Support renderItem being a function component
+- Fix: scrollToEnd being incorrect by the amount of the bottom padding
+
+## 1.0.17
+- Fix: initialScrollIndex not taking header component size into account
+- Fix: PaddingAndAdjust for ListHeaderComponent
+- Fix: ignore alignItemsAtEnd when the list is empty
+
+## 1.0.16
+- Fix: isAtEnd was going to false when overscrolling
+- Fix: refreshControl not being top padded correctly
+- Fix: type of useLastItem hook
+- Fix: header component was not displaying if a list had no data
+- Fix: scrollToIndex logic that fixes scroll after items layout was not using viewPosition/viewOffset
+- Fix: Improve scrollToIndex accuracy
+- Fix: Improve scrollToEnd accuracy
+
+## 1.0.15
+- Feat: Add a useIsLastItem hook
+- Feat: Support horizontal lists without an intrinsic height, it takes the maximum height of list items
+- Feat: Add onLoad prop
+- Fix: maintainVisibleContentPosition not working on horizontal lists
+- Perf: scrollForNextCalculateItemsInView was not taking drawDistance into account correctly
+- Perf: Improved the algorithm for allocating containers to items
+- Perf: Use useLayoutEffect in LegendList if available to get the outer ScrollView layout as soon as possible
+
+## 1.0.14
+- Fix: A container changing size while inactive but not yet recycled could potentially overlap with elements onscreen if large enough
+
+## 1.0.13
+- Fix: Missing React import in ListHeaderComponentContainer crashing some environments
+- Fix: `initialScrollIndex` was off by padding if using "padding" or "paddingVertical" props
+
+## 1.0.12
+- Fix: Initial scroll index and scrollTo were not compensating for top padding
+- Fix: Removed an overly aggressive optimization that was sometimes causing blank spaces after scrolling
+- Fix: Adding a lot of items to the end with maintainScrollAtEnd could result in a large blank space
+- Fix: ListHeaderComponent sometimes not positioned correctly with maintainVisibleContentPosition
+- Fix: Gap styles not working with maintainVisibleContentPosition
+
+## 1.0.11
+- Fix: scrollTo was sometimes showing gaps at the bottom or bottom after reaching the destination
+
+## 1.0.10
+- Fix: Removed an optimization that only checked newly visible items, which could sometimes cause gaps in lists
+- Fix: Scroll history resets properly during scroll operations, which was causing gaps after scroll
+- Fix: Made scroll buffer calculations and scroll jump handling more reliable
+
+## 1.0.9
+- Fix: Use the `use-sync-external-store` shim to support older versions of react
+- Fix: Lists sometimes leaving some gaps when reordering a list
+- Fix: Sometimes precomputing next scroll position for calculation incorrectly
+
+## 1.0.8
+- Perf: The scroll buffering algorithm is smarter and adjusts based on scroll direction for better performance
+- Perf: The container-finding logic keeps index order, reducing gaps in rendering
+- Perf: Combine multiple hooks in Container to a single `useArray$` hook
+
+## 1.0.7
+- Fix: Containers that move out of view are handled better
+
+## 1.0.6
+- Fix: Average item size calculations are more accurate while scrolling
+- Fix: Items in view are handled better when data changes
+- Fix: Scroll position is maintained more accurately during updates
+
+## 1.0.5
+- Fix: Fast scrolling sometimes caused elements to disappear
+- Fix: Out-of-range `scrollToIndex` calls are handled better
+
+## 1.0.4
+- Fix: Container allocation is more efficient
+- Fix: Bidirectional infinite lists scroll better on the old architecture
+- Fix: Item size updates are handled more reliably
+- Fix: Container reuse logic is more accurate
+- Fix: Zero-size layouts are handled better in the old architecture
+
+## 1.0.3
+- Fix: Items that are larger than the estimated size are handled correctly
+
+## 1.0.2
+- Fix: Initial layout works better in the old architecture
+- Fix: Average size calculations are more accurate for bidirectional scrolling
+- Fix: Initial scroll index behavior is more precise
+- Fix: Item size calculations are more accurate overall
+
+## 1.0.1
+- Fix: Total size calculations are correct when using average sizes
+- Fix: Keyboard avoiding behavior is improved for a smoother experience
+
+## 1.0.0
+Initial release! Major changes if you're coming from a beta version:
+
+- Item hooks like `useRecyclingState` are no longer render props, but can be imported directly from `@legendapp/list`.

package/dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Moo.do LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/README.md

@@ -0,0 +1,139 @@
+# Legend List
+
+**Legend List** is a high-performance list component for **React Native**, written purely in Typescript with no native dependencies. It is a drop-in replacement for `FlatList` and `FlashList` with better performance, especially when handling dynamically sized items.
+
+<video src="https://github.com/user-attachments/assets/8641e305-ab06-4fb3-a96a-fd220df84985"></video>
+
+---
+
+## 🤔 Why Legend List?
+
+*   **Performance:** Designed from the ground up and heavily optimized for performance, it is faster than FlatList and other list libraries in most scenarios.
+*   **Dynamic Item Sizes:** Natively supports items with varying heights without performance hits.
+*   **Drop-in Replacement:** API compatibility with `FlatList` and `FlashList` for easier migration.
+*   **100% JS:** No native module linking required, ensuring easy integration and compatibility across platforms.
+*   **Lightweight:** Our goal is to keep LegendList as small of a dependency as possible. For more advanced use cases, we plan on supporting optional plugins. This ensures that we keep the package size as small as possible.
+*   **Bidirectional infinite lists:** Supports infinite scrolling in both directions with no flashes or scroll jumping
+*   **Chat UIs without inverted:** Chat UIs can align their content to the bottom and maintain scroll at end, so that the list doesn't need to be inverted, which causes weird behavior (in animations, etc...)
+
+For more information, listen to the Legend List episode of the [React Native Radio Podcast](https://infinite.red/react-native-radio/rnr-325-legend-list-with-jay-meistrich) and the [livestream with Expo](https://www.youtube.com/watch?v=XpZMveUCke8).
+
+---
+## ✨ Additional Features
+
+Beyond standard `FlatList` capabilities:
+
+*   `recycleItems`: (boolean) Toggles item component recycling.
+    *   `true`: Reuses item components for optimal performance. Be cautious if your item components contain local state, as it might be reused unexpectedly.
+    *   `false` (default): Creates new item components every time. Less performant but safer if items have complex internal state.
+*   `maintainScrollAtEnd`: (boolean) If `true` and the user is scrolled near the bottom (within `maintainScrollAtEndThreshold * screen height`), the list automatically scrolls to the end when items are added or heights change. Useful for chat interfaces.
+*   `alignItemsAtEnd`: (boolean) Useful for chat UIs, content smaller than the View will be aligned to the bottom of the list.
+
+---
+
+## 📚 Documentation
+
+For comprehensive documentation, guides, and the full API reference, please visit:
+
+➡️ **[Legend List Documentation Site](https://www.legendapp.com/open-source/list)**
+
+---
+
+## 💻 Usage
+
+### Installation
+
+```bash
+# Using Bun
+bun add @legendapp/list
+
+# Using npm
+npm install @legendapp/list
+
+# Using Yarn
+yarn add @legendapp/list
+```
+
+### Example
+```tsx
+import React, { useRef } from "react"
+import { View, Image, Text, StyleSheet } from "react-native"
+import { LegendList, LegendListRef, LegendListRenderItemProps } from "@legendapp/list"
+
+// Define the type for your data items
+interface UserData {
+    id: string;
+    name: string;
+    photoUri: string;
+}
+
+const LegendListExample = () => {
+    // Optional: Ref for accessing list methods (e.g., scrollTo)
+    const listRef = useRef<LegendListRef | null>(null)
+
+    const data = []
+
+    const renderItem = ({ item }: LegendListRenderItemProps<UserData>) => {
+        return (
+            <View>
+                <Image source={{ uri: item.photoUri }} />
+                <Text>{item.name}</Text>
+            </View>
+        )
+    }
+
+    return (
+        <LegendList
+            // Required Props
+            data={data}
+            renderItem={renderItem}
+
+            // Recommended props (Improves performance)
+            keyExtractor={(item) => item.id}
+            recycleItems={true}
+
+            // Recommended if data can change
+            maintainVisibleContentPosition
+
+            ref={listRef}
+        />
+    )
+}
+
+export default LegendListExample
+
+```
+
+---
+
+## How to Build
+
+1. `bun i`
+2. `bun run build` will build the package to the `dist` folder.
+
+## Running the Example
+
+1. `cd example`
+2. `bun i`
+3. `bun run ios`
+
+## PRs gladly accepted!
+
+There's not a ton of code so hopefully it's easy to contribute. If you want to add a missing feature or fix a bug please post an issue to see if development is already in progress so we can make sure to not duplicate work 😀.
+
+## Upcoming Roadmap
+
+- [] Column spans
+- [] overrideItemLayout
+- [] Sticky headers
+- [] Masonry layout
+- [] getItemType
+- [] React DOM implementation
+
+## Community
+
+Join us on [Discord](https://discord.gg/tuW2pAffjA) to get involved with the Legend community.
+
+## 👩‍⚖️ License
+
+[MIT](LICENSE)

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

@@ -31,7 +31,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | _legendapp_list.MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;

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

@@ -31,7 +31,7 @@ declare const AnimatedLegendList: Animated.AnimatedComponent<(<T>(props: Omit<Om
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | _legendapp_list.MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;

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

@@ -1,8 +1,8 @@
 import * as React$1 from 'react';
 import { ComponentProps, ReactNode, Dispatch, SetStateAction } from 'react';
 import * as react_native from 'react-native';
-import { View, ScrollView, StyleProp, ViewStyle, ScrollViewProps, NativeSyntheticEvent, NativeScrollEvent, ScrollViewComponent, ScrollResponderMixin } from 'react-native';
-import Animated from 'react-native-reanimated';
+import { View, ScrollView, Animated, StyleProp, ViewStyle, ScrollViewProps, LayoutRectangle, NativeSyntheticEvent, NativeScrollEvent, ScrollViewComponent, ScrollResponderMixin } from 'react-native';
+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";
@@ -26,7 +26,7 @@ declare class ScrollAdjustHandler {
     setMounted(): void;
 }
 
-type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
+type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView> | ComponentProps<typeof Animated$1.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     /**
      * If true, aligns items at the end of the list.
      * @default false
@@ -122,7 +122,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
      * If true, auto-scrolls to end when new items are added.
      * @default false
      */
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     /**
      * Distance threshold in percentage of screen size to trigger maintainScrollAtEnd.
      * @default 0.1
@@ -233,6 +233,11 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
         elapsedTimeInMs: number;
     }) => void;
 };
+interface MaintainScrollAtEndOptions {
+    onLayout?: boolean;
+    onItemLayout?: boolean;
+    onDataChange?: boolean;
+}
 interface ColumnWrapperStyle {
     rowGap?: number;
     gap?: number;
@@ -250,7 +255,6 @@ interface InternalState {
     isEndReached: boolean;
     isAtEnd: boolean;
     isAtStart: boolean;
-    data: readonly any[];
     hasScrolled?: boolean;
     scrollLength: number;
     startBuffered: number;
@@ -275,7 +279,6 @@ interface InternalState {
     indexByKey: Map<string, number>;
     idCache: Map<number, string>;
     viewabilityConfigCallbackPairs: ViewabilityConfigCallbackPairs | undefined;
-    renderItem: ((props: LegendListRenderItemProps<any>) => ReactNode) | React.ComponentType<LegendListRenderItemProps<any>>;
     scrollHistory: Array<{
         scroll: number;
         time: number;
@@ -308,8 +311,53 @@ interface InternalState {
         num: number;
         avg: number;
     }>;
-    onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
-    stylePaddingBottom?: number;
+    refScroller: React.RefObject<ScrollView>;
+    loadStartTime: number;
+    initialScroll: ScrollIndexWithOffsetPosition | undefined;
+    lastLayout: LayoutRectangle | undefined;
+    props: {
+        alignItemsAtEnd: boolean;
+        data: readonly any[];
+        estimatedItemSize: number | undefined;
+        getEstimatedItemSize: ((index: number, item: any) => number) | undefined;
+        horizontal: boolean;
+        keyExtractor: ((item: any, index: number) => string) | undefined;
+        maintainScrollAtEnd: boolean | MaintainScrollAtEndOptions;
+        maintainScrollAtEndThreshold: number | undefined;
+        maintainVisibleContentPosition: boolean;
+        onEndReached: (((info: {
+            distanceFromEnd: number;
+        }) => void) | null | undefined) | undefined;
+        onEndReachedThreshold: number | null | undefined;
+        onItemSizeChanged: ((info: {
+            size: number;
+            previous: number;
+            index: number;
+            itemKey: string;
+            itemData: any;
+        }) => void) | undefined;
+        onLoad: ((info: {
+            elapsedTimeInMs: number;
+        }) => void) | undefined;
+        onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
+        onStartReached: (((info: {
+            distanceFromStart: number;
+        }) => void) | null | undefined) | undefined;
+        onStartReachedThreshold: number | null | undefined;
+        suggestEstimatedItemSize: boolean;
+        stylePaddingBottom: number | undefined;
+        renderItem: ((props: LegendListRenderItemProps<any>) => ReactNode) | React.ComponentType<LegendListRenderItemProps<any>>;
+        initialScroll: {
+            index: number;
+            viewOffset?: number;
+            viewPosition?: number;
+        } | undefined;
+        scrollBuffer: number;
+        viewabilityConfigCallbackPairs: ViewabilityConfigCallbackPairs | undefined;
+        numColumns: number;
+        initialContainerPoolRatio: number;
+        stylePaddingTop: number | undefined;
+    };
 }
 interface ViewableRange<T> {
     startBuffered: number;
@@ -533,10 +581,10 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     keyExtractor?: ((item: T, index: number) => string) | undefined;
     ListEmptyComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListFooterComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
-    ListFooterComponentStyle?: react_native.StyleProp<ViewStyle> | undefined;
+    ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
-    ListHeaderComponentStyle?: react_native.StyleProp<ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -604,7 +652,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -666,7 +714,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -730,7 +778,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -776,4 +824,4 @@ declare function useListScrollSize(): {
     height: number;
 };
 
-export { type ColumnWrapperStyle, type GetRenderedItem, type GetRenderedItemResult, type InternalState, LazyLegendList, type LazyLegendListProps, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type ScrollIndexWithOffsetPosition, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };
+export { type ColumnWrapperStyle, type GetRenderedItem, type GetRenderedItemResult, type InternalState, LazyLegendList, type LazyLegendListProps, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type MaintainScrollAtEndOptions, type OnViewableItemsChanged, type ScrollIndexWithOffsetPosition, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };

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

@@ -1,8 +1,8 @@
 import * as React$1 from 'react';
 import { ComponentProps, ReactNode, Dispatch, SetStateAction } from 'react';
 import * as react_native from 'react-native';
-import { View, ScrollView, StyleProp, ViewStyle, ScrollViewProps, NativeSyntheticEvent, NativeScrollEvent, ScrollViewComponent, ScrollResponderMixin } from 'react-native';
-import Animated from 'react-native-reanimated';
+import { View, ScrollView, Animated, StyleProp, ViewStyle, ScrollViewProps, LayoutRectangle, NativeSyntheticEvent, NativeScrollEvent, ScrollViewComponent, ScrollResponderMixin } from 'react-native';
+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";
@@ -26,7 +26,7 @@ declare class ScrollAdjustHandler {
     setMounted(): void;
 }
 
-type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
+type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView> | ComponentProps<typeof Animated$1.ScrollView>> = Omit<TScrollView, "contentOffset" | "contentInset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children"> & {
     /**
      * If true, aligns items at the end of the list.
      * @default false
@@ -122,7 +122,7 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
      * If true, auto-scrolls to end when new items are added.
      * @default false
      */
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     /**
      * Distance threshold in percentage of screen size to trigger maintainScrollAtEnd.
      * @default 0.1
@@ -233,6 +233,11 @@ type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof Scroll
         elapsedTimeInMs: number;
     }) => void;
 };
+interface MaintainScrollAtEndOptions {
+    onLayout?: boolean;
+    onItemLayout?: boolean;
+    onDataChange?: boolean;
+}
 interface ColumnWrapperStyle {
     rowGap?: number;
     gap?: number;
@@ -250,7 +255,6 @@ interface InternalState {
     isEndReached: boolean;
     isAtEnd: boolean;
     isAtStart: boolean;
-    data: readonly any[];
     hasScrolled?: boolean;
     scrollLength: number;
     startBuffered: number;
@@ -275,7 +279,6 @@ interface InternalState {
     indexByKey: Map<string, number>;
     idCache: Map<number, string>;
     viewabilityConfigCallbackPairs: ViewabilityConfigCallbackPairs | undefined;
-    renderItem: ((props: LegendListRenderItemProps<any>) => ReactNode) | React.ComponentType<LegendListRenderItemProps<any>>;
     scrollHistory: Array<{
         scroll: number;
         time: number;
@@ -308,8 +311,53 @@ interface InternalState {
         num: number;
         avg: number;
     }>;
-    onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
-    stylePaddingBottom?: number;
+    refScroller: React.RefObject<ScrollView>;
+    loadStartTime: number;
+    initialScroll: ScrollIndexWithOffsetPosition | undefined;
+    lastLayout: LayoutRectangle | undefined;
+    props: {
+        alignItemsAtEnd: boolean;
+        data: readonly any[];
+        estimatedItemSize: number | undefined;
+        getEstimatedItemSize: ((index: number, item: any) => number) | undefined;
+        horizontal: boolean;
+        keyExtractor: ((item: any, index: number) => string) | undefined;
+        maintainScrollAtEnd: boolean | MaintainScrollAtEndOptions;
+        maintainScrollAtEndThreshold: number | undefined;
+        maintainVisibleContentPosition: boolean;
+        onEndReached: (((info: {
+            distanceFromEnd: number;
+        }) => void) | null | undefined) | undefined;
+        onEndReachedThreshold: number | null | undefined;
+        onItemSizeChanged: ((info: {
+            size: number;
+            previous: number;
+            index: number;
+            itemKey: string;
+            itemData: any;
+        }) => void) | undefined;
+        onLoad: ((info: {
+            elapsedTimeInMs: number;
+        }) => void) | undefined;
+        onScroll: ((event: NativeSyntheticEvent<NativeScrollEvent>) => void) | undefined;
+        onStartReached: (((info: {
+            distanceFromStart: number;
+        }) => void) | null | undefined) | undefined;
+        onStartReachedThreshold: number | null | undefined;
+        suggestEstimatedItemSize: boolean;
+        stylePaddingBottom: number | undefined;
+        renderItem: ((props: LegendListRenderItemProps<any>) => ReactNode) | React.ComponentType<LegendListRenderItemProps<any>>;
+        initialScroll: {
+            index: number;
+            viewOffset?: number;
+            viewPosition?: number;
+        } | undefined;
+        scrollBuffer: number;
+        viewabilityConfigCallbackPairs: ViewabilityConfigCallbackPairs | undefined;
+        numColumns: number;
+        initialContainerPoolRatio: number;
+        stylePaddingTop: number | undefined;
+    };
 }
 interface ViewableRange<T> {
     startBuffered: number;
@@ -533,10 +581,10 @@ declare const LegendList: <T>(props: Omit<Omit<react_native.ScrollViewProps, "sc
     keyExtractor?: ((item: T, index: number) => string) | undefined;
     ListEmptyComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListFooterComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
-    ListFooterComponentStyle?: react_native.StyleProp<ViewStyle> | undefined;
+    ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
-    ListHeaderComponentStyle?: react_native.StyleProp<ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -604,7 +652,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -666,7 +714,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -730,7 +778,7 @@ declare const LazyLegendList: <ItemT, ListT extends (<T>(props: Omit<Omit<react_
     ListFooterComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
     ListHeaderComponent?: React$1.ComponentType<any> | React$1.ReactElement | null | undefined;
     ListHeaderComponentStyle?: react_native.StyleProp<react_native.ViewStyle> | undefined;
-    maintainScrollAtEnd?: boolean;
+    maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
     maintainScrollAtEndThreshold?: number;
     maintainVisibleContentPosition?: boolean;
     numColumns?: number;
@@ -776,4 +824,4 @@ declare function useListScrollSize(): {
     height: number;
 };
 
-export { type ColumnWrapperStyle, type GetRenderedItem, type GetRenderedItemResult, type InternalState, LazyLegendList, type LazyLegendListProps, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type OnViewableItemsChanged, type ScrollIndexWithOffsetPosition, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };
+export { type ColumnWrapperStyle, type GetRenderedItem, type GetRenderedItemResult, type InternalState, LazyLegendList, type LazyLegendListProps, LegendList, type LegendListProps, type LegendListPropsBase, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type MaintainScrollAtEndOptions, type OnViewableItemsChanged, type ScrollIndexWithOffsetPosition, type ScrollState, type TypedForwardRef, type TypedMemo, type ViewAmountToken, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, type ViewableRange, typedForwardRef, typedMemo, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useViewability, useViewabilityAmount };