@rafaelaugusto/jolt 0.1.0-rc.4 → 0.1.0-rc.6

package/dist/core/gravity.js

@@ -0,0 +1,84 @@
+export const DEFAULT_ACCELERATION = 1800;
+export const DEFAULT_RESTITUTION = 0.55;
+const MAX_FLIGHTS = 512;
+const MAX_DURATION = 60_000;
+/** Ballistic flights against one fixed boundary; no numerical integration or frame loop. */
+export function solveGravity(from, to, acceleration, restitution, velocity, precision) {
+    if (![from, to, acceleration, restitution, velocity, precision].every(Number.isFinite) ||
+        acceleration <= 0 ||
+        restitution < 0 ||
+        restitution >= 1 ||
+        precision <= 0)
+        throw new RangeError('Invalid gravity position, acceleration, restitution or velocity.');
+    const direction = to < from ? -1 : 1;
+    const distance = Math.abs(to - from);
+    let speed = velocity * direction;
+    const impact = Math.hypot(speed, Math.sqrt(2 * acceleration * distance));
+    if (!Number.isFinite(impact))
+        throw new RangeError('Gravity motion exceeds the finite numeric range.');
+    // This form avoids cancellation when moving quickly toward a nearby boundary.
+    let seconds = speed >= 0
+        ? distance === 0
+            ? 0
+            : (2 * distance) / (impact + speed)
+        : (impact - speed) / acceleration;
+    let duration = 0;
+    const flights = [];
+    const breakpoints = [];
+    const addFlight = (origin, initial, length) => {
+        const end = duration + length * 1000;
+        if (!Number.isFinite(end) || end > MAX_DURATION || flights.length >= MAX_FLIGHTS)
+            throw new RangeError('Gravity motion must settle within 60 seconds and 512 flights.');
+        if (length > 0) {
+            const apex = duration - (initial / acceleration) * 1000;
+            if (apex > duration && apex < end)
+                breakpoints.push(apex);
+            flights.push({ start: duration, end, origin, speed: initial });
+            breakpoints.push(end);
+            duration = end;
+        }
+    };
+    addFlight(-distance, speed, seconds);
+    speed = impact * restitution;
+    while (speed > precision * 10 || (speed * speed) / (2 * acceleration) > precision) {
+        seconds = (2 * speed) / acceleration;
+        addFlight(0, -speed, seconds);
+        speed *= restitution;
+    }
+    const flightAt = (time) => {
+        let lo = 0, hi = flights.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            if (time >= flights[mid].end)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return flights[lo];
+    };
+    return {
+        duration,
+        breakpoints,
+        position(time) {
+            if (time >= duration)
+                return to;
+            if (time <= 0)
+                return from;
+            const flight = flightAt(time);
+            const t = (time - flight.start) / 1000;
+            return (to +
+                direction *
+                    Math.min(0, flight.origin + flight.speed * t + (acceleration * t * t) / 2));
+        },
+        velocity(time) {
+            if (duration === 0 || time >= duration)
+                return 0;
+            const flight = flightAt(Math.max(0, time));
+            return (direction *
+                (flight.speed + (acceleration * (Math.max(0, time) - flight.start)) / 1000));
+        },
+        // Valid between mandatory impact seams. Each flight is an exact quadratic.
+        interpolationError: (start, end) => (acceleration * ((end - start) / 1000) ** 2) / 8,
+    };
+}
+//# sourceMappingURL=gravity.js.map

package/dist/core/gravity.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { createTrack, type Track, type CompilationSettings } from './track.js';
+export { resolveTransition, mergeTransitions, fitTransition, origamiSpring, springs, type Transition, type ResolvedTransition, type Curve, } from './transition.js';
+export { createClock, validateProgress, type Animation, type PlaybackAnimation, type PlaybackClock, type PlaybackCommand, type PlaybackState, } from './playback.js';
+export { createOwnership } from './ownership.js';
+export type { Driver, LayoutFrame } from './driver.js';
+export type { Property, NumericProperty } from './properties.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,OAAO,EACP,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,KAAK,GACX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+// Internal portable boundary. This is not a published package entry point yet.
+export { createTrack } from './track.js';
+export { resolveTransition, mergeTransitions, fitTransition, origamiSpring, springs, } from './transition.js';
+export { createClock, validateProgress, } from './playback.js';
+export { createOwnership } from './ownership.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAwC,MAAM,YAAY,CAAA;AAC9E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,OAAO,GAIR,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,WAAW,EACX,gBAAgB,GAMjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/core/numeric-map.d.ts

