@legendapp/list 3.0.0-beta.12 → 3.0.0-beta.14

package/README.md

@@ -27,7 +27,7 @@ Beyond standard `FlatList` capabilities:
     *   `true`: Reuses item components for optimal performance. Be cautious if your item components contain local state, as it might be reused unexpectedly.
     *   `false` (default): Creates new item components every time. Less performant but safer if items have complex internal state.
 *   `maintainScrollAtEnd`: (boolean) If `true` and the user is scrolled near the bottom (within `maintainScrollAtEndThreshold * screen height`), the list automatically scrolls to the end when items are added or heights change. Useful for chat interfaces.
-*   `maintainVisibleContentPosition`: Keeps visible content steady during size/layout changes while scrolling (default). Pass `true` or `{ dataChanges: true }` to also anchor during data updates; pass `false` to disable; pass `{ scroll: false }` to opt out of scroll-time stabilization.
+*   `maintainVisibleContentPosition`: Keeps visible content steady during size/layout changes while scrolling up or when items resize above the viewport (default). Pass `true` or `{ data: true }` to also anchor during data updates; pass `false` to disable; pass `{ size: false }` to opt out of scroll-time stabilization.
 *   `alignItemsAtEnd`: (boolean) Useful for chat UIs, content smaller than the View will be aligned to the bottom of the list.
 
 ---

package/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Dispatch, SetStateAction } from 'react';
-import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-C83aU7VI.mjs';
-export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-C83aU7VI.mjs';
+import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-CdqSrGnu.mjs';
+export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-CdqSrGnu.mjs';
 import 'react-native';
 import 'react-native-reanimated';
 

package/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Dispatch, SetStateAction } from 'react';
-import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-C83aU7VI.js';
-export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-C83aU7VI.js';
+import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-CdqSrGnu.js';
+export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-CdqSrGnu.js';
 import 'react-native';
 import 'react-native-reanimated';
 

package/index.js

@@ -1230,7 +1230,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1775,7 +1775,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1783,7 +1783,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1806,7 +1806,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -3515,18 +3515,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = React3.useRef(null);
@@ -3813,7 +3813,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/index.mjs

@@ -1209,7 +1209,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1754,7 +1754,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1762,7 +1762,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1785,7 +1785,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -3494,18 +3494,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = useRef(null);
@@ -3792,7 +3792,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/index.native.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Dispatch, SetStateAction } from 'react';
-import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-C83aU7VI.mjs';
-export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-C83aU7VI.mjs';
+import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-CdqSrGnu.mjs';
+export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-CdqSrGnu.mjs';
 import 'react-native';
 import 'react-native-reanimated';
 

package/index.native.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Dispatch, SetStateAction } from 'react';
-import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-C83aU7VI.js';
-export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-C83aU7VI.js';
+import { L as LegendListProps, a as LegendListRef, V as ViewabilityCallback, b as ViewabilityAmountCallback, c as LegendListRecyclingState } from './types-CdqSrGnu.js';
+export { C as ColumnWrapperStyle, w as GetRenderedItem, G as GetRenderedItemResult, v as InitialScrollAnchor, I as InternalState, d as LegendListPropsBase, h as LegendListRenderItemProps, i as LegendListState, f as MaintainScrollAtEndOptions, M as MaintainVisibleContentPositionConfig, e as MaintainVisibleContentPositionNormalized, O as OnViewableItemsChanged, r as ScrollIndexWithOffset, u as ScrollIndexWithOffsetAndContentOffset, s as ScrollIndexWithOffsetPosition, S as ScrollTarget, T as ThresholdSnapshot, o as TypedForwardRef, p as TypedMemo, k as ViewAmountToken, j as ViewToken, n as ViewabilityConfig, l as ViewabilityConfigCallbackPair, m as ViewabilityConfigCallbackPairs, g as ViewableRange, t as typedForwardRef, q as typedMemo } from './types-CdqSrGnu.js';
 import 'react-native';
 import 'react-native-reanimated';
 

package/index.native.js

@@ -938,7 +938,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1565,7 +1565,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1573,7 +1573,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1599,7 +1599,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -1636,7 +1636,7 @@ function prepareMVCP(ctx, dataChanged) {
         }
       }
       if (Math.abs(positionDiff) > 0.1) {
-        requestAdjust(ctx, positionDiff, dataChanged && mvcpDataChanges);
+        requestAdjust(ctx, positionDiff, dataChanged && mvcpData);
       }
     };
   }
@@ -3301,18 +3301,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = React2.useRef(null);
@@ -3599,7 +3599,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/index.native.mjs

@@ -917,7 +917,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1544,7 +1544,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1552,7 +1552,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1578,7 +1578,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -1615,7 +1615,7 @@ function prepareMVCP(ctx, dataChanged) {
         }
       }
       if (Math.abs(positionDiff) > 0.1) {
-        requestAdjust(ctx, positionDiff, dataChanged && mvcpDataChanges);
+        requestAdjust(ctx, positionDiff, dataChanged && mvcpData);
       }
     };
   }
@@ -3280,18 +3280,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = useRef(null);
@@ -3578,7 +3578,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/package.json

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

