@smoove/transitions 0.1.1

package/dist/timings/linear-timing.js

@@ -0,0 +1,20 @@
+import { interpolate } from "@smoove/core";
+/**
+ * A transition whose progress moves linearly (optionally eased) from 0 to 1
+ * over `durationInFrames`. Mirrors Remotion's `linearTiming`.
+ */
+export function linearTiming(options) {
+    const { durationInFrames, easing } = options;
+    if (!Number.isInteger(durationInFrames) || durationInFrames <= 0) {
+        throw new Error("linearTiming: durationInFrames must be a positive integer");
+    }
+    return {
+        getDurationInFrames: () => durationInFrames,
+        getProgress: (frame) => interpolate(frame, [0, durationInFrames], [0, 1], {
+            easing,
+            extrapolateLeft: "clamp",
+            extrapolateRight: "clamp",
+        }),
+    };
+}
+//# sourceMappingURL=linear-timing.js.map

package/dist/timings/linear-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-timing.js","sourceRoot":"","sources":["../../src/timings/linear-timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO;QACL,mBAAmB,EAAE,GAAG,EAAE,CAAC,gBAAgB;QAC3C,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CACrB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAChD,MAAM;YACN,eAAe,EAAE,OAAO;YACxB,gBAAgB,EAAE,OAAO;SAC1B,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/timings/spring/index.d.ts

@@ -0,0 +1,19 @@
+import { type SpringConfig } from "./spring-utils.js";
+export { measureSpring } from "./measure-spring.js";
+export { defaultSpringConfig, type SpringConfig } from "./spring-utils.js";
+/**
+ * Sample a physics spring at `frame`. Returns a value animating `from → to`.
+ * Ported from Remotion's `spring()`. When `durationInFrames` or `reverse` is
+ * set, time is remapped against the spring's natural settle time.
+ */
+export declare function spring({ frame, fps, config, from, to, durationInFrames, durationRestThreshold, reverse, }: {
+    frame: number;
+    fps: number;
+    config?: Partial<SpringConfig>;
+    from?: number;
+    to?: number;
+    durationInFrames?: number;
+    durationRestThreshold?: number;
+    reverse?: boolean;
+}): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/timings/spring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/timings/spring/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,GAAG,EACH,MAAW,EACX,IAAQ,EACR,EAAM,EACN,gBAAgB,EAChB,qBAAqB,EACrB,OAAe,GAChB,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAqBT"}

package/dist/timings/spring/index.js

@@ -0,0 +1,30 @@
+import { interpolate } from "@smoove/core";
+import { measureSpring } from "./measure-spring.js";
+import { springCalculation } from "./spring-utils.js";
+export { measureSpring } from "./measure-spring.js";
+export { defaultSpringConfig } from "./spring-utils.js";
+/**
+ * Sample a physics spring at `frame`. Returns a value animating `from → to`.
+ * Ported from Remotion's `spring()`. When `durationInFrames` or `reverse` is
+ * set, time is remapped against the spring's natural settle time.
+ */
+export function spring({ frame, fps, config = {}, from = 0, to = 1, durationInFrames, durationRestThreshold, reverse = false, }) {
+    const needsNatural = reverse || durationInFrames !== undefined;
+    const naturalDuration = needsNatural
+        ? measureSpring({ fps, config, threshold: durationRestThreshold })
+        : undefined;
+    let frameToUse = frame;
+    if (reverse) {
+        const duration = durationInFrames ?? naturalDuration;
+        frameToUse = duration - frame;
+    }
+    if (durationInFrames !== undefined && naturalDuration !== undefined && naturalDuration !== 0) {
+        const stretch = durationInFrames / naturalDuration;
+        frameToUse = frameToUse / stretch;
+    }
+    const { position } = springCalculation({ fps, frame: frameToUse, config });
+    if (from === 0 && to === 1)
+        return position;
+    return interpolate(position, [0, 1], [from, to]);
+}
+//# sourceMappingURL=index.js.map