@@ -0,0 +1,11 @@
+export interface NumericMapOptions {
+    clamp?: boolean;
+}
+/** A bounded piecewise linear map. At an interior knot, use the left derivative. */
+export declare function numericMap(input: readonly number[], output: readonly number[], options?: NumericMapOptions): {
+    sample: (value: number) => {
+        value: any;
+        slope: number;
+    };
+};
+//# sourceMappingURL=numeric-map.d.ts.map

package/dist/core/numeric-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numeric-map.d.ts","sourceRoot":"","sources":["../../src/core/numeric-map.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE,iBAAsB;oBAoCR,MAAM;;;;EAa9B"}

package/dist/core/numeric-map.js

@@ -0,0 +1,48 @@
+/** A bounded piecewise linear map. At an interior knot, use the left derivative. */
+export function numericMap(input, output, options = {}) {
+    if (!Array.isArray(input) ||
+        !Array.isArray(output) ||
+        input.length < 2 ||
+        input.length > 1024 ||
+        input.length !== output.length ||
+        [...input, ...output].some((n) => typeof n !== 'number' || !Number.isFinite(n)))
+        throw new TypeError('A numeric map needs 2–1024 finite input/output pairs.');
+    if (!options ||
+        typeof options !== 'object' ||
+        Object.keys(options).some((key) => key !== 'clamp') ||
+        (options.clamp !== undefined && typeof options.clamp !== 'boolean'))
+        throw new TypeError('Mapping options support only a boolean clamp.');
+    const clamp = options.clamp !== false;
+    const x = [...input], y = [...output];
+    if (x.at(-1) < x[0]) {
+        x.reverse();
+        y.reverse();
+    }
+    const slopes = x.slice(1).map((stop, i) => {
+        if (stop <= x[i])
+            throw new RangeError('Map inputs must be strictly monotonic; duplicate stops are unsupported.');
+        const span = stop - x[i], slope = (y[i + 1] - y[i]) / span;
+        if (!Number.isFinite(span) || !Number.isFinite(slope))
+            throw new RangeError('Numeric mapping range overflowed.');
+        return slope;
+    });
+    const sample = (value) => {
+        if (!Number.isFinite(value))
+            throw new RangeError('Mapped input must be finite.');
+        if (clamp) {
+            if (value <= x[0])
+                return { value: y[0], slope: 0 };
+            if (value >= x.at(-1))
+                return { value: y.at(-1), slope: 0 };
+        }
+        let i = 0;
+        while (i < slopes.length - 1 && value > x[i + 1])
+            i++;
+        const mapped = y[i] + (value - x[i]) * slopes[i];
+        if (!Number.isFinite(mapped))
+            throw new RangeError('Mapped output overflowed.');
+        return { value: mapped, slope: slopes[i] };
+    };
+    return { sample };
+}
+//# sourceMappingURL=numeric-map.js.map

package/dist/core/numeric-map.js.map

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

package/dist/core/ownership.d.ts

@@ -0,0 +1,7 @@
+/** A registry per runtime/context. Tokens prevent old cleanup from changing a newer owner. */
+export declare function createOwnership<Target extends object, Property extends string>(): {
+    get(target: Target, property: Property): symbol | undefined;
+    claim(target: Target, property: Property): symbol;
+    invalidate(target: Target, properties?: readonly Property[]): void;
+};
+//# sourceMappingURL=ownership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../src/core/ownership.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,MAAM,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM;gBAG9D,MAAM,YAAY,QAAQ;kBAGxB,MAAM,YAAY,QAAQ;uBAOrB,MAAM,eAAe,SAAS,QAAQ,EAAE;EAM9D"}

package/dist/core/ownership.js

@@ -0,0 +1,23 @@
+/** A registry per runtime/context. Tokens prevent old cleanup from changing a newer owner. */
+export function createOwnership() {
+    const revisions = new WeakMap();
+    return {
+        get(target, property) {
+            return revisions.get(target)?.get(property);
+        },
+        claim(target, property) {
+            let tokens = revisions.get(target);
+            if (!tokens)
+                revisions.set(target, (tokens = new Map()));
+            const token = Symbol(property);
+            tokens.set(property, token);
+            return token;
+        },
+        invalidate(target, properties) {
+            const tokens = revisions.get(target);
+            for (const property of properties ?? tokens?.keys() ?? [])
+                tokens?.set(property, Symbol(property));
+        },
+    };
+}
+//# sourceMappingURL=ownership.js.map

