@tamagui/animations-react-native 2.7.7 → 3.0.0-beta.1093.1

package/src/types.ts

@@ -0,0 +1,4 @@
+export type CreateAnimationsOptions = {
+  // override native driver detection (default: auto-detect Fabric)
+  useNativeDriver?: boolean
+}

package/types/{createAnimations.d.ts → createAnimations.native.d.ts}

@@ -1,16 +1,7 @@
-import type { AnimationDriver, UniversalAnimatedNumber, UseAnimatedNumberReaction, UseAnimatedNumberStyle } from "@tamagui/web";
+import { type AnimationsConfig } from "@tamagui/animation-helpers";
+import type { AnimationDriverWithAnimatedNumbers, UniversalAnimatedNumber, UseAnimatedNumberReaction, UseAnimatedNumberStyle } from "@tamagui/web";
 import { Animated, type Text, type View } from "react-native";
-type AnimationsConfig<A extends object = any> = { [Key in keyof A] : AnimationConfig };
-type SpringConfig = {
-	type?: "spring";
-} & Partial<Pick<Animated.SpringAnimationConfig, "delay" | "bounciness" | "damping" | "friction" | "mass" | "overshootClamping" | "speed" | "stiffness" | "tension" | "velocity">>;
-type TimingConfig = {
-	type: "timing";
-} & Partial<Animated.TimingAnimationConfig>;
-type AnimationConfig = SpringConfig | TimingConfig;
-type CreateAnimationsOptions = {
-	useNativeDriver?: boolean;
-};
+import type { CreateAnimationsOptions } from "./types";
 export declare const AnimatedView: Animated.AnimatedComponent<typeof View>;
 export declare const AnimatedText: Animated.AnimatedComponent<typeof Text>;
 export declare function useAnimatedNumber(initial: number): UniversalAnimatedNumber<Animated.Value>;
@@ -18,7 +9,7 @@ type RNAnimatedNum = UniversalAnimatedNumber<Animated.Value>;
 export declare const useAnimatedNumberReaction: UseAnimatedNumberReaction<RNAnimatedNum>;
 export declare const useAnimatedNumberStyle: UseAnimatedNumberStyle<RNAnimatedNum>;
 export declare const useAnimatedNumbersStyle: (vals: RNAnimatedNum[], getStyle: (...currentValues: any[]) => any) => any;
-export declare function createAnimations<A extends AnimationsConfig>(animations: A, options?: CreateAnimationsOptions): AnimationDriver<A>;
+export declare function createAnimations<A extends AnimationsConfig>(animations: A, options?: CreateAnimationsOptions): AnimationDriverWithAnimatedNumbers<A>;
 export {};
 
-//# sourceMappingURL=createAnimations.d.ts.map
+//# sourceMappingURL=createAnimations.native.d.ts.map

