@rootnative/inertia 0.0.0-alpha.3 → 0.0.0-alpha.5

package/dist/index.js

@@ -1,41 +1,41 @@
 'use strict';
 
-var chunkK7ICHCTZ_js = require('./chunk-K7ICHCTZ.js');
-var chunkNJYRN3WG_js = require('./chunk-NJYRN3WG.js');
-var chunkUMFBAFZP_js = require('./chunk-UMFBAFZP.js');
-var chunkR3ODWDTI_js = require('./chunk-R3ODWDTI.js');
-var chunk5RCMIJGZ_js = require('./chunk-5RCMIJGZ.js');
-var chunkS4AEU72O_js = require('./chunk-S4AEU72O.js');
-var chunkKVSJWO5X_js = require('./chunk-KVSJWO5X.js');
-var chunkJWHKMNYA_js = require('./chunk-JWHKMNYA.js');
-var chunkSFRNO6AW_js = require('./chunk-SFRNO6AW.js');
+var chunk4PEHWDAZ_js = require('./chunk-4PEHWDAZ.js');
+var chunk4QGXK6TF_js = require('./chunk-4QGXK6TF.js');
+var chunkZ7HIOFKQ_js = require('./chunk-Z7HIOFKQ.js');
+var chunk3UTJJ4A3_js = require('./chunk-3UTJJ4A3.js');
+var chunkTDSO63CJ_js = require('./chunk-TDSO63CJ.js');
+var chunk2HYD2ZBK_js = require('./chunk-2HYD2ZBK.js');
+var chunk7UDYEFBU_js = require('./chunk-7UDYEFBU.js');
+var chunk7AOERN53_js = require('./chunk-7AOERN53.js');
+var chunkPTRF47DA_js = require('./chunk-PTRF47DA.js');
 var react = require('react');
 var reactNativeReanimated = require('react-native-reanimated');
 var reactNativeWorklets = require('react-native-worklets');
 
 // src/motion/index.ts
 var Motion = {
-  View: chunkNJYRN3WG_js.MotionView,
-  Text: chunkUMFBAFZP_js.MotionText,
-  Image: chunkR3ODWDTI_js.MotionImage,
-  Pressable: chunk5RCMIJGZ_js.MotionPressable,
-  ScrollView: chunkS4AEU72O_js.MotionScrollView
+  View: chunk4QGXK6TF_js.MotionView,
+  Text: chunkZ7HIOFKQ_js.MotionText,
+  Image: chunk3UTJJ4A3_js.MotionImage,
+  Pressable: chunkTDSO63CJ_js.MotionPressable,
+  ScrollView: chunk2HYD2ZBK_js.MotionScrollView
 };
 function useAnimation(target, transition) {
   const output = reactNativeReanimated.useSharedValue(target);
-  const shouldReduceMotion = chunkJWHKMNYA_js.useShouldReduceMotion();
-  const resolved = chunkJWHKMNYA_js.resolveNamedTransition(transition, chunkJWHKMNYA_js.useNamedTransitions());
-  const cfgSig = chunkSFRNO6AW_js.stableSig(resolved);
+  const shouldReduceMotion = chunk7AOERN53_js.useShouldReduceMotion();
+  const resolved = chunk7AOERN53_js.resolveNamedTransition(transition, chunk7AOERN53_js.useNamedTransitions());
+  const cfgSig = chunkPTRF47DA_js.stableSig(resolved);
   react.useEffect(() => {
     const cfg = shouldReduceMotion ? { type: "no-animation" } : resolved ?? { type: "spring" };
-    output.value = chunkSFRNO6AW_js.resolveTransition(cfg, target);
+    output.value = chunkPTRF47DA_js.resolveTransition(cfg, target);
   }, [target, cfgSig, shouldReduceMotion]);
   return output;
 }
 function useSpring(target, config) {
-  const spring = resolveSpringInput(config, chunkJWHKMNYA_js.useNamedTransitions());
+  const spring = resolveSpringInput(config, chunk7AOERN53_js.useNamedTransitions());
   const reanimConfig = react.useMemo(
-    () => chunkSFRNO6AW_js.springToReanimated(spring ?? {}),
+    () => chunkPTRF47DA_js.springToReanimated(spring ?? {}),
     // Keyed on the resolved primitive fields rather than the `config` object
     // identity: callers routinely pass a fresh object literal each render, so
     // depending on `config` itself would rebuild the Reanimated config on
@@ -74,7 +74,7 @@ function useSpring(target, config) {
 }
 function resolveSpringInput(config, registry) {
   if (typeof config !== "string") return config;
-  const cfg = chunkJWHKMNYA_js.lookupNamedTransition(config, registry);
+  const cfg = chunk7AOERN53_js.lookupNamedTransition(config, registry);
   if (cfg.type === void 0 || cfg.type === "spring") return cfg;
   if (__DEV__) {
     console.warn(
@@ -107,10 +107,18 @@ function useTransform(arg1, inputRange, outputRange, options) {
   let producer;
   if (typeof arg1 === "function") {
     const userFn = arg1;
-    producer = reactNativeWorklets.isWorkletFunction(userFn) ? userFn : () => {
-      "worklet";
-      return userFn();
-    };
+    if (reactNativeWorklets.isWorkletFunction(userFn)) {
+      producer = userFn;
+    } else {
+      chunkPTRF47DA_js.warnNonWorkletOnce(
+        "useTransform-transformer",
+        "[inertia] useTransform: the transformer is not a worklet, so the shared values it reads can't be tracked as dependencies \u2014 the derived value will only refresh on React re-renders, and native builds reject plain functions on the UI thread. Add the 'worklet' directive as the first statement of the transformer."
+      );
+      producer = () => {
+        "worklet";
+        return userFn();
+      };
+    }
   } else {
     const source = arg1;
     const input = inputRange;
@@ -240,79 +248,79 @@ function useVariants(variants, initial) {
 
 Object.defineProperty(exports, "useGesture", {
   enumerable: true,
-  get: function () { return chunkK7ICHCTZ_js.useGesture; }
+  get: function () { return chunk4PEHWDAZ_js.useGesture; }
 });
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkNJYRN3WG_js.MotionView; }
+  get: function () { return chunk4QGXK6TF_js.MotionView; }
 });
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkUMFBAFZP_js.MotionText; }
+  get: function () { return chunkZ7HIOFKQ_js.MotionText; }
 });
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunkR3ODWDTI_js.MotionImage; }
+  get: function () { return chunk3UTJJ4A3_js.MotionImage; }
 });
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunk5RCMIJGZ_js.MotionPressable; }
+  get: function () { return chunkTDSO63CJ_js.MotionPressable; }
 });
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunkS4AEU72O_js.MotionScrollView; }
+  get: function () { return chunk2HYD2ZBK_js.MotionScrollView; }
 });
 Object.defineProperty(exports, "Presence", {
   enumerable: true,
-  get: function () { return chunkKVSJWO5X_js.Presence; }
+  get: function () { return chunk7UDYEFBU_js.Presence; }
 });
 Object.defineProperty(exports, "createMotionComponent", {
   enumerable: true,
-  get: function () { return chunkKVSJWO5X_js.createMotionComponent; }
+  get: function () { return chunk7UDYEFBU_js.createMotionComponent; }
 });
 Object.defineProperty(exports, "usePresence", {
   enumerable: true,
-  get: function () { return chunkKVSJWO5X_js.usePresence; }
+  get: function () { return chunk7UDYEFBU_js.usePresence; }
 });
 Object.defineProperty(exports, "MotionConfig", {
   enumerable: true,
-  get: function () { return chunkJWHKMNYA_js.MotionConfig; }
+  get: function () { return chunk7AOERN53_js.MotionConfig; }
 });
 Object.defineProperty(exports, "resolveNamedTransition", {
   enumerable: true,
-  get: function () { return chunkJWHKMNYA_js.resolveNamedTransition; }
+  get: function () { return chunk7AOERN53_js.resolveNamedTransition; }
 });
 Object.defineProperty(exports, "useMotionConfig", {
   enumerable: true,
-  get: function () { return chunkJWHKMNYA_js.useMotionConfig; }
+  get: function () { return chunk7AOERN53_js.useMotionConfig; }
 });
 Object.defineProperty(exports, "useNamedTransitions", {
   enumerable: true,
-  get: function () { return chunkJWHKMNYA_js.useNamedTransitions; }
+  get: function () { return chunk7AOERN53_js.useNamedTransitions; }
 });
 Object.defineProperty(exports, "useShouldReduceMotion", {
   enumerable: true,
-  get: function () { return chunkJWHKMNYA_js.useShouldReduceMotion; }
+  get: function () { return chunk7AOERN53_js.useShouldReduceMotion; }
 });
 Object.defineProperty(exports, "buildReleaseAnimation", {
   enumerable: true,
-  get: function () { return chunkSFRNO6AW_js.buildReleaseAnimation; }
+  get: function () { return chunkPTRF47DA_js.buildReleaseAnimation; }
 });
 Object.defineProperty(exports, "cubicBezier", {
   enumerable: true,
-  get: function () { return chunkSFRNO6AW_js.cubicBezier; }
+  get: function () { return chunkPTRF47DA_js.cubicBezier; }
 });
 Object.defineProperty(exports, "ensureWorkletEasing", {
   enumerable: true,
-  get: function () { return chunkSFRNO6AW_js.ensureWorkletEasing; }
+  get: function () { return chunkPTRF47DA_js.ensureWorkletEasing; }
 });
 Object.defineProperty(exports, "resolveAnimatableValue", {
   enumerable: true,
-  get: function () { return chunkSFRNO6AW_js.resolveAnimatableValue; }
+  get: function () { return chunkPTRF47DA_js.resolveAnimatableValue; }
 });
 Object.defineProperty(exports, "resolveTransition", {
   enumerable: true,
-  get: function () { return chunkSFRNO6AW_js.resolveTransition; }
+  get: function () { return chunkPTRF47DA_js.resolveTransition; }
 });
 exports.Motion = Motion;
 exports.useAnimation = useAnimation;