package/dist/core/ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.js","sourceRoot":"","sources":["../../src/core/ownership.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,IAAI,OAAO,EAAiC,CAAA;IAC9D,OAAO;QACL,GAAG,CAAC,MAAc,EAAE,QAAkB;YACpC,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC;QACD,KAAK,CAAC,MAAc,EAAE,QAAkB;YACtC,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAClC,IAAI,CAAC,MAAM;gBAAE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAA;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC9B,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC3B,OAAO,KAAK,CAAA;QACd,CAAC;QACD,UAAU,CAAC,MAAc,EAAE,UAAgC;YACzD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACpC,KAAK,MAAM,QAAQ,IAAI,UAAU,IAAI,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;gBACvD,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/core/playback.d.ts

@@ -0,0 +1,44 @@
+export interface Animation extends PromiseLike<boolean> {
+    /**
+     * Resolves with `true` once the animation played to the end, or with `false`
+     * if it was stopped, superseded or skipped.
+     * Playback cancellation never rejects; sequences can reject setup/callback errors.
+     */
+    readonly finished: Promise<boolean>;
+    /** Stops playback. Each effect documents whether it preserves or restores its visual state. */
+    stop(): void;
+}
+/** Controls returned by animate() and decay(). Effects expose the base Animation. */
+export interface PlaybackAnimation extends Animation {
+    /** Pauses only the properties owned by this animation. */
+    pause(): void;
+    /** Continues from the current position. Completed/stopped animations remain terminal. */
+    play(): void;
+    readonly paused: boolean;
+    /** Total milliseconds, including delays and repeats. Infinity for endless loops. */
+    readonly duration: number;
+    /** Finite timeline position, from 0 to 1. Seeking preserves the playing/paused state. */
+    progress: number;
+}
+export type PlaybackCommand = 'pause' | 'play' | 'seek';
+export interface PlaybackClock {
+    time(): number;
+    pause(): void;
+    play(): void;
+    seek(ms: number): void;
+    cancel(): void;
+}
+/** Boundary notifications, never frame callbacks. Consumers sample this same clock. */
+export interface PlaybackState {
+    readonly position?: number;
+    readonly time: number;
+    readonly duration: number;
+    readonly paused: boolean;
+    readonly ready: boolean;
+    readonly settled: boolean;
+    readonly completed: boolean;
+}
+/** Read only on user commands; there is no frame loop in JavaScript. */
+export declare function createClock(now: () => number, initial?: number): PlaybackClock;
+export declare function validateProgress(value: number, duration: number): void;
+//# sourceMappingURL=playback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"playback.d.ts","sourceRoot":"","sources":["../../src/core/playback.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAU,SAAQ,WAAW,CAAC,OAAO,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACnC,+FAA+F;IAC/F,IAAI,IAAI,IAAI,CAAA;CACb;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,0DAA0D;IAC1D,KAAK,IAAI,IAAI,CAAA;IACb,yFAAyF;IACzF,IAAI,IAAI,IAAI,CAAA;IACZ,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,MAAM,CAAA;IACd,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,OAAO,SAAI,GAAG,aAAa,CA0BzE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAO/D"}

package/dist/core/playback.js

@@ -0,0 +1,35 @@
+/** Read only on user commands; there is no frame loop in JavaScript. */
+export function createClock(now, initial = 0) {
+    let offset = initial;
+    let anchor = now();
+    let paused = false;
+    const time = () => offset + (paused ? 0 : now() - anchor);
+    return {
+        time,
+        pause() {
+            offset = time();
+            paused = true;
+        },
+        play() {
+            if (paused) {
+                anchor = now();
+                paused = false;
+            }
+        },
+        seek(ms) {
+            offset = ms;
+            anchor = now();
+        },
+        cancel() {
+            offset = time();
+            paused = true;
+        },
+    };
+}
+export function validateProgress(value, duration) {
+    if (!Number.isFinite(value) || value < 0 || value > 1)
+        throw new RangeError('Animation progress must be between 0 and 1.');
+    if (!Number.isFinite(duration))
+        throw new RangeError('Progress requires a finite animation; endless loops can pause and play.');
+}
+//# sourceMappingURL=playback.js.map

