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

package/animated.d.ts

@@ -91,13 +91,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>) => React.ReactNode) | React.ComponentType<LegendListRenderItemProps<ItemT, TItemType>>;
+    renderItem: (props: LegendListRenderItemProps<ItemT, TItemType>) => React.ReactNode;
     children?: never;
 }
 interface ChildrenModeProps {
@@ -228,6 +226,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.
@@ -262,6 +267,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.
      */

package/index.d.ts

@@ -116,7 +116,7 @@ type BootstrapOwnedInitialScrollSession = InternalInitialScrollSessionBase & {
 type InternalInitialScrollSession = OffsetInitialScrollSession | BootstrapOwnedInitialScrollSession;
 type LegendListPropsInternal = LegendListPropsBase$1<any, Record<string, any>, string | undefined> & {
     data: readonly any[];
-    renderItem: ((props: LegendListRenderItemProps$1<any, string | undefined>) => React.ReactNode) | React.ComponentType<LegendListRenderItemProps$1<any, string | undefined>>;
+    renderItem: (props: LegendListRenderItemProps$1<any, string | undefined>) => React.ReactNode;
 };
 interface PendingDataComparison {
     byIndex: Array<0 | 1 | 2 | undefined>;
@@ -147,6 +147,9 @@ interface InternalState$1 {
     endNoBuffer: number;
     endReachedSnapshot: ThresholdSnapshot$1 | undefined;
     firstFullyOnScreenIndex: number;
+    preservedEndAnchorCorrection?: {
+        lastRequestTime?: number;
+    };
     hasScrolled?: boolean;
     idCache: string[];
     idsInView: string[];
@@ -166,6 +169,8 @@ interface InternalState$1 {
     isStartReached: boolean | null;
     lastBatchingAction: number;
     lastLayout: LayoutRectangle$1 | undefined;
+    lastNativeScroll?: number;
+    lastNativeScrollTime?: number;
     lastScrollAdjustForHistory?: number;
     lastScrollDelta: number;
     loadStartTime: number;
@@ -210,6 +215,7 @@ interface InternalState$1 {
         time: number;
     }>;
     scrollingTo?: InternalScrollTarget | undefined;
+    horizontalRTLScrollType?: "normal" | "inverted" | "negative";
     scrollLastCalculate?: number;
     scrollLength: number;
     scrollPending: number;
@@ -254,6 +260,7 @@ interface InternalState$1 {
         getFixedItemSize: LegendListPropsInternal["getFixedItemSize"];
         getItemType: LegendListPropsInternal["getItemType"];
         horizontal: boolean;
+        rtl?: boolean;
         initialContainerPoolRatio: number;
         itemsAreEqual: LegendListPropsInternal["itemsAreEqual"];
         keyExtractor: LegendListPropsInternal["keyExtractor"];
@@ -279,6 +286,8 @@ interface InternalState$1 {
         stickyIndicesArr: number[];
         stickyIndicesSet: Set<number>;
         stylePaddingBottom: number | undefined;
+        stylePaddingLeft: number | undefined;
+        stylePaddingRight: number | undefined;
         stylePaddingTop: number | undefined;
         useWindowScroll: boolean;
     };
@@ -415,13 +424,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$1<ItemT, TItemType>) => React.ReactNode) | React.ComponentType<LegendListRenderItemProps$1<ItemT, TItemType>>;
+    renderItem: (props: LegendListRenderItemProps$1<ItemT, TItemType>) => React.ReactNode;
     children?: never;
 }
 interface ChildrenModeProps {
@@ -552,6 +559,13 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Style for the header component.
      */
     ListHeaderComponentStyle?: StyleProp$1<ViewStyle$1> | 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.
@@ -586,6 +600,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.
      */