package/dist/index.mjs

@@ -1,19 +1,19 @@
-export { useGesture } from './chunk-W6IS4HAK.mjs';
-import { MotionView } from './chunk-RJNR7CFN.mjs';
-export { MotionView } from './chunk-RJNR7CFN.mjs';
-import { MotionText } from './chunk-FSPQVLBF.mjs';
-export { MotionText } from './chunk-FSPQVLBF.mjs';
-import { MotionImage } from './chunk-UM3WVSKQ.mjs';
-export { MotionImage } from './chunk-UM3WVSKQ.mjs';
-import { MotionPressable } from './chunk-E4MDU4YV.mjs';
-export { MotionPressable } from './chunk-E4MDU4YV.mjs';
-import { MotionScrollView } from './chunk-KARV7QKF.mjs';
-export { MotionScrollView } from './chunk-KARV7QKF.mjs';
-export { Presence, createMotionComponent, usePresence } from './chunk-UXK4YCT6.mjs';
-import { useShouldReduceMotion, resolveNamedTransition, useNamedTransitions, lookupNamedTransition } from './chunk-GJD4VVAS.mjs';
-export { MotionConfig, resolveNamedTransition, useMotionConfig, useNamedTransitions, useShouldReduceMotion } from './chunk-GJD4VVAS.mjs';
-import { stableSig, resolveTransition, springToReanimated } from './chunk-6FENLMCA.mjs';
-export { buildReleaseAnimation, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveTransition } from './chunk-6FENLMCA.mjs';
+export { useGesture } from './chunk-RGNX6UZN.mjs';
+import { MotionView } from './chunk-6SMPIOIC.mjs';
+export { MotionView } from './chunk-6SMPIOIC.mjs';
+import { MotionText } from './chunk-JVBXPF2G.mjs';
+export { MotionText } from './chunk-JVBXPF2G.mjs';
+import { MotionImage } from './chunk-ALRHDFZE.mjs';
+export { MotionImage } from './chunk-ALRHDFZE.mjs';
+import { MotionPressable } from './chunk-NXDJZD6A.mjs';
+export { MotionPressable } from './chunk-NXDJZD6A.mjs';
+import { MotionScrollView } from './chunk-CWLFUYIY.mjs';
+export { MotionScrollView } from './chunk-CWLFUYIY.mjs';
+export { Presence, createMotionComponent, usePresence } from './chunk-DWCLIBYO.mjs';
+import { useShouldReduceMotion, resolveNamedTransition, useNamedTransitions, lookupNamedTransition } from './chunk-R63GIUNU.mjs';
+export { MotionConfig, resolveNamedTransition, useMotionConfig, useNamedTransitions, useShouldReduceMotion } from './chunk-R63GIUNU.mjs';
+import { stableSig, resolveTransition, springToReanimated, warnNonWorkletOnce } from './chunk-CY7Y64C3.mjs';
+export { buildReleaseAnimation, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveTransition } from './chunk-CY7Y64C3.mjs';
 import { useEffect, useMemo, useRef } from 'react';
 import { useSharedValue, withSpring, useAnimatedReaction, useAnimatedStyle, interpolateColor, useDerivedValue, Extrapolation, useAnimatedScrollHandler, interpolate } from 'react-native-reanimated';
 import { isWorkletFunction } from 'react-native-worklets';
