@legendapp/list 3.0.0-beta.52 → 3.0.0-beta.54

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;
     /**
@@ -249,6 +253,11 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * 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
@@ -350,12 +359,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.
      */
@@ -444,6 +447,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;
@@ -465,6 +472,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;
@@ -642,7 +650,7 @@ interface ViewabilityConfig {
     waitForInteraction?: boolean | undefined;
 }
 
-type LegendListPropsOverrides<ItemT, TItemType extends string | undefined> = Omit<LegendListPropsBase<ItemT, ScrollViewProps, TItemType>, "anchoredEndSpace" | "onScroll" | "refScrollView" | "renderScrollComponent" | "ListHeaderComponentStyle" | "ListFooterComponentStyle"> & {
+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>;

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;
     /**
@@ -305,6 +309,11 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * 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
@@ -406,12 +415,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.
      */
@@ -500,6 +503,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;
@@ -521,6 +528,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;
@@ -698,7 +706,7 @@ interface ViewabilityConfig {
     waitForInteraction?: boolean | undefined;
 }
 
-type LegendListPropsOverrides<ItemT, TItemType extends string | undefined> = Omit<LegendListPropsBase<ItemT, ScrollViewProps, TItemType>, "anchoredEndSpace" | "onScroll" | "refScrollView" | "renderScrollComponent" | "ListHeaderComponentStyle" | "ListFooterComponentStyle"> & {
+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>;