@rafaelaugusto/jolt 0.1.0-beta.1 → 0.1.0-beta.11

package/dist/gradient.js

@@ -0,0 +1,247 @@
+import { isAndroid, isIOS } from '@nativescript/core';
+import { toView } from './animate.js';
+import { colorMixer, parseColor } from './color.js';
+import { reducedMotion } from './config.js';
+import { getDriver } from './driver/index.js';
+import { androidGradient } from './driver/android-gradient.js';
+import { iosGradient } from './driver/ios-gradient.js';
+import { createTrack } from './track.js';
+import { resolveTransition, springs, } from './transition.js';
+let factory;
+/** Test seam, like `setDriver`. */
+export function setGradientPainter(next) {
+    factory = next;
+}
+function platformPainter(view, type) {
+    if (isIOS)
+        return iosGradient(view, type);
+    if (isAndroid)
+        return androidGradient(view, type);
+    return undefined;
+}
+const types = ['linear', 'radial', 'conic'];
+/**
+ * Paints a native gradient behind a layout's children and animates it.
+ *
+ * ```ts
+ * const glow = gradient(halo, { type: 'radial', colors: ['#FF0080', '#7928CA00'], radius: 0.8 })
+ * glow.animate({ center: { x: 0.8, y: 0.2 }, radius: 1.2 }, { duration: 2000 })
+ * ```
+ */
+export function gradient(target, options) {
+    const view = toView(target);
+    if (!options || !types.includes(options.type))
+        throw new TypeError(`Gradient type must be 'linear', 'radial' or 'conic'.`);
+    const first = resolve({ colors: [], stops: [], angle: 180, x: 0.5, y: 0.5, radius: 0.5 }, options, false);
+    return new GradientController(view, options.type, first);
+}
+class GradientController {
+    view;
+    type;
+    painter;
+    pending;
+    removed = false;
+    model;
+    running;
+    constructor(view, type, frame) {
+        this.view = view;
+        this.type = type;
+        this.model = frame;
+        this.attach((factory ?? platformPainter)(view, type));
+        view.on('unloaded', this.unloaded);
+    }
+    unloaded = () => this.stop();
+    attach(painter) {
+        if (!painter)
+            return;
+        if (this.removed)
+            return painter.remove();
+        this.painter = painter;
+        painter.paint(this.pending ?? this.model);
+        this.pending = undefined;
+    }
+    animate(values, transition) {
+        this.assertActive();
+        const from = this.presented();
+        const to = resolve(from, values, true);
+        const resolved = typeof transition === 'string' ? springOf(transition) : (transition ?? {});
+        const track = createTrack('opacity', [0, 1], resolveTransition(resolved, 'opacity', 2), 0);
+        const reduced = reducedMotion();
+        const frameAt = (progress) => mix(from, to, progress, reduced);
+        this.cancelRunning();
+        this.model = frameAt(track.to);
+        let settle;
+        const finished = new Promise((resolve) => (settle = resolve));
+        const animation = {
+            finished,
+            stop: () => {
+                if (this.running?.settle === settle)
+                    this.stop();
+            },
+            then: (onfulfilled, onrejected) => finished.then(onfulfilled, onrejected),
+        };
+        if (track.end === 0 || !this.painter) {
+            this.paint(this.model);
+            settle(true);
+            return animation;
+        }
+        const handle = this.painter.play(track.values.map(frameAt), track.times, {
+            duration: track.duration,
+            delay: track.delay,
+            repeat: track.repeat,
+            reverse: track.reverse,
+        }, (completed) => {
+            if (this.running?.settle !== settle)
+                return;
+            this.running = undefined;
+            settle(completed);
+        });
+        this.running = {
+            from,
+            to,
+            track,
+            startedAt: getDriver().now(),
+            handle,
+            settle,
+        };
+        return animation;
+    }
+    set(values) {
+        this.assertActive();
+        const next = resolve(this.presented(), values, false);
+        this.cancelRunning();
+        this.model = next;
+        this.paint(next);
+    }
+    stop() {
+        if (!this.running)
+            return;
+        const current = this.presented();
+        this.cancelRunning();
+        this.model = current;
+        this.paint(current);
+    }
+    remove() {
+        if (this.removed)
+            return;
+        this.cancelRunning();
+        this.removed = true;
+        this.view.off('unloaded', this.unloaded);
+        this.painter?.remove();
+        this.painter = undefined;
+    }
+    paint(frame) {
+        if (this.painter)
+            this.painter.paint(frame);
+        else
+            this.pending = frame;
+    }
+    presented() {
+        const running = this.running;
+        if (!running)
+            return this.model;
+        const elapsed = getDriver().now() - running.startedAt;
+        return mix(running.from, running.to, running.track.valueAt(elapsed), reducedMotion());
+    }
+    cancelRunning() {
+        const running = this.running;
+        if (!running)
+            return;
+        this.running = undefined;
+        running.handle.cancel();
+        running.settle(false);
+    }
+    assertActive() {
+        if (this.removed)
+            throw new Error('This gradient was removed.');
+    }
+}
+function springOf(name) {
+    const spring = springs[name];
+    if (!spring || !Object.hasOwn(springs, name))
+        throw new Error(`Unknown spring "${name}".`);
+    return spring;
+}
+/** Validates values and fills in what they leave out from `base`. */
+function resolve(base, values, sameCount) {
+    if (!values || typeof values !== 'object')
+        throw new TypeError('Gradient values must be an object.');
+    const colors = values.colors ? values.colors.map(parseColor) : base.colors;
+    if (colors.length < 2 || colors.length > 8)
+        throw new RangeError('A gradient needs between two and eight colors.');
+    if (sameCount && values.colors && colors.length !== base.colors.length)
+        throw new RangeError(`Animating a gradient keeps its ${base.colors.length} colors; use set() to change the count.`);
+    const stops = values.stops
+        ? [...values.stops]
+        : values.colors || base.stops.length !== colors.length
+            ? colors.map((_, i) => i / (colors.length - 1))
+            : base.stops;
+    if (stops.length !== colors.length ||
+        stops.some((stop, i) => !Number.isFinite(stop) || stop < 0 || stop > 1 || stop < (stops[i - 1] ?? 0)))
+        throw new RangeError('Gradient stops need one value per color, from 0 to 1, without going back.');
+    const angle = values.angle ?? base.angle;
+    const x = values.center?.x ?? base.x;
+    const y = values.center?.y ?? base.y;
+    const radius = values.radius ?? base.radius;
+    for (const [name, value] of [
+        ['angle', angle],
+        ['center', x],
+        ['center', y],
+        ['radius', radius],
+    ])
+        if (!Number.isFinite(value))
+            throw new RangeError(`Invalid gradient ${name}: ${value}.`);
+    if (radius < 0)
+        throw new RangeError(`Gradient radius must not be negative, got ${radius}.`);
+    return { colors, stops, angle, x, y, radius };
+}
+/** One frame between two states. Geometry follows the curve, overshoot included; colors and stops stay between their ends. */
+export function mix(from, to, progress, reduced = false) {
+    const p = Math.min(Math.max(progress, 0), 1);
+    const g = reduced ? 1 : progress;
+    const lerp = (a, b, t) => a + (b - a) * t;
+    return {
+        colors: to.colors.map((color, i) => colorMixer(from.colors[i] ?? color, color)(p)),
+        stops: to.stops.map((stop, i) => lerp(from.stops[i] ?? stop, stop, p)),
+        angle: lerp(from.angle, to.angle, g),
+        x: lerp(from.x, to.x, g),
+        y: lerp(from.y, to.y, g),
+        radius: Math.max(0, lerp(from.radius, to.radius, g)),
+    };
+}
+/**
+ * The points a platform gradient needs, in unit coordinates of a `width` × `height` box.
+ * Linear follows CSS: the line runs through the center at `angle` and is long enough
+ * for the corners to get the first and last colors.
+ */
+export function gradientPoints(type, frame, width, height) {
+    const radians = (frame.angle * Math.PI) / 180;
+    const sin = Math.sin(radians);
+    const cos = Math.cos(radians);
+    if (type === 'linear') {
+        const length = Math.abs(width * sin) + Math.abs(height * cos);
+        const dx = width > 0 ? (sin * length) / (2 * width) : 0;
+        const dy = height > 0 ? (-cos * length) / (2 * height) : 0;
+        return { start: { x: 0.5 - dx, y: 0.5 - dy }, end: { x: 0.5 + dx, y: 0.5 + dy } };
+    }
+    const center = { x: frame.x, y: frame.y };
+    const shorter = Math.min(width, height);
+    if (type === 'radial') {
+        const r = frame.radius * shorter;
+        return {
+            start: center,
+            end: {
+                x: center.x + (width > 0 ? r / width : 0),
+                y: center.y + (height > 0 ? r / height : 0),
+            },
+        };
+    }
+    return {
+        start: center,
+        end: {
+            x: center.x + (width > 0 ? (sin * shorter) / (2 * width) : 0),
+            y: center.y + (height > 0 ? (-cos * shorter) / (2 * height) : 0),
+        },
+    };
+}
+//# sourceMappingURL=gradient.js.map

