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

package/dist/index.js

@@ -1,41 +1,41 @@
 'use strict';
 
-var chunkQ6ZTMLTI_js = require('./chunk-Q6ZTMLTI.js');
-var chunkSCTX5Z7I_js = require('./chunk-SCTX5Z7I.js');
-var chunkWZGMAXKC_js = require('./chunk-WZGMAXKC.js');
-var chunkNDKVHL3N_js = require('./chunk-NDKVHL3N.js');
-var chunkOM5FXU4I_js = require('./chunk-OM5FXU4I.js');
-var chunk5I3G43XA_js = require('./chunk-5I3G43XA.js');
-var chunk6UQ4KA6V_js = require('./chunk-6UQ4KA6V.js');
-var chunk6EP3S2PN_js = require('./chunk-6EP3S2PN.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: chunkSCTX5Z7I_js.MotionView,
-  Text: chunkWZGMAXKC_js.MotionText,
-  Image: chunkNDKVHL3N_js.MotionImage,
-  Pressable: chunkOM5FXU4I_js.MotionPressable,
-  ScrollView: chunk5I3G43XA_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 = chunk6EP3S2PN_js.useShouldReduceMotion();
-  const resolved = chunk6EP3S2PN_js.resolveNamedTransition(transition, chunk6EP3S2PN_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, chunk6EP3S2PN_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 = chunk6EP3S2PN_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 chunkQ6ZTMLTI_js.useGesture; }
+  get: function () { return chunk4PEHWDAZ_js.useGesture; }
 });
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkSCTX5Z7I_js.MotionView; }
+  get: function () { return chunk4QGXK6TF_js.MotionView; }
 });
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkWZGMAXKC_js.MotionText; }
+  get: function () { return chunkZ7HIOFKQ_js.MotionText; }
 });
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunkNDKVHL3N_js.MotionImage; }
+  get: function () { return chunk3UTJJ4A3_js.MotionImage; }
 });
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunkOM5FXU4I_js.MotionPressable; }
+  get: function () { return chunkTDSO63CJ_js.MotionPressable; }
 });
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunk5I3G43XA_js.MotionScrollView; }
+  get: function () { return chunk2HYD2ZBK_js.MotionScrollView; }
 });
 Object.defineProperty(exports, "Presence", {
   enumerable: true,
-  get: function () { return chunk6UQ4KA6V_js.Presence; }
+  get: function () { return chunk7UDYEFBU_js.Presence; }
 });
 Object.defineProperty(exports, "createMotionComponent", {
   enumerable: true,
-  get: function () { return chunk6UQ4KA6V_js.createMotionComponent; }
+  get: function () { return chunk7UDYEFBU_js.createMotionComponent; }
 });
 Object.defineProperty(exports, "usePresence", {
   enumerable: true,
-  get: function () { return chunk6UQ4KA6V_js.usePresence; }
+  get: function () { return chunk7UDYEFBU_js.usePresence; }
 });
 Object.defineProperty(exports, "MotionConfig", {
   enumerable: true,
-  get: function () { return chunk6EP3S2PN_js.MotionConfig; }
+  get: function () { return chunk7AOERN53_js.MotionConfig; }
 });
 Object.defineProperty(exports, "resolveNamedTransition", {
   enumerable: true,
-  get: function () { return chunk6EP3S2PN_js.resolveNamedTransition; }
+  get: function () { return chunk7AOERN53_js.resolveNamedTransition; }
 });
 Object.defineProperty(exports, "useMotionConfig", {
   enumerable: true,
-  get: function () { return chunk6EP3S2PN_js.useMotionConfig; }
+  get: function () { return chunk7AOERN53_js.useMotionConfig; }
 });
 Object.defineProperty(exports, "useNamedTransitions", {
   enumerable: true,
-  get: function () { return chunk6EP3S2PN_js.useNamedTransitions; }
+  get: function () { return chunk7AOERN53_js.useNamedTransitions; }
 });
 Object.defineProperty(exports, "useShouldReduceMotion", {
   enumerable: true,
-  get: function () { return chunk6EP3S2PN_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-ZQUCQRZT.mjs';
-import { MotionView } from './chunk-WPPLZNM4.mjs';
-export { MotionView } from './chunk-WPPLZNM4.mjs';
-import { MotionText } from './chunk-IJNVUM5U.mjs';
-export { MotionText } from './chunk-IJNVUM5U.mjs';
-import { MotionImage } from './chunk-K4KR5BIS.mjs';
-export { MotionImage } from './chunk-K4KR5BIS.mjs';
-import { MotionPressable } from './chunk-OBE7KTMK.mjs';
-export { MotionPressable } from './chunk-OBE7KTMK.mjs';
-import { MotionScrollView } from './chunk-QQJSBIXV.mjs';
-export { MotionScrollView } from './chunk-QQJSBIXV.mjs';
-export { Presence, createMotionComponent, usePresence } from './chunk-I76OC6RX.mjs';
-import { useShouldReduceMotion, resolveNamedTransition, useNamedTransitions, lookupNamedTransition } from './chunk-L2EVRKSC.mjs';
-export { MotionConfig, resolveNamedTransition, useMotionConfig, useNamedTransitions, useShouldReduceMotion } from './chunk-L2EVRKSC.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 chunkNDKVHL3N_js = require('../chunk-NDKVHL3N.js');
-require('../chunk-6UQ4KA6V.js');
-require('../chunk-6EP3S2PN.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 chunkNDKVHL3N_js.MotionImage; }
+  get: function () { return chunk3UTJJ4A3_js.MotionImage; }
 });

package/dist/motion/Image.mjs

@@ -1,4 +1,4 @@
-export { MotionImage } from '../chunk-K4KR5BIS.mjs';
-import '../chunk-I76OC6RX.mjs';
-import '../chunk-L2EVRKSC.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 chunkOM5FXU4I_js = require('../chunk-OM5FXU4I.js');
-require('../chunk-6UQ4KA6V.js');
-require('../chunk-6EP3S2PN.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 chunkOM5FXU4I_js.MotionPressable; }
+  get: function () { return chunkTDSO63CJ_js.MotionPressable; }
 });

package/dist/motion/Pressable.mjs

@@ -1,4 +1,4 @@
-export { MotionPressable } from '../chunk-OBE7KTMK.mjs';
-import '../chunk-I76OC6RX.mjs';
-import '../chunk-L2EVRKSC.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 chunk5I3G43XA_js = require('../chunk-5I3G43XA.js');
-require('../chunk-6UQ4KA6V.js');
-require('../chunk-6EP3S2PN.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 chunk5I3G43XA_js.MotionScrollView; }
+  get: function () { return chunk2HYD2ZBK_js.MotionScrollView; }
 });