package/types/createAnimations.native.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,cAKO,wBAGA;AAGP,cAEE,oCAEA,yBACA,2BACA,8BACK;AAIP,SACE,eAIK,WACA,YACA;AAEP,cAAc,+BAA+B;AAwF7C,OAAO,cAAM,cAAc,SAAS,yBAAyB;AAC7D,OAAO,cAAM,cAAc,SAAS,yBAAyB;AAE7D,OAAO,iBAAS,kBACd,kBACC,wBAAwB,SAAS;KAgE/B,gBAAgB,wBAAwB,SAAS;AAEtD,OAAO,cAAM,2BAA2B,0BAA0B;AAgBlE,OAAO,cAAM,wBAAwB,uBAAuB;AAiC5D,OAAO,cAAM,0BACX,MAAM,iBACN,WAAW,GAAG;AAKhB,OAAO,iBAAS,iBAAiB,UAAU,kBACzC,YAAY,GACZ,UAAU,0BACT,mCAAmC",
+  "names": [],
+  "sources": [
+    "src/createAnimations.native.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import {\n  easingToBezier,\n  forAnimationState,\n  getTransitionForKey,\n  resolveTransition,\n  type AnimationsConfig,\n  type ResolvedEntry,\n  type ResolvedTransition,\n} from '@tamagui/animation-helpers'\nimport { isWeb, useIsomorphicLayoutEffect } from '@tamagui/constants'\nimport { ResetPresence, usePresence } from '@tamagui/use-presence'\nimport type {\n  AnimatedNumberStrategy,\n  AnimationDriverWithAnimatedNumbers,\n  TransitionProp,\n  UniversalAnimatedNumber,\n  UseAnimatedNumberReaction,\n  UseAnimatedNumberStyle,\n} from '@tamagui/web'\nimport { useEvent } from '@tamagui/web'\nimport { useThemeWithState } from '@tamagui/web/internal-runtime'\nimport React from 'react'\nimport {\n  Animated,\n  Easing,\n  processColor,\n  type ColorValue,\n  type Text,\n  type View,\n} from 'react-native'\n\nimport type { CreateAnimationsOptions } from './types'\n\n// detect Fabric (New Architecture) — Paper doesn't support native driver for all style keys\nconst isFabric =\n  !isWeb && typeof global !== 'undefined' && !!global.__nativeFabricUIManager\n\n// Helper to resolve dynamic theme values like {dynamic: {dark: \"value\", light: undefined}}\nconst resolveDynamicValue = (value: any, isDark: boolean): any => {\n  if (value && typeof value === 'object' && 'dynamic' in value) {\n    const dynamicValue = isDark ? value.dynamic.dark : value.dynamic.light\n    return dynamicValue\n  }\n  return value\n}\n\n/** what `getAnimationConfig` hands to `Animated.spring` / `Animated.timing` */\ntype AnimationConfig =\n  | ({ type: 'spring'; delay?: number } & Partial<\n      Pick<\n        Animated.SpringAnimationConfig,\n        'damping' | 'mass' | 'overshootClamping' | 'stiffness' | 'velocity'\n      >\n    >)\n  | ({ type: 'timing'; delay?: number } & Partial<\n      Pick<Animated.TimingAnimationConfig, 'duration' | 'easing'>\n    >)\n\nconst animatedStyleKey = {\n  transform: true,\n  opacity: true,\n}\n\nconst colorStyleKey = {\n  backgroundColor: true,\n  color: true,\n  borderColor: true,\n  borderLeftColor: true,\n  borderRightColor: true,\n  borderTopColor: true,\n  borderBottomColor: true,\n}\n\n// layout dimension keys. these must run on the JS driver (useNativeDriver:false)\n// because the native animated module can't drive layout props.\nconst layoutStyleKey = {\n  height: true,\n  width: true,\n  minHeight: true,\n  maxHeight: true,\n  minWidth: true,\n  maxWidth: true,\n}\n\nfunction hasAnimatedLayoutKey(\n  style: Record<string, any>,\n  isDark: boolean,\n  resolved: ResolvedTransition\n) {\n  for (const key in layoutStyleKey) {\n    if (!getTransitionForKey(resolved, key)) continue\n    if (typeof resolveDynamicValue(style[key], isDark) === 'number') return true\n  }\n  return false\n}\n\n// Only colors accepted by RN's own parser can enter interpolation. CSS-wide\n// keywords, unresolved tokens, var()/calc(), and empty strings otherwise reach\n// createInterpolationFromStringOutputRange / mapStringToNumericComponents and\n// throw. Those values must be applied as static styles.\nfunction isAnimatableColor(value: unknown): value is string {\n  return typeof value === 'string' && processColor(value as ColorValue) != null\n}\n\n// these style keys are costly to animate and only work with native driver on Fabric\nconst costlyToAnimateStyleKey = {\n  borderRadius: true,\n  borderTopLeftRadius: true,\n  borderTopRightRadius: true,\n  borderBottomLeftRadius: true,\n  borderBottomRightRadius: true,\n  borderWidth: true,\n  borderLeftWidth: true,\n  borderRightWidth: true,\n  borderTopWidth: true,\n  borderBottomWidth: true,\n  ...colorStyleKey,\n}\n\nexport const AnimatedView: Animated.AnimatedComponent<typeof View> = Animated.View\nexport const AnimatedText: Animated.AnimatedComponent<typeof Text> = Animated.Text\n\nexport function useAnimatedNumber(\n  initial: number\n): UniversalAnimatedNumber<Animated.Value> {\n  const state = React.useRef(\n    null as any as {\n      val: Animated.Value\n      composite: Animated.CompositeAnimation | null\n      strategy: AnimatedNumberStrategy\n    }\n  )\n  if (!state.current) {\n    state.current = {\n      composite: null,\n      val: new Animated.Value(initial),\n      strategy: { type: 'spring' },\n    }\n  }\n\n  return {\n    getInstance() {\n      return state.current.val\n    },\n    getValue() {\n      return state.current.val['_value']\n    },\n    stop() {\n      state.current.composite?.stop()\n      state.current.composite = null\n    },\n    setValue(next: number, { type, ...config } = { type: 'spring' }, onFinish) {\n      const val = state.current.val\n\n      const handleFinish = onFinish\n        ? ({ finished }) => (finished ? onFinish() : null)\n        : undefined\n\n      if (type === 'direct') {\n        state.current.composite?.stop()\n        state.current.composite = null\n        val.setValue(next)\n        // a direct set finishes the moment it lands. not calling back stranded\n        // everything waiting on it (sheet snap, presence completion).\n        onFinish?.()\n      } else if (type === 'spring') {\n        state.current.composite?.stop()\n        const composite = Animated.spring(val, {\n          ...config,\n          toValue: next,\n          useNativeDriver: isFabric,\n        })\n        composite.start(handleFinish)\n        state.current.composite = composite\n      } else {\n        state.current.composite?.stop()\n        const composite = Animated.timing(val, {\n          ...config,\n          toValue: next,\n          useNativeDriver: isFabric,\n        })\n        composite.start(handleFinish)\n        state.current.composite = composite\n      }\n    },\n  }\n}\n\ntype RNAnimatedNum = UniversalAnimatedNumber<Animated.Value>\n\nexport const useAnimatedNumberReaction: UseAnimatedNumberReaction<RNAnimatedNum> = (\n  { value },\n  onValue\n) => {\n  const onChange = useEvent((current) => {\n    onValue(current.value)\n  })\n\n  React.useEffect(() => {\n    const id = value.getInstance().addListener(onChange)\n    return () => {\n      value.getInstance().removeListener(id)\n    }\n  }, [value, onChange])\n}\n\nexport const useAnimatedNumberStyle: UseAnimatedNumberStyle<RNAnimatedNum> = (\n  value,\n  getStyle\n) => {\n  const instance = value.getInstance()\n  const animatedStyle = getStyle(instance)\n  const usesAnimatedNode = hasAnimatedNode(animatedStyle)\n  const [current, setCurrent] = React.useState(value.getValue())\n\n  // preserve the native animated-node path for direct mappings. callbacks\n  // that do arithmetic require numeric values, so drive those through the\n  // value listener and render the computed style.\n  React.useEffect(() => {\n    if (usesAnimatedNode) return\n\n    const id = instance.addListener(({ value: next }) => {\n      setCurrent(next)\n    })\n    return () => {\n      instance.removeListener(id)\n    }\n  }, [instance, usesAnimatedNode])\n\n  return usesAnimatedNode ? animatedStyle : getStyle(current)\n}\n\nfunction hasAnimatedNode(value: unknown): boolean {\n  if (!value || typeof value !== 'object') return false\n  if (typeof (value as any).__getValue === 'function') return true\n  if (Array.isArray(value)) return value.some(hasAnimatedNode)\n  return Object.values(value).some(hasAnimatedNode)\n}\n\nexport const useAnimatedNumbersStyle = (\n  vals: RNAnimatedNum[],\n  getStyle: (...currentValues: any[]) => any\n): any => {\n  return getStyle(...vals.map((v) => v.getInstance()))\n}\n\nexport function createAnimations<A extends AnimationsConfig>(\n  animations: A,\n  options?: CreateAnimationsOptions\n): AnimationDriverWithAnimatedNumbers<A> {\n  const nativeDriver = options?.useNativeDriver ?? isFabric\n\n  return {\n    inputStyle: 'value',\n    outputStyle: 'inline',\n    avoidReRenders: true,\n    animations,\n    needsCustomComponent: true,\n    View: AnimatedView,\n    Text: AnimatedText,\n    useAnimatedNumber,\n    useAnimatedNumberReaction,\n    useAnimatedNumberStyle,\n    useAnimatedNumbersStyle,\n    usePresence,\n    ResetPresence,\n    useAnimations: ({\n      props,\n      onTransition,\n      style,\n      componentState,\n      presence,\n      stateRef,\n      styleState,\n      useStyleEmitter,\n    }) => {\n      const isDisabled = isWeb && componentState.unmounted === true\n      const isExiting = presence?.[0] === false\n      const sendExitComplete = presence?.[1]\n      const onTransitionRef = React.useRef(onTransition)\n      onTransitionRef.current = onTransition\n      const emit = (\n        phase: 'start' | 'end',\n        cause: 'enter' | 'exit' | 'update',\n        finished?: boolean\n      ) => {\n        onTransitionRef.current?.(\n          phase === 'end' ? { phase, cause, finished } : { phase, cause }\n        )\n      }\n      // createComponent merges a colocated `transition` out of the active\n      // pseudo style (`enterStyle={{ opacity: 0, transition: '200ms' }}`), so\n      // this is the one that applies right now, not the base prop.\n      const effectiveTransition = (styleState?.effectiveTransition ?? props.transition) as\n        | TransitionProp\n        | null\n        | undefined\n\n      const [, themeState] = useThemeWithState({})\n      // Check scheme first, then fall back to checking theme name for 'dark'\n      const isDark = themeState?.scheme === 'dark' || themeState?.name?.startsWith('dark')\n\n      /** store Animated value of each key e.g: color: AnimatedValue */\n      const animateStyles = React.useRef<Record<string, Animated.Value>>({})\n      const animatedTranforms = React.useRef<{ [key: string]: Animated.Value }[]>([])\n      const animationsState = React.useRef(\n        new WeakMap<\n          Animated.Value,\n          {\n            interpolation: Animated.AnimatedInterpolation<any>\n            current?: number | string | undefined\n            // only for colors\n            animateToValue?: number\n          }\n        >()\n      )\n      const pseudoActiveRef = React.useRef(false)\n\n      // exit cycle guards to prevent stale/duplicate completion\n      const exitCycleIdRef = React.useRef(0)\n      const exitCompletedRef = React.useRef(false)\n      const wasExitingRef = React.useRef(false)\n\n      // onTransition lifecycle bookkeeping\n      const enterStartedRef = React.useRef(false)\n      const exitStartedRef = React.useRef(false)\n      const updateInFlightRef = React.useRef(false)\n      const updateCycleIdRef = React.useRef(0)\n      const prevStyleSigRef = React.useRef<string | null>(null)\n\n      // detect transition into/out of exiting state\n      const justStartedExiting = isExiting && !wasExitingRef.current\n      const justStoppedExiting = !isExiting && wasExitingRef.current\n\n      // start new exit cycle only on transition INTO exiting\n      if (justStartedExiting) {\n        exitCycleIdRef.current++\n        exitCompletedRef.current = false\n      }\n      // invalidate pending callbacks when exit is canceled/interrupted\n      if (justStoppedExiting) {\n        exitCycleIdRef.current++\n      }\n\n      // Track if we just finished entering (transition from entering to not entering)\n      // must be declared before args array that uses justFinishedEntering\n      const isEntering = !!componentState.unmounted\n      const wasEnteringRef = React.useRef(isEntering)\n      const justFinishedEntering = wasEnteringRef.current && !isEntering\n      React.useEffect(() => {\n        wasEnteringRef.current = isEntering\n      })\n\n      const args = [\n        JSON.stringify(style),\n        JSON.stringify(effectiveTransition),\n        componentState,\n        isExiting,\n        !!onTransition,\n        isDark,\n        justFinishedEntering,\n      ]\n\n      const res = React.useMemo(() => {\n        const runners: Function[] = []\n        const completions: Promise<void>[] = []\n\n        // Determine animation state for enter/exit transitions\n        // Use 'enter' if we're entering OR if we just finished entering\n        const animationState: 'enter' | 'exit' | 'default' = isExiting\n          ? 'exit'\n          : isEntering || justFinishedEntering\n            ? 'enter'\n            : 'default'\n\n        // which style keys animate at all is the transition's own decision, so\n        // a property list narrows this the same way it narrows css\n        const resolved = forAnimationState(\n          resolveTransition(effectiveTransition, { animations }),\n          animationState\n        )\n\n        const nonAnimatedStyle = {}\n        // animatedStyle owns every Animated.Value on the node. Fabric cannot mix\n        // native- and JS-driven values inside that shared graph, so one layout\n        // animation makes the whole node use the JS driver.\n        const useNativeDriverForNode =\n          nativeDriver && !hasAnimatedLayoutKey(style, isDark, resolved)\n\n        // track which animated keys/transforms the incoming style actually\n        // carries this pass, so entries that left the style can be dropped\n        // below (an Animated.Value that persisted forever would keep painting\n        // a stale pixel value, e.g. a released-to-auto accordion height)\n        const seenAnimateKeys = new Set<string>()\n        let sawTransform = false\n        let transformCount = 0\n\n        for (const key in style) {\n          const rawVal = style[key]\n          // Resolve dynamic theme values from flat theme clauses.\n          const val = resolveDynamicValue(rawVal, isDark)\n          if (val === undefined) continue\n\n          if (isDisabled) {\n            continue\n          }\n\n          if (\n            animatedStyleKey[key] == null &&\n            !costlyToAnimateStyleKey[key] &&\n            !layoutStyleKey[key]\n          ) {\n            nonAnimatedStyle[key] = val\n            continue\n          }\n\n          // `transform` is a container, not a property: its parts each resolve\n          // on their own below, and a part no entry covers gets `snapConfig`.\n          // the array cannot be split into animated and static halves here.\n          if (key !== 'transform' && !getTransitionForKey(resolved, key)) {\n            nonAnimatedStyle[key] = val\n            continue\n          }\n\n          // layout dimension keys only animate numbers — 'auto' (an open\n          // accordion at rest) and percent strings apply as static styles\n          if (layoutStyleKey[key] && typeof val !== 'number') {\n            nonAnimatedStyle[key] = val\n            continue\n          }\n\n          // unparseable colors crash RN\n          // interpolation — apply them as a static style instead\n          if (colorStyleKey[key] && !isAnimatableColor(val)) {\n            nonAnimatedStyle[key] = val\n            continue\n          }\n\n          if (key !== 'transform') {\n            animateStyles.current[key] = update(key, animateStyles.current[key], val)\n            seenAnimateKeys.add(key)\n            continue\n          }\n          // key: 'transform'\n          // for now just support one transform key\n          if (!val) continue\n          if (typeof val === 'string') {\n            console.warn(`Warning: Tamagui can't animate string transforms yet!`)\n            continue\n          }\n\n          sawTransform = true\n          for (const transform of val) {\n            if (!transform) continue\n            const index = transformCount++\n            // tkey: e.g: 'translateX'\n            const tkey = Object.keys(transform)[0]\n            const currentTransform = animatedTranforms.current[index]?.[tkey]\n            animatedTranforms.current[index] = {\n              [tkey]: update(tkey, currentTransform, transform[tkey]),\n            }\n            animatedTranforms.current = [...animatedTranforms.current]\n          }\n        }\n\n        // drop stale Animated.Values whose keys left the incoming style, so the\n        // key genuinely leaves the rendered style object (a released height goes\n        // back to auto instead of staying pinned at its last pixel value). skip\n        // while exiting (presence still animates the leaving keys) and while\n        // disabled (the loop above intentionally skips every key). an active\n        // pseudo owns the current emitted style until its matching release.\n        if (!isExiting && !isDisabled && !pseudoActiveRef.current) {\n          for (const k in animateStyles.current) {\n            if (!seenAnimateKeys.has(k)) delete animateStyles.current[k]\n          }\n          if (!sawTransform) {\n            if (animatedTranforms.current.length) animatedTranforms.current = []\n          } else if (animatedTranforms.current.length > transformCount) {\n            animatedTranforms.current = animatedTranforms.current.slice(0, transformCount)\n          }\n        }\n\n        const animatedTransformStyle =\n          animatedTranforms.current.length > 0\n            ? {\n                transform: animatedTranforms.current.map((r) => {\n                  const key = Object.keys(r)[0]\n                  const val =\n                    animationsState.current!.get(r[key])?.interpolation || r[key]\n                  return { [key]: val }\n                }),\n              }\n            : {}\n\n        const animatedStyle = {\n          ...Object.fromEntries(\n            Object.entries(animateStyles.current).map(([k, v]) => [\n              k,\n              animationsState.current!.get(v)?.interpolation || v,\n            ])\n          ),\n          ...animatedTransformStyle,\n        }\n\n        return {\n          runners,\n          completions,\n          style: [nonAnimatedStyle, animatedStyle],\n        }\n\n        function update(\n          key: string,\n          animated: Animated.Value | undefined,\n          valIn: string | number\n        ) {\n          const isColorStyleKey = colorStyleKey[key]\n          const [val, type] = isColorStyleKey ? [0, undefined] : getValue(valIn)\n          let animateToValue = val\n          const value = animated || new Animated.Value(val)\n          const curInterpolation = animationsState.current.get(value)\n\n          let interpolateArgs: any\n          if (type) {\n            interpolateArgs = getInterpolated(\n              curInterpolation?.current ?? value['_value'],\n              val,\n              type\n            )\n            animationsState.current!.set(value, {\n              interpolation: value.interpolate(interpolateArgs),\n              current: val,\n            })\n          }\n\n          if (isColorStyleKey) {\n            animateToValue = curInterpolation?.animateToValue ? 0 : 1\n            interpolateArgs = getColorInterpolated(\n              curInterpolation?.current as string,\n              // valIn is the next color\n              valIn as string,\n              animateToValue\n            )\n            animationsState.current!.set(value, {\n              current: valIn,\n              interpolation: value.interpolate(interpolateArgs),\n              animateToValue: curInterpolation?.animateToValue ? 0 : 1,\n            })\n          }\n\n          if (value) {\n            const animationConfig = getAnimationConfig(\n              key,\n              animations,\n              effectiveTransition,\n              animationState\n            )\n\n            let resolve\n            const promise = new Promise<void>((res) => {\n              resolve = res\n            })\n            completions.push(promise)\n\n            runners.push(() => {\n              value.stopAnimation()\n\n              // `delay` drives the sequence below, so it must not also ride\n              // along in the config or every delayed animation waits twice\n              const { type, delay, ...config } = animationConfig\n              const animation = Animated[type || 'spring'](value, {\n                toValue: animateToValue,\n                ...config,\n                useNativeDriver: useNativeDriverForNode,\n              })\n              const animation2 = delay\n                ? Animated.sequence([Animated.delay(delay), animation])\n                : animation\n\n              animation2.start(({ finished }) => {\n                // always resolve during exit (element is leaving anyway)\n                // for non-exit, only resolve on successful completion\n                if (finished || isExiting) {\n                  resolve()\n                }\n              })\n            })\n          }\n\n          if (process.env.NODE_ENV === 'development') {\n            if (props['debug'] === 'verbose') {\n              // prettier-ignore\n              console.info(\n                ' 💠 animate',\n                key,\n                `from (${value['_value']}) to`,\n                valIn,\n                `(${val})`,\n                'type',\n                type,\n                'interpolate',\n                interpolateArgs\n              )\n            }\n          }\n          return value\n        }\n      }, args)\n\n      // track previous exiting state\n      React.useEffect(() => {\n        wasExitingRef.current = isExiting\n      })\n\n      // exit interrupted by a re-enter: report the exit as finished:false\n      useIsomorphicLayoutEffect(() => {\n        if (justStoppedExiting && exitStartedRef.current && !exitCompletedRef.current) {\n          exitStartedRef.current = false\n          emit('end', 'exit', false)\n        }\n      }, [justStoppedExiting])\n\n      useIsomorphicLayoutEffect(() => {\n        res.runners.forEach((r) => r())\n\n        // capture current cycle id\n        const cycleId = exitCycleIdRef.current\n\n        const cause: 'enter' | 'exit' | 'update' = isExiting\n          ? 'exit'\n          : isEntering || justFinishedEntering\n            ? 'enter'\n            : 'update'\n\n        // interruptions: an enter or update still in flight when exit begins is\n        // reported as finished:false (its own completion promise won't resolve\n        // because the animation was stopped, not finished).\n        if (cause === 'exit') {\n          if (enterStartedRef.current) {\n            enterStartedRef.current = false\n            emit('end', 'enter', false)\n          }\n          if (updateInFlightRef.current) {\n            updateInFlightRef.current = false\n            updateCycleIdRef.current++\n            emit('end', 'update', false)\n          }\n        }\n\n        // in-place update: a genuine style change while mounted (not entering or\n        // exiting). guard on the style signature so lifecycle-only re-renders\n        // don't register as updates.\n        if (cause === 'update') {\n          const sig = args[0] as string\n          if (prevStyleSigRef.current === null || prevStyleSigRef.current === sig) {\n            prevStyleSigRef.current = sig\n            return\n          }\n          prevStyleSigRef.current = sig\n          if (res.completions.length === 0) return\n          if (updateInFlightRef.current) {\n            // superseded before finishing\n            emit('end', 'update', false)\n          }\n          updateInFlightRef.current = true\n          const uid = ++updateCycleIdRef.current\n          emit('start', 'update')\n          Promise.all(res.completions).then(() => {\n            if (uid !== updateCycleIdRef.current) return\n            updateInFlightRef.current = false\n            emit('end', 'update', true)\n          })\n          return\n        }\n\n        // keep the update signature current while entering/exiting\n        prevStyleSigRef.current = args[0] as string\n\n        // handle zero-completion case immediately (enter/exit report a pair)\n        if (res.completions.length === 0) {\n          emit('start', cause)\n          emit('end', cause, true)\n          if (isExiting && !exitCompletedRef.current) {\n            exitCompletedRef.current = true\n            sendExitComplete?.()\n          }\n          return\n        }\n\n        // enter/exit start (once per cycle; re-runs continue the same animation)\n        if (cause === 'enter' && !enterStartedRef.current) {\n          enterStartedRef.current = true\n          emit('start', 'enter')\n        }\n        if (cause === 'exit' && !exitStartedRef.current) {\n          exitStartedRef.current = true\n          emit('start', 'exit')\n        }\n\n        Promise.all(res.completions).then(() => {\n          // guard against stale cycle completion\n          if (isExiting && cycleId !== exitCycleIdRef.current) return\n          if (isExiting && exitCompletedRef.current) return\n\n          if (isExiting) {\n            if (exitStartedRef.current) {\n              exitStartedRef.current = false\n              // exit 'end' fires immediately before presence safeToRemove\n              emit('end', 'exit', true)\n            }\n            exitCompletedRef.current = true\n            sendExitComplete?.()\n          } else if (enterStartedRef.current) {\n            enterStartedRef.current = false\n            emit('end', 'enter', true)\n          }\n        })\n      }, args)\n\n      // avoidReRenders: receive style changes imperatively from tamagui\n      // and update Animated.Values directly without React re-renders\n      // reuses the same update() + runner pattern as the useMemo path\n      useStyleEmitter?.((nextStyle, emittedTransition, pseudoActive) => {\n        pseudoActiveRef.current = pseudoActive === true\n        const runners: Function[] = []\n        const seenAnimateKeys = new Set<string>()\n        let transformCount = 0\n        let animatedShapeChanged = false\n        // the emitter runs on a mounted node, so `default` is the state, but\n        // the transition is the one it was handed\n        const emittedResolved = forAnimationState(\n          resolveTransition(emittedTransition ?? effectiveTransition, { animations }),\n          'default'\n        )\n        // nextStyle is the complete style for this node, so the emitter makes\n        // the same single driver decision as the render path. include the\n        // currently rendered graph because its stale keys are not removed until\n        // the structural-change commit below.\n        const useNativeDriverForNode =\n          nativeDriver &&\n          !hasAnimatedLayoutKey(nextStyle, isDark, emittedResolved) &&\n          !Object.keys(animateStyles.current).some((key) => layoutStyleKey[key])\n\n        for (const key in nextStyle) {\n          const rawVal = nextStyle[key]\n          const val = resolveDynamicValue(rawVal, isDark)\n          if (val === undefined) continue\n\n          if (key === 'transform' && Array.isArray(val)) {\n            for (const transform of val) {\n              if (!transform) continue\n              const index = transformCount++\n              const tkey = Object.keys(transform)[0]\n              const currentTransform = animatedTranforms.current[index]?.[tkey]\n              if (!currentTransform) animatedShapeChanged = true\n              animatedTranforms.current[index] = {\n                [tkey]: update(tkey, currentTransform, transform[tkey]),\n              }\n            }\n          } else if (\n            animatedStyleKey[key] != null ||\n            costlyToAnimateStyleKey[key] ||\n            layoutStyleKey[key]\n          ) {\n            // layout keys only animate numbers ('auto'/percents are static);\n            // unparseable themed colors can't be interpolated — skip both and\n            // let the next render apply them statically\n            if (layoutStyleKey[key] && typeof val !== 'number') continue\n            if (colorStyleKey[key] && !isAnimatableColor(val)) continue\n            if (!animateStyles.current[key]) animatedShapeChanged = true\n            animateStyles.current[key] = update(key, animateStyles.current[key], val)\n            seenAnimateKeys.add(key)\n          }\n        }\n\n        // the emitter receives a complete style. keep the Animated style graph\n        // equally complete, including a pseudo release that omits a pseudo-only\n        // key. React Native needs a commit when that graph's shape changes.\n        for (const key in animateStyles.current) {\n          if (!seenAnimateKeys.has(key)) {\n            delete animateStyles.current[key]\n            animatedShapeChanged = true\n          }\n        }\n        if (animatedTranforms.current.length > transformCount) {\n          animatedTranforms.current = animatedTranforms.current.slice(0, transformCount)\n          animatedShapeChanged = true\n        }\n\n        // run the queued animations immediately\n        runners.forEach((r) => r())\n\n        // pseudo state normally stays on the avoidReRenders path. adding or\n        // removing a style key cannot be expressed by an existing Animated.Value,\n        // so commit the pending state only for that structural change.\n        if (animatedShapeChanged && stateRef.current.nextState) {\n          stateRef.current.baseSetStateShallow?.(stateRef.current.nextState)\n        }\n\n        function update(\n          key: string,\n          animated: Animated.Value | undefined,\n          valIn: string | number\n        ) {\n          const isColor = colorStyleKey[key]\n          const [numVal, type] = isColor ? [0, undefined] : getValue(valIn)\n          let animateToValue = numVal\n          const value = animated || new Animated.Value(numVal)\n          const curInterpolation = animationsState.current.get(value)\n\n          if (type) {\n            animationsState.current.set(value, {\n              interpolation: value.interpolate(\n                getInterpolated(\n                  curInterpolation?.current ?? value['_value'],\n                  numVal,\n                  type\n                )\n              ),\n              current: numVal,\n            })\n          }\n\n          if (isColor) {\n            animateToValue = curInterpolation?.animateToValue ? 0 : 1\n            animationsState.current.set(value, {\n              current: valIn,\n              interpolation: value.interpolate(\n                getColorInterpolated(\n                  curInterpolation?.current as string,\n                  valIn as string,\n                  animateToValue\n                )\n              ),\n              animateToValue: curInterpolation?.animateToValue ? 0 : 1,\n            })\n          }\n\n          // the emitter runs for pseudo-state changes on a mounted node, so\n          // `default` is the state, but the transition is the one it was handed\n          const animationConfig = getAnimationConfig(\n            key,\n            animations,\n            emittedTransition ?? effectiveTransition,\n            'default'\n          )\n          runners.push(() => {\n            value.stopAnimation()\n            const { type, delay, ...config } = animationConfig\n            const anim = Animated[type || 'spring'](value, {\n              toValue: animateToValue,\n              ...config,\n              useNativeDriver: useNativeDriverForNode,\n            })\n            ;(delay ? Animated.sequence([Animated.delay(delay), anim]) : anim).start()\n          })\n\n          return value\n        }\n      })\n\n      if (process.env.NODE_ENV === 'development') {\n        if (props['debug'] === 'verbose') {\n          console.info(`Animated`, { response: res, inputStyle: style, isExiting })\n        }\n      }\n\n      return res\n    },\n  }\n}\n\nfunction getColorInterpolated(\n  currentColor: string | undefined,\n  nextColor: string,\n  animateToValue: number\n) {\n  const inputRange = [0, 1]\n  const outputRange = [currentColor ? currentColor : nextColor, nextColor]\n  if (animateToValue === 0) {\n    // because we are animating from value 1 to 0, we need to put target color at the beginning\n    outputRange.reverse()\n  }\n  return {\n    inputRange,\n    outputRange,\n  }\n}\n\nfunction getInterpolated(current: number, next: number, postfix = 'deg') {\n  if (next === current) {\n    current = next - 0.000000001\n  }\n  const inputRange = [current, next]\n  const outputRange = [`${current}${postfix}`, `${next}${postfix}`]\n  if (next < current) {\n    inputRange.reverse()\n    outputRange.reverse()\n  }\n  return {\n    inputRange,\n    outputRange,\n  }\n}\n\n/**\n * one resolved entry as a react-native Animated config.\n *\n * springs go in as stiffness/damping/mass, which is the parameterization RN\n * actually integrates. `bounciness`/`speed` and `tension`/`friction` are older\n * spellings of the same two numbers, so nothing is lost by not using them.\n */\nfunction entryToRN(entry: ResolvedEntry): AnimationConfig {\n  const extra = entry.timing.kind === 'spring' ? entry.timing.extra : undefined\n\n  if (entry.timing.kind === 'spring') {\n    return {\n      type: 'spring',\n      stiffness: entry.timing.stiffness,\n      damping: entry.timing.damping,\n      mass: entry.timing.mass,\n      ...(typeof extra?.velocity === 'number' ? { velocity: extra.velocity } : null),\n      ...(typeof extra?.overshootClamping === 'boolean'\n        ? { overshootClamping: extra.overshootClamping }\n        : null),\n      ...(entry.delayMs ? { delay: entry.delayMs } : null),\n    }\n  }\n\n  const bezier = easingToBezier(entry.timing.easing)\n  return {\n    type: 'timing',\n    duration: entry.timing.durationMs,\n    // `linear()` and `steps()` have no bezier equivalent; RN's default easing\n    // is the honest answer rather than a curve we made up\n    ...(bezier\n      ? { easing: Easing.bezier(bezier[0], bezier[1], bezier[2], bezier[3]) }\n      : null),\n    ...(entry.delayMs ? { delay: entry.delayMs } : null),\n  }\n}\n\n// a key the transition does not cover does not animate. snapping is what css\n// does for an unlisted property, so the drivers have to agree on it too.\nconst snapConfig: AnimationConfig = { type: 'timing', duration: 0 }\n\nfunction getAnimationConfig(\n  key: string,\n  animations: AnimationsConfig,\n  transition?: TransitionProp | null,\n  animationState: 'enter' | 'exit' | 'default' = 'default'\n): AnimationConfig {\n  const resolved = forAnimationState(\n    resolveTransition(transition, { animations }),\n    animationState\n  )\n  const entry = getTransitionForKey(resolved, key)\n  return entry ? entryToRN(entry) : snapConfig\n}\n\nfunction getValue(input: number | string, isColor = false) {\n  if (typeof input !== 'string') {\n    return [input] as const\n  }\n  // the unit is optional: unitless numbers reach here as strings (scale, and\n  // any bare token value), and the number may be fractional. matching only\n  // `[-0-9]+` followed by a required unit read \"1.5deg\" as 5 and gave NaN for\n  // \"0.95\", and an Animated animation toward NaN never calls its completion\n  // callback, which strands whatever waits on it.\n  const [_, number, after] = input.match(/(-?(?:\\d+\\.?\\d*|\\.\\d+))(deg|%|px)?/) ?? []\n  return [+number, after] as const\n}\n"
+  ]
+}

