@expo/ui 58.0.6 → 58.0.7

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{58.0.6/expo.modules.ui-58.0.6.module → 58.0.7/expo.modules.ui-58.0.7.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "expo.modules.ui",
     "module": "expo.modules.ui",
-    "version": "58.0.6",
+    "version": "58.0.7",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.6.aar",
-          "url": "expo.modules.ui-58.0.6.aar",
-          "size": 1792968,
-          "sha512": "ddcedbdcc0e95db83f0657a68090572e6d7c7fb9233e796ea875d86e9782c619560ef0e98316cdf6642abbed4b42eb43b5e8264be55130f47e473adbc0f77c11",
-          "sha256": "9b228fbd60d559e9dfebe894e1846a8c7ce3c72e5c91936b4382c97295e9b072",
-          "sha1": "643965a7c8a6f46ba589dcd348cbf5e112834194",
-          "md5": "61e999a9915231a3196a7fc2864c479e"
+          "name": "expo.modules.ui-58.0.7.aar",
+          "url": "expo.modules.ui-58.0.7.aar",
+          "size": 1835156,
+          "sha512": "58f2fa2376432db80f54bf406250ceb0c07fd16f2dd693dcb9aa784c078a18e5044bd224896e2112237b52f6169eeda86f3cfa4edae36be61fec24ffaa6ea1ac",
+          "sha256": "db4b84c7879a230cb83fb791d8f9a8f86a282f5c93751bc267dd8a648ed141af",
+          "sha1": "955cc1dcde621dc0ad9d70588bff46adfedc1129",
+          "md5": "b4a6d6acd9603febf32c95c833b1405f"
         }
       ]
     },
@@ -135,19 +135,19 @@
           "group": "io.github.expo.pika",
           "module": "pika-api",
           "version": {
-            "requires": "1.0.0"
+            "requires": "1.1.0"
           }
         }
       ],
       "files": [
         {
-          "name": "expo.modules.ui-58.0.6.aar",
-          "url": "expo.modules.ui-58.0.6.aar",
-          "size": 1792968,
-          "sha512": "ddcedbdcc0e95db83f0657a68090572e6d7c7fb9233e796ea875d86e9782c619560ef0e98316cdf6642abbed4b42eb43b5e8264be55130f47e473adbc0f77c11",
-          "sha256": "9b228fbd60d559e9dfebe894e1846a8c7ce3c72e5c91936b4382c97295e9b072",
-          "sha1": "643965a7c8a6f46ba589dcd348cbf5e112834194",
-          "md5": "61e999a9915231a3196a7fc2864c479e"
+          "name": "expo.modules.ui-58.0.7.aar",
+          "url": "expo.modules.ui-58.0.7.aar",
+          "size": 1835156,
+          "sha512": "58f2fa2376432db80f54bf406250ceb0c07fd16f2dd693dcb9aa784c078a18e5044bd224896e2112237b52f6169eeda86f3cfa4edae36be61fec24ffaa6ea1ac",
+          "sha256": "db4b84c7879a230cb83fb791d8f9a8f86a282f5c93751bc267dd8a648ed141af",
+          "sha1": "955cc1dcde621dc0ad9d70588bff46adfedc1129",
+          "md5": "b4a6d6acd9603febf32c95c833b1405f"
         }
       ]
     },