package/dist/timings/spring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/timings/spring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAqB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,mBAAmB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,EACrB,KAAK,EACL,GAAG,EACH,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,CAAC,EACR,EAAE,GAAG,CAAC,EACN,gBAAgB,EAChB,qBAAqB,EACrB,OAAO,GAAG,KAAK,GAUhB;IACC,MAAM,YAAY,GAAG,OAAO,IAAI,gBAAgB,KAAK,SAAS,CAAC;IAC/D,MAAM,eAAe,GAAG,YAAY;QAClC,CAAC,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;QAClE,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,gBAAgB,IAAK,eAA0B,CAAC;QACjE,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChC,CAAC;IAED,IAAI,gBAAgB,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC7F,MAAM,OAAO,GAAG,gBAAgB,GAAG,eAAe,CAAC;QACnD,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IACpC,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3E,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/timings/spring/measure-spring.d.ts

@@ -0,0 +1,12 @@
+import { type SpringConfig } from "./spring-utils.js";
+/**
+ * The natural settle time of a spring, in frames: the first frame where the
+ * spring is within `threshold` of its target and stays there for 20 frames.
+ * Ported from Remotion's `measureSpring`.
+ */
+export declare function measureSpring({ fps, config, threshold, }: {
+    fps: number;
+    config?: Partial<SpringConfig>;
+    threshold?: number;
+}): number;
+//# sourceMappingURL=measure-spring.d.ts.map

package/dist/timings/spring/measure-spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-spring.d.ts","sourceRoot":"","sources":["../../../src/timings/spring/measure-spring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAEzE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,MAAW,EACX,SAAiB,GAClB,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CA6BT"}

package/dist/timings/spring/measure-spring.js

@@ -0,0 +1,37 @@
+import { springCalculation } from "./spring-utils.js";
+/**
+ * The natural settle time of a spring, in frames: the first frame where the
+ * spring is within `threshold` of its target and stays there for 20 frames.
+ * Ported from Remotion's `measureSpring`.
+ */
+export function measureSpring({ fps, config = {}, threshold = 0.005, }) {
+    if (threshold === 0)
+        return Number.POSITIVE_INFINITY;
+    if (threshold === 1)
+        return 0;
+    if (!Number.isFinite(threshold) || threshold < 0) {
+        throw new TypeError(`springTiming: durationRestThreshold must be >= 0 (got ${threshold})`);
+    }
+    const calc = (frame) => springCalculation({ fps, frame, config });
+    let frame = 0;
+    let finished = false;
+    let restFrame = 0;
+    const cap = 100_000; // safety bound
+    while (!finished && frame < cap) {
+        const { position } = calc(frame);
+        if (Math.abs(position - 1) < threshold) {
+            if (restFrame === 0)
+                restFrame = frame;
+            if (frame - restFrame >= 20) {
+                finished = true;
+                break;
+            }
+        }
+        else {
+            restFrame = 0;
+        }
+        frame++;
+    }
+    return restFrame;
+}
+//# sourceMappingURL=measure-spring.js.map

package/dist/timings/spring/measure-spring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-spring.js","sourceRoot":"","sources":["../../../src/timings/spring/measure-spring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,GAAG,EACH,MAAM,GAAG,EAAE,EACX,SAAS,GAAG,KAAK,GAKlB;IACC,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACrD,IAAI,SAAS,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,SAAS,CAAC,yDAAyD,SAAS,GAAG,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,eAAe;IAEpC,OAAO,CAAC,QAAQ,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC;YACvC,IAAI,SAAS,KAAK,CAAC;gBAAE,SAAS,GAAG,KAAK,CAAC;YACvC,IAAI,KAAK,GAAG,SAAS,IAAI,EAAE,EAAE,CAAC;gBAC5B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/timings/spring/spring-utils.d.ts

@@ -0,0 +1,20 @@
+export type SpringConfig = {
+    damping: number;
+    mass: number;
+    stiffness: number;
+    overshootClamping: boolean;
+};
+export declare const defaultSpringConfig: SpringConfig;
+type AdvanceResult = {
+    position: number;
+    velocity: number;
+};
+export declare function springCalculation({ fps, frame, config, from, to, }: {
+    fps: number;
+    frame: number;
+    config?: Partial<SpringConfig>;
+    from?: number;
+    to?: number;
+}): AdvanceResult;
+export {};
+//# sourceMappingURL=spring-utils.d.ts.map

package/dist/timings/spring/spring-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-utils.d.ts","sourceRoot":"","sources":["../../../src/timings/spring/spring-utils.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,YAKjC,CAAC;AAUF,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,KAAK,EACL,MAAW,EACX,IAAQ,EACR,EAAM,GACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,aAAa,CA4BhB"}

