@rafaelaugusto/jolt 0.0.0-stage → 0.1.0-beta.1

package/dist/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAA;AAE7E,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAA;AAY3D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAsB;IAC7C,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAE1B,MAAM,OAAO,GAAgB,EAAE,CAAA;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO;gBAAE,OAAM;YACnB,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;YACxE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvB,MAAM,SAAS,CAAC,SAAS,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjF,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,MAAM,SAAS,GAAc;QAC3B,QAAQ;QACR,IAAI;YACF,OAAO,GAAG,IAAI,CAAA;YACd,OAAO,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;KAC1E,CAAA;IACD,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsB;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,UAAU;YAAE,SAAQ;QACxC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;QACzC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAEjD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,IAAI,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAA;YAE5D,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAC9B,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,CACnE,CAAA;YACD,QAAQ,CACN,IAAI,EACJ,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CACpC,CAAA;YACD,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtC,IAAI,KAAK,KAAK,IAAI;oBAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;YACvD,CAAC;YACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE;gBAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAChE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/spring.d.ts

@@ -0,0 +1,22 @@
+export interface SpringPhysics {
+    stiffness: number;
+    damping: number;
+    mass: number;
+}
+export interface SpringParams {
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    bounce?: number;
+    duration?: number;
+}
+export interface SpringMotion {
+    /** Milliseconds until the spring settles. */
+    duration: number;
+    position(time: number): number;
+    /** Units per second. */
+    velocity(time: number): number;
+}
+export declare function springPhysics({ stiffness, damping, mass, bounce, duration, }: SpringParams): SpringPhysics;
+export declare function solveSpring({ stiffness, damping, mass }: SpringPhysics, from: number, to: number, velocity: number, precision: number): SpringMotion;
+//# sourceMappingURL=spring.d.ts.map

package/dist/spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../src/spring.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAC/B;AAKD,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,OAAO,EACP,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE,YAAY,GAAG,aAAa,CAW9B;AAED,wBAAgB,WAAW,CACzB,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,aAAa,EAC3C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,YAAY,CA4Cd"}

package/dist/spring.js

@@ -0,0 +1,54 @@
+const MAX_DURATION = 10_000;
+const STEP = 1000 / 120;
+export function springPhysics({ stiffness, damping, mass, bounce, duration, }) {
+    if (stiffness !== undefined || damping !== undefined || mass !== undefined) {
+        return { stiffness: stiffness ?? 170, damping: damping ?? 26, mass: mass ?? 1 };
+    }
+    // The same model as SwiftUI: duration is the period of the undamped spring,
+    // bounce 0 is critically damped, negative values are overdamped.
+    const omega = (2 * Math.PI) / ((duration ?? 400) / 1000);
+    const b = Math.min(Math.max(bounce ?? 0.15, -0.99), 0.99);
+    const ratio = b >= 0 ? 1 - b : 1 / (1 + b);
+    return { stiffness: omega * omega, damping: 2 * ratio * omega, mass: 1 };
+}
+export function solveSpring({ stiffness, damping, mass }, from, to, velocity, precision) {
+    const x0 = from - to;
+    const w0 = Math.sqrt(stiffness / mass);
+    const zeta = damping / (2 * Math.sqrt(stiffness * mass));
+    let displacement;
+    if (Math.abs(zeta - 1) < 1e-6) {
+        const b = velocity + w0 * x0;
+        displacement = (t) => Math.exp(-w0 * t) * (x0 + b * t);
+    }
+    else if (zeta < 1) {
+        const wd = w0 * Math.sqrt(1 - zeta * zeta);
+        const b = (velocity + zeta * w0 * x0) / wd;
+        displacement = (t) => Math.exp(-zeta * w0 * t) * (x0 * Math.cos(wd * t) + b * Math.sin(wd * t));
+    }
+    else {
+        const s = w0 * Math.sqrt(zeta * zeta - 1);
+        const r1 = -zeta * w0 + s;
+        const r2 = -zeta * w0 - s;
+        const c1 = (velocity - r2 * x0) / (r1 - r2);
+        const c2 = x0 - c1;
+        displacement = (t) => c1 * Math.exp(r1 * t) + c2 * Math.exp(r2 * t);
+    }
+    const position = (time) => to + displacement(time / 1000);
+    const speed = (time) => {
+        const t = time / 1000;
+        return (displacement(t + 0.0005) - displacement(t - 0.0005)) / 0.001;
+    };
+    let duration = 0;
+    while (duration < MAX_DURATION &&
+        (Math.abs(displacement(duration / 1000)) > precision ||
+            Math.abs(speed(duration)) > precision * 10)) {
+        duration += STEP;
+    }
+    duration = Math.ceil(duration);
+    return {
+        duration,
+        position: (time) => (time >= duration ? to : position(time)),
+        velocity: (time) => (time >= duration ? 0 : speed(time)),
+    };
+}
+//# sourceMappingURL=spring.js.map

