@asciiz/atoolkit 0.1.0

package/dist/atempo/curves/overshoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overshoot.js","sourceRoot":"","sources":["../../../atempo/curves/overshoot.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,IAAI,EAAS,EAAE;IAC9C,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,CAAS,EAAU,EAAE;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/atempo/curves/quad.d.ts

@@ -0,0 +1,14 @@
+import { type Curve } from "../curve.js";
+/**
+ * Quadratic ease-in curve.
+ */
+export declare const quadIn: Curve;
+/**
+ * Quadratic ease-out curve.
+ */
+export declare const quadOut: Curve;
+/**
+ * Quadratic ease-in-out curve.
+ */
+export declare const quadInOut: Curve;
+//# sourceMappingURL=quad.d.ts.map

package/dist/atempo/curves/quad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quad.d.ts","sourceRoot":"","sources":["../../../atempo/curves/quad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,KAGpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAGrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,KAGvB,CAAC"}

package/dist/atempo/curves/quad.js

@@ -0,0 +1,22 @@
+/**
+ * Quadratic ease-in curve.
+ */
+export const quadIn = (t) => {
+    const c = Math.max(0, Math.min(1, t));
+    return c * c;
+};
+/**
+ * Quadratic ease-out curve.
+ */
+export const quadOut = (t) => {
+    const c = Math.max(0, Math.min(1, t));
+    return c * (2 - c);
+};
+/**
+ * Quadratic ease-in-out curve.
+ */
+export const quadInOut = (t) => {
+    const c = Math.max(0, Math.min(1, t));
+    return c < 0.5 ? 2 * c * c : -1 + (4 - 2 * c) * c;
+};
+//# sourceMappingURL=quad.js.map

package/dist/atempo/curves/quad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quad.js","sourceRoot":"","sources":["../../../atempo/curves/quad.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,CAAS,EAAU,EAAE;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAU,CAAC,CAAS,EAAU,EAAE;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAU,CAAC,CAAS,EAAU,EAAE;IAClD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC,CAAC"}

package/dist/atempo/curves/step.d.ts

@@ -0,0 +1,6 @@
+import { type Curve } from "../curve.js";
+/**
+ * Creates staircase quantization curve mapping [0, 1] into discrete steps.
+ */
+export declare const step: (steps?: number) => Curve;
+//# sourceMappingURL=step.d.ts.map

package/dist/atempo/curves/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../atempo/curves/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,IAAI,GAAI,cAAS,KAAG,KAMhC,CAAC"}

package/dist/atempo/curves/step.js

@@ -0,0 +1,11 @@
+/**
+ * Creates staircase quantization curve mapping [0, 1] into discrete steps.
+ */
+export const step = (steps = 4) => {
+    const s = Math.max(1, Math.floor(steps));
+    return (t) => {
+        const clamped = Math.max(0, Math.min(1, t));
+        return Math.floor(clamped * s) / s;
+    };
+};
+//# sourceMappingURL=step.js.map

package/dist/atempo/curves/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../../atempo/curves/step.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,EAAS,EAAE;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,CAAS,EAAU,EAAE;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/atempo/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Atempo: Temporal orchestration and cadence evaluation primitives.
+ */
+export { Cadence, FixedCadence } from "./cadence.js";
+export { Phase, Metronome, type MetronomeState } from "./phase.js";
+export { Spring } from "./spring.js";
+export { type Curve } from "./curve.js";
+export { Track, Extrapolation, type Keyframe } from "./track.js";
+export { Clip, type ClipMarker } from "./clip.js";
+export * as curves from "./curves/index.js";
+export * as tracks from "./tracks/index.js";
+export { FloatTrack } from "./tracks/float.js";
+export { VecTrack } from "./tracks/vec.js";
+export { QuatTrack } from "./tracks/quat.js";
+export { ColorTrack, ColorSpace } from "./tracks/color.js";
+export { linear, step, quadIn, quadOut, quadInOut, cubicIn, cubicOut, cubicInOut, expoIn, expoOut, expoInOut, overshoot, bounce, elastic, holdSnap, bezier, } from "./curves/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../atempo/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EACH,MAAM,EACN,IAAI,EACJ,MAAM,EACN,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,GACT,MAAM,mBAAmB,CAAC"}