package/dist/timings/spring/spring-utils.js

@@ -0,0 +1,65 @@
+// TODO: promote to @smoove/core (a general-purpose spring() solver).
+// Self-contained physics spring, ported from Remotion's packages/core/src/spring.
+// Analytic solution to the damped harmonic oscillator — pure & deterministic.
+export const defaultSpringConfig = {
+    damping: 10,
+    mass: 1,
+    stiffness: 100,
+    overshootClamping: false,
+};
+export function springCalculation({ fps, frame, config = {}, from = 0, to = 1, }) {
+    const cfg = { ...defaultSpringConfig, ...config };
+    if (cfg.damping <= 0) {
+        throw new Error(`springTiming: config.damping must be > 0 (got ${cfg.damping})`);
+    }
+    if (cfg.mass <= 0) {
+        throw new Error(`springTiming: config.mass must be > 0 (got ${cfg.mass})`);
+    }
+    if (cfg.stiffness <= 0) {
+        throw new Error(`springTiming: config.stiffness must be > 0 (got ${cfg.stiffness})`);
+    }
+    let value = from;
+    let velocity = 0;
+    const frameClamped = Math.max(0, frame);
+    const wholeFrames = Math.floor(frameClamped);
+    for (let f = 0; f <= wholeFrames; f++) {
+        const isLast = f === wholeFrames;
+        const proportion = isLast ? frameClamped - wholeFrames : 1;
+        if (f === 0 && proportion === 0)
+            continue;
+        const timestamp = (proportion / fps) * 1000;
+        const result = advance({ fromValue: value, toValue: to, velocity, config: cfg, timestamp });
+        value = result.position;
+        velocity = result.velocity;
+    }
+    return { position: value, velocity };
+}
+function advance({ fromValue, toValue, velocity, config, timestamp }) {
+    const { damping: c, mass: m, stiffness: k } = config;
+    const t = Math.min(timestamp, 64) / 1000;
+    const v0 = -velocity;
+    const x0 = toValue - fromValue;
+    const zeta = c / (2 * Math.sqrt(k * m)); // damping ratio
+    const omega0 = Math.sqrt(k / m); // undamped angular frequency
+    const omega1 = omega0 * Math.sqrt(1.0 - zeta * zeta); // damped angular frequency
+    if (zeta < 1) {
+        // Under-damped.
+        const envelope = Math.exp(-zeta * omega0 * t);
+        const position = toValue -
+            envelope *
+                (((v0 + zeta * omega0 * x0) / omega1) * Math.sin(omega1 * t) + x0 * Math.cos(omega1 * t));
+        const velocityResult = zeta *
+            omega0 *
+            envelope *
+            ((Math.sin(omega1 * t) * (v0 + zeta * omega0 * x0)) / omega1 + x0 * Math.cos(omega1 * t)) -
+            envelope *
+                (Math.cos(omega1 * t) * (v0 + zeta * omega0 * x0) - omega1 * x0 * Math.sin(omega1 * t));
+        return { position, velocity: velocityResult };
+    }
+    // Critically damped.
+    const envelope = Math.exp(-omega0 * t);
+    const position = toValue - envelope * (x0 + (v0 + omega0 * x0) * t);
+    const velocityResult = envelope * (v0 * (t * omega0 - 1) + t * x0 * omega0 * omega0);
+    return { position, velocity: velocityResult };
+}
+//# sourceMappingURL=spring-utils.js.map

package/dist/timings/spring/spring-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-utils.js","sourceRoot":"","sources":["../../../src/timings/spring/spring-utils.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,kFAAkF;AAClF,8EAA8E;AAS9E,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,CAAC;IACP,SAAS,EAAE,GAAG;IACd,iBAAiB,EAAE,KAAK;CACzB,CAAC;AAYF,MAAM,UAAU,iBAAiB,CAAC,EAChC,GAAG,EACH,KAAK,EACL,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,CAAC,EACR,EAAE,GAAG,CAAC,GAOP;IACC,MAAM,GAAG,GAAiB,EAAE,GAAG,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAAC;IAChE,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8CAA8C,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mDAAmD,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,KAAK,WAAW,CAAC;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC;YAAE,SAAS;QAC1C,MAAM,SAAS,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5F,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC;QACxB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAe;IAC/E,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IAEzC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;IACrB,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC;IAE/B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,6BAA6B;IAC9D,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,2BAA2B;IAEjF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,gBAAgB;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,QAAQ,GACZ,OAAO;YACP,QAAQ;gBACN,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,cAAc,GAClB,IAAI;YACF,MAAM;YACN,QAAQ;YACR,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3F,QAAQ;gBACN,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAChD,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACrF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AAChD,CAAC"}