package/dist/spring.js.map

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

package/dist/track.d.ts

@@ -0,0 +1,28 @@
+import { type Property } from './properties.js';
+import type { ResolvedTransition } from './transition.js';
+/**
+ * One property animated over time. The curve is computed here and sampled,
+ * so the platform plays plain keyframes and nothing runs in JavaScript per frame.
+ */
+export interface Track {
+    readonly property: Property;
+    readonly delay: number;
+    /** One iteration, in milliseconds. */
+    readonly duration: number;
+    readonly repeat: number;
+    readonly reverse: boolean;
+    /** Offsets from 0 to 1 within one iteration, paired with `values`. */
+    readonly times: readonly number[];
+    readonly values: readonly number[];
+    /** Where the property is left once the track is over. */
+    readonly to: number;
+    /** Milliseconds from the start until the end of the last iteration. */
+    readonly end: number;
+    /** When it looks done: a spring is close to its target and stays there, long before it settles. */
+    readonly arrival: number;
+    valueAt(elapsed: number): number;
+    /** Units per second. */
+    velocityAt(elapsed: number): number;
+}
+export declare function createTrack(property: Property, keyframes: readonly number[], { curve, delay, repeat, reverse }: ResolvedTransition, velocity: number): Track;
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAS,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,wBAAwB;IACxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAaD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,kBAAkB,EACrD,QAAQ,EAAE,MAAM,GACf,KAAK,CAuCP"}

package/dist/track.js

