@effetune/dsp 0.4.0 → 0.6.0

package/README.md

@@ -3,8 +3,8 @@
 <!-- BEGIN DSP-LIBRARY-JAVASCRIPT-SUMMARY -->
 EffeTune DSP provides the same MIT-licensed C++ audio kernels used by EffeTune
 as a self-contained WebAssembly package for Node.js and evergreen browsers.
-Version 0.4.0 exposes all 83 catalog types through the generic Chain and
-`createEffect` APIs and 83 generated named convenience classes,
+Version 0.6.0 exposes all 92 catalog types through the generic Chain and
+`createEffect` APIs and 92 generated named convenience classes,
 decoded analyzer telemetry, versioned semantic presets, deterministic seeds, and an AudioWorklet wrapper.
 <!-- END DSP-LIBRARY-JAVASCRIPT-SUMMARY -->
 
@@ -39,6 +39,44 @@ const output = await chain.process(input, { sampleRate: 48000 });
 console.log(output.length, output[0].length, output[0][0]);
 chain.close();
 ```
+
+### Graph v1 quickstart
+
+Graph v1 is opt-in routing for branching and merging:
+
+```js
+import { Graph, createGraph, createVolume } from '@effetune/dsp';
+
+const input = [
+  new Float32Array(128).fill(0.25),
+  new Float32Array(128).fill(0.25)
+];
+const graphDocument = Graph.wetDry(
+  createVolume({ id: 'wet', volume: -6 }),
+  { dry: 0.5, wet: 0.5 }
+);
+const graph = await createGraph(graphDocument);
+let stream;
+
+try {
+  const offline = await graph.process(input, { sampleRate: 48000 });
+  stream = await graph.stream({
+    sampleRate: 48000,
+    channels: 2,
+    blockSize: 128
+  });
+  const continuous = await stream.process(input);
+  console.log(
+    offline[0][0],
+    continuous[0][0],
+    stream.latencySamples,
+    stream.compileSnapshot.effectiveSchedule
+  );
+} finally {
+  stream?.close();
+  graph.close();
+}
+```
 <!-- END DSP-LIBRARY-JAVASCRIPT-START -->
 
 The package is ESM-only. Save the example as `start.mjs` and run
@@ -51,10 +89,14 @@ Public package entry points are:
 - `@effetune/dsp/worklet` for `EffeTuneNode`
 - `@effetune/dsp/processor` for the side-effect AudioWorklet processor
 - `@effetune/dsp/schemas/chain-v1.json` for the Chain v1 JSON Schema
+- `@effetune/dsp/schemas/graph-v1.json` for the Graph v1 JSON Schema
 - `@effetune/dsp/schemas/bundle-v1.json` for the Bundle v1 JSON Schema
 - `@effetune/dsp/catalog` for ESM catalog exports
 - `@effetune/dsp/catalog.json` for the machine-readable catalog JSON
 
+Graph v1 is opt-in. Its current capacities and delay-storage accounting are
+published in the [Graph v1 guide](https://effetune.frieve.com/dsp/reference/graph-v1/#capacity).
+
 Every offline `process()` call starts from fresh DSP state and returns newly
 owned `Float32Array` channels. Input arrays are never mutated. Effects run in
 array order; a disabled effect and an empty chain are identity operations.
@@ -97,8 +139,9 @@ seed, and DSP state from stream creation.
 assets to be staged again. Open a new stream after changing
 `IRReverb.channelMode`, `latency`, or `convolutionRate`;
 `FIRCrossover.bandCount`, `latencyMode`, or `filterDelaySamples`; or
-`latencyMode` / `filterDelaySamples` on `FiveBandFIRPEQ`, `GroupDelayEQ`, or
-`RoomEQ`. The same restriction applies to `EffeTuneNode.setParam()`.
+`latencyMode` / `filterDelaySamples` on `FiveBandFIRPEQ`, `GroupDelayEQ`,
+`GroupDelayPEQ`, or `RoomEQ`. The same restriction applies to
+`EffeTuneNode.setParam()`.
 
 Canonical presets use semantic long parameter names:
 
@@ -125,24 +168,83 @@ Move or copy the desired effects into one serial path in the app and export it
 again, or reproduce the branching in the host around separate Chains.
 Unsupported fields produce a validation error.
 
-FIR Crossover, Five Band FIR PEQ, Group Delay EQ, IR Reverb, and Room EQ
-require an `assets.impulseResponse` reference and an `assetResolver`. The four
-FIR filter effects use prepared coefficient impulses at the processing sample
-rate. Use the public `encodeEta1({ channels, sampleRate, topology, paths })`
+FIR Crossover, Five Band FIR PEQ, Group Delay EQ, Group Delay PEQ, IR Reverb,
+and Room EQ require an `assets.impulseResponse` reference and an
+`assetResolver`. The five FIR filter effects use prepared coefficient impulses
+at the processing sample rate. Use the public
+`encodeEta1({ channels, sampleRate, topology, paths })`
 helper to encode raw planar float32 arrays for a resolver. Bundle manifests
 verify exact byte length and SHA-256 before accepting an ETA1 payload. The
 complete payload and convolution footprint must fit the 32 MiB kernel cap.
 
 `EFFECT_CATALOG` and `getEffectCatalog()` expose the machine-readable semantic
-catalog for all 83 root classes and their `create<Type>()` factories. The
+catalog for all 92 root classes and their `create<Type>()` factories. The
 catalog contains channel choices, parameters, required assets, telemetry, and
 latency declarations, but no private implementation mapping.
 
+### Modulation Style recipes
+
+The application-only **Style** selector is not a DSP parameter or a second
+preset API. The following JSON-compatible objects are the equivalent public
+parameter dictionaries. Copy one into a named constructor, for example
+`new Chorus(MODULATION_STYLES.Chorus.Flanger)`, or into a Chain effect's
+`parameters` object.
+
+```js
+const MODULATION_STYLES = {
+  AutoFilter: {
+    "Auto Filter Sweep": { mode: "LFO", filterType: "Low-pass", minimumFrequency: 200, maximumFrequency: 4000, resonance: 1.5, mix: 80, rate: 0.5, waveform: "Sine", stereoPhase: 0, sensitivity: 24, attack: 20, release: 250, direction: "Up" },
+    "Stereo Filter Sweep": { mode: "LFO", filterType: "Low-pass", minimumFrequency: 160, maximumFrequency: 6000, resonance: 2, mix: 85, rate: 0.35, waveform: "Sine", stereoPhase: 120, sensitivity: 24, attack: 20, release: 250, direction: "Up" },
+    "Envelope Filter": { mode: "Envelope", filterType: "Low-pass", minimumFrequency: 100, maximumFrequency: 5000, resonance: 1.2, mix: 85, rate: 0.5, waveform: "Sine", stereoPhase: 0, sensitivity: 24, attack: 18, release: 300, direction: "Up" },
+    "Auto Wah": { mode: "Envelope", filterType: "Band-pass", minimumFrequency: 180, maximumFrequency: 2400, resonance: 5, mix: 100, rate: 0.5, waveform: "Sine", stereoPhase: 0, sensitivity: 30, attack: 8, release: 180, direction: "Up" },
+    "Reverse Auto Wah": { mode: "Envelope", filterType: "Band-pass", minimumFrequency: 180, maximumFrequency: 2800, resonance: 4, mix: 100, rate: 0.5, waveform: "Sine", stereoPhase: 0, sensitivity: 30, attack: 12, release: 350, direction: "Down" }
+  },
+  AutoPan: {
+    "Gentle Auto Pan": { rate: 0.35, depth: 45, center: 0, width: 70, waveform: "Sine", phase: 0 },
+    "Wide Auto Pan": { rate: 0.7, depth: 100, center: 0, width: 100, waveform: "Sine", phase: 0 },
+    "Fast Auto Pan": { rate: 4, depth: 85, center: 0, width: 100, waveform: "Triangle", phase: 0 }
+  },
+  Chorus: {
+    "Classic Chorus": { mode: "Chorus", rate: 0.8, delay: 12, depth: 3, voices: 3, stereoSpread: 60, feedback: 0, mix: 45 },
+    "Stereo Chorus": { mode: "Stereo Chorus", rate: 0.65, delay: 15, depth: 4, voices: 2, stereoSpread: 80, feedback: 0, mix: 50 },
+    Ensemble: { mode: "Ensemble", rate: 0.45, delay: 20, depth: 6, voices: 6, stereoSpread: 100, feedback: 0, mix: 60 },
+    Flanger: { mode: "Flanger", rate: 0.35, delay: 2.5, depth: 2, voices: 1, stereoSpread: 35, feedback: 45, mix: 50 },
+    "Jet Flanger": { mode: "Flanger", rate: 0.18, delay: 1.5, depth: 1.4, voices: 1, stereoSpread: 70, feedback: -75, mix: 55 },
+    Vibrato: { mode: "Vibrato", rate: 4.5, delay: 8, depth: 5, voices: 1, stereoSpread: 50, feedback: 0, mix: 100 }
+  },
+  FrequencyShifter: {
+    "Shift Up": { mode: "Shift", shift: 8, carrierFrequency: 440, minimumShift: 20, maximumShift: 800, rate: 0.15, direction: "Up", stereoPhase: 0, mix: 100 },
+    "Shift Down": { mode: "Shift", shift: -8, carrierFrequency: 440, minimumShift: 20, maximumShift: 800, rate: 0.15, direction: "Down", stereoPhase: 0, mix: 100 },
+    "Fine Detune": { mode: "Shift", shift: 2, carrierFrequency: 440, minimumShift: 20, maximumShift: 800, rate: 0.15, direction: "Up", stereoPhase: 90, mix: 55 },
+    "Ring Modulator": { mode: "Ring Mod", shift: 8, carrierFrequency: 440, minimumShift: 20, maximumShift: 800, rate: 0.15, direction: "Up", stereoPhase: 0, mix: 100 },
+    "Barber-pole Up": { mode: "Barber-pole", shift: 8, carrierFrequency: 440, minimumShift: 20, maximumShift: 900, rate: 0.12, direction: "Up", stereoPhase: 90, mix: 85 },
+    "Barber-pole Down": { mode: "Barber-pole", shift: -8, carrierFrequency: 440, minimumShift: 20, maximumShift: 900, rate: 0.12, direction: "Down", stereoPhase: 90, mix: 85 }
+  },
+  Phaser: {
+    "Classic Phaser": { mode: "Classic", rate: 0.5, centerFrequency: 1000, range: 3, stages: 6, feedback: 20, stereoPhase: 90, direction: "Up", mix: 50 },
+    "Deep Phaser": { mode: "Classic", rate: 0.25, centerFrequency: 700, range: 4.5, stages: 12, feedback: 55, stereoPhase: 30, direction: "Up", mix: 55 },
+    "Stereo Phaser": { mode: "Classic", rate: 0.65, centerFrequency: 1200, range: 3.5, stages: 8, feedback: 25, stereoPhase: 120, direction: "Up", mix: 50 },
+    "Barber-pole Up": { mode: "Barber-pole", rate: 0.35, centerFrequency: 1000, range: 5, stages: 8, feedback: 30, stereoPhase: 60, direction: "Up", mix: 55 },
+    "Barber-pole Down": { mode: "Barber-pole", rate: 0.35, centerFrequency: 1000, range: 5, stages: 8, feedback: 30, stereoPhase: 60, direction: "Down", mix: 55 }
+  },
+  RotarySpeaker: {
+    "Rotary Slow": { speedState: "Slow", speed: 100, acceleration: 2.2, crossover: 800, rotorBalance: 0, stereoWidth: 75, dopplerDepth: 45, amplitudeDepth: 55, mix: 70 },
+    "Rotary Fast": { speedState: "Fast", speed: 100, acceleration: 1.4, crossover: 800, rotorBalance: 0, stereoWidth: 85, dopplerDepth: 65, amplitudeDepth: 70, mix: 78 },
+    "Gentle Rotary": { speedState: "Slow", speed: 75, acceleration: 3, crossover: 900, rotorBalance: 0, stereoWidth: 45, dopplerDepth: 25, amplitudeDepth: 30, mix: 55 },
+    "Leslie Slow": { speedState: "Slow", speed: 100, acceleration: 2.8, crossover: 800, rotorBalance: -5, stereoWidth: 80, dopplerDepth: 50, amplitudeDepth: 60, mix: 75 },
+    "Leslie Fast": { speedState: "Fast", speed: 100, acceleration: 1.8, crossover: 800, rotorBalance: -5, stereoWidth: 90, dopplerDepth: 70, amplitudeDepth: 75, mix: 82 }
+  }
+};
+```
+
 For stateful processing, `ChainStream.latencySamples` reports aggregate runtime
 latency and matches Python `Stream.latency_samples` for the same chain and
 sample rate. `chain.latencySamples({ sampleRate })` reports the same value
-without opening a stream, which aligns offline `process()` output.
-`EffeTuneNode` does not expose a latency getter.
+without opening a stream. `EffeTuneNode.latencySamples` exposes the cached
+aggregate for real-time processing; initialization and awaited `setParam()` or
+`reset()` calls update it before returning. These APIs report latency without
+trimming or padding offline output, so the host decides how to place rendered
+audio.
 
 For real-time processing:
 
@@ -156,6 +258,7 @@ const node = await EffeTuneNode.create(context, preset, {
 });
 source.connect(node).connect(context.destination);
 await node.setParam('voice', 'threshold', -20);
+console.log(node.latencySamples);
 await node.reset();
 node.close();
 ```

