@vessel-dsp/chain 0.1.0

package/dist/nodes/nam-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nam-node.d.ts","sourceRoot":"","sources":["../../src/nodes/nam-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC7B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CACxC;AAOD;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,YAAW,SAAS;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,SAAS;IACtB,uFAAuF;IACvF,QAAQ,CAAC,cAAc,KAAK;IAC5B,QAAQ,UAAS;IACjB,GAAG,SAAO;IAEV,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,IAAI,CAA6B;IAEzC,OAAO,CAAC,QAAQ,CAA0D;IAC1E,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,oBAAoB,CAAgB;gBAEhC,EAAE,oBAAY,EAAE,IAAI,oBAAY,EAAE,MAAM,EAAE,aAAa;IAUnE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMjC,KAAK,IAAI,IAAI;IAMb,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAexC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBzC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IASnC,OAAO,IAAI,WAAW;IAStB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQjC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY;IAkCzD,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,eAAe;CAYvB"}

package/dist/nodes/nam-node.js

@@ -0,0 +1,234 @@
+import { loadNamModel, namLoudness, } from "../nam/engine.js";
+const MAX_FRAMES = 1024;
+const GAIN_DB_LIMIT = 24;
+/** A model stating a rate this far from the chain rate is refused, not run silently. */
+const SAMPLE_RATE_TOLERANCE_HZ = 0.5;
+/**
+ * A NAM (Neural Amp Modeler) capture as a chain node.
+ *
+ * **The node applies no loudness gain of its own, deliberately.** `nam_process` already implements
+ * NAM's `Normalized` output mode internally -- `10^((-18 - modelLoudness)/20)`, smoothed against
+ * clicks -- which is the policy the workbench validated by listening. Applying it again here would
+ * double it. `getInfo().loudness` reports what the engine did so a host can show it.
+ *
+ * The engine instance is created at `prepare`, not in the constructor, because instantiation is
+ * asynchronous and belongs to the caller. Until then the node passes audio through.
+ */
+export class NamNode {
+    id;
+    name;
+    kind = "nam";
+    /** The engine adds no algorithmic delay; the buffer is in-place and sample-aligned. */
+    latencySamples = 0;
+    bypassed = false;
+    mix = 1.0;
+    engine;
+    modelJson;
+    slimSize;
+    inputGainDb;
+    outputGainDb;
+    sampleRate = 48000;
+    instanceId = 0;
+    bufferPointer = 0;
+    view = null;
+    loudness = { modelLoudnessDb: null, appliedGain: 1 };
+    expectedSampleRate = null;
+    slimmable = false;
+    slimmableBreakpoints = [];
+    constructor(id = "nam-amp", name = "NAM Amp", config) {
+        this.id = id;
+        this.name = name;
+        this.engine = config.engine;
+        this.modelJson = config.model;
+        this.slimSize = config.slimSize ?? -1;
+        this.inputGainDb = clampGainDb(config.inputGainDb ?? 0);
+        this.outputGainDb = clampGainDb(config.outputGainDb ?? 0);
+    }
+    prepare(sampleRate) {
+        this.sampleRate = sampleRate;
+        this.destroyInstance();
+        this.adoptInstance(this.createLoadedInstance(this.modelJson));
+    }
+    reset() {
+        // Recreating the instance is what "reload the state" means for this node: the engine's
+        // prewarm settles the network's initial conditions, which is the point of a reset.
+        this.prepare(this.sampleRate);
+    }
+    getParam(id) {
+        switch (id) {
+            case "inputGainDb":
+                return this.inputGainDb;
+            case "outputGainDb":
+                return this.outputGainDb;
+            case "slimSize":
+                // Not a param the engine will act on for this model, so it is not reported as
+                // one: a host that offered it would be offering a control that does nothing.
+                return this.slimmable ? this.slimSize : undefined;
+            default:
+                return undefined;
+        }
+    }
+    setParam(id, value) {
+        switch (id) {
+            case "inputGainDb":
+                this.inputGainDb = clampGainDb(value);
+                break;
+            case "outputGainDb":
+                this.outputGainDb = clampGainDb(value);
+                break;
+            case "slimSize":
+                // Ignored for non-slimmable models, and ignored rather than refused: the
+                // parameter is a host-level control that only some models answer to.
+                if (this.slimmable) {
+                    this.slimSize = value;
+                    this.engine._nam_setSlimmableSize(this.instanceId, value);
+                }
+                break;
+        }
+    }
+    getParams() {
+        const params = {
+            inputGainDb: this.inputGainDb,
+            outputGainDb: this.outputGainDb,
+        };
+        if (this.slimmable)
+            params.slimSize = this.slimSize;
+        return params;
+    }
+    getInfo() {
+        return {
+            loudness: { ...this.loudness },
+            expectedSampleRate: this.expectedSampleRate,
+            slimmable: this.slimmable,
+            slimmableBreakpoints: [...this.slimmableBreakpoints],
+        };
+    }
+    /**
+     * Swap the model. The replacement is loaded into a **new** instance; the current one keeps
+     * running until the new one is ready, and is released only then. A refused model therefore
+     * never interrupts playback -- the engine's own reason is thrown and the old model stays.
+     */
+    setModel(modelJson) {
+        const instanceId = this.createLoadedInstance(modelJson);
+        const previous = this.instanceId;
+        this.modelJson = modelJson;
+        this.adoptInstance(instanceId);
+        if (previous > 0)
+            this.engine._nam_destroyInstance(previous);
+    }
+    process(input) {
+        const length = input.length;
+        if (this.bypassed || this.instanceId <= 0) {
+            return new Float64Array(input);
+        }
+        const output = new Float64Array(length);
+        const inputGain = 10 ** (this.inputGainDb / 20);
+        const outputGain = 10 ** (this.outputGainDb / 20);
+        const wetMix = Math.max(0, Math.min(1, this.mix));
+        const dryMix = 1 - wetMix;
+        const engine = this.engine;
+        for (let offset = 0; offset < length; offset += MAX_FRAMES) {
+            const frames = Math.min(MAX_FRAMES, length - offset);
+            // Re-derived only when the heap identity changes. `ALLOW_MEMORY_GROWTH` means a growth
+            // detaches every existing view, and a detached `Float32Array` reads as zeros rather
+            // than throwing -- so the check is an identity comparison, not a try/catch.
+            const heap = this.bufferView();
+            for (let i = 0; i < frames; i++) {
+                heap[i] = (input[offset + i] ?? 0) * inputGain;
+            }
+            engine._nam_process(this.instanceId, frames);
+            // `nam_process` never allocates, so the view above is still attached here.
+            for (let i = 0; i < frames; i++) {
+                const wet = (heap[i] ?? 0) * outputGain;
+                const dry = input[offset + i] ?? 0;
+                output[offset + i] = dryMix * dry + wetMix * wet;
+            }
+        }
+        return output;
+    }
+    dispose() {
+        this.destroyInstance();
+    }
+    /**
+     * Create an instance with `modelJson` loaded, or throw. The instance is released on every
+     * failure path so a refused model does not strand one.
+     */
+    createLoadedInstance(modelJson) {
+        const instanceId = this.engine._nam_createInstance(this.sampleRate, MAX_FRAMES);
+        if (instanceId <= 0) {
+            throw new Error("nam_createInstance refused");
+        }
+        try {
+            loadNamModel(this.engine, instanceId, modelJson, this.slimSize);
+            const expected = this.engine._nam_getExpectedSampleRate(instanceId);
+            if (expected >= 0 &&
+                Math.abs(expected - this.sampleRate) > SAMPLE_RATE_TOLERANCE_HZ) {
+                throw new Error(`NAM model ${labelOf(modelJson)} states ${expected} Hz but the chain runs at ` +
+                    `${this.sampleRate} Hz; refusing to run it at the wrong rate`);
+            }
+            return instanceId;
+        }
+        catch (error) {
+            this.engine._nam_destroyInstance(instanceId);
+            throw error;
+        }
+    }
+    adoptInstance(instanceId) {
+        this.instanceId = instanceId;
+        this.bufferPointer = this.engine._nam_getBuffer(instanceId);
+        this.view = null;
+        this.loudness = namLoudness(this.engine, instanceId);
+        const expected = this.engine._nam_getExpectedSampleRate(instanceId);
+        this.expectedSampleRate = expected < 0 ? null : expected;
+        this.slimmable = this.engine._nam_isSlimmable(instanceId) === 1;
+        this.slimmableBreakpoints = [];
+        if (this.slimmable) {
+            const count = this.engine._nam_getSlimmableBreakpointCount(instanceId);
+            for (let index = 0; index < count; index++) {
+                const breakpoint = this.engine._nam_getSlimmableBreakpoint(instanceId, index);
+                if (breakpoint >= 0)
+                    this.slimmableBreakpoints.push(breakpoint);
+            }
+        }
+    }
+    bufferView() {
+        if (this.view === null || this.view.buffer !== this.engine.HEAPF32.buffer) {
+            const offset = this.bufferPointer >> 2;
+            this.view = this.engine.HEAPF32.subarray(offset, offset + MAX_FRAMES);
+        }
+        return this.view;
+    }
+    destroyInstance() {
+        if (this.instanceId > 0) {
+            this.engine._nam_destroyInstance(this.instanceId);
+        }
+        this.instanceId = 0;
+        this.bufferPointer = 0;
+        this.view = null;
+        this.loudness = { modelLoudnessDb: null, appliedGain: 1 };
+        this.expectedSampleRate = null;
+        this.slimmable = false;
+        this.slimmableBreakpoints = [];
+    }
+}
+function clampGainDb(value) {
+    return Math.max(-GAIN_DB_LIMIT, Math.min(GAIN_DB_LIMIT, value));
+}
+/** A short, stable label for a model document, for error messages. */
+function labelOf(modelJson) {
+    try {
+        const parsed = JSON.parse(modelJson);
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "name" in parsed &&
+            typeof parsed.name === "string" &&
+            parsed.name.length > 0) {
+            return parsed.name;
+        }
+    }
+    catch {
+        // Not parseable, or has no name: fall through to the truncated document.
+    }
+    return `${modelJson.slice(0, 80)}...`;
+}
+//# sourceMappingURL=nam-node.js.map