@@ -0,0 +1,103 @@
+import { linear } from './easing.js';
+import { precision } from './properties.js';
+import { solveSpring } from './spring.js';
+const SAMPLES_PER_SECOND = 60;
+const ARRIVAL_TOLERANCE = 0.05;
+export function createTrack(property, keyframes, { curve, delay, repeat, reverse }, velocity) {
+    const motion = curve.type === 'spring'
+        ? spring(property, keyframes, curve, velocity)
+        : tween(keyframes, curve);
+    const { duration } = motion;
+    const first = motion.values[0];
+    const last = motion.values.at(-1);
+    const finite = Number.isFinite(repeat);
+    const endsBackwards = reverse && finite && repeat % 2 === 1;
+    const end = delay + (duration === 0 ? 0 : duration * (repeat + 1));
+    const localTime = (elapsed) => {
+        const time = elapsed - delay;
+        if (time <= 0)
+            return [0, 1];
+        if (time >= end - delay)
+            return [endsBackwards ? 0 : duration, 1];
+        const iteration = Math.floor(time / duration);
+        const local = time - iteration * duration;
+        return reverse && iteration % 2 === 1 ? [duration - local, -1] : [local, 1];
+    };
+    return {
+        property,
+        delay,
+        duration,
+        repeat,
+        reverse,
+        times: motion.times,
+        values: motion.values,
+        to: !finite || endsBackwards ? first : last,
+        end,
+        arrival: curve.type === 'spring' && repeat === 0 ? delay + arrival(motion) : end,
+        valueAt: (elapsed) => motion.position(localTime(elapsed)[0]),
+        velocityAt: (elapsed) => {
+            if (elapsed <= delay || elapsed >= end)
+                return 0;
+            const [time, direction] = localTime(elapsed);
+            return motion.velocity(time) * direction;
+        },
+    };
+}
+function arrival({ times, values, duration }) {
+    const target = values.at(-1);
+    const tolerance = Math.max(...values.map((value) => Math.abs(value - target))) * ARRIVAL_TOLERANCE;
+    let i = values.length - 1;
+    while (i > 0 && Math.abs(values[i - 1] - target) <= tolerance)
+        i--;
+    return times[i] * duration;
+}
+function spring(property, [from, to], curve, velocity) {
+    const motion = solveSpring(curve.physics, from, to, curve.velocity ?? velocity, precision[property]);
+    const steps = Math.max(1, Math.ceil((motion.duration / 1000) * SAMPLES_PER_SECOND));
+    const times = [];
+    const values = [];
+    for (let i = 0; i <= steps; i++) {
+        times.push(i / steps);
+        values.push(i === steps ? to : motion.position((i / steps) * motion.duration));
+    }
+    return { ...motion, times, values };
+}
+function tween(keyframes, curve) {
+    const { duration, ease } = curve;
+    const offsets = curve.times ?? keyframes.map((_, i) => i / (keyframes.length - 1));
+    const position = (time) => {
+        const progress = duration > 0 ? Math.min(Math.max(time / duration, 0), 1) : 1;
+        let i = 0;
+        while (i < offsets.length - 2 && progress > offsets[i + 1])
+            i++;
+        const start = offsets[i];
+        const span = offsets[i + 1] - start;
+        const local = span > 0 ? (progress - start) / span : 1;
+        const from = keyframes[i];
+        return from + (keyframes[i + 1] - from) * ease[i](local);
+    };
+    const times = [0];
+    const values = [keyframes[0]];
+    for (let i = 0; i < keyframes.length - 1; i++) {
+        const start = offsets[i];
+        const span = offsets[i + 1] - start;
+        const from = keyframes[i];
+        const to = keyframes[i + 1];
+        const easing = ease[i];
+        const steps = easing === linear || from === to
+            ? 1
+            : Math.max(1, Math.ceil(((span * duration) / 1000) * SAMPLES_PER_SECOND));
+        for (let step = 1; step <= steps; step++) {
+            times.push(start + (span * step) / steps);
+            values.push(step === steps ? to : from + (to - from) * easing(step / steps));
+        }
+    }
+    return {
+        duration,
+        position,
+        velocity: (time) => (position(time + 0.5) - position(time - 0.5)) * 1000,
+        times,
+        values,
+    };
+}
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

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

package/dist/transition.d.ts

@@ -0,0 +1,58 @@
+import { type Easing, type EasingFunction } from './easing.js';
+import type { Property } from './properties.js';
+import { type SpringPhysics } from './spring.js';
+export interface Timing {
+    /** Milliseconds to wait before starting. The first keyframe is applied right away. */
+    delay?: number;
+    /** How many more times to play it. `Infinity` keeps going until stopped. */
+    repeat?: number;
+    /** `reverse` plays every other repeat backwards. */
+    repeatType?: 'loop' | 'reverse';
+}
+export interface Tween extends Timing {
+    type?: 'tween';
+    /** Milliseconds. */
+    duration?: number;
+    /** One easing, or one per segment between keyframes. */
+    ease?: Easing | readonly Easing[];
+    /** Where each keyframe sits, from 0 to 1. Evenly spaced by default. */
+    times?: readonly number[];
+}
+export interface Spring extends Timing {
+    type?: 'spring';
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    /** From -1 to 1. 0 settles without overshooting, higher values bounce more. */
+    bounce?: number;
+    /** How long the spring feels, in milliseconds. Goes with `bounce`, ignored with `stiffness`, `damping` or `mass`. */
+    duration?: number;
+    /** Units per second. Defaults to the velocity of the animation it interrupts. */
+    velocity?: number;
+}
+export type Transition = Tween | Spring;
+export type SpringName = 'smooth' | 'snappy' | 'bouncy';
+export declare const springs: Record<SpringName, Spring>;
+export type Curve = {
+    type: 'tween';
+    duration: number;
+    ease: readonly EasingFunction[];
+    times: readonly number[] | undefined;
+} | {
+    type: 'spring';
+    physics: SpringPhysics;
+    velocity: number | undefined;
+};
+export interface ResolvedTransition {
+    curve: Curve;
+    delay: number;
+    repeat: number;
+    reverse: boolean;
+}
+export declare const DEFAULT_DURATION = 300;
+export declare function hasCurve(transition: Transition): boolean;
+export declare function timingOf(transition: Transition): Timing;
+/** Timing merges key by key, the curve is taken whole from whichever side has one. */
+export declare function mergeTransitions(base: Transition, override: Transition): Transition;
+export declare function resolveTransition(transition: Transition, property: Property, keyframes: number): ResolvedTransition;
+//# sourceMappingURL=transition.d.ts.map