package/dist/gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.js","sourceRoot":"","sources":["../src/gradient.ts"],"names":[],"mappings":"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"}

package/dist/haptics.d.ts

@@ -0,0 +1,21 @@
+import { type View } from '@nativescript/core';
+import type { Driver } from './driver/index.js';
+import type { Track } from './track.js';
+export type HapticStyle = 'light' | 'medium' | 'heavy';
+export interface HapticOptions {
+    style: HapticStyle;
+    /** Points from 0 to 1 over the finite animation, excluding its initial delay. Defaults to arrival. */
+    times?: readonly number[];
+}
+export type Haptic = HapticStyle | HapticOptions | false;
+/** Validate before any running animation is interrupted. */
+export declare function resolveHaptic(haptic: Haptic | undefined): HapticOptions | undefined;
+/** Discrete feedback only: animation playback remains entirely native. */
+export declare function playHaptics(view: View, tracks: readonly Track[], options: HapticOptions | undefined, driver: Driver, startedAt: number, elapsedTime?: () => number): {
+    cancel: () => void;
+    pause(): void;
+    play(): void;
+    seek(): void;
+    finish(): void;
+} | undefined;
+//# sourceMappingURL=haptics.d.ts.map

package/dist/haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEtD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,CAAA;IAClB,sGAAsG;IACtG,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,aAAa,GAAG,KAAK,CAAA;AAExD,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAsBnF;AAMD,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,eAAiC;;;;;;cAiG7C"}

