@hyperframes/core 0.7.107 → 0.7.108

package/dist/audio/audioFxAutomation.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Plays automation envelopes through native AudioParam scheduling.
+ *
+ * Nothing here runs per frame. The envelope is handed to the audio thread once,
+ * as ramps and curves, so it stays sample-accurate no matter what the main
+ * thread is doing — and the offline render schedules it the same way, which is
+ * why preview and render agree by construction rather than by tolerance.
+ */
+import { type HfAutomation, type HfAutomationLane } from "../audioAutomation.js";
+import type { HfAudioFxChain } from "../audioFx.js";
+import type { FxNodeHandle, FxParamTarget } from "./audioFxGraph.js";
+/** Where the clip sits in context time when its source is scheduled. */
+export interface AutomationTiming {
+    /** Context time the source was scheduled at. */
+    scheduledAt: number;
+    /** Clip-local seconds already elapsed at that moment; negative before it starts. */
+    elapsed: number;
+    /** Playback rate, which compresses clip seconds into context seconds. */
+    rate: number;
+}
+/**
+ * Drop every event booked on a parameter, including a curve already under way.
+ *
+ * Anything landing inside a running curve is refused — a fresh curve, or the
+ * plain `.value` write that re-parameterising a chain performs — so the param has
+ * to be cancelled first. Measured against Chrome, any cancel frees the span; this
+ * takes the strongest form on purpose, because curve-over-curve refusals were
+ * reported from the field with a cancel at the new schedule time already in place
+ * and have never reproduced. Cancelling from zero cannot leave a stale event
+ * behind whatever that mechanism is.
+ *
+ * Safe on these parameters because this scheduler is their only writer: they
+ * belong to effect nodes it built, and the caller re-seeds the value in the same
+ * breath, so nothing clicks.
+ */
+export declare function clearParamLane(targets: readonly FxParamTarget[]): void;
+/** Stop an envelope, leaving the parameter wherever it currently sits. */
+export declare function cancelParamLane(targets: readonly FxParamTarget[], from: number): void;
+/**
+ * Schedule one lane onto every AudioParam behind its knob.
+ *
+ * Existing automation from an earlier schedule is cancelled first, so calling
+ * this again after an edit replaces the envelope rather than layering on it.
+ */
+export declare function scheduleParamLane(targets: readonly FxParamTarget[], lane: HfAutomationLane, scale: "linear" | "log", timing: AutomationTiming): void;
+/** One built effect, paired with the chain node id lanes address it by. */
+export interface AutomatableNode {
+    id?: string;
+    handle: FxNodeHandle;
+}
+/**
+ * Schedule every FX lane in an automation set against a built chain.
+ *
+ * Lanes with nowhere to write are skipped rather than reported: a one-pole
+ * filter exposes no frequency param, and a worklet effect exposes none at all.
+ * Returns the targets that were scheduled, so they can be cancelled together.
+ */
+export declare function scheduleChainAutomation(automation: HfAutomation, chain: HfAudioFxChain, nodes: readonly AutomatableNode[], timing: AutomationTiming, 
+/** The wet/dry blend around each preset run, from `FxChainHandle.presets`. */
+presets?: Record<string, FxParamTarget[]>): FxParamTarget[];
+/** The track's volume lane, if it has one. */
+export declare function volumeLane(automation: HfAutomation): HfAutomationLane | null;
+//# sourceMappingURL=audioFxAutomation.d.ts.map

package/dist/audio/audioFxAutomation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioFxAutomation.d.ts","sourceRoot":"","sources":["../../src/audio/audioFxAutomation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAErE,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AA2ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAEtE;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,QAAQ,GAAG,KAAK,EACvB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAeN;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,YAAY,EACxB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,MAAM,EAAE,gBAAgB;AACxB,8EAA8E;AAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,GACxC,aAAa,EAAE,CAuBjB;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,UAAU,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAE5E"}

package/dist/audio/audioFxAutomation.js

