@rootnative/inertia 0.0.9 → 0.0.11

package/dist/gestureLayer/index.mjs

@@ -1,6 +1,6 @@
-import { useGesture } from '../chunk-L4JFECXU.mjs';
-import { useShouldReduceMotion, resolveNamedTransitionProp, useNamedTransitions } from '../chunk-MFAFB4K7.mjs';
-import { stableSig, resolveTransition, isTopLevelTransition } from '../chunk-W7NTRSPD.mjs';
+import { useGesture } from '../chunk-FKJLPYGY.mjs';
+import { useShouldReduceMotion, resolveNamedTransitionProp, useNamedTransitions } from '../chunk-2Q6JMDYZ.mjs';
+import { stableSig, resolveTransition, isTopLevelTransition } from '../chunk-QIRKPDXA.mjs';
 import { useEffect, useMemo } from 'react';
 import { useSharedValue, useAnimatedStyle, interpolateColor } from 'react-native-reanimated';
 
@@ -19,6 +19,7 @@ function useGestureLayer(states, options = {}) {
     const cfg = shouldReduceMotion ? { type: "no-animation" } : disabledTransition(transition) ?? { type: "spring" };
     disabledProgress.value = resolveTransition(cfg, target);
   }, [isDisabled, shouldReduceMotion, transitionSig, disabledProgress]);