package/dist/atempo/index.js

@@ -0,0 +1,18 @@
+/**
+ * Atempo: Temporal orchestration and cadence evaluation primitives.
+ */
+export { Cadence, FixedCadence } from "./cadence.js";
+export { Phase, Metronome } from "./phase.js";
+export { Spring } from "./spring.js";
+export { Track, Extrapolation } from "./track.js";
+export { Clip } from "./clip.js";
+export * as curves from "./curves/index.js";
+export * as tracks from "./tracks/index.js";
+// Direct track presets
+export { FloatTrack } from "./tracks/float.js";
+export { VecTrack } from "./tracks/vec.js";
+export { QuatTrack } from "./tracks/quat.js";
+export { ColorTrack, ColorSpace } from "./tracks/color.js";
+// Direct curve presets
+export { linear, step, quadIn, quadOut, quadInOut, cubicIn, cubicOut, cubicInOut, expoIn, expoOut, expoInOut, overshoot, bounce, elastic, holdSnap, bezier, } from "./curves/index.js";
+//# sourceMappingURL=index.js.map

package/dist/atempo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../atempo/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAuB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,IAAI,EAAmB,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uBAAuB;AACvB,OAAO,EACH,MAAM,EACN,IAAI,EACJ,MAAM,EACN,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,QAAQ,EACR,MAAM,GACT,MAAM,mBAAmB,CAAC"}

package/dist/atempo/phase.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Periodic phase coordinates, waveform generators, and cyclic metronomic tracking.
+ */
+export declare class Phase {
+    private static readonly TWO_PI;
+    /**
+     * Converts time and frequency into normalized cyclic phase in [0.0, 1.0).
+     */
+    static cycle(timeSec: number, frequencyHz: number, phaseOffset?: number): number;
+    /**
+     * Normalized sine wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static sine(phase: number): number;
+    /**
+     * Normalized cosine wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static cosine(phase: number): number;
+    /**
+     * Symmetric triangle wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static triangle(phase: number): number;
+    /**
+     * Linear ramp sawtooth wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static saw(phase: number): number;
+    /**
+     * Square pulse wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static square(phase: number, dutyCycle?: number): number;
+    /**
+     * Exponential decay impulse starting at 1.0 at phase 0.0 and decaying toward 0.0.
+     */
+    static impulse(phase: number, sharpness?: number): number;
+    /**
+     * Wraps scalar value into [min, max) range.
+     */
+    static wrap(value: number, min: number, max: number): number;
+}
+export interface MetronomeState {
+    cycle: number;
+    phase: number;
+    bar: number;
+    justTriggered: boolean;
+    impulse: number;
+}
+/**
+ * Periodic beat and bar tracker.
+ * Evaluates integer cycles, phase progress in [0, 1), and boundary triggers.
+ */
+export declare class Metronome {
+    private _frequency;
+    private _lastCycle;
+    private _justTriggered;
+    constructor(frequencyOrBpm?: number, isBpm?: boolean);
+    setBpm(bpm: number): this;
+    setFrequency(hz: number): this;
+    get frequency(): number;
+    get bpm(): number;
+    get period(): number;
+    /**
+     * Evaluates metronome state for timestamp and updates cycle boundary trigger.
+     */
+    sample(timeSec: number): MetronomeState;
+    get justTriggered(): boolean;
+}
+//# sourceMappingURL=phase.d.ts.map

package/dist/atempo/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../atempo/phase.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,KAAK;IACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAE/C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,SAAM,GAAG,MAAM;IAM7E;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKtC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKjC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM;IAKrD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM;IAKtD;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAK/D;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,SAAM,EAAE,KAAK,UAAO;IAQ9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;IAoBvC,IAAI,aAAa,IAAI,OAAO,CAE3B;CACJ"}