package/dist/haptics.js

@@ -0,0 +1,120 @@
+import { isIOS } from '@nativescript/core';
+/** Validate before any running animation is interrupted. */
+export function resolveHaptic(haptic) {
+    if (haptic === undefined || haptic === false)
+        return undefined;
+    const options = typeof haptic === 'string' ? { style: haptic } : haptic;
+    if (!options || !['light', 'medium', 'heavy'].includes(options.style))
+        throw new TypeError('Haptic style must be light, medium or heavy.');
+    const times = options.times;
+    if (times !== undefined &&
+        (!Array.isArray(times) ||
+            times.length === 0 ||
+            Array.from(times).some((time, i) => !Number.isFinite(time) ||
+                time <= 0 ||
+                time > 1 ||
+                (i > 0 && time <= times[i - 1]))))
+        throw new RangeError('Haptic times must be increasing points greater than 0 and at most 1.');
+    return { style: options.style, times: times && [...times] };
+}
+const PREPARE_AHEAD = 100;
+const MAX_LATENESS = 100;
+const COMPLETION_TOLERANCE = 20;
+/** Discrete feedback only: animation playback remains entirely native. */
+export function playHaptics(view, tracks, options, driver, startedAt, elapsedTime = () => driver.now() - startedAt) {
+    if (!isIOS || !options || typeof UIImpactFeedbackGenerator === 'undefined')
+        return;
+    const moving = tracks.filter((track) => track.duration > 0 && track.values.some((value) => value !== track.values[0]));
+    if (!moving.length)
+        return;
+    const end = Math.max(...tracks.map((track) => track.end));
+    if (!Number.isFinite(end))
+        return;
+    const delay = Math.min(...moving.map((track) => track.delay));
+    const offsets = options.times
+        ? options.times.map((time) => delay + (end - delay) * time)
+        : [Math.max(...tracks.map((track) => track.arrival))];
+    const styles = {
+        light: 0,
+        medium: 1,
+        heavy: 2,
+    };
+    let generator = UIImpactFeedbackGenerator.alloc().initWithStyle(styles[options.style]);
+    const native = view.nativeViewProtected;
+    let paused = false;
+    let next = 0;
+    let cancelPrepare;
+    let cancelImpact;
+    const active = () => view.isLoaded &&
+        view.nativeViewProtected === native &&
+        !!native.window &&
+        UIApplication.sharedApplication.applicationState === 0; // UIApplicationState.Active
+    const cancelTimers = () => {
+        cancelPrepare?.();
+        cancelImpact?.();
+        cancelPrepare = cancelImpact = undefined;
+    };
+    const cancel = () => {
+        cancelPrepare?.();
+        cancelImpact?.();
+        cancelPrepare = cancelImpact = undefined;
+        generator = undefined;
+        view.off('unloaded', cancel);
+    };
+    const fire = (tolerance = 0) => {
+        const elapsed = elapsedTime();
+        // A busy UI thread can delay timers. Drop stale impacts instead of replaying
+        // several old taps at once when it becomes responsive again.
+        while (next < offsets.length && offsets[next] <= elapsed + tolerance) {
+            const offset = offsets[next++];
+            if (active() && elapsed - offset <= MAX_LATENESS)
+                generator?.impactOccurred();
+        }
+    };
+    const schedule = () => {
+        if (paused)
+            return;
+        if (!generator || next === offsets.length)
+            return cancel();
+        const remaining = offsets[next] - elapsedTime();
+        if (active())
+            generator.prepare();
+        if (remaining > PREPARE_AHEAD) {
+            cancelPrepare = driver.after(remaining - PREPARE_AHEAD, () => {
+                if (active())
+                    generator?.prepare();
+            });
+        }
+        cancelImpact = driver.after(Math.max(0, remaining), () => {
+            fire();
+            schedule();
+        });
+    };
+    view.on('unloaded', cancel);
+    schedule();
+    return {
+        cancel,
+        pause() {
+            paused = true;
+            cancelTimers();
+        },
+        play() {
+            if (paused) {
+                paused = false;
+                schedule();
+            }
+        },
+        seek() {
+            cancelTimers();
+            while (next < offsets.length && offsets[next] <= elapsedTime())
+                next++;
+            schedule();
+        },
+        finish() {
+            // Native completion may beat the timer at the final keyframe by a frame.
+            fire(COMPLETION_TOLERANCE);
+            cancel();
+        },
+    };
+}
+//# sourceMappingURL=haptics.js.map

