@rootnative/inertia 0.0.6 → 0.0.7

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to `@rootnative/inertia` are documented here. The format fol
 
 ## [Unreleased]
 
+## [0.0.7] - 2026-08-14
+
+### Added
+
+- **`Motion.FlatList` — a virtualized animated scroller.** Reachable from the `Motion` namespace, as the named export `MotionFlatList`, and through the new `@rootnative/inertia/flat-list` subpath.
+
+  It closes a gap that forced a real architectural compromise on consumers: `useScroll`'s `onScroll` is a worklet handler, which only functions on a Reanimated animated component, and until now the only animated scroller was `Motion.ScrollView` — which mounts every row. A long list could virtualize (a plain `FlatList`, no animation) or animate from scroll position (`Motion.ScrollView`, every row mounted), not both. Nothing about `useScroll` was ever specific to `ScrollView`; the primitive was simply missing.
+
+  Animation props apply to the scroll **container**, matching `Motion.ScrollView`. Rows animate via a `Motion.*` primitive inside `renderItem`, which is what makes scroll-driven row effects work. The `layout` prop animates the list frame; Reanimated's `itemLayoutAnimation` is forwarded untouched for per-row layout animation.
+
+  Typing keeps both inference paths that a naive wrapper loses. `createMotionComponent<C>` returns a non-generic component, so `data` / `renderItem` would collapse to `any` — the item type is restored with a generic call signature, the same fix Reanimated applies to its own `Animated.FlatList`. The variants map is a **second** generic on that one signature, so `animate="typo"` against a `variants` prop stays a compile error here exactly as on every other primitive; declaring only the item generic would have silently dropped that narrowing on this primitive alone.
+
+  Built on Reanimated's `Animated.FlatList` rather than RN's `FlatList`, which supplies the `CellRendererComponent` injection behind `itemLayoutAnimation` and defaults `scrollEventThrottle` to 1 — so a `useScroll` handler reports every frame with no extra prop.
+
+  **Bundle cost: 9.10 kB for the new subpath, +0.04 kB on the root entry**, and nothing on existing subpaths. The cheapest primitive added so far: it is almost entirely the shared factory, adding no parser, no interpolation, and no worklet branch.
+
+### Fixed
+
+- **`gesture={{ pressed: … }}` now responds to a mouse on web.** On any primitive that isn't a `Pressable` — a plain `Motion.View`, `Motion.Text`, `Motion.Image` — the pressed layer never engaged under a desktop click. It has been inert on web since the `gesture` prop shipped in `0.0.1`.
+
+  The cause is which events the layer was wired to. `pressed` was driven by `onTouchStart` / `onTouchEnd` plus `onPressIn` / `onPressOut`. The press pair only exists on `Pressable`-style hosts, and react-native-web forwards `onTouchStart` to the DOM as a real `touchstart` listener — which a mouse never fires. So `Motion.Pressable` worked (it has the press path) while every other primitive had no live path at all for a pointer that isn't a finger.
+
+  The layer now also listens on `onPointerDown` / `onPointerUp` / `onPointerCancel`, which react-native-web forwards and which cover mouse, pen, and touch alike. `pressed` means "any pointer" on every platform. `onPointerCancel` is included so a browser-initiated takeover (a scroll or drag beginning mid-press) releases the layer instead of leaving it stuck on.
+
+  A web touch emits both `touchstart` and `pointerdown`; both set the same flag to the same value, so the overlap is idempotent rather than a double-toggle. React Native has no pointer props, so the added handlers are inert on iOS and Android. `hovered`, `focused`, and `focusVisible` were never affected — their events are forwarded on every primitive.
+
+  **Bundle cost: +0.06 kB (+0.7%) per primitive subpath**, 9.05 → 9.11 kB brotlied, +0.04 kB on the root entry. No `size-limit` cap moved. Handlers are still mounted only when `pressed` is declared, so the gesture-less path is unchanged.
+
+### Internal
+
+- **`pressed-modalities.test.tsx` asserts each input modality separately.** Every pre-existing gesture test fires `pressIn` — the one path that already worked on every platform — which is why a six-release gap in the touch and pointer paths went unseen. The new file drives touch, pointer, and press independently, plus the cancel path, the both-events-at-once overlap, composition with a consumer's own pointer handlers, and the guarantee that no pointer handler is mounted when `pressed` isn't declared.
+
 ## [0.0.6] - 2026-08-08
 
 **Defect release: two animations that never ran.** Both trace to one assumption about what Reanimated accepts as an animatable value, and both were hidden by the same thing — `type: 'timing'` snaps to its target when the duration elapses, so a total interpolation failure still produced the right end state. `animate={{ boxShadow }}` was inert under the default spring; every colour key was inert when it rested at its default, which is the far more common path. Neither is caught by a mocked test suite, so this release also adds a test file that runs Reanimated's real drivers.