package/dist/core/playback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playback.js","sourceRoot":"","sources":["../../src/core/playback.ts"],"names":[],"mappings":"AA6CA,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,GAAiB,EAAE,OAAO,GAAG,CAAC;IACxD,IAAI,MAAM,GAAG,OAAO,CAAA;IACpB,IAAI,MAAM,GAAG,GAAG,EAAE,CAAA;IAClB,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAA;IACzD,OAAO;QACL,IAAI;QACJ,KAAK;YACH,MAAM,GAAG,IAAI,EAAE,CAAA;YACf,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;QACD,IAAI;YACF,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,EAAE,CAAA;gBACd,MAAM,GAAG,KAAK,CAAA;YAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,EAAE;YACL,MAAM,GAAG,EAAE,CAAA;YACX,MAAM,GAAG,GAAG,EAAE,CAAA;QAChB,CAAC;QACD,MAAM;YACJ,MAAM,GAAG,IAAI,EAAE,CAAA;YACf,MAAM,GAAG,IAAI,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,QAAgB;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,6CAA6C,CAAC,CAAA;IACrE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC5B,MAAM,IAAI,UAAU,CAClB,yEAAyE,CAC1E,CAAA;AACL,CAAC"}

package/dist/core/presets.d.ts

@@ -0,0 +1,298 @@
+export declare const presets: {
+    fadeIn: {
+        keyframes: {
+            opacity: number[];
+        };
+        transition: {
+            readonly duration: 300;
+            readonly ease: 'easeOut';
+        };
+    };
+    fadeInUp: {
+        keyframes: {
+            opacity: number[];
+            y: number[];
+        };
+        transition: {
+            type: 'spring';
+            duration: 500;
+            bounce: 0;
+            opacity: {
+                readonly duration: 300;
+                readonly ease: 'easeOut';
+            };
+        };
+    };
+    fadeInDown: {
+        keyframes: {
+            opacity: number[];
+            y: number[];
+        };
+        transition: {
+            type: 'spring';
+            duration: 500;
+            bounce: 0;
+            opacity: {
+                readonly duration: 300;
+                readonly ease: 'easeOut';
+            };
+        };
+    };
+    fadeInLeft: {
+        keyframes: {
+            opacity: number[];
+            x: number[];
+        };
+        transition: {
+            type: 'spring';
+            duration: 500;
+            bounce: 0;
+            opacity: {
+                readonly duration: 300;
+                readonly ease: 'easeOut';
+            };
+        };
+    };
+    fadeInRight: {
+        keyframes: {
+            opacity: number[];
+            x: number[];
+        };
+        transition: {
+            type: 'spring';
+            duration: 500;
+            bounce: 0;
+            opacity: {
+                readonly duration: 300;
+                readonly ease: 'easeOut';
+            };
+        };
+    };
+    zoomIn: {
+        keyframes: {
+            opacity: number[];
+            scale: number[];
+        };
+        transition: {
+            type: 'spring';
+            duration: 500;
+            bounce: 0;
+            opacity: {
+                readonly duration: 300;
+                readonly ease: 'easeOut';
+            };
+        };
+    };
+    popIn: {
+        keyframes: {
+            opacity: number[];
+            scale: number[];
+        };
+        transition: {
+            type: "spring";
+            duration: number;
+            bounce: number;
+            opacity: {
+                duration: number;
+            };
+        };
+    };
+    flipInX: {
+        keyframes: {
+            opacity: number[];
+            rotateX: number[];
+        };
+        transition: {
+            type: "spring";
+            duration: number;
+            bounce: number;
+            opacity: {
+                duration: number;
+            };
+        };
+    };
+    flipInY: {
+        keyframes: {
+            opacity: number[];
+            rotateY: number[];
+        };
+        transition: {
+            type: "spring";
+            duration: number;
+            bounce: number;
+            opacity: {
+                duration: number;
+            };
+        };
+    };
+    fadeOut: {
+        keyframes: {
+            opacity: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    fadeOutUp: {
+        keyframes: {
+            opacity: number;
+            y: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    fadeOutDown: {
+        keyframes: {
+            opacity: number;
+            y: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    fadeOutLeft: {
+        keyframes: {
+            opacity: number;
+            x: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    fadeOutRight: {
+        keyframes: {
+            opacity: number;
+            x: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    zoomOut: {
+        keyframes: {
+            opacity: number;
+            scale: number;
+        };
+        transition: {
+            readonly duration: 200;
+            readonly ease: 'easeIn';
+        };
+    };
+    popOut: {
+        keyframes: {
+            opacity: number;
+            scale: (number | null)[];
+        };
+        transition: {
+            duration: number;
+            ease: ["easeOut", "easeIn"];
+            times: number[];
+            opacity: {
+                duration: number;
+                ease: "easeIn";
+            };
+        };
+    };
+    pulse: {
+        keyframes: {
+            scale: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "easeInOut";
+            relative: true;
+        };
+    };
+    bounce: {
+        keyframes: {
+            y: number[];
+        };
+        transition: {
+            duration: number;
+            relative: true;
+            times: number[];
+            ease: ["easeOut", "easeIn", "easeOut", "easeIn"];
+        };
+    };
+    shake: {
+        keyframes: {
+            x: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "easeInOut";
+            relative: true;
+        };
+    };
+    wiggle: {
+        keyframes: {
+            rotate: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "easeInOut";
+            relative: true;
+        };
+    };
+    heartbeat: {
+        keyframes: {
+            scale: number[];
+        };
+        transition: {
+            duration: number;
+            relative: true;
+            times: number[];
+            ease: "easeInOut";
+        };
+    };
+    jelly: {
+        keyframes: {
+            scaleX: number[];
+            scaleY: number[];
+        };
+        transition: {
+            duration: number;
+            relative: true;
+            times: number[];
+            ease: "easeInOut";
+        };
+    };
+    flash: {
+        keyframes: {
+            opacity: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "easeInOut";
+            relative: true;
+        };
+    };
+    tada: {
+        keyframes: {
+            scale: number[];
+            rotate: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "easeInOut";
+            relative: true;
+        };
+    };
+    spin: {
+        keyframes: {
+            rotate: number[];
+        };
+        transition: {
+            duration: number;
+            ease: "linear";
+            relative: true;
+        };
+    };
+};
+//# sourceMappingURL=presets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/core/presets.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,OAAO;;QACR,SAAS;YAAI,OAAO;;QAAY,UAAU;+BAL3B,GAAG;2BAAQ,SAAS;;;;;YAO9B,OAAO;YAAU,CAAC;;;kBALb,QAAQ;sBAAY,GAAG;oBAAU,CAAC;;;;;;;;;YASvC,OAAO;YAAU,CAAC;;;kBATb,QAAQ;sBAAY,GAAG;oBAAU,CAAC;;;;;;;;;YAavC,OAAO;YAAU,CAAC;;;kBAbb,QAAQ;sBAAY,GAAG;oBAAU,CAAC;;;;;;;;;YAiBvC,OAAO;YAAU,CAAC;;;kBAjBb,QAAQ;sBAAY,GAAG;oBAAU,CAAC;;;;;;;;;YAqBvC,OAAO;YAAU,KAAK;;;kBArBjB,QAAQ;sBAAY,GAAG;oBAAU,CAAC;;;;;;;;;YAyBvC,OAAO;YAAU,KAAK;;;;;;;gBAKtB,QAAQ;;;;;;YAIR,OAAO;YAAU,OAAO;;;;;;;gBAKxB,QAAQ;;;;;;YAIR,OAAO;YAAU,OAAO;;;;;;;gBAKxB,QAAQ;;;;;QAIZ,SAAS;YAAI,OAAO;;QAAO,UAAU;+BArDtB,GAAG;2BAAQ,QAAQ;;;;QAsDhC,SAAS;YAAI,OAAO;YAAK,CAAC;;QAAS,UAAU;;;;;;QAC3C,SAAS;YAAI,OAAO;YAAK,CAAC;;QAAQ,UAAU;;;;;;QAC5C,SAAS;YAAI,OAAO;YAAK,CAAC;;QAAS,UAAU;;;;;;QAC5C,SAAS;YAAI,OAAO;YAAK,CAAC;;QAAQ,UAAU;;;;;;QACjD,SAAS;YAAI,OAAO;YAAK,KAAK;;QAAU,UAAU;;;;;;;YAE9C,OAAO;YAAK,KAAK;;;;;;;;;;;;;;YAUjB,KAAK;;;;;;;;;;YAIL,CAAC;;;;;;;;;;;YASD,CAAC;;;;;;;;;;YAID,MAAM;;;;;;;;;;YAIN,KAAK;;;;;;;;;;;YAUhB,MAAM;YACN,MAAM;;;;;;;;;;;YAUK,OAAO;;;;;;;;;;YAKlB,KAAK;YACL,MAAM;;;;;;;;;;YAKK,MAAM;;;;;;;;CAGkB,CAAA"}