package/dist/timings/spring-timing.d.ts

@@ -0,0 +1,16 @@
+import type { Timing } from "../types.js";
+import { type SpringConfig } from "./spring/index.js";
+export type SpringTimingOptions = {
+    config?: Partial<SpringConfig>;
+    /** Forced length in frames. When omitted, the spring's natural settle time is used. */
+    durationInFrames?: number;
+    durationRestThreshold?: number;
+    reverse?: boolean;
+};
+/**
+ * A transition whose progress follows a physics spring. Mirrors Remotion's
+ * `springTiming`. The spring needs an `fps` to integrate — it is taken from the
+ * `Composition` via `getProgress`/`getDurationInFrames`.
+ */
+export declare function springTiming(options?: SpringTimingOptions): Timing;
+//# sourceMappingURL=spring-timing.d.ts.map

package/dist/timings/spring-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-timing.d.ts","sourceRoot":"","sources":["../../src/timings/spring-timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAiB,KAAK,YAAY,EAAU,MAAM,mBAAmB,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAwBtE"}

package/dist/timings/spring-timing.js

@@ -0,0 +1,28 @@
+import { measureSpring, spring } from "./spring/index.js";
+/**
+ * A transition whose progress follows a physics spring. Mirrors Remotion's
+ * `springTiming`. The spring needs an `fps` to integrate — it is taken from the
+ * `Composition` via `getProgress`/`getDurationInFrames`.
+ */
+export function springTiming(options = {}) {
+    const { config, durationInFrames, durationRestThreshold, reverse = false } = options;
+    if (durationInFrames !== undefined &&
+        (!Number.isInteger(durationInFrames) || durationInFrames <= 0)) {
+        throw new Error("springTiming: durationInFrames must be a positive integer");
+    }
+    return {
+        getDurationInFrames: (fps) => durationInFrames ??
+            Math.ceil(measureSpring({ fps, config, threshold: durationRestThreshold })),
+        getProgress: (frame, fps) => spring({
+            fps,
+            frame,
+            config,
+            from: reverse ? 1 : 0,
+            to: reverse ? 0 : 1,
+            durationInFrames,
+            durationRestThreshold,
+            reverse,
+        }),
+    };
+}
+//# sourceMappingURL=spring-timing.js.map

package/dist/timings/spring-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-timing.js","sourceRoot":"","sources":["../../src/timings/spring-timing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAqB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAU7E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrF,IACE,gBAAgB,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,IAAI,CAAC,CAAC,EAC9D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO;QACL,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC3B,gBAAgB;YAChB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC7E,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAC1B,MAAM,CAAC;YACL,GAAG;YACH,KAAK;YACL,MAAM;YACN,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,gBAAgB;YAChB,qBAAqB;YACrB,OAAO;SACR,CAAC;KACL,CAAC;AACJ,CAAC"}

package/dist/transition-series.d.ts

