@opendaw/studio-core-wasm 0.0.12 → 0.0.14

package/dist/engine-modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-modules.d.ts","sourceRoot":"","sources":["../src/engine-modules.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAG7E,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAE3E,eAAe,EAAE,MAAM,CAAC;IAGxB,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAG3C,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAC9C,CAAA;AASD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,mBAAmB,CAAA;IACzB,WAAW,EAAE,0BAA0B,CAAA;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C,CAAA;AAGD,oBAAY,mBAAmB;IAAE,WAAW,IAAI;IAAE,UAAU,IAAI;CAAC;AAGjE,oBAAY,0BAA0B;IAAE,SAAS,IAAI;IAAE,MAAM,IAAI;IAAE,SAAS,IAAI;CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG;IACxB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAA;IAChC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAChD,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACxC,gBAAgB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CACvD,CAAA;AAQD,eAAO,MAAM,kBAAkB,QAAO,WAAW,CAAC,MAAgD,CAAA;AAMlG,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4BnE,CAAA;AAKD,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,aAAa,CAWnD,CAAA;AAMD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CA0BhE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,OAAM,MAAW,KAAG,OAAO,CAAC,aAAa,CAUhF,CAAA"}
+{"version":3,"file":"engine-modules.d.ts","sourceRoot":"","sources":["../src/engine-modules.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAG7E,mBAAmB,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAE3E,eAAe,EAAE,MAAM,CAAC;IAGxB,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAG3C,cAAc,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAC9C,CAAA;AASD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,mBAAmB,CAAA;IACzB,WAAW,EAAE,0BAA0B,CAAA;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C,CAAA;AAGD,oBAAY,mBAAmB;IAAE,WAAW,IAAI;IAAE,UAAU,IAAI;CAAC;AAGjE,oBAAY,0BAA0B;IAAE,SAAS,IAAI;IAAE,MAAM,IAAI;IAAE,SAAS,IAAI;CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG;IACxB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAA;IAChC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAChD,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACrC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACxC,gBAAgB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CACvD,CAAA;AAQD,eAAO,MAAM,kBAAkB,QAAO,WAAW,CAAC,MAAgD,CAAA;AAMlG,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6BnE,CAAA;AAKD,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,aAAa,CAWnD,CAAA;AAMD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CA0BhE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,OAAM,MAAW,KAAG,OAAO,CAAC,aAAa,CAUhF,CAAA"}

package/dist/engine-modules.js

@@ -49,6 +49,7 @@ export const DEVICES = [
     { url: "/wasm/plugins/device_reverb.wasm", boxType: "ReverbDeviceBox" }, // audio effect
     { url: "/wasm/plugins/device_dattorro_reverb.wasm", boxType: "DattorroReverbDeviceBox" }, // audio effect
     { url: "/wasm/plugins/device_soundfont.wasm", boxType: "SoundfontDeviceBox" }, // instrument (preset sampler)
+    { url: "/wasm/plugins/device_cubed.wasm", boxType: "CubedDeviceBox" }, // instrument (303-style bassline)
     { url: "/wasm/plugins/device_vocoder.wasm", boxType: "VocoderDeviceBox" }, // audio effect (channel vocoder + sidechain)
     { url: "/wasm/plugins/device_neural_amp.wasm", boxType: "NeuralAmpDeviceBox" }, // audio effect (NAM, via the nam bridge)
     { url: "/wasm/plugins/device_autotune.wasm", boxType: "AutotuneDeviceBox" }, // audio effect (pitch correction, PSOLA)

package/dist/script-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-bridge.d.ts","sourceRoot":"","sources":["../src/script-bridge.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,YAAY;IACzB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACxC;AAsDD,qBAAa,aAAa;;gBASV,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EACpE,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAe;IAQzE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;IA+M/D,eAAe,IAAI,MAAM;CAG5B"}
+{"version":3,"file":"script-bridge.d.ts","sourceRoot":"","sources":["../src/script-bridge.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,YAAY;IACzB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACxC;AAyDD,qBAAa,aAAa;;gBASV,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EACpE,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAe;IAQzE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;IAoN/D,eAAe,IAAI,MAAM;CAG5B"}

package/dist/script-bridge.js

@@ -12,7 +12,7 @@
 // views EVERY call, since the SharedArrayBuffer can grow / detach (talc), never caching a typed-array view.
 import { isDefined, UUID, ValueMapping } from "@opendaw/lib-std";
 import { SimpleLimiter } from "@opendaw/lib-dsp";
-import { runSpielwerk, SpielwerkRuntime } from "./script-spielwerk";
+import { copyEvents, runSpielwerk, SpielwerkRuntime } from "./script-spielwerk";
 const RENDER_QUANTUM = 128;
 // ~1 second of render calls (128-frame quanta at 48k) before a scriptless device is reported — long enough to
 // cover a script still compiling / addModule-ing async, short enough to surface a genuine misconfiguration.
@@ -49,6 +49,9 @@ class Bridge {
     sampleHandles = new Map(); // index -> resolved engine sample handle (-1 = no sample; 0 is valid)
     limiter = null;
     spielwerk = null;
+    // Spielwerk's `@no-pass` verdict for the CURRENTLY loaded script. `true` by default so a device whose script
+    // never loaded (or died) forwards its input instead of muting the chain.
+    pass = true;
     // A scriptable device with no registered Processor renders silence. That is legitimate for a block or two
     // while the script loads async, but a device that stays scriptless is an anomaly the host must surface (not
     // swallow). Count the render calls that found no registry entry; warn ONCE past the grace window.
@@ -143,6 +146,8 @@ export class ScriptBridges {
             return null;
         }
         if (registry !== undefined && registry.update !== bridge.currentUpdate) {
+            // Outside the try: a script that throws in its constructor still gets ITS declared note routing.
+            bridge.pass = registry.pass !== false;
             try {
                 const proc = new registry.create();
                 bridge.paramMappings = new Map(registry.params.map(declaration => [declaration.index, { label: declaration.label, mapping: resolveMapping(declaration) }]));
@@ -277,16 +282,19 @@ export class ScriptBridges {
         if (bridge === undefined) {
             return 0;
         }
+        // No live Processor (never loaded, or silenced): forward the input, so a scriptless / broken Spielwerk
+        // is transparent rather than a mute button. A `@no-pass` script keeps its silence, as its author asked.
+        const forward = () => bridge.pass ? copyEvents(this.#memory.buffer, inPtr, inCount, outPtr, outMax) : 0;
         const proc = this.#ensureProc(bridge);
         if (proc === null || bridge.spielwerk === null) {
-            return 0;
+            return forward();
         }
         try {
-            return runSpielwerk(bridge.spielwerk, proc, this.#memory.buffer, inPtr, inCount, outPtr, outMax, from, to, bpm, flags, s0, s1);
+            return runSpielwerk(bridge.spielwerk, proc, this.#memory.buffer, inPtr, inCount, outPtr, outMax, from, to, bpm, flags, s0, s1, bridge.pass);
         }
         catch (error) {
             this.#silence(bridge, `Runtime error: ${error}`);
-            return 0;
+            return forward();
         }
     }
     // Resolve a sample handle's resident planar frames and hand the user proc an AudioData view (no copy).

package/dist/script-spielwerk.d.ts

@@ -19,6 +19,7 @@ export declare class SpielwerkRuntime {
     readonly sourceToOutput: Map<number, Set<number>>;
     reset(): void;
 }
-export declare const runSpielwerk: (runtime: SpielwerkRuntime, proc: any, memory: ArrayBufferLike, inPtr: number, inCount: number, outPtr: number, outMax: number, from: number, to: number, bpm: number, flags: number, s0: number, s1: number) => number;
+export declare const copyEvents: (memory: ArrayBufferLike, inPtr: number, inCount: number, outPtr: number, outMax: number) => number;
+export declare const runSpielwerk: (runtime: SpielwerkRuntime, proc: any, memory: ArrayBufferLike, inPtr: number, inCount: number, outPtr: number, outMax: number, from: number, to: number, bpm: number, flags: number, s0: number, s1: number, pass: boolean) => number;
 export {};
 //# sourceMappingURL=script-spielwerk.d.ts.map

package/dist/script-spielwerk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script-spielwerk.d.ts","sourceRoot":"","sources":["../src/script-spielwerk.ts"],"names":[],"mappings":"AAgBA,KAAK,aAAa,GAAG;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AACxG,KAAK,YAAY,GAAG;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AAKnH,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAK;IACxC,QAAQ,CAAC,cAAc,2BAAiC;IAExD,KAAK,IAAI,IAAI;CAKhB;AA6BD,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB,EAAE,MAAM,GAAG,EAAE,QAAQ,eAAe,EAC7D,OAAO,MAAM,EAAE,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,EAC9D,MAAM,MAAM,EAAE,IAAI,MAAM,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,KAAG,MA0F3G,CAAA"}
+{"version":3,"file":"script-spielwerk.d.ts","sourceRoot":"","sources":["../src/script-spielwerk.ts"],"names":[],"mappings":"AAuBA,KAAK,aAAa,GAAG;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AACxG,KAAK,YAAY,GAAG;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AAKnH,qBAAa,gBAAgB;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAK;IACtC,QAAQ,CAAC,SAAS,EAAE,aAAa,EAAE,CAAK;IACxC,QAAQ,CAAC,cAAc,2BAAiC;IAExD,KAAK,IAAI,IAAI;CAKhB;AAgBD,eAAO,MAAM,UAAU,GAAI,QAAQ,eAAe,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,EACvD,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG,MAI3D,CAAA;AAiBD,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB,EAAE,MAAM,GAAG,EAAE,QAAQ,eAAe,EAC7D,OAAO,MAAM,EAAE,SAAS,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,EAC9D,MAAM,MAAM,EAAE,IAAI,MAAM,EAAE,KAAK,MAAM,EAAE,OAAO,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,EAC5E,MAAM,OAAO,KAAG,MAoG5C,CAAA"}

package/dist/script-spielwerk.js

@@ -1,8 +1,10 @@
 // Spielwerk's stateful note-transform orchestration (mirrors the TS `SpielwerkDeviceProcessor.processNotes`),
 // run JS-side by the script bridge. It reads the upstream input `EventRecord`s the device pulled (note-on /
-// note-off), builds the `UserEvent` stream, runs the user generator `*process(block, events)`, validates each
-// yielded note, schedules future-block notes, and correlates note-on -> note-off via a retainer so it can emit
-// the stops. The persistent state (retainer + scheduler) lives in `SpielwerkRuntime` across blocks.
+// note-off), FORWARDS them verbatim unless the script declared `// @no-pass`, builds the `UserEvent` stream,
+// runs the user generator `*process(block, events)`, validates each yielded note, schedules future-block notes,
+// and correlates note-on -> note-off via a retainer so it can emit the stops. Forwarded notes are NOT retained:
+// their note-off arrives from upstream. The persistent state (retainer + scheduler) lives in `SpielwerkRuntime`
+// across blocks.
 //
 // EventRecord (abi, 40 bytes, little-endian): position f64@0, offset u32@8, kind u32@12, id u32@16,
 // pitch u32@20, velocity f32@24, cent f32@28, duration f64@32. kind: 0 = note-on, 1 = note-off. `duration` is
@@ -12,6 +14,11 @@ const KIND_NOTE_ON = 0;
 const KIND_NOTE_OFF = 1;
 const MAX_NOTES_PER_BLOCK = 128;
 const MAX_SCHEDULED_NOTES = 128;
+// Forwarded input records keep their UPSTREAM ids, so the ids this device MINTS must live in a disjoint range:
+// the consumer matches a note-off to its voice by id, and a collision would stop the wrong note.
+const GENERATED_ID_BASE = 0x4000_0000;
+const GENERATED_ID_MASK = 0x3fff_ffff;
+const FLAG_DISCONTINUOUS = 1 << 1; // mirrors abi `BlockFlags::DISCONTINUOUS`: a loop wrap or a seek
 let nextOutputId = 1;
 // One Spielwerk instance's cross-block state.
 export class SpielwerkRuntime {
@@ -35,6 +42,13 @@ const writeRecord = (view, slot, kind, position, id, pitch, velocity, cent, dura
     view.setFloat32(base + 28, cent, true);
     view.setFloat64(base + 32, duration, true);
 };
+// Forward the pulled input records UNCHANGED (id, position, duration, pitch, velocity, cent). Used both as the
+// pass-through prologue of a run and as the fallback when there is no live Processor to run at all.
+export const copyEvents = (memory, inPtr, inCount, outPtr, outMax) => {
+    const count = Math.min(inCount, outMax);
+    new Uint8Array(memory, outPtr, count * RECORD_SIZE).set(new Uint8Array(memory, inPtr, count * RECORD_SIZE));
+    return count;
+};
 const validateNote = (note, from) => {
     if (note === undefined || note === null) {
         return "process yielded undefined";
@@ -67,16 +81,27 @@ const validateNote = (note, from) => {
 };
 // Run one pulled range through the user generator + tracking, writing output records, returning the count.
 // Throws on a script error / validation failure / flood (the bridge catches it and silences).
-export const runSpielwerk = (runtime, proc, memory, inPtr, inCount, outPtr, outMax, from, to, bpm, flags, s0, s1) => {
+export const runSpielwerk = (runtime, proc, memory, inPtr, inCount, outPtr, outMax, from, to, bpm, flags, s0, s1, pass) => {
     const input = new DataView(memory, inPtr, inCount * RECORD_SIZE);
     const out = new DataView(memory, outPtr, outMax * RECORD_SIZE);
-    let outCount = 0;
+    // Pass-through prologue: the input goes out verbatim (the output is still empty, so one bulk copy), and the
+    // generator's yields are ADDED on top. `@no-pass` scripts skip this and own the output alone.
+    let outCount = pass ? copyEvents(memory, inPtr, inCount, outPtr, outMax) : 0;
     const emit = (kind, position, id, pitch, velocity, cent, duration) => {
         if (outCount >= outMax) {
             throw new Error(`Note flood: exceeded ${outMax} output notes per range`);
         }
         writeRecord(out, outCount++, kind, position, id, pitch, velocity, cent, duration);
     };
+    // A transport JUMP (loop wrap / seek) releases EVERYTHING held, at `from` — the contract the engine's own
+    // note source honours (`NoteSequencer::process_notes`). Without it a note whose span reaches past the loop
+    // end never sees its end position again and the downstream instrument holds that voice forever.
+    if ((flags & FLAG_DISCONTINUOUS) !== 0) {
+        for (const note of runtime.retained) {
+            emit(KIND_NOTE_OFF, from, note.id, note.pitch, 0, 0, 0);
+        }
+        runtime.reset();
+    }
     // Release retained notes whose span completed within this range, emitting their note-off.
     for (let i = runtime.retained.length - 1; i >= 0; i--) {
         const note = runtime.retained[i];
@@ -173,7 +198,7 @@ export const runSpielwerk = (runtime, proc, memory, inPtr, inCount, outPtr, outM
     return outCount;
 };
 const retain = (runtime, note) => {
-    const id = nextOutputId++;
+    const id = GENERATED_ID_BASE + (nextOutputId++ & GENERATED_ID_MASK);
     runtime.retained.push({ id, position: note.position, duration: note.duration, pitch: note.pitch, velocity: note.velocity, cent: note.cent });
     return id;
 };