package/dist/assets/effetune-dsp.meta.json

@@ -1,16 +1,16 @@
 {
   "abiVersion": 1,
-  "sourceDigest": "sha256:1e46f26d7a51f22747ce105a425cf83be4c71ed3f9b1342275cdff2bed6e0590",
+  "sourceDigest": "sha256:c00f5411a8fe68c2139dd6a5903e1f480229387a9e7057bd6e246fc2676cddec",
   "emsdkVersion": "6.0.2",
   "g726PerformanceInput": {
     "contract": "g726-production-performance-input-sha256-v2",
     "hashAlgorithm": "SHA-256 over the contract and ordered UTF-8 components as id\\0content\\0; CRLF and CR normalize to LF",
-    "digest": "sha256:2a3c283e9f45f68d561b2d651a8c73d78cab2a8f8cbc74f6f99ebcc64e408598",
+    "digest": "sha256:0dab4b4c5ba1de2a9998e5f2e8bee1b3d31b654b1029fa1be0c677ef6aa295d1",
     "inputs": [
       {
         "id": "dsp/core/abi.cpp",
         "kind": "file",
-        "sha256": "sha256:97e277947544bcb21015c9fe289af338fbe6f46b97dda233d24b594704bd2059"
+        "sha256": "sha256:ae52245f49287e6bf3345ba0860e65c7eb9d49fe61fabb0a3fb3459bb9eb6676"
       },
       {
         "id": "dsp/core/allocation_guard.cpp",
@@ -35,17 +35,17 @@
       {
         "id": "dsp/core/engine.cpp",
         "kind": "file",
-        "sha256": "sha256:49b8be2b35956dbd34c0cb46a48da64132b8b2b4395437ab3381755936fb4741"
+        "sha256": "sha256:2d492ff232ddc0d6b64843dba7a08d3f2834c9bb4b0ee923d9a93e2b71c29ec2"
       },
       {
         "id": "dsp/core/engine.h",
         "kind": "file",
-        "sha256": "sha256:5959f7d0bca55fb80c580d16cf7f22859db87b3d20a46f589d96f7682f80fd49"
+        "sha256": "sha256:373b70d2e7f6925a79c13e067719b40b36539567d26bf6f3d8df575641e47239"
       },
       {
         "id": "dsp/core/registry.cpp",
         "kind": "file",
-        "sha256": "sha256:64c18288f9be512826a01e93c387c9b0105fa716cdd36db5c01e9e9a757132b8"
+        "sha256": "sha256:1ca815678d0ecc13ee7dfd35f8c0af6b2ea1d4ff1e7100177349057b7ebbdcab"
       },
       {
         "id": "dsp/core/registry.h",
@@ -55,7 +55,7 @@
       {
         "id": "dsp/core/telemetry.cpp",
         "kind": "file",
-        "sha256": "sha256:515405f783c4b410567e6b44ec66abd68d1872361840e713518c4bf7425bca42"
+        "sha256": "sha256:a78cfe83117c9ea3714f0fe83e320e377165331c56627283f2193c78012514da"
       },
       {
         "id": "dsp/EMSDK_VERSION",
@@ -65,7 +65,7 @@
       {
         "id": "dsp/exports.txt",
         "kind": "file",
-        "sha256": "sha256:a80c7af5a36d703cae78efc96e7458d238cbff7a9ac86ffaecdb2e6d19d18735"
+        "sha256": "sha256:d9fafe26c1f1d23eaa4f38fa61073f992f34a0649e85eac39df9bd1dc8215342"
       },
       {
         "id": "dsp/generated/cpp/G726ADPCMSimulatorPluginParams.h",
@@ -75,7 +75,7 @@
       {
         "id": "dsp/include/effetune/abi.h",
         "kind": "file",
-        "sha256": "sha256:2e13c9f28ba46ec8a0397a003d360923ccb3367639918e0d24d02ed4f6726894"
+        "sha256": "sha256:18dcdc3fdd2af9de4b7acb27dacb3441b01a441e9447af1908efb69437b3909a"
       },
       {
         "id": "dsp/include/effetune/dsp/halfband.h",
@@ -115,7 +115,7 @@
       {
         "id": "dsp/plugins/lofi/g726_adpcm_simulator/params.json",
         "kind": "file",
-        "sha256": "sha256:a096e3cb9174c7650a7d024f3dc2c28506f8e1b98b879329cd8a9f5dc3d685ee"
+        "sha256": "sha256:d7ecbfdc5d087b12319c3501e685021b148cd0e21e4f87b36463cbffbabbc879"
       },
       {
         "id": "dsp/registry.inc#G726ADPCMSimulatorPlugin-entry",
@@ -130,17 +130,17 @@
       {
         "id": "js/audio/dsp-engine-binding.js",
         "kind": "file",
-        "sha256": "sha256:5186b3cd1a1d6897f644bfded4ad2f5542e09addf913e98f85b14a95825240e0"
+        "sha256": "sha256:4c0efb5c75ee0c051ba2fc0804f908d61363d077fec95f86f5b390a8eb031cc9"
       },
       {
         "id": "production-build#g726-resolved-authority",
         "kind": "derived",
-        "sha256": "sha256:083288185aaf9068f11cca8ffef3eefc2a68f8d9aab59f4a43bc2d141e2218be"
+        "sha256": "sha256:872376fbba212753fe6283376ec83125c55906cf51b746cebae39882acc2490d"
       },
       {
         "id": "production-build#g726-source-authority",
         "kind": "derived",
-        "sha256": "sha256:957f4ed2f398b92b5d6dce22cfabd431b8445dd0b66e3d0312c063c16e09447e"
+        "sha256": "sha256:2f0ae13c16cc15cd2953365a24f94d90cbe00ce65a525368a67a6855459affed"
       },
       {
         "id": "tools/dsp-parity/cases.mjs",
@@ -160,7 +160,7 @@
       {
         "id": "tools/dsp-parity/runners.mjs",
         "kind": "file",
-        "sha256": "sha256:83be9da46b7fdb60a469c853eb501d1a3a7eca7872b143a0d3e972a633229260"
+        "sha256": "sha256:fe1da8063d168c1b9f142a6217a097230bbf8783bd1d8f4bcb8ac807d78d862f"
       },
       {
         "id": "tools/dsp-parity/stimuli.mjs",
@@ -180,7 +180,7 @@
           "target_compile_options(pffft PRIVATE -msimd128)",
           "set_target_properties(pffft PROPERTIES POSITION_INDEPENDENT_CODE ON)",
           "target_link_libraries(pffft PUBLIC m)",
-          "target_include_directories( effetune_dsp_core PUBLIC include PRIVATE core generated/cpp)",
+          "target_include_directories( effetune_dsp_core PUBLIC include bindings/generated PRIVATE core generated/cpp)",
           "target_link_libraries(effetune_dsp_core PUBLIC pffft)",
           "target_compile_definitions( effetune_dsp_core PRIVATE $<$<BOOL:${ET_SIMD}>:ET_SIMD=1> $<$<BOOL:${ET_DEBUG_STATE}>:ET_DEBUG_STATE=1> $<$<CONFIG:Debug>:ET_DEBUG_BUILD=1> $<$<CONFIG:Debug>:ET_ALLOCATION_GUARD=1> $<$<AND:$<CONFIG:Debug>,$<NOT:$<CXX_COMPILER_ID:MSVC>>>:ET_WRAP_MALLOC=1> $<$<BOOL:${BUILD_TESTING}>:ET_ENABLE_TEST_KERNEL=1>)",
           "target_link_options( effetune_dsp_core INTERFACE $<$<AND:$<CONFIG:Debug>,$<NOT:$<CXX_COMPILER_ID:MSVC>>>:-Wl,--wrap=malloc>)",
@@ -222,7 +222,7 @@
             "-DBUILD_TESTING=OFF"
           ]
         },
-        "digest": "sha256:9f661f9436b7a66184aec1c77806dbfa36d5fe8ed156e4911a771fae4a0d95da"
+        "digest": "sha256:c2ea8f18f42afd6375341c9df08f4f21ef57a44875f540126eef084101ddef99"
       },
       "resolved": {
         "source": "configured CMake Ninja compile/link edges",
@@ -255,49 +255,49 @@
                 "source": "dsp/core/abi.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/allocation_guard.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/arena.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/engine.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/registry.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/telemetry.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/plugins/lofi/g726_adpcm_simulator/kernel.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/wasm/no_entry.cpp",
                 "definitions": "-DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/vendor/pffft/include/pffft"
               }
             ],
             "linkCommand": {
@@ -334,49 +334,49 @@
                 "source": "dsp/core/abi.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/allocation_guard.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/arena.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/engine.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/registry.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/core/telemetry.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/plugins/lofi/g726_adpcm_simulator/kernel.cpp",
                 "definitions": "-DET_ENABLE_LIFECYCLE_EXCEPTION_BOUNDARY=1 -DET_SIMD=1 -DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20 -Wall -Wextra -Wpedantic -Werror -fwasm-exceptions -fno-rtti -O3 -flto -msimd128",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/core -I<repo>/dsp/generated/cpp -I<repo>/dsp/vendor/pffft/include/pffft"
               },
               {
                 "source": "dsp/wasm/no_entry.cpp",
                 "definitions": "-DPFFFT_STATIC_DEFINE=1",
                 "flags": "-O3 -DNDEBUG -std=c++20",
-                "includes": "-I<repo>/dsp/include -I<repo>/dsp/vendor/pffft/include/pffft"
+                "includes": "-I<repo>/dsp/include -I<repo>/dsp/bindings/generated -I<repo>/dsp/vendor/pffft/include/pffft"
               }
             ],
             "linkCommand": {
@@ -386,7 +386,7 @@
             }
           }
         },
-        "digest": "sha256:49d590ffe39aeb113169fefad12d64eef03bd8125686fbed577ddb0f86b4f833"
+        "digest": "sha256:25a31669bb24da034d90512065fd746433745ead5d247e352c9ed08b3cbd24ea"
       }
     }
   },
@@ -622,6 +622,19 @@
         }
       ]
     },