package/dist/haptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.js","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"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"}

package/dist/image-effect-native.d.ts

@@ -0,0 +1,26 @@
+import { type Image, type ImageSource } from '@nativescript/core';
+export interface ImageEffectSettings {
+    mode: number;
+    x: number;
+    y: number;
+    amplitude: number;
+    radius: number;
+    duration: number;
+    seed: number;
+    to?: ImageSource;
+}
+export interface ImageRenderer {
+    readonly backend: 'metal' | 'agsl';
+    readonly progress: number;
+    readonly frames: number;
+    readonly textureBytes: number;
+    readonly longestFrameMs: number;
+    play(endpoint: number): void;
+    pause(): void;
+    resume(): void;
+    seek(progress: number): void;
+    finish(endpoint: number): void;
+    stop(preserveImage?: boolean): void;
+}
+export declare function createImageRenderer(image: Image, settings: ImageEffectSettings, ended: (completed: boolean, progress: number) => void): ImageRenderer | undefined;
+//# sourceMappingURL=image-effect-native.d.ts.map

package/dist/image-effect-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-effect-native.d.ts","sourceRoot":"","sources":["../src/image-effect-native.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAE1F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,WAAW,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,IAAI,CAAA;IACd,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CACpC;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACpD,aAAa,GAAG,SAAS,CAiG3B"}

package/dist/image-effect-native.js