package/section-list.d.mts

@@ -1,7 +1,7 @@
 import * as react_native from 'react-native';
 import { SectionListData, SectionBase, SectionListRenderItemInfo, SectionListScrollParams } from 'react-native';
 import * as React from 'react';
-import { a as LegendListRef, L as LegendListProps } from './types-C83aU7VI.mjs';
+import { a as LegendListRef, L as LegendListProps } from './types-CdqSrGnu.mjs';
 import 'react-native-reanimated';
 
 type SectionListSeparatorProps<ItemT, SectionT> = {

package/section-list.d.ts

@@ -1,7 +1,7 @@
 import * as react_native from 'react-native';
 import { SectionListData, SectionBase, SectionListRenderItemInfo, SectionListScrollParams } from 'react-native';
 import * as React from 'react';
-import { a as LegendListRef, L as LegendListProps } from './types-C83aU7VI.js';
+import { a as LegendListRef, L as LegendListProps } from './types-CdqSrGnu.js';
 import 'react-native-reanimated';
 
 type SectionListSeparatorProps<ItemT, SectionT> = {

package/section-list.js

@@ -1097,7 +1097,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1642,7 +1642,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1650,7 +1650,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1673,7 +1673,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -3382,18 +3382,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = React3.useRef(null);
@@ -3680,7 +3680,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/section-list.mjs

@@ -1076,7 +1076,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1621,7 +1621,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1629,7 +1629,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1652,7 +1652,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -3361,18 +3361,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = useRef(null);
@@ -3659,7 +3659,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/section-list.native.d.mts

@@ -1,7 +1,7 @@
 import * as react_native from 'react-native';
 import { SectionListData, SectionBase, SectionListRenderItemInfo, SectionListScrollParams } from 'react-native';
 import * as React from 'react';
-import { a as LegendListRef, L as LegendListProps } from './types-C83aU7VI.mjs';
+import { a as LegendListRef, L as LegendListProps } from './types-CdqSrGnu.mjs';
 import 'react-native-reanimated';
 
 type SectionListSeparatorProps<ItemT, SectionT> = {

package/section-list.native.d.ts

@@ -1,7 +1,7 @@
 import * as react_native from 'react-native';
 import { SectionListData, SectionBase, SectionListRenderItemInfo, SectionListScrollParams } from 'react-native';
 import * as React from 'react';
-import { a as LegendListRef, L as LegendListProps } from './types-C83aU7VI.js';
+import { a as LegendListRef, L as LegendListProps } from './types-CdqSrGnu.js';
 import 'react-native-reanimated';
 
 type SectionListSeparatorProps<ItemT, SectionT> = {

package/section-list.native.js

@@ -807,7 +807,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1434,7 +1434,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1442,7 +1442,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1468,7 +1468,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -1505,7 +1505,7 @@ function prepareMVCP(ctx, dataChanged) {
         }
       }
       if (Math.abs(positionDiff) > 0.1) {
-        requestAdjust(ctx, positionDiff, dataChanged && mvcpDataChanges);
+        requestAdjust(ctx, positionDiff, dataChanged && mvcpData);
       }
     };
   }
@@ -3170,18 +3170,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = React2.useRef(null);
@@ -3468,7 +3468,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/section-list.native.mjs

@@ -786,7 +786,7 @@ var ListComponent = typedMemo(function ListComponent2({
       ],
       contentOffset: initialContentOffset ? horizontal ? { x: initialContentOffset, y: 0 } : { x: 0, y: initialContentOffset } : void 0,
       horizontal,
-      maintainVisibleContentPosition: maintainVisibleContentPosition.scroll || maintainVisibleContentPosition.dataChanges ? { minIndexForVisible: 0 } : void 0,
+      maintainVisibleContentPosition: maintainVisibleContentPosition.size || maintainVisibleContentPosition.data ? { minIndexForVisible: 0 } : void 0,
       onLayout,
       onScroll: onScroll2,
       ref: refScrollView,
@@ -1413,7 +1413,7 @@ function prepareMVCP(ctx, dataChanged) {
   const state = ctx.state;
   const { idsInView, positions, props } = state;
   const {
-    maintainVisibleContentPosition: { dataChanges: mvcpDataChanges, scroll: mvcpScroll }
+    maintainVisibleContentPosition: { data: mvcpData, size: mvcpScroll }
   } = props;
   const scrollingTo = state.scrollingTo;
   let prevPosition;
@@ -1421,7 +1421,7 @@ function prepareMVCP(ctx, dataChanged) {
   const idsInViewWithPositions = [];
   const scrollTarget = scrollingTo == null ? void 0 : scrollingTo.index;
   const scrollingToViewPosition = scrollingTo == null ? void 0 : scrollingTo.viewPosition;
-  const shouldMVCP = dataChanged ? mvcpDataChanges : mvcpScroll;
+  const shouldMVCP = dataChanged ? mvcpData : mvcpScroll;
   const indexByKey = state.indexByKey;
   if (shouldMVCP) {
     if (scrollTarget !== void 0) {
@@ -1447,7 +1447,7 @@ function prepareMVCP(ctx, dataChanged) {
     }
     return () => {
       let positionDiff = 0;
-      if (dataChanged && targetId === void 0 && mvcpDataChanges) {
+      if (dataChanged && targetId === void 0 && mvcpData) {
         for (let i = 0; i < idsInViewWithPositions.length; i++) {
           const { id, position } = idsInViewWithPositions[i];
           const newPosition = positions.get(id);
@@ -1484,7 +1484,7 @@ function prepareMVCP(ctx, dataChanged) {
         }
       }
       if (Math.abs(positionDiff) > 0.1) {
-        requestAdjust(ctx, positionDiff, dataChanged && mvcpDataChanges);
+        requestAdjust(ctx, positionDiff, dataChanged && mvcpData);
       }
     };
   }
@@ -3149,18 +3149,18 @@ function getRenderedItem(ctx, key) {
 function normalizeMaintainVisibleContentPosition(value) {
   var _a3, _b;
   if (value === true) {
-    return { dataChanges: true, scroll: true };
+    return { data: true, size: true };
   }
   if (value && typeof value === "object") {
     return {
-      dataChanges: (_a3 = value.dataChanges) != null ? _a3 : false,
-      scroll: (_b = value.scroll) != null ? _b : true
+      data: (_a3 = value.data) != null ? _a3 : false,
+      size: (_b = value.size) != null ? _b : true
     };
   }
   if (value === false) {
-    return { dataChanges: false, scroll: false };
+    return { data: false, size: false };
   }
-  return { dataChanges: false, scroll: true };
+  return { data: false, size: true };
 }
 function useThrottleDebounce(mode) {
   const timeoutRef = useRef(null);
@@ -3447,7 +3447,7 @@ var LegendListInner = typedForwardRef(function LegendListInner2(props, forwarded
     setPaddingTop(ctx, { stylePaddingTop: stylePaddingTopState });
     refState.current.props.stylePaddingBottom = stylePaddingBottomState;
     let paddingDiff = stylePaddingTopState - prevPaddingTop;
-    if (maintainVisibleContentPositionConfig.scroll && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
+    if (maintainVisibleContentPositionConfig.size && paddingDiff && prevPaddingTop !== void 0 && Platform2.OS === "ios") {
       if (state.scroll < 0) {
         paddingDiff += state.scroll;
       }

package/{types-C83aU7VI.d.mts → types-CdqSrGnu.d.mts}

@@ -223,7 +223,7 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     /**
      * Maintains visibility of content.
      * - scroll (default: true) stabilizes during size/layout changes while scrolling.
-     * - dataChanges (default: false) stabilizes when the data array changes; passing true also sets the RN maintainVisibleContentPosition prop.
+     * - data (default: false) stabilizes when the data array changes; passing true also sets the RN maintainVisibleContentPosition prop.
      * - undefined (default) enables scroll stabilization but skips data-change anchoring.
      * - true enables both behaviors; false disables both.
      */
@@ -346,12 +346,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
 }
 type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView> | ComponentProps<typeof Reanimated.ScrollView>, TItemType extends string | undefined = string | undefined> = BaseScrollViewProps<TScrollView> & LegendListSpecificProps<ItemT, TItemType> & (DataModeProps<ItemT, TItemType> | ChildrenModeProps);
 interface MaintainVisibleContentPositionConfig {
-    dataChanges?: boolean;
-    scroll?: boolean;
+    data?: boolean;
+    size?: boolean;
 }
 interface MaintainVisibleContentPositionNormalized {
-    dataChanges: boolean;
-    scroll: boolean;
+    data: boolean;
+    size: boolean;
 }
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;

package/{types-C83aU7VI.d.ts → types-CdqSrGnu.d.ts}

@@ -223,7 +223,7 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
     /**
      * Maintains visibility of content.
      * - scroll (default: true) stabilizes during size/layout changes while scrolling.
-     * - dataChanges (default: false) stabilizes when the data array changes; passing true also sets the RN maintainVisibleContentPosition prop.
+     * - data (default: false) stabilizes when the data array changes; passing true also sets the RN maintainVisibleContentPosition prop.
      * - undefined (default) enables scroll stabilization but skips data-change anchoring.
      * - true enables both behaviors; false disables both.
      */
@@ -346,12 +346,12 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
 }
 type LegendListPropsBase<ItemT, TScrollView extends ComponentProps<typeof ScrollView> | ComponentProps<typeof Animated.ScrollView> | ComponentProps<typeof Reanimated.ScrollView>, TItemType extends string | undefined = string | undefined> = BaseScrollViewProps<TScrollView> & LegendListSpecificProps<ItemT, TItemType> & (DataModeProps<ItemT, TItemType> | ChildrenModeProps);
 interface MaintainVisibleContentPositionConfig {
-    dataChanges?: boolean;
-    scroll?: boolean;
+    data?: boolean;
+    size?: boolean;
 }
 interface MaintainVisibleContentPositionNormalized {
-    dataChanges: boolean;
-    scroll: boolean;
+    data: boolean;
+    size: boolean;
 }
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;