@legendapp/list 3.0.0-beta.53 → 3.0.0-beta.55

package/reanimated.d.ts

@@ -155,7 +155,10 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      */
     extraData?: any;
     /**
-     * In case you have distinct item sizes, you can provide a function to get the size of an item.
+     * Optional per-item size estimate used before a row is measured.
+     *
+     * @deprecated Prefer a single `estimatedItemSize` for initial size hints, or `getFixedItemSize`
+     * when item sizes are known exactly.
      */
     getEstimatedItemSize?: (item: ItemT, index: number, type: TItemType) => number;
     /**
@@ -173,8 +176,9 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
         leadingItem: ItemT;
     }>;
     /**
-     * Ratio of initial container pool size to data length (e.g., 0.5 for half).
-     * @default 2
+     * Ratio used to size the initial recycled container pool.
+     * @deprecated The list now manages spare container capacity automatically.
+     * @default 3
      */
     initialContainerPoolRatio?: number | undefined;
     /**
@@ -225,6 +229,13 @@ 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.
@@ -259,6 +270,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * @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.
      */
@@ -355,12 +372,6 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Array of item indices to use as snap points.
      */
     snapToIndices?: number[];
-    /**
-     * This will log a suggested estimatedItemSize.
-     * @required
-     * @default false
-     */
-    suggestEstimatedItemSize?: boolean;
     /**
      * Configuration for determining item viewability.
      */
@@ -449,6 +460,10 @@ interface LegendListMetrics {
     headerSize: number;
     footerSize: number;
 }
+interface LegendListAverageItemSize {
+    average: number;
+    count: number;
+}
 interface LegendListRenderItemProps<ItemT, TItemType extends string | number | undefined = string | number | undefined> {
     data: readonly ItemT[];
     extraData: any;
@@ -470,6 +485,7 @@ type LegendListState = {
     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;

package/reanimated.js

@@ -50,7 +50,7 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
   const combinedRef = useCombinedRef(animatedScrollRef, forwardedRef);
   const ScrollComponent = React__namespace.useMemo(
     () => renderScrollComponent ? React__namespace.forwardRef(
-      (scrollViewProps, ref) => renderScrollComponent({ ...scrollViewProps, ref })
+      (scrollViewProps, ref) => renderScrollComponent({ ...scrollViewProps, ref, scrollEventThrottle: 1 })
     ) : Reanimated__default.default.ScrollView,
     [renderScrollComponent]
   );

package/reanimated.mjs

@@ -26,7 +26,7 @@ var ReanimatedScrollBridge = typedMemo(function ReanimatedScrollBridgeComponent(
   const combinedRef = useCombinedRef(animatedScrollRef, forwardedRef);
   const ScrollComponent = React.useMemo(
     () => renderScrollComponent ? React.forwardRef(
-      (scrollViewProps, ref) => renderScrollComponent({ ...scrollViewProps, ref })
+      (scrollViewProps, ref) => renderScrollComponent({ ...scrollViewProps, ref, scrollEventThrottle: 1 })
     ) : Reanimated.ScrollView,
     [renderScrollComponent]
   );

package/section-list.d.ts

@@ -211,7 +211,10 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      */
     extraData?: any;
     /**
-     * In case you have distinct item sizes, you can provide a function to get the size of an item.
+     * Optional per-item size estimate used before a row is measured.
+     *
+     * @deprecated Prefer a single `estimatedItemSize` for initial size hints, or `getFixedItemSize`
+     * when item sizes are known exactly.
      */
     getEstimatedItemSize?: (item: ItemT, index: number, type: TItemType) => number;
     /**
@@ -229,8 +232,9 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
         leadingItem: ItemT;
     }>;
     /**
-     * Ratio of initial container pool size to data length (e.g., 0.5 for half).
-     * @default 2
+     * Ratio used to size the initial recycled container pool.
+     * @deprecated The list now manages spare container capacity automatically.
+     * @default 3
      */
     initialContainerPoolRatio?: number | undefined;
     /**
@@ -281,6 +285,13 @@ 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.
@@ -315,6 +326,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * @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.
      */
@@ -411,12 +428,6 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Array of item indices to use as snap points.
      */
     snapToIndices?: number[];
-    /**
-     * This will log a suggested estimatedItemSize.
-     * @required
-     * @default false
-     */
-    suggestEstimatedItemSize?: boolean;
     /**
      * Configuration for determining item viewability.
      */
@@ -505,6 +516,10 @@ interface LegendListMetrics {
     headerSize: number;
     footerSize: number;
 }
+interface LegendListAverageItemSize {
+    average: number;
+    count: number;
+}
 interface LegendListRenderItemProps<ItemT, TItemType extends string | number | undefined = string | number | undefined> {
     data: readonly ItemT[];
     extraData: any;
@@ -526,6 +541,7 @@ type LegendListState = {
     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;