@@ -161,13 +161,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.ui-58.0.6-sources.jar",
-          "url": "expo.modules.ui-58.0.6-sources.jar",
-          "size": 106293,
-          "sha512": "5a6dc466f00aa1d74a9e1df2c4a06f3bf9c00b9eebe03e54e1ae68db446806f3f47f98e4a1d04bd90db6683459dd11785d22499d9cef48dd979293f8a88104d3",
-          "sha256": "d4e08c526d892c05d1ab6e42bd451df874e4da5cc58c18080ad730fc0ae59dfa",
-          "sha1": "ccc4bc2b5f6f1713a4f7c85ae9be4a6247690fc5",
-          "md5": "a2c50d54e658f6c03ab37ce21bc712ed"
+          "name": "expo.modules.ui-58.0.7-sources.jar",
+          "url": "expo.modules.ui-58.0.7-sources.jar",
+          "size": 109722,
+          "sha512": "c1f94d22a03f47ec553960cf5a44936e26992755aebc5f3583484c41ee224f9637620571022ae95f0687e5701632d93a1752f817dca5923b07aa10a2697c4776",
+          "sha256": "5645728c21cb9bd3183045c4208434114a1372ed0a367dadc545a2555294748b",
+          "sha1": "21cb93383a49b039772df3cbd1a14c3cd821886c",
+          "md5": "bbdad22fa84c26c5a5b649ed116f1fcb"
         }
       ]
     }

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.module.md5

@@ -0,0 +1 @@
+ef9649b49362d0da4b0e79afd086b9a8

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.module.sha1

@@ -0,0 +1 @@
+9dd32ee8f56b957697d2292dce6935a9a6c113f7

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.module.sha256

@@ -0,0 +1 @@
+4461d437dc9b9973416bb69437c013180a65b2a0d3cb5cb9a87566d1d388bad9

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.module.sha512

@@ -0,0 +1 @@
+62141bdabeb89bd61f79ba40fe8a39c31d7ff0f04eb060a7872dd83eb1e72899ee8d1befaeebdfb4251174b0dc53e4d9ac9e6cac357364d905ddd1df91754ed6

package/local-maven-repo/expo/modules/ui/expo.modules.ui/{58.0.6/expo.modules.ui-58.0.6.pom → 58.0.7/expo.modules.ui-58.0.7.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
-  <version>58.0.6</version>
+  <version>58.0.7</version>
   <packaging>aar</packaging>
   <name>expo.modules.ui</name>
   <url>https://github.com/expo/expo</url>
@@ -117,7 +117,7 @@
     <dependency>
       <groupId>io.github.expo.pika</groupId>
       <artifactId>pika-api</artifactId>
-      <version>1.0.0</version>
+      <version>1.1.0</version>
       <scope>runtime</scope>
     </dependency>
   </dependencies>

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.pom.md5

@@ -0,0 +1 @@
+ea27c56a290e1fc992da3e12320a93e8

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.pom.sha1

@@ -0,0 +1 @@
+582b5b30bd24edc8b923d34cce63fcd644fa12d6

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.pom.sha256

@@ -0,0 +1 @@
+5365fa5ce4427865eebebb3fa8fb502842f890b4bd2d79c2b6be0225fb07a2fc

package/local-maven-repo/expo/modules/ui/expo.modules.ui/58.0.7/expo.modules.ui-58.0.7.pom.sha512

@@ -0,0 +1 @@
+5fcaae8cc43b51d719769cbebd906e1333dd120c6d14212a2006aa0ee966143bb32a04edc35ed68a7f8cdb1cee1ae442c3cf98f6f0a39b0cbc2a05ae0287c4fd

package/local-maven-repo/expo/modules/ui/expo.modules.ui/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>expo.modules.ui</groupId>
   <artifactId>expo.modules.ui</artifactId>
   <versioning>
-    <latest>58.0.6</latest>
-    <release>58.0.6</release>
+    <latest>58.0.7</latest>
+    <release>58.0.7</release>
     <versions>
-      <version>58.0.6</version>
+      <version>58.0.7</version>
     </versions>
-    <lastUpdated>20260923154017</lastUpdated>
+    <lastUpdated>20260925081306</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/expo/modules/ui/expo.modules.ui/maven-metadata.xml.md5

@@ -1 +1 @@
-96559b0eabb8170769333ad05cdcfafe
+3b013569e130377748855287121192d4

package/local-maven-repo/expo/modules/ui/expo.modules.ui/maven-metadata.xml.sha1

@@ -1 +1 @@
-9b146187e50f805cfcdce4249b9d56e1e1fdf9d6
+c66fce1b7df0c1281b2cabcf550be469af735aee

package/local-maven-repo/expo/modules/ui/expo.modules.ui/maven-metadata.xml.sha256

@@ -1 +1 @@
-89c63e4e2a7fce899cd9101093d5c1105c62feffaea5ec288e6a39e5b8739446
+4531b51612843804ca4cd240ad0c2e8ca8c576a8459e0a5311a68a9859ab7251

package/local-maven-repo/expo/modules/ui/expo.modules.ui/maven-metadata.xml.sha512

@@ -1 +1 @@
-50a66b6bfe1bbcedd9157651a817cac9309fb48c2a649c274b5a34e625370c8cd487af0235f5801320779f19049a619e06bcb71e69df646a129d06bfb0041c27
+a2250c863289705ac41b43de2372d4232e10cda70f7fb7e2cc2f1fc32ea8005ad51acbcf9f24f7be1295e4cfe50fed4ee6ed6950bc87557253faa1a1d22f54f3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/ui",
-  "version": "58.0.6",
+  "version": "58.0.7",
   "description": "A collection of UI components",
   "keywords": [
     "Jetpack Compose",
@@ -149,8 +149,8 @@
     "@types/node": "^22.14.0",
     "@types/react": "~19.3.0",
     "expo-module-scripts": "56.0.3",
-    "react-native-reanimated": "4.6.0",
-    "react-native-worklets": "0.12.2"
+    "react-native-reanimated": "4.7.0",
+    "react-native-worklets": "0.13.0"
   },
   "peerDependencies": {
     "@babel/core": "*",
@@ -171,7 +171,7 @@
       "optional": true
     }
   },
