@rafaelaugusto/jolt 0.1.0-beta.12 → 0.1.0-beta.13

package/dist/timed-animation.js

@@ -0,0 +1,177 @@
+import { getDriver } from './driver/index.js';
+import { Trace } from '@nativescript/core';
+import { setArrival, setArrivalTiming } from './engine.js';
+import { createClock, registerPlayback, validateProgress, } from './playback.js';
+/** A sampled resource's control clock. Native sinks play frames; JS runs only at boundaries. */
+export class TimedAnimation {
+    duration;
+    arrival;
+    update;
+    finish;
+    finished;
+    resolve;
+    arrive;
+    clock;
+    notifyPlayback;
+    listeners = new Set();
+    cancelEnd;
+    cancelArrival;
+    _paused = false;
+    settled = false;
+    completed = false;
+    arrived = false;
+    active = false;
+    constructor(duration, arrival, update, finish) {
+        this.duration = duration;
+        this.arrival = arrival;
+        this.update = update;
+        this.finish = finish;
+        const driver = getDriver();
+        this.clock = driver.clock?.(duration) ?? createClock(() => driver.now());
+        this.finished = new Promise((resolve) => {
+            this.resolve = resolve;
+        });
+        setArrival(this, new Promise((resolve) => {
+            this.arrive = resolve;
+        }));
+        this.notifyPlayback = registerPlayback(this, () => ({
+            time: this.time,
+            duration,
+            paused: this._paused,
+            ready: this.active,
+            settled: this.settled,
+            completed: this.completed,
+        }));
+        setArrivalTiming(this, {
+            read: () => ({
+                remaining: Math.max(0, arrival - this.time),
+                paused: this.paused,
+                arrived: this.arrived,
+            }),
+            subscribe: (callback) => {
+                this.listeners.add(callback);
+                return () => {
+                    this.listeners.delete(callback);
+                };
+            },
+        });
+    }
+    get time() {
+        return Math.max(0, Math.min(this.duration, this.clock.time()));
+    }
+    get paused() {
+        return this._paused;
+    }
+    get done() {
+        return this.settled;
+    }
+    get progress() {
+        if (!Number.isFinite(this.duration))
+            throw new RangeError('Progress requires a finite animation.');
+        return this.completed ? 1 : this.duration ? this.time / this.duration : 0;
+    }
+    set progress(value) {
+        validateProgress(value, this.duration);
+        this.seekTime(value * this.duration);
+    }
+    start() {
+        if (this.active || this.settled)
+            return;
+        this.active = true;
+        this.schedule();
+        this.notify();
+    }
+    pause() {
+        if (this._paused || this.settled)
+            return;
+        this.clock.pause();
+        this._paused = true;
+        this.cancelTimers();
+        this.update(this.time, true, 'pause');
+        this.notify();
+    }
+    play() {
+        if (!this._paused || this.settled)
+            return;
+        this._paused = false;
+        this.clock.play();
+        this.update(this.time, false, 'play');
+        this.schedule();
+        this.notify();
+    }
+    seekTime(time) {
+        if (!Number.isFinite(time) || time < 0)
+            throw new RangeError('Seek time must be finite and nonnegative.');
+        if (this.settled)
+            return;
+        this.clock.seek(Math.min(this.duration, time));
+        this.update(this.time, this._paused, 'seek');
+        this.schedule();
+        this.notify();
+    }
+    stop() {
+        this.settle(false);
+    }
+    then(onfulfilled, onrejected) {
+        return this.finished.then(onfulfilled, onrejected);
+    }
+    notify() {
+        this.notifyPlayback();
+        for (const callback of [...this.listeners])
+            callback();
+    }
+    cancelTimers() {
+        this.cancelEnd?.();
+        this.cancelArrival?.();
+        this.cancelEnd = this.cancelArrival = undefined;
+    }
+    schedule() {
+        this.cancelTimers();
+        if (!this.active || this._paused || this.settled)
+            return;
+        const driver = getDriver();
+        if (Number.isFinite(this.duration)) {
+            const remaining = this.duration - this.time;
+            if (remaining <= 0) {
+                this.settle(true);
+                return;
+            }
+            this.cancelEnd = driver.after(remaining, () => this.settle(true));
+        }
+        if (!this.arrived && Number.isFinite(this.arrival)) {
+            const remaining = this.arrival - this.time;
+            const arrive = () => {
+                this.arrived = true;
+                this.arrive();
+                this.notify();
+            };
+            if (remaining <= 0)
+                arrive();
+            else
+                this.cancelArrival = driver.after(remaining, arrive);
+        }
+    }
+    settle(completed) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.completed = completed;
+        this.cancelTimers();
+        if (completed)
+            this.clock.seek(this.duration);
+        this.clock.cancel();
+        try {
+            this.finish(completed);
+        }
+        catch (error) {
+            this.completed = false;
+            Trace.write(`Jolt sampled playback failed: ${String(error)}`, Trace.categories.Error, Trace.messageType.error);
+        }
+        this.arrived = true;
+        this.arrive();
+        this.notify();
+        this.resolve(this.completed);
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=timed-animation.js.map

package/dist/timed-animation.js.map

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

package/dist/value-observers.d.ts

@@ -0,0 +1,19 @@
+import { Color } from '@nativescript/core';
+export interface SubscribeOptions {
+    /** Deliver the current value synchronously when subscribing. Defaults to true. */
+    immediate?: boolean;
+}
+/** `time` is milliseconds on the native animation clock, shared by a notification batch. */
+export type ValueListener<T> = (value: T, time: number) => void;
+/** Root-owned subscriptions; mappings are evaluated only for consumers that opted in. */
+export declare class ValueObservers {
+    private readonly read;
+    private readonly observers;
+    private running;
+    constructor(read: (time: number) => number);
+    get active(): boolean;
+    subscribe(read: (value: number) => number, color: boolean, listener: ValueListener<number | Color>, options?: SubscribeOptions): () => void;
+    changed(running: boolean): void;
+    snapshot(time: number): () => void;
+}
+//# sourceMappingURL=value-observers.d.ts.map

package/dist/value-observers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-observers.d.ts","sourceRoot":"","sources":["../src/value-observers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,EAAS,MAAM,oBAAoB,CAAA;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,4FAA4F;AAC5F,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAqE/D,yFAAyF;AACzF,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,OAAO,CAAQ;IAEvB,YAA6B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAI;IAE/D,IAAI,MAAM,YAET;IAED,SAAS,CACP,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,EACvC,OAAO,GAAE,gBAAqB,GAC7B,MAAM,IAAI,CAeZ;IAED,OAAO,CAAC,OAAO,EAAE,OAAO,QAMvB;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAYjC;CACF"}

package/dist/value-observers.js

@@ -0,0 +1,111 @@
+import { Application, Color, Trace } from '@nativescript/core';
+import { getDriver } from './driver/index.js';
+// Only sources that need a frame live here. Idle subscriptions retain no global root reference.
+const pending = new Set();
+let cancelFrame;
+let listening = false;
+let suspended = false;
+function suspend() {
+    suspended = true;
+    cancelFrame?.();
+    cancelFrame = undefined;
+}
+function resume() {
+    suspended = false;
+    schedule();
+}
+function schedule() {
+    if (!pending.size) {
+        cancelFrame?.();
+        cancelFrame = undefined;
+        if (listening && !suspended) {
+            Application.off(Application.suspendEvent, suspend);
+            Application.off(Application.resumeEvent, resume);
+            listening = false;
+        }
+        return;
+    }
+    if (!listening) {
+        Application.on(Application.suspendEvent, suspend);
+        Application.on(Application.resumeEvent, resume);
+        listening = true;
+    }
+    if (cancelFrame || suspended)
+        return;
+    cancelFrame = getDriver().frame(() => {
+        cancelFrame = undefined;
+        const time = getDriver().now();
+        const sources = [...pending];
+        pending.clear();
+        // Capture every source before calling any listener: reentrant writes belong to the next batch.
+        const deliveries = sources.map((source) => source.snapshot(time));
+        for (const source of sources)
+            if (source.active)
+                pending.add(source);
+        for (const deliver of deliveries)
+            deliver();
+        schedule();
+    });
+}
+function deliver(observer, value, time) {
+    try {
+        observer.listener(observer.color ? new Color(value) : value, time);
+    }
+    catch (error) {
+        // A consumer failure must not interrupt other consumers or strand the shared frame source.
+        Trace.write(`Jolt motion value subscriber failed: ${error instanceof Error ? error.stack : String(error)}`, Trace.categories.Error, Trace.messageType.error);
+    }
+}
+/** Root-owned subscriptions; mappings are evaluated only for consumers that opted in. */
+export class ValueObservers {
+    read;
+    observers = new Set();
+    running = false;
+    constructor(read) {
+        this.read = read;
+    }
+    get active() {
+        return this.running && this.observers.size > 0;
+    }
+    subscribe(read, color, listener, options = {}) {
+        if (typeof listener !== 'function')
+            throw new TypeError('subscribe() needs a listener function.');
+        const time = getDriver().now();
+        const observer = { read, color, listener, previous: read(this.read(time)) };
+        this.observers.add(observer);
+        if (options.immediate !== false)
+            deliver(observer, observer.previous, time);
+        if (this.active)
+            this.changed(true);
+        return () => {
+            this.observers.delete(observer);
+            if (!this.observers.size) {
+                pending.delete(this);
+                schedule();
+            }
+        };
+    }
+    changed(running) {
+        this.running = running;
+        if (this.observers.size) {
+            pending.add(this);
+            schedule();
+        }
+    }
+    snapshot(time) {
+        const value = this.read(time);
+        const deliveries = [...this.observers].flatMap((observer) => {
+            const next = observer.read(value);
+            if (Object.is(next, observer.previous))
+                return [];
+            observer.previous = next;
+            return [{ observer, next }];
+        });
+        return () => {
+            for (const { observer, next } of deliveries)
+                if (this.observers.has(observer))
+                    deliver(observer, next, time);
+        };
+    }
+}
+//# sourceMappingURL=value-observers.js.map

package/dist/value-observers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-observers.js","sourceRoot":"","sources":["../src/value-observers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAiB7C,gGAAgG;AAChG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;AACzC,IAAI,WAAqC,CAAA;AACzC,IAAI,SAAS,GAAG,KAAK,CAAA;AACrB,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB,SAAS,OAAO;IACd,SAAS,GAAG,IAAI,CAAA;IAChB,WAAW,EAAE,EAAE,CAAA;IACf,WAAW,GAAG,SAAS,CAAA;AACzB,CAAC;AAED,SAAS,MAAM;IACb,SAAS,GAAG,KAAK,CAAA;IACjB,QAAQ,EAAE,CAAA;AACZ,CAAC;AAED,SAAS,QAAQ;IACf,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,WAAW,EAAE,EAAE,CAAA;QACf,WAAW,GAAG,SAAS,CAAA;QACvB,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;YAClD,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;YAChD,SAAS,GAAG,KAAK,CAAA;QACnB,CAAC;QACD,OAAM;IACR,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QACjD,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAC/C,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC;IACD,IAAI,WAAW,IAAI,SAAS;QAAE,OAAM;IACpC,WAAW,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QACnC,WAAW,GAAG,SAAS,CAAA;QACvB,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAA;QAC5B,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,+FAA+F;QAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QACjE,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,MAAM,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACpE,KAAK,MAAM,OAAO,IAAI,UAAU;YAAE,OAAO,EAAE,CAAA;QAC3C,QAAQ,EAAE,CAAA;IACZ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,QAAkB,EAAE,KAAa,EAAE,IAAY;IAC9D,IAAI,CAAC;QACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2FAA2F;QAC3F,KAAK,CAAC,KAAK,CACT,wCAAwC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,KAAK,CAAC,UAAU,CAAC,KAAK,EACtB,KAAK,CAAC,WAAW,CAAC,KAAK,CACxB,CAAA;IACH,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,OAAO,cAAc;IAII,IAAI;IAHhB,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;IACxC,OAAO,GAAG,KAAK,CAAA;IAEvB,YAA6B,IAA8B;oBAA9B,IAAI;IAA6B,CAAC;IAE/D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAA;IAChD,CAAC;IAED,SAAS,CACP,IAA+B,EAC/B,KAAc,EACd,QAAuC,EACvC,OAAO,GAAqB,EAAE;QAE9B,IAAI,OAAO,QAAQ,KAAK,UAAU;YAChC,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,CAAA;QAC9B,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAA;QAC3E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,IAAI,OAAO,CAAC,SAAS,KAAK,KAAK;YAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC3E,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACpB,QAAQ,EAAE,CAAA;YACZ,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IAED,OAAO,CAAC,OAAgB;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACjB,QAAQ,EAAE,CAAA;QACZ,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBAAE,OAAO,EAAE,CAAA;YACjD,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAA;YACxB,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU;gBACzC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;oBAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;QACnE,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/value-track.d.ts

@@ -0,0 +1,13 @@
+import { type Track } from './track.js';
+export interface ValuePart {
+    readonly track: Track;
+    readonly elapsed: number;
+    readonly base: number;
+    readonly span: number;
+}
+/** Compile scalar addition before any binding's mapping. The snapshot is independent of later edits. */
+export declare function valueTrack(parts: readonly ValuePart[], rest: number): {
+    track: Track;
+    windowed: boolean;
+};
+//# sourceMappingURL=value-track.d.ts.map

package/dist/value-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-track.d.ts","sourceRoot":"","sources":["../src/value-track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAErD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,wGAAwG;AACxG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM;;;EAiDnE"}

package/dist/value-track.js

@@ -0,0 +1,59 @@
+import { instantTrack } from './track.js';
+/** Compile scalar addition before any binding's mapping. The snapshot is independent of later edits. */
+export function valueTrack(parts, rest) {
+    const value = (time) => parts.reduce((sum, part) => sum + part.base + part.span * part.track.valueAt(part.elapsed + time), rest);
+    let finite = 0;
+    const periods = [];
+    for (const { track, elapsed } of parts) {
+        if (Number.isFinite(track.end))
+            finite = Math.max(finite, track.end - elapsed);
+        else if (elapsed < track.delay)
+            finite = Math.max(finite, track.delay - elapsed);
+        else
+            periods.push(Math.max(1, track.duration * (track.reverse ? 2 : 1)));
+    }
+    if (finite <= 0 && !periods.length)
+        return { track: instantTrack('x', value(0)), windowed: false };
+    const loop = finite <= 0 && periods.length ? commonPeriod(periods) : undefined;
+    // Bound finite compositions too: a minutes-long base must not undersample a short pulse.
+    const duration = finite > 0 ? Math.min(finite, 4000) : (loop ?? 4000);
+    const steps = Math.max(1, Math.min(6000, Math.ceil((duration * 60) / 1000)));
+    const times = Array.from({ length: steps + 1 }, (_, i) => i / steps);
+    const values = times.map((time) => value(time * duration));
+    const endless = loop !== undefined;
+    const at = (time) => value(endless
+        ? ((time % duration) + duration) % duration
+        : Math.min(duration, Math.max(0, time)));
+    const track = {
+        property: 'x',
+        delay: 0,
+        duration,
+        repeat: endless ? Infinity : 0,
+        reverse: false,
+        times,
+        values,
+        to: endless ? values[0] : values[steps],
+        end: endless ? Infinity : duration,
+        arrival: endless ? Infinity : duration,
+        valueAt: at,
+        velocityAt: (time) => (at(time + 0.5) - at(time - 0.5)) * 1000,
+    };
+    return {
+        track,
+        windowed: finite > duration ||
+            (!endless && parts.some(({ track }) => !Number.isFinite(track.end))),
+    };
+}
+function commonPeriod(periods) {
+    const gcd = (a, b) => (b ? gcd(b, a % b) : a);
+    let total = 1;
+    for (const period of periods) {
+        if (!Number.isInteger(period))
+            return undefined;
+        total = (total / gcd(total, period)) * period;
+        if (total > 30000)
+            return undefined;
+    }
+    return total;
+}
+//# sourceMappingURL=value-track.js.map

package/dist/value-track.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafaelaugusto/jolt",
-  "version": "0.1.0-beta.12",
+  "version": "0.1.0-beta.13",
   "description": "Native animations for NativeScript: presets, springs, keyframes and stagger in one call.",
   "keywords": [
     "nativescript",
@@ -33,7 +33,11 @@
       "types": "./dist/vue/index.d.ts",
       "default": "./dist/vue/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./native": {
+      "types": "./dist/native/index.d.ts",
+      "default": "./dist/native/index.js"
+    }
   },
   "files": [
     "dist",

package/src/android-plugin.d.ts

@@ -209,3 +209,40 @@ declare namespace org.rafaelaugusto.jolt {
     }
   }
 }