package/dist/nodes/nam-node.js.map

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

package/dist/nodes/runtime-node.d.ts

@@ -0,0 +1,66 @@
+import type { Program, SupplyResolution } from "@vessel-dsp/compiler";
+import type { SupplyProfile } from "../supply-profile.js";
+import type { ChainNode } from "../types.js";
+export type RuntimeNodeOptions = {
+    readonly source?: string;
+};
+export declare class RuntimeNode implements ChainNode {
+    readonly id: string;
+    readonly name: string;
+    readonly kind = "circuit-runtime";
+    bypassed: boolean;
+    mix: number;
+    private runtime;
+    private program;
+    private params;
+    private sampleRate;
+    private source;
+    private supplyResolution;
+    private supplyProfile;
+    private appliedVoltsMagnitude;
+    private appliedOhms;
+    constructor(id: string, name: string, program: Program, options?: RuntimeNodeOptions);
+    getProgram(): Program;
+    /**
+     * Apply a supply profile to the circuit's external supply stamps.
+     *
+     * Resolves once (lazily, cached) with `resolveSupplyStamps(source,
+     * program)`, then retargets every resolved stamp through the runtime's
+     * `setSupply`. A null `openCircuitVolts` keeps each stamp's compiled
+     * magnitude; an explicit value replaces the magnitude. The sign always
+     * follows the stamp's own volts sign read from `getSupplies()`, so a
+     * positive-ground germanium rail stays negative.
+     *
+     * Throws when no source text was given or when nothing resolves, naming
+     * the refusal reason codes and rail ids. A program with refused derived
+     * rails but one resolved external rail applies to the resolved one and
+     * keeps the refusals visible via `getSupplyResolution()`.
+     *
+     * Callable before and after `prepare()` and between `process()` calls,
+     * following the runtime's contract. There is no audio-domain processing
+     * in this path.
+     */
+    setSupplyProfile(profile: SupplyProfile): void;
+    /**
+     * The cached supply resolution, or null until `setSupplyProfile` has
+     * resolved once.
+     */
+    getSupplyResolution(): SupplyResolution | null;
+    /**
+     * The last applied supply profile, or null until one has been applied.
+     */
+    getSupplyProfile(): SupplyProfile | null;
+    prepare(sampleRate: number): void;
+    reset(): void;
+    getParam(id: string): number | undefined;
+    setParam(id: string, value: number): void;
+    getParams(): Record<string, number>;
+    process(input: Float64Array | Float32Array): Float64Array;
+    private resolveSupplies;
+    private describeRefusals;
+    private compiledVoltsFor;
+    private applyProfileToRuntime;
+    private fallbackVoltsMagnitude;
+    private fallbackOhms;
+}
+//# sourceMappingURL=runtime-node.d.ts.map

