@legendapp/list 3.3.10 → 3.4.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 3.4.0
+
+- Feat: Add `onReady`, called after each initial placement and scroll cycle completes, including cycles restarted by a `dataKey` change.
+- Fix: End-following and animated programmatic scrolling now stay aligned through footer, viewport, and native layout changes, while user dragging cancels queued follow requests.
+- Fix: `onStartReached` and `onEndReached` callbacks now fire reliably after layout and dataset resets, including short lists and gestures that cross a threshold over multiple events.
+- Fix: Numeric `initialScrollIndex` values that target the last row now include the footer when opening at the end.
+- Perf: Fast scrolling now prepares rows in the direction you are moving, including upward and end-aligned scrolling, so the next content is ready sooner.
+
+## 3.3.11
+
+- Fix: `scrollToEnd` and `maintainScrollAtEnd` keep reaching the end as content changes, while scrolling away or requesting another position cancels automatic following.
+- Fix: Switching datasets cancels old scroll requests so they cannot override the new dataset's initial position.
+- Fix: `anchoredEndSpace` shrinks excess blank space as rows are measured instead of waiting for every remaining row.
+- Fix: Resizing the chat composer preserves the combined keyboard and composer spacing.
+- Fix: Web scroll adjustments no longer leave extra padding at the end of the list.
+- Fix: Web row reordering happens sooner when idle and preserves focus, animations, and embedded content state in browsers that support state-preserving moves.
+
 ## 3.3.10
 
 - Fix: Changing `dataKey` no longer loses the new dataset's initial scroll position when React retries a render.

package/animated.d.ts

@@ -333,6 +333,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    /**
+     * Called after layout and initial scrolling complete, including after a
+     * dataKey reset. Unlike onLoad, this runs for each initial placement cycle.
+     * Ordinary data updates do not trigger it unless they restart initial placement.
+     */
+    onReady?: () => void;
     /**
      * Called when list layout metrics change.
      */

package/keyboard.d.ts

@@ -281,7 +281,7 @@ type KeyboardChatComposerInsetListRef = {
 type KeyboardChatComposerRef = {
     current: Pick<View, "measure"> | null;
 };
-declare function useKeyboardChatComposerInset(listRef: KeyboardChatComposerInsetListRef, composerRef: KeyboardChatComposerRef, initialHeight?: number): {
+declare function useKeyboardChatComposerInset(_listRef: KeyboardChatComposerInsetListRef, composerRef: KeyboardChatComposerRef, initialHeight?: number): {
     contentInsetEndAdjustment: SharedValue<number>;
     onComposerLayout: (event: LayoutChangeEvent) => void;
 };

package/keyboard.js

@@ -33,19 +33,17 @@ if (typeof __DEV__ !== "undefined" && __DEV__ && !reactNativeKeyboardController.
     "[legend-list] KeyboardAwareLegendList requires a recent react-native-keyboard-controller with KeyboardChatScrollView. Please upgrade react-native-keyboard-controller to at least 1.21.7."
   );
 }
-function useKeyboardChatComposerInset(listRef, composerRef, initialHeight = 0) {
+function useKeyboardChatComposerInset(_listRef, composerRef, initialHeight = 0) {
   const contentInsetEndAdjustment = reactNativeReanimated.useSharedValue(initialHeight);
   const lastHeightRef = React.useRef(void 0);
   const reportHeight = React.useCallback(
     (height) => {
-      var _a;
       if (Number.isFinite(height) && height !== lastHeightRef.current) {
         lastHeightRef.current = height;
         contentInsetEndAdjustment.value = height;
-        (_a = listRef.current) == null ? void 0 : _a.reportContentInset({ bottom: height });
       }
     },
-    [contentInsetEndAdjustment, listRef]
+    [contentInsetEndAdjustment]
   );
   React.useLayoutEffect(() => {
     var _a;

package/keyboard.mjs

@@ -12,19 +12,17 @@ if (typeof __DEV__ !== "undefined" && __DEV__ && !KeyboardChatScrollView) {
     "[legend-list] KeyboardAwareLegendList requires a recent react-native-keyboard-controller with KeyboardChatScrollView. Please upgrade react-native-keyboard-controller to at least 1.21.7."
   );
 }
-function useKeyboardChatComposerInset(listRef, composerRef, initialHeight = 0) {
+function useKeyboardChatComposerInset(_listRef, composerRef, initialHeight = 0) {
   const contentInsetEndAdjustment = useSharedValue(initialHeight);
   const lastHeightRef = useRef(void 0);
   const reportHeight = useCallback(
     (height) => {
-      var _a;
       if (Number.isFinite(height) && height !== lastHeightRef.current) {
         lastHeightRef.current = height;
         contentInsetEndAdjustment.value = height;
-        (_a = listRef.current) == null ? void 0 : _a.reportContentInset({ bottom: height });
       }
     },
-    [contentInsetEndAdjustment, listRef]
+    [contentInsetEndAdjustment]
   );
   useLayoutEffect(() => {
     var _a;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/list",
-  "version": "3.3.10",
+  "version": "3.4.0",
   "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

@@ -333,6 +333,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     onLoad?: (info: {
         elapsedTimeInMs: number;
     }) => void;
+    /**
+     * Called after layout and initial scrolling complete, including after a
+     * dataKey reset. Unlike onLoad, this runs for each initial placement cycle.
+     * Ordinary data updates do not trigger it unless they restart initial placement.
+     */
+    onReady?: () => void;
     /**
      * Called when list layout metrics change.
      */