package/dist/motion/ScrollView.mjs

@@ -1,4 +1,4 @@
-export { MotionScrollView } from '../chunk-QQJSBIXV.mjs';
-import '../chunk-I76OC6RX.mjs';
-import '../chunk-L2EVRKSC.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 chunkWZGMAXKC_js = require('../chunk-WZGMAXKC.js');
-require('../chunk-6UQ4KA6V.js');
-require('../chunk-6EP3S2PN.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 chunkWZGMAXKC_js.MotionText; }
+  get: function () { return chunkZ7HIOFKQ_js.MotionText; }
 });

package/dist/motion/Text.mjs

@@ -1,4 +1,4 @@
-export { MotionText } from '../chunk-IJNVUM5U.mjs';
-import '../chunk-I76OC6RX.mjs';
-import '../chunk-L2EVRKSC.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 chunkSCTX5Z7I_js = require('../chunk-SCTX5Z7I.js');
-require('../chunk-6UQ4KA6V.js');
-require('../chunk-6EP3S2PN.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 chunkSCTX5Z7I_js.MotionView; }
+  get: function () { return chunk4QGXK6TF_js.MotionView; }
 });

package/dist/motion/View.mjs

@@ -1,4 +1,4 @@
-export { MotionView } from '../chunk-WPPLZNM4.mjs';
-import '../chunk-I76OC6RX.mjs';
-import '../chunk-L2EVRKSC.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.4",
+  "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/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)

package/src/values/useTransform.ts

@@ -10,6 +10,7 @@ import {
 // `react-native-worklets` is a required peer of Reanimated 4, so the direct
 // import is always available wherever Inertia is.
 import { isWorkletFunction } from 'react-native-worklets'
+import { warnNonWorkletOnce } from '../internal/nonWorkletWarning'
 
 /**
  * Extrapolation behavior at the edges of the input range. Mirrors
@@ -36,9 +37,17 @@ export interface UseTransformOptions {
  * const distance = useTransform(() => Math.sqrt(x.value ** 2 + y.value ** 2))
  * ```
  *
- * The transformer must be a worklet (or a plain function we auto-wrap —
- * see the easing wrapper for the rationale). It runs on the UI thread on
- * every frame where any read shared value changes.
+ * The transformer MUST be a worklet — put the `'worklet'` directive as its
+ * first statement so the consumer's Babel plugin captures the shared values
+ * it reads as its closure. It runs on the UI thread on every frame where
+ * any read shared value changes.
+ *
+ * A plain function cannot work here, and the hook warns in dev when it gets
+ * one: the best-effort wrapper it falls back to closes over the opaque
+ * function reference, not the shared values read inside it, so Reanimated
+ * can't track them as dependencies — the derived value only refreshes on
+ * React re-renders, and native builds reject the plain function when the
+ * closure crosses to the UI thread.
  */
 export function useTransform<T>(transformer: () => T): SharedValue<T>
 
@@ -80,16 +89,23 @@ export function useTransform<T>(
   // interpolation) is decided once at JS time, never at frame time.
   let producer: () => unknown
   if (typeof arg1 === 'function') {
-    // Transformer overload. The public surface accepts a plain function;
-    // Reanimated 3.9+ requires worklets in nested-derivation contexts, so
-    // we auto-wrap at JS time the same way `ensureWorkletEasing` does.
+    // Transformer overload. Must be a worklet — the directive-wrapped
+    // fallback below is best-effort only (its closure holds the opaque
+    // function, not the shared values read inside it, so dependency
+    // tracking cannot work — see `warnNonWorkletOnce`).
     const userFn = arg1 as () => T
-    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 — 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 {
     // Interpolation overload. We pre-resolve everything JS-side so the
     // worklet body only consumes flat values.

package/dist/chunk-NDKVHL3N.js

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

package/dist/chunk-SCTX5Z7I.js

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