package/dist/atempo/phase.js

@@ -0,0 +1,121 @@
+/**
+ * Periodic phase coordinates, waveform generators, and cyclic metronomic tracking.
+ */
+export class Phase {
+    static TWO_PI = Math.PI * 2.0;
+    /**
+     * Converts time and frequency into normalized cyclic phase in [0.0, 1.0).
+     */
+    static cycle(timeSec, frequencyHz, phaseOffset = 0.0) {
+        if (frequencyHz <= 0)
+            return 0.0;
+        const raw = timeSec * frequencyHz + phaseOffset;
+        return raw - Math.floor(raw);
+    }
+    /**
+     * Normalized sine wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static sine(phase) {
+        return Math.sin(phase * Phase.TWO_PI);
+    }
+    /**
+     * Normalized cosine wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static cosine(phase) {
+        return Math.cos(phase * Phase.TWO_PI);
+    }
+    /**
+     * Symmetric triangle wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static triangle(phase) {
+        const p = phase - Math.floor(phase);
+        return 1.0 - 4.0 * Math.abs(p - 0.5);
+    }
+    /**
+     * Linear ramp sawtooth wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static saw(phase) {
+        const p = phase - Math.floor(phase);
+        return 2.0 * p - 1.0;
+    }
+    /**
+     * Square pulse wave over phase [0.0, 1.0) mapped to [-1.0, 1.0].
+     */
+    static square(phase, dutyCycle = 0.5) {
+        const p = phase - Math.floor(phase);
+        return p < dutyCycle ? 1.0 : -1.0;
+    }
+    /**
+     * Exponential decay impulse starting at 1.0 at phase 0.0 and decaying toward 0.0.
+     */
+    static impulse(phase, sharpness = 4.0) {
+        const p = phase - Math.floor(phase);
+        return Math.exp(-sharpness * p);
+    }
+    /**
+     * Wraps scalar value into [min, max) range.
+     */
+    static wrap(value, min, max) {
+        const range = max - min;
+        if (range <= 0)
+            return min;
+        return min + ((((value - min) % range) + range) % range);
+    }
+}
+/**
+ * Periodic beat and bar tracker.
+ * Evaluates integer cycles, phase progress in [0, 1), and boundary triggers.
+ */
+export class Metronome {
+    _frequency = 1.0;
+    _lastCycle = 0;
+    _justTriggered = false;
+    constructor(frequencyOrBpm = 120, isBpm = true) {
+        if (isBpm) {
+            this.setBpm(frequencyOrBpm);
+        }
+        else {
+            this.setFrequency(frequencyOrBpm);
+        }
+    }
+    setBpm(bpm) {
+        this._frequency = Math.max(0.0001, bpm / 60.0);
+        return this;
+    }
+    setFrequency(hz) {
+        this._frequency = Math.max(0.0001, hz);
+        return this;
+    }
+    get frequency() {
+        return this._frequency;
+    }
+    get bpm() {
+        return this._frequency * 60.0;
+    }
+    get period() {
+        return 1.0 / this._frequency;
+    }
+    /**
+     * Evaluates metronome state for timestamp and updates cycle boundary trigger.
+     */
+    sample(timeSec) {
+        const totalCycles = timeSec * this._frequency;
+        const currentCycle = Math.floor(totalCycles);
+        const phase = totalCycles - currentCycle;
+        const bar = Math.floor(currentCycle / 4);
+        this._justTriggered = currentCycle !== this._lastCycle;
+        this._lastCycle = currentCycle;
+        const impulse = Math.pow(Math.max(0.0, 1.0 - phase * 3.5), 2.2);
+        return {
+            cycle: currentCycle,
+            phase,
+            bar,
+            justTriggered: this._justTriggered,
+            impulse,
+        };
+    }
+    get justTriggered() {
+        return this._justTriggered;
+    }
+}
+//# sourceMappingURL=phase.js.map