+  const statesSig = stableSig(states);
   const meta = useMemo(() => {
     const layers = {
       rest: states.rest,
@@ -58,14 +59,7 @@ function useGestureLayer(states, options = {}) {
       restValues[k] = restRaw !== void 0 ? restRaw : isColor ? "transparent" : 0;
     }
     return { layers, keys, types, restValues };
-  }, [
-    states.rest,
-    states.hovered,
-    states.focused,
-    states.focusVisible,
-    states.pressed,
-    states.disabled
-  ]);
+  }, [statesSig]);
   const style = useAnimatedStyle(() => {
     const { layers, keys, types, restValues } = meta;
     const ph = gesture.hovered.value;

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 { TextStyle, ImageStyle, ViewStyle, NativeSyntheticEvent, NativeScrollEvent } from 'react-native';
-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';
+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-C5Zbs9MC.mjs';
+export { e as AnimateStyle, f as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, g as EasingFunction, h as EasingFunctionFactory, G as GestureLayerTransitions, i as GestureSubStates, j as MotionComponentProps, k as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, l as RepeatConfig, m as SequenceStep, n as TimingTransition, o as Transition } from './types-C5Zbs9MC.mjs';
+export { T as TranslateStyle, a as applyBounds, u as useTranslateStyle } from './useTranslateStyle-BDrOD97O.mjs';
+import { SharedValue } from 'react-native-reanimated';
 export { SharedValue } from 'react-native-reanimated';
-export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-CnZQnYHH.mjs';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-Ve8EGjTr.mjs';
 export { MotionFlatList } from './motion/FlatList.mjs';
 export { MotionImage } from './motion/Image.mjs';
 export { MotionPressable } from './motion/Pressable.mjs';
@@ -273,6 +274,12 @@ declare function resolveTransition(config: TransitionConfig | undefined, toValue
  *   3. array of either   → `withSequence` of resolved steps, with the
  *      top-level `repeat` applied at the **sequence level** (not per step).
  *      Per-step `repeat` overrides remain step-local.
+ *
+ * `withSequence` writes a `finished` flag onto each argument it is handed, so
+ * a bare target throws `Cannot create property 'finished' on number` and takes
+ * the whole render down with it. Two paths produce bare targets, and both are
+ * handled below rather than at the call site: reduced motion (every step) and
+ * a per-step `{ type: 'no-animation' }` override (some steps).
  */
 declare function resolveAnimatableValue<V extends number | string>(value: AnimatableValue<V>, base: TransitionConfig | undefined, factory?: CallbackFactory): unknown;
 
@@ -341,6 +348,8 @@ declare function cubicBezier(css: string): EasingInput;
  */
 declare function ensureWorkletEasing(easing: EasingInput | undefined): ((t: number) => number) | undefined;
 
+declare function isTopLevelTransition(t: unknown): t is TransitionConfig;
+
 /**
  * Worklet-safe single-step animation builder. Mirrors a subset of
  * `resolveTransition` for the UI-thread path where the transition config is
@@ -367,6 +376,15 @@ declare function ensureWorkletEasing(easing: EasingInput | undefined): ((t: numb
  */
 declare function buildReleaseAnimation(transition: TransitionConfig, toValue: number, callback?: AnimationCallback): unknown;
 
+/**
+ * Stable string signature for an arbitrary value — used as a dep-array
+ * member so a fresh object literal each render doesn't re-fire an effect
+ * unless something structurally changed. Functions serialize as `null`
+ * (their identity isn't useful in a sig); `undefined` collapses to an empty
+ * string so omitted props compare equal across renders.
+ */
+declare function stableSig(value: unknown): string;
+
 /**
  * The one colour spelling Reanimated's animation drivers cannot accept.
  *
@@ -521,6 +539,22 @@ declare function useBooleanSpring(active: boolean, springConfig?: SpringTransiti
  * returned style fragment is always a legal RN style.
  */
 type ColorStyleKey = 'backgroundColor' | 'color' | 'borderColor' | 'borderTopColor' | 'borderRightColor' | 'borderBottomColor' | 'borderLeftColor' | 'tintColor' | 'shadowColor';
+/**
+ * A one-key colour style fragment, as returned by {@link useColorTransition}
+ * and {@link useColorCascade}.
+ *
+ * Deliberately **not** `ReturnType<typeof useAnimatedStyle>`. Reanimated 4.5
+ * brands that value (`AnimatedStyleHandle`), and a branded type is rejected
+ * inside a `StyleProp` array — so every call site would need a cast, which is
+ * the defect `InterpolatedStyle` was introduced to remove in `0.0.9`. The brand
+ * is compile-time only, so the runtime value is unchanged.
+ *
+ * Optional per key because which slot is filled is chosen at run time from
+ * `options.key`; exactly one is ever present.
+ */
+type ColorStyle = {
+    [K in ColorStyleKey]?: string;
+};
 interface UseColorTransitionOptions {
     /**
      * Which style slot the interpolated color is emitted under. Defaults to
@@ -552,7 +586,7 @@ interface UseColorTransitionOptions {
  * compose into a hand-rolled `useAnimatedStyle`), use `useTransform`
  * directly with a color output range.
  */
-declare function useColorTransition(progress: SharedValue<number>, range: readonly [string, string], options?: UseColorTransitionOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useColorTransition(progress: SharedValue<number>, range: readonly [string, string], options?: UseColorTransitionOptions): ColorStyle;
 
 /**
  * One layer in a color cascade: its own `progress` shared value (0→1) and the
@@ -612,7 +646,7 @@ interface UseColorCascadeOptions {
  * `rest`, the layer count, or **which shared value drives a layer** all rewire
  * the worklet as you'd expect.
  */
-declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ColorStyle;
 
 /**
  * Extrapolation behavior at the edges of the input range. Mirrors
@@ -624,47 +658,6 @@ declare function useColorCascade(rest: string, layers: readonly ColorCascadeLaye
  * - `'extend'` — continue the linear slope beyond the range.
  */
 type ExtrapolationMode = 'clamp' | 'identity' | 'extend';
-interface UseTransformOptions {
-    extrapolateLeft?: ExtrapolationMode;
-    extrapolateRight?: ExtrapolationMode;
-}
-/**
- * Derive a value from one or more shared values via a transformer worklet.
- *
- * ```ts
- * const x = useMotionValue(0)
- * const y = useMotionValue(0)
- * const distance = useTransform(() => Math.sqrt(x.value ** 2 + y.value ** 2))
- * ```
- *
- * 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.
- */
-declare function useTransform<T>(transformer: () => T): SharedValue<T>;
-/**
- * Interpolate a numeric shared value onto a range of numbers or colors.
- *
- * ```ts
- * const scroll = useMotionValue(0)
- * const headerOpacity = useTransform(scroll, [0, 100], [1, 0])
- * const headerColor  = useTransform(scroll, [0, 100], ['#fff', '#000'])
- * ```
- *
- * When `outputRange` is numeric, this maps to Reanimated's `interpolate`;
- * when it's a tuple of color strings, it maps to `interpolateColor`. The
- * input range must be monotonically increasing.
- */
-declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly number[], options?: UseTransformOptions): SharedValue<number>;
-declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly string[], options?: UseTransformOptions): SharedValue<string>;
 
 /**
  * Numeric style keys `useInterpolatedStyle` can emit directly (not lifted into
@@ -813,9 +806,57 @@ declare function useMotionValue<T extends number | string>(initial: T): SharedVa
  * must resolve to a spring config — a name registered as timing / decay /
  * no-animation warns in dev and falls back to the default spring (reach for
  * `useAnimation` when the named transition's type should be honored).
+ *
+ * Reduced motion (via `<MotionConfig reducedMotion>`) is honoured: the output
+ * is assigned the target directly, with no spring, on both paths.
  */
 declare function useSpring(target: number | SharedValue<number>, config?: SpringTransition | TransitionName): SharedValue<number>;
 
+interface UseTransformOptions {
+    extrapolateLeft?: ExtrapolationMode;
+    extrapolateRight?: ExtrapolationMode;
+}
+/**
+ * Derive a value from one or more shared values via a transformer worklet.
+ *
+ * ```ts
+ * const x = useMotionValue(0)
+ * const y = useMotionValue(0)
+ * const distance = useTransform(() => {
+ *   'worklet'
+ *   return Math.sqrt(x.value ** 2 + y.value ** 2)
+ * })
+ * ```
+ *
+ * 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.
+ */
+declare function useTransform<T>(transformer: () => T): SharedValue<T>;
+/**
+ * Interpolate a numeric shared value onto a range of numbers or colors.
+ *
+ * ```ts
+ * const scroll = useMotionValue(0)
+ * const headerOpacity = useTransform(scroll, [0, 100], [1, 0])
+ * const headerColor  = useTransform(scroll, [0, 100], ['#fff', '#000'])
+ * ```
+ *
+ * When `outputRange` is numeric, this maps to Reanimated's `interpolate`;
+ * when it's a tuple of color strings, it maps to `interpolateColor`. The
+ * input range must be monotonically increasing.
+ */
+declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly number[], options?: UseTransformOptions): SharedValue<number>;
+declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly string[], options?: UseTransformOptions): SharedValue<string>;
+
 interface UseScrollResult {
     /** Horizontal scroll offset in points. */
     scrollX: SharedValue<number>;
@@ -928,6 +969,24 @@ interface ShadowConfig {
      */
     boxShadow?: string | readonly BoxShadowLayer[];
 }
+/**
+ * The style fragment {@link useShadow} returns: the native shadow keys plus the
+ * CSS `boxShadow`, each present only when the paired configs drive it.
+ *
+ * Deliberately **not** `ReturnType<typeof useAnimatedStyle>` — see
+ * {@link ColorStyle} for why the brand is erased here.
+ */
+type ShadowStyle = {
+    shadowColor?: string;
+    shadowOffset?: {
+        width: number;
+        height: number;
+    };
+    shadowOpacity?: number;
+    shadowRadius?: number;
+    elevation?: number;
+    boxShadow?: string;
+};
 interface UseShadowOptions {
     /** Shadow state at `progress === 0`. */
     from: ShadowConfig;
@@ -977,7 +1036,7 @@ interface UseShadowOptions {
  * })
  * ```
  */
-declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useShadow({ from, to, progress, }: UseShadowOptions): ShadowStyle;
 
 /**
  * Build a controller for a variants map. The controller is the imperative
@@ -992,4 +1051,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 AnimationCallback, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyle, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, Stagger, type StaggerProps, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, applyDelay, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, useTransform, useVariants };
+export { AnimatableValue, type AnimationCallback, type Animator, type BoxShadowLayer, type CallbackFactory, type ColorCascadeLayer, type ColorStyle, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyle, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, type ShadowStyle, SpringTransition, Stagger, type StaggerProps, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, applyDelay, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, isTopLevelTransition, resolveAnimatableValue, resolveNamedTransition, resolveTransition, stableSig, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, 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 { TextStyle, ImageStyle, ViewStyle, NativeSyntheticEvent, NativeScrollEvent } from 'react-native';
-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';
+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-C5Zbs9MC.js';
+export { e as AnimateStyle, f as AnimationCallbackInfo, B as BoxShadowInput, D as DecayTransition, g as EasingFunction, h as EasingFunctionFactory, G as GestureLayerTransitions, i as GestureSubStates, j as MotionComponentProps, k as NoAnimationTransition, P as PerPropertyTransition, R as RegisteredTransitions, l as RepeatConfig, m as SequenceStep, n as TimingTransition, o as Transition } from './types-C5Zbs9MC.js';
+export { T as TranslateStyle, a as applyBounds, u as useTranslateStyle } from './useTranslateStyle-BDrOD97O.js';
+import { SharedValue } from 'react-native-reanimated';
 export { SharedValue } from 'react-native-reanimated';
-export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-DbH46EBp.js';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-Be0ZhCWj.js';
 export { MotionFlatList } from './motion/FlatList.js';
 export { MotionImage } from './motion/Image.js';
 export { MotionPressable } from './motion/Pressable.js';
@@ -273,6 +274,12 @@ declare function resolveTransition(config: TransitionConfig | undefined, toValue
  *   3. array of either   → `withSequence` of resolved steps, with the
  *      top-level `repeat` applied at the **sequence level** (not per step).
  *      Per-step `repeat` overrides remain step-local.
+ *
+ * `withSequence` writes a `finished` flag onto each argument it is handed, so
+ * a bare target throws `Cannot create property 'finished' on number` and takes
+ * the whole render down with it. Two paths produce bare targets, and both are
+ * handled below rather than at the call site: reduced motion (every step) and
+ * a per-step `{ type: 'no-animation' }` override (some steps).
  */
 declare function resolveAnimatableValue<V extends number | string>(value: AnimatableValue<V>, base: TransitionConfig | undefined, factory?: CallbackFactory): unknown;
 
@@ -341,6 +348,8 @@ declare function cubicBezier(css: string): EasingInput;
  */
 declare function ensureWorkletEasing(easing: EasingInput | undefined): ((t: number) => number) | undefined;
 
+declare function isTopLevelTransition(t: unknown): t is TransitionConfig;
+
 /**
  * Worklet-safe single-step animation builder. Mirrors a subset of
  * `resolveTransition` for the UI-thread path where the transition config is
@@ -367,6 +376,15 @@ declare function ensureWorkletEasing(easing: EasingInput | undefined): ((t: numb
  */
 declare function buildReleaseAnimation(transition: TransitionConfig, toValue: number, callback?: AnimationCallback): unknown;
 
+/**
+ * Stable string signature for an arbitrary value — used as a dep-array
+ * member so a fresh object literal each render doesn't re-fire an effect
+ * unless something structurally changed. Functions serialize as `null`
+ * (their identity isn't useful in a sig); `undefined` collapses to an empty
+ * string so omitted props compare equal across renders.
+ */
+declare function stableSig(value: unknown): string;
+
 /**
  * The one colour spelling Reanimated's animation drivers cannot accept.
  *
@@ -521,6 +539,22 @@ declare function useBooleanSpring(active: boolean, springConfig?: SpringTransiti
  * returned style fragment is always a legal RN style.
  */
 type ColorStyleKey = 'backgroundColor' | 'color' | 'borderColor' | 'borderTopColor' | 'borderRightColor' | 'borderBottomColor' | 'borderLeftColor' | 'tintColor' | 'shadowColor';
+/**
+ * A one-key colour style fragment, as returned by {@link useColorTransition}
+ * and {@link useColorCascade}.
+ *
+ * Deliberately **not** `ReturnType<typeof useAnimatedStyle>`. Reanimated 4.5
+ * brands that value (`AnimatedStyleHandle`), and a branded type is rejected
+ * inside a `StyleProp` array — so every call site would need a cast, which is
+ * the defect `InterpolatedStyle` was introduced to remove in `0.0.9`. The brand
+ * is compile-time only, so the runtime value is unchanged.
+ *
+ * Optional per key because which slot is filled is chosen at run time from
+ * `options.key`; exactly one is ever present.
+ */
+type ColorStyle = {
+    [K in ColorStyleKey]?: string;
+};
 interface UseColorTransitionOptions {
     /**
      * Which style slot the interpolated color is emitted under. Defaults to
@@ -552,7 +586,7 @@ interface UseColorTransitionOptions {
  * compose into a hand-rolled `useAnimatedStyle`), use `useTransform`
  * directly with a color output range.
  */
-declare function useColorTransition(progress: SharedValue<number>, range: readonly [string, string], options?: UseColorTransitionOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useColorTransition(progress: SharedValue<number>, range: readonly [string, string], options?: UseColorTransitionOptions): ColorStyle;
 
 /**
  * One layer in a color cascade: its own `progress` shared value (0→1) and the
@@ -612,7 +646,7 @@ interface UseColorCascadeOptions {
  * `rest`, the layer count, or **which shared value drives a layer** all rewire
  * the worklet as you'd expect.
  */
-declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ColorStyle;
 
 /**
  * Extrapolation behavior at the edges of the input range. Mirrors
@@ -624,47 +658,6 @@ declare function useColorCascade(rest: string, layers: readonly ColorCascadeLaye
  * - `'extend'` — continue the linear slope beyond the range.
  */
 type ExtrapolationMode = 'clamp' | 'identity' | 'extend';
-interface UseTransformOptions {
-    extrapolateLeft?: ExtrapolationMode;
-    extrapolateRight?: ExtrapolationMode;
-}
-/**
- * Derive a value from one or more shared values via a transformer worklet.
- *
- * ```ts
- * const x = useMotionValue(0)
- * const y = useMotionValue(0)
- * const distance = useTransform(() => Math.sqrt(x.value ** 2 + y.value ** 2))
- * ```
- *
- * 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.
- */
-declare function useTransform<T>(transformer: () => T): SharedValue<T>;
-/**
- * Interpolate a numeric shared value onto a range of numbers or colors.
- *
- * ```ts
- * const scroll = useMotionValue(0)
- * const headerOpacity = useTransform(scroll, [0, 100], [1, 0])
- * const headerColor  = useTransform(scroll, [0, 100], ['#fff', '#000'])
- * ```
- *
- * When `outputRange` is numeric, this maps to Reanimated's `interpolate`;
- * when it's a tuple of color strings, it maps to `interpolateColor`. The
- * input range must be monotonically increasing.
- */
-declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly number[], options?: UseTransformOptions): SharedValue<number>;
-declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly string[], options?: UseTransformOptions): SharedValue<string>;
 
 /**
  * Numeric style keys `useInterpolatedStyle` can emit directly (not lifted into
@@ -813,9 +806,57 @@ declare function useMotionValue<T extends number | string>(initial: T): SharedVa
  * must resolve to a spring config — a name registered as timing / decay /
  * no-animation warns in dev and falls back to the default spring (reach for
  * `useAnimation` when the named transition's type should be honored).
+ *
+ * Reduced motion (via `<MotionConfig reducedMotion>`) is honoured: the output
+ * is assigned the target directly, with no spring, on both paths.
  */
 declare function useSpring(target: number | SharedValue<number>, config?: SpringTransition | TransitionName): SharedValue<number>;
 
+interface UseTransformOptions {
+    extrapolateLeft?: ExtrapolationMode;
+    extrapolateRight?: ExtrapolationMode;
+}
+/**
+ * Derive a value from one or more shared values via a transformer worklet.
+ *
+ * ```ts
+ * const x = useMotionValue(0)
+ * const y = useMotionValue(0)
+ * const distance = useTransform(() => {
+ *   'worklet'
+ *   return Math.sqrt(x.value ** 2 + y.value ** 2)
+ * })
+ * ```
+ *
+ * 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.
+ */
+declare function useTransform<T>(transformer: () => T): SharedValue<T>;
+/**
+ * Interpolate a numeric shared value onto a range of numbers or colors.
+ *
+ * ```ts
+ * const scroll = useMotionValue(0)
+ * const headerOpacity = useTransform(scroll, [0, 100], [1, 0])
+ * const headerColor  = useTransform(scroll, [0, 100], ['#fff', '#000'])
+ * ```
+ *
+ * When `outputRange` is numeric, this maps to Reanimated's `interpolate`;
+ * when it's a tuple of color strings, it maps to `interpolateColor`. The
+ * input range must be monotonically increasing.
+ */
+declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly number[], options?: UseTransformOptions): SharedValue<number>;
+declare function useTransform(value: SharedValue<number>, inputRange: readonly number[], outputRange: readonly string[], options?: UseTransformOptions): SharedValue<string>;
+
 interface UseScrollResult {
     /** Horizontal scroll offset in points. */
     scrollX: SharedValue<number>;
@@ -928,6 +969,24 @@ interface ShadowConfig {
      */
     boxShadow?: string | readonly BoxShadowLayer[];
 }
+/**
+ * The style fragment {@link useShadow} returns: the native shadow keys plus the
+ * CSS `boxShadow`, each present only when the paired configs drive it.
+ *
+ * Deliberately **not** `ReturnType<typeof useAnimatedStyle>` — see
+ * {@link ColorStyle} for why the brand is erased here.
+ */
+type ShadowStyle = {
+    shadowColor?: string;
+    shadowOffset?: {
+        width: number;
+        height: number;
+    };
+    shadowOpacity?: number;
+    shadowRadius?: number;
+    elevation?: number;
+    boxShadow?: string;
+};
 interface UseShadowOptions {
     /** Shadow state at `progress === 0`. */
     from: ShadowConfig;
@@ -977,7 +1036,7 @@ interface UseShadowOptions {
  * })
  * ```
  */
-declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useShadow({ from, to, progress, }: UseShadowOptions): ShadowStyle;
 
 /**
  * Build a controller for a variants map. The controller is the imperative
@@ -992,4 +1051,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 AnimationCallback, type Animator, type BoxShadowLayer, type ColorCascadeLayer, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyle, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, SpringTransition, Stagger, type StaggerProps, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, applyDelay, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveNamedTransition, resolveTransition, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, useTransform, useVariants };
+export { AnimatableValue, type AnimationCallback, type Animator, type BoxShadowLayer, type CallbackFactory, type ColorCascadeLayer, type ColorStyle, type ColorStyleKey, EasingInput, type ExtrapolationMode, type InterpolatedStyle, type InterpolatedStyleMap, Motion, MotionComponent, MotionConfig, type MotionConfigProps, type MotionConfigValue, MotionProps, NamedTransitions, type NumericStyleKey, Presence, type PresenceContextValue, type ReducedMotion, type ShadowConfig, type ShadowStyle, SpringTransition, Stagger, type StaggerProps, TRANSPARENT, type TransformKey, TransitionConfig, TransitionInput, TransitionName, type UseColorCascadeOptions, type UseColorTransitionOptions, type UseInterpolatedStyleOptions, type UseScrollResult, type UseShadowOptions, type UseTransformOptions, VariantController, VariantsMap, applyDelay, buildReleaseAnimation, createMotionComponent, cubicBezier, ensureWorkletEasing, isTopLevelTransition, resolveAnimatableValue, resolveNamedTransition, resolveTransition, stableSig, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, useTransform, useVariants };