package/dist/transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.d.ts","sourceRoot":"","sources":["../src/transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE/D,MAAM,WAAW,MAAM;IACrB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,WAAW,KAAM,SAAQ,MAAM;IACnC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACjC,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qHAAqH;IACrH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAA;AAEvC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEvD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAI9C,CAAA;AAED,MAAM,MAAM,KAAK,GACb;IACE,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;IAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACrC,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAE5E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAMD,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAIxD;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAMvD;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,CAInF;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CA8DpB"}

package/dist/transition.js

@@ -0,0 +1,82 @@
+import { resolveEasing } from './easing.js';
+import { springPhysics } from './spring.js';
+export const springs = {
+    smooth: { type: 'spring', duration: 500, bounce: 0 },
+    snappy: { type: 'spring', duration: 400, bounce: 0.15 },
+    bouncy: { type: 'spring', duration: 550, bounce: 0.4 },
+};
+const springKeys = ['stiffness', 'damping', 'mass', 'bounce', 'velocity'];
+const curveKeys = ['type', 'duration', 'ease', 'times', ...springKeys];
+const timingKeys = ['delay', 'repeat', 'repeatType'];
+export const DEFAULT_DURATION = 300;
+export function hasCurve(transition) {
+    return curveKeys.some((key) => transition[key] !== undefined);
+}
+export function timingOf(transition) {
+    const timing = {};
+    for (const key of timingKeys) {
+        if (transition[key] !== undefined)
+            timing[key] = transition[key];
+    }
+    return timing;
+}
+/** Timing merges key by key, the curve is taken whole from whichever side has one. */
+export function mergeTransitions(base, override) {
+    return hasCurve(override)
+        ? { ...timingOf(base), ...override }
+        : { ...base, ...timingOf(override) };
+}
+export function resolveTransition(transition, property, keyframes) {
+    const type = transition.type ??
+        (springKeys.some((key) => transition[key] !== undefined)
+            ? 'spring'
+            : hasCurve(transition) || property === 'opacity' || keyframes > 2
+                ? 'tween'
+                : 'spring');
+    const delay = transition.delay ?? 0;
+    const repeat = transition.repeat ?? 0;
+    if (delay < 0 || Number.isNaN(delay))
+        throw new RangeError(`Invalid delay: ${delay}.`);
+    if (repeat < 0 || Number.isNaN(repeat))
+        throw new RangeError(`Invalid repeat: ${repeat}.`);
+    const timing = { delay, repeat, reverse: transition.repeatType === 'reverse' };
+    if (type === 'spring') {
+        if (keyframes > 2) {
+            throw new Error(`A spring goes from one value to another, but "${property}" has ${keyframes} keyframes. Use a tween for keyframes.`);
+        }
+        const spring = transition;
+        return {
+            ...timing,
+            curve: { type, physics: springPhysics(spring), velocity: spring.velocity },
+        };
+    }
+    const tween = transition;
+    const duration = tween.duration ?? DEFAULT_DURATION;
+    if (duration < 0 || Number.isNaN(duration)) {
+        throw new RangeError(`Invalid duration: ${duration}.`);
+    }
+    const segments = keyframes - 1;
+    const ease = tween.ease ?? 'easeOut';
+    const eases = isEasingList(ease) ? ease : Array.from({ length: segments }, () => ease);
+    if (eases.length !== segments) {
+        throw new Error(`"${property}" has ${segments} segments between keyframes but ${eases.length} easings.`);
+    }
+    const times = tween.times;
+    if (times) {
+        const valid = times.length === keyframes &&
+            times[0] === 0 &&
+            times.at(-1) === 1 &&
+            times.every((time, i) => i === 0 || time >= times[i - 1]);
+        if (!valid) {
+            throw new Error(`"times" needs one value per keyframe (${keyframes}), going from 0 to 1 without going back.`);
+        }
+    }
+    return {
+        ...timing,
+        curve: { type, duration, ease: eases.map(resolveEasing), times },
+    };
+}
+function isEasingList(ease) {
+    return Array.isArray(ease) && ease.length > 0 && typeof ease[0] !== 'number';
+}
+//# sourceMappingURL=transition.js.map