-  "gitHead": "8aeb4368d396d2d71a2fc8c652c4d1d4d53ed858",
+  "gitHead": "ad41d067bd3df6dd12f1788acc6b54a68e7a650d",
   "scripts": {
     "precompile-ios": "et prebuild-package-for-publish",
     "build": "pnpm run build:lib && pnpm run build:plugin",

package/src/jetpack-compose/LazyColumn/index.tsx

@@ -1,6 +1,7 @@
 import { requireNativeView } from 'expo';
 
 import type { ExpoModifier } from '../../types';
+import { LazyItems } from '../LazyItems';
 import { createViewModifierEventListener } from '../modifiers/utils';
 
 /**
@@ -77,3 +78,5 @@ function transformProps(props: LazyColumnProps): NativeLazyColumnProps {
 export function LazyColumn(props: LazyColumnProps) {
   return <LazyColumnNativeView {...transformProps(props)} />;
 }
+
+LazyColumn.Items = LazyItems;

package/src/jetpack-compose/LazyItems/index.tsx

@@ -0,0 +1,121 @@
+import { requireNativeView } from 'expo';
+import { Fragment, type ReactElement } from 'react';
+
+import {
+  useItemKeys,
+  useRecycledRows,
+  type RecycledSlotProps,
+  type RenderItem,
+  type WindowChangeEvent,
+} from '../../recycling/useRecycledRows';
+import { type ViewEvent } from '../../types';
+
+export interface LazyItemsProps<ItemT> {
+  /** Items to display. Replace the array when updating data. */
+  data: readonly ItemT[];
+  /** Returns a stable, unique string key, also used as the lazy list item key. */
+  keyExtractor: (item: ItemT, index: number) => string;
+  /**
+   * Renders a row. Wrap it in `useCallback`, or every row re-renders on each parent render.
+   * Recycled rows are reused for other items, so their local state (`useState`) carries over.
+   * Reset it when the item changes, or keep the state outside the row.
+   */
+  children: RenderItem<ItemT>;
+  /**
+   * Renders only the rows near the visible range and reuses them while scrolling. Set to `false` to
+   * render every row at once. Set it once; changing it remounts the rows.
+   * @default true
+   */
+  recycling?: boolean;
+  /**
+   * Extra rows to prepare on each side of the visible rows. Must be a non-negative integer.
+   * Ignored when `recycling` is `false`.
+   * @default 10
+   */
+  overscanCount?: number;
+  /**
+   * Placeholder size in dp along the scroll axis, until a row is measured. Must be positive.
+   * Measurements reset when the data changes. In `LazyColumn.Items` they also reset when the list
+   * width changes. Ignored when `recycling` is `false`.
+   * @default 64
+   */
+  estimatedItemSize?: number;
+}
+
+type NativeLazyItemsProps = ViewEvent<'onWindowChange', WindowChangeEvent> & {
+  itemKeys: string[];
+  revision: number;
+  estimatedItemSize: number;
+  children: ReactElement;
+};
+
+const LazyItemsNativeView: React.ComponentType<NativeLazyItemsProps> =
+  requireNativeView<NativeLazyItemsProps>('ExpoUI', 'LazyItemsView');
+const LazyItemsSlotNativeView: React.ComponentType<RecycledSlotProps> =
+  requireNativeView<RecycledSlotProps>('ExpoUI', 'LazyItemsSlotView');
+const LazyItemsPoolNativeView: React.ComponentType<{ children: ReactElement[] }> =
+  requireNativeView('ExpoUI', 'LazyItemsPoolView');
+
+/**
+ * A block of recycled rows inside `LazyColumn` or `LazyRow`, mirroring the Compose
+ * `items(count, key)` builder. Only a small pool of rows around the visible range is mounted,
+ * so large data sets stay cheap. Rows that are not ready yet show a placeholder of
+ * `estimatedItemSize`, or of the size last measured for that item.
+ *
+ * Mount it as a direct child of `LazyColumn` or `LazyRow`. Plain children of the same list stay
+ * single items, so static and recycled content can be mixed in order.
+ * @platform android
+ */
+export const LazyItems = createLazyItems('LazyColumn.Items');
+
+/**
+ * @hidden
+ * Creates the `Items` component of one lazy list, so its errors name that list.
+ */
+export function createLazyItems(componentName: string) {
+  function Items<ItemT>({ recycling = true, ...props }: LazyItemsProps<ItemT>) {
+    return recycling ? <RecycledItems {...props} /> : <StaticItems {...props} />;
+  }
+
+  // Each row is a plain child of the lazy list, so it becomes one lazy item.
+  function StaticItems<ItemT>({
+    data,
+    keyExtractor,
+    children: renderItem,
+  }: Omit<LazyItemsProps<ItemT>, 'recycling'>) {
+    const itemKeys = useItemKeys(componentName, data, keyExtractor);
+    return data.map((item, index) => (
+      <Fragment key={itemKeys[index]}>{renderItem({ item, index })}</Fragment>
+    ));
+  }
+
+  function RecycledItems<ItemT>({
+    data,
+    keyExtractor,
+    children: renderItem,
+    overscanCount,
+    estimatedItemSize = 64,
+  }: Omit<LazyItemsProps<ItemT>, 'recycling'>) {
+    const { itemKeys, revision, rows, onWindowChange } = useRecycledRows({
+      componentName,
+      Slot: LazyItemsSlotNativeView,
+      data,
+      keyExtractor,
+      renderItem,
+      overscanCount,
+      estimatedItemSize,
+    });
+
+    return (
+      <LazyItemsNativeView
+        itemKeys={itemKeys}
+        revision={revision}
+        estimatedItemSize={estimatedItemSize}
+        onWindowChange={({ nativeEvent }) => onWindowChange(nativeEvent)}>
+        <LazyItemsPoolNativeView>{rows}</LazyItemsPoolNativeView>
+      </LazyItemsNativeView>
+    );
+  }
+  Items.displayName = componentName;
+  return Items;
+}