@@ -112,10 +112,18 @@ function useTransform(arg1, inputRange, outputRange, options) {
   let producer;
   if (typeof arg1 === "function") {
     const userFn = arg1;
-    producer = isWorkletFunction(userFn) ? userFn : () => {
-      "worklet";
-      return userFn();
-    };
+    if (isWorkletFunction(userFn)) {
+      producer = userFn;
+    } else {
+      warnNonWorkletOnce(
+        "useTransform-transformer",
+        "[inertia] useTransform: the transformer is not a worklet, so the shared values it reads can't be tracked as dependencies \u2014 the derived value will only refresh on React re-renders, and native builds reject plain functions on the UI thread. Add the 'worklet' directive as the first statement of the transformer."
+      );
+      producer = () => {
+        "worklet";
+        return userFn();
+      };
+    }
   } else {
     const source = arg1;
     const input = inputRange;

package/dist/motion/Image.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkR3ODWDTI_js = require('../chunk-R3ODWDTI.js');
-require('../chunk-KVSJWO5X.js');
-require('../chunk-JWHKMNYA.js');
-require('../chunk-SFRNO6AW.js');
+var chunk3UTJJ4A3_js = require('../chunk-3UTJJ4A3.js');
+require('../chunk-7UDYEFBU.js');
+require('../chunk-7AOERN53.js');
+require('../chunk-PTRF47DA.js');
 
 
 
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunkR3ODWDTI_js.MotionImage; }
+  get: function () { return chunk3UTJJ4A3_js.MotionImage; }
 });