+
+declare namespace org.rafaelaugusto.jolt {
+  class PropertySink extends java.lang.Object {
+    static scalar(target: any, getter: string, setter: string): PropertySink
+    getDimensions(): number
+    isAlive(): boolean
+    isCompiled(): boolean
+    read(): native.Array<number>
+    write(values: native.Array<number>): void
+    dispose(): void
+  }
+  class MapLibrePropertySink extends PropertySink {
+    constructor(target: any, camera: boolean)
+  }
+  class PropertyPlayer extends java.lang.Object {
+    constructor(
+      sink: PropertySink,
+      times: native.Array<number>,
+      values: native.Array<number>,
+      finalValue: native.Array<number>,
+      duration: number,
+      delay: number,
+      repeat: number,
+      reverse: boolean,
+      listener: PropertyPlayer.Listener,
+    )
+    static activeCount(): number
+    getFrames(): number
+    control(time: number, paused: boolean): void
+    cancel(): void
+  }
+  namespace PropertyPlayer {
+    class Listener extends java.lang.Object {
+      constructor(implementation: { onEnd(completed: boolean): void })
+    }
+  }
+}

package/src/animate.ts

@@ -29,6 +29,7 @@ import {
   detachBindings,
   isMotionValue,
   type MotionValue,
+  type ValueAnimationOptions,
 } from './motion-value.js'
 import { resolveHaptic, type Haptic } from './haptics.js'
 import { layerable } from './mixer.js'