package/dist/nodes/runtime-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-node.d.ts","sourceRoot":"","sources":["../../src/nodes/runtime-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAItE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAKF,qBAAa,WAAY,YAAW,SAAS;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,UAAS;IACjB,GAAG,SAAO;IAEV,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAA8B;IAE5C,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,WAAW,CAAuB;gBAGzC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,kBAAkB;IAiB7B,UAAU,IAAI,OAAO;IAIrB;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IA0C9C;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,IAAI;IAI9C;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAWjC,KAAK,IAAI,IAAI;IAYb,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUxC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAsBzC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAanC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY;IA0BzD,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,qBAAqB;IAuC7B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,YAAY;CASpB"}

package/dist/nodes/runtime-node.js

@@ -0,0 +1,247 @@
+import { resolveSupplyStamps } from "@vessel-dsp/compiler";
+import { ReferenceRuntime } from "@vessel-dsp/runtime";
+import { customSupplyProfile } from "../supply-profile.js";
+const SUPPLY_VOLTS_PARAM = "supplyOpenCircuitVolts";
+const SUPPLY_OHMS_PARAM = "supplyInternalResistanceOhms";
+export class RuntimeNode {
+    id;
+    name;
+    kind = "circuit-runtime";
+    bypassed = false;
+    mix = 1.0;
+    runtime;
+    program;
+    params = {};
+    sampleRate = 48000;
+    source;
+    supplyResolution = null;
+    supplyProfile = null;
+    appliedVoltsMagnitude = null;
+    appliedOhms = null;
+    constructor(id, name, program, options) {
+        this.id = id;
+        this.name = name;
+        this.program = program;
+        this.source = options?.source;
+        this.runtime = new ReferenceRuntime(program);
+        // Initialize default parameters from program controls
+        if (program.controls) {
+            for (const ctrl of program.controls) {
+                this.params[ctrl.id] = ctrl.defaultPosition ?? 0.5;
+                this.runtime.setControl(ctrl.id, this.params[ctrl.id]);
+            }
+        }
+    }
+    getProgram() {
+        return this.program;
+    }
+    /**
+     * Apply a supply profile to the circuit's external supply stamps.
+     *
+     * Resolves once (lazily, cached) with `resolveSupplyStamps(source,
+     * program)`, then retargets every resolved stamp through the runtime's
+     * `setSupply`. A null `openCircuitVolts` keeps each stamp's compiled
+     * magnitude; an explicit value replaces the magnitude. The sign always
+     * follows the stamp's own volts sign read from `getSupplies()`, so a
+     * positive-ground germanium rail stays negative.
+     *
+     * Throws when no source text was given or when nothing resolves, naming
+     * the refusal reason codes and rail ids. A program with refused derived
+     * rails but one resolved external rail applies to the resolved one and
+     * keeps the refusals visible via `getSupplyResolution()`.
+     *
+     * Callable before and after `prepare()` and between `process()` calls,
+     * following the runtime's contract. There is no audio-domain processing
+     * in this path.
+     */
+    setSupplyProfile(profile) {
+        if (profile.openCircuitVolts !== null &&
+            (!Number.isFinite(profile.openCircuitVolts) ||
+                profile.openCircuitVolts <= 0)) {
+            throw new Error(`setSupplyProfile: openCircuitVolts must be null or a finite positive magnitude, got ${String(profile.openCircuitVolts)}`);
+        }
+        if (!Number.isFinite(profile.internalResistanceOhms) ||
+            profile.internalResistanceOhms < 0) {
+            throw new Error(`setSupplyProfile: internalResistanceOhms must be a finite non-negative resistance, got ${String(profile.internalResistanceOhms)}`);
+        }
+        const resolution = this.resolveSupplies();
+        if (resolution.supplies.length === 0) {
+            throw new Error(`setSupplyProfile: no external supply resolved (${this.describeRefusals(resolution)})`);
+        }
+        this.applyProfileToRuntime(profile, resolution);
+        this.supplyProfile = profile;
+        if (profile.openCircuitVolts !== null) {
+            this.appliedVoltsMagnitude = profile.openCircuitVolts;
+        }
+        else {
+            const first = resolution.supplies[0];
+            if (first === undefined) {
+                throw new Error(`setSupplyProfile: no external supply resolved (${this.describeRefusals(resolution)})`);
+            }
+            this.appliedVoltsMagnitude = Math.abs(this.compiledVoltsFor(first.address));
+        }
+        this.appliedOhms = profile.internalResistanceOhms;
+    }
+    /**
+     * The cached supply resolution, or null until `setSupplyProfile` has
+     * resolved once.
+     */
+    getSupplyResolution() {
+        return this.supplyResolution;
+    }
+    /**
+     * The last applied supply profile, or null until one has been applied.
+     */
+    getSupplyProfile() {
+        return this.supplyProfile;
+    }
+    prepare(sampleRate) {
+        this.sampleRate = sampleRate;
+        this.runtime.prepare(sampleRate);
+        if (this.supplyProfile !== null && this.supplyResolution !== null) {
+            this.applyProfileToRuntime(this.supplyProfile, this.supplyResolution);
+        }
+    }
+    reset() {
+        if (this.sampleRate > 0) {
+            this.runtime.prepare(this.sampleRate);
+            if (this.supplyProfile !== null && this.supplyResolution !== null) {
+                this.applyProfileToRuntime(this.supplyProfile, this.supplyResolution);
+            }
+        }
+    }
+    getParam(id) {
+        if (id === SUPPLY_VOLTS_PARAM) {
+            return this.appliedVoltsMagnitude ?? undefined;
+        }
+        if (id === SUPPLY_OHMS_PARAM) {
+            return this.appliedOhms ?? undefined;
+        }
+        return this.params[id];
+    }
+    setParam(id, value) {
+        if (id === SUPPLY_VOLTS_PARAM || id === SUPPLY_OHMS_PARAM) {
+            const currentVolts = this.appliedVoltsMagnitude ?? this.fallbackVoltsMagnitude();
+            const currentOhms = this.appliedOhms ?? this.fallbackOhms();
+            const nextVolts = id === SUPPLY_VOLTS_PARAM ? value : currentVolts;
+            const nextOhms = id === SUPPLY_OHMS_PARAM ? value : currentOhms;
+            const custom = customSupplyProfile({
+                openCircuitVolts: nextVolts,
+                internalResistanceOhms: nextOhms,
+                name: "Custom supply (preset)",
+            });
+            this.setSupplyProfile(custom);
+            return;
+        }
+        this.params[id] = value;
+        this.runtime.setControl(id, value);
+    }
+    getParams() {
+        const base = { ...this.params };
+        if (this.supplyProfile !== null &&
+            this.appliedVoltsMagnitude !== null &&
+            this.appliedOhms !== null) {
+            base[SUPPLY_VOLTS_PARAM] = this.appliedVoltsMagnitude;
+            base[SUPPLY_OHMS_PARAM] = this.appliedOhms;
+        }
+        return base;
+    }
+    process(input) {
+        const length = input.length;
+        const input64 = input instanceof Float64Array ? input : new Float64Array(input);
+        if (this.bypassed) {
+            return new Float64Array(input64);
+        }
+        const wet = this.runtime.process(input64);
+        if (this.mix >= 0.999) {
+            return wet;
+        }
+        const output = new Float64Array(length);
+        const wetMix = this.mix;
+        const dryMix = 1.0 - wetMix;
+        for (let i = 0; i < length; i++) {
+            output[i] = dryMix * (input64[i] ?? 0) + wetMix * (wet[i] ?? 0);
+        }
+        return output;
+    }
+    resolveSupplies() {
+        if (this.supplyResolution !== null) {
+            return this.supplyResolution;
+        }
+        if (this.source === undefined) {
+            throw new Error("setSupplyProfile: no source text was given to this RuntimeNode, so no external supply can be resolved: pass the .vdsp text as the fourth constructor argument");
+        }
+        const resolution = resolveSupplyStamps(this.source, this.program);
+        this.supplyResolution = resolution;
+        return resolution;
+    }
+    describeRefusals(resolution) {
+        if (resolution.refused.length === 0) {
+            return "no refusals recorded";
+        }
+        return resolution.refused
+            .map((entry) => `${entry.reason}(${entry.railComponentId ?? "no-rail"})`)
+            .join(", ");
+    }
+    compiledVoltsFor(address) {
+        const block = this.program.blocks[address.blockIndex];
+        if (block?.kind !== "mna") {
+            throw new Error(`setSupplyProfile: resolved block index ${String(address.blockIndex)} is not an MNA block`);
+        }
+        for (const stamp of block.stamps) {
+            if (stamp.kind === "dc-source" &&
+                stamp.sourceIndex === address.sourceIndex) {
+                return stamp.volts;
+            }
+        }
+        throw new Error(`setSupplyProfile: resolved supply at block ${String(address.blockIndex)} source ${String(address.sourceIndex)} has no compiled dc-source stamp`);
+    }
+    applyProfileToRuntime(profile, resolution) {
+        const liveByKey = new Map();
+        for (const info of this.runtime.getSupplies()) {
+            liveByKey.set(`${info.address.blockIndex}:${info.address.sourceIndex}`, info.volts);
+        }
+        const grouped = new Map();
+        for (const supply of resolution.supplies) {
+            const compiled = this.compiledVoltsFor(supply.address);
+            const live = liveByKey.get(`${supply.address.blockIndex}:${supply.address.sourceIndex}`);
+            const signSource = live ?? compiled;
+            const sign = signSource < 0 ? -1 : 1;
+            const magnitude = profile.openCircuitVolts ?? Math.abs(compiled);
+            const targetVolts = sign * magnitude;
+            const key = targetVolts;
+            let list = grouped.get(key);
+            if (list === undefined) {
+                list = [];
+                grouped.set(key, list);
+            }
+            list.push(supply.address);
+        }
+        for (const [targetVolts, addresses] of grouped) {
+            this.runtime.setSupply(addresses, targetVolts, profile.internalResistanceOhms);
+        }
+    }
+    fallbackVoltsMagnitude() {
+        const live = this.runtime.getSupplies()[0];
+        if (live !== undefined && Number.isFinite(live.volts)) {
+            const magnitude = Math.abs(live.volts);
+            if (magnitude > 0) {
+                return magnitude;
+            }
+        }
+        if (this.supplyResolution !== null) {
+            for (const supply of this.supplyResolution.supplies) {
+                return Math.abs(this.compiledVoltsFor(supply.address));
+            }
+        }
+        throw new Error("setSupplyProfile: supplyOpenCircuitVolts has no current value to pair with: apply a profile first");
+    }
+    fallbackOhms() {
+        const live = this.runtime.getSupplies()[0];
+        if (live !== undefined && Number.isFinite(live.sourceOhms)) {
+            return live.sourceOhms;
+        }
+        throw new Error("setSupplyProfile: supplyInternalResistanceOhms has no current value to pair with: apply a profile first");
+    }
+}
+//# sourceMappingURL=runtime-node.js.map