@@ -0,0 +1,219 @@
+/**
+ * Plays automation envelopes through native AudioParam scheduling.
+ *
+ * Nothing here runs per frame. The envelope is handed to the audio thread once,
+ * as ramps and curves, so it stays sample-accurate no matter what the main
+ * thread is doing — and the offline render schedules it the same way, which is
+ * why preview and render agree by construction rather than by tolerance.
+ */
+import { isConstantLane, resolveAutomationRange, sampleAutomationCurve, sampleAutomationLane, } from "../audioAutomation.js";
+import { parseAutomationTarget, VOLUME_TARGET } from "../audioAutomation.js";
+/**
+ * Sampling density for segments that cannot be expressed as a ramp. Dense
+ * enough that a curve is inaudible from a continuous one, capped so a long
+ * segment cannot allocate without bound.
+ */
+const CURVE_POINTS_PER_SEC = 100;
+const MIN_CURVE_POINTS = 8;
+const MAX_CURVE_POINTS = 4096;
+const identity = (v) => v;
+/**
+ * A segment is a straight line only when nothing bends it: no curvature and no
+ * via point on the point it leaves, a linear parameter scale, and no unit
+ * mapping that could be non-linear. Everything else is sampled.
+ *
+ * Both bend forms have to be checked. `curve` is an exponent; a via point names
+ * an interior point the segment passes through, and it is what the timeline
+ * writes when a bend is dragged. Testing only the exponent read every dragged
+ * bend as straight and played it as a linear ramp — the lane drew one shape and
+ * the ear got another.
+ */
+function isStraight(point, scale, map) {
+    const bent = Boolean(point.curve) || (point.viaX !== undefined && point.viaY !== undefined);
+    return !bent && scale === "linear" && !map;
+}
+function curvePointCount(duration) {
+    const wanted = Math.ceil(duration * CURVE_POINTS_PER_SEC);
+    return Math.min(MAX_CURVE_POINTS, Math.max(MIN_CURVE_POINTS, wanted));
+}
+/**
+ * One segment of the envelope, as the event that plays it. Returns null when
+ * the segment is already behind the playhead.
+ */
+function segmentOp(lane, index, scale, timing, map) {
+    const { scheduledAt, elapsed, rate } = timing;
+    const apply = map ?? identity;
+    const toCtx = (t) => scheduledAt + (t - elapsed) / rate;
+    const a = lane.points[index];
+    const b = lane.points[index + 1];
+    const toTime = toCtx(b.t);
+    if (toTime <= scheduledAt)
+        return null;
+    const fromTime = Math.max(scheduledAt, toCtx(a.t));
+    const duration = toTime - fromTime;
+    if (duration <= 0)
+        return null;
+    if (isStraight(a, scale, map)) {
+        return { kind: "ramp", time: toTime, value: apply(b.v) };
+    }
+    // Sample from wherever the segment is entered, which is mid-segment when the
+    // playhead landed inside it.
+    const count = curvePointCount(duration);
+    const raw = sampleAutomationCurve(lane, Math.max(a.t, elapsed), b.t, count, scale);
+    const values = new Float32Array(count);
+    for (let k = 0; k < count; k += 1)
+        values[k] = apply(raw[k] ?? 0);
+    return { kind: "curve", time: fromTime, duration, values };
+}
+/** Turn a lane into the events one AudioParam should receive. */
+function planOps(lane, scale, timing, map) {
+    const ops = [];
+    for (let i = 0; i + 1 < lane.points.length; i += 1) {
+        const op = segmentOp(lane, i, scale, timing, map);
+        if (op)
+            ops.push(op);
+    }
+    // Hold the envelope's value at the moment playback starts. This is what makes
+    // a lane correct before its first point and after its last, and it gives a
+    // following ramp something to ramp from.
+    //
+    // A value curve may not overlap another event, so the seed is dropped when a
+    // curve already begins at that instant — the curve sets the value itself.
+    const first = ops[0];
+    if (!(first?.kind === "curve" && first.time <= timing.scheduledAt)) {
+        ops.unshift({
+            kind: "set",
+            time: timing.scheduledAt,
+            value: (map ?? identity)(sampleAutomationLane(lane, timing.elapsed, scale)),
+        });
+    }
+    return ops;
+}
+/**
+ * Hand the plan to the AudioParam, degrading a curve the browser will not take.
+ *
+ * A value curve may not overlap another, and this has been seen refused in the
+ * field while rescheduling mid-playback — two passes landing a render quantum
+ * apart, which is what applying a carve while the transport runs does. Every
+ * caller here cancels the parameter first, and measured against Chrome that is
+ * enough to free even a curve already under way, so the mechanism behind those
+ * reports is not understood and does not reproduce. This catch is the backstop
+ * for it: unhandled, the exception reached the console and abandoned every
+ * remaining segment of the envelope.
+ *
+ * A ramp to the same destination is always accepted, since it books no span. The
+ * segment loses its bend until the next full reschedule, which is a far better
+ * failure than the rest of the envelope never being scheduled at all.
+ */
+function emit(param, ops) {
+    for (const op of ops) {
+        if (op.kind === "set")
+            param.setValueAtTime(op.value, op.time);
+        else if (op.kind === "ramp")
+            param.linearRampToValueAtTime(op.value, op.time);
+        else {
+            try {
+                param.setValueCurveAtTime(op.values, op.time, op.duration);
+            }
+            catch {
+                const end = op.values[op.values.length - 1] ?? 0;
+                param.linearRampToValueAtTime(end, op.time + op.duration);
+            }
+        }
+    }
+}
+/**
+ * Drop every event booked on a parameter, including a curve already under way.
+ *
+ * Anything landing inside a running curve is refused — a fresh curve, or the
+ * plain `.value` write that re-parameterising a chain performs — so the param has
+ * to be cancelled first. Measured against Chrome, any cancel frees the span; this
+ * takes the strongest form on purpose, because curve-over-curve refusals were
+ * reported from the field with a cancel at the new schedule time already in place
+ * and have never reproduced. Cancelling from zero cannot leave a stale event
+ * behind whatever that mechanism is.
+ *
+ * Safe on these parameters because this scheduler is their only writer: they
+ * belong to effect nodes it built, and the caller re-seeds the value in the same
+ * breath, so nothing clicks.
+ */
+export function clearParamLane(targets) {
+    for (const target of targets)
+        target.param.cancelScheduledValues(0);
+}
+/** Stop an envelope, leaving the parameter wherever it currently sits. */
+export function cancelParamLane(targets, from) {
+    for (const target of targets) {
+        // Keep the value the ramp had reached rather than snapping back to the
+        // last explicitly-set one, which would click.
+        if (typeof target.param.cancelAndHoldAtTime === "function") {
+            target.param.cancelAndHoldAtTime(from);
+        }
+        else {
+            target.param.cancelScheduledValues(from);
+        }
+    }
+}
+/**
+ * Schedule one lane onto every AudioParam behind its knob.
+ *
+ * Existing automation from an earlier schedule is cancelled first, so calling
+ * this again after an edit replaces the envelope rather than layering on it.
+ */
+export function scheduleParamLane(targets, lane, scale, timing) {
+    if (lane.points.length === 0)
+        return;
+    for (const target of targets) {
+        // Cleared from zero rather than from this instant: a reschedule mid-playback
+        // lands inside the previous pass's still-running curve, and the field reports
+        // of that being refused had a cancel at this instant already in place. The
+        // plan below re-seeds the value here, so clearing costs nothing audible.
+        clearParamLane([target]);
+        if (isConstantLane(lane)) {
+            const value = (target.map ?? identity)(lane.points[0].v);
+            target.param.setValueAtTime(value, timing.scheduledAt);
+            continue;
+        }
+        emit(target.param, planOps(lane, scale, timing, target.map));
+    }
+}
+/**
+ * Schedule every FX lane in an automation set against a built chain.
+ *
+ * Lanes with nowhere to write are skipped rather than reported: a one-pole
+ * filter exposes no frequency param, and a worklet effect exposes none at all.
+ * Returns the targets that were scheduled, so they can be cancelled together.
+ */
+export function scheduleChainAutomation(automation, chain, nodes, timing, 
+/** The wet/dry blend around each preset run, from `FxChainHandle.presets`. */
+presets) {
+    const byId = new Map(nodes.filter((n) => n.id).map((n) => [n.id, n.handle]));
+    const scheduled = [];
+    for (const lane of automation.lanes) {
+        const parsed = parseAutomationTarget(lane.target);
+        if (!parsed)
+            continue;
+        // A whole-preset lane drives the wet/dry blend the graph wrapped its run in,
+        // rather than any node's parameter — which is the point of it: a preset's
+        // nodes share no automatable parameter, and its worklet effects expose none
+        // at all.
+        const targets = parsed.kind === "preset"
+            ? presets?.[parsed.presetId]
+            : parsed.kind === "fx"
+                ? byId.get(parsed.nodeId)?.automation?.[parsed.param]
+                : undefined;
+        if (!targets || targets.length === 0)
+            continue;
+        const range = resolveAutomationRange(lane.target, chain);
+        if (!range)
+            continue;
+        scheduleParamLane(targets, lane, range.scale, timing);
+        scheduled.push(...targets);
+    }
+    return scheduled;
+}
+/** The track's volume lane, if it has one. */
+export function volumeLane(automation) {
+    return automation.lanes.find((lane) => lane.target === VOLUME_TARGET) ?? null;
+}
+//# sourceMappingURL=audioFxAutomation.js.map