@@ -0,0 +1,52 @@
+import { type Composition, Sequence, type SequenceProvider } from "@smoove/core";
+import type { Presentation, Timing } from "./types.js";
+export type TransitionSeriesOptions = {
+    /**
+     * The Composition the series will be added to. Needed up front because spring
+     * timings resolve their length from `fps`, and presentations are sized from
+     * the stage `width`/`height`. (Diverges from Remotion, which reads these from
+     * React context.)
+     */
+    composition: Composition;
+    /** Frame the series starts at. Default `0`. */
+    from?: number;
+};
+export type TransitionSeriesSceneOptions = {
+    durationInFrames: number;
+};
+export type TransitionSeriesTransitionOptions = {
+    presentation: Presentation;
+    timing: Timing;
+};
+/**
+ * Sequential sequencer where adjacent scenes overlap by a transition's
+ * `durationInFrames`. Built on the same offset engine as `Series` — a
+ * transition is just a sequential step with a negative (overlap) delta. Mirrors
+ * Remotion's `<TransitionSeries>`.
+ *
+ * ```ts
+ * const series = new TransitionSeries({ composition });
+ * series.scene({ durationInFrames: 60 }, (seq) => seq.add(sceneA));
+ * series.transition({ presentation: fade(), timing: linearTiming({ durationInFrames: 15 }) });
+ * series.scene({ durationInFrames: 90 }, (seq) => seq.add(sceneB));
+ * composition.add(series);
+ * ```
+ */
+export declare class TransitionSeries implements SequenceProvider {
+    readonly from: number;
+    private readonly composition;
+    private readonly _items;
+    constructor(opts: TransitionSeriesOptions);
+    scene(opts: TransitionSeriesSceneOptions, build: (seq: Sequence) => void): this;
+    transition(opts: TransitionSeriesTransitionOptions): this;
+    /** Σ scene durations − Σ transition durations. */
+    get durationInFrames(): number;
+    /**
+     * Build every scene `Sequence` (with overlaps resolved) plus a GL overlay
+     * `Sequence` for each Tier B transition. Add them all to the composition.
+     */
+    sequences(): Sequence[];
+    /** Swap a GL presentation for `fade()` when no WebGL context is available. */
+    private _resolve;
+}
+//# sourceMappingURL=transition-series.d.ts.map

package/dist/transition-series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-series.d.ts","sourceRoot":"","sources":["../src/transition-series.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAGhB,QAAQ,EACR,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;OAKG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,iCAAiC,GAAG;IAC9C,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAyBF;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,IAAI,EAAE,uBAAuB;IASzC,KAAK,CAAC,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAQ/E,UAAU,CAAC,IAAI,EAAE,iCAAiC,GAAG,IAAI;IAgBzD,kDAAkD;IAClD,IAAI,gBAAgB,IAAI,MAAM,CAQ7B;IAED;;;OAGG;IACH,SAAS,IAAI,QAAQ,EAAE;IAgKvB,8EAA8E;IAC9E,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/transition-series.js

