@rafaelaugusto/jolt 0.1.0-rc.12 → 0.1.0-rc.12.1

package/README.md

@@ -31,7 +31,7 @@ NativeScript's `view.animate()` covers the basics and stops there: one curve for
 
 Jolt computes the motion once, in JavaScript, when the animation starts, and hands it to the platform as keyframes: Core Animation on iOS, `ObjectAnimator` on Android. Those default view tracks play without per-frame JavaScript. Real-size layout, opt-in subscribers, gesture input and timeline step activation retain their documented [execution limits](https://jolt.rafaelaugusto.dev/guide/how-it-works). Springs follow real physics, and an animation that interrupts another one starts from where the view is, at the speed it was going.
 
-The [0.1.0-rc.12 release candidate](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/CHANGELOG.md) adds native/Web pointer presence, property groups, renderer activity, bounded drawing, drop targets, optional audio/cues and inspection, plus Web paths, 3D rotation and shadows. The versioned [portable foundations](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/docs/guide/portable-foundations.md) and [interaction/depth guides](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/docs/guide/interaction-depth.md) include reviewed recordings and platform limits. Install `@rafaelaugusto/jolt@0.1.0-rc.12` and rebuild native apps; external native properties also need matching `@rafaelaugusto/jolt-native@0.1.0-rc.12`. Web APIs remain experimental; physical-device acceptance and performance investigations remain open.
+The [0.1.0-rc.12.1 release candidate](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12.1/CHANGELOG.md) adds [portable composition](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12.1/docs/guide/portable-composition.md): retained Web resources and Vue shapes, behavior priorities, gradient text, articulated 2D rigs, shared helpers and runtime-aware reduced-motion observation. Browser vector adapters include explicit availability; physical browser sensor validation remains open in #385. The guide includes reviewed native/browser recordings and platform limits. Install `@rafaelaugusto/jolt@0.1.0-rc.12.1` and rebuild native apps; external native properties also need matching `@rafaelaugusto/jolt-native@0.1.0-rc.12.1`. Web APIs remain experimental; performance investigations remain open.
 
 For the browser, import **`@rafaelaugusto/jolt/web`**. It installs without NativeScript, Vue or React; **`@rafaelaugusto/jolt/web/vue`** optionally integrates Vue 3.5 DOM refs and enter/leave. Both entries are experimental and use the same motion compiler as native playback. See [installation](https://jolt.rafaelaugusto.dev/guide/install#experimental-web-candidate), [finite Web playback](https://jolt.rafaelaugusto.dev/guide/web-runtime) and [Vue Web motion](https://jolt.rafaelaugusto.dev/guide/web-vue). Mavis integration and its shared application proof continue separately.
 
@@ -101,7 +101,7 @@ For the browser, import **`@rafaelaugusto/jolt/web`**. It installs without Nativ
 npm install @rafaelaugusto/jolt@next
 ```
 
-The current release candidate is **0.1.0-rc.12**, published under the `next` tag. Requires `@nativescript/core` 8.9 or later. It doesn't depend on a framework: it takes a view, or an element that holds one. Rebuild the native app after installing or upgrading Jolt. See [release status and limits](https://jolt.rafaelaugusto.dev/guide/not-there-yet) for the remaining stable-release acceptance work.
+The current release candidate is **0.1.0-rc.12.1**, published under the `next` tag. Requires `@nativescript/core` 8.9 or later. It doesn't depend on a framework: it takes a view, or an element that holds one. Rebuild the native app after installing or upgrading Jolt. See [release status and limits](https://jolt.rafaelaugusto.dev/guide/not-there-yet) for the remaining stable-release acceptance work.
 
 On iOS 15+, Jolt requests up to 120 Hz on ProMotion displays. Set `CADisableMinimumFrameDurationOnPhone` to `true` in the app's `App_Resources/iOS/Info.plist` and rebuild to enable higher rates on iPhone. See the [iOS setup](https://jolt.rafaelaugusto.dev/guide/install#promotion-on-ios); the system still chooses the actual refresh rate.
 

package/dist/core/gradient-text.d.ts

@@ -0,0 +1,24 @@
+/** Plain text paint shared by native glyph masks and browser text clipping. */
+export interface GradientTextDefinition<Color = string> {
+    colors: readonly Color[];
+    stops?: readonly number[];
+    /** Degrees clockwise from left-to-right. */
+    angle?: number;
+    sheen?: {
+        color?: Color;
+        width?: number;
+        direction?: 'left' | 'right';
+    };
+}
+export interface TextPaint {
+    colors: number[];
+    stops: number[];
+    angle: number;
+    sheen: number;
+    width: number;
+}
+export declare function resolveGradientText<Color>(options: GradientTextDefinition<Color>, parse: (color: Color) => number): {
+    paint: TextPaint;
+    direction: "left" | "right";
+};
+//# sourceMappingURL=gradient-text.d.ts.map

package/dist/core/gradient-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-text.d.ts","sourceRoot":"","sources":["../../src/core/gradient-text.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,MAAM;IACpD,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CACxE;AACD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,EACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM;;;EAsChC"}

package/dist/core/gradient-text.js

@@ -0,0 +1,30 @@
+export function resolveGradientText(options, parse) {
+    if (!Array.isArray(options.colors) ||
+        options.colors.length < 2 ||
+        options.colors.length > 8)
+        throw new TypeError('Gradient text needs 2..8 colors.');
+    const colors = Array.from(options.colors, parse);
+    const stops = options.stops
+        ? Array.from(options.stops)
+        : colors.map((_, i) => i / (colors.length - 1));
+    if (stops.length !== colors.length ||
+        stops.some((stop, i) => !Number.isFinite(stop) || stop < 0 || stop > 1 || (i > 0 && stop < stops[i - 1])))
+        throw new TypeError('Gradient stops must be ordered in 0..1 and match colors.');
+    const paint = {
+        colors,
+        stops,
+        angle: options.angle ?? 0,
+        sheen: options.sheen?.color === undefined ? 0xbfffffff : parse(options.sheen.color),
+        width: options.sheen?.width ?? 0.3,
+    };
+    const direction = options.sheen?.direction ?? 'right';
+    if (direction !== 'left' && direction !== 'right')
+        throw new TypeError('Invalid text sheen direction.');
+    if (!Number.isFinite(paint.angle) ||
+        !Number.isFinite(paint.width) ||
+        paint.width <= 0 ||
+        paint.width > 1)
+        throw new TypeError('Invalid text gradient angle or sheen width.');
+    return { paint, direction };
+}
+//# sourceMappingURL=gradient-text.js.map

package/dist/core/gradient-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient-text.js","sourceRoot":"","sources":["../../src/core/gradient-text.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,mBAAmB,CACjC,OAAsC,EACtC,KAA+B;IAE/B,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAEzB,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK;QACzB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IACjD,IACE,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAC9B,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACV,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CACpF;QAED,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAA;IACjF,MAAM,KAAK,GAAc;QACvB,MAAM;QACN,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACnF,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,GAAG;KACnC,CAAA;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,IAAI,OAAO,CAAA;IACrD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO;QAC/C,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAA;IACtD,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7B,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7B,KAAK,CAAC,KAAK,IAAI,CAAC;QAChB,KAAK,CAAC,KAAK,GAAG,CAAC;QAEf,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAA;IACpE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AAC7B,CAAC"}

package/dist/core/motion-behaviors.d.ts

@@ -0,0 +1,68 @@
+/** Platform execution is supplied by the native or browser scope adapter. */
+export interface BehaviorScope {
+    suspend(): void;
+    resume(): void;
+    dispose(): void;
+}
+export interface BehaviorHost<S extends BehaviorScope> {
+    scope(): S;
+    hidden(): boolean;
+    visibility(callback: () => void): () => void;
+    disposed?(): void;
+}
+export type BehaviorStatus = 'completed' | 'interrupted' | 'cancelled' | 'failed' | 'blocked';
+export interface BehaviorResult {
+    readonly status: BehaviorStatus;
+    readonly error?: unknown;
+}
+export interface BehaviorRun {
+    readonly id: number;
+    readonly name: string;
+    readonly finished: Promise<BehaviorResult>;
+    cancel(): void;
+}
+export interface BehaviorContext<S extends BehaviorScope> {
+    /** Private to this run; cancellation disposes it before the next run starts. */
+    readonly scope: S;
+    readonly id: number;
+    readonly active: boolean;
+    /** Check after an external await, before starting work or changing application state. */
+    checkpoint(): void;
+    /** Await work and check identity before continuing. False animation results cancel the run. */
+    wait<T>(work: PromiseLike<T>): Promise<T>;
+    /** Guard a callback that may arrive after interruption (e.g. a service response). */
+    guard<A extends unknown[]>(callback: (...args: A) => void): (...args: A) => void;
+}
+export interface MotionBehavior<S extends BehaviorScope> {
+    priority?: number;
+    /** Evaluated on each request. Domain state stays in the application. */
+    when?: () => boolean;
+    /** Explicit exclusions, including higher-priority requests. Defaults to none. */
+    blocks?: readonly string[];
+    /** Equal-priority requests, including the same name, reject by default. */
+    equal?: 'reject' | 'replace';
+    run(context: BehaviorContext<S>): void | PromiseLike<unknown>;
+}
+export interface MotionBehaviorsOptions<N extends string> {
+    /** Restart this declared rest behavior after success, cancellation or failure. No implicit resume. */
+    rest?: N;
+    /** Receive failure after cleanup. Throwing here does not strand another run. */
+    onError?: (error: unknown, name: N) => void;
+}
+export interface MotionBehaviors<N extends string = string> {
+    readonly current: N | undefined;
+    readonly disposed: boolean;
+    readonly paused: boolean;
+    can(name: N): boolean;
+    request(name: N): BehaviorRun;
+    /** Cancel the active run and restore the declared rest behavior. */
+    cancel(): void;
+    pause(): void;
+    play(): void;
+    /** Cancel without restoration; later requests may start again. */
+    stop(): void;
+    dispose(): void;
+}
+/** One exclusive interaction lane; other coordinators and unrelated input remain independent. */
+export declare function createMotionBehaviors<S extends BehaviorScope, const D extends Record<string, MotionBehavior<S>>>(definitions: D, options: MotionBehaviorsOptions<Extract<keyof D, string>>, host: BehaviorHost<S>): MotionBehaviors<Extract<keyof D, string>>;
+//# sourceMappingURL=motion-behaviors.d.ts.map

package/dist/core/motion-behaviors.d.ts.map

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

package/dist/core/motion-behaviors.js

@@ -0,0 +1,276 @@
+/** One exclusive interaction lane; other coordinators and unrelated input remain independent. */
+export function createMotionBehaviors(definitions, options, host) {
+    // Copy policy so changing the caller's object cannot silently change an active run.
+    const policies = new Map();
+    for (const [name, definition] of Object.entries(definitions)) {
+        if (!definition ||
+            typeof definition.run !== 'function' ||
+            !Number.isFinite(definition.priority ?? 0) ||
+            (definition.when !== undefined && typeof definition.when !== 'function') ||
+            (definition.equal !== undefined &&
+                !['reject', 'replace'].includes(definition.equal)) ||
+            (definition.blocks !== undefined &&
+                (!Array.isArray(definition.blocks) ||
+                    definition.blocks.some((n) => !Object.hasOwn(definitions, n)))))
+            throw new TypeError(`Invalid motion behavior "${name}".`);
+        policies.set(name, { ...definition, blocks: [...(definition.blocks ?? [])] });
+    }
+    if (options.rest !== undefined && !policies.has(options.rest))
+        throw new TypeError('The rest behavior must be declared.');
+    const cancelled = Symbol('cancelled behavior');
+    let serial = 0, disposed = false, paused = false, changing = false, restPending = false;
+    let background = host.hidden();
+    let unlisten = () => { };
+    const isPaused = () => paused || background;
+    let active;
+    const policy = (name) => {
+        const definition = policies.get(name);
+        if (!definition)
+            throw new TypeError(`Unknown motion behavior "${name}".`);
+        return definition;
+    };
+    const report = (error, name) => {
+        try {
+            options.onError?.(error, name);
+        }
+        catch {
+            /* Reporters cannot replace ownership. */
+        }
+    };
+    const finish = (run, status, error) => {
+        if (run.done)
+            return;
+        run.done = true;
+        run.wake?.();
+        if (active === run)
+            active = undefined;
+        try {
+            run.scope.dispose();
+        }
+        catch (cleanup) {
+            error =
+                error === undefined
+                    ? cleanup
+                    : new AggregateError([error, cleanup], 'Behavior cleanup failed.');
+            status = 'failed';
+        }
+        run.resolve({ status, ...(error === undefined ? {} : { error }) });
+        if (error !== undefined)
+            report(error, run.name);
+    };
+    const restore = (previous) => {
+        if (!disposed && !active && options.rest !== undefined && previous !== options.rest) {
+            restPending = isPaused();
+            if (!isPaused()) {
+                try {
+                    controller.request(options.rest);
+                }
+                catch (error) {
+                    report(error, options.rest);
+                }
+            }
+        }
+    };
+    const allowed = (name) => {
+        const candidate = policy(name);
+        if (disposed || isPaused() || changing)
+            return false;
+        let permitted;
+        changing = true;
+        try {
+            permitted = candidate.when?.() !== false;
+        }
+        finally {
+            changing = false;
+        }
+        if (!permitted || disposed || isPaused())
+            return false;
+        if (!active)
+            return true;
+        const current = policy(active.name);
+        if (current.blocks?.includes(name))
+            return false;
+        const delta = (candidate.priority ?? 0) - (current.priority ?? 0);
+        return delta > 0 || (delta === 0 && candidate.equal === 'replace');
+    };
+    const cancel = (restoreRest) => {
+        if (changing)
+            return;
+        restPending = false;
+        const previous = active?.name;
+        changing = true;
+        try {
+            if (active)
+                finish(active, 'cancelled');
+        }
+        finally {
+            changing = false;
+        }
+        if (restoreRest)
+            restore(previous);
+    };
+    const controller = {
+        get current() {
+            return active?.name;
+        },
+        get disposed() {
+            return disposed;
+        },
+        get paused() {
+            return isPaused();
+        },
+        can: allowed,
+        request(name) {
+            const id = ++serial;
+            if (!allowed(name))
+                return { id, name, finished: Promise.resolve({ status: 'blocked' }), cancel() { } };
+            // Guard/exclusion callbacks may have changed ownership; evaluate them before mutation.
+            const definition = policy(name);
+            changing = true;
+            try {
+                if (active)
+                    finish(active, 'interrupted');
+            }
+            finally {
+                changing = false;
+            }
+            if (disposed || isPaused())
+                return {
+                    id,
+                    name,
+                    finished: Promise.resolve({ status: 'cancelled' }),
+                    cancel() { },
+                };
+            restPending = false;
+            let resolve;
+            const finished = new Promise((r) => {
+                resolve = r;
+            });
+            const run = { id, name, scope: host.scope(), done: false, resolve };
+            active = run;
+            const checkpoint = () => {
+                if (disposed || run.done || active !== run)
+                    throw cancelled;
+            };
+            const context = {
+                id,
+                scope: run.scope,
+                get active() {
+                    return !disposed && !run.done && active === run;
+                },
+                checkpoint,
+                async wait(work) {
+                    checkpoint();
+                    const result = await work;
+                    checkpoint();
+                    while (isPaused()) {
+                        await new Promise((resolve) => {
+                            const previous = run.wake;
+                            run.wake = () => {
+                                previous?.();
+                                resolve();
+                            };
+                        });
+                        checkpoint();
+                    }
+                    if (result === false)
+                        throw cancelled;
+                    return result;
+                },
+                guard(callback) {
+                    return (...args) => {
+                        if (context.active)
+                            callback(...args);
+                    };
+                },
+            };
+            const settle = (status, error) => {
+                if (run.done)
+                    return;
+                changing = true;
+                try {
+                    finish(run, status, error);
+                }
+                finally {
+                    changing = false;
+                }
+                restore(name);
+            };
+            try {
+                const work = definition.run(context);
+                void Promise.resolve(work).then(() => settle('completed'), (error) => error === cancelled ? settle('cancelled') : settle('failed', error));
+            }
+            catch (error) {
+                settle(error === cancelled ? 'cancelled' : 'failed', error === cancelled ? undefined : error);
+            }
+            return {
+                id,
+                name,
+                finished,
+                cancel() {
+                    if (active === run)
+                        cancel(true);
+                },
+            };
+        },
+        cancel() {
+            cancel(true);
+        },
+        pause() {
+            if (paused || disposed)
+                return;
+            paused = true;
+            active?.scope.suspend();
+        },
+        play() {
+            if (!paused || disposed)
+                return;
+            paused = false;
+            if (!background)
+                active?.scope.resume();
+            wake();
+        },
+        stop() {
+            cancel(false);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            unlisten();
+            restPending = false;
+            // Guards and cleanup may dispose reentrantly. Invalidate the current run too.
+            const wasChanging = changing;
+            changing = true;
+            try {
+                if (active)
+                    finish(active, 'cancelled');
+            }
+            finally {
+                changing = wasChanging;
+                host.disposed?.();
+            }
+        },
+    };
+    const wake = () => {
+        if (disposed || isPaused())
+            return;
+        active?.wake?.();
+        if (active)
+            active.wake = undefined;
+        if (restPending) {
+            restPending = false;
+            restore();
+        }
+    };
+    unlisten = host.visibility(() => {
+        background = host.hidden();
+        if (background)
+            active?.scope.suspend();
+        else if (!paused)
+            active?.scope.resume();
+        wake();
+    });
+    return controller;
+}
+//# sourceMappingURL=motion-behaviors.js.map

package/dist/core/motion-behaviors.js.map

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

package/dist/core/rig.d.ts

@@ -0,0 +1,73 @@
+import type { Track } from './track.js';
+export declare const rigChannels: readonly ['x', 'y', 'scaleX', 'scaleY', 'rotate'];
+export type RigChannel = (typeof rigChannels)[number];
+export type RigTransform = Partial<Record<RigChannel, number>>;
+export interface RigPart {
+    parent?: string;
+    /** Fractions of the part's border-box size. */
+    pivot?: {
+        x: number;
+        y: number;
+    };
+    rest?: RigTransform;
+    /** Degrees; the entire sampled rotation, including spring overshoot, is bounded. */
+    rotation?: readonly [number, number];
+}
+export interface RigSocket {
+    part: string;
+    /** Local logical units (native DIPs / CSS pixels), or fractions when relative. */
+    x: number;
+    y: number;
+    units?: 'dip' | 'relative';
+}
+export interface RigDefinition {
+    parts: Record<string, RigPart>;
+    poses: Record<string, Record<string, RigTransform>>;
+    sockets?: Record<string, RigSocket>;
+}
+export declare const shortestRigAngle: (angle: number) => number;
+export interface RigPoseLayer {
+    pose: Record<string, RigTransform>;
+    weight: number;
+}
+export declare function resolveRigDefinition(definition: RigDefinition): {
+    parts: Map<string, {
+        parent?: string;
+        pivot: {
+            x: number;
+            y: number;
+        } | undefined;
+        rest: {
+            rotate?: number | undefined;
+            scaleX?: number | undefined;
+            scaleY?: number | undefined;
+            x?: number | undefined;
+            y?: number | undefined;
+        };
+        rotation: [number, number] | undefined;
+    }>;
+    poses: Map<string, {
+        [k: string]: {
+            rotate?: number | undefined;
+            scaleX?: number | undefined;
+            scaleY?: number | undefined;
+            x?: number | undefined;
+            y?: number | undefined;
+        };
+    }>;
+    sockets: Map<string, {
+        part: string;
+        /** Local logical units (native DIPs / CSS pixels), or fractions when relative. */
+        x: number;
+        y: number;
+        units?: 'dip' | 'relative';
+    }>;
+    used: Map<string, Set<"rotate" | "scaleX" | "scaleY" | "x" | "y">>;
+    select: (layers: readonly {
+        pose: string;
+        weight: number;
+    }[]) => RigPoseLayer[];
+};
+export declare function rigDestination(part: RigPart, name: string, property: RigChannel, rest: number, current: number, selected: readonly RigPoseLayer[]): number;
+export declare function limitRigTrack(original: Track, limits?: readonly [number, number]): Track;
+//# sourceMappingURL=rig.d.ts.map

package/dist/core/rig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rig.d.ts","sourceRoot":"","sources":["../../src/core/rig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,eAAO,MAAM,WAAW,YAAI,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;CAC3B;AACD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACpC;AAED,eAAO,MAAM,gBAAgB,UAAW,MAAM,WACD,CAAA;AAC7C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AACD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,aAAa;;iBA1BnD,MAAM;;eAEF,MAAM;eAAK,MAAM;;;;;;;;;;;;;;;;;;;;;cAMxB,MAAM;QACZ,kFAAkF;WAC/E,MAAM;WACN,MAAM;gBACD,KAAK,GAAG,UAAU;;;qBAgFhB,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,KAClD,YAAY,EAAE;EAQlB;AACD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,YAAY,EAAE,UAiBlC;AACD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,KAAK,EACf,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,KAAK,CAcP"}

package/dist/core/rig.js

@@ -0,0 +1,99 @@
+export const rigChannels = ['x', 'y', 'scaleX', 'scaleY', 'rotate'];
+const finite = (n) => typeof n === 'number' && Number.isFinite(n);
+export const shortestRigAngle = (angle) => ((((angle + 180) % 360) + 360) % 360) - 180;
+export function resolveRigDefinition(definition) {
+    const parts = new Map(Object.entries(definition.parts).map(([name, part]) => [
+        name,
+        {
+            ...part,
+            pivot: part.pivot && { ...part.pivot },
+            rest: { ...part.rest },
+            rotation: part.rotation && [...part.rotation],
+        },
+    ]));
+    if (!parts.size || parts.size > 64)
+        throw new RangeError('A rig supports 1..64 parts.');
+    const validateTransform = (values) => {
+        for (const [key, value] of Object.entries(values))
+            if (!rigChannels.includes(key) || !finite(value))
+                throw new TypeError('Invalid rig transform.');
+    };
+    const used = new Map();
+    for (const [name, part] of parts) {
+        validateTransform(part.rest);
+        used.set(name, new Set(Object.keys(part.rest)));
+        if (part.pivot && (!finite(part.pivot.x) || !finite(part.pivot.y)))
+            throw new TypeError('Invalid rig pivot.');
+        if (part.rotation &&
+            (part.rotation.length !== 2 ||
+                !part.rotation.every(finite) ||
+                part.rotation[0] > part.rotation[1]))
+            throw new TypeError('Invalid rotation limits.');
+        const visited = new Set([name]);
+        let parent = part.parent;
+        while (parent !== undefined) {
+            if (!parts.has(parent) || visited.has(parent))
+                throw new TypeError('Rig hierarchy contains a cycle or missing parent.');
+            visited.add(parent);
+            parent = parts.get(parent).parent;
+        }
+    }
+    const poses = new Map(Object.entries(definition.poses).map(([name, pose]) => [
+        name,
+        Object.fromEntries(Object.entries(pose).map(([part, values]) => {
+            if (!parts.has(part))
+                throw new TypeError(`Unknown rig part "${part}".`);
+            validateTransform(values);
+            Object.keys(values).forEach((key) => used.get(part).add(key));
+            return [part, { ...values }];
+        })),
+    ]));
+    const sockets = new Map(Object.entries(definition.sockets ?? {}).map(([name, socket]) => {
+        if (!parts.has(socket.part) ||
+            !finite(socket.x) ||
+            !finite(socket.y) ||
+            (socket.units !== undefined && !['dip', 'relative'].includes(socket.units)))
+            throw new TypeError('Invalid rig socket.');
+        return [name, { ...socket }];
+    }));
+    const select = (layers) => {
+        return layers.map((layer) => {
+            if (!finite(layer.weight) || layer.weight < 0 || !poses.has(layer.pose))
+                throw new TypeError('Unknown pose or invalid blend weight.');
+            return { pose: poses.get(layer.pose), weight: layer.weight };
+        });
+    };
+    return { parts, poses, sockets, used, select };
+}
+export function rigDestination(part, name, property, rest, current, selected) {
+    let total = 0, offset = 0;
+    for (const layer of selected) {
+        const value = layer.pose[name]?.[property];
+        if (value === undefined)
+            continue;
+        total += layer.weight;
+        offset +=
+            (property === 'rotate' && !part.rotation
+                ? shortestRigAngle(value - rest)
+                : value - rest) * layer.weight;
+    }
+    const destination = rest + offset / Math.max(1, total);
+    return property === 'rotate' && !part.rotation
+        ? current + shortestRigAngle(destination - current)
+        : destination;
+}
+export function limitRigTrack(original, limits) {
+    if (!limits)
+        return original;
+    const [min, max] = limits, clamp = (value) => Math.max(min, Math.min(max, value));
+    return {
+        ...original,
+        values: original.values.map(clamp),
+        to: clamp(original.to),
+        valueAt: (time) => clamp(original.valueAt(time)),
+        velocityAt: (time) => original.valueAt(time) <= min || original.valueAt(time) >= max
+            ? 0
+            : original.velocityAt(time),
+    };
+}
+//# sourceMappingURL=rig.js.map

package/dist/core/rig.js.map

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