@legendapp/list 3.0.3 → 3.0.5

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 3.0.5
+
+- Fix: clearCaches now rechecks the rows that are already on screen, so resetting the size cache does not leave items stuck in old positions.
+- Perf: Scrolling through content that is already rendered now updates viewability with less work.
+- Perf: Trimmed repeated work during scrolls, especially around recycled containers, sticky headers, size checks, and viewability.
+- Perf: Large and fast scrolls now reuse more of the same scroll state instead of recalculating it in multiple places.
+
+## 3.0.4
+
+- Fix: scrollToEnd now waits for newly committed data before targeting the final item, improving chat-style append-and-scroll flows.
+- Fix: Anchored end space waits for measured or fixed tail sizes before reporting readiness, avoiding stale end-space values during append flows.
+- Feat: Add anchoredEndSpace.onReady to notify when the anchored tail has authoritative sizing.
+
 ## 3.0.3
 
 - Fix: MVCP was getting batched to improve big jumps, but was making scroll worse

package/animated.d.ts

@@ -388,12 +388,22 @@ interface MaintainVisibleContentPositionConfig<ItemT = any> {
     size?: boolean;
     shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
+interface AnchoredEndSpaceReadyInfo {
+    anchorIndex: number | undefined;
+    anchorKey: string | undefined;
+    size: number;
+}
+interface ScrollToEndOptions {
+    animated?: boolean;
+    viewOffset?: number;
+}
 interface AnchoredEndSpaceConfig {
     anchorIndex: number;
     anchorOffset?: number;
     anchorMaxSize?: number;
     includeInEndInset?: boolean;
     onSizeChanged?: (size: number) => void;
+    onReady?: (info: AnchoredEndSpaceReadyInfo) => void;
 }
 interface StickyHeaderConfig {
     /**
@@ -525,10 +535,7 @@ type LegendListRef$1 = {
      * @param options.animated - If true, animates the scroll. Default: true.
      * @param options.viewOffset - Offset from the target position.
      */
-    scrollToEnd(options?: {
-        animated?: boolean | undefined;
-        viewOffset?: number | undefined;
-    }): Promise<void>;
+    scrollToEnd(options?: ScrollToEndOptions): Promise<void>;
     /**
      * Scrolls to a specific index in the list.
      * @param params - Parameters for scrolling.

package/keyboard-legacy.d.ts

@@ -63,6 +63,10 @@ interface Insets {
     bottom: number;
     right: number;
 }
+interface ScrollToEndOptions {
+    animated?: boolean;
+    viewOffset?: number;
+}
 interface LegendListAverageItemSize {
     average: number;
     count: number;
@@ -141,10 +145,7 @@ type LegendListRef$1 = {
      * @param options.animated - If true, animates the scroll. Default: true.
      * @param options.viewOffset - Offset from the target position.
      */
-    scrollToEnd(options?: {
-        animated?: boolean | undefined;
-        viewOffset?: number | undefined;
-    }): Promise<void>;
+    scrollToEnd(options?: ScrollToEndOptions): Promise<void>;
     /**
      * Scrolls to a specific index in the list.
      * @param params - Parameters for scrolling.

package/keyboard.d.ts

@@ -64,12 +64,22 @@ interface Insets {
     bottom: number;
     right: number;
 }
+interface AnchoredEndSpaceReadyInfo {
+    anchorIndex: number | undefined;
+    anchorKey: string | undefined;
+    size: number;
+}
+interface ScrollToEndOptions {
+    animated?: boolean;
+    viewOffset?: number;
+}
 interface AnchoredEndSpaceConfig$1 {
     anchorIndex: number;
     anchorOffset?: number;
     anchorMaxSize?: number;
     includeInEndInset?: boolean;
     onSizeChanged?: (size: number) => void;
+    onReady?: (info: AnchoredEndSpaceReadyInfo) => void;
 }
 interface LegendListAverageItemSize {
     average: number;
@@ -149,10 +159,7 @@ type LegendListRef$1 = {
      * @param options.animated - If true, animates the scroll. Default: true.
      * @param options.viewOffset - Offset from the target position.
      */
-    scrollToEnd(options?: {
-        animated?: boolean | undefined;
-        viewOffset?: number | undefined;
-    }): Promise<void>;
+    scrollToEnd(options?: ScrollToEndOptions): Promise<void>;
     /**
      * Scrolls to a specific index in the list.
      * @param params - Parameters for scrolling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/list",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "Legend List is a drop-in replacement for FlatList with much better performance and supporting dynamically sized items.",
   "sideEffects": false,
   "private": false,

package/react-native.d.ts

@@ -394,12 +394,22 @@ interface MaintainVisibleContentPositionConfig<ItemT = any> {
     size?: boolean;
     shouldRestorePosition?: (item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
+interface AnchoredEndSpaceReadyInfo {
+    anchorIndex: number | undefined;
+    anchorKey: string | undefined;
+    size: number;
+}
+interface ScrollToEndOptions {
+    animated?: boolean;
+    viewOffset?: number;
+}
 interface AnchoredEndSpaceConfig {
     anchorIndex: number;
     anchorOffset?: number;
     anchorMaxSize?: number;
     includeInEndInset?: boolean;
     onSizeChanged?: (size: number) => void;
+    onReady?: (info: AnchoredEndSpaceReadyInfo) => void;
 }
 interface StickyHeaderConfig {
     /**
@@ -531,10 +541,7 @@ type LegendListRef$1 = {
      * @param options.animated - If true, animates the scroll. Default: true.
      * @param options.viewOffset - Offset from the target position.
      */
-    scrollToEnd(options?: {
-        animated?: boolean | undefined;
-        viewOffset?: number | undefined;
-    }): Promise<void>;
+    scrollToEnd(options?: ScrollToEndOptions): Promise<void>;
     /**
      * Scrolls to a specific index in the list.
      * @param params - Parameters for scrolling.