@@ -0,0 +1,217 @@
+import { computeOffsets, Sequence, } from "@smoove/core";
+import Konva from "konva";
+import { getCompositor } from "./gl/compositor.js";
+import { fade } from "./presentations/fade.js";
+let warnedNoWebGl = false;
+/** Reset a layer's transform to identity (used between/around transitions). */
+function resetLayer(layer) {
+    layer.opacity(1);
+    layer.position({ x: 0, y: 0 });
+    layer.scale({ x: 1, y: 1 });
+    layer.rotation(0);
+    if (layer.getAttr("clipFunc"))
+        layer.setAttr("clipFunc", undefined);
+}
+/**
+ * Sequential sequencer where adjacent scenes overlap by a transition's
+ * `durationInFrames`. Built on the same offset engine as `Series` — a
+ * transition is just a sequential step with a negative (overlap) delta. Mirrors
+ * Remotion's `<TransitionSeries>`.
+ *
+ * ```ts
+ * const series = new TransitionSeries({ composition });
+ * series.scene({ durationInFrames: 60 }, (seq) => seq.add(sceneA));
+ * series.transition({ presentation: fade(), timing: linearTiming({ durationInFrames: 15 }) });
+ * series.scene({ durationInFrames: 90 }, (seq) => seq.add(sceneB));
+ * composition.add(series);
+ * ```
+ */
+export class TransitionSeries {
+    from;
+    composition;
+    _items = [];
+    constructor(opts) {
+        const from = opts.from ?? 0;
+        if (!Number.isInteger(from) || from < 0) {
+            throw new Error("TransitionSeries: from must be a non-negative integer");
+        }
+        this.composition = opts.composition;
+        this.from = from;
+    }
+    scene(opts, build) {
+        if (!Number.isInteger(opts.durationInFrames) || opts.durationInFrames <= 0) {
+            throw new Error("TransitionSeries: scene durationInFrames must be a positive integer");
+        }
+        this._items.push({ kind: "scene", durationInFrames: opts.durationInFrames, build });
+        return this;
+    }
+    transition(opts) {
+        const last = this._items[this._items.length - 1];
+        if (!last) {
+            throw new Error("TransitionSeries: a transition must not be the first item — add a scene first");
+        }
+        if (last.kind === "transition") {
+            throw new Error("TransitionSeries: two transitions must not be adjacent — add a scene between them");
+        }
+        this._items.push({ kind: "transition", presentation: opts.presentation, timing: opts.timing });
+        return this;
+    }
+    /** Σ scene durations − Σ transition durations. */
+    get durationInFrames() {
+        const fps = this.composition.fps;
+        let total = 0;
+        for (const item of this._items) {
+            if (item.kind === "scene")
+                total += item.durationInFrames;
+            else
+                total -= item.timing.getDurationInFrames(fps);
+        }
+        return total;
+    }
+    /**
+     * Build every scene `Sequence` (with overlaps resolved) plus a GL overlay
+     * `Sequence` for each Tier B transition. Add them all to the composition.
+     */
+    sequences() {
+        if (this._items.length === 0) {
+            throw new Error("TransitionSeries: add at least one scene before reading sequences");
+        }
+        if (this._items[this._items.length - 1]?.kind === "transition") {
+            throw new Error("TransitionSeries: a transition must not be the last item — end with a scene");
+        }
+        const fps = this.composition.fps;
+        const dims = {
+            width: this.composition.width(),
+            height: this.composition.height(),
+        };
+        const compositor = getCompositor();
+        const records = [];
+        for (let i = 0; i < this._items.length; i++) {
+            const item = this._items[i];
+            if (item?.kind !== "scene")
+                continue;
+            const prev = this._items[i - 1];
+            const next = this._items[i + 1];
+            const record = {
+                durationInFrames: item.durationInFrames,
+                build: item.build,
+            };
+            if (prev?.kind === "transition") {
+                const duration = prev.timing.getDurationInFrames(fps);
+                record.incoming = { presentation: prev.presentation, timing: prev.timing, duration };
+            }
+            if (next?.kind === "transition") {
+                const duration = next.timing.getDurationInFrames(fps);
+                record.outgoing = { presentation: next.presentation, timing: next.timing, duration };
+            }
+            records.push(record);
+        }
+        // Validate transition duration ≤ each neighbour scene's duration.
+        for (const record of records) {
+            if (record.incoming && record.incoming.duration > record.durationInFrames) {
+                throw new Error(`TransitionSeries: a transition (${record.incoming.duration} frames) must not be longer than the previous scene (${record.durationInFrames} frames)`);
+            }
+            if (record.outgoing && record.outgoing.duration > record.durationInFrames) {
+                throw new Error(`TransitionSeries: a transition (${record.outgoing.duration} frames) must not be longer than the next scene (${record.durationInFrames} frames)`);
+            }
+        }
+        // Resolve each scene's `from`: an incoming transition overlaps by its duration.
+        const offsetScenes = records.map((r) => ({
+            durationInFrames: r.durationInFrames,
+            offset: r.incoming ? -r.incoming.duration : 0,
+        }));
+        const { placed } = computeOffsets(offsetScenes, this.from);
+        const sceneSeqs = [];
+        const overlaySeqs = [];
+        records.forEach((record, i) => {
+            const place = placed[i];
+            if (!place)
+                return;
+            const seq = new Sequence({ from: place.from, durationInFrames: place.durationInFrames });
+            record.build(seq);
+            sceneSeqs.push(seq);
+            // Resolve presentations, falling back to fade when GL is unavailable.
+            const incoming = record.incoming
+                ? {
+                    ...record.incoming,
+                    presentation: this._resolve(record.incoming.presentation, compositor),
+                }
+                : undefined;
+            const outgoing = record.outgoing
+                ? {
+                    ...record.outgoing,
+                    presentation: this._resolve(record.outgoing.presentation, compositor),
+                }
+                : undefined;
+            const dur = place.durationInFrames;
+            if (incoming || outgoing) {
+                seq.register((local) => {
+                    if (incoming && local < incoming.duration && !incoming.presentation.gl) {
+                        const p = incoming.timing.getProgress(local, fps);
+                        incoming.presentation.enter?.(seq, p, dims);
+                        return;
+                    }
+                    if (outgoing && local >= dur - outgoing.duration && !outgoing.presentation.gl) {
+                        const p = outgoing.timing.getProgress(local - (dur - outgoing.duration), fps);
+                        outgoing.presentation.exit?.(seq, p, dims);
+                        return;
+                    }
+                    resetLayer(seq);
+                });
+            }
+            // Tier B: an overlay sequence drives the GL compositor over the overlap.
+            if (incoming?.presentation.gl && compositor) {
+                const outgoingSeq = sceneSeqs[i - 1];
+                const gl = incoming.presentation.gl;
+                const timing = incoming.timing;
+                const d = incoming.duration;
+                if (outgoingSeq) {
+                    const overlay = new Sequence({ from: place.from, durationInFrames: d });
+                    const image = new Konva.Image({
+                        x: 0,
+                        y: 0,
+                        width: dims.width,
+                        height: dims.height,
+                        image: undefined,
+                        listening: false,
+                    });
+                    overlay.add(image);
+                    overlay.register((local) => {
+                        const p = timing.getProgress(local, fps);
+                        const incomingCanvas = seq.toCanvas({
+                            x: 0,
+                            y: 0,
+                            width: dims.width,
+                            height: dims.height,
+                            pixelRatio: 1,
+                        });
+                        const outgoingCanvas = outgoingSeq.toCanvas({
+                            x: 0,
+                            y: 0,
+                            width: dims.width,
+                            height: dims.height,
+                            pixelRatio: 1,
+                        });
+                        const out = compositor.render(gl.fragment, incomingCanvas, outgoingCanvas, p, gl.uniforms?.(p, dims) ?? {}, dims.width, dims.height);
+                        image.image(out);
+                    });
+                    overlaySeqs.push(overlay);
+                }
+            }
+        });
+        // Overlays added last so they z-order above the scene layers they blend.
+        return [...sceneSeqs, ...overlaySeqs];
+    }
+    /** Swap a GL presentation for `fade()` when no WebGL context is available. */
+    _resolve(presentation, compositor) {
+        if (presentation.gl && !compositor) {
+            if (!warnedNoWebGl) {
+                warnedNoWebGl = true;
+                console.warn("@smoove/transitions: WebGL2 unavailable — shader transitions fall back to fade().");
+            }
+            return fade();
+        }
+        return presentation;
+    }
+}
+//# sourceMappingURL=transition-series.js.map

