@rafaelaugusto/jolt 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/layout.js

@@ -0,0 +1,348 @@
+import { Application } from '@nativescript/core';
+import { prepareAnimation, toView } from './animate.js';
+import { getDriver } from './driver/index.js';
+import { captureValue, propertyRevision, arrivalOf, setArrival, } from './engine.js';
+import { interactionSurface } from './interaction-surface.js';
+import { readValue, writeValue } from './properties.js';
+import { springs } from './transition.js';
+const pending = new WeakMap();
+const playing = new WeakMap();
+const properties = ['x', 'y', 'scaleX', 'scaleY'];
+export function animateLayout(container, changeOrOptions, options) {
+    const host = toView(container);
+    const change = typeof changeOrOptions === 'function' ? changeOrOptions : undefined;
+    const input = change ? options : changeOrOptions;
+    const { size = 'scale', enter = true, ...transition } = normalize(input);
+    // Validate the complete transition before changing children or cancelling an earlier request.
+    prepareAnimation(host, { x: [0, 1], y: [0, 1], scaleX: [1, 2], scaleY: [1, 2], opacity: [0, 1] }, transition);
+    const driver = getDriver();
+    const before = new Map();
+    const ready = laidOut(host);
+    if (ready)
+        for (const child of childrenOf(host)) {
+            const frame = frameOf(child);
+            if (frame)
+                before.set(child, {
+                    frame,
+                    originX: child.originX,
+                    originY: child.originY,
+                    rotate: child.rotate,
+                    rotateX: child.rotateX,
+                    rotateY: child.rotateY,
+                    values: {
+                        x: captureValue(child, 'x'),
+                        y: captureValue(child, 'y'),
+                        scaleX: captureValue(child, 'scaleX'),
+                        scaleY: captureValue(child, 'scaleY'),
+                    },
+                });
+        }
+    let resolve;
+    let reject;
+    const finished = new Promise((done, fail) => {
+        resolve = done;
+        reject = fail;
+    });
+    let arrive;
+    const arrival = new Promise((done) => (arrive = done));
+    const owned = [];
+    let settled = false;
+    let detach;
+    const cleanup = () => {
+        detach?.();
+        detach = undefined;
+        host.off('unloaded', stop);
+        Application.off(Application.suspendEvent, stop);
+        if (pending.get(host) === handle)
+            pending.delete(host);
+        const active = playing.get(host);
+        active?.delete(handle);
+        if (!active?.size)
+            playing.delete(host);
+        before.clear();
+        owned.forEach((child) => child.detach());
+        arrive();
+    };
+    const complete = (result, error) => {
+        if (settled)
+            return;
+        settled = true;
+        cleanup();
+        if (error !== undefined)
+            reject(error);
+        else
+            resolve(result);
+    };
+    // A cancelled FLIP settles into the real layout rather than leaving a temporary inverse offset.
+    // The engine marker protects any animation that took ownership after this operation.
+    const restoreOne = ({ view, handle: child, targets }) => {
+        const current = targets.filter((target) => propertyRevision(view, target.property) === target.token);
+        child.stop();
+        for (const target of current)
+            if (propertyRevision(view, target.property) === target.token)
+                writeValue(view, target.property, target.value);
+        if (current.length)
+            driver.sync?.(view);
+    };
+    const restore = () => {
+        owned.forEach(restoreOne);
+    };
+    function stop() {
+        if (settled)
+            return;
+        restore();
+        complete(false);
+    }
+    const handle = {
+        finished,
+        stop,
+        then: (onfulfilled, onrejected) => finished.then(onfulfilled, onrejected),
+    };
+    setArrival(handle, arrival);
+    const run = () => {
+        if (settled)
+            return;
+        detach?.();
+        detach = undefined;
+        if (!laidOut(host)) {
+            stop();
+            return;
+        }
+        if (pending.get(host) === handle)
+            pending.delete(host);
+        const previous = [...(playing.get(host) ?? [])];
+        try {
+            const prepared = [];
+            for (const child of childrenOf(host)) {
+                const now = frameOf(child);
+                if (!now)
+                    continue;
+                const was = before.get(child);
+                const frames = was
+                    ? inverse(child, was, now, size)
+                    : enter
+                        ? { opacity: [0, child.opacity] }
+                        : undefined;
+                if (frames && Object.keys(frames).length)
+                    prepared.push({
+                        view: child,
+                        frames,
+                        start: prepareAnimation(child, frames, transition),
+                    });
+            }
+            before.clear();
+            // Selection lasts only for starting these tracks; their native geometry driver stays until completion.
+            for (const { view, frames, start } of prepared) {
+                const surface = interactionSurface(view);
+                try {
+                    const child = start();
+                    const targets = Object.entries(frames).map(([property, frames]) => ({
+                        property: property,
+                        value: frames.at(-1),
+                        token: propertyRevision(view, property),
+                    }));
+                    const item = {
+                        view,
+                        handle: child,
+                        targets,
+                        detach: () => view.off('unloaded', unloaded),
+                    };
+                    const unloaded = () => {
+                        item.detach();
+                        if (!settled)
+                            restoreOne(item);
+                    };
+                    // Keyed reorder may unload/reinsert the same native view. Do not persist its FLIP offset.
+                    view.on('unloaded', unloaded);
+                    owned.push(item);
+                }
+                finally {
+                    surface.dispose();
+                }
+            }
+            const active = playing.get(host) ?? new Set();
+            active.add(handle);
+            playing.set(host, active);
+            // Replacements start before old handles stop so the engine can transfer velocity.
+            for (const old of previous)
+                old.stop();
+            void Promise.all(owned.map(({ handle }) => arrivalOf(handle))).then(arrive);
+            void Promise.all(owned.map(({ handle }) => handle.finished)).then((results) => complete(results.every(Boolean)), (error) => {
+                restore();
+                complete(false, error);
+            });
+        }
+        catch (error) {
+            restore();
+            complete(false, error);
+        }
+    };
+    pending.get(host)?.stop();
+    pending.set(host, handle);
+    host.on('unloaded', stop);
+    Application.on(Application.suspendEvent, stop);
+    try {
+        const result = change?.();
+        if (result && typeof result.then === 'function') {
+            void Promise.resolve(result).catch(() => { });
+            throw new TypeError('Layout mutations must be synchronous. Call animateLayout after awaited work.');
+        }
+        if (!settled) {
+            if (!ready || !laidOut(host))
+                complete(true);
+            else {
+                if (!driver.afterLayout || !driver.layoutFrame)
+                    throw new Error('The animation driver does not support layout changes.');
+                detach = driver.afterLayout(host, run);
+                // Always request a pass, including a no-op mutation: no arbitrary timer or hanging wait.
+                host.requestLayout();
+            }
+        }
+    }
+    catch (error) {
+        stop();
+        throw error;
+    }
+    return handle;
+}
+function normalize(input) {
+    if (typeof input === 'string') {
+        if (!Object.hasOwn(springs, input))
+            throw new TypeError(`Unknown layout spring "${input}".`);
+        return normalize({ ...springs[input] });
+    }
+    if (input === undefined)
+        return {};
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        throw new TypeError('Invalid layout options.');
+    const allowed = new Set([
+        'type',
+        'duration',
+        'ease',
+        'times',
+        'stiffness',
+        'damping',
+        'mass',
+        'bounce',
+        'velocity',
+        'delay',
+        'size',
+        'enter',
+    ]);
+    for (const key of Object.keys(input))
+        if (!allowed.has(key))
+            throw new TypeError(`Unsupported layout option "${key}".`);
+    if (input.size !== undefined && input.size !== false && input.size !== 'scale')
+        throw new TypeError('Layout size must be "scale" or false.');
+    if (input.enter !== undefined && typeof input.enter !== 'boolean')
+        throw new TypeError('Layout enter must be boolean.');
+    if (input.type !== undefined && input.type !== 'spring' && input.type !== 'tween')
+        throw new TypeError('Layout type must be "spring" or "tween".');
+    const numbers = input;
+    for (const key of [
+        'duration',
+        'delay',
+        'stiffness',
+        'damping',
+        'mass',
+        'bounce',
+        'velocity',
+    ]) {
+        const value = numbers[key];
+        if (value !== undefined && (typeof value !== 'number' || !Number.isFinite(value)))
+            throw new RangeError(`Layout ${key} must be finite.`);
+        if (typeof value === 'number') {
+            if (['duration', 'delay', 'damping'].includes(key) && value < 0)
+                throw new RangeError(`Layout ${key} must be nonnegative.`);
+            if (['stiffness', 'mass'].includes(key) && value <= 0)
+                throw new RangeError(`Layout ${key} must be positive.`);
+            if (key === 'bounce' && (value < -1 || value > 1))
+                throw new RangeError('Layout bounce must be between -1 and 1.');
+        }
+    }
+    const physical = ['stiffness', 'damping', 'mass'].some((key) => numbers[key] !== undefined);
+    const spring = input.type === 'spring' ||
+        (input.type !== 'tween' &&
+            ['bounce', 'velocity', 'stiffness', 'damping', 'mass'].some((key) => numbers[key] !== undefined));
+    if (spring && !physical && input.duration === 0)
+        throw new RangeError('A duration-based layout spring must have positive duration; use a zero-duration tween to settle immediately.');
+    const result = { ...input };
+    if ('ease' in result && Array.isArray(result.ease))
+        result.ease = [...result.ease];
+    if ('times' in result && result.times)
+        result.times = [...result.times];
+    return result;
+}
+function inverse(view, was, now, size) {
+    // Origin/rotation changes require a different affine transform, not a translation/scale FLIP.
+    if (view.originX !== was.originX ||
+        view.originY !== was.originY ||
+        view.rotate !== was.rotate ||
+        was.rotateX ||
+        was.rotateY ||
+        view.rotateX ||
+        view.rotateY)
+        return undefined;
+    const frames = {};
+    const width = was.frame.width - now.width, height = was.frame.height - now.height;
+    const resized = Math.abs(width) > 0.25 || Math.abs(height) > 0.25;
+    for (const property of properties) {
+        const current = was.values[property]();
+        if (current === undefined)
+            continue; // A newer explicit animation owns this property.
+        let start;
+        if (property === 'x')
+            start =
+                was.frame.x -
+                    now.x +
+                    current +
+                    (size === 'scale' && resized ? width * was.originX : 0);
+        else if (property === 'y')
+            start =
+                was.frame.y -
+                    now.y +
+                    current +
+                    (size === 'scale' && resized ? height * was.originY : 0);
+        else {
+            if (size !== 'scale')
+                continue;
+            start =
+                current *
+                    (property === 'scaleX'
+                        ? was.frame.width / now.width
+                        : was.frame.height / now.height);
+        }
+        const end = readValue(view, property);
+        if (Math.abs(start - end) > (property.startsWith('scale') ? 0.0001 : 0.25))
+            frames[property] = [start, end];
+    }
+    return frames;
+}
+function laidOut(view) {
+    if (!view.isLoaded || !view.nativeViewProtected)
+        return false;
+    for (let current = view; current; current = current.parent)
+        if (current.isCollapsed)
+            return false;
+    return true;
+}
+function frameOf(view) {
+    if (!laidOut(view))
+        return undefined;
+    const frame = getDriver().layoutFrame?.(view);
+    return frame &&
+        Object.values(frame).every(Number.isFinite) &&
+        frame.width > 0 &&
+        frame.height > 0
+        ? frame
+        : undefined;
+}
+function childrenOf(host) {
+    const children = [];
+    host.eachChildView((child) => {
+        children.push(child);
+        return true;
+    });
+    return children;
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/motion-scope.d.ts

@@ -0,0 +1,39 @@
+import { animate, decay } from './animate.js';
+import { press } from './press.js';
+import { drag } from './drag.js';
+import { animateLayout } from './layout.js';
+import { sequence } from './sequence.js';
+import { type MotionState, type MotionDefinitions, type MotionStates, type MotionStatesOptions } from './motion-states.js';
+import type { Target } from './types.js';
+/** A cleanup function or a handle owned exclusively by one scope. */
+export type MotionResource = (() => void) | {
+    stop(): void;
+} | {
+    dispose(): void;
+};
+export interface MotionScope {
+    readonly disposed: boolean;
+    readonly suspended: boolean;
+    /** Owned handles/subscriptions, including suspended subscription factories. */
+    readonly size: number;
+    animateLayout: typeof animateLayout;
+    animate: typeof animate;
+    decay: typeof decay;
+    sequence: typeof sequence;
+    press: typeof press;
+    drag: typeof drag;
+    states<T extends Record<string, Target>, const S extends Record<string, MotionState<keyof T>>>(targets: T, definitions: MotionDefinitions<T, S>, options?: Omit<MotionStatesOptions, 'scope'>): MotionStates<Extract<keyof S, string>>;
+    /** Adopt an existing handle. Completed animations are released automatically. */
+    add<T extends MotionResource>(resource: T): T;
+    /** Attach a subscription, detach on suspension, and recreate on resume. */
+    use(setup: () => MotionResource): () => void;
+    /** Pause playable handles; cancel non-playable ones; detach subscriptions. */
+    suspend(): void;
+    resume(): void;
+    /** Cancel all owned work without destroying the scope, e.g. when recycling a cell. */
+    reset(): void;
+    dispose(): void;
+}
+/** Framework-independent ownership. Native unload never permanently destroys a scope. */
+export declare function motionScope(): MotionScope;
+//# sourceMappingURL=motion-scope.d.ts.map

package/dist/motion-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-scope.d.ts","sourceRoot":"","sources":["../src/motion-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAA;AAclF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,OAAO,aAAa,CAAA;IACnC,OAAO,EAAE,OAAO,OAAO,CAAA;IACvB,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,QAAQ,EAAE,OAAO,QAAQ,CAAA;IACzB,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,IAAI,EAAE,OAAO,IAAI,CAAA;IACjB,MAAM,CACJ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAEpD,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAC3C,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IACzC,iFAAiF;IACjF,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAA;IAC7C,2EAA2E;IAC3E,GAAG,CAAC,KAAK,EAAE,MAAM,cAAc,GAAG,MAAM,IAAI,CAAA;IAC5C,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;IACd,sFAAsF;IACtF,KAAK,IAAI,IAAI,CAAA;IACb,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,IAAI,WAAW,CAwNzC"}

package/dist/motion-scope.js

@@ -0,0 +1,238 @@
+import { animate, decay } from './animate.js';
+import { press } from './press.js';
+import { drag } from './drag.js';
+import { animateLayout } from './layout.js';
+import { sequence } from './sequence.js';
+import { motionStates, } from './motion-states.js';
+const owners = new WeakMap();
+/** Framework-independent ownership. Native unload never permanently destroys a scope. */
+export function motionScope() {
+    const entries = new Set();
+    const adopted = new Map();
+    const identity = {};
+    let disposed = false;
+    let suspended = false;
+    let clearing = false;
+    const assertAlive = () => {
+        if (disposed)
+            throw new Error('Motion scope is disposed.');
+        if (clearing)
+            throw new Error('Motion scope is resetting.');
+    };
+    const assertActive = () => {
+        assertAlive();
+        if (suspended)
+            throw new Error('Motion scope is suspended; resume it before starting work.');
+    };
+    const validate = (resource) => {
+        if (typeof resource !== 'function' &&
+            (!resource ||
+                (typeof resource.dispose !== 'function' &&
+                    typeof resource.stop !== 'function')))
+            throw new TypeError('A motion resource must be a cleanup function or expose stop()/dispose().');
+        const finished = resource.finished;
+        if (finished && typeof finished.then !== 'function')
+            throw new TypeError('Resource finished must be a promise.');
+        if (owners.has(resource) && owners.get(resource) !== identity)
+            throw new Error('Motion resource already belongs to another scope.');
+    };
+    const forget = (entry) => {
+        const resource = entry.resource;
+        if (resource) {
+            owners.delete(resource);
+            adopted.delete(resource);
+            entry.resource = undefined;
+        }
+        entry.resume = false;
+    };
+    const disposeResource = (resource) => {
+        if (typeof resource === 'function')
+            resource();
+        else if (typeof resource.dispose === 'function')
+            resource.dispose();
+        else
+            resource.stop();
+    };
+    const release = (entry) => {
+        const resource = entry.resource;
+        forget(entry);
+        if (!resource)
+            return;
+        disposeResource(resource);
+    };
+    const remove = (entry) => {
+        entries.delete(entry);
+        release(entry);
+    };
+    const attach = (entry, resource) => {
+        validate(resource);
+        if (adopted.has(resource))
+            throw new Error('Subscription factory returned an already owned resource.');
+        entry.resource = resource;
+        adopted.set(resource, entry);
+        owners.set(resource, identity);
+        const finished = resource.finished;
+        if (!entry.setup && finished) {
+            const settled = () => {
+                if (entry.resource !== resource)
+                    return;
+                forget(entry);
+                entries.delete(entry);
+            };
+            void finished.then(settled, settled);
+        }
+    };
+    const startSubscription = (entry) => {
+        const resource = entry.setup();
+        validate(resource);
+        // Setup may synchronously navigate away, suspend or remove its own scope.
+        if (disposed || suspended || !entries.has(entry)) {
+            if (!owners.has(resource))
+                disposeResource(resource);
+            return;
+        }
+        attach(entry, resource);
+    };
+    // One bad cleanup must not strand the other subscriptions.
+    const visit = (action) => {
+        const errors = [];
+        for (const entry of [...entries]) {
+            if (!entries.has(entry))
+                continue;
+            try {
+                action(entry);
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length)
+            throw new AggregateError(errors, 'Motion scope cleanup/lifecycle failed.');
+    };
+    const startOwned = (factory) => {
+        assertActive();
+        const resource = factory();
+        try {
+            return scope.add(resource);
+        }
+        catch (error) {
+            if (!owners.has(resource))
+                disposeResource(resource);
+            throw error;
+        }
+    };
+    const scope = {
+        get disposed() {
+            return disposed;
+        },
+        get suspended() {
+            return suspended;
+        },
+        get size() {
+            return entries.size;
+        },
+        animateLayout(container, changeOrOptions, options) {
+            return startOwned(() => typeof changeOrOptions === 'function'
+                ? animateLayout(container, changeOrOptions, options)
+                : animateLayout(container, changeOrOptions));
+        },
+        animate(...args) {
+            return startOwned(() => animate(...args));
+        },
+        decay(...args) {
+            return startOwned(() => decay(...args));
+        },
+        sequence(...args) {
+            return startOwned(() => sequence(...args));
+        },
+        press(...args) {
+            return scope.use(() => press(...args));
+        },
+        drag(...args) {
+            return startOwned(() => drag(...args));
+        },
+        states(targets, definitions, options) {
+            return startOwned(() => motionStates(targets, definitions, options));
+        },
+        add(resource) {
+            assertActive();
+            validate(resource);
+            if (adopted.has(resource))
+                return resource;
+            const entry = { resume: false };
+            attach(entry, resource);
+            entries.add(entry);
+            return resource;
+        },
+        use(setup) {
+            assertAlive();
+            if (typeof setup !== 'function')
+                throw new TypeError('Motion subscription needs a factory.');
+            const entry = { setup, resume: false };
+            entries.add(entry);
+            try {
+                if (!suspended)
+                    startSubscription(entry);
+            }
+            catch (error) {
+                remove(entry);
+                throw error;
+            }
+            return () => remove(entry);
+        },
+        suspend() {
+            if (disposed || suspended)
+                return;
+            suspended = true;
+            visit((entry) => {
+                if (entry.setup) {
+                    release(entry);
+                    return;
+                }
+                const resource = entry.resource;
+                if (typeof resource?.pause === 'function' &&
+                    typeof resource.play === 'function') {
+                    entry.resume = resource.paused !== true;
+                    if (entry.resume)
+                        resource.pause();
+                }
+                else
+                    remove(entry);
+            });
+        },
+        resume() {
+            if (disposed || !suspended)
+                return;
+            suspended = false;
+            visit((entry) => {
+                if (disposed || suspended)
+                    return;
+                if (entry.setup)
+                    startSubscription(entry);
+                else if (entry.resume) {
+                    entry.resume = false;
+                    entry.resource.play?.();
+                }
+            });
+        },
+        reset() {
+            if (disposed || clearing)
+                return;
+            clearing = true;
+            try {
+                visit(remove);
+            }
+            finally {
+                clearing = false;
+            }
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            visit(remove);
+        },
+    };
+    return scope;
+}
+//# sourceMappingURL=motion-scope.js.map

package/dist/motion-scope.js.map

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