@rootnative/inertia 0.0.6 → 0.0.8

package/src/transitions/runtime.ts

@@ -5,6 +5,7 @@ import {
   withTiming,
 } from 'react-native-reanimated'
 import { springToReanimated } from './spring'
+import { type AnimationCallback } from './resolve'
 import { type TransitionConfig } from '../types'
 
 const DEFAULT_TIMING_DURATION = 250
@@ -26,13 +27,23 @@ const DEFAULT_TIMING_DURATION = 250
  *
  * For decay transitions, `toValue` is ignored — decay decelerates from the
  * SV's current position via its own physics. Pass `0` if you don't have one.
+ *
+ * `callback`, when provided, fires once when the animation settles — the same
+ * `(finished) => void` shape Reanimated's `with*` factories accept. It runs on
+ * the UI thread, so bridge to JS with `runOnJS(...)` inside it. For
+ * `no-animation` the callback fires synchronously with `finished: true`, since
+ * a direct assignment has no settle point of its own.
  */
 export function buildReleaseAnimation(
   transition: TransitionConfig,
   toValue: number,
+  callback?: AnimationCallback,
 ): unknown {
   'worklet'
-  if (transition.type === 'no-animation') return toValue
+  if (transition.type === 'no-animation') {
+    if (callback) callback(true, toValue)
+    return toValue
+  }
   if (transition.type === 'decay') {
     const cfg: {
       velocity: number
@@ -43,7 +54,7 @@ export function buildReleaseAnimation(
       cfg.deceleration = transition.deceleration
     }
     if (transition.clamp !== undefined) cfg.clamp = transition.clamp
-    return withDecay(cfg)
+    return withDecay(cfg, callback as never)
   }
   if (transition.type === 'timing') {
     // Reanimated 4's `Easing.bezier(...)` returns an `EasingFunctionFactory`
@@ -54,10 +65,14 @@ export function buildReleaseAnimation(
       e && typeof e === 'object' && 'factory' in e
         ? e.factory()
         : (e ?? Easing.inOut(Easing.ease))
-    return withTiming(toValue, {
-      duration: transition.duration ?? DEFAULT_TIMING_DURATION,
-      easing: easingFn,
-    })
+    return withTiming(
+      toValue,
+      {
+        duration: transition.duration ?? DEFAULT_TIMING_DURATION,
+        easing: easingFn,
+      },
+      callback as never,
+    )
   }
-  return withSpring(toValue, springToReanimated(transition))
+  return withSpring(toValue, springToReanimated(transition), callback as never)
 }

package/src/values/useScroll.ts

@@ -11,10 +11,10 @@ export 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
 }
@@ -47,9 +47,13 @@ export 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.
  */
 export function useScroll(): UseScrollResult {
   const scrollX = useSharedValue(0)

package/dist/chunk-FWWVHLXB.js

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

package/dist/chunk-K5SI6VXS.js

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

package/dist/chunk-STARIT6W.js

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