+    {
+      "name": "GroupDelayPEQPlugin",
+      "hash": 2941825417,
+      "byteCapacity": 0,
+      "assets": [
+        {
+          "slot": 0,
+          "format": "ET_ASSET_F32_MULTICH",
+          "capacity": "32 MiB convolution cap",
+          "byteCapacity": 33554432
+        }
+      ]
+    },
     {
       "name": "HiPassFilterPlugin",
       "hash": 299011831,
@@ -731,6 +744,12 @@
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "MDSimulatorPlugin",
+      "hash": 2124600068,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "MP3CodecSimulatorPlugin",
       "hash": 3523139611,
@@ -773,18 +792,60 @@
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "AutoFilterPlugin",
+      "hash": 1612236675,
+      "byteCapacity": 0,
+      "assets": []
+    },
+    {
+      "name": "AutoPanPlugin",
+      "hash": 1469569767,
+      "byteCapacity": 0,
+      "assets": []
+    },
+    {
+      "name": "ChorusPlugin",
+      "hash": 2730690922,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "DopplerDistortionPlugin",
       "hash": 10372816,
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "FrequencyShifterPlugin",
+      "hash": 1854760556,
+      "byteCapacity": 0,
+      "assets": []
+    },
+    {
+      "name": "PhaserPlugin",
+      "hash": 2823426285,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "PitchShifterPlugin",
       "hash": 1998192054,
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "PitchShifterHQPlugin",
+      "hash": 3982397611,
+      "byteCapacity": 0,
+      "assets": []
+    },
+    {
+      "name": "RotarySpeakerPlugin",
+      "hash": 1430720979,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "TremoloPlugin",
       "hash": 1836520376,
@@ -835,7 +896,7 @@
     },
     {
       "name": "IRReverbPlugin",
-      "hash": 2199744560,
+      "hash": 2529061658,
       "byteCapacity": 0,
       "assets": [
         {
@@ -852,6 +913,12 @@
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "BandwidthExtenderPlugin",
+      "hash": 3030838001,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "DynamicSaturationPlugin",
       "hash": 3365051379,
@@ -896,7 +963,7 @@
     },
     {
       "name": "TubeSimulatorPlugin",
-      "hash": 3886736006,
+      "hash": 127429451,
       "byteCapacity": 0,
       "assets": []
     },
@@ -918,6 +985,12 @@
       "byteCapacity": 0,
       "assets": []
     },
+    {
+      "name": "PhaseSelectEqPlugin",
+      "hash": 1371985786,
+      "byteCapacity": 0,
+      "assets": []
+    },
     {
       "name": "StereoBlendPlugin",
       "hash": 648556109,
@@ -926,7 +999,7 @@
     }
   ],
   "sizes": {
-    "baseline": 801049,
-    "simd": 892774
+    "baseline": 1167544,
+    "simd": 1286159
   }
 }