package/dist/nodes/runtime-node.js.map

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

package/dist/supply-profile.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Battery supply profiles for {@link RuntimeNode.setSupplyProfile}.
+ *
+ * A profile is an open-circuit EMF magnitude plus a series resistance. It is
+ * applied to the circuit's external supply stamps only (see
+ * `resolveSupplyStamps` in `@vessel-dsp/compiler`): derived rails keep their
+ * compiled values, and mains-fed rails are refused. There is no audio-domain
+ * processing here: no envelope follower, no waveshaper, no extra chain node.
+ * The circuit's own current draw through the series resistance is what
+ * produces sag inside the solver.
+ *
+ * Provenance rule: every numeric value below is either the literal
+ * "definition" (the ideal source) or a citation of the one opened document,
+ * Jack Orman, "9v Battery Impedance", AMZ-FX Lab Notebook, copyright 2015,
+ * http://www.muzique.com/lab/batteryz.htm, method: unloaded reading with a
+ * Fluke multimeter, then loaded with a 560 ohm resistor, internal resistance
+ * by Ohm's law. No adapter profile is listed because no source was found for
+ * one (design note section 5). No number from the old PowerSupplyNode is
+ * reused.
+ */
+export type SupplyProfile = {
+    readonly id: string;
+    readonly name: string;
+    /** Open-circuit EMF magnitude in volts, or null to keep the pedal's own declared supply voltage. */
+    readonly openCircuitVolts: number | null;
+    /** Series resistance in ohms. */
+    readonly internalResistanceOhms: number;
+    /** A citation (document, year, table, exact values, how a derived number was computed) or the literal "definition". */
+    readonly source: string;
+};
+/**
+ * The five built-in profiles, and only these. Adapter profiles are
+ * deliberately absent: no source was found for a regulated 9 V, regulated
+ * 18 V, or unregulated AC/DC resistance or voltage.
+ */
+export declare const SUPPLY_PROFILES: readonly SupplyProfile[];
+/**
+ * Build a profile from the caller's own measurement, following Orman's
+ * method: read the open-circuit volts E, then the loaded volts across a known
+ * resistor Rload, and compute Rint = (Vopen - Vloaded) / (Vloaded / Rload).
+ */
+export declare function profileFromMeasurement(input: {
+    readonly openCircuitVolts: number;
+    readonly loadedVolts: number;
+    readonly loadOhms: number;
+}): SupplyProfile;
+/**
+ * Build a profile from caller-supplied numbers (for example a preset
+ * round-trip). The source is the caller: no citation is claimed.
+ */
+export declare function customSupplyProfile(input: {
+    readonly openCircuitVolts: number | null;
+    readonly internalResistanceOhms: number;
+    readonly name?: string;
+}): SupplyProfile;
+//# sourceMappingURL=supply-profile.d.ts.map

package/dist/supply-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supply-profile.d.ts","sourceRoot":"","sources":["../src/supply-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,iCAAiC;IACjC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,uHAAuH;IACvH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;AA0DF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAMnD,CAAC;AAaF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B,GAAG,aAAa,CA8BhB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,aAAa,CAyBhB"}