@@ -0,0 +1,73 @@
+import { Utils, isAndroid, isIOS } from '@nativescript/core';
+export function createImageRenderer(image, settings, ended) {
+    const { mode, x, y, amplitude, radius, duration, seed, to } = settings;
+    if (isIOS && typeof JoltImageEffect !== 'undefined') {
+        const native = JoltImageEffect.createWithViewDestinationModeOriginXOriginYAmplitudeRadiusDurationSeedListener(image.nativeViewProtected, to?.ios ?? null, mode, x, y, amplitude, radius, duration, seed, ended);
+        if (!native)
+            return undefined;
+        return {
+            backend: 'metal',
+            get progress() {
+                return native.progress;
+            },
+            get frames() {
+                return native.frames;
+            },
+            get textureBytes() {
+                return native.textureBytes;
+            },
+            get longestFrameMs() {
+                return native.longestFrame * 1000;
+            },
+            play: (p) => native.play(p),
+            pause: () => native.pause(),
+            resume: () => native.resume(),
+            seek: (p) => native.seek(p),
+            finish: (p) => native.finish(p),
+            stop: (preserveImage) => preserveImage ? native.stopPreservingImage() : native.stop(),
+        };
+    }
+    if (isAndroid && android.os.Build.VERSION.SDK_INT >= 33) {
+        const density = Utils.layout.getDisplayDensity();
+        const background = image.nativeViewProtected.getBackground();
+        // NativeScript draws bitmap pixels itself: ImageView.getImageMatrix() does
+        // not describe its stretch, EXIF rotation or inner border clipping.
+        const geometry = Array.create('float', 6);
+        geometry[0] = image.imageSource?.rotationAngle ?? 0;
+        geometry[1] = to?.rotationAngle ?? 0;
+        const corners = ['TopLeft', 'TopRight', 'BottomRight', 'BottomLeft'];
+        corners.forEach((corner, i) => {
+            geometry[i + 2] = background?.[`getBorder${corner}Radius`]?.() ?? 0;
+        });
+        const native = new org.rafaelaugusto.jolt.ImageEffect(image.nativeViewProtected, image.imageSource?.android ?? null, to?.android ?? null, geometry, mode, x * density, y * density, amplitude * density, radius * density, duration, seed, image
+            .touchListener ?? null, new org.rafaelaugusto.jolt.ImageEffect.Listener({ onEnd: ended }));
+        if (!native.isSupported()) {
+            const reason = native.getFailureReason();
+            native.stop();
+            throw new Error(reason);
+        }
+        return {
+            backend: 'agsl',
+            get progress() {
+                return native.getProgress();
+            },
+            get frames() {
+                return native.getFrames();
+            },
+            get textureBytes() {
+                return native.getTextureBytes();
+            },
+            get longestFrameMs() {
+                return native.getLongestFrameNanos() / 1e6;
+            },
+            play: (p) => native.play(p),
+            pause: () => native.pause(),
+            resume: () => native.resume(),
+            seek: (p) => native.seek(p),
+            finish: (p) => native.finish(p),
+            stop: (preserveImage) => preserveImage ? native.stopPreservingImage() : native.stop(),
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=image-effect-native.js.map

package/dist/image-effect-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-effect-native.js","sourceRoot":"","sources":["../src/image-effect-native.ts"],"names":[],"mappings":"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"}

package/dist/image-effect.d.ts

@@ -0,0 +1,50 @@
+import { ImageSource } from '@nativescript/core';
+import type { Animation } from './engine.js';
+import type { Target } from './types.js';
+export type ImageEffectName = 'ripple' | 'distortion' | 'dissolve';
+export interface ImageEffectOptions {
+    /** Origin in target-local DIPs; defaults to the center. */
+    origin?: {
+        x: number;
+        y: number;
+    };
+    /** Maximum displacement in DIPs, 0..64. Defaults to 8. */
+    amplitude?: number;
+    /** Influence radius in DIPs, greater than zero. Defaults to 96. */
+    radius?: number;
+    /** Milliseconds for a finite effect (or drag release). Defaults to 650. */
+    duration?: number;
+    /** Deterministic dissolve noise seed, 0..65535. Defaults to 1. */
+    seed?: number;
+    /** Loaded destination raster for dissolve. */
+    to?: ImageSource;
+    /** Prepare at progress zero without starting. */
+    paused?: boolean;
+}
+export interface ImageEffectDiagnostics {
+    backend: 'waiting' | 'metal' | 'agsl' | 'fallback';
+    reason?: 'reduced-motion' | 'unsupported' | 'not-visible';
+    /** Native setup error, when available. Intended for developer diagnostics. */
+    detail?: string;
+    frames: number;
+    textureBytes: number;
+    peakTextureBytes: number;
+    preparationMs: number;
+    longestFrameMs: number;
+}
+export interface ImageEffect extends Animation {
+    readonly effect: ImageEffectName;
+    readonly paused: boolean;
+    /** Finite progress; distortion rejects seeking because it follows native touch input. */
+    progress: number;
+    readonly diagnostics: Readonly<ImageEffectDiagnostics>;
+    pause(): void;
+    play(): void;
+    /** Reverse a finite effect from its current pixels. Terminal handles remain terminal. */
+    reverse(): void;
+    /** Complete immediately at the current direction's endpoint. */
+    finish(): void;
+}
+/** Optional native image effects. Stop restores the source; dissolve completion commits its destination. */
+export declare function imageEffect(target: Target, effect: ImageEffectName, options?: ImageEffectOptions): ImageEffect;
+//# sourceMappingURL=image-effect.d.ts.map

package/dist/image-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-effect.d.ts","sourceRoot":"","sources":["../src/image-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EAGZ,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAA;AAClE,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,EAAE,CAAC,EAAE,WAAW,CAAA;IAChB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AACD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;IAClD,MAAM,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,aAAa,CAAA;IACzD,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB;AACD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACtD,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,yFAAyF;IACzF,OAAO,IAAI,IAAI,CAAA;IACf,gEAAgE;IAChE,MAAM,IAAI,IAAI,CAAA;CACf;AAcD,4GAA4G;AAC5G,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CA8Cb"}