@react-native-tvos/virtualized-lists 0.73.4 → 0.73.6-0

package/Lists/VirtualizedList.d.ts

@@ -390,4 +390,12 @@ export interface VirtualizedListWithoutRenderItemProps<ItemT>
     | React.ComponentType<CellRendererProps<ItemT>>
     | null
     | undefined;
+
+  /**
+   * Defines regions within the list that are exempt from virtualization,
+   * ensuring they remain rendered at all times. Useful for cases where
+   * users can't afford blank areas in certain parts of the list.
+   * The specified regions are lazily rendered after the initial render.
+   */
+  additionalRenderRegions?: {first: number; last: number}[] | undefined;
 }

package/Lists/VirtualizedList.js

@@ -31,6 +31,7 @@ import {
   ScrollView,
   View,
   StyleSheet,
+  TVFocusGuideView,
   findNodeHandle,
 } from 'react-native';
 import Batchinator from '../Interaction/Batchinator';
@@ -64,7 +65,6 @@ import {
   onEndReachedThresholdOrDefault,
   windowSizeOrDefault,
 } from './VirtualizedListProps';
-import TVFocusGuideView from '../../react-native/Libraries/Components/TV/TVFocusGuideView';
 
 export type {RenderItemProps, RenderItemType, Separators};
 
@@ -1900,13 +1900,19 @@ class VirtualizedList extends StateSafePureComponent<Props, State> {
     first: number,
     last: number,
   }> => {
+    let nonViewportRenderRegions = [];
+
+    if (props?.additionalRenderRegions?.length) {
+      nonViewportRenderRegions = [...props.additionalRenderRegions];
+    }
+
     // Keep a viewport's worth of content around the last focused cell to allow
     // random navigation around it without any blanking. E.g. tabbing from one
     // focused item out of viewport to another.
     if (
       !(this._lastFocusedCellKey && this._cellRefs[this._lastFocusedCellKey])
     ) {
-      return [];
+      return nonViewportRenderRegions;
     }
 
     const lastFocusedCellRenderer = this._cellRefs[this._lastFocusedCellKey];
@@ -1920,7 +1926,7 @@ class VirtualizedList extends StateSafePureComponent<Props, State> {
       VirtualizedList._getItemKey(props, focusedCellIndex) !==
         this._lastFocusedCellKey
     ) {
-      return [];
+      return nonViewportRenderRegions;
     }
 
     let first = focusedCellIndex;
@@ -1952,7 +1958,7 @@ class VirtualizedList extends StateSafePureComponent<Props, State> {
       ).length;
     }
 
-    return [{first, last}];
+    return [...nonViewportRenderRegions, {first, last}];
   };
 
   _updateViewableItems(

package/Lists/VirtualizedListProps.js

@@ -285,6 +285,13 @@ type OptionalProps = {|
    * The legacy implementation is no longer supported.
    */
   legacyImplementation?: empty,
+  /**
+   * Defines regions within the list that are exempt from virtualization,
+   * ensuring they remain rendered at all times. Useful for cases where
+   * users can't afford blank areas in certain parts of the list.
+   * The specified regions are lazily rendered after the initial render.
+   */
+  additionalRenderRegions?: Array<{first: number, last: number}>,
 |};
 
 export type Props = {|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-tvos/virtualized-lists",
-  "version": "0.73.4",
+  "version": "0.73.6-0",
   "description": "Virtualized lists for React Native with TV focus engine support.",
   "license": "MIT",
   "repository": {
@@ -29,4 +29,4 @@
   "peerDependencies": {
     "react-native": "*"
   }
-}
+}