package/dist/assets.js

@@ -705,6 +705,29 @@ function prepareFirFilterAsset(effect, resolvedAssets, {
            path.irChannel !== paths[index].irChannel))) {
       throw new AssetError(`${effect.id} filter paths do not match its band layout.`);
     }
+  } else if (effect.type === 'RoomEQ') {
+    const explicitTopology = asset.format.topology;
+    if (explicitTopology === IR_ASSET_TOPOLOGY.mono ||
+        (explicitTopology === IR_ASSET_TOPOLOGY.unspecified && asset.format.channels === 1)) {
+      topology = IR_ASSET_TOPOLOGY.mono;
+    } else if (explicitTopology === IR_ASSET_TOPOLOGY.independent ||
+               (explicitTopology === IR_ASSET_TOPOLOGY.unspecified &&
+                asset.format.channels === processingChannels)) {
+      topology = IR_ASSET_TOPOLOGY.independent;
+    } else {
+      throw new AssetError(
+        `${effect.id} requires either one shared filter channel or one filter channel per processing channel.`
+      );
+    }
+    assetChannels = asset.format.channels;
+    paths = [];
+    inputCount = 0;
+    if ((topology === IR_ASSET_TOPOLOGY.mono && assetChannels !== 1) ||
+        (topology === IR_ASSET_TOPOLOGY.independent && assetChannels !== processingChannels)) {
+      throw new AssetError(
+        `${effect.id} requires either one shared filter channel or one filter channel per processing channel.`
+      );
+    }
   } else {
     topology = IR_ASSET_TOPOLOGY.mono;
     assetChannels = 1;