package/dist/transition-series.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+import type Konva from "konva";
+/** Scene dimensions handed to a presentation — the Composition stage size. */
+export type PresentationDims = {
+    width: number;
+    height: number;
+};
+/**
+ * Extra (per-effect) uniforms a GL presentation uploads each frame, keyed by
+ * GLSL uniform name. A `number` → `uniform1f`; a `number[]` of length 2/3/4 →
+ * `uniform2f`/`uniform3f`/`uniform4f`.
+ */
+export type GlUniforms = Record<string, number | number[]>;
+/**
+ * How a transition renders. A geometric (Tier A) presentation implements
+ * `enter`/`exit`, mutating the incoming/outgoing `Konva.Layer` directly. A
+ * shader (Tier B) presentation instead provides `gl` — a fragment shader the
+ * shared WebGL compositor runs over both captured layers.
+ */
+export type Presentation = {
+    /** Apply the incoming layer's state at `progress` (0 → fully out, 1 → in). */
+    enter?(layer: Konva.Layer, progress: number, dims: PresentationDims): void;
+    /** Apply the outgoing layer's state at `progress` (0 → fully in, 1 → out). */
+    exit?(layer: Konva.Layer, progress: number, dims: PresentationDims): void;
+    /** GLSL fragment shader + uniform wiring for a Tier B (shader) transition. */
+    gl?: {
+        fragment: string;
+        /** Per-effect uniforms (beyond `u_time`/`u_prev`/`u_next`) for this frame. */
+        uniforms?(progress: number, dims: PresentationDims): GlUniforms;
+    };
+};
+/**
+ * Maps a transition's local frame onto a `[0, 1]` progress and reports its
+ * length in frames. Pure/deterministic so transitions render identically
+ * offline.
+ */
+export type Timing = {
+    getDurationInFrames(fps: number): number;
+    getProgress(localFrame: number, fps: number): number;
+};
+//# 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,KAAK,MAAM,OAAO,CAAC;AAE/B,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3E,8EAA8E;IAC9E,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1E,8EAA8E;IAC9E,EAAE,CAAC,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,8EAA8E;QAC9E,QAAQ,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAAC;KACjE,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtD,CAAC"}

package/dist/types.js

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