@legendapp/list 3.1.2 → 3.3.0

package/react.d.ts

@@ -115,26 +115,32 @@ interface NativeSyntheticEvent<T> {
 type ViewStyle = Record<string, unknown>;
 type StyleProp<T> = T | T[] | null | undefined | false;
 type AdaptiveRender = "normal" | "light";
+type AdaptiveRenderChangeReason = "initial" | "ready" | "scroll";
 interface AdaptiveRenderConfig {
+    /**
+     * Mode to use before the list is ready to render.
+     * @default "normal"
+     */
+    initialMode?: AdaptiveRender;
     /**
      * Scroll velocity in pixels per millisecond above which items should switch to light mode.
-     * @default 4
+     * @default 3 native, 6 web
      */
     enterVelocity?: number;
     /**
      * Scroll velocity in pixels per millisecond below which items can return to normal mode.
-     * @default 1
+     * @default 1 native, 3 web
      */
     exitVelocity?: number;
     /**
      * Time to wait without velocity above exitVelocity before returning to normal mode.
-     * @default 1000
+     * @default 250
      */
     exitDelay?: number;
     /**
      * Called when the list-level adaptive render changes.
      */
-    onChange?: (mode: AdaptiveRender) => void;
+    onChange?: (mode: AdaptiveRender, reason: AdaptiveRenderChangeReason) => void;
 }
 type BaseScrollViewProps<TScrollView> = Omit<TScrollView, "contentOffset" | "maintainVisibleContentPosition" | "stickyHeaderIndices" | "removeClippedSubviews" | "children" | "onScroll">;
 interface DataModeProps<ItemT, TItemType extends string | undefined> {
@@ -176,6 +182,11 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Style applied to each column's wrapper view.
      */
     columnWrapperStyle?: ColumnWrapperStyle;
+    /**
+     * Identity token for the dataset represented by `data`.
+     * Change this when replacing the current dataset with a different logical dataset.
+     */
+    dataKey?: Key;
     /**
      * 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.
@@ -344,6 +355,15 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * Called when list layout metrics change.
      */
     onMetricsChange?: (metrics: LegendListMetrics) => void;
+    /**
+     * Called when the first visible item changes. This is emitted from the core range calculation and is cheaper than
+     * viewability tracking when you only need to follow the item at the top of the viewport.
+     */
+    onFirstVisibleItemChanged?: (info: {
+        index: number;
+        item: ItemT;
+        key: string;
+    }) => void;
     /**
      * Configures the adaptive render signal. Items can use this to render a lighter version while scrolling quickly.
      */
@@ -812,4 +832,4 @@ declare function useSyncLayout(): () => void;
 
 declare const LegendList: LegendListComponent;
 
-export { type AdaptiveRender, type AdaptiveRenderConfig, type AlwaysRenderConfig, type AnchoredEndSpaceConfig, 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, useAdaptiveRender, useAdaptiveRenderChange, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useSyncLayout, useViewability, useViewabilityAmount };
+export { type AdaptiveRender, type AdaptiveRenderChangeReason, type AdaptiveRenderConfig, type AlwaysRenderConfig, type AnchoredEndSpaceConfig, 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, useAdaptiveRender, useAdaptiveRenderChange, useIsLastItem, useListScrollSize, useRecyclingEffect, useRecyclingState, useSyncLayout, useViewability, useViewabilityAmount };