@@ -77,8 +78,8 @@ interface Options {
 export function animate(
   value: MotionValue,
   to: number | readonly (number | null)[],
-  transition?: Transition | SpringName,
-): Animation
+  transition?: ValueAnimationOptions | SpringName,
+): PlaybackAnimation
 export function animate(
   target: Target | readonly Target[],
   animation: Keyframes | PresetName,
@@ -92,7 +93,7 @@ export function animate(
   if (isMotionValue(target))
     return asRoot(target).animate(
       animation as number | readonly (number | null)[],
-      options as Transition | SpringName | undefined,
+      options as ValueAnimationOptions | SpringName | undefined,
     )
   return prepareAnimation(
     target as Target | readonly Target[],
@@ -237,7 +238,7 @@ export function decay(
  * Stops all or selected properties at their current values. `scale` stops both axes.
  * A motion value stops where it is, and so do the views bound to it.
  */
-export function stop(value: MotionValue): void
+export function stop(value: MotionValue, options?: { layer?: string }): void
 export function stop(
   target: Target | readonly Target[],
   properties?: readonly KeyframeProperty[],
@@ -245,11 +246,16 @@ export function stop(
 ): void
 export function stop(
   target: Target | readonly Target[] | MotionValue,
-  properties?: readonly KeyframeProperty[],
+  properties?: readonly KeyframeProperty[] | { layer?: string },
   options?: { layer?: string },
 ) {
-  if (isMotionValue(target)) return asRoot(target).stop()
-  const expanded = properties?.flatMap<Property>((property) =>
+  if (isMotionValue(target))
+    return asRoot(target).stop((properties as { layer?: string } | undefined)?.layer)
+  if (properties && !Array.isArray(properties))
+    throw new TypeError('View properties must be an array.')
+  const expanded = (
+    properties as readonly KeyframeProperty[] | undefined
+  )?.flatMap<Property>((property) =>
     property === 'scale' ? ['scaleX', 'scaleY'] : [property],
   )
   for (const view of toViews(target as Target | readonly Target[]))

package/src/drag.ts

@@ -247,7 +247,7 @@ class DragController implements Drag {
   }
   get position(): DragPoint {
     const value = this.config.value
-    if (value) return { x: 0, y: 0, [this.config.axes[0]!]: value.raw() }
+    if (value) return { x: 0, y: 0, [this.config.axes[0]!]: value.base() }
     return { x: currentValue(this.view, 'x'), y: currentValue(this.view, 'y') }
   }
   cancel = () => {
@@ -338,7 +338,7 @@ class DragController implements Drag {
       this.blocked = false
       const value = this.config.value
       if (value) {
-        value.stop()
+        value.stopBase()
         this.origin = this.position
       } else {
         // Claim just the enabled axes, preserving the native presentation on takeover.
@@ -385,7 +385,7 @@ class DragController implements Drag {
           : clampDrag(raw, curve.bounds)
         if (axis === 'x') vx = input.velocityX * resistance
         else vy = input.velocityY * resistance
-        if (this.config.value) this.config.value.set(position[axis])
+        if (this.config.value) this.config.value.setBase(position[axis])
         else {
           stopBase(this.view, [axis])
           setBase(this.view, axis, position[axis])

package/src/driver/android.ts

@@ -12,6 +12,7 @@ import {
 import { Application, Utils, type View } from '@nativescript/core'
 import type { NumericProperty } from '../properties.js'
 import type { Driver } from './index.js'
+import { frame } from './frame.js'
 import { isColorProperty } from '../color.js'
 import {
   playAndroidColor,
@@ -109,6 +110,7 @@ export function createAndroidDriver(): Driver {
 
   return {
     now: () => android.os.SystemClock.uptimeMillis(),
+    frame,
     clock,
     control(_view, handle, elapsed, paused, command) {
       ;(handle as Handle).control(elapsed, paused, command)

package/src/driver/frame.ts

@@ -0,0 +1,10 @@
+import {
+  cancelAnimationFrame,
+  requestAnimationFrame,
+} from '@nativescript/core/animation-frame'
+
+/** NativeScript schedules subsequent frames with CADisplayLink / Choreographer. */
+export function frame(callback: () => void): () => void {
+  const id = requestAnimationFrame(callback)
+  return () => cancelAnimationFrame(id)
+}

package/src/driver/index.ts

@@ -15,6 +15,8 @@ export interface LayoutFrame {
 export interface Driver {
   /** Milliseconds, on the clock the platform's animations run on. */
   now(): number
+  /** One native animation frame; returns an idempotent cancellation function. */
+  frame(callback: () => void): () => void
   /** Starts the track at `startedAt + track.delay` and calls `onEnd` once, however it ends. */
   play(
     view: View,

package/src/driver/ios.ts

@@ -13,6 +13,7 @@ import { playIOSColor, presentedIOSColor } from './ios-color.js'
 import { after, type Driver } from './index.js'
 import { hasInteractionSurface } from '../interaction-surface.js'
 import { retainInteractiveLayout } from './ios-layout.js'
+import { frame } from './frame.js'
 
 interface Handle {
   stop(): void
@@ -59,6 +60,7 @@ function ensurePerspective(view: View, layers: CALayer[]) {
 export function createIOSDriver(): Driver {
   return {
     now: () => CACurrentMediaTime() * 1000,
+    frame,
 
     play(view, track, startedAt, onEnd): Handle {
       if (isDecorationProperty(track.property))