package/src/jetpack-compose/LazyRow/index.tsx

@@ -2,6 +2,7 @@ import { requireNativeView } from 'expo';
 
 import type { ExpoModifier } from '../../types';
 import { type ContentPadding } from '../LazyColumn';
+import { createLazyItems } from '../LazyItems';
 import { createViewModifierEventListener } from '../modifiers/utils';
 
 export interface LazyRowProps {
@@ -56,3 +57,5 @@ function transformProps(props: LazyRowProps): NativeLazyRowProps {
 export function LazyRow(props: LazyRowProps) {
   return <LazyRowNativeView {...transformProps(props)} />;
 }
+
+LazyRow.Items = createLazyItems('LazyRow.Items');

package/src/jetpack-compose/index.ts

@@ -17,6 +17,7 @@ export * from './ExposedDropdownMenuBox';
 export * from './Divider';
 export * from './Host';
 export * from './LazyColumn';
+export { type LazyItemsProps } from './LazyItems';
 export * from './LazyRow';
 export * from './ListItem';
 export * from './RNHostView';

package/src/recycling/useRecycledRows.tsx

@@ -0,0 +1,200 @@
+import {
+  memo,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState,
+  type ComponentType,
+  type ReactElement,
+} from 'react';
+
+import { getSlotIndices, getWindow } from './window';
+
+/** Payload of the native event asking for the rows around the visible range. */
+export type WindowChangeEvent = { first: number; last: number; revision: number };
+
+/** Props of the native view that holds one recycled row. */
+export type RecycledSlotProps = {
+  itemKey: string;
+  index: number;
+  revision: number;
+  children: ReactElement;
+};
+
+/** Renders one row of the data set. */
+export type RenderItem<ItemT> = (info: { item: ItemT; index: number }) => ReactElement;
+
+type RecycledRowProps<ItemT> = Omit<RecycledSlotProps, 'children'> & {
+  Slot: ComponentType<RecycledSlotProps>;
+  item: ItemT;
+  renderItem: RenderItem<ItemT>;
+};
+
+// Skip unchanged rows when the window moves.
+const RecycledRow = memo(function RecycledRow<ItemT>({
+  Slot,
+  item,
+  index,
+  itemKey,
+  revision,
+  renderItem,
+}: RecycledRowProps<ItemT>) {
+  return (
+    <Slot itemKey={itemKey} index={index} revision={revision}>
+      {renderItem({ item, index })}
+    </Slot>
+  );
+}) as <ItemT>(props: RecycledRowProps<ItemT>) => ReactElement;
+
+export type RecycledRows = {
+  /** Keys of every item, so the native list can size and identify the full data set. */
+  itemKeys: string[];
+  /** Increases whenever the data changes, so late native events can be dropped. */
+  revision: number;
+  /** The pooled rows to mount, one per slot. */
+  rows: ReactElement[];
+  /** Applies a native window request. */
+  onWindowChange: (event: WindowChangeEvent) => void;
+  /** Whether a native event was sent for the data currently committed to native. */
+  isCurrentRevision: (revision: number) => boolean;
+};
+
+/**
+ * Returns one key per item. Keys follow `data` only: an inline `keyExtractor` changes identity on
+ * every parent render, and recomputing keys for it would bump the revision and re-render every row.
+ */
+export function useItemKeys<ItemT>(
+  componentName: string,
+  data: readonly ItemT[],
+  keyExtractor: (item: ItemT, index: number) => string
+): string[] {
+  const keyExtractorRef = useRef(keyExtractor);
+  keyExtractorRef.current = keyExtractor;
+  return useMemo(() => {
+    const keys = data.map((item, index) => keyExtractorRef.current(item, index));
+    if (keys.some((key) => typeof key !== 'string') || new Set(keys).size !== keys.length) {
+      throw new Error(`${componentName} keyExtractor must return a unique string for every item.`);
+    }
+    return keys;
+  }, [data]);
+}
+
+/**
+ * Keeps a fixed pool of rows centered on the range the native list asks for.
+ * Item `index` always renders in slot `index % capacity`, so moving the window
+ * only re-renders the slots whose item changed.
+ */
+export function useRecycledRows<ItemT>({
+  componentName,
+  Slot,
+  data,
+  keyExtractor,
+  renderItem,
+  overscanCount = 10,
+  estimatedItemSize = 64,
+}: {
+  /** Name used in error messages, for example `List.ForEach`. */
+  componentName: string;
+  /** Native view that holds one recycled row. */
+  Slot: ComponentType<RecycledSlotProps>;
+  data: readonly ItemT[];
+  keyExtractor: (item: ItemT, index: number) => string;
+  renderItem: RenderItem<ItemT>;
+  overscanCount?: number;
+  estimatedItemSize?: number;
+}): RecycledRows {
+  if (!Number.isSafeInteger(overscanCount) || overscanCount < 0) {
+    throw new Error(`${componentName} overscanCount must be a non-negative integer.`);
+  }
+  if (!Number.isFinite(estimatedItemSize) || estimatedItemSize <= 0) {
+    throw new Error(`${componentName} estimatedItemSize must be a positive finite number.`);
+  }
+  const itemKeys = useItemKeys(componentName, data, keyExtractor);
+  const [state, setState] = useState({
+    keys: itemKeys,
+    first: 0,
+    last: 0,
+    revision: 0,
+    capacity: 0,
+    overscanCount,
+  });
+  let current = state;
+  if (state.keys !== itemKeys) {
+    const previousKey = state.keys[state.first];
+    const anchor = previousKey === undefined ? 0 : Math.max(0, itemKeys.indexOf(previousKey));
+    current = {
+      ...state,
+      keys: itemKeys,
+      first: Math.min(anchor, Math.max(0, data.length - 1)),
+      last: Math.min(anchor + state.last - state.first, Math.max(0, data.length - 1)),
+      revision: state.revision + 1,
+    };
+  }
+  if (current.overscanCount !== overscanCount) {
+    current = { ...current, overscanCount, capacity: 0 };
+  }
+  if (current !== state) setState(current);
+  const { start, capacity } = getWindow(
+    data.length,
+    current.first,
+    current.last,
+    overscanCount,
+    current.capacity
+  );
+  const committedRevision = useRef(current.revision);
+  useLayoutEffect(() => {
+    committedRevision.current = current.revision;
+  }, [current.revision]);
+
+  const rows = getSlotIndices(start, capacity).map((index, slot) => {
+    const item = data[index];
+    const itemKey = itemKeys[index];
+    if (item === undefined || itemKey === undefined) {
+      throw new Error(`${componentName} could not resolve the item at index ${index}.`);
+    }
+    return (
+      <RecycledRow
+        key={slot}
+        Slot={Slot}
+        item={item}
+        index={index}
+        itemKey={itemKey}
+        revision={current.revision}
+        renderItem={renderItem}
+      />
+    );
+  });
+
+  return {
+    itemKeys,
+    revision: current.revision,
+    rows,
+    isCurrentRevision: (revision) => revision === committedRevision.current,
+    onWindowChange: (event) => {
+      if (
+        !Number.isSafeInteger(event.first) ||
+        !Number.isSafeInteger(event.last) ||
+        event.last < event.first
+      ) {
+        return;
+      }
+      setState((previous) => {
+        // Ignore requests from before a data change.
+        if (event.revision !== previous.revision) return previous;
+        const maximum = Math.max(0, previous.keys.length - 1);
+        const first = Math.max(0, Math.min(event.first, maximum));
+        const last = Math.max(first, Math.min(event.last, maximum));
+        const { capacity } = getWindow(
+          previous.keys.length,
+          first,
+          last,
+          previous.overscanCount,
+          previous.capacity
+        );
+        return first === previous.first && last === previous.last && capacity === previous.capacity
+          ? previous
+          : { ...previous, first, last, capacity };
+      });
+    },
+  };
+}