@react-native-ohos/flash-list 1.8.3 → 2.1.1-rc.1

package/dist/FlashListProps.d.ts

@@ -1,279 +1,286 @@
-/**
- * MIT License
- *
- * Copyright (C) 2024 Huawei Device Co., Ltd.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-import type React from "react";
-import { StyleProp, ScrollViewProps, ViewabilityConfig, ViewabilityConfigCallbackPairs, ViewStyle } from "react-native";
-import { BlankAreaEventHandler } from "./native/auto-layout/AutoLayoutView";
-import ViewToken from "./viewability/ViewToken";
-export interface ListRenderItemInfo<TItem> {
-    item: TItem;
-    index: number;
-    /**
-     * FlashList may render your items for multiple reasons.
-     * Cell - This is for your list item
-     * Measurement - Might be invoked for size measurement and won't be visible. You can ignore this in analytics.
-     * StickyHeader - This is for your sticky header. Use this to change your item's appearance while it's being used as a sticky header.
-     */
-    target: RenderTarget;
-    extraData?: any;
-}
-export type RenderTarget = "Cell" | "StickyHeader" | "Measurement";
-export declare const RenderTargetOptions: Record<string, RenderTarget>;
-export type ListRenderItem<TItem> = (info: ListRenderItemInfo<TItem>) => React.ReactElement | null;
-export type ContentStyle = Pick<ViewStyle, "backgroundColor" | "paddingTop" | "paddingLeft" | "paddingRight" | "paddingBottom" | "padding" | "paddingVertical" | "paddingHorizontal">;
-export interface FlashListProps<TItem> extends ScrollViewProps {
-    /**
-     * Takes an item from `data` and renders it into the list. Typical usage:
-     * ```ts
-     * renderItem = ({item}) => (
-     *   <Text>{item.title}</Text>
-     * );
-     * ...
-     * <FlashList data={[{title: 'Title Text', key: 'item1'}]} renderItem={renderItem} />
-     * ```
-     *
-     * Provides additional metadata like `index`
-     *
-     * - `item` (`Object`): The item from `data` being rendered.
-     * - `index` (`number`): The index corresponding to this item in the `data` array.
-     */
-    renderItem: ListRenderItem<TItem> | null | undefined;
-    /**
-     * For simplicity, data is a plain array of items of a given type.
-     */
-    data: ReadonlyArray<TItem> | null | undefined;
-    /**
-     * Average or median size for elements in the list. Doesn't have to be very accurate but a good estimate can improve performance.
-     * A quick look at `Element Inspector` can help you determine this. If you're confused between two values, the smaller value is a better choice.
-     * For vertical lists provide average height and for horizontal average width.
-     * Read more about it here: https://shopify.github.io/flash-list/docs/estimated-item-size
-     */
-    estimatedItemSize?: number;
-    /**
-     * Each cell is rendered using this element.
-     * Can be a React Component Class, or a render function.
-     * The root component should always be a `CellContainer` which is also the default component used.
-     * Ensure that the original `props` are passed to the returned `CellContainer`. The `props` will include the following:
-     * - `onLayout`: Method for updating data about the real `CellContainer` layout
-     * - `index`: Index of the cell in the list, you can use this to query data if needed
-     * - `style`: Style of `CellContainer`, including:
-     *   - `flexDirection`: Depends on whether your list is horizontal or vertical
-     *   - `position`: Value of this will be `absolute` as that's how `FlashList` positions elements
-     *   - `left`: Determines position of the element on x axis
-     *   - `top`: Determines position of the element on y axis
-     *   - `width`: Determines width of the element (present when list is vertical)
-     *   - `height`: Determines height of the element (present when list is horizontal)
-     *
-     * Note: Changing layout of the cell can conflict with the native layout operations. You may need to set `disableAutoLayout` to `true` to prevent this.
-     */
-    CellRendererComponent?: React.ComponentType<any> | undefined;
-    /**
-     * Rendered in between each item, but not at the top or bottom. By default, `leadingItem` and `trailingItem` (if available) props are provided.
-     */
-    ItemSeparatorComponent?: React.ComponentType<any> | null | undefined;
-    /**
-     * Rendered when the list is empty. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
-     */
-    ListEmptyComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
-    /**
-     * Rendered at the bottom of all the items. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
-     */
-    ListFooterComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
-    /**
-     * Styling for internal View for `ListFooterComponent`.
-     */
-    ListFooterComponentStyle?: StyleProp<ViewStyle> | undefined;
-    /**
-     * Rendered at the top of all the items. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
-     */
-    ListHeaderComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
-    /**
-     * Styling for internal View for `ListHeaderComponent`.
-     */
-    ListHeaderComponentStyle?: StyleProp<ViewStyle> | undefined;
-    /**
-     * Rendered as the main scrollview.
-     */
-    renderScrollComponent?: React.ComponentType<ScrollViewProps> | React.FC<ScrollViewProps>;
-    /**
-     * You can use `contentContainerStyle` to apply padding that will be applied to the whole content itself.
-     * For example, you can apply this padding, so that all of your items have leading and trailing space.
-     */
-    contentContainerStyle?: ContentStyle;
-    /**
-     * Draw distance for advanced rendering (in dp/px)
-     */
-    drawDistance?: number;
-    /**
-     * Specifies how far the first item is drawn from start of the list window or, offset of the first item of the list (not the header).
-     * Needed if you're using initialScrollIndex prop. Before the initial draw the list cannot figure out the size of header or, any special margin/padding that might have been applied
-     * using header styles etc.
-     * If this isn't provided initialScrollIndex might not scroll to the provided index.
-     */
-    estimatedFirstItemOffset?: number;
-    /**
-     * Visible height and width of the list. This is not the scroll content size.
-     */
-    estimatedListSize?: {
-        height: number;
-        width: number;
-    };
-    /**
-     * A marker property for telling the list to re-render (since it implements PureComponent).
-     * If any of your `renderItem`, Header, Footer, etc. functions depend on anything outside of the `data` prop,
-     * stick it here and treat it immutably.
-     */
-    extraData?: any;
-    /**
-     * If true, renders items next to each other horizontally instead of stacked vertically.
-     */
-    horizontal?: boolean | null | undefined;
-    /**
-     * Instead of starting at the top with the first item, start at initialScrollIndex.
-     */
-    initialScrollIndex?: number | null | undefined;
-    /**
-     * Reverses the direction of scroll. Uses scale transforms of -1.
-     */
-    inverted?: boolean | null | undefined;
-    /**
-     * Used to extract a unique key for a given item at the specified index.
-     * Key is used for optimizing performance. Defining `keyExtractor` is also necessary
-     * when doing [layout animations](https://shopify.github.io/flash-list/docs/guides/layout-animation)
-     * to uniquely identify animated components.
-     */
-    keyExtractor?: ((item: TItem, index: number) => string) | undefined;
-    /**
-     * Multiple columns can only be rendered with `horizontal={false}` and will zig-zag like a `flexWrap` layout.
-     * Items should all be the same height - masonry layouts are not supported.
-     */
-    numColumns?: number | undefined;
-    /**
-     * Computes blank space that is visible to the user during scroll or list load. If list doesn't have enough items to fill the screen even then this will be raised.
-     * Values reported: {
-     *    offsetStart -> visible blank space on top of the screen (while going up). If value is greater than 0 then it's visible to user.
-     *    offsetEnd -> visible blank space at the end of the screen (while going down). If value is greater than 0 then it's visible to user.
-     *    blankArea -> max(offsetStart, offsetEnd) use this directly and look for values > 0
-     * }
-     * Please note that this event isn't synced with onScroll event but works with native onDraw/layoutSubviews. Events with values > 0 are blanks.
-     * This event is raised even when there is no visible blank with negative values for extensibility however, for most use cases check blankArea > 0 and use the value.
-     */
-    onBlankArea?: BlankAreaEventHandler;
-    /**
-     * Called once when the scroll position gets within onEndReachedThreshold of the rendered content.
-     */
-    onEndReached?: (() => void) | null | undefined;
-    /**
-     * How far from the end (in units of visible length of the list) the bottom edge of the
-     * list must be from the end of the content to trigger the `onEndReached` callback.
-     * Thus a value of 0.5 will trigger `onEndReached` when the end of the content is
-     * within half the visible length of the list.
-     */
-    onEndReachedThreshold?: number | null | undefined;
-    /**
-     * This event is raised once the list has drawn items on the screen. It also reports @param elapsedTimeInMs which is the time it took to draw the items.
-     * This is required because FlashList doesn't render items in the first cycle. Items are drawn after it measures itself at the end of first render.
-     * If you're using ListEmptyComponent, this event is raised as soon as ListEmptyComponent is rendered.
-     */
-    onLoad?: (info: {
-        elapsedTimeInMs: number;
-    }) => void;
-    /**
-     * Called when the viewability of rows changes, as defined by the `viewabilityConfig` prop.
-     * Array of `changed` includes `ViewToken`s that both visible and non-visible items. You can use the `isViewable` flag to filter the items.
-     *
-     * If you are tracking the time a view becomes (non-)visible, use the `timestamp` property.
-     * We make no guarantees that in the future viewability callbacks will be invoked as soon as they happen - for example,
-     * they might be deferred until JS thread is less busy.
-     */
-    onViewableItemsChanged?: ((info: {
-        viewableItems: ViewToken[];
-        changed: ViewToken[];
-    }) => void) | null | undefined;
-    /**
-     * If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality.
-     * Make sure to also set the refreshing prop correctly.
-     */
-    onRefresh?: (() => void) | null | undefined;
-    /**
-     * Allows developers to override type of items. This will improve recycling if you have different types of items in the list
-     * Right type will be used for the right item. Default type is 0
-     * If you don't want to change for an indexes just return undefined.
-     * Performance: This method is called very frequently. Keep it fast.
-     */
-    getItemType?: (item: TItem, index: number, extraData?: any) => string | number | undefined;
-    /**
-     * This method can be used to provide explicit size estimates or change column span of an item.
-     *
-     * Providing specific estimates is a good idea when you can calculate sizes reliably. FlashList will prefer this value over `estimatedItemSize` for that specific item.
-     * Precise estimates will also improve precision of `scrollToIndex` method and `initialScrollIndex` prop. If you have a `separator` below your items you can include its size in the estimate.
-     *
-     * Changing item span is useful when you have grid layouts (numColumns > 1) and you want few items to be bigger than the rest.
-     *
-     * Modify the given layout. Do not return. FlashList will fallback to default values if this is ignored.
-     *
-     * Performance: This method is called very frequently. Keep it fast.
-     */
-    overrideItemLayout?: (layout: {
-        span?: number;
-        size?: number;
-    }, item: TItem, index: number, maxColumns: number, extraData?: any) => void;
-    /**
-     * For debugging and exception use cases, internal props will be overriden with these values if used
-     */
-    overrideProps?: object;
-    /**
-     * Set this when offset is needed for the loading indicator to show correctly.
-     * @platform android
-     */
-    progressViewOffset?: number | undefined;
-    /**
-     * Set this true while waiting for new data from a refresh.
-     */
-    refreshing?: boolean | null | undefined;
-    /**
-     * `viewabilityConfig` is a default configuration for determining whether items are viewable.
-     *
-     * Changing viewabilityConfig on the fly is not supported.
-     */
-    viewabilityConfig?: ViewabilityConfig | null | undefined;
-    /**
-     * List of `ViewabilityConfig`/`onViewableItemsChanged` pairs.
-     * A specific `onViewableItemsChanged` will be called when its corresponding `ViewabilityConfig`'s conditions are met.
-     */
-    viewabilityConfigCallbackPairs?: ViewabilityConfigCallbackPairs | undefined;
-    /**
-     * FlashList attempts to measure size of horizontal lists by drawing an extra list item in advance. This can sometimes cause issues when used with `initialScrollIndex` in lists
-     * with very little content. You might see some amount of over scroll. When set to true the list's rendered size needs to be deterministic (i.e., height and width greater than 0)
-     * as FlashList will skip rendering the extra item for measurement. Default value is `false`.
-     */
-    disableHorizontalListHeightMeasurement?: boolean;
-    /**
-     * FlashList applies some fixes to layouts of its children which can conflict with custom `CellRendererComponent`
-     * implementations. You can disable this behavior by setting this to `true`.
-     * Recommendation: Set this to `true` while you apply special behavior to the `CellRendererComponent`. Once done set this to
-     * `false` again.
-     */
-    disableAutoLayout?: boolean;
-}
+import type React from "react";
+import { StyleProp, ScrollViewProps, ViewabilityConfig, ViewStyle } from "react-native";
+import ViewToken from "./recyclerview/viewability/ViewToken";
+export interface ListRenderItemInfo<TItem> {
+    item: TItem;
+    index: number;
+    /**
+     * FlashList may render your items for multiple reasons.
+     * Cell - This is for your list item
+     * Measurement - Might be invoked for size measurement and won't be visible. You can ignore this in analytics.
+     * StickyHeader - This is for your sticky header. Use this to change your item's appearance while it's being used as a sticky header.
+     */
+    target: RenderTarget;
+    extraData?: any;
+}
+export interface OverrideProps {
+    initialDrawBatchSize?: number;
+    [key: string]: any;
+}
+export type RenderTarget = "Cell" | "StickyHeader" | "Measurement";
+export declare const RenderTargetOptions: Record<string, RenderTarget>;
+export type ListRenderItem<TItem> = (info: ListRenderItemInfo<TItem>) => React.ReactElement | null;
+export interface ViewabilityConfigCallbackPair<TItem> {
+    viewabilityConfig: ViewabilityConfig;
+    onViewableItemsChanged: ((info: {
+        viewableItems: ViewToken<TItem>[];
+        changed: ViewToken<TItem>[];
+    }) => void) | null;
+}
+export type ViewabilityConfigCallbackPairs<TItem> = ViewabilityConfigCallbackPair<TItem>[];
+export interface FlashListProps<TItem> extends Omit<ScrollViewProps, "maintainVisibleContentPosition"> {
+    /**
+     * Takes an item from `data` and renders it into the list. Typical usage:
+     * ```ts
+     * renderItem = ({item}) => (
+     *   <Text>{item.title}</Text>
+     * );
+     * ...
+     * <FlashList data={[{title: 'Title Text', key: 'item1'}]} renderItem={renderItem} />
+     * ```
+     *
+     * Provides additional metadata like `index`
+     *
+     * - `item` (`Object`): The item from `data` being rendered.
+     * - `index` (`number`): The index corresponding to this item in the `data` array.
+     */
+    renderItem: ListRenderItem<TItem> | null | undefined;
+    /**
+     * For simplicity, data is a plain array of items of a given type.
+     */
+    data: ReadonlyArray<TItem> | null | undefined;
+    /**
+     * Each cell is rendered using this element.
+     * Can be a React Component Class, or a render function.
+     * The root component should always be a `CellContainer` which is also the default component used.
+     * Ensure that the original `props` are passed to the returned `CellContainer`. The `props` will include the following:
+     * - `onLayout`: Method for updating data about the real `CellContainer` layout
+     * - `index`: Index of the cell in the list, you can use this to query data if needed
+     * - `style`: Style of `CellContainer`, including:
+     *   - `flexDirection`: Depends on whether your list is horizontal or vertical
+     *   - `position`: Value of this will be `absolute` as that's how `FlashList` positions elements
+     *   - `left`: Determines position of the element on x axis
+     *   - `top`: Determines position of the element on y axis
+     *   - `width`: Determines width of the element (present when list is vertical)
+     *   - `height`: Determines height of the element (present when list is horizontal)
+     *
+     * Note: Changing layout of the cell can conflict with the native layout operations. You may need to set `disableAutoLayout` to `true` to prevent this.
+     */
+    CellRendererComponent?: React.ComponentType<any> | undefined;
+    /**
+     * Rendered in between each item, but not at the top or bottom. By default, `leadingItem` and `trailingItem` (if available) props are provided.
+     */
+    ItemSeparatorComponent?: React.ComponentType<any> | null | undefined;
+    /**
+     * Rendered when the list is empty. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
+     */
+    ListEmptyComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
+    /**
+     * Rendered at the bottom of all the items. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
+     */
+    ListFooterComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
+    /**
+     * Styling for internal View for `ListFooterComponent`.
+     */
+    ListFooterComponentStyle?: StyleProp<ViewStyle> | undefined;
+    /**
+     * Rendered at the top of all the items. Can be a React Component (e.g. `SomeComponent`), or a React element (e.g. `<SomeComponent />`).
+     */
+    ListHeaderComponent?: React.ComponentType<any> | React.ReactElement | null | undefined;
+    /**
+     * Styling for internal View for `ListHeaderComponent`.
+     */
+    ListHeaderComponentStyle?: StyleProp<ViewStyle> | undefined;
+    /**
+     * Rendered as the main scrollview.
+     */
+    renderScrollComponent?: React.ComponentType<ScrollViewProps> | React.FC<ScrollViewProps>;
+    /**
+     * Draw distance for advanced rendering (in dp/px)
+     */
+    drawDistance?: number;
+    /**
+     * A marker property for telling the list to re-render (since it implements PureComponent).
+     * If any of your `renderItem`, Header, Footer, etc. functions depend on anything outside of the `data` prop,
+     * stick it here and treat it immutably.
+     */
+    extraData?: any;
+    /**
+     * If true, renders items next to each other horizontally instead of stacked vertically.
+     */
+    horizontal?: boolean | null | undefined;
+    /**
+     * Instead of starting at the top with the first item, start at initialScrollIndex.
+     */
+    initialScrollIndex?: number | null | undefined;
+    /**
+     * Additional configuration for initialScrollIndex.
+     * Use viewOffset to apply an offset to the initial scroll position as defined by initialScrollIndex.
+     * Ignored if initialScrollIndex is not set.
+     */
+    initialScrollIndexParams?: {
+        viewOffset?: number;
+    } | null | undefined;
+    /**
+     * Used to extract a unique key for a given item at the specified index.
+     * Key is used for optimizing performance. Defining `keyExtractor` is also necessary
+     * when doing [layout animations](https://shopify.github.io/flash-list/docs/guides/layout-animation)
+     * to uniquely identify animated components.
+     */
+    keyExtractor?: ((item: TItem, index: number) => string) | undefined;
+    /**
+     * Multiple columns can only be rendered with `horizontal={false}` and will zig-zag like a `flexWrap` layout.
+     * Items should all be the same height - masonry layouts are not supported.
+     */
+    numColumns?: number | undefined;
+    /**
+     * Called once when the scroll position gets within onEndReachedThreshold of the rendered content.
+     */
+    onEndReached?: (() => void) | null | undefined;
+    /**
+     * How far from the end (in units of visible length of the list) the bottom edge of the
+     * list must be from the end of the content to trigger the `onEndReached` callback.
+     * Thus a value of 0.5 will trigger `onEndReached` when the end of the content is
+     * within half the visible length of the list. Default value is 0.5.
+     */
+    onEndReachedThreshold?: number | null | undefined;
+    /**
+     * This event is raised once the list has drawn items on the screen. It also reports @param elapsedTimeInMs which is the time it took to draw the items.
+     * This is required because FlashList doesn't render items in the first cycle. Items are drawn after it measures itself at the end of first render.
+     * If you're using ListEmptyComponent, this event is raised as soon as ListEmptyComponent is rendered.
+     */
+    onLoad?: (info: {
+        elapsedTimeInMs: number;
+    }) => void;
+    /**
+     * Called when the viewability of rows changes, as defined by the `viewabilityConfig` prop.
+     * Array of `changed` includes `ViewToken`s that both visible and non-visible items. You can use the `isViewable` flag to filter the items.
+     *
+     * If you are tracking the time a view becomes (non-)visible, use the `timestamp` property.
+     * We make no guarantees that in the future viewability callbacks will be invoked as soon as they happen - for example,
+     * they might be deferred until JS thread is less busy.
+     */
+    onViewableItemsChanged?: ((info: {
+        viewableItems: ViewToken<TItem>[];
+        changed: ViewToken<TItem>[];
+    }) => void) | null | undefined;
+    /**
+     * If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality.
+     * Make sure to also set the refreshing prop correctly.
+     */
+    onRefresh?: (() => void) | null | undefined;
+    /**
+     * Allows developers to override type of items. This will improve recycling if you have different types of items in the list
+     * Right type will be used for the right item. Default type is 0
+     * If you don't want to change for an indexes just return undefined.
+     * Performance: This method is called very frequently. Keep it fast.
+     */
+    getItemType?: (item: TItem, index: number, extraData?: any) => string | number | undefined;
+    /**
+     * This method can be used to change column span of an item.
+     * Changing item span is useful when you have grid layouts (numColumns > 1) and you want few items to be bigger than the rest.
+     *
+     * Modify the given layout. Do not return. FlashList will fallback to default values if this is ignored.
+     *
+     * Performance: This method is called very frequently. Keep it fast.
+     */
+    overrideItemLayout?: (layout: {
+        span?: number;
+    }, item: TItem, index: number, maxColumns: number, extraData?: any) => void;
+    /**
+     * For debugging and exception use cases, internal props will be overriden with these values if used
+     */
+    overrideProps?: OverrideProps;
+    /**
+     * Set this when offset is needed for the loading indicator to show correctly.
+     * @platform android
+     */
+    progressViewOffset?: number | undefined;
+    /**
+     * Set this true while waiting for new data from a refresh.
+     */
+    refreshing?: boolean | null | undefined;
+    /**
+     * `viewabilityConfig` is a default configuration for determining whether items are viewable.
+     *
+     * Changing viewabilityConfig on the fly is not supported.
+     */
+    viewabilityConfig?: ViewabilityConfig | null | undefined;
+    /**
+     * List of `ViewabilityConfig`/`onViewableItemsChanged` pairs.
+     * A specific `onViewableItemsChanged` will be called when its corresponding `ViewabilityConfig`'s conditions are met.
+     */
+    viewabilityConfigCallbackPairs?: ViewabilityConfigCallbackPairs<TItem> | undefined;
+    /**
+     * New arch only
+     * Maximum number of items in the recycle pool. These are the items that are cached in the recycle pool when they are scrolled off the screen.
+     * Unless you have a huge number of item types, you shouldn't need to set this.
+     * Setting this to 0, will disable the recycle pool and items will unmount once they are scrolled off the screen.
+     * There's no limit by default.
+     */
+    maxItemsInRecyclePool?: number;
+    /**
+     * New arch only
+     * Enable masonry layout.
+     */
+    masonry?: boolean;
+    /**
+     * New arch only
+     * If enabled, MasonryFlashList will try to reduce difference in column height by modifying item order.
+     */
+    optimizeItemArrangement?: boolean;
+    /**
+     * New arch only
+     * Called once when the scroll position gets within onStartReachedThreshold of the start of the content.
+     */
+    onStartReached?: FlashListProps<TItem>["onEndReached"];
+    /**
+     * New arch only
+     * How far from the start (in units of visible length of the list) the top edge of the
+     * list must be from the start of the content to trigger the `onStartReached` callback.
+     * Thus a value of 0.5 will trigger `onStartReached` when the start of the content is
+     * within half the visible length of the list. Default value is 0.2.
+     */
+    onStartReachedThreshold?: FlashListProps<TItem>["onEndReachedThreshold"];
+    /**
+     * New arch only
+     * Style for the RecyclerView's parent container.
+     * Please avoid anything which can mess size of children in this view. For example, margin is okay but padding is not.
+     */
+    style?: StyleProp<ViewStyle>;
+    /**
+     * New arch only
+     * Configuration for maintaining scroll position when content changes.
+     * Useful for chat-like interfaces where new messages can be added at the top or bottom.
+     */
+    maintainVisibleContentPosition?: {
+        /**
+         * maintainVisibleContentPosition is enabled by default.
+         */
+        disabled?: boolean;
+        /**
+         * When content is added at the top, automatically scroll to maintain position if the user is within this threshold of the top
+         */
+        autoscrollToTopThreshold?: number;
+        /**
+         * When content is added at the bottom, automatically scroll to maintain position if the user is within this threshold of the bottom
+         */
+        autoscrollToBottomThreshold?: number;
+        /**
+         * Scroll with animation whenever `autoscrollToBottom` is triggered. Default is `true`.
+         * Default is true.
+         */
+        animateAutoScrollToBottom?: boolean;
+        /**
+         * If true, initial render will start from the bottom of the list, useful for chat-like interfaces when there are only few messages
+         */
+        startRenderingFromBottom?: boolean;
+    };
+    /**
+     * New arch only
+     * Called when the layout is committed. Can be used to measure list.
+     * Doing set state inside the callback can lead to infinite loops. Make sure FlashList's props are memoized.
+     */
+    onCommitLayoutEffect?: () => void;
+}
 //# sourceMappingURL=FlashListProps.d.ts.map

package/dist/FlashListProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlashListProps.d.ts","sourceRoot":"","sources":["../src/FlashListProps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FlashListProps.d.ts","sourceRoot":"","sources":["../src/FlashListProps.ts"],"names":[],"mappings":"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"}