package/dist/motion/Image.mjs

@@ -1,4 +1,4 @@
-export { MotionImage } from '../chunk-UM3WVSKQ.mjs';
-import '../chunk-UXK4YCT6.mjs';
-import '../chunk-GJD4VVAS.mjs';
-import '../chunk-6FENLMCA.mjs';
+export { MotionImage } from '../chunk-ALRHDFZE.mjs';
+import '../chunk-DWCLIBYO.mjs';
+import '../chunk-R63GIUNU.mjs';
+import '../chunk-CY7Y64C3.mjs';

package/dist/motion/Pressable.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk5RCMIJGZ_js = require('../chunk-5RCMIJGZ.js');
-require('../chunk-KVSJWO5X.js');
-require('../chunk-JWHKMNYA.js');
-require('../chunk-SFRNO6AW.js');
+var chunkTDSO63CJ_js = require('../chunk-TDSO63CJ.js');
+require('../chunk-7UDYEFBU.js');
+require('../chunk-7AOERN53.js');
+require('../chunk-PTRF47DA.js');
 
 
 
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunk5RCMIJGZ_js.MotionPressable; }
+  get: function () { return chunkTDSO63CJ_js.MotionPressable; }
 });

package/dist/motion/Pressable.mjs

@@ -1,4 +1,4 @@
-export { MotionPressable } from '../chunk-E4MDU4YV.mjs';
-import '../chunk-UXK4YCT6.mjs';
-import '../chunk-GJD4VVAS.mjs';
-import '../chunk-6FENLMCA.mjs';
+export { MotionPressable } from '../chunk-NXDJZD6A.mjs';
+import '../chunk-DWCLIBYO.mjs';
+import '../chunk-R63GIUNU.mjs';
+import '../chunk-CY7Y64C3.mjs';