package/dist/audio/audioFxAutomation.js.map

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

package/dist/audio/audioFxGraph.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Builds the Web Audio graph for an FX chain, one builder per `web` id in the
+ * core registry.
+ *
+ * Every node exposes `update`, so turning a dial re-parameterises the running
+ * graph instead of rebuilding it. That is the whole point of previewing in the
+ * browser: an AudioParam change lands on the next 128-sample render quantum,
+ * about 2.7 ms at 48 kHz, so the knob-to-ear loop is immediate.
+ */
+import { type HfAudioFxChain, type HfAudioFxParamValues } from "../audioFx.js";
+import { audioFxWorkletsReady, ensureAudioFxWorklets } from "./audioFxWorklets.js";
+/**
+ * Deterministic reverb impulse, shared by both engines so the browser and the
+ * render convolve the identical response. Exponentially-decaying noise with a
+ * one-pole lowpass standing in for air absorption; the PRNG is seeded from the
+ * parameters so the same room always produces the same tail.
+ */
+export declare function synthesizeReverbImpulse(sampleRate: number, size: number, damping: number): Float32Array;
+/**
+ * Where an automation lane writes when it drives one knob.
+ *
+ * A knob is not always one AudioParam. A wet/dry mix is two gains moving in
+ * opposition, and a knob in milliseconds drives a delay time in seconds, so
+ * each target carries its own mapping out of the knob's declared unit.
+ */
+export interface FxParamTarget {
+    param: AudioParam;
+    map?: (value: number) => number;
+}
+export interface FxNodeHandle {
+    input: AudioNode;
+    output: AudioNode;
+    update(params: HfAudioFxParamValues): void;
+    /**
+     * AudioParams behind the knobs the registry marks `automatable`, keyed by
+     * parameter key. Absent for a node whose values cannot be scheduled.
+     */
+    automation?: Record<string, FxParamTarget[]>;
+    dispose(): void;
+}
+/** Effect ids whose Web Audio node needs a worklet module registered first. */
+export declare function chainNeedsWorklets(chain: HfAudioFxChain): boolean;
+export declare function buildFxNode(ctx: BaseAudioContext, type: string, params: HfAudioFxParamValues, elapsed?: number): FxNodeHandle;
+export interface FxChainHandle {
+    input: AudioNode;
+    output: AudioNode;
+    /** Built effects in chain order, carrying the node ids lanes address. */
+    nodes: {
+        id?: string;
+        type: string;
+        handle: FxNodeHandle;
+    }[];
+    /**
+     * The wet/dry blend around each preset run, by preset id — where a
+     * whole-preset lane writes. Two gains in opposition, the same shape
+     * `mixTargets` builds for an effect's own mix knob.
+     */
+    presets: Record<string, FxParamTarget[]>;
+    /** Re-parameterise in place when the shape is unchanged; false if a rebuild is needed. */
+    update(chain: HfAudioFxChain): boolean;
+    dispose(): void;
+}
+/**
+ * Build the whole chain in series. Returns a handle whose `input`/`output` can
+ * be spliced into any graph; an empty chain yields a pass-through.
+ *
+ * `elapsed` is where in the clip this is being built — see `Builder`. It only
+ * reaches the modulated effects, and only matters when the graph is built after
+ * the audio has already started.
+ */
+export declare function buildFxChain(ctx: BaseAudioContext, chain: HfAudioFxChain, elapsed?: number): FxChainHandle;
+export { audioFxWorkletsReady, ensureAudioFxWorklets };
+//# sourceMappingURL=audioFxGraph.d.ts.map

package/dist/audio/audioFxGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioFxGraph.d.ts","sourceRoot":"","sources":["../../src/audio/audioFxGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,YAAY,CA8Bd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7C,OAAO,IAAI,IAAI,CAAC;CACjB;AA8aD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEjE;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,oBAAoB,EAC5B,OAAO,SAAI,GACV,YAAY,CAWd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,EAAE,CAAC;IAC7D;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IACzC,0FAA0F;IAC1F,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC;IACvC,OAAO,IAAI,IAAI,CAAC;CACjB;AAgED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,cAAc,EACrB,OAAO,SAAI,GACV,aAAa,CAwHf;AAED,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC"}