@@ -225,7 +257,8 @@ Initial alpha publish. The full initial surface is in place; APIs are still subj
 - SVG path morphing, gradient interpolation, and shared-element transitions across screens are out of scope until `0.2.x` / `1.x` per the roadmap.
 - `react-native-gesture-handler` integration (drag, pan, swipe sub-states) lands in `0.2` via the optional `@rootnative/inertia-gestures` adapter.
 
-[unreleased]: https://github.com/rootnative/inertia/compare/core+gestures+gradients+svg@0.0.6...HEAD
+[unreleased]: https://github.com/rootnative/inertia/compare/core+gestures+gradients+svg@0.0.7...HEAD
+[0.0.7]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.7
 [0.0.6]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.6
 [0.0.5]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.5
 [0.0.4]: https://github.com/rootnative/inertia/releases/tag/core+gestures+gradients+svg@0.0.4

package/README.md

@@ -1,3 +1,9 @@
+<!--
+  Absolute URL, not a relative path: this README is the npm package page, and
+  npm does not resolve repository-relative image paths.
+-->
+<img src="https://raw.githubusercontent.com/rootnative/inertia/main/assets/brand/inertia-mark.png" alt="" width="88" height="88" />
+
 # @rootnative/inertia
 
 [![npm](https://img.shields.io/npm/v/@rootnative/inertia.svg)](https://www.npmjs.com/package/@rootnative/inertia)
@@ -6,7 +12,7 @@
 
 Declarative animation primitives for React Native, built as a thin wrapper around [`react-native-reanimated`](https://docs.swmansion.com/react-native-reanimated/). Inspired by Framer Motion (web) and react-spring (cross-platform).
 
-> **Status:** `0.0.6` — stable. Pre-`1.0.0` minor versions may break — see the root [README](https://github.com/rootnative/inertia#versioning--release).
+> **Status:** `0.0.7` — stable. Pre-`1.0.0` minor versions may break — see the root [README](https://github.com/rootnative/inertia#versioning--release).
 
 ## Install
 

package/dist/{chunk-C3EDC5ZW.mjs → chunk-52QSN2VQ.mjs}

@@ -1,4 +1,4 @@
-import { createMotionComponent } from './chunk-2ICQLWH2.mjs';
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
 import { Pressable } from 'react-native';
 
 var MotionPressable = createMotionComponent(Pressable);

package/dist/{chunk-767UKZXG.js → chunk-6V7MOBXO.js}

@@ -1652,6 +1652,15 @@ function useGestureHandlers(gesture, rest, setPressed, setFocused, setFocusVisib
       );
       handlers.onPressIn = compose(rest.onPressIn, () => setPressed(true));
       handlers.onPressOut = compose(rest.onPressOut, () => setPressed(false));
+      handlers.onPointerDown = compose(
+        rest.onPointerDown,
+        () => setPressed(true)
+      );
+      handlers.onPointerUp = compose(rest.onPointerUp, () => setPressed(false));
+      handlers.onPointerCancel = compose(
+        rest.onPointerCancel,
+        () => setPressed(false)
+      );
     }
     if (gesture.focused || gesture.focusVisible) {
       handlers.onFocus = compose(rest.onFocus, () => {
@@ -1681,6 +1690,9 @@ function useGestureHandlers(gesture, rest, setPressed, setFocused, setFocusVisib
     rest.onTouchCancel,
     rest.onPressIn,
     rest.onPressOut,
+    rest.onPointerDown,
+    rest.onPointerUp,
+    rest.onPointerCancel,
     rest.onFocus,
     rest.onBlur,
     rest.onMouseEnter,

package/dist/{chunk-2ICQLWH2.mjs → chunk-HPJMIBBK.mjs}

@@ -1646,6 +1646,15 @@ function useGestureHandlers(gesture, rest, setPressed, setFocused, setFocusVisib
       );
       handlers.onPressIn = compose(rest.onPressIn, () => setPressed(true));
       handlers.onPressOut = compose(rest.onPressOut, () => setPressed(false));
+      handlers.onPointerDown = compose(
+        rest.onPointerDown,
+        () => setPressed(true)
+      );
+      handlers.onPointerUp = compose(rest.onPointerUp, () => setPressed(false));
+      handlers.onPointerCancel = compose(
+        rest.onPointerCancel,
+        () => setPressed(false)
+      );
     }
     if (gesture.focused || gesture.focusVisible) {
       handlers.onFocus = compose(rest.onFocus, () => {
@@ -1675,6 +1684,9 @@ function useGestureHandlers(gesture, rest, setPressed, setFocused, setFocusVisib
     rest.onTouchCancel,
     rest.onPressIn,
     rest.onPressOut,
+    rest.onPointerDown,
+    rest.onPointerUp,
+    rest.onPointerCancel,
     rest.onFocus,
     rest.onBlur,
     rest.onMouseEnter,

package/dist/{chunk-PFPO7DX2.mjs → chunk-KBFN4TRO.mjs}

@@ -1,4 +1,4 @@
-import { createMotionComponent } from './chunk-2ICQLWH2.mjs';
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
 import { Image } from 'react-native';
 
 var MotionImage = createMotionComponent(Image);

package/dist/chunk-NPJ46457.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
+var reactNative = require('react-native');
+
+var MotionView = chunk6V7MOBXO_js.createMotionComponent(reactNative.View);
+
+exports.MotionView = MotionView;

package/dist/chunk-QJYFTTM2.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
+var Animated = require('react-native-reanimated');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Animated__default = /*#__PURE__*/_interopDefault(Animated);
+
+var MotionFlatList = chunk6V7MOBXO_js.createMotionComponent(
+  Animated__default.default.FlatList
+  // `createMotionComponent<C>` returns a non-generic `MotionComponent<C>`, so
+  // `data` / `renderItem` would collapse to `any` and lose `ItemT` inference.
+  // Restore it with the same call-signature cast Reanimated itself uses for
+  // this exact problem (see its `ReanimatedFlatList` export, and the
+  // `@ts-expect-error` above `AnimatedFlatList` explaining that
+  // `createAnimatedComponent` cannot create generic components).
+  //
+  // **Both** generics live on the one call signature, and that is deliberate:
+  // `ItemT` infers from `data` while `V` infers from `variants`, independently.
+  // Declaring only `ItemT` (the obvious first cut) silently drops the
+  // variant-key narrowing that `MotionComponent` provides on every other
+  // primitive — `animate="typo"` would stop being a compile error here and
+  // nowhere else. Both directions are pinned in
+  // `__type-tests__/flat-list.test-d.tsx`.
+);
+
+exports.MotionFlatList = MotionFlatList;

package/dist/{chunk-X7B5WR5A.js → chunk-QYR66E2G.js}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk767UKZXG_js = require('./chunk-767UKZXG.js');
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
 var reactNative = require('react-native');
 
-var MotionScrollView = chunk767UKZXG_js.createMotionComponent(reactNative.ScrollView);
+var MotionScrollView = chunk6V7MOBXO_js.createMotionComponent(reactNative.ScrollView);
 
 exports.MotionScrollView = MotionScrollView;

package/dist/{chunk-CMHVF6F4.mjs → chunk-RUIOM2YZ.mjs}

@@ -1,4 +1,4 @@
-import { createMotionComponent } from './chunk-2ICQLWH2.mjs';
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
 import { View } from 'react-native';
 
 var MotionView = createMotionComponent(View);

package/dist/{chunk-BAAQI37F.mjs → chunk-VSK2E35J.mjs}

@@ -1,4 +1,4 @@
-import { createMotionComponent } from './chunk-2ICQLWH2.mjs';
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
 import { ScrollView } from 'react-native';
 
 var MotionScrollView = createMotionComponent(ScrollView);

package/dist/{chunk-5MGWHOSV.js → chunk-WGCF3WQG.js}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk767UKZXG_js = require('./chunk-767UKZXG.js');
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
 var reactNative = require('react-native');
 
-var MotionPressable = chunk767UKZXG_js.createMotionComponent(reactNative.Pressable);
+var MotionPressable = chunk6V7MOBXO_js.createMotionComponent(reactNative.Pressable);
 
 exports.MotionPressable = MotionPressable;

package/dist/{chunk-F7LJX56B.mjs → chunk-WMLS4TMX.mjs}

@@ -1,4 +1,4 @@
-import { createMotionComponent } from './chunk-2ICQLWH2.mjs';
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
 import { Text } from 'react-native';
 
 var MotionText = createMotionComponent(Text);

package/dist/chunk-YUTS6JRU.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
+var reactNative = require('react-native');
+
+var MotionImage = chunk6V7MOBXO_js.createMotionComponent(reactNative.Image);
+
+exports.MotionImage = MotionImage;

package/dist/chunk-ZOBOKLAS.mjs

@@ -0,0 +1,22 @@
+import { createMotionComponent } from './chunk-HPJMIBBK.mjs';
+import Animated from 'react-native-reanimated';
+
+var MotionFlatList = createMotionComponent(
+  Animated.FlatList
+  // `createMotionComponent<C>` returns a non-generic `MotionComponent<C>`, so
+  // `data` / `renderItem` would collapse to `any` and lose `ItemT` inference.
+  // Restore it with the same call-signature cast Reanimated itself uses for
+  // this exact problem (see its `ReanimatedFlatList` export, and the
+  // `@ts-expect-error` above `AnimatedFlatList` explaining that
+  // `createAnimatedComponent` cannot create generic components).
+  //
+  // **Both** generics live on the one call signature, and that is deliberate:
+  // `ItemT` infers from `data` while `V` infers from `variants`, independently.
+  // Declaring only `ItemT` (the obvious first cut) silently drops the
+  // variant-key narrowing that `MotionComponent` provides on every other
+  // primitive — `animate="typo"` would stop being a compile error here and
+  // nowhere else. Both directions are pinned in
+  // `__type-tests__/flat-list.test-d.tsx`.
+);
+
+export { MotionFlatList };

package/dist/chunk-ZSOCRHU3.js

@@ -0,0 +1,8 @@
+'use strict';
+
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
+var reactNative = require('react-native');
+
+var MotionText = chunk6V7MOBXO_js.createMotionComponent(reactNative.Text);
+
+exports.MotionText = MotionText;

package/dist/gestureLayer/index.d.mts

@@ -1,6 +1,6 @@
 import { SharedValue, AnimatedStyle } from 'react-native-reanimated';
-import { U as UseGestureHandlers } from '../useGesture-DfaTx-3t.mjs';
-import { a as TransitionInput, G as GestureLayerTransitions } from '../types-BQgLJeQG.mjs';
+import { U as UseGestureHandlers } from '../useGesture-CnZQnYHH.mjs';
+import { b as TransitionInput, G as GestureLayerTransitions } from '../types-DyJpG64F.mjs';
 import 'react';
 import 'react-native';
 

package/dist/gestureLayer/index.d.ts

@@ -1,6 +1,6 @@
 import { SharedValue, AnimatedStyle } from 'react-native-reanimated';
-import { U as UseGestureHandlers } from '../useGesture-B0_CzOUz.js';
-import { a as TransitionInput, G as GestureLayerTransitions } from '../types-BQgLJeQG.js';
+import { U as UseGestureHandlers } from '../useGesture-DbH46EBp.js';
+import { b as TransitionInput, G as GestureLayerTransitions } from '../types-DyJpG64F.js';
 import 'react';
 import 'react-native';
 

package/dist/index.d.mts

@@ -2,11 +2,12 @@ import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
 import * as react_native from 'react-native';
 import { NativeSyntheticEvent, NativeScrollEvent } from 'react-native';
-import { M as MotionComponent, N as NamedTransitions, a as TransitionInput, T as TransitionConfig, A as AnimatableValue, E as EasingInput, S as SpringTransition, b as TransitionName, V as VariantController } from './types-BQgLJeQG.mjs';
-export { c as AnimateStyle, d as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, e as EasingFunction, f as EasingFunctionFactory, g as GestureSubStates, h as MotionProps, i as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, j as RepeatConfig, k as SequenceStep, l as TimingTransition, m as Transition, n as VariantsMap } from './types-BQgLJeQG.mjs';
+import { M as MotionComponent, V as VariantsMap, a as MotionProps, N as NamedTransitions, b as TransitionInput, T as TransitionConfig, A as AnimatableValue, E as EasingInput, S as SpringTransition, c as TransitionName, d as VariantController } from './types-DyJpG64F.mjs';
+export { e as AnimateStyle, f as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, g as EasingFunction, h as EasingFunctionFactory, i as GestureSubStates, j as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, k as RepeatConfig, l as SequenceStep, m as TimingTransition, n as Transition } from './types-DyJpG64F.mjs';
 import { SharedValue, useAnimatedStyle } from 'react-native-reanimated';
 export { SharedValue } from 'react-native-reanimated';
-export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-DfaTx-3t.mjs';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-CnZQnYHH.mjs';
+export { MotionFlatList } from './motion/FlatList.mjs';
 export { MotionImage } from './motion/Image.mjs';
 export { MotionPressable } from './motion/Pressable.mjs';
 export { MotionScrollView } from './motion/ScrollView.mjs';
@@ -36,6 +37,9 @@ declare const Motion: {
     readonly Image: MotionComponent<typeof react_native.Image>;
     readonly Pressable: MotionComponent<react.ForwardRefExoticComponent<react_native.PressableProps & react.RefAttributes<react_native.View>>>;
     readonly ScrollView: MotionComponent<typeof react_native.ScrollView>;
+    readonly FlatList: <ItemT = any, V extends VariantsMap<react_native.FlatListProps<ItemT>> = VariantsMap<react_native.FlatListProps<ItemT>>>(props: react_native.FlatListProps<ItemT> & MotionProps<react_native.FlatListProps<ItemT>, V> & {
+        ref?: React.Ref<react_native.FlatList<ItemT>>;
+    }) => React.ReactElement;
 };
 
 /**
@@ -731,10 +735,10 @@ interface UseScrollResult {
     /** Vertical scroll offset in points. */
     scrollY: SharedValue<number>;
     /**
-     * Handler to pass to a `Motion.ScrollView`'s `onScroll` prop (or any other
-     * Reanimated `Animated.ScrollView`). The handler is opaque to JS — it runs
-     * as a worklet — but the type narrows to the same shape RN's native
-     * `onScroll` prop expects so it composes cleanly.
+     * Handler to pass to the `onScroll` prop of `Motion.ScrollView` or
+     * `Motion.FlatList` (or any other Reanimated animated scroller). The handler
+     * is opaque to JS — it runs as a worklet — but the type narrows to the same
+     * shape RN's native `onScroll` prop expects so it composes cleanly.
      */
     onScroll: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
 }
@@ -766,9 +770,13 @@ interface UseScrollResult {
  * read from any worklet (`useAnimatedStyle`, `useDerivedValue`,
  * `useTransform`) without a JS-thread bounce.
  *
- * Remember to set `scrollEventThrottle={16}` on the `ScrollView` for 60Hz
+ * Remember to set `scrollEventThrottle={16}` on a `Motion.ScrollView` for 60Hz
  * updates — RN's default is to dispatch on every event, which on iOS still
  * means one per frame, but Android benefits from the explicit cap.
+ *
+ * `Motion.FlatList` needs no such setting — it defaults `scrollEventThrottle`
+ * to 1 for you. Prefer it over `Motion.ScrollView` for long or unbounded lists:
+ * it virtualizes, and both accept this handler.
  */
 declare function useScroll(): UseScrollResult;
 
@@ -897,4 +905,4 @@ declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnTyp
  */
 declare function useVariants<V extends Readonly<Record<string, object>>>(variants: V, initial?: keyof V & string): VariantController<keyof V & string>;
 
-export { AnimatableValue, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useTransform, useVariants };
+export { AnimatableValue, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useTransform, useVariants };

package/dist/index.d.ts

@@ -2,11 +2,12 @@ import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
 import * as react_native from 'react-native';
 import { NativeSyntheticEvent, NativeScrollEvent } from 'react-native';
-import { M as MotionComponent, N as NamedTransitions, a as TransitionInput, T as TransitionConfig, A as AnimatableValue, E as EasingInput, S as SpringTransition, b as TransitionName, V as VariantController } from './types-BQgLJeQG.js';
-export { c as AnimateStyle, d as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, e as EasingFunction, f as EasingFunctionFactory, g as GestureSubStates, h as MotionProps, i as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, j as RepeatConfig, k as SequenceStep, l as TimingTransition, m as Transition, n as VariantsMap } from './types-BQgLJeQG.js';
+import { M as MotionComponent, V as VariantsMap, a as MotionProps, N as NamedTransitions, b as TransitionInput, T as TransitionConfig, A as AnimatableValue, E as EasingInput, S as SpringTransition, c as TransitionName, d as VariantController } from './types-DyJpG64F.js';
+export { e as AnimateStyle, f as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, g as EasingFunction, h as EasingFunctionFactory, i as GestureSubStates, j as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, k as RepeatConfig, l as SequenceStep, m as TimingTransition, n as Transition } from './types-DyJpG64F.js';
 import { SharedValue, useAnimatedStyle } from 'react-native-reanimated';
 export { SharedValue } from 'react-native-reanimated';
-export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-B0_CzOUz.js';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-DbH46EBp.js';
+export { MotionFlatList } from './motion/FlatList.js';
 export { MotionImage } from './motion/Image.js';
 export { MotionPressable } from './motion/Pressable.js';
 export { MotionScrollView } from './motion/ScrollView.js';
@@ -36,6 +37,9 @@ declare const Motion: {
     readonly Image: MotionComponent<typeof react_native.Image>;
     readonly Pressable: MotionComponent<react.ForwardRefExoticComponent<react_native.PressableProps & react.RefAttributes<react_native.View>>>;
     readonly ScrollView: MotionComponent<typeof react_native.ScrollView>;
+    readonly FlatList: <ItemT = any, V extends VariantsMap<react_native.FlatListProps<ItemT>> = VariantsMap<react_native.FlatListProps<ItemT>>>(props: react_native.FlatListProps<ItemT> & MotionProps<react_native.FlatListProps<ItemT>, V> & {
+        ref?: React.Ref<react_native.FlatList<ItemT>>;
+    }) => React.ReactElement;
 };
 
 /**
@@ -731,10 +735,10 @@ interface UseScrollResult {
     /** Vertical scroll offset in points. */
     scrollY: SharedValue<number>;
     /**
-     * Handler to pass to a `Motion.ScrollView`'s `onScroll` prop (or any other
-     * Reanimated `Animated.ScrollView`). The handler is opaque to JS — it runs
-     * as a worklet — but the type narrows to the same shape RN's native
-     * `onScroll` prop expects so it composes cleanly.
+     * Handler to pass to the `onScroll` prop of `Motion.ScrollView` or
+     * `Motion.FlatList` (or any other Reanimated animated scroller). The handler
+     * is opaque to JS — it runs as a worklet — but the type narrows to the same
+     * shape RN's native `onScroll` prop expects so it composes cleanly.
      */
     onScroll: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
 }
@@ -766,9 +770,13 @@ interface UseScrollResult {
  * read from any worklet (`useAnimatedStyle`, `useDerivedValue`,
  * `useTransform`) without a JS-thread bounce.
  *
- * Remember to set `scrollEventThrottle={16}` on the `ScrollView` for 60Hz
+ * Remember to set `scrollEventThrottle={16}` on a `Motion.ScrollView` for 60Hz
  * updates — RN's default is to dispatch on every event, which on iOS still
  * means one per frame, but Android benefits from the explicit cap.
+ *
+ * `Motion.FlatList` needs no such setting — it defaults `scrollEventThrottle`
+ * to 1 for you. Prefer it over `Motion.ScrollView` for long or unbounded lists:
+ * it virtualizes, and both accept this handler.
  */
 declare function useScroll(): UseScrollResult;
 
@@ -897,4 +905,4 @@ declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnTyp
  */
 declare function useVariants<V extends Readonly<Record<string, object>>>(variants: V, initial?: keyof V & string): VariantController<keyof V & string>;
 
-export { AnimatableValue, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useTransform, useVariants };
+export { AnimatableValue, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useTransform, useVariants };

package/dist/index.js

@@ -1,12 +1,13 @@
 'use strict';
 
 var chunk4NAMD62I_js = require('./chunk-4NAMD62I.js');
-var chunkK5SI6VXS_js = require('./chunk-K5SI6VXS.js');
-var chunkSTARIT6W_js = require('./chunk-STARIT6W.js');
-var chunkFWWVHLXB_js = require('./chunk-FWWVHLXB.js');
-var chunk5MGWHOSV_js = require('./chunk-5MGWHOSV.js');
-var chunkX7B5WR5A_js = require('./chunk-X7B5WR5A.js');
-var chunk767UKZXG_js = require('./chunk-767UKZXG.js');
+var chunkNPJ46457_js = require('./chunk-NPJ46457.js');
+var chunkZSOCRHU3_js = require('./chunk-ZSOCRHU3.js');
+var chunkYUTS6JRU_js = require('./chunk-YUTS6JRU.js');
+var chunkWGCF3WQG_js = require('./chunk-WGCF3WQG.js');
+var chunkQYR66E2G_js = require('./chunk-QYR66E2G.js');
+var chunkQJYFTTM2_js = require('./chunk-QJYFTTM2.js');
+var chunk6V7MOBXO_js = require('./chunk-6V7MOBXO.js');
 var chunkOBRGJAST_js = require('./chunk-OBRGJAST.js');
 var chunkPM6CVGXJ_js = require('./chunk-PM6CVGXJ.js');
 var react = require('react');
@@ -15,11 +16,12 @@ var reactNativeWorklets = require('react-native-worklets');
 
 // src/motion/index.ts
 var Motion = {
-  View: chunkK5SI6VXS_js.MotionView,
-  Text: chunkSTARIT6W_js.MotionText,
-  Image: chunkFWWVHLXB_js.MotionImage,
-  Pressable: chunk5MGWHOSV_js.MotionPressable,
-  ScrollView: chunkX7B5WR5A_js.MotionScrollView
+  View: chunkNPJ46457_js.MotionView,
+  Text: chunkZSOCRHU3_js.MotionText,
+  Image: chunkYUTS6JRU_js.MotionImage,
+  Pressable: chunkWGCF3WQG_js.MotionPressable,
+  ScrollView: chunkQYR66E2G_js.MotionScrollView,
+  FlatList: chunkQJYFTTM2_js.MotionFlatList
 };
 function useAnimation(target, transition) {
   const output = reactNativeReanimated.useSharedValue(target);
@@ -362,9 +364,9 @@ function useShadow({
   const hasElevation = from.elevation !== void 0 || to.elevation !== void 0;
   const hasColor = from.shadowColor !== void 0 || to.shadowColor !== void 0;
   const hasOffset = from.shadowOffset !== void 0 || to.shadowOffset !== void 0;
-  const boxShadowPairs = from.boxShadow !== void 0 || to.boxShadow !== void 0 ? chunk767UKZXG_js.pairBoxShadowLayers(
-    chunk767UKZXG_js.resolveBoxShadowInput(from.boxShadow),
-    chunk767UKZXG_js.resolveBoxShadowInput(to.boxShadow)
+  const boxShadowPairs = from.boxShadow !== void 0 || to.boxShadow !== void 0 ? chunk6V7MOBXO_js.pairBoxShadowLayers(
+    chunk6V7MOBXO_js.resolveBoxShadowInput(from.boxShadow),
+    chunk6V7MOBXO_js.resolveBoxShadowInput(to.boxShadow)
   ) : [];
   const opacityFrom = from.shadowOpacity ?? 0;
   const opacityTo = to.shadowOpacity ?? 0;
@@ -467,39 +469,43 @@ Object.defineProperty(exports, "useGesture", {
 });
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkK5SI6VXS_js.MotionView; }
+  get: function () { return chunkNPJ46457_js.MotionView; }
 });
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkSTARIT6W_js.MotionText; }
+  get: function () { return chunkZSOCRHU3_js.MotionText; }
 });
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunkFWWVHLXB_js.MotionImage; }
+  get: function () { return chunkYUTS6JRU_js.MotionImage; }
 });
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunk5MGWHOSV_js.MotionPressable; }
+  get: function () { return chunkWGCF3WQG_js.MotionPressable; }
 });
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunkX7B5WR5A_js.MotionScrollView; }
+  get: function () { return chunkQYR66E2G_js.MotionScrollView; }
+});
+Object.defineProperty(exports, "MotionFlatList", {
+  enumerable: true,
+  get: function () { return chunkQJYFTTM2_js.MotionFlatList; }
 });
 Object.defineProperty(exports, "Presence", {
   enumerable: true,
-  get: function () { return chunk767UKZXG_js.Presence; }
+  get: function () { return chunk6V7MOBXO_js.Presence; }
 });
 Object.defineProperty(exports, "TRANSPARENT", {
   enumerable: true,
-  get: function () { return chunk767UKZXG_js.TRANSPARENT; }
+  get: function () { return chunk6V7MOBXO_js.TRANSPARENT; }
 });
 Object.defineProperty(exports, "createMotionComponent", {
   enumerable: true,
-  get: function () { return chunk767UKZXG_js.createMotionComponent; }
+  get: function () { return chunk6V7MOBXO_js.createMotionComponent; }
 });
 Object.defineProperty(exports, "usePresence", {
   enumerable: true,
-  get: function () { return chunk767UKZXG_js.usePresence; }
+  get: function () { return chunk6V7MOBXO_js.usePresence; }
 });
 Object.defineProperty(exports, "MotionConfig", {
   enumerable: true,

package/dist/index.mjs

@@ -1,16 +1,18 @@
 export { useGesture } from './chunk-OW5XTGVN.mjs';
-import { MotionView } from './chunk-CMHVF6F4.mjs';
-export { MotionView } from './chunk-CMHVF6F4.mjs';
-import { MotionText } from './chunk-F7LJX56B.mjs';
-export { MotionText } from './chunk-F7LJX56B.mjs';
-import { MotionImage } from './chunk-PFPO7DX2.mjs';
-export { MotionImage } from './chunk-PFPO7DX2.mjs';
-import { MotionPressable } from './chunk-C3EDC5ZW.mjs';
-export { MotionPressable } from './chunk-C3EDC5ZW.mjs';
-import { MotionScrollView } from './chunk-BAAQI37F.mjs';
-export { MotionScrollView } from './chunk-BAAQI37F.mjs';
-import { pairBoxShadowLayers, resolveBoxShadowInput } from './chunk-2ICQLWH2.mjs';
-export { Presence, TRANSPARENT, createMotionComponent, usePresence } from './chunk-2ICQLWH2.mjs';
+import { MotionView } from './chunk-RUIOM2YZ.mjs';
+export { MotionView } from './chunk-RUIOM2YZ.mjs';
+import { MotionText } from './chunk-WMLS4TMX.mjs';
+export { MotionText } from './chunk-WMLS4TMX.mjs';
+import { MotionImage } from './chunk-KBFN4TRO.mjs';
+export { MotionImage } from './chunk-KBFN4TRO.mjs';
+import { MotionPressable } from './chunk-52QSN2VQ.mjs';
+export { MotionPressable } from './chunk-52QSN2VQ.mjs';
+import { MotionScrollView } from './chunk-VSK2E35J.mjs';
+export { MotionScrollView } from './chunk-VSK2E35J.mjs';
+import { MotionFlatList } from './chunk-ZOBOKLAS.mjs';
+export { MotionFlatList } from './chunk-ZOBOKLAS.mjs';
+import { pairBoxShadowLayers, resolveBoxShadowInput } from './chunk-HPJMIBBK.mjs';
+export { Presence, TRANSPARENT, createMotionComponent, usePresence } from './chunk-HPJMIBBK.mjs';
 import { useShouldReduceMotion, resolveNamedTransition, useNamedTransitions, lookupNamedTransition } from './chunk-Z3HCJ43H.mjs';
 export { MotionConfig, resolveNamedTransition, useMotionConfig, useNamedTransitions, useShouldReduceMotion } from './chunk-Z3HCJ43H.mjs';
 import { stableSig, resolveTransition, springToReanimated, warnNonWorkletOnce } from './chunk-REYL77RE.mjs';
@@ -25,7 +27,8 @@ var Motion = {
   Text: MotionText,
   Image: MotionImage,
   Pressable: MotionPressable,
-  ScrollView: MotionScrollView
+  ScrollView: MotionScrollView,
+  FlatList: MotionFlatList
 };
 function useAnimation(target, transition) {
   const output = useSharedValue(target);

package/dist/motion/FlatList.d.mts

@@ -0,0 +1,53 @@
+import { FlatListProps, FlatList } from 'react-native';
+import { V as VariantsMap, a as MotionProps } from '../types-DyJpG64F.mjs';
+import 'react';
+
+/**
+ * Animatable, virtualized `FlatList`.
+ *
+ * Built on Reanimated's `Animated.FlatList` rather than RN's `FlatList`. That
+ * wrapper supplies two things this primitive would otherwise have to
+ * re-implement: the `CellRendererComponent` injection that powers per-row
+ * `itemLayoutAnimation`, and a `scrollEventThrottle` default of 1.
+ *
+ * A note on that throttle default, because the reasoning is easy to get wrong
+ * from Reanimated's own source comment: it says RN defaults FlatList's
+ * `scrollEventThrottle` to 50, which **is stale**. On RN 0.81
+ * (`@react-native/virtualized-lists`, `VirtualizedList.js`) the default is
+ * `props.scrollEventThrottle ?? 0.0001` — effectively every frame. So the
+ * patch is belt-and-braces on current RN rather than the load-bearing reason
+ * to use the wrapper. It is still worth inheriting: it costs nothing, and it
+ * pins the behaviour if RN's default changes again. **Do not restate the "50"
+ * figure as fact** — verify against the installed RN before relying on it.
+ *
+ * This is the primitive that lets one list both virtualize and animate. The
+ * `useScroll()` handler works because `Motion.*` components are Reanimated
+ * animated components — the same mechanism `Motion.ScrollView` relies on, and
+ * nothing about it was ever specific to `ScrollView`:
+ *
+ * ```tsx
+ * const { scrollY, onScroll } = useScroll()
+ *
+ * <Motion.FlatList
+ *   data={items}
+ *   renderItem={renderItem}
+ *   onScroll={onScroll}
+ *   initial={{ opacity: 0 }}
+ *   animate={{ opacity: 1 }}
+ * />
+ * ```
+ *
+ * Two scoping notes:
+ *
+ * - `animate` / `initial` / `gesture` apply to the **scroll container**, not to
+ *   rows. Animate rows by using a `Motion.*` primitive inside `renderItem`.
+ * - The `layout` prop animates the list frame. Per-row layout animation is
+ *   Reanimated's `itemLayoutAnimation`, which is forwarded through untouched.
+ *   Note that row-level layout animation can fight the list's own measurement
+ *   passes — measure before adopting it.
+ */
+declare const MotionFlatList: <ItemT = any, V extends VariantsMap<FlatListProps<ItemT>> = VariantsMap<FlatListProps<ItemT>>>(props: FlatListProps<ItemT> & MotionProps<FlatListProps<ItemT>, V> & {
+    ref?: React.Ref<FlatList<ItemT>>;
+}) => React.ReactElement;
+
+export { MotionFlatList };