@legendapp/list 3.1.1 → 3.2.0

package/react.d.ts

@@ -116,19 +116,24 @@ type ViewStyle = Record<string, unknown>;
 type StyleProp<T> = T | T[] | null | undefined | false;
 type AdaptiveRender = "normal" | "light";
 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;
     /**
@@ -344,6 +349,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.
      */