@rootnative/inertia 0.0.8 → 0.0.10

package/dist/index.d.mts

@@ -1,12 +1,13 @@
 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, 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 { 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-08mG8fNk.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-08mG8fNk.mjs';
+export { a as applyBounds } from './applyBounds-BYGiHrYO.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-CnZQnYHH.mjs';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-DjszaHWz.mjs';
 export { MotionFlatList } from './motion/FlatList.mjs';
 export { MotionImage } from './motion/Image.mjs';
 export { MotionPressable } from './motion/Pressable.mjs';
@@ -341,6 +342,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 +370,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.
  *
@@ -624,47 +636,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
@@ -689,6 +660,22 @@ type InterpolatedStyleMap = {
 } & {
     [K in ColorStyleKey]?: readonly string[];
 };
+/**
+ * The style shape a map of `K` produces. Transform keys collapse into the
+ * single `transform` array the worklet emits; every other key survives under
+ * its own name, typed from the RN style family it belongs to.
+ *
+ * This is what lets the return narrow to `ViewStyle` at a call site whose map
+ * holds only view keys. Reanimated's own `useAnimatedStyle` resolves to
+ * `DefaultStyle` (`ViewStyle | ImageStyle | TextStyle`), and that union is
+ * rejected inside a `StyleProp<ViewStyle>` array — `TextStyle` fails on
+ * `cursor` — so a consumer had to cast.
+ */
+type InterpolatedStyle<K extends keyof InterpolatedStyleMap> = {
+    [P in Exclude<K, TransformKey>]: P extends keyof TextStyle ? TextStyle[P] : P extends keyof ImageStyle ? ImageStyle[P] : P extends keyof ViewStyle ? ViewStyle[P] : never;
+} & (Extract<K, TransformKey> extends never ? unknown : {
+    transform: NonNullable<ViewStyle['transform']>;
+});
 interface UseInterpolatedStyleOptions {
     /**
      * Input range mapped onto every key's output range. Defaults to `[0, 1]`
@@ -746,7 +733,7 @@ interface UseInterpolatedStyleOptions {
  * hook stays fully declarative and hashable so unchanged maps produce zero
  * new UI-thread closures.
  */
-declare function useInterpolatedStyle(progress: SharedValue<number>, map: InterpolatedStyleMap, options?: UseInterpolatedStyleOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useInterpolatedStyle<K extends keyof InterpolatedStyleMap>(progress: SharedValue<number>, map: Pick<InterpolatedStyleMap, K>, options?: UseInterpolatedStyleOptions): InterpolatedStyle<K>;
 
 /**
  * Create an animatable value owned by JS but readable from worklets.
@@ -797,9 +784,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>;
@@ -963,6 +998,29 @@ interface UseShadowOptions {
  */
 declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnType<typeof useAnimatedStyle>;
 
+/**
+ * Animated style that translates by two shared values:
+ * `transform: [{ translateX: x }, { translateY: y }]`.
+ *
+ * This is the style fragment every drag-style hook returns (`useTouchDrag`,
+ * and `useDrag` / `usePan` / `useSwipe` in `@rootnative/inertia-gestures`).
+ * Use it directly when a custom gesture owns its own translation values.
+ *
+ * The style owns the whole `transform` key. Do not stack a second transform
+ * style beside it — `transform` is one key in React Native, so the later
+ * style replaces this one instead of merging. Nest another animated view, or
+ * build one style from `x` / `y` with `useInterpolatedStyle`, to add a
+ * transform.
+ *
+ * ```tsx
+ * const x = useMotionValue(0)
+ * const y = useMotionValue(0)
+ * const style = useTranslateStyle(x, y)
+ * return <Motion.View style={style} />
+ * ```
+ */
+declare function useTranslateStyle(x: SharedValue<number>, y: SharedValue<number>): ReturnType<typeof useAnimatedStyle>;
+
 /**
  * Build a controller for a variants map. The controller is the imperative
  * escape hatch — pass it to a Motion primitive via `controller={...}` and
@@ -976,4 +1034,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 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 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, isTopLevelTransition, resolveAnimatableValue, resolveNamedTransition, resolveTransition, stableSig, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, useTransform, useTranslateStyle, useVariants };

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 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, 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 { 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-08mG8fNk.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-08mG8fNk.js';
+export { a as applyBounds } from './applyBounds-BYGiHrYO.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-DbH46EBp.js';
+export { U as UseGestureHandlers, a as UseGestureResult, u as useGesture } from './useGesture-D1lHeQQ6.js';
 export { MotionFlatList } from './motion/FlatList.js';
 export { MotionImage } from './motion/Image.js';
 export { MotionPressable } from './motion/Pressable.js';
@@ -341,6 +342,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 +370,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.
  *
@@ -624,47 +636,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
@@ -689,6 +660,22 @@ type InterpolatedStyleMap = {
 } & {
     [K in ColorStyleKey]?: readonly string[];
 };
+/**
+ * The style shape a map of `K` produces. Transform keys collapse into the
+ * single `transform` array the worklet emits; every other key survives under
+ * its own name, typed from the RN style family it belongs to.
+ *
+ * This is what lets the return narrow to `ViewStyle` at a call site whose map
+ * holds only view keys. Reanimated's own `useAnimatedStyle` resolves to
+ * `DefaultStyle` (`ViewStyle | ImageStyle | TextStyle`), and that union is
+ * rejected inside a `StyleProp<ViewStyle>` array — `TextStyle` fails on
+ * `cursor` — so a consumer had to cast.
+ */
+type InterpolatedStyle<K extends keyof InterpolatedStyleMap> = {
+    [P in Exclude<K, TransformKey>]: P extends keyof TextStyle ? TextStyle[P] : P extends keyof ImageStyle ? ImageStyle[P] : P extends keyof ViewStyle ? ViewStyle[P] : never;
+} & (Extract<K, TransformKey> extends never ? unknown : {
+    transform: NonNullable<ViewStyle['transform']>;
+});
 interface UseInterpolatedStyleOptions {
     /**
      * Input range mapped onto every key's output range. Defaults to `[0, 1]`
@@ -746,7 +733,7 @@ interface UseInterpolatedStyleOptions {
  * hook stays fully declarative and hashable so unchanged maps produce zero
  * new UI-thread closures.
  */
-declare function useInterpolatedStyle(progress: SharedValue<number>, map: InterpolatedStyleMap, options?: UseInterpolatedStyleOptions): ReturnType<typeof useAnimatedStyle>;
+declare function useInterpolatedStyle<K extends keyof InterpolatedStyleMap>(progress: SharedValue<number>, map: Pick<InterpolatedStyleMap, K>, options?: UseInterpolatedStyleOptions): InterpolatedStyle<K>;
 
 /**
  * Create an animatable value owned by JS but readable from worklets.
@@ -797,9 +784,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>;
@@ -963,6 +998,29 @@ interface UseShadowOptions {
  */
 declare function useShadow({ from, to, progress, }: UseShadowOptions): ReturnType<typeof useAnimatedStyle>;
 
+/**
+ * Animated style that translates by two shared values:
+ * `transform: [{ translateX: x }, { translateY: y }]`.
+ *
+ * This is the style fragment every drag-style hook returns (`useTouchDrag`,
+ * and `useDrag` / `usePan` / `useSwipe` in `@rootnative/inertia-gestures`).
+ * Use it directly when a custom gesture owns its own translation values.
+ *
+ * The style owns the whole `transform` key. Do not stack a second transform
+ * style beside it — `transform` is one key in React Native, so the later
+ * style replaces this one instead of merging. Nest another animated view, or
+ * build one style from `x` / `y` with `useInterpolatedStyle`, to add a
+ * transform.
+ *
+ * ```tsx
+ * const x = useMotionValue(0)
+ * const y = useMotionValue(0)
+ * const style = useTranslateStyle(x, y)
+ * return <Motion.View style={style} />
+ * ```
+ */
+declare function useTranslateStyle(x: SharedValue<number>, y: SharedValue<number>): ReturnType<typeof useAnimatedStyle>;
+
 /**
  * Build a controller for a variants map. The controller is the imperative
  * escape hatch — pass it to a Motion primitive via `controller={...}` and
@@ -976,4 +1034,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 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 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, isTopLevelTransition, resolveAnimatableValue, resolveNamedTransition, resolveTransition, stableSig, useAnimation, useAnimator, useBooleanSpring, useColorCascade, useColorTransition, useInterpolatedStyle, useMotionConfig, useMotionValue, useNamedTransitions, usePresence, useScroll, useShadow, useShouldReduceMotion, useSpring, useStaggerDelay, useTransform, useTranslateStyle, useVariants };