package/dist/transition.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+import type { View } from '@nativescript/core';
+import type { SpringName, Transition } from './transition.js';
+/** A value to animate to, or keyframes. `null` stands for the value the view has when the animation starts. */
+export type KeyframeValue = number | readonly (number | null)[];
+export interface Keyframes {
+    opacity?: KeyframeValue;
+    /** Same as `translateX`, in DIPs. */
+    x?: KeyframeValue;
+    /** Same as `translateY`, in DIPs. */
+    y?: KeyframeValue;
+    /** Sets `scaleX` and `scaleY` together. */
+    scale?: KeyframeValue;
+    scaleX?: KeyframeValue;
+    scaleY?: KeyframeValue;
+    /** Degrees. */
+    rotate?: KeyframeValue;
+    rotateX?: KeyframeValue;
+    rotateY?: KeyframeValue;
+}
+/** A view, or anything that holds one: a NativeScript-Vue element, an Angular `ElementRef`. */
+export type Target = View | {
+    readonly nativeView: View;
+} | {
+    readonly nativeElement: View;
+};
+export interface Stagger {
+    /** Milliseconds between one target and the next. */
+    each: number;
+    /** Which target starts first. */
+    from?: 'first' | 'last' | 'center' | number;
+}
+export type AnimateOptions = Transition & {
+    [K in keyof Keyframes]?: Transition | SpringName;
+} & {
+    /** Offset translations/rotations and multiply scale/opacity by their values at the start. */
+    relative?: boolean;
+    /** With several targets, delays each one by this much more than the previous. */
+    stagger?: number | Stagger;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE7D,+GAA+G;AAC/G,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;AAE/D,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,qCAAqC;IACrC,CAAC,CAAC,EAAE,aAAa,CAAA;IACjB,qCAAqC;IACrC,CAAC,CAAC,EAAE,aAAa,CAAA;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,eAAe;IACf,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED,+FAA+F;AAC/F,MAAM,MAAM,MAAM,GAChB,IAAI,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;CAAE,CAAA;AAEzE,MAAM,WAAW,OAAO;IACtB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CAC5C;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;KACvC,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,UAAU;CACjD,GAAG;IACF,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "@rafaelaugusto/jolt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-beta.1",
+  "description": "Native animations for NativeScript: presets, springs, keyframes and stagger in one call.",
+  "keywords": [
+    "nativescript",
+    "animation",
+    "animations",
+    "motion",
+    "spring",
+    "keyframes",
+    "ios",
+    "android"
+  ],
+  "author": "Rafael Augusto",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rafaelaugustos/jolt.git"
+  },
+  "homepage": "https://github.com/rafaelaugustos/jolt#readme",
+  "bugs": "https://github.com/rafaelaugustos/jolt/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@nativescript/core": ">=8.9.0"
+  },
+  "devDependencies": {
+    "@nativescript/core": "^9.1.3",
+    "@nativescript/types-android": "^9.1.1",
+    "@nativescript/types-ios": "^9.1.3",
+    "prettier": "^3.9.10",
+    "typescript": "^7.0.2",
+    "vitepress": "^1.6.4",
+    "vitest": "^5.0.4"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}