package/dist/atempo/phase.js.map

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

package/dist/atempo/spring.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Analytical solution for damped harmonic oscillator dynamics across under-damped, critically damped, and over-damped regimes.
+ */
+export declare class Spring {
+    frequency: number;
+    damping: number;
+    constructor(frequency?: number, damping?: number);
+    /**
+     * Updates scalar spring position and velocity in-place.
+     * posVel[0] = position, posVel[1] = velocity.
+     */
+    update(posVel: Float32Array | number[], target: number, deltaSec: number): void;
+    /**
+     * Updates N-dimensional vector in-place.
+     * posArray[posOffset .. posOffset + dim - 1] = positions
+     * velArray[velOffset .. velOffset + dim - 1] = velocities
+     */
+    updateVector(posArray: Float32Array | number[], velArray: Float32Array | number[], targetArray: ArrayLike<number>, dimension: number, deltaSec: number, posOffset?: number, velOffset?: number, targetOffset?: number): void;
+}
+//# sourceMappingURL=spring.d.ts.map

package/dist/atempo/spring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.d.ts","sourceRoot":"","sources":["../../atempo/spring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,MAAM;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;gBAEJ,SAAS,SAAM,EAAE,OAAO,SAAM;IAK1C;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA8C/E;;;;OAIG;IACH,YAAY,CACR,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,EACjC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,EACjC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAI,EACb,SAAS,SAAI,EACb,YAAY,SAAI,GACjB,IAAI;CAUV"}

package/dist/atempo/spring.js

@@ -0,0 +1,71 @@
+/**
+ * Analytical solution for damped harmonic oscillator dynamics across under-damped, critically damped, and over-damped regimes.
+ */
+export class Spring {
+    frequency; // Natural frequency in Hz
+    damping; // Damping ratio (zeta): 1.0 = critical, <1.0 = under-damped, >1.0 = over-damped
+    constructor(frequency = 2.0, damping = 0.7) {
+        this.frequency = Math.max(0.001, frequency);
+        this.damping = Math.max(0.0, damping);
+    }
+    /**
+     * Updates scalar spring position and velocity in-place.
+     * posVel[0] = position, posVel[1] = velocity.
+     */
+    update(posVel, target, deltaSec) {
+        const dt = Math.max(0, deltaSec);
+        if (dt === 0)
+            return;
+        const f = this.frequency;
+        const z = this.damping;
+        const w = f * (2.0 * Math.PI);
+        const x = posVel[0] - target;
+        const v = posVel[1];
+        if (z < 0.9999) {
+            // Under-damped oscillation
+            const wd = w * Math.sqrt(1.0 - z * z);
+            const exp = Math.exp(-z * w * dt);
+            const c = Math.cos(wd * dt);
+            const s = Math.sin(wd * dt);
+            const newX = exp * (x * c + ((v + z * w * x) / wd) * s);
+            const newV = exp * (v * c - ((v * z * w + w * w * x) / wd) * s);
+            posVel[0] = newX + target;
+            posVel[1] = newV;
+        }
+        else if (z > 1.0001) {
+            // Over-damped decay
+            const s = Math.sqrt(z * z - 1.0);
+            const w1 = w * (z - s);
+            const w2 = w * (z + s);
+            const exp1 = Math.exp(-w1 * dt);
+            const exp2 = Math.exp(-w2 * dt);
+            const c1 = (v + w2 * x) / (2.0 * w * s);
+            const c2 = (-v - w1 * x) / (2.0 * w * s);
+            posVel[0] = c1 * exp1 + c2 * exp2 + target;
+            posVel[1] = -c1 * w1 * exp1 - c2 * w2 * exp2;
+        }
+        else {
+            // Critically damped
+            const exp = Math.exp(-w * dt);
+            const c2 = v + w * x;
+            posVel[0] = (x + c2 * dt) * exp + target;
+            posVel[1] = (v - c2 * w * dt) * exp;
+        }
+    }
+    /**
+     * Updates N-dimensional vector in-place.
+     * posArray[posOffset .. posOffset + dim - 1] = positions
+     * velArray[velOffset .. velOffset + dim - 1] = velocities
+     */
+    updateVector(posArray, velArray, targetArray, dimension, deltaSec, posOffset = 0, velOffset = 0, targetOffset = 0) {
+        const temp = [0, 0];
+        for (let d = 0; d < dimension; d++) {
+            temp[0] = posArray[posOffset + d];
+            temp[1] = velArray[velOffset + d];
+            this.update(temp, targetArray[targetOffset + d], deltaSec);
+            posArray[posOffset + d] = temp[0];
+            velArray[velOffset + d] = temp[1];
+        }
+    }
+}
+//# sourceMappingURL=spring.js.map