package/types/index.d.ts

@@ -1,4 +1,12 @@
-import "./polyfill";
-export * from "./createAnimations";
+import type { AnimationsConfig } from "@tamagui/animation-helpers";
+import type { AnimationDriverWithAnimatedNumbers } from "@tamagui/web";
+import type { CreateAnimationsOptions } from "./types";
+export type { CreateAnimationsOptions };
+/**
+* The web half of the native driver. It keeps the same signature so a shared
+* config typechecks on both platforms, and throws if anything actually reaches
+* for it: `Animated` lives in react-native, which web is not tied to.
+*/
+export declare const createAnimations: <A extends AnimationsConfig>(_animations: A, _options?: CreateAnimationsOptions) => AnimationDriverWithAnimatedNumbers<A>;
 
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1,11 +1,11 @@
 {
-  "mappings": "AAAA,OAAO;AAEP,cAAc",
+  "mappings": "AAAA,cAAc,wBAAwB;AACtC,cAAc,0CAA0C;AAExD,cAAc,+BAA+B;AAE7C,cAAc;;;;;;AAUd,OAAO,cAAM,mBAAoB,UAAU,kBACzC,aAAa,GACb,WAAW,4BACV,mCAAmC",
   "names": [],
   "sources": [
     "src/index.ts"
   ],
   "version": 3,
   "sourcesContent": [
-    "import './polyfill'\n\nexport * from './createAnimations'\n"
+    "import type { AnimationsConfig } from '@tamagui/animation-helpers'\nimport type { AnimationDriverWithAnimatedNumbers } from '@tamagui/web'\n\nimport type { CreateAnimationsOptions } from './types'\n\nexport type { CreateAnimationsOptions }\n\nconst unsupportedWebDriverMessage =\n  '[@tamagui/animations-react-native] This animation driver only works on native. On web, use @tamagui/animations-css, @tamagui/animations-motion, or @tamagui/animations-reanimated.'\n\n/**\n * The web half of the native driver. It keeps the same signature so a shared\n * config typechecks on both platforms, and throws if anything actually reaches\n * for it: `Animated` lives in react-native, which web is not tied to.\n */\nexport const createAnimations = <A extends AnimationsConfig>(\n  _animations: A,\n  _options?: CreateAnimationsOptions\n): AnimationDriverWithAnimatedNumbers<A> => {\n  throw new Error(unsupportedWebDriverMessage)\n}\n"
   ]
 }

package/types/index.native.d.ts

@@ -0,0 +1,4 @@
+import "./polyfill";
+export * from "./createAnimations.native";
+
+//# sourceMappingURL=index.native.d.ts.map

package/types/index.native.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,OAAO;AAEP,cAAc",
+  "names": [],
+  "sources": [
+    "src/index.native.ts"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import './polyfill'\n\nexport * from './createAnimations.native'\n"
+  ]
+}

package/types/types.d.ts

@@ -0,0 +1,5 @@
+export type CreateAnimationsOptions = {
+	useNativeDriver?: boolean;
+};
+
+//# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,YAAY,0BAA0B;CAEpC",
+  "names": [],
+  "sources": [
+    "src/types.ts"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "export type CreateAnimationsOptions = {\n  // override native driver detection (default: auto-detect Fabric)\n  useNativeDriver?: boolean\n}\n"
+  ]
+}