@legendapp/list 3.0.0-beta.13 → 3.0.0-beta.15

package/{types-BSoW8ni4.d.mts → types-Dj2MEm9V.d.mts}

@@ -76,7 +76,7 @@ declare class ScrollAdjustHandler {
     constructor(ctx: StateContext);
     requestAdjust(add: number): void;
     getAdjust(): number;
-    commitPendingAdjust(): void;
+    commitPendingAdjust(scrollTarget: ScrollTarget): void;
 }
 
 type BaseSharedValue<T = number> = {
@@ -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.
-     * - dataChanged (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.
      */
@@ -340,18 +340,36 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * @deprecated Use stickyHeaderIndices instead for parity with React Native.
      */
     stickyIndices?: number[];
+    /**
+     * Configuration for sticky headers.
+     * @default undefined
+     */
+    stickyHeaderConfig?: StickyHeaderConfig;
     getItemType?: (item: ItemT, index: number) => TItemType;
     getFixedItemSize?: (index: number, item: ItemT, type: TItemType) => number | undefined;
     itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
 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 {
-    dataChanged?: boolean;
-    scroll?: boolean;
+    data?: boolean;
+    size?: boolean;
 }
 interface MaintainVisibleContentPositionNormalized {
-    dataChanged: boolean;
-    scroll: boolean;
+    data: boolean;
+    size: boolean;
+}
+interface StickyHeaderConfig {
+    /**
+     * Specifies how far from the top edge sticky headers should start sticking.
+     * Useful for scenarios with a fixed navbar or header, where sticky elements pin below it..
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * Component to render as a backdrop behind the sticky header.
+     * @default undefined
+     */
+    backdropComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
 }
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -731,4 +749,4 @@ type GetRenderedItemResult<ItemT> = {
 };
 type GetRenderedItem = (key: string) => GetRenderedItemResult<any> | null;
 
-export { type ColumnWrapperStyle as C, type GetRenderedItemResult as G, type InternalState as I, type LegendListProps as L, type MaintainVisibleContentPositionConfig as M, type OnViewableItemsChanged as O, type ScrollTarget as S, type ThresholdSnapshot as T, type ViewabilityCallback as V, type LegendListRef as a, type ViewabilityAmountCallback as b, type LegendListRecyclingState as c, type LegendListPropsBase as d, type MaintainVisibleContentPositionNormalized as e, type MaintainScrollAtEndOptions as f, type ViewableRange as g, type LegendListRenderItemProps as h, type LegendListState as i, type ViewToken as j, type ViewAmountToken as k, type ViewabilityConfigCallbackPair as l, type ViewabilityConfigCallbackPairs as m, type ViewabilityConfig as n, type TypedForwardRef as o, type TypedMemo as p, typedMemo as q, type ScrollIndexWithOffset as r, type ScrollIndexWithOffsetPosition as s, typedForwardRef as t, type ScrollIndexWithOffsetAndContentOffset as u, type InitialScrollAnchor as v, type GetRenderedItem as w };
+export { type ColumnWrapperStyle as C, type GetRenderedItemResult as G, type InternalState as I, type LegendListProps as L, type MaintainVisibleContentPositionConfig as M, type OnViewableItemsChanged as O, type StickyHeaderConfig as S, type ThresholdSnapshot as T, type ViewabilityCallback as V, type LegendListRef as a, type ViewabilityAmountCallback as b, type LegendListRecyclingState as c, type LegendListPropsBase as d, type MaintainVisibleContentPositionNormalized as e, type MaintainScrollAtEndOptions as f, type ScrollTarget as g, type ViewableRange as h, type LegendListRenderItemProps as i, type LegendListState as j, type ViewToken as k, type ViewAmountToken as l, type ViewabilityConfigCallbackPair as m, type ViewabilityConfigCallbackPairs as n, type ViewabilityConfig as o, type TypedForwardRef as p, type TypedMemo as q, typedMemo as r, type ScrollIndexWithOffset as s, typedForwardRef as t, type ScrollIndexWithOffsetPosition as u, type ScrollIndexWithOffsetAndContentOffset as v, type InitialScrollAnchor as w, type GetRenderedItem as x };

package/{types-BSoW8ni4.d.ts → types-Dj2MEm9V.d.ts}

@@ -76,7 +76,7 @@ declare class ScrollAdjustHandler {
     constructor(ctx: StateContext);
     requestAdjust(add: number): void;
     getAdjust(): number;
-    commitPendingAdjust(): void;
+    commitPendingAdjust(scrollTarget: ScrollTarget): void;
 }
 
 type BaseSharedValue<T = number> = {
@@ -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.
-     * - dataChanged (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.
      */
@@ -340,18 +340,36 @@ interface LegendListSpecificProps<ItemT, TItemType extends string | undefined> {
      * @deprecated Use stickyHeaderIndices instead for parity with React Native.
      */
     stickyIndices?: number[];
+    /**
+     * Configuration for sticky headers.
+     * @default undefined
+     */
+    stickyHeaderConfig?: StickyHeaderConfig;
     getItemType?: (item: ItemT, index: number) => TItemType;
     getFixedItemSize?: (index: number, item: ItemT, type: TItemType) => number | undefined;
     itemsAreEqual?: (itemPrevious: ItemT, item: ItemT, index: number, data: readonly ItemT[]) => boolean;
 }
 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 {
-    dataChanged?: boolean;
-    scroll?: boolean;
+    data?: boolean;
+    size?: boolean;
 }
 interface MaintainVisibleContentPositionNormalized {
-    dataChanged: boolean;
-    scroll: boolean;
+    data: boolean;
+    size: boolean;
+}
+interface StickyHeaderConfig {
+    /**
+     * Specifies how far from the top edge sticky headers should start sticking.
+     * Useful for scenarios with a fixed navbar or header, where sticky elements pin below it..
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * Component to render as a backdrop behind the sticky header.
+     * @default undefined
+     */
+    backdropComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
 }
 interface MaintainScrollAtEndOptions {
     onLayout?: boolean;
@@ -731,4 +749,4 @@ type GetRenderedItemResult<ItemT> = {
 };
 type GetRenderedItem = (key: string) => GetRenderedItemResult<any> | null;
 
-export { type ColumnWrapperStyle as C, type GetRenderedItemResult as G, type InternalState as I, type LegendListProps as L, type MaintainVisibleContentPositionConfig as M, type OnViewableItemsChanged as O, type ScrollTarget as S, type ThresholdSnapshot as T, type ViewabilityCallback as V, type LegendListRef as a, type ViewabilityAmountCallback as b, type LegendListRecyclingState as c, type LegendListPropsBase as d, type MaintainVisibleContentPositionNormalized as e, type MaintainScrollAtEndOptions as f, type ViewableRange as g, type LegendListRenderItemProps as h, type LegendListState as i, type ViewToken as j, type ViewAmountToken as k, type ViewabilityConfigCallbackPair as l, type ViewabilityConfigCallbackPairs as m, type ViewabilityConfig as n, type TypedForwardRef as o, type TypedMemo as p, typedMemo as q, type ScrollIndexWithOffset as r, type ScrollIndexWithOffsetPosition as s, typedForwardRef as t, type ScrollIndexWithOffsetAndContentOffset as u, type InitialScrollAnchor as v, type GetRenderedItem as w };
+export { type ColumnWrapperStyle as C, type GetRenderedItemResult as G, type InternalState as I, type LegendListProps as L, type MaintainVisibleContentPositionConfig as M, type OnViewableItemsChanged as O, type StickyHeaderConfig as S, type ThresholdSnapshot as T, type ViewabilityCallback as V, type LegendListRef as a, type ViewabilityAmountCallback as b, type LegendListRecyclingState as c, type LegendListPropsBase as d, type MaintainVisibleContentPositionNormalized as e, type MaintainScrollAtEndOptions as f, type ScrollTarget as g, type ViewableRange as h, type LegendListRenderItemProps as i, type LegendListState as j, type ViewToken as k, type ViewAmountToken as l, type ViewabilityConfigCallbackPair as m, type ViewabilityConfigCallbackPairs as n, type ViewabilityConfig as o, type TypedForwardRef as p, type TypedMemo as q, typedMemo as r, type ScrollIndexWithOffset as s, typedForwardRef as t, type ScrollIndexWithOffsetPosition as u, type ScrollIndexWithOffsetAndContentOffset as v, type InitialScrollAnchor as w, type GetRenderedItem as x };