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

package/src/driverTypes.ts

@@ -1,140 +0,0 @@
-import type { SharedValue } from 'react-native-reanimated';
-import type { SmoothClipPresentation } from './geometry';
-
-export type ClipReduceMotion = 'system' | 'always' | 'never';
-
-/** Options shared by every animation kind. */
-type ClipAnimationBase = Readonly<{
-  /**
-   * Explicit start: fuses a `setScalars(from…)` take-ownership hot write
-   * immediately before the animation, so native starts from exactly this
-   * presentation instead of its last delivered value. Use at a gesture
-   * release when the freshest sample (e.g. the UP event's position) never
-   * reached native — a gated per-frame reaction may not have flushed it.
-   * Also re-grabs from a running animation (which an implicit interactive
-   * start would silently skip). Non-finite `from` rejects the whole call.
-   * On the native drivers `driver.presentation.value` is not written from
-   * `from` (it stays stale until success sets it to the target); the web
-   * fallback does write it — its presentation SharedValue is the render
-   * channel itself. Against a held pending-animation latch, explicit `from`
-   * is newer intent: the fused write cancels that latch once unfinished,
-   * applies `from`, and starts the replacement from that native value.
-   *
-   * Keyframes interpolate absolutely, so pass `frames[0].presentation` —
-   * the seed renders it before the first animation frame, making the
-   * handoff continuous.
-   *
-   * iOS note: keyframes start exactly at `from` (frame 0 travels in-band);
-   * timing/spring sample their Core Animation from-value off the
-   * presentation layer — the last committed frame, at most one frame behind
-   * `from` — identical to the two-call pattern this option desugars to.
-   */
-  from?: SmoothClipPresentation;
-}>;
-
-export type TimingClipAnimation = ClipAnimationBase &
-  Readonly<{
-    type: 'timing';
-    duration: number;
-    controlPoints: readonly [number, number, number, number];
-  }>;
-
-export type SpringClipAnimation = ClipAnimationBase &
-  Readonly<{
-    type: 'spring';
-    mass?: number;
-    stiffness?: number;
-    damping?: number;
-    initialVelocity?: number | 'inherit';
-  }>;
-
-export type KeyframedClipAnimation = ClipAnimationBase &
-  Readonly<{
-    type: 'keyframes';
-    duration: number;
-    frames: readonly Readonly<{
-      offset: number;
-      presentation: SmoothClipPresentation;
-    }>[];
-  }>;
-
-export type SmoothClipAnimation =
-  TimingClipAnimation | SpringClipAnimation | KeyframedClipAnimation;
-
-export type ClipAnimationResult = Readonly<{
-  animationId: number;
-  finished: boolean;
-}>;
-
-export type SmoothClipDriverOptions = Readonly<{
-  reduceMotion?: ClipReduceMotion;
-  onAnimationComplete?: (result: ClipAnimationResult) => void;
-  /**
-   * Android only; captured at driver creation. Records two-sample velocity
-   * history on `setScalars` hot writes so a spring `initialVelocity: 'inherit'`
-   * can project its launch speed from the live drag. Off by default: the
-   * recording (a clock read plus channel copies) rides the per-frame
-   * `setScalars` hot path, and drivers that never hand off into an inherit
-   * spring should not pay it. Without this flag, `'inherit'` inherits 0 after
-   * a `setScalars` drag on Android (each skipped write also invalidates older
-   * samples, so stale pre-drag motion never leaks in). `set()`, the fused
-   * `animateTo` `from` seed, and the declarative `presentation.value` channel
-   * always record regardless of the flag. iOS always records; the flag is a
-   * no-op there.
-   */
-  velocityTracking?: boolean;
-}>;
-
-export type SmoothClipUIControls = Readonly<{
-  beginInteraction(): SmoothClipPresentation;
-  set(presentation: SmoothClipPresentation): void;
-  /**
-   * Per-frame hot path: writes geometry straight to native without touching
-   * `driver.presentation`. Skips SharedValue bookkeeping (dirty marking, RN
-   * mirror sync, listener dispatch) for high-frequency streams such as
-   * gestures. `driver.presentation.value` is stale after hot writes by design;
-   * `beginInteraction()` remains the source of truth for visible geometry.
-   * Do not interleave with `presentation.value` writes on the same driver —
-   * the listener's duplicate suppression may skip a later equal value.
-   * To hand off into an animation from a fresher value than the last hot
-   * write, pass the geometry as `animation.from` to `animateTo` — it fuses
-   * this call and the handoff into one.
-   */
-  setScalars(
-    x: number,
-    y: number,
-    width: number,
-    height: number,
-    radius: number,
-    contentTranslateX: number,
-    contentTranslateY: number
-  ): void;
-  animateTo(
-    presentation: SmoothClipPresentation,
-    animation: SmoothClipAnimation
-  ): number;
-  cancel(
-    animationId?: number,
-    behavior?: 'current' | 'target'
-  ): SmoothClipPresentation;
-}>;
-
-export type SmoothClipReactControls = Readonly<{
-  beginInteraction(): Promise<SmoothClipPresentation>;
-  set(presentation: SmoothClipPresentation): Promise<void>;
-  animateTo(
-    presentation: SmoothClipPresentation,
-    animation: SmoothClipAnimation
-  ): Promise<number>;
-  cancel(
-    animationId?: number,
-    behavior?: 'current' | 'target'
-  ): Promise<SmoothClipPresentation>;
-}>;
-
-export type SmoothClipDriver = Readonly<{
-  kind: 'hybrid';
-  presentation: SharedValue<SmoothClipPresentation>;
-  ui: SmoothClipUIControls;
-  react: SmoothClipReactControls;
-}>;

package/src/drivers.android.ts

@@ -1,8 +0,0 @@
-// Platform re-export only — the implementation is shared with iOS.
-// Edit drivers.native.ts, not this file.
-export { useSmoothClipDriver } from './drivers.native';
-export type {
-  KeyframedClipAnimation,
-  SpringClipAnimation,
-  TimingClipAnimation,
-} from './drivers.native';

package/src/drivers.ios.ts

@@ -1,8 +0,0 @@
-// Platform re-export only — the implementation is shared with Android.
-// Edit drivers.native.ts, not this file.
-export { useSmoothClipDriver } from './drivers.native';
-export type {
-  KeyframedClipAnimation,
-  SpringClipAnimation,
-  TimingClipAnimation,
-} from './drivers.native';