react-native-smooth-clip-view 0.3.0 → 0.4.0

package/src/drivers.native.ts

@@ -1,1599 +0,0 @@
-// The shared native driver: iOS and Android both execute this file, via the
-// one-line re-exports in drivers.ios.ts / drivers.android.ts that Metro's
-// platform resolution picks up from index.ts's `./drivers` import. Only the
-// `./smoothClipNative` import below is platform-split.
-import { useEffect, useRef } from 'react';
-import { Platform } from 'react-native';
-import { useSharedValue, type SharedValue } from 'react-native-reanimated';
-import { isRNRuntime, scheduleOnRN, scheduleOnUI } from 'react-native-worklets';
-import NativeSmoothClipModule from './smoothClipNative';
-import { getSmoothClipCapabilities } from './capabilities';
-import type {
-  ClipReduceMotion,
-  KeyframedClipAnimation,
-  SmoothClipAnimation,
-  SmoothClipDriver,
-  SmoothClipDriverOptions,
-  SpringClipAnimation,
-  TimingClipAnimation,
-} from './driverTypes';
-import {
-  allocateDriverId,
-  attachDriverState,
-  createDriverState,
-  detachDriverState,
-  getDriverState,
-  setDriverState,
-} from './driverState';
-import {
-  completeNativeAnimation,
-  synchronizeNativeCompletion,
-} from './nativeCompletion';
-import {
-  canonicalizeClipPresentation,
-  clipPresentationEquals,
-  createClipPresentation,
-  isFiniteClipPresentation,
-  type CanonicalSmoothClipPresentation,
-  type ClipGeometry,
-  type SmoothClipPresentation,
-} from './geometry';
-import {
-  createReactRequest,
-  rejectDriverRequests,
-  resolveReactRequest,
-} from './reactRequests';
-
-const INTERACTIVE = 0;
-const NATIVE = 1;
-
-// Only Android consumes the Reanimated start stamp (its frame-clock anchor —
-// docs/android-frame-clock-anchor.md). iOS's TurboModule reads its declared
-// parameters positionally and drops the trailing argument, so capturing the
-// stamp there is a wasted native _getAnimationTimestamp() call per animateTo.
-// Resolved once at module scope; the worklet captures the primitive.
-const NEEDS_START_STAMP = Platform.OS === 'android';
-const PRESENTATION_PROTOCOL_VERSION =
-  getSmoothClipCapabilities().presentationProtocolVersion;
-
-type NativeV2HostFunctions = Readonly<{
-  setClipPresentationV2(
-    driverId: number,
-    x: number,
-    y: number,
-    width: number,
-    height: number,
-    topLeftRadius: number,
-    topRightRadius: number,
-    bottomRightRadius: number,
-    bottomLeftRadius: number,
-    curveCode: number,
-    contentTranslateX: number,
-    contentTranslateY: number,
-    contentScale: number,
-    takeOwnership: boolean,
-    overridePendingAnimation: boolean,
-    recordVelocity?: boolean
-  ): void;
-  beginInteractionV2(driverId: number): readonly number[];
-  snapshotCurrentV2(driverId: number): readonly number[];
-  animateTimingV2(...args: readonly unknown[]): number;
-  animateSpringV2(...args: readonly unknown[]): number;
-  animateKeyframesV2(...args: readonly unknown[]): number;
-  animateTimingFromV2(...args: readonly unknown[]): number;
-  animateSpringFromV2(...args: readonly unknown[]): number;
-  animateKeyframesFromV2(...args: readonly unknown[]): number;
-  cancelAnimationV2(
-    driverId: number,
-    animationId: number,
-    behavior: number
-  ): readonly number[];
-}>;
-
-const NativeSmoothClipModuleV2 =
-  NativeSmoothClipModule as unknown as Partial<NativeV2HostFunctions>;
-
-// Widened like the animate* functions below: one trailing argument beyond the
-// TurboModule spec — whether this write should record an `'inherit'` velocity
-// sample. Android's JSI bindings read it (absent means record, the pre-flag
-// behavior); the iOS TurboModule reads its declared parameters positionally
-// and drops it, so iOS always records.
-type WithRecordVelocity<F> = F extends (...args: infer A) => infer R
-  ? (...args: [...A, recordVelocity?: boolean]) => R
-  : never;
-const setPresentationHostFunction: WithRecordVelocity<
-  typeof NativeSmoothClipModule.setClipPresentation
-> = NativeSmoothClipModule.setClipPresentation;
-const beginInteractionHostFunction = NativeSmoothClipModule.beginInteraction;
-
-// The animate* host functions take one argument beyond the TurboModule spec:
-// the Reanimated-rule start stamp in milliseconds (see animateOnUI). Android's
-// JSI bindings read it as an optional trailing argument; the iOS TurboModule
-// reads its declared parameters positionally and ignores extras, so the
-// codegen spec stays untouched and both platforms take the same call. A
-// narrower function is assignable to the widened type, so no cast is needed.
-type WithStartStamp<F> = F extends (...args: infer A) => infer R
-  ? (...args: [...A, startedAtMs: number]) => R
-  : never;
-const animateTimingHostFunction: WithStartStamp<
-  typeof NativeSmoothClipModule.animateTiming
-> = NativeSmoothClipModule.animateTiming;
-const animateSpringHostFunction: WithStartStamp<
-  typeof NativeSmoothClipModule.animateSpring
-> = NativeSmoothClipModule.animateSpring;
-const animateKeyframesHostFunction: WithStartStamp<
-  typeof NativeSmoothClipModule.animateKeyframes
-> = NativeSmoothClipModule.animateKeyframes;
-const rejectAnimationHostFunction = NativeSmoothClipModule.rejectAnimation;
-const cancelAnimationHostFunction = NativeSmoothClipModule.cancelAnimation;
-const destroyDriverHostFunction = NativeSmoothClipModule.destroyDriver;
-const setPresentationV2HostFunction =
-  NativeSmoothClipModuleV2.setClipPresentationV2;
-const beginInteractionV2HostFunction =
-  NativeSmoothClipModuleV2.beginInteractionV2;
-const snapshotCurrentV2HostFunction =
-  NativeSmoothClipModuleV2.snapshotCurrentV2;
-const animateTimingV2HostFunction = NativeSmoothClipModuleV2.animateTimingV2;
-const animateSpringV2HostFunction = NativeSmoothClipModuleV2.animateSpringV2;
-const animateKeyframesV2HostFunction =
-  NativeSmoothClipModuleV2.animateKeyframesV2;
-const animateTimingFromV2HostFunction =
-  NativeSmoothClipModuleV2.animateTimingFromV2;
-const animateSpringFromV2HostFunction =
-  NativeSmoothClipModuleV2.animateSpringFromV2;
-const animateKeyframesFromV2HostFunction =
-  NativeSmoothClipModuleV2.animateKeyframesFromV2;
-const cancelAnimationV2HostFunction =
-  NativeSmoothClipModuleV2.cancelAnimationV2;
-
-// Workaround for react-native-worklets 0.10.0 (fixed upstream in >=0.10.1,
-// which drops the registry/proxy design; kept while the peer range still
-// allows 0.10.0 consumers): the RN-side serialization cache
-// hands out one remote-function registry id per function forever, but the
-// registry entry is deleted as soon as any transient UI-side proxy of that
-// function is garbage collected. A later scheduleOnRN for the same function
-// then reads `undefined` from the registry and aborts in Value::getObject.
-// Pinning one UI-side reference for the app lifetime keeps the proxy — and
-// with it the registry entry — alive. Remove once the peer range requires
-// worklets >=0.10.1.
-scheduleOnUI((resolver: typeof resolveReactRequest) => {
-  'worklet';
-  (globalThis as Record<string, unknown>).__smoothClipPinnedResolver = resolver;
-}, resolveReactRequest);
-
-function reduceMotionCode(value: ClipReduceMotion): number {
-  switch (value) {
-    case 'always':
-      return 1;
-    case 'never':
-      return 2;
-    default:
-      return 0;
-  }
-}
-
-function animationIsFinite(
-  animation: SmoothClipAnimation,
-  strictV2: boolean
-): boolean {
-  'worklet';
-  if (
-    animation.from !== undefined &&
-    !isFiniteClipPresentation(animation.from)
-  ) {
-    // Silently dropping an invalid explicit start would re-open the exact
-    // stale-start handoff `from` exists to close — reject the whole call.
-    return false;
-  }
-  if (animation.type === 'timing') {
-    const [x1, , x2] = animation.controlPoints;
-    return (
-      Number.isFinite(animation.duration) &&
-      (!strictV2 || animation.duration >= 0) &&
-      animation.controlPoints.every(Number.isFinite) &&
-      // A cubic-bezier easing is only defined for x within [0,1] (the CSS /
-      // CoreAnimation / Reanimated Easing.bezier contract). Out-of-range x
-      // makes the Android parameter solve meaningless while CoreAnimation
-      // silently clamps — reject like any other invalid input instead of
-      // diverging per platform.
-      (!strictV2 || (x1 >= 0 && x1 <= 1 && x2 >= 0 && x2 <= 1))
-    );
-  }
-  if (animation.type === 'spring') {
-    const mass = animation.mass ?? 1;
-    const stiffness = animation.stiffness ?? 100;
-    const damping = animation.damping ?? 10;
-    const initialVelocity =
-      animation.initialVelocity === 'inherit'
-        ? 0
-        : (animation.initialVelocity ?? 0);
-    return (
-      [mass, stiffness, damping, initialVelocity].every(Number.isFinite) &&
-      (!strictV2 || (mass > 0 && stiffness > 0 && damping >= 0))
-    );
-  }
-  // Keyframe frames validate inside flattenFiniteKeyframes — one traversal
-  // both checks and flattens, instead of walking every frame twice. The type
-  // check is statically always-true for the TS union but load-bearing for JS
-  // callers: an unrecognized type must reject here, or it would skip the
-  // keyframe gate entirely and hand native a null frames array.
-  return (
-    animation.type === 'keyframes' && (!strictV2 || animation.duration >= 0)
-  );
-}
-
-function presentationFromNative(
-  values: ReadonlyArray<number>,
-  fallback: CanonicalSmoothClipPresentation,
-  offset = 0
-): CanonicalSmoothClipPresentation {
-  'worklet';
-  if (values.length >= offset + 12) {
-    const presentation = canonicalizeClipPresentation({
-      clip: {
-        x: values[offset] as number,
-        y: values[offset + 1] as number,
-        width: values[offset + 2] as number,
-        height: values[offset + 3] as number,
-        radius: 0,
-        topLeftRadius: values[offset + 4] as number,
-        topRightRadius: values[offset + 5] as number,
-        bottomRightRadius: values[offset + 6] as number,
-        bottomLeftRadius: values[offset + 7] as number,
-        curve: values[offset + 8] === 1 ? 'continuous' : 'circular',
-      },
-      contentTranslateX: values[offset + 9] as number,
-      contentTranslateY: values[offset + 10] as number,
-      contentScale: values[offset + 11] as number,
-    });
-    return presentation ?? fallback;
-  }
-  if (values.length < offset + 7) return fallback;
-  const presentation = canonicalizeClipPresentation({
-    clip: {
-      x: values[offset] as number,
-      y: values[offset + 1] as number,
-      width: values[offset + 2] as number,
-      height: values[offset + 3] as number,
-      radius: values[offset + 4] as number,
-    },
-    contentTranslateX: values[offset + 5] as number,
-    contentTranslateY: values[offset + 6] as number,
-  });
-  return presentation ?? fallback;
-}
-
-function curveCode(presentation: CanonicalSmoothClipPresentation): number {
-  'worklet';
-  return presentation.clip.curve === 'continuous' ? 1 : 0;
-}
-
-function isV1Compatible(
-  presentation: CanonicalSmoothClipPresentation
-): boolean {
-  'worklet';
-  const clip = presentation.clip;
-  return (
-    clip.curve === 'circular' &&
-    clip.topLeftRadius === clip.radius &&
-    clip.topRightRadius === clip.radius &&
-    clip.bottomRightRadius === clip.radius &&
-    clip.bottomLeftRadius === clip.radius &&
-    presentation.contentScale === 1
-  );
-}
-
-function springScaleIsProvablyPositive(
-  start: CanonicalSmoothClipPresentation,
-  target: CanonicalSmoothClipPresentation,
-  animation: SpringClipAnimation
-): boolean {
-  'worklet';
-  if (start.contentScale === target.contentScale) return true;
-
-  // A zero-velocity critically/over-damped step is monotonic, so its sampled
-  // scale remains between two already-positive endpoints. Inherited or
-  // under-damped configurations can overshoot; callers must compile those
-  // plans to exact keyframes instead of risking a non-positive transform.
-  const mass = animation.mass ?? 1;
-  const stiffness = animation.stiffness ?? 100;
-  const damping = animation.damping ?? 10;
-  return (
-    animation.initialVelocity === 0 && damping * damping >= 4 * mass * stiffness
-  );
-}
-
-// Validates and flattens the keyframe list in one traversal (the flat number
-// array is the wire format the native side reads back positionally). Returns
-// null when any frame is invalid — same rejection contract the two-pass
-// validate-then-flatten had.
-function flattenFiniteKeyframes(
-  target: CanonicalSmoothClipPresentation,
-  animation: KeyframedClipAnimation
-): {
-  frames: number[];
-  canonicalFrames: CanonicalSmoothClipPresentation[];
-} | null {
-  'worklet';
-  if (!Number.isFinite(animation.duration) || animation.frames.length < 2) {
-    return null;
-  }
-  const values: number[] = [];
-  const canonicalFrames: CanonicalSmoothClipPresentation[] = [];
-  let previousOffset = -1;
-  for (const frame of animation.frames) {
-    const { offset } = frame;
-    const presentation = canonicalizeClipPresentation(frame.presentation);
-    if (
-      !Number.isFinite(offset) ||
-      offset < 0 ||
-      offset > 1 ||
-      offset <= previousOffset ||
-      presentation === null ||
-      presentation.clip.curve !== target.clip.curve
-    ) {
-      return null;
-    }
-    previousOffset = offset;
-    canonicalFrames.push(presentation);
-    const { clip, contentTranslateX, contentTranslateY, contentScale } =
-      presentation;
-    values.push(
-      offset,
-      clip.x,
-      clip.y,
-      clip.width,
-      clip.height,
-      clip.topLeftRadius,
-      clip.topRightRadius,
-      clip.bottomRightRadius,
-      clip.bottomLeftRadius,
-      curveCode(presentation),
-      contentTranslateX,
-      contentTranslateY,
-      contentScale
-    );
-  }
-  if (
-    animation.frames[0]?.offset !== 0 ||
-    previousOffset !== 1 ||
-    !clipPresentationEquals(
-      canonicalFrames[canonicalFrames.length - 1] ?? null,
-      target
-    )
-  ) {
-    return null;
-  }
-  return { frames: values, canonicalFrames };
-}
-
-function flattenV1Keyframes(
-  frames: readonly CanonicalSmoothClipPresentation[],
-  offsets: readonly number[]
-): number[] {
-  'worklet';
-  const values: number[] = [];
-  for (let index = 0; index < frames.length; index += 1) {
-    const presentation = frames[index];
-    const offset = offsets[index];
-    if (presentation === undefined || offset === undefined) continue;
-    values.push(
-      offset,
-      presentation.clip.x,
-      presentation.clip.y,
-      presentation.clip.width,
-      presentation.clip.height,
-      presentation.clip.radius,
-      presentation.contentTranslateX,
-      presentation.contentTranslateY
-    );
-  }
-  return values;
-}
-
-function uiOnly(): never {
-  'worklet';
-  throw new Error(
-    '[SmoothClipView] driver.ui methods must run on the UI runtime. Use driver.react from React code.'
-  );
-}
-
-export function useSmoothClipDriver(
-  initialValue: ClipGeometry | SmoothClipPresentation,
-  options: SmoothClipDriverOptions = {}
-): SmoothClipDriver {
-  const requestedInitialPresentation =
-    'clip' in initialValue
-      ? initialValue
-      : createClipPresentation(initialValue);
-  const initialPresentation = canonicalizeClipPresentation(
-    requestedInitialPresentation
-  );
-  if (initialPresentation === null) {
-    throw new Error('[SmoothClipView] Initial presentation must be finite.');
-  }
-  const presentation =
-    useSharedValue<SmoothClipPresentation>(initialPresentation);
-  const ownership = useSharedValue(INTERACTIVE);
-  const suppressDeliveries = useSharedValue(0);
-  const activeAnimationId = useSharedValue(0);
-  // Non-zero after a setScalars hot write: driver.presentation is then stale,
-  // so animateTo must start from the native registry's latest value instead
-  // of snapping back to the stale SharedValue.
-  const scalarsStale = useSharedValue(0);
-  // Non-zero between the effect cleanup's native teardown and the next effect
-  // run. Native cannot tell "this driver was never seeded" from "this driver
-  // was destroyed and erased" — both are a missing registry entry — so the
-  // animation entry points would happily create a fresh state for a call that
-  // arrives after the hook is gone, leaving a latch that no view starts and no
-  // destroy cancels. Only the UI side knows the difference, so it is decided
-  // here.
-  const disposed = useSharedValue(0);
-  const callbackRef = useRef(options.onAnimationComplete);
-  const driverRef = useRef<SmoothClipDriver | null>(null);
-  callbackRef.current = options.onAnimationComplete;
-
-  if (driverRef.current === null) {
-    const driverId = allocateDriverId();
-    const reduceMotion = reduceMotionCode(options.reduceMotion ?? 'system');
-    // Captured once, like reduceMotion. Only the per-frame setScalars stream
-    // consults it; set(), the fused animateTo `from` seed, and the effect's
-    // declarative deliveries always record, so every once-per-call channel
-    // keeps its pre-flag 'inherit' behavior.
-    const velocityTracking = options.velocityTracking === true;
-    const seedPresentation = (next: CanonicalSmoothClipPresentation) => {
-      'worklet';
-      if (clipPresentationEquals(presentation.value, next)) return;
-      suppressDeliveries.value += 1;
-      presentation.value = next;
-      // The listener runs synchronously inside that assignment, so the credit
-      // is either spent by now or was never spendable. deliver() returns before
-      // the decrement whenever the value dedupes against `last` — which happens
-      // exactly when native already holds it, e.g. freezing a latch back to the
-      // value it started from. An unspent credit would then swallow the next
-      // real declarative write and leave native a geometry behind for good.
-      if (suppressDeliveries.value > 0) suppressDeliveries.value -= 1;
-    };
-
-    const beginOnUI = (): CanonicalSmoothClipPresentation => {
-      'worklet';
-      const fallback =
-        canonicalizeClipPresentation(presentation.value) ?? initialPresentation;
-      if (disposed.value !== 0) return fallback;
-      const current = presentationFromNative(
-        PRESENTATION_PROTOCOL_VERSION === 2 && beginInteractionV2HostFunction
-          ? beginInteractionV2HostFunction(driverId)
-          : beginInteractionHostFunction(driverId),
-        fallback
-      );
-      activeAnimationId.value = 0;
-      ownership.value = INTERACTIVE;
-      scalarsStale.value = 0;
-      seedPresentation(current);
-      return current;
-    };
-
-    const setOnUI = (next: SmoothClipPresentation): void => {
-      'worklet';
-      const canonical = canonicalizeClipPresentation(next);
-      if (disposed.value !== 0 || canonical === null) return;
-      activeAnimationId.value = 0;
-      ownership.value = INTERACTIVE;
-      scalarsStale.value = 0;
-      const { clip, contentTranslateX, contentTranslateY, contentScale } =
-        canonical;
-      // Always records: only the per-frame setScalars hot path is gated by
-      // velocityTracking. set() already pays full validation and a SharedValue
-      // seed per call, so the sample recording is noise here.
-      if (
-        PRESENTATION_PROTOCOL_VERSION === 2 &&
-        setPresentationV2HostFunction
-      ) {
-        setPresentationV2HostFunction(
-          driverId,
-          clip.x,
-          clip.y,
-          clip.width,
-          clip.height,
-          clip.topLeftRadius,
-          clip.topRightRadius,
-          clip.bottomRightRadius,
-          clip.bottomLeftRadius,
-          curveCode(canonical),
-          contentTranslateX,
-          contentTranslateY,
-          contentScale,
-          true,
-          false,
-          true
-        );
-      } else if (isV1Compatible(canonical)) {
-        setPresentationHostFunction(
-          driverId,
-          clip.x,
-          clip.y,
-          clip.width,
-          clip.height,
-          clip.radius,
-          contentTranslateX,
-          contentTranslateY,
-          true,
-          false
-        );
-      } else {
-        return;
-      }
-      seedPresentation(canonical);
-    };
-
-    const setScalarsOnUI = (
-      x: number,
-      y: number,
-      width: number,
-      height: number,
-      radius: number,
-      contentTranslateX: number,
-      contentTranslateY: number,
-      overridePendingAnimation = false,
-      forceRecordVelocity = false
-    ): void => {
-      'worklet';
-      // Resolved in the body, not as a default-parameter initializer: the
-      // worklets Babel plugin only captures closure variables referenced
-      // inside the function body, so `= velocityTracking` up in the parameter
-      // list would throw "Property 'velocityTracking' doesn't exist" on the
-      // UI runtime.
-      const recordVelocity = forceRecordVelocity || velocityTracking;
-      // Number.isFinite (not a fused arithmetic gate): it also rejects
-      // non-number types, which arithmetic would coerce past the gate and
-      // into a UI-runtime throw from the binding's asNumber. The gate must
-      // stay on this side of the bridge: the native binding drops non-finite
-      // writes silently, and flipping the ownership SharedValues below for a
-      // write native never applied would let the deliver listener record
-      // values native has not observed — a later identical declarative write
-      // then dedupes against them and is swallowed for good.
-      if (
-        disposed.value !== 0 ||
-        !Number.isFinite(x) ||
-        !Number.isFinite(y) ||
-        !Number.isFinite(width) ||
-        !Number.isFinite(height) ||
-        !Number.isFinite(radius) ||
-        !Number.isFinite(contentTranslateX) ||
-        !Number.isFinite(contentTranslateY)
-      ) {
-        return;
-      }
-      if (activeAnimationId.value !== 0) activeAnimationId.value = 0;
-      if (ownership.value !== INTERACTIVE) ownership.value = INTERACTIVE;
-      if (scalarsStale.value === 0) scalarsStale.value = 1;
-      setPresentationHostFunction(
-        driverId,
-        x,
-        y,
-        width,
-        height,
-        radius,
-        contentTranslateX,
-        contentTranslateY,
-        true,
-        overridePendingAnimation,
-        recordVelocity
-      );
-    };
-
-    const setPresentationScalarsOnUI = (
-      x: number,
-      y: number,
-      width: number,
-      height: number,
-      topLeftRadius: number,
-      topRightRadius: number,
-      bottomRightRadius: number,
-      bottomLeftRadius: number,
-      nextCurveCode: number,
-      contentTranslateX: number,
-      contentTranslateY: number,
-      contentScale: number,
-      overridePendingAnimation = false,
-      forceRecordVelocity = false
-    ): void => {
-      'worklet';
-      const values = [
-        x,
-        y,
-        width,
-        height,
-        topLeftRadius,
-        topRightRadius,
-        bottomRightRadius,
-        bottomLeftRadius,
-        nextCurveCode,
-        contentTranslateX,
-        contentTranslateY,
-        contentScale,
-      ];
-      if (
-        disposed.value !== 0 ||
-        !values.every(Number.isFinite) ||
-        (nextCurveCode !== 0 && nextCurveCode !== 1) ||
-        contentScale <= 0
-      ) {
-        return;
-      }
-      const recordVelocity = forceRecordVelocity || velocityTracking;
-      if (
-        PRESENTATION_PROTOCOL_VERSION !== 2 ||
-        !setPresentationV2HostFunction
-      ) {
-        if (
-          nextCurveCode === 0 &&
-          contentScale === 1 &&
-          topLeftRadius === topRightRadius &&
-          topLeftRadius === bottomRightRadius &&
-          topLeftRadius === bottomLeftRadius
-        ) {
-          setScalarsOnUI(
-            x,
-            y,
-            width,
-            height,
-            topLeftRadius,
-            contentTranslateX,
-            contentTranslateY,
-            overridePendingAnimation,
-            forceRecordVelocity
-          );
-        }
-        return;
-      }
-      if (activeAnimationId.value !== 0) activeAnimationId.value = 0;
-      if (ownership.value !== INTERACTIVE) ownership.value = INTERACTIVE;
-      if (scalarsStale.value === 0) scalarsStale.value = 1;
-      setPresentationV2HostFunction(
-        driverId,
-        x,
-        y,
-        width,
-        height,
-        topLeftRadius,
-        topRightRadius,
-        bottomRightRadius,
-        bottomLeftRadius,
-        nextCurveCode,
-        contentTranslateX,
-        contentTranslateY,
-        contentScale,
-        true,
-        overridePendingAnimation,
-        recordVelocity
-      );
-    };
-
-    const animateOnUI = (
-      target: SmoothClipPresentation,
-      animation: SmoothClipAnimation
-    ): number => {
-      'worklet';
-      // Cleanup owns the terminal state. Check it before validation so even an
-      // invalid stale call cannot mint a native rejection id/completion against
-      // a driver whose listener and registry entry are already gone.
-      if (disposed.value !== 0) return 0;
-      const canonicalTarget = canonicalizeClipPresentation(target);
-      const canonicalFrom =
-        animation.from === undefined
-          ? undefined
-          : canonicalizeClipPresentation(animation.from);
-      const keyframeResult =
-        animation.type === 'keyframes'
-          ? canonicalTarget === null
-            ? null
-            : flattenFiniteKeyframes(canonicalTarget, animation)
-          : null;
-      if (
-        canonicalTarget === null ||
-        (animation.from !== undefined && canonicalFrom === null) ||
-        (animation.type === 'keyframes' && keyframeResult === null)
-      ) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      const resolvedFrom = canonicalFrom ?? undefined;
-      const v1Compatible =
-        isV1Compatible(canonicalTarget) &&
-        (resolvedFrom === undefined || isV1Compatible(resolvedFrom)) &&
-        (animation.type !== 'keyframes' ||
-          (keyframeResult?.canonicalFrames.every(isV1Compatible) ?? false));
-      // V1-representable plans deliberately stay on the original seven-scalar
-      // bridge even when V2 is installed. Besides preserving bridge shape,
-      // this retains V1's finite-value/clamping and host-normalization rules.
-      const useV2 = !v1Compatible;
-      if (!animationIsFinite(animation, useV2)) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      const hasV2Protocol =
-        PRESENTATION_PROTOCOL_VERSION === 2 &&
-        snapshotCurrentV2HostFunction !== undefined &&
-        animateTimingV2HostFunction !== undefined &&
-        animateSpringV2HostFunction !== undefined &&
-        animateKeyframesV2HostFunction !== undefined;
-      const hasAtomicFromMethod =
-        resolvedFrom === undefined ||
-        (animation.type === 'timing'
-          ? animateTimingFromV2HostFunction !== undefined
-          : animation.type === 'spring'
-            ? animateSpringFromV2HostFunction !== undefined
-            : animateKeyframesFromV2HostFunction !== undefined);
-      // This is intentionally before sampling or any ownership/group/
-      // presentation mutation. New JS against old native must fail closed,
-      // and an explicit V2 start must never degrade to set()+animate().
-      if (useV2 && (!hasV2Protocol || !hasAtomicFromMethod)) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      if (
-        useV2 &&
-        resolvedFrom !== undefined &&
-        animation.type === 'keyframes' &&
-        !clipPresentationEquals(
-          keyframeResult?.canonicalFrames[0] ?? null,
-          resolvedFrom
-        )
-      ) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      const currentPresentation =
-        canonicalizeClipPresentation(presentation.value) ?? initialPresentation;
-      const sampledStart =
-        resolvedFrom ??
-        (useV2
-          ? presentationFromNative(
-              snapshotCurrentV2HostFunction!(driverId),
-              currentPresentation
-            )
-          : currentPresentation);
-      // setPresentationScalars intentionally leaves the public SharedValue
-      // stale to keep the hot path allocation-free. Validate an implicit
-      // retarget against the sampled native-visible start, not that stale JS
-      // value; otherwise a streamed curve transition cannot settle natively on
-      // its new (now stable) curve.
-      if (canonicalTarget.clip.curve !== sampledStart.clip.curve) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      if (
-        useV2 &&
-        animation.type === 'spring' &&
-        !springScaleIsProvablyPositive(sampledStart, canonicalTarget, animation)
-      ) {
-        return rejectAnimationHostFunction(driverId);
-      }
-      // Past the hook's cleanup the native entry is gone for good, and an
-      // interactive start here would recreate it as a latch nothing can ever
-      // start or cancel. Reject before any side effect — not via
-      // rejectAnimation, which would mint an id and a completion for a driver
-      // whose JS state is already detached. This is the "unsupported dispatch"
-      // arm of the documented 0 contract.
-      const from = resolvedFrom;
-      if (from !== undefined && !useV2) {
-        // Fused hot write: exactly setScalars(from…) issued immediately
-        // before the handoff, so native's latest value — the animation
-        // start below — is the caller's explicit presentation. Also
-        // re-grabs from a running animation, which the implicit
-        // interactive-start path would silently skip. Always records a
-        // velocity sample regardless of velocityTracking: this is one write
-        // per animateTo, not the per-frame stream the flag exists to keep
-        // cheap, and an unrecorded seed would invalidate the history a
-        // set()-driven drag just recorded (the tracker's coalesce and
-        // identical-re-record rules were designed for exactly this write).
-        setScalarsOnUI(
-          from.clip.x,
-          from.clip.y,
-          from.clip.width,
-          from.clip.height,
-          from.clip.radius,
-          from.contentTranslateX,
-          from.contentTranslateY,
-          true,
-          true
-        );
-      }
-
-      // After a setScalars hot write the SharedValue no longer matches what
-      // is on screen; passing it as the start would snap the animation back.
-      // Without an interactive start, native resolves the start from its own
-      // latest value instead.
-      const scalarsWereStale = scalarsStale.value !== 0;
-      const hasInteractiveStart =
-        ownership.value === INTERACTIVE && !scalarsWereStale;
-      const start =
-        canonicalizeClipPresentation(presentation.value) ?? initialPresentation;
-      // V1 preserves the old optimistic SharedValue ownership transition.
-      // V2 commits it only after native has atomically accepted the plan.
-      if (!useV2) {
-        ownership.value = NATIVE;
-        presentation.value = canonicalTarget;
-        scalarsStale.value = 0;
-      }
-      const dispatchStart = useV2 && from !== undefined ? from : start;
-      const startClip = dispatchStart.clip;
-      const targetClip = canonicalTarget.clip;
-      // Reanimated stamps a parallel animation's t0 on this same runtime as
-      // `__frameTimestamp || _getAnimationTimestamp()` (valueSetter.ts).
-      // Capturing the identical value here and handing it to the integrator
-      // keeps clip and content phase-locked in every branch — including a
-      // start issued from CALLBACK_INPUT (batched gesture moves), where the
-      // dispatching frame's stamp is EARLIER than the call: the native min()
-      // anchor alone would adopt that frame stamp while Reanimated, outside
-      // its rAF flush where __frameTimestamp is cleared, keeps the wall
-      // clock — a lead lasting the whole animation. NaN when the globals are
-      // absent (tests, non-worklets runtimes): native then falls back to its
-      // own clock plus the min() anchor, the pre-stamp behavior. On iOS the
-      // stamp is always NaN: Core Animation anchors at commit time and the
-      // TurboModule discards the argument, so the capture would only cost.
-      const workletGlobal = globalThis as {
-        __frameTimestamp?: number;
-        _getAnimationTimestamp?: () => number;
-      };
-      const startedAtMs = !NEEDS_START_STAMP
-        ? Number.NaN
-        : workletGlobal.__frameTimestamp ||
-          (typeof workletGlobal._getAnimationTimestamp === 'function'
-            ? workletGlobal._getAnimationTimestamp()
-            : Number.NaN);
-      let animationId: number;
-
-      if (animation.type === 'timing' && useV2) {
-        const [x1, y1, x2, y2] = animation.controlPoints;
-        animationId =
-          from !== undefined
-            ? animateTimingFromV2HostFunction!(
-                driverId,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                animation.duration,
-                x1,
-                y1,
-                x2,
-                y2,
-                reduceMotion,
-                startedAtMs
-              )
-            : animateTimingV2HostFunction!(
-                driverId,
-                hasInteractiveStart,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                animation.duration,
-                x1,
-                y1,
-                x2,
-                y2,
-                reduceMotion,
-                startedAtMs
-              );
-      } else if (animation.type === 'timing') {
-        const [x1, y1, x2, y2] = animation.controlPoints;
-        animationId = animateTimingHostFunction(
-          driverId,
-          hasInteractiveStart,
-          startClip.x,
-          startClip.y,
-          startClip.width,
-          startClip.height,
-          startClip.radius,
-          start.contentTranslateX,
-          start.contentTranslateY,
-          targetClip.x,
-          targetClip.y,
-          targetClip.width,
-          targetClip.height,
-          targetClip.radius,
-          canonicalTarget.contentTranslateX,
-          canonicalTarget.contentTranslateY,
-          Math.max(0, animation.duration),
-          x1,
-          y1,
-          x2,
-          y2,
-          reduceMotion,
-          startedAtMs
-        );
-      } else if (animation.type === 'spring' && useV2) {
-        const inheritVelocity =
-          animation.initialVelocity === undefined ||
-          animation.initialVelocity === 'inherit';
-        const mass = animation.mass ?? 1;
-        const stiffness = animation.stiffness ?? 100;
-        const damping = animation.damping ?? 10;
-        const initialVelocity = inheritVelocity
-          ? 0
-          : (animation.initialVelocity as number);
-        animationId =
-          from !== undefined
-            ? animateSpringFromV2HostFunction!(
-                driverId,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                mass,
-                stiffness,
-                damping,
-                initialVelocity,
-                inheritVelocity,
-                reduceMotion,
-                startedAtMs
-              )
-            : animateSpringV2HostFunction!(
-                driverId,
-                hasInteractiveStart,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                mass,
-                stiffness,
-                damping,
-                initialVelocity,
-                inheritVelocity,
-                reduceMotion,
-                startedAtMs
-              );
-      } else if (animation.type === 'spring') {
-        const inheritVelocity =
-          animation.initialVelocity === undefined ||
-          animation.initialVelocity === 'inherit';
-        animationId = animateSpringHostFunction(
-          driverId,
-          hasInteractiveStart,
-          startClip.x,
-          startClip.y,
-          startClip.width,
-          startClip.height,
-          startClip.radius,
-          start.contentTranslateX,
-          start.contentTranslateY,
-          targetClip.x,
-          targetClip.y,
-          targetClip.width,
-          targetClip.height,
-          targetClip.radius,
-          canonicalTarget.contentTranslateX,
-          canonicalTarget.contentTranslateY,
-          Math.max(0.0001, animation.mass ?? 1),
-          Math.max(0.0001, animation.stiffness ?? 100),
-          Math.max(0, animation.damping ?? 10),
-          inheritVelocity ? 0 : (animation.initialVelocity as number),
-          inheritVelocity,
-          reduceMotion,
-          startedAtMs
-        );
-      } else if (useV2) {
-        const frames = (keyframeResult as NonNullable<typeof keyframeResult>)
-          .frames;
-        animationId =
-          from !== undefined
-            ? animateKeyframesFromV2HostFunction!(
-                driverId,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                animation.duration,
-                frames,
-                reduceMotion,
-                startedAtMs
-              )
-            : animateKeyframesV2HostFunction!(
-                driverId,
-                hasInteractiveStart,
-                startClip.x,
-                startClip.y,
-                startClip.width,
-                startClip.height,
-                startClip.topLeftRadius,
-                startClip.topRightRadius,
-                startClip.bottomRightRadius,
-                startClip.bottomLeftRadius,
-                curveCode(dispatchStart),
-                dispatchStart.contentTranslateX,
-                dispatchStart.contentTranslateY,
-                dispatchStart.contentScale,
-                targetClip.x,
-                targetClip.y,
-                targetClip.width,
-                targetClip.height,
-                targetClip.topLeftRadius,
-                targetClip.topRightRadius,
-                targetClip.bottomRightRadius,
-                targetClip.bottomLeftRadius,
-                curveCode(canonicalTarget),
-                canonicalTarget.contentTranslateX,
-                canonicalTarget.contentTranslateY,
-                canonicalTarget.contentScale,
-                animation.duration,
-                frames,
-                reduceMotion,
-                startedAtMs
-              );
-      } else {
-        animationId = animateKeyframesHostFunction(
-          driverId,
-          hasInteractiveStart,
-          startClip.x,
-          startClip.y,
-          startClip.width,
-          startClip.height,
-          startClip.radius,
-          start.contentTranslateX,
-          start.contentTranslateY,
-          targetClip.x,
-          targetClip.y,
-          targetClip.width,
-          targetClip.height,
-          targetClip.radius,
-          canonicalTarget.contentTranslateX,
-          canonicalTarget.contentTranslateY,
-          Math.max(0, animation.duration),
-          // Non-null here: the validation gate above rejected null before any
-          // side effect.
-          flattenV1Keyframes(
-            (keyframeResult as NonNullable<typeof keyframeResult>)
-              .canonicalFrames,
-            animation.frames.map((frame) => frame.offset)
-          ),
-          reduceMotion,
-          startedAtMs
-        );
-      }
-      if (animationId === 0) {
-        // The 0 sentinel: off-main, invalid-id, or otherwise unsupported
-        // dispatch. A missing driver is accepted when this call carries the
-        // authoritative interactive start above; a start-less missing-state
-        // request remains unsupported rather than inventing zero geometry.
-        // Validation failures never get here: they reject before any side
-        // effect, with a fresh id and one finished:false completion once the
-        // native entry exists — in the pre-seed window rejectAnimation has no
-        // entry and returns the bare 0 sentinel with no completion instead.
-        if (!useV2) {
-          ownership.value = INTERACTIVE;
-          presentation.value = start;
-          if (scalarsWereStale) scalarsStale.value = 1;
-          activeAnimationId.value = 0;
-        }
-        return rejectAnimationHostFunction(driverId);
-      }
-      if (useV2) {
-        ownership.value = NATIVE;
-        presentation.value = canonicalTarget;
-        scalarsStale.value = 0;
-      }
-      activeAnimationId.value = animationId;
-      return animationId;
-    };
-
-    const cancelOnUI = (
-      animationId = 0,
-      behavior: 'current' | 'target' = 'current'
-    ): CanonicalSmoothClipPresentation => {
-      'worklet';
-      // Past the hook's cleanup the native entry is gone; the call would fail
-      // defined (handled=false) but it is the last driver.ui path that still
-      // crosses into native after the tombstone. Guard it like the rest.
-      const fallback =
-        canonicalizeClipPresentation(presentation.value) ?? initialPresentation;
-      if (disposed.value !== 0) return fallback;
-      const values =
-        PRESENTATION_PROTOCOL_VERSION === 2 && cancelAnimationV2HostFunction
-          ? cancelAnimationV2HostFunction(
-              driverId,
-              animationId,
-              behavior === 'target' ? 1 : 0
-            )
-          : cancelAnimationHostFunction(
-              driverId,
-              animationId,
-              behavior === 'target' ? 1 : 0
-            );
-      if (values.length < 8 || values[0] !== 1) return fallback;
-      const current = presentationFromNative(values, fallback, 1);
-      activeAnimationId.value = 0;
-      ownership.value = INTERACTIVE;
-      scalarsStale.value = 0;
-      seedPresentation(current);
-      return current;
-    };
-
-    const driver: SmoothClipDriver = {
-      kind: 'hybrid',
-      presentation,
-      ui: {
-        beginInteraction() {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          return beginOnUI();
-        },
-        set(next) {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          setOnUI(next);
-        },
-        setScalars(
-          x,
-          y,
-          width,
-          height,
-          radius,
-          contentTranslateX,
-          contentTranslateY
-        ) {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          setScalarsOnUI(
-            x,
-            y,
-            width,
-            height,
-            radius,
-            contentTranslateX,
-            contentTranslateY
-          );
-        },
-        setPresentationScalars(
-          x,
-          y,
-          width,
-          height,
-          topLeftRadius,
-          topRightRadius,
-          bottomRightRadius,
-          bottomLeftRadius,
-          nextCurveCode,
-          contentTranslateX,
-          contentTranslateY,
-          contentScale
-        ) {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          setPresentationScalarsOnUI(
-            x,
-            y,
-            width,
-            height,
-            topLeftRadius,
-            topRightRadius,
-            bottomRightRadius,
-            bottomLeftRadius,
-            nextCurveCode,
-            contentTranslateX,
-            contentTranslateY,
-            contentScale
-          );
-        },
-        animateTo(target, animation) {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          return animateOnUI(target, animation);
-        },
-        cancel(animationId = 0, behavior = 'current') {
-          'worklet';
-          if (isRNRuntime()) return uiOnly();
-          return cancelOnUI(animationId, behavior);
-        },
-      },
-      react: {
-        beginInteraction() {
-          const { requestId, promise } =
-            createReactRequest<CanonicalSmoothClipPresentation>(driverId);
-          scheduleOnUI(() => {
-            'worklet';
-            const result = beginOnUI();
-            scheduleOnRN(resolveReactRequest, driverId, requestId, result);
-          });
-          return promise;
-        },
-        set(next) {
-          // Teardown resolves (undefined) rather than rejects: `set` is a
-          // documented fire-and-forget call, and a promise discarded with
-          // `void` must not become an unhandled rejection at unmount.
-          const { requestId, promise } = createReactRequest<void>(
-            driverId,
-            false,
-            { value: undefined }
-          );
-          scheduleOnUI(() => {
-            'worklet';
-            setOnUI(next);
-            scheduleOnRN(resolveReactRequest, driverId, requestId, undefined);
-          });
-          return promise;
-        },
-        animateTo(target, animation) {
-          // Teardown resolves with the documented 0 rejection sentinel (see
-          // `set` above): the README's own example voids this promise.
-          const { requestId, promise } = createReactRequest<number>(
-            driverId,
-            true,
-            { value: 0 }
-          );
-          scheduleOnUI(() => {
-            'worklet';
-            const result = animateOnUI(target, animation);
-            scheduleOnRN(
-              resolveReactRequest,
-              driverId,
-              requestId,
-              result,
-              true
-            );
-          });
-          return promise;
-        },
-        cancel(animationId = 0, behavior = 'current') {
-          const { requestId, promise } =
-            createReactRequest<CanonicalSmoothClipPresentation>(driverId, true);
-          scheduleOnUI(() => {
-            'worklet';
-            const result = cancelOnUI(animationId, behavior);
-            scheduleOnRN(
-              resolveReactRequest,
-              driverId,
-              requestId,
-              result,
-              true
-            );
-          });
-          return promise;
-        },
-      },
-      __smoothClipHandle: {
-        driverId,
-        presentation,
-        ownership,
-        activeAnimationId,
-        disposed,
-      },
-    };
-
-    setDriverState(
-      driver,
-      createDriverState(
-        driverId,
-        initialPresentation,
-        presentation,
-        callbackRef,
-        activeAnimationId,
-        ownership
-      )
-    );
-    driverRef.current = driver;
-  }
-
-  const driver = driverRef.current;
-
-  useEffect(() => {
-    const currentDriver = driverRef.current;
-    if (!currentDriver) return undefined;
-    const state = getDriverState(currentDriver);
-    const { driverId } = state;
-    // Re-attach on every effect run: StrictMode/<Activity> replay the effect
-    // after its cleanup detached this state and destroyed the native driver.
-    // The authoritative seed below recreates the native entry in that case.
-    attachDriverState(state);
-
-    const subscription = NativeSmoothClipModule.onClipAnimationComplete(
-      (result) => {
-        if (result.driverId !== driverId) return;
-        synchronizeNativeCompletion(
-          activeAnimationId,
-          ownership,
-          result.animationId,
-          result.finished
-        );
-        completeNativeAnimation(driverId, result.animationId, result.finished);
-      }
-    );
-
-    scheduleOnUI(
-      (
-        source: SharedValue<SmoothClipPresentation>,
-        listenerId: number,
-        nativeDriverId: number,
-        owner: SharedValue<number>,
-        suppressed: SharedValue<number>,
-        active: SharedValue<number>,
-        stale: SharedValue<number>,
-        gone: SharedValue<number>,
-        setter: typeof setPresentationHostFunction,
-        setterV2: typeof setPresentationV2HostFunction,
-        protocolVersion: number
-      ) => {
-        'worklet';
-        // First, before the listener or the seed: this effect run owns the
-        // driver again, so a StrictMode/<Activity> replay must clear the
-        // previous cleanup's tombstone or every later write would be rejected.
-        gone.value = 0;
-        let last: SmoothClipPresentation | null = null;
-        const deliver = (next: SmoothClipPresentation) => {
-          const canonical = canonicalizeClipPresentation(next);
-          if (canonical === null || clipPresentationEquals(last, canonical)) {
-            return;
-          }
-          // Record `last` only for values native has actually observed:
-          // deliveries dropped during native ownership must stay eligible
-          // for re-delivery once interactive ownership returns.
-          if (owner.value !== INTERACTIVE) return;
-          if (suppressed.value > 0) {
-            suppressed.value -= 1;
-            last = canonical;
-            return;
-          }
-          if (protocolVersion !== 2 && !isV1Compatible(canonical)) {
-            return;
-          }
-          last = canonical;
-          if (stale.value !== 0) stale.value = 0;
-          const { clip, contentTranslateX, contentTranslateY, contentScale } =
-            canonical;
-          // Declarative deliveries always record velocity samples — only the
-          // setScalars hot path is gated by the velocityTracking option.
-          if (protocolVersion === 2 && setterV2) {
-            setterV2(
-              nativeDriverId,
-              clip.x,
-              clip.y,
-              clip.width,
-              clip.height,
-              clip.topLeftRadius,
-              clip.topRightRadius,
-              clip.bottomRightRadius,
-              clip.bottomLeftRadius,
-              curveCode(canonical),
-              contentTranslateX,
-              contentTranslateY,
-              contentScale,
-              false,
-              false,
-              true
-            );
-          } else {
-            setter(
-              nativeDriverId,
-              clip.x,
-              clip.y,
-              clip.width,
-              clip.height,
-              clip.radius,
-              contentTranslateX,
-              contentTranslateY,
-              false,
-              false
-            );
-          }
-        };
-        source.addListener(listenerId, deliver);
-        // Authoritative take-ownership seed. Creates the native entry before
-        // any view mounts on the ordinary path, and revives a driver destroyed
-        // by an effect-replay cleanup (StrictMode/<Activity>) on later runs.
-        // An animation worklet can win the scheduling race and create a latch
-        // first; Native ownership then marks that intent as newer, so this
-        // passive seed must not clear its active id or replay the target value.
-        const current = canonicalizeClipPresentation(source.value);
-        if (owner.value === INTERACTIVE && current !== null) {
-          active.value = 0;
-          owner.value = INTERACTIVE;
-          stale.value = 0;
-          last = current;
-          if (protocolVersion === 2 && setterV2) {
-            setterV2(
-              nativeDriverId,
-              current.clip.x,
-              current.clip.y,
-              current.clip.width,
-              current.clip.height,
-              current.clip.topLeftRadius,
-              current.clip.topRightRadius,
-              current.clip.bottomRightRadius,
-              current.clip.bottomLeftRadius,
-              curveCode(current),
-              current.contentTranslateX,
-              current.contentTranslateY,
-              current.contentScale,
-              true,
-              false,
-              true
-            );
-          } else if (isV1Compatible(current)) {
-            setter(
-              nativeDriverId,
-              current.clip.x,
-              current.clip.y,
-              current.clip.width,
-              current.clip.height,
-              current.clip.radius,
-              current.contentTranslateX,
-              current.contentTranslateY,
-              true,
-              false
-            );
-          }
-        }
-      },
-      presentation,
-      driverId,
-      driverId,
-      ownership,
-      suppressDeliveries,
-      activeAnimationId,
-      scalarsStale,
-      disposed,
-      setPresentationHostFunction,
-      setPresentationV2HostFunction,
-      PRESENTATION_PROTOCOL_VERSION
-    );
-
-    return () => {
-      subscription.remove();
-      rejectDriverRequests(driverId);
-      detachDriverState(state);
-      scheduleOnUI(
-        (
-          source: SharedValue<SmoothClipPresentation>,
-          listenerId: number,
-          nativeDriverId: number,
-          owner: SharedValue<number>,
-          active: SharedValue<number>,
-          stale: SharedValue<number>,
-          suppressed: SharedValue<number>,
-          gone: SharedValue<number>,
-          destroy: typeof destroyDriverHostFunction
-        ) => {
-          'worklet';
-          source.removeListener(listenerId);
-          destroy(nativeDriverId);
-          // StrictMode replays the effect with these same SharedValues. Reset
-          // the UI-side tombstone only after native teardown so the next setup
-          // can seed or animate without inheriting stale Native ownership.
-          active.value = 0;
-          owner.value = INTERACTIVE;
-          stale.value = 0;
-          // Defensive: seedPresentation now reclaims its own unspent credit at
-          // the point of issue, so this should already be 0. Kept because the
-          // failure mode — one declarative write silently dropped for the rest
-          // of the next hook's life — is invisible until someone reports a
-          // stale clip rect.
-          suppressed.value = 0;
-          // Last: the native entry is now erased, so until the next effect run
-          // clears this, any call that would recreate it is rejected instead.
-          gone.value = 1;
-        },
-        presentation,
-        driverId,
-        driverId,
-        ownership,
-        activeAnimationId,
-        scalarsStale,
-        suppressDeliveries,
-        disposed,
-        destroyDriverHostFunction
-      );
-    };
-  }, [
-    activeAnimationId,
-    disposed,
-    ownership,
-    presentation,
-    scalarsStale,
-    suppressDeliveries,
-  ]);
-
-  return driver;
-}
-
-export type {
-  KeyframedClipAnimation,
-  SpringClipAnimation,
-  TimingClipAnimation,
-};