package/dist/motion/ScrollView.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkS4AEU72O_js = require('../chunk-S4AEU72O.js');
-require('../chunk-KVSJWO5X.js');
-require('../chunk-JWHKMNYA.js');
-require('../chunk-SFRNO6AW.js');
+var chunk2HYD2ZBK_js = require('../chunk-2HYD2ZBK.js');
+require('../chunk-7UDYEFBU.js');
+require('../chunk-7AOERN53.js');
+require('../chunk-PTRF47DA.js');
 
 
 
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunkS4AEU72O_js.MotionScrollView; }
+  get: function () { return chunk2HYD2ZBK_js.MotionScrollView; }
 });

package/dist/motion/ScrollView.mjs

@@ -1,4 +1,4 @@
-export { MotionScrollView } from '../chunk-KARV7QKF.mjs';
-import '../chunk-UXK4YCT6.mjs';
-import '../chunk-GJD4VVAS.mjs';
-import '../chunk-6FENLMCA.mjs';
+export { MotionScrollView } from '../chunk-CWLFUYIY.mjs';
+import '../chunk-DWCLIBYO.mjs';
+import '../chunk-R63GIUNU.mjs';
+import '../chunk-CY7Y64C3.mjs';

package/dist/motion/Text.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkUMFBAFZP_js = require('../chunk-UMFBAFZP.js');
-require('../chunk-KVSJWO5X.js');
-require('../chunk-JWHKMNYA.js');
-require('../chunk-SFRNO6AW.js');
+var chunkZ7HIOFKQ_js = require('../chunk-Z7HIOFKQ.js');
+require('../chunk-7UDYEFBU.js');
+require('../chunk-7AOERN53.js');
+require('../chunk-PTRF47DA.js');
 
 
 
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkUMFBAFZP_js.MotionText; }
+  get: function () { return chunkZ7HIOFKQ_js.MotionText; }
 });

package/dist/motion/Text.mjs

@@ -1,4 +1,4 @@
-export { MotionText } from '../chunk-FSPQVLBF.mjs';
-import '../chunk-UXK4YCT6.mjs';
-import '../chunk-GJD4VVAS.mjs';
-import '../chunk-6FENLMCA.mjs';
+export { MotionText } from '../chunk-JVBXPF2G.mjs';
+import '../chunk-DWCLIBYO.mjs';
+import '../chunk-R63GIUNU.mjs';
+import '../chunk-CY7Y64C3.mjs';

package/dist/motion/View.js

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkNJYRN3WG_js = require('../chunk-NJYRN3WG.js');
-require('../chunk-KVSJWO5X.js');
-require('../chunk-JWHKMNYA.js');
-require('../chunk-SFRNO6AW.js');
+var chunk4QGXK6TF_js = require('../chunk-4QGXK6TF.js');
+require('../chunk-7UDYEFBU.js');
+require('../chunk-7AOERN53.js');
+require('../chunk-PTRF47DA.js');
 
 
 
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkNJYRN3WG_js.MotionView; }
+  get: function () { return chunk4QGXK6TF_js.MotionView; }
 });

package/dist/motion/View.mjs

@@ -1,4 +1,4 @@
-export { MotionView } from '../chunk-RJNR7CFN.mjs';
-import '../chunk-UXK4YCT6.mjs';
-import '../chunk-GJD4VVAS.mjs';
-import '../chunk-6FENLMCA.mjs';
+export { MotionView } from '../chunk-6SMPIOIC.mjs';
+import '../chunk-DWCLIBYO.mjs';
+import '../chunk-R63GIUNU.mjs';
+import '../chunk-CY7Y64C3.mjs';

package/dist/touch/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkSFRNO6AW_js = require('../chunk-SFRNO6AW.js');
+var chunkPTRF47DA_js = require('../chunk-PTRF47DA.js');
 var react = require('react');
 var reactNative = require('react-native');
 var reactNativeReanimated = require('react-native-reanimated');
