@legendapp/list 3.0.0-beta.9 → 3.0.1

package/{types-1Hgg1rTO.d.mts → react-native.d.ts}

@@ -1,24 +1,32 @@
-import * as React$1 from 'react';
-import { ComponentProps, Key, ReactNode } from 'react';
-import { View, ScrollView, Animated, LayoutRectangle, ScrollViewProps, Insets, ScrollViewComponent, ScrollResponderMixin, StyleProp, ViewStyle, NativeSyntheticEvent, NativeScrollEvent } from 'react-native';
-import Reanimated from 'react-native-reanimated';
+import * as React from 'react';
+import { Key, Dispatch, SetStateAction } from 'react';
+import { ScrollViewProps, NativeSyntheticEvent as NativeSyntheticEvent$1, NativeScrollEvent as NativeScrollEvent$1, ScrollView, StyleProp as StyleProp$1, ViewStyle as ViewStyle$1, ScrollViewComponent, ScrollResponderMixin, Insets as Insets$1, View } from 'react-native';
 
-type AnimatedValue = number;
+interface MaintainVisibleContentPositionNormalized<ItemT = any> {
+    data: boolean;
+    size: boolean;
+    shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
+}
 
-type ListenerType = "activeStickyIndex" | "alignItemsPaddingTop" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | `containerColumn${number}` | `containerItemData${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}` | `containerStickyOffset${number}`;
-type LegendListListenerType = Extract<ListenerType, "activeStickyIndex" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "snapToOffsets" | "totalSize">;
+type ListenerType = "activeStickyIndex" | "anchoredEndSpaceSize" | "debugComputedScroll" | "debugRawScroll" | "extraData" | "footerSize" | "headerSize" | "lastItemKeys" | "lastPositionUpdate" | "maintainVisibleContentPosition" | "numColumns" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "scrollAdjust" | "scrollAdjustPending" | "scrollAdjustUserOffset" | "scrollSize" | "snapToOffsets" | "stylePaddingTop" | "totalSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | `containerColumn${number}` | `containerSpan${number}` | `containerItemData${number}` | `containerItemKey${number}` | `containerPosition${number}` | `containerSticky${number}`;
+type LegendListListenerType = Extract<ListenerType, "activeStickyIndex" | "anchoredEndSpaceSize" | "footerSize" | "headerSize" | "isAtEnd" | "isAtStart" | "isNearEnd" | "isNearStart" | "isWithinMaintainScrollAtEndThreshold" | "lastItemKeys" | "lastPositionUpdate" | "numContainers" | "numContainersPooled" | "otherAxisSize" | "readyToRender" | "snapToOffsets" | "totalSize">;
 type ListenerTypeValueMap = {
     activeStickyIndex: number;
-    alignItemsPaddingTop: number;
+    anchoredEndSpaceSize: number;
     animatedScrollY: any;
     debugComputedScroll: number;
     debugRawScroll: number;
     extraData: any;
     footerSize: number;
     headerSize: number;
+    isAtEnd: boolean;
+    isAtStart: boolean;
+    isNearEnd: boolean;
+    isNearStart: boolean;
+    isWithinMaintainScrollAtEndThreshold: boolean;
     lastItemKeys: string[];
     lastPositionUpdate: number;
-    maintainVisibleContentPosition: boolean;
+    maintainVisibleContentPosition: MaintainVisibleContentPositionNormalized;
     numColumns: number;
     numContainers: number;
     numContainersPooled: number;
@@ -43,49 +51,44 @@ type ListenerTypeValueMap = {
 } & {
     [K in ListenerType as K extends `containerColumn${number}` ? K : never]: number;
 } & {
-    [K in ListenerType as K extends `containerSticky${number}` ? K : never]: boolean;
+    [K in ListenerType as K extends `containerSpan${number}` ? K : never]: number;
 } & {
-    [K in ListenerType as K extends `containerStickyOffset${number}` ? K : never]: number;
+    [K in ListenerType as K extends `containerSticky${number}` ? K : never]: boolean;
 };
-interface StateContext {
-    animatedScrollY: AnimatedValue;
-    columnWrapperStyle: ColumnWrapperStyle | undefined;
-    contextNum: number;
-    listeners: Map<ListenerType, Set<(value: any) => void>>;
-    mapViewabilityCallbacks: Map<string, ViewabilityCallback>;
-    mapViewabilityValues: Map<string, ViewToken>;
-    mapViewabilityAmountCallbacks: Map<number, ViewabilityAmountCallback>;
-    mapViewabilityAmountValues: Map<number, ViewAmountToken>;
-    mapViewabilityConfigStates: Map<string, {
-        viewableItems: ViewToken[];
-        start: number;
-        end: number;
-        previousStart: number;
-        previousEnd: number;
-    }>;
-    positionListeners: Map<string, Set<(value: any) => void>>;
-    state: InternalState;
-    values: Map<ListenerType, any>;
-    viewRefs: Map<number, React$1.RefObject<View>>;
-}
 
-declare class ScrollAdjustHandler {
-    private appliedAdjust;
-    private pendingAdjust;
-    private ctx;
-    constructor(ctx: StateContext);
-    requestAdjust(add: number): void;
-    getAdjust(): number;
-    commitPendingAdjust(): void;
+interface Insets {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
 }
-
-type BaseSharedValue<T = number> = {
-    get: () => T;
-};
-type StylesAsSharedValue<Style> = {
-    [key in keyof Style]: Style[key] | BaseSharedValue<Style[key]>;
-};
-
+interface LayoutRectangle {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface NativeScrollEvent {
+    contentOffset: {
+        x: number;
+        y: number;
+    };
+    contentSize: {
+        width: number;
+        height: number;
+    };
+    layoutMeasurement: {
+        width: number;
+        height: number;
+    };
+    contentInset: Insets;
+    zoomScale: number;
+}
+interface NativeSyntheticEvent<T> {
+    nativeEvent: T;
+}
+type ViewStyle = Record<string, unknown>;
+type StyleProp<T> = T | T[] | null | undefined | false;
 type BaseScrollViewProps<TScrollView> = Omit<TScrollView, "contentOffset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children" | "onScroll">;
 interface DataModeProps<ItemT, TItemType extends string | undefined> {
     /**
@@ -94,13 +97,11 @@ interface DataModeProps<ItemT, TItemType extends string | undefined> {
      */
     data: ReadonlyArray<ItemT>;
     /**
-     * Function or React component to render each item in the list.
-     * Can be either:
-     * - A function: (props: LegendListRenderItemProps<ItemT>) => ReactNode
-     * - A React component: React.ComponentType<LegendListRenderItemProps<ItemT>>
+     * Callback to render each item in the list.
+     * To use hooks in an item component, return that component from this callback.
      * @required when using data mode
      */
-    renderItem: ((props: LegendListRenderItemProps<ItemT, TItemType>) => ReactNode) | React.ComponentType<LegendListRenderItemProps<ItemT, TItemType>>;
+    renderItem: (props: LegendListRenderItemProps<ItemT, TItemType>) => React.ReactNode;
     children?: never;
 }
 interface ChildrenModeProps {
@@ -109,7 +110,7 @@ interface ChildrenModeProps {
      * Each child will be treated as an individual list item.
      * @required when using children mode
      */
-    children: ReactNode;
+    children: React.ReactNode;
     data?: never;
     renderItem?: never;
 }
@@ -119,10 +120,20 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * @default false
      */
     alignItemsAtEnd?: boolean;
+    /**
+     * Keeps selected items mounted even when they scroll out of view.
+     * @default undefined
+     */
+    alwaysRender?: AlwaysRenderConfig;
     /**
      * Style applied to each column's wrapper view.
      */
     columnWrapperStyle?: ColumnWrapperStyle;
+    /**
+     * Version token that forces the list to treat data as updated even when the array reference is stable.
+     * Increment or change this when mutating the data array in place.
+     */
+    dataVersion?: Key;
     /**
      * Distance in pixels to pre-render items ahead of the visible area.
      * @default 250
@@ -147,25 +158,25 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      */
     extraData?: any;
     /**
-     * Version token that forces the list to treat data as updated even when the array reference is stable.
-     * Increment or change this when mutating the data array in place.
+     * In case items always have a fixed size, you can provide a function to return it.
      */
-    dataVersion?: Key;
+    getFixedItemSize?: (item: ItemT, index: number, type: TItemType) => number | undefined;
     /**
-     * In case you have distinct item sizes, you can provide a function to get the size of an item.
-     * Use instead of FlatList's getItemLayout or FlashList overrideItemLayout if you want to have accurate initialScrollOffset, you should provide this function
+     * Returns a stable item type used for pooling and size estimation.
      */
-    getEstimatedItemSize?: (index: number, item: ItemT, type: TItemType) => number;
+    getItemType?: (item: ItemT, index: number) => TItemType;
     /**
-     * Ratio of initial container pool size to data length (e.g., 0.5 for half).
-     * @default 2
+     * Component to render between items, receiving the leading item as prop.
      */
-    initialContainerPoolRatio?: number | undefined;
+    ItemSeparatorComponent?: React.ComponentType<{
+        leadingItem: ItemT;
+    }>;
     /**
-     * Initial scroll position in pixels.
-     * @default 0
+     * When true, the list initializes scrolled to the last item.
+     * Overrides `initialScrollIndex` and `initialScrollOffset` when data is available.
+     * @default false
      */
-    initialScrollOffset?: number;
+    initialScrollAtEnd?: boolean;
     /**
      * Index to scroll to initially.
      * @default 0
@@ -173,19 +184,17 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     initialScrollIndex?: number | {
         index: number;
         viewOffset?: number | undefined;
+        viewPosition?: number | undefined;
     };
     /**
-     * When true, the list initializes scrolled to the last item.
-     * Overrides `initialScrollIndex` and `initialScrollOffset` when data is available.
-     * @default false
+     * Initial scroll position in pixels.
+     * @default 0
      */
-    initialScrollAtEnd?: boolean;
+    initialScrollOffset?: number;
     /**
-     * Component to render between items, receiving the leading item as prop.
+     * Custom equality function to detect semantically unchanged items.
      */
-    ItemSeparatorComponent?: React.ComponentType<{
-        leadingItem: ItemT;
-    }>;
+    itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
     /**
      * Function to extract a unique key for each item.
      */
@@ -210,8 +219,16 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Style for the header component.
      */
     ListHeaderComponentStyle?: StyleProp<ViewStyle> | undefined;
+    /**
+     * Estimated height of the ListHeaderComponent. Provide this when the expected header height
+     * is known before layout so that only the items actually visible below the header are rendered
+     * on the initial frame, rather than a full screen's worth of items that are hidden behind it.
+     * The measured header size still replaces this value after layout.
+     */
+    estimatedHeaderSize?: number;
     /**
      * If true, auto-scrolls to end when new items are added.
+     * Use an options object to opt into specific triggers and control whether that scroll is animated.
      * @default false
      */
     maintainScrollAtEnd?: boolean | MaintainScrollAtEndOptions;
@@ -221,16 +238,34 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      */
     maintainScrollAtEndThreshold?: number;
     /**
-     * If true, maintains visibility of content across data changes (filtering/resorting/insertions).
-     * Scroll-time stability for measurements is always enabled.
-     * @default false
+     * Maintains visibility of content.
+     * - scroll (default: true) stabilizes during size/layout changes while scrolling.
+     * - data (default: false) stabilizes when the data array changes; passing true also sets the RN maintainVisibleContentPosition prop.
+     * - shouldRestorePosition can opt out specific items from data-change anchoring.
+     * - undefined (default) enables scroll stabilization but skips data-change anchoring.
+     * - true enables both behaviors; false disables both.
      */
-    maintainVisibleContentPosition?: boolean;
+    maintainVisibleContentPosition?: boolean | MaintainVisibleContentPositionConfig<ItemT>;
+    /**
+     * Keeps an item visually anchored to the start by adding trailing space when the content below it underflows.
+     */
+    anchoredEndSpace?: AnchoredEndSpaceConfig;
+    /**
+     * Adjusts the effective end content inset for web lists without replacing the base contentInset.
+     * The adjustment is also rendered as real content padding so the browser scroll range includes it.
+     */
+    contentInsetEndAdjustment?: number;
     /**
      * Number of columns to render items in.
      * @default 1
      */
     numColumns?: number;
+    /**
+     * Force RTL mode for this list instance.
+     * When undefined, uses React Native's global I18nManager.isRTL.
+     * @default undefined
+     */
+    rtl?: boolean;
     /**
      * Called when scrolling reaches the end within onEndReachedThreshold.
      */
@@ -252,10 +287,23 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
         itemKey: string;
         itemData: ItemT;
     }) => void;
+    /**
+     * Called after the initial render work completes.
+     */
+    onLoad?: (info: {
+        elapsedTimeInMs: number;
+    }) => void;
+    /**
+     * Called when list layout metrics change.
+     */
+    onMetricsChange?: (metrics: LegendListMetrics) => void;
     /**
      * Function to call when the user pulls to refresh.
      */
     onRefresh?: () => void;
+    /**
+     * Called when the list scrolls.
+     */
     onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
     /**
      * Called when scrolling reaches the start within onStartReachedThreshold.
@@ -279,6 +327,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Called when the viewability of items changes.
      */
     onViewableItemsChanged?: OnViewableItemsChanged<ItemT> | undefined;
+    /**
+     * Customize layout for multi-column lists, such as allowing items to span multiple columns.
+     */
+    overrideItemLayout?: (layout: {
+        span?: number;
+    }, item: ItemT, index: number, maxColumns: number, extraData?: any) => void;
     /**
      * Offset in pixels for the refresh indicator.
      * @default 0
@@ -292,7 +346,7 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     /**
      * Ref to the underlying ScrollView component.
      */
-    refScrollView?: React.Ref<ScrollView>;
+    refScrollView?: React.Ref<any>;
     /**
      * If true, shows a refresh indicator.
      * @default false
@@ -303,13 +357,11 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Note: When using `stickyHeaderIndices`, you must provide an Animated ScrollView component.
      * @default (props) => <ScrollView {...props} />
      */
-    renderScrollComponent?: (props: ScrollViewProps) => React.ReactElement<ScrollViewProps>;
+    renderScrollComponent?: (props: any) => React.ReactElement | null;
     /**
-     * This will log a suggested estimatedItemSize.
-     * @required
-     * @default false
+     * Array of item indices to use as snap points.
      */
-    suggestEstimatedItemSize?: boolean;
+    snapToIndices?: number[];
     /**
      * Configuration for determining item viewability.
      */
@@ -318,15 +370,6 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Pairs of viewability configs and their callbacks for tracking visibility.
      */
     viewabilityConfigCallbackPairs?: ViewabilityConfigCallbackPairs<ItemT> | undefined;
-    /**
-     * If true, delays rendering until initial layout is complete.
-     * @default false
-     */
-    waitForInitialLayout?: boolean;
-    onLoad?: (info: {
-        elapsedTimeInMs: number;
-    }) => void;
-    snapToIndices?: number[];
     /**
      * Array of child indices determining which children get docked to the top of the screen when scrolling.
      * For example, passing stickyHeaderIndices={[0]} will cause the first child to be fixed to the top of the scroll view.
@@ -335,174 +378,77 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      */
     stickyHeaderIndices?: number[];
     /**
-     * @deprecated Use stickyHeaderIndices instead for parity with React Native.
+     * Configuration for sticky headers.
+     * @default undefined
      */
-    stickyIndices?: number[];
-    getItemType?: (item: ItemT, index: number) => TItemType;
-    getFixedItemSize?: (index: number, item: ItemT, type: TItemType) => number | undefined;
-    itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
+    stickyHeaderConfig?: StickyHeaderConfig;
+    /**
+     * Web only: when true, listens to window/body scrolling instead of rendering a scrollable list container.
+     * @default false
+     */
+    useWindowScroll?: boolean;
+}
+type LegendListPropsBase<ItemT, TScrollViewProps = Record<string, any>, TItemType extends string | undefined = string | undefined> = BaseScrollViewProps<TScrollViewProps> & LegendListSpecificProps<ItemT, TItemType> & (DataModeProps<ItemT, TItemType> | ChildrenModeProps);
+interface MaintainVisibleContentPositionConfig<ItemT = any> {
+    data?: boolean;
+    size?: boolean;
+    shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
+}
+interface AnchoredEndSpaceConfig {
+    anchorIndex: number;
+    anchorOffset?: number;
+    anchorMaxSize?: number;
+    includeInEndInset?: boolean;
+    onSizeChanged?: (size: number) => void;
+}
+interface StickyHeaderConfig {
+    /**
+     * Specifies how far from the top edge sticky headers should start sticking.
+     * Useful for scenarios with a fixed navbar or header, where sticky elements pin below it..
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * Component to render as a backdrop behind the sticky header.
+     * @default undefined
+     */
+    backdropComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
+}
+interface AlwaysRenderConfig {
+    top?: number;
+    bottom?: number;
+    indices?: number[];
+    keys?: string[];
+}
+interface MaintainScrollAtEndOnOptions {
+    dataChange?: boolean;
+    itemLayout?: boolean;
+    layout?: boolean;
 }
-type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView> | ComponentProps<typeof Reanimated.ScrollView>, TItemType extends string | undefined = string | undefined> = BaseScrollViewProps<TScrollView> & LegendListSpecificProps<ItemT, TItemType> & (DataModeProps<ItemT, TItemType> | ChildrenModeProps);
 interface MaintainScrollAtEndOptions {
-    onLayout?: boolean;
-    onItemLayout?: boolean;
-    onDataChange?: boolean;
+    /**
+     * Whether maintainScrollAtEnd should animate when it scrolls to the end.
+     */
+    animated?: boolean;
+    /**
+     * Which events should keep the list pinned to the end.
+     * - If omitted, object values default to all triggers.
+     * - If provided, only the keys set to `true` are enabled.
+     */
+    on?: MaintainScrollAtEndOnOptions;
 }
 interface ColumnWrapperStyle {
     rowGap?: number;
     gap?: number;
     columnGap?: number;
 }
-type LegendListProps<ItemT = any> = LegendListPropsBase<ItemT, ComponentProps<typeof ScrollView>>;
-interface ThresholdSnapshot {
-    scrollPosition: number;
-    contentSize?: number;
-    dataLength?: number;
-    atThreshold: boolean;
-}
-interface ScrollTarget {
-    animated?: boolean;
-    index?: number;
-    isInitialScroll?: boolean;
-    itemSize?: number;
-    offset: number;
-    precomputedWithViewOffset?: boolean;
-    viewOffset?: number;
-    viewPosition?: number;
-}
-interface InternalState {
-    activeStickyIndex: number | undefined;
-    adjustingFromInitialMount?: number;
-    animFrameCheckFinishedScroll?: any;
-    averageSizes: Record<string, {
-        num: number;
-        avg: number;
-    }>;
-    columns: Map<string, number>;
-    containerItemKeys: Set<string>;
-    containerItemTypes: Map<number, string>;
-    dataChangeNeedsScrollUpdate: boolean;
-    didColumnsChange?: boolean;
-    didDataChange?: boolean;
-    didFinishInitialScroll?: boolean;
-    didContainersLayout?: boolean;
-    enableScrollForNextCalculateItemsInView: boolean;
-    endBuffered: number;
-    endNoBuffer: number;
-    endReachedSnapshot: ThresholdSnapshot | undefined;
-    firstFullyOnScreenIndex: number;
-    hasScrolled?: boolean;
-    idCache: string[];
-    idsInView: string[];
-    ignoreScrollFromMVCP?: {
-        lt?: number;
-        gt?: number;
-    };
-    ignoreScrollFromMVCPIgnored?: boolean;
-    ignoreScrollFromMVCPTimeout?: any;
-    indexByKey: Map<string, number>;
-    initialAnchor?: InitialScrollAnchor;
-    initialScroll: ScrollIndexWithOffsetAndContentOffset | undefined;
-    isAtEnd: boolean;
-    isAtStart: boolean;
-    isEndReached: boolean | null;
-    isFirst?: boolean;
-    isStartReached: boolean | null;
-    lastBatchingAction: number;
-    lastLayout: LayoutRectangle | undefined;
-    lastScrollAdjustForHistory?: number;
-    loadStartTime: number;
-    maintainingScrollAtEnd?: boolean;
-    minIndexSizeChanged: number | undefined;
-    nativeMarginTop: number;
-    needsOtherAxisSize?: boolean;
-    otherAxisSize?: number;
-    pendingTotalSize?: number;
-    positions: Map<string, number>;
-    previousData?: readonly unknown[];
-    queuedCalculateItemsInView: number | undefined;
-    queuedInitialLayout?: boolean | undefined;
-    refScroller: React.RefObject<ScrollView>;
-    scroll: number;
-    scrollAdjustHandler: ScrollAdjustHandler;
-    scrollForNextCalculateItemsInView: {
-        top: number | null;
-        bottom: number | null;
-    } | undefined;
-    scrollHistory: Array<{
-        scroll: number;
-        time: number;
-    }>;
-    scrollingTo?: ScrollTarget | undefined;
-    scrollLastCalculate?: number;
-    scrollLength: number;
-    scrollPending: number;
-    scrollPrev: number;
-    scrollPrevTime: number;
-    scrollProcessingEnabled: boolean;
-    scrollTime: number;
-    sizes: Map<string, number>;
-    sizesKnown: Map<string, number>;
-    startBuffered: number;
-    startBufferedId?: string;
-    startNoBuffer: number;
-    startReachedSnapshot: ThresholdSnapshot | undefined;
-    stickyContainerPool: Set<number>;
-    stickyContainers: Map<number, number>;
-    timeouts: Set<number>;
-    timeoutSetPaddingTop?: any;
-    timeoutSizeMessage: any;
-    timeoutCheckFinishedScrollFallback?: any;
-    totalSize: number;
-    triggerCalculateItemsInView?: (params?: {
-        doMVCP?: boolean;
-        dataChanged?: boolean;
-        forceFullItemPositions?: boolean;
-    }) => void;
-    viewabilityConfigCallbackPairs: ViewabilityConfigCallbackPairs<any> | undefined;
-    props: {
-        alignItemsAtEnd: boolean;
-        animatedProps: StylesAsSharedValue<ScrollViewProps>;
-        contentInset: Insets | undefined;
-        data: readonly any[];
-        dataVersion: Key | undefined;
-        estimatedItemSize: number | undefined;
-        getEstimatedItemSize: LegendListProps["getEstimatedItemSize"];
-        getFixedItemSize: LegendListProps["getFixedItemSize"];
-        getItemType: LegendListProps["getItemType"];
-        horizontal: boolean;
-        initialContainerPoolRatio: number;
-        itemsAreEqual: LegendListProps["itemsAreEqual"];
-        keyExtractor: LegendListProps["keyExtractor"];
-        maintainScrollAtEnd: boolean | MaintainScrollAtEndOptions;
-        maintainScrollAtEndThreshold: number | undefined;
-        maintainVisibleContentPosition: boolean;
-        numColumns: number;
-        onEndReached: LegendListProps["onEndReached"];
-        onEndReachedThreshold: number | null | undefined;
-        onItemSizeChanged: LegendListProps["onItemSizeChanged"];
-        onLoad: LegendListProps["onLoad"];
-        onScroll: LegendListProps["onScroll"];
-        onStartReached: LegendListProps["onStartReached"];
-        onStartReachedThreshold: number | null | undefined;
-        onStickyHeaderChange: LegendListProps["onStickyHeaderChange"];
-        recycleItems: boolean;
-        renderItem: LegendListProps["renderItem"];
-        scrollBuffer: number;
-        snapToIndices: number[] | undefined;
-        stickyIndicesArr: number[];
-        stickyIndicesSet: Set<number>;
-        stylePaddingBottom: number | undefined;
-        stylePaddingTop: number | undefined;
-        suggestEstimatedItemSize: boolean;
-    };
+interface LegendListMetrics {
+    headerSize: number;
+    footerSize: number;
 }
-interface ViewableRange<T> {
-    end: number;
-    endBuffered: number;
-    items: T[];
-    start: number;
-    startBuffered: number;
+interface LegendListAverageItemSize {
+    average: number;
+    count: number;
 }
 interface LegendListRenderItemProps<ItemT, TItemType extends string | number | undefined = string | number | undefined> {
     data: readonly ItemT[];
@@ -511,27 +457,34 @@ interface LegendListRenderItemProps<ItemT, TItemType extends string | number | u
     item: ItemT;
     type: TItemType;
 }
-type LegendListState = {
+type LegendListState$1 = {
     activeStickyIndex: number;
     contentLength: number;
     data: readonly any[];
-    elementAtIndex: (index: number) => View | null | undefined;
+    elementAtIndex: (index: number) => any;
     end: number;
     endBuffered: number;
     isAtEnd: boolean;
     isAtStart: boolean;
+    isNearEnd: boolean;
+    isNearStart: boolean;
+    isEndReached: boolean;
+    isStartReached: boolean;
+    isWithinMaintainScrollAtEndThreshold: boolean;
+    getAverageItemSizes: () => Record<string, LegendListAverageItemSize>;
     listen: <T extends LegendListListenerType>(listenerType: T, callback: (value: ListenerTypeValueMap[T]) => void) => () => void;
     listenToPosition: (key: string, callback: (value: number) => void) => () => void;
     positionAtIndex: (index: number) => number;
-    positions: Map<string, number>;
+    positionByKey: (key: string) => number | undefined;
     scroll: number;
     scrollLength: number;
+    scrollVelocity: number;
     sizeAtIndex: (index: number) => number;
     sizes: Map<string, number>;
     start: number;
     startBuffered: number;
 };
-type LegendListRef = {
+type LegendListRef$1 = {
     /**
      * Displays the scroll indicators momentarily.
      */
@@ -539,7 +492,7 @@ type LegendListRef = {
     /**
      * Returns the native ScrollView component reference.
      */
-    getNativeScrollRef(): React.ElementRef<typeof ScrollViewComponent>;
+    getNativeScrollRef(): any;
     /**
      * Returns the scroll responder instance for handling scroll events.
      */
@@ -547,11 +500,11 @@ type LegendListRef = {
     /**
      * Returns the ScrollResponderMixin for advanced scroll handling.
      */
-    getScrollResponder(): ScrollResponderMixin;
+    getScrollResponder(): any;
     /**
      * Returns the internal state of the scroll virtualization.
      */
-    getState(): LegendListState;
+    getState(): LegendListState$1;
     /**
      * Scrolls a specific index into view.
      * @param params - Parameters for scrolling.
@@ -561,7 +514,7 @@ type LegendListRef = {
     scrollIndexIntoView(params: {
         animated?: boolean | undefined;
         index: number;
-    }): void;
+    }): Promise<void>;
     /**
      * Scrolls a specific index into view.
      * @param params - Parameters for scrolling.
@@ -571,7 +524,7 @@ type LegendListRef = {
     scrollItemIntoView(params: {
         animated?: boolean | undefined;
         item: any;
-    }): void;
+    }): Promise<void>;
     /**
      * Scrolls to the end of the list.
      * @param options - Options for scrolling.
@@ -581,7 +534,7 @@ type LegendListRef = {
     scrollToEnd(options?: {
         animated?: boolean | undefined;
         viewOffset?: number | undefined;
-    }): void;
+    }): Promise<void>;
     /**
      * Scrolls to a specific index in the list.
      * @param params - Parameters for scrolling.
@@ -595,7 +548,7 @@ type LegendListRef = {
         index: number;
         viewOffset?: number | undefined;
         viewPosition?: number | undefined;
-    }): void;
+    }): Promise<void>;
     /**
      * Scrolls to a specific item in the list.
      * @param params - Parameters for scrolling.
@@ -609,7 +562,7 @@ type LegendListRef = {
         item: any;
         viewOffset?: number | undefined;
         viewPosition?: number | undefined;
-    }): void;
+    }): Promise<void>;
     /**
      * Scrolls to a specific offset in pixels.
      * @param params - Parameters for scrolling.
@@ -619,7 +572,7 @@ type LegendListRef = {
     scrollToOffset(params: {
         offset: number;
         animated?: boolean | undefined;
-    }): void;
+    }): Promise<void>;
     /**
      * Sets or adds to the offset of the visible content anchor.
      * @param value - The offset to set or add.
@@ -631,6 +584,19 @@ type LegendListRef = {
      * @param enabled - If true, scroll processing is enabled.
      */
     setScrollProcessingEnabled(enabled: boolean): void;
+    /**
+     * Clears internal virtualization caches.
+     * @param options - Cache clearing options.
+     * @param options.mode - `sizes` clears measurement caches. `full` also clears key/position caches.
+     */
+    clearCaches(options?: {
+        mode?: "sizes" | "full";
+    }): void;
+    /**
+     * Reports an externally measured content inset. Pass null/undefined to clear.
+     * Values are merged on top of props/animated/native insets.
+     */
+    reportContentInset(inset?: Partial<Insets> | null): void;
 };
 interface ViewToken<ItemT = any> {
     containerId: number;
@@ -651,10 +617,15 @@ interface ViewabilityConfigCallbackPair<ItemT = any> {
     viewabilityConfig: ViewabilityConfig;
 }
 type ViewabilityConfigCallbackPairs<ItemT> = ViewabilityConfigCallbackPair<ItemT>[];
-type OnViewableItemsChanged<ItemT> = ((info: {
-    viewableItems: Array<ViewToken<ItemT>>;
+interface OnViewableItemsChangedInfo<ItemT> {
     changed: Array<ViewToken<ItemT>>;
-}) => void) | null;
+    end: number;
+    endBuffered: number;
+    start: number;
+    startBuffered: number;
+    viewableItems: Array<ViewToken<ItemT>>;
+}
+type OnViewableItemsChanged<ItemT> = ((info: OnViewableItemsChangedInfo<ItemT>) => void) | null;
 interface ViewabilityConfig {
     /**
      * A unique ID to identify this viewability config
@@ -692,12 +663,6 @@ interface LegendListRecyclingState<T> {
     prevIndex: number | undefined;
     prevItem: T | undefined;
 }
-type TypedForwardRef = <T, P = {}>(render: (props: P, ref: React.Ref<T>) => React.ReactNode) => (props: P & React.RefAttributes<T>) => React.ReactNode;
-declare const typedForwardRef: TypedForwardRef;
-type TypedMemo = <T extends React.ComponentType<any>>(Component: T, propsAreEqual?: (prevProps: Readonly<React.JSXElementConstructor<T>>, nextProps: Readonly<React.JSXElementConstructor<T>>) => boolean) => T & {
-    displayName?: string;
-};
-declare const typedMemo: TypedMemo;
 interface ScrollIndexWithOffset {
     index: number;
     viewOffset?: number;
@@ -709,16 +674,36 @@ interface ScrollIndexWithOffsetPosition extends ScrollIndexWithOffset {
 interface ScrollIndexWithOffsetAndContentOffset extends ScrollIndexWithOffsetPosition {
     contentOffset?: number;
 }
-interface InitialScrollAnchor extends ScrollIndexWithOffsetPosition {
-    attempts?: number;
-    lastDelta?: number;
-    settledTicks?: number;
-}
-type GetRenderedItemResult<ItemT> = {
-    index: number;
-    item: ItemT;
-    renderedItem: React.ReactNode;
+
+type LegendListPropsOverrides<ItemT, TItemType extends string | undefined> = Omit<LegendListPropsBase<ItemT, ScrollViewProps, TItemType>, "anchoredEndSpace" | "contentInsetEndAdjustment" | "onScroll" | "refScrollView" | "renderScrollComponent" | "ListHeaderComponentStyle" | "ListFooterComponentStyle"> & {
+    onScroll?: (event: NativeSyntheticEvent$1<NativeScrollEvent$1>) => void;
+    refScrollView?: React.Ref<ScrollView>;
+    renderScrollComponent?: (props: ScrollViewProps) => React.ReactElement<ScrollViewProps>;
+    ListHeaderComponentStyle?: StyleProp$1<ViewStyle$1> | undefined;
+    ListFooterComponentStyle?: StyleProp$1<ViewStyle$1> | undefined;
+};
+type LegendListProps<ItemT = any, TItemType extends string | undefined = string | undefined> = LegendListPropsOverrides<ItemT, TItemType>;
+type LegendListRef = Omit<LegendListRef$1, "getNativeScrollRef" | "getScrollResponder" | "reportContentInset"> & {
+    getNativeScrollRef(): React.ElementRef<typeof ScrollViewComponent>;
+    getScrollResponder(): ScrollResponderMixin;
+    reportContentInset(inset?: Partial<Insets$1> | null): void;
 };
-type GetRenderedItem = (key: string) => GetRenderedItemResult<any> | null;
+type LegendListState = Omit<LegendListState$1, "elementAtIndex"> & {
+    elementAtIndex: (index: number) => View | null | undefined;
+};
+type LegendListComponent = <ItemT = any>(props: LegendListProps<ItemT> & React.RefAttributes<LegendListRef>) => React.ReactElement | null;
+
+declare function useViewability<ItemT = any>(callback: ViewabilityCallback<ItemT>, configId?: string): void;
+declare function useViewabilityAmount<ItemT = any>(callback: ViewabilityAmountCallback<ItemT>): void;
+declare function useRecyclingEffect(effect: (info: LegendListRecyclingState<unknown>) => void | (() => void)): void;
+declare function useRecyclingState<ItemT>(valueOrFun: ((info: LegendListRecyclingState<ItemT>) => ItemT) | ItemT): readonly [ItemT, Dispatch<SetStateAction<ItemT>>];
+declare function useIsLastItem(): boolean;
+declare function useListScrollSize(): {
+    width: number;
+    height: number;
+};
+declare function useSyncLayout(): () => void;
+
+declare const LegendList: LegendListComponent;
 
-export { type ColumnWrapperStyle as C, type GetRenderedItemResult as G, type InternalState as I, type LegendListProps as L, type MaintainScrollAtEndOptions as M, type OnViewableItemsChanged as O, type ScrollTarget as S, type ThresholdSnapshot as T, type ViewabilityCallback as V, type LegendListRef as a, type ViewabilityAmountCallback as b, type LegendListRecyclingState as c, type LegendListPropsBase as d, type ViewableRange as e, type LegendListRenderItemProps as f, type LegendListState as g, type ViewToken as h, type ViewAmountToken as i, type ViewabilityConfigCallbackPair as j, type ViewabilityConfigCallbackPairs as k, type ViewabilityConfig as l, type TypedForwardRef as m, type TypedMemo as n, typedMemo as o, type ScrollIndexWithOffset as p, type ScrollIndexWithOffsetPosition as q, type ScrollIndexWithOffsetAndContentOffset as r, type InitialScrollAnchor as s, typedForwardRef as t, type GetRenderedItem as u };
+export { type AlwaysRenderConfig, type ColumnWrapperStyle, type Insets, type LayoutRectangle, LegendList, type LegendListAverageItemSize, type LegendListComponent, type LegendListMetrics, type LegendListProps, type LegendListRecyclingState, type LegendListRef, type LegendListRenderItemProps, type LegendListState, type MaintainScrollAtEndOnOptions, type MaintainScrollAtEndOptions, type MaintainVisibleContentPositionConfig, type NativeScrollEvent, type NativeSyntheticEvent, type OnViewableItemsChanged, type OnViewableItemsChangedInfo, type ScrollIndexWithOffset, type ScrollIndexWithOffsetAndContentOffset, type ScrollIndexWithOffsetPosition, type StickyHeaderConfig, type StyleProp, type ViewAmountToken, type ViewStyle, type ViewToken, type ViewabilityAmountCallback, type ViewabilityCallback, type ViewabilityConfig, type ViewabilityConfigCallbackPair, type ViewabilityConfigCallbackPairs, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useSyncLayout, useViewability, useViewabilityAmount };