package/dist/atempo/spring.js.map

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

package/dist/atempo/track.d.ts

@@ -0,0 +1,69 @@
+import { type Curve } from "./curve.js";
+export declare enum Extrapolation {
+    Clamp = 0,
+    Loop = 1,
+    PingPong = 2
+}
+export interface Keyframe<T> {
+    time: number;
+    value: T;
+    curve?: Curve;
+}
+/**
+ * Base temporal sequence track.
+ * Stores chronological keyframes and evaluates interval interpolation.
+ * Subclasses implement blend(a, b, alpha, out) for concrete data types.
+ */
+export declare abstract class Track<T, TOut = T> {
+    extrapolation: Extrapolation;
+    protected _times: Float64Array;
+    protected _values: T[];
+    protected _curves: (Curve | undefined)[];
+    protected _count: number;
+    protected _capacity: number;
+    protected _cachedIndex: number;
+    constructor(initialCapacity?: number);
+    get count(): number;
+    get startTime(): number;
+    get endTime(): number;
+    get duration(): number;
+    /**
+     * Appends or inserts keyframe maintaining ascending chronological order.
+     */
+    addKey(time: number, value: T, curve?: Curve): this;
+    /**
+     * Removes keyframe at specified index.
+     */
+    removeKey(index: number): boolean;
+    /**
+     * Clears all keyframes.
+     */
+    clear(): this;
+    /**
+     * Retrieves keyframe at index.
+     */
+    getKey(index: number): Keyframe<T> | undefined;
+    /**
+     * Samples track value at specified timestamp.
+     * Evaluates active interval span, computes shaped alpha, and invokes blend().
+     *
+     * @param time Sample timestamp
+     * @param out Optional pre-allocated destination buffer
+     */
+    sample(time: number, out?: TOut): TOut;
+    /**
+     * Subclasses implement value blending between two keyframes.
+     *
+     * @param a Left keyframe value
+     * @param b Right keyframe value
+     * @param alpha Shaped interval progress
+     * @param out Optional output destination buffer
+     */
+    abstract blend(a: T, b: T, alpha: number, out?: TOut): TOut;
+    /**
+     * Fallback value when track contains zero keyframes.
+     */
+    protected defaultValue(out?: TOut): TOut;
+    private _grow;
+}
+//# sourceMappingURL=track.d.ts.map

package/dist/atempo/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../atempo/track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,oBAAY,aAAa;IACrB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,QAAQ,IAAI;CACf;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED;;;;GAIG;AACH,8BAAsB,KAAK,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC;IACnC,aAAa,EAAE,aAAa,CAAuB;IAEnD,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,CAAM;IAC5B,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAAM;IAC9C,SAAS,CAAC,MAAM,SAAK;IACrB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,YAAY,SAAK;gBAEf,eAAe,SAAK;IAKhC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAoCnD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAS9C;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;IA8DtC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;IAE3D;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;IAIxC,OAAO,CAAC,KAAK;CAMhB"}