@@ -48,14 +48,14 @@ function useTouchDrag(options = {}) {
         if (result) {
           if (result.x && lockX) {
             const toX = "to" in result.x ? result.x.to : x;
-            dragX.value = chunkSFRNO6AW_js.buildReleaseAnimation(
+            dragX.value = chunkPTRF47DA_js.buildReleaseAnimation(
               result.x,
               toX
             );
           }
           if (result.y && lockY) {
             const toY = "to" in result.y ? result.y.to : y;
-            dragY.value = chunkSFRNO6AW_js.buildReleaseAnimation(
+            dragY.value = chunkPTRF47DA_js.buildReleaseAnimation(
               result.y,
               toY
             );

package/dist/touch/index.mjs

@@ -1,4 +1,4 @@
-import { buildReleaseAnimation } from '../chunk-6FENLMCA.mjs';
+import { buildReleaseAnimation } from '../chunk-CY7Y64C3.mjs';
 import { useMemo } from 'react';
 import { PanResponder } from 'react-native';
 import { useSharedValue, useAnimatedStyle } from 'react-native-reanimated';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rootnative/inertia",
-  "version": "0.0.0-alpha.3",
+  "version": "0.0.0-alpha.5",
   "description": "Declarative animation primitives for React Native, built on react-native-reanimated.",
   "license": "MIT",
   "author": "RootNative",
@@ -142,7 +142,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
     "test": "jest",
     "size": "size-limit",
     "size:why": "size-limit --why",

package/src/gestures/focusVisibility.ts

@@ -12,10 +12,15 @@ import { Platform } from 'react-native'
  * arrives via D-pad, screen reader, or hardware keyboard, all of which are
  * keyboard-equivalent — so `isFocusVisible()` is unconditionally `true`.
  *
- * The web listeners attach lazily on first call (capture phase, so they run
- * before the focus event reaches the focused element) and stay installed for
- * the lifetime of the document. They are passive and idle-cheap; the cost is
- * one boolean read per `onFocus` dispatch.
+ * The web listeners attach eagerly at module import (capture phase, so they
+ * run before the focus event reaches the focused element) and stay installed
+ * for the lifetime of the document. Eager installation matters: the very
+ * first interaction with a page can be the mouse click that focuses a
+ * gesture-wired element, and if the listeners only attached during that
+ * focus dispatch the mousedown would already have passed unobserved —
+ * leaving the default `'keyboard'` modality and drawing a focus ring for a
+ * pointer interaction. They are passive and idle-cheap; the cost is one
+ * boolean read per `onFocus` dispatch.
  */
 
 type InputModality = 'keyboard' | 'pointer'
@@ -44,6 +49,12 @@ function ensureInstalled(): void {
   installed = true
 }
 
+// Install at import time so the pointer event that precedes the first focus
+// is observed (see module doc above). `ensureInstalled` stays in
+// `isFocusVisible` as a safety net for environments where `document` appears
+// after import.
+ensureInstalled()
+
 /**
  * `true` if the next `onFocus` should be treated as "focus-visible" (keyboard
  * focus). On native, always `true`. On web, reflects the most recent user

package/src/internal/nonWorkletWarning.ts

@@ -0,0 +1,41 @@
+declare const __DEV__: boolean
+
+// The core package intentionally has no Node types — declare the minimal
+// shape needed for the Jest detection below (guarded by a typeof check, so
+// environments without `process` are fine).
+declare const process: { env?: Record<string, string | undefined> } | undefined
+
+const warned = new Set<string>()
+
+/**
+ * Dev-only, once-per-key warning for plain (non-worklet) functions handed to
+ * surfaces that need real worklets — `useTransform` transformers and custom
+ * `timing.easing` functions.
+ *
+ * Why this can't be papered over with an auto-wrap: wrapping a plain
+ * function in a `'worklet'`-directive closure captures the *function
+ * reference*, not the shared values it reads. Even when the consumer's
+ * Babel plugin workletizes the wrapper, its `__closure` contains only the
+ * opaque JS function — Reanimated cannot extract the shared values read
+ * inside it as dependencies (so derived values never refresh), and native
+ * builds reject the plain function when the closure is serialized to the UI
+ * thread. The only correct authoring is the `'worklet'` directive on the
+ * consumer's own function, where *their* Babel pass captures the real
+ * closure.
+ *
+ * Suppressed under Jest: the shared Reanimated/worklets test stubs report
+ * every function as non-worklet, which would turn the warning into noise in
+ * every consumer's test suite.
+ */
+export function warnNonWorkletOnce(key: string, message: string): void {
+  if (!__DEV__) return
+  if (typeof process !== 'undefined' && process.env?.JEST_WORKER_ID) return
+  if (warned.has(key)) return
+  warned.add(key)
+  console.warn(message)
+}
+
+/** @internal — test-only hook to reset the once-per-key state. */
+export function __resetNonWorkletWarningsForTests(): void {
+  warned.clear()
+}

package/src/layout/resolveLayout.ts

@@ -13,8 +13,9 @@ export type LayoutProp = boolean | TransitionConfig | undefined
  * - `true` → default spring with the library's tuned tension / friction / mass.
  * - `{ type: 'spring', ... }` → spring with react-spring vocabulary, bridged
  *   into `springify().damping().stiffness().mass()` via `springToReanimated`.
- * - `{ type: 'timing', ... }` → `.duration().easing()`. User easing fns are
- *   auto-wrapped as worklets (Reanimated 3.9+ validates this).
+ * - `{ type: 'timing', ... }` → `.duration().easing()`. Custom easing fns
+ *   must be worklets (Reanimated 3.9+ validates this); plain functions
+ *   dev-warn via `ensureWorkletEasing`.
  * - `{ type: 'decay', ... }` → silently downgrades to spring; decay doesn't
  *   have a clear target for a layout transition.
  *

package/src/transitions/easing.ts

@@ -1,20 +1,21 @@
 // `isWorkletFunction` lives in `react-native-worklets` (the Reanimated 4 peer
 // dep); Reanimated's own re-export is deprecated.
 import { isWorkletFunction } from 'react-native-worklets'
+import { warnNonWorkletOnce } from '../internal/nonWorkletWarning'
 import { type EasingInput } from '../types'
 
 /**
  * Reanimated 3.9+ validates that easing functions used in nested-transition
  * contexts (variants, sequences, per-property maps) are worklets, and crashes
- * with `[Reanimated] The easing function is not a worklet` otherwise. The
- * library accepts plain functions on the public surface; this helper wraps
- * them so consumers don't have to think about the worklet boundary.
+ * with `[Reanimated] The easing function is not a worklet` otherwise.
  *
- * If the input is already a worklet (has been processed by the worklets babel
- * plugin), it's returned as-is. Otherwise it's wrapped in a function whose
- * body declares the `'worklet'` directive — when our source is processed by
- * the consumer's worklets babel plugin (the default Expo/RN setup), the
- * wrapper becomes a real worklet that captures the user fn via closure.
+ * Custom easing functions MUST therefore be worklets — put the `'worklet'`
+ * directive as the function's first statement (Reanimated's built-in
+ * `Easing.*` helpers and inertia's `cubicBezier()` already are). A plain
+ * function warns in dev and falls back to a directive-wrapped call-through;
+ * that wrapper works on web (single-threaded) but its closure holds the
+ * opaque plain function, which native builds reject when the transition's
+ * config is serialized to the UI thread.
  *
  * Reanimated 4 changed `Easing.bezier(...)` to return an
  * `EasingFunctionFactory` (`{ factory: () => EasingFunction }`) rather than
@@ -34,6 +35,10 @@ export function ensureWorkletEasing(
   // ends up in the transition config.
   const fn = isEasingFactory(easing) ? easing.factory() : easing
   if (isWorkletFunction(fn)) return fn
+  warnNonWorkletOnce(
+    'timing-easing',
+    "[inertia] timing easing: the provided easing function is not a worklet. The fallback wrapper works on web but native builds reject it when the transition runs on the UI thread. Add the 'worklet' directive as the first statement of the easing function, or use Reanimated's Easing.* helpers / inertia's cubicBezier(), which are already worklets.",
+  )
   const wrapped = (t: number) => {
     'worklet'
     return fn(t)