@effetune/dsp 0.5.0 → 0.7.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.5.0 exposes all 90 catalog types through the generic Chain and
-`createEffect` APIs and 90 generated named convenience classes,
+Version 0.7.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 -->
 
@@ -139,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:
 
@@ -167,24 +168,25 @@ 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 90 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
+### Modulation system-preset 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
+The application exposes these settings as system presets. The following
+JSON-compatible objects are their 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.
 
@@ -229,8 +231,8 @@ const MODULATION_STYLES = {
     "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 }
+    "Vintage Rotor Slow": { speedState: "Slow", speed: 100, acceleration: 2.8, crossover: 800, rotorBalance: -5, stereoWidth: 80, dopplerDepth: 50, amplitudeDepth: 60, mix: 75 },
+    "Vintage Rotor Fast": { speedState: "Fast", speed: 100, acceleration: 1.8, crossover: 800, rotorBalance: -5, stereoWidth: 90, dopplerDepth: 70, amplitudeDepth: 75, mix: 82 }
   }
 };
 ```

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

@@ -1,11 +1,11 @@
 {
   "abiVersion": 1,
-  "sourceDigest": "sha256:00067361c0a5d99d45cf1d82c9bf6551d0403f895a8fa49ca21a6c79baf5c4d1",
+  "sourceDigest": "sha256:df1bbb523b8c25f3733a6a948c648f3cf627b7e73d576b911c409900e81fbea5",
   "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:b50736a00940789be0f1ac4cfb8ab918c1ac1226fb9223703c0847d50b82d9e6",
+    "digest": "sha256:e7e32b3616dc0bafdee4e807e9aceae8d4afe1aeb2bf41346aa0c8255a26a8e7",
     "inputs": [
       {
         "id": "dsp/core/abi.cpp",
@@ -15,7 +15,7 @@
       {
         "id": "dsp/core/allocation_guard.cpp",
         "kind": "file",
-        "sha256": "sha256:95462089e6f7069ef80bf82e1ef49c841f0afe1a796b4ddb9151198bb403d93f"
+        "sha256": "sha256:69dd284b57f2704580778028a33d05f683fa8d5674de22b4aa094c2254475049"
       },
       {
         "id": "dsp/core/allocation_guard.h",
@@ -25,7 +25,7 @@
       {
         "id": "dsp/core/arena.cpp",
         "kind": "file",
-        "sha256": "sha256:2de46fb659bd4327d2f241dbf28529c4adff78b5a69bba7c4c28e77593857ffd"
+        "sha256": "sha256:9b2795ac6f44ab7cc7708d6f831f180b4df73ebff438e16745519cf00be4f4be"
       },
       {
         "id": "dsp/core/arena.h",
@@ -35,12 +35,12 @@
       {
         "id": "dsp/core/engine.cpp",
         "kind": "file",
-        "sha256": "sha256:be4717516d9fb48de4a4fb68f5338a490ac4a060c571a22237514f311c2c1126"
+        "sha256": "sha256:04c3257634399acfadf9ee258be827ee26fce0a86d8189397f0d4bae245b1343"
       },
       {
         "id": "dsp/core/engine.h",
         "kind": "file",
-        "sha256": "sha256:373b70d2e7f6925a79c13e067719b40b36539567d26bf6f3d8df575641e47239"
+        "sha256": "sha256:7a6dab8dcc980bc0535c2571942e0674fe96eba7c3053b6c97460ea2c8807c97"
       },
       {
         "id": "dsp/core/registry.cpp",
@@ -95,7 +95,7 @@
       {
         "id": "dsp/include/effetune/kernel.h",
         "kind": "file",
-        "sha256": "sha256:89f9d73a1ccd78c995487605ae285f4f522ccc126e64659d0d2fb2f8ae7ac29e"
+        "sha256": "sha256:077893c235793dd2a250404672bbee43f18e91fd0e24753b96fddc846dc853ff"
       },
       {
         "id": "dsp/include/effetune/telemetry.h",
@@ -115,7 +115,7 @@
       {
         "id": "dsp/plugins/lofi/g726_adpcm_simulator/params.json",
         "kind": "file",
-        "sha256": "sha256:fccbe3d6b852a1f29f86a1f3d1cc6acf855dbfa7d4472cbb2c211abd52ccd61f"
+        "sha256": "sha256:128c5eb52ac4eecd786065ecc778005a88fef91fb8fb7ea49e74028415f2b5dc"
       },
       {
         "id": "dsp/registry.inc#G726ADPCMSimulatorPlugin-entry",
@@ -160,7 +160,7 @@
       {
         "id": "tools/dsp-parity/runners.mjs",
         "kind": "file",
-        "sha256": "sha256:2149fe3fd23139997563d401277b0ea5cdc1b893d310f970fc4e5f9b8517d11c"
+        "sha256": "sha256:cd67baecc50e260dddedb992f50de963caecf9ec7c6fc76bbf415b3fd4b478ec"
       },
       {
         "id": "tools/dsp-parity/stimuli.mjs",
@@ -454,7 +454,7 @@
     },
     {
       "name": "MultiChannelPanelPlugin",
-      "hash": 4191368224,
+      "hash": 2638026937,
       "byteCapacity": 0,
       "assets": []
     },
@@ -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,
@@ -968,7 +987,7 @@
     },
     {
       "name": "PhaseSelectEqPlugin",
-      "hash": 4158366201,
+      "hash": 1371985786,
       "byteCapacity": 0,
       "assets": []
     },
@@ -980,7 +999,7 @@
     }
   ],
   "sizes": {
-    "baseline": 975148,
-    "simd": 1071488
+    "baseline": 1170211,
+    "simd": 1291175
   }
 }

package/dist/assets.js

@@ -138,11 +138,11 @@ function inferEta1Format(bytes, reference) {
   const topology = header.getUint32(16, true);
   const pathCount = header.getUint32(20, true);
   if (header.getUint32(0, true) !== 0x31415445 ||
-      channels < 1 || channels > 8 ||
+      channels < 1 || channels > 16 ||
       frames < 1 || frames > 8388600 ||
       sampleRate < 1 ||
       topology > IR_ASSET_TOPOLOGY.matrix ||
-      pathCount > 8 ||
+      pathCount > 16 ||
       header.getUint32(24, true) !== 0 ||
       header.getUint32(28, true) !== 0) {
     throw new AssetError(`Asset ${reference} has an invalid ETA1 header.`);
@@ -232,8 +232,8 @@ async function resolverResult(resolver, reference, descriptor, effectId) {
 }
 
 function validatePaths(paths, channels) {
-  if (!Array.isArray(paths) || paths.length < 1 || paths.length > 8) {
-    throw new AssetError('Matrix impulse responses require between 1 and 8 paths.');
+  if (!Array.isArray(paths) || paths.length < 1 || paths.length > 16) {
+    throw new AssetError('Matrix impulse responses require between 1 and 16 paths.');
   }
   const normalized = paths.map(path => {
     if (!isRecord(path) ||
@@ -247,8 +247,8 @@ function validatePaths(paths, channels) {
     const outputSlot = path?.outputSlot;
     const irChannel = path?.irChannel;
     if (![inputSlot, outputSlot, irChannel].every(Number.isSafeInteger) ||
-        inputSlot < 0 || inputSlot > 7 ||
-        outputSlot < 0 || outputSlot > 7 ||
+        inputSlot < 0 || inputSlot > 15 ||
+        outputSlot < 0 || outputSlot > 15 ||
         irChannel < 0 || irChannel >= channels) {
       throw new AssetError('Matrix impulse-response paths contain an invalid channel or slot.');
     }
@@ -288,8 +288,8 @@ export function encodeEta1(options) {
     throw new AssetError('ETA1 encoding options must be an object.');
   }
   const { channels, sampleRate, topology = 'unspecified', paths } = options;
-  if (!Array.isArray(channels) || channels.length < 1 || channels.length > 8) {
-    throw new AssetError('ETA1 channels must contain between 1 and 8 Float32Array values.');
+  if (!Array.isArray(channels) || channels.length < 1 || channels.length > 16) {
+    throw new AssetError('ETA1 channels must contain between 1 and 16 Float32Array values.');
   }
   const frames = channels[0] instanceof Float32Array ? channels[0].length : 0;
   if (frames < 1) {
@@ -345,7 +345,7 @@ function normalizeFormatMetadata(format, byteLength, reference, options = {}) {
     throw new AssetError(`Asset ${reference} must use the ETA1 planar little-endian float32 format.`);
   }
   const { channels, frames, sampleRate } = format;
-  if (!Number.isInteger(channels) || channels < 1 || channels > 8 ||
+  if (!Number.isInteger(channels) || channels < 1 || channels > 16 ||
       !Number.isInteger(frames) || frames < 1 || frames > 8388600 ||
       !Number.isInteger(sampleRate) || sampleRate < 1 || sampleRate > 0xffffffff) {
     throw new AssetError(`Asset ${reference} has invalid channel, frame, or sample-rate metadata.`);
@@ -679,11 +679,11 @@ function prepareFirFilterAsset(effect, resolvedAssets, {
   let inputCount;
   if (effect.type === 'FIRCrossover') {
     const bandCount = effect.parameters.bandCount;
-    if (![4, 6, 8].includes(processingChannels) ||
+    if ((processingChannels < 4 || processingChannels > 16 || processingChannels % 2 !== 0) ||
         bandCount * 2 > processingChannels ||
         asset.format.channels !== bandCount) {
       throw new AssetError(
-        `${effect.id} requires 4, 6, or 8 processing channels and one filter channel per band.`
+        `${effect.id} requires an even number of processing channels from 4 to 16 and one filter channel per band.`
       );
     }
     topology = IR_ASSET_TOPOLOGY.matrix;
@@ -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;

package/dist/catalog/effects-v1.json

@@ -13,9 +13,21 @@
     "6",
     "7",
     "8",
+    "9",
+    "10",
+    "11",
+    "12",
+    "13",
+    "14",
+    "15",
+    "16",
     "34",
     "56",
-    "78"
+    "78",
+    "910",
+    "1112",
+    "1314",
+    "1516"
   ],
   "effects": [
     {
@@ -340,7 +352,7 @@
           "count": 1,
           "default": "0011",
           "maximumLength": 3072,
-          "pattern": "^(?:p?[0-8][0-8])*$"
+          "pattern": "^(?:p?[0-9a-f][0-9a-f])*$"
         }
       ],
       "seeded": false,
@@ -356,8 +368,16 @@
         {
           "name": "mute",
           "type": "boolean",
-          "count": 8,
+          "count": 16,
           "default": [
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
             false,
             false,
             false,
@@ -371,8 +391,16 @@
         {
           "name": "solo",
           "type": "boolean",
-          "count": 8,
+          "count": 16,
           "default": [
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
             false,
             false,
             false,
@@ -386,8 +414,16 @@
         {
           "name": "volume",
           "type": "number",
-          "count": 8,
+          "count": 16,
           "default": [
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
             0,
             0,
             0,
@@ -404,8 +440,16 @@
         {
           "name": "delay",
           "type": "number",
-          "count": 8,
+          "count": 16,
           "default": [
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
+            0,
             0,
             0,
             0,
@@ -422,8 +466,16 @@
         {
           "name": "link",
           "type": "boolean",
-          "count": 7,
+          "count": 15,
           "default": [
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
+            false,
             false,
             false,
             false,
@@ -2217,6 +2269,49 @@
         }
       ]
     },
+    {
+      "type": "GroupDelayPEQ",
+      "parameters": [
+        {
+          "name": "latencyMode",
+          "type": "string",
+          "count": 1,
+          "default": "128",
+          "values": [
+            "0",
+            "128",
+            "256",
+            "512",
+            "1024"
+          ]
+        },
+        {
+          "name": "filterDelaySamples",
+          "type": "integer",
+          "count": 1,
+          "default": 8192,
+          "minimum": 0,
+          "maximum": 65536
+        }
+      ],
+      "seeded": true,
+      "telemetry": [],
+      "latency": {
+        "kind": "dynamic",
+        "dependsOn": [
+          "latencyMode",
+          "filterDelaySamples",
+          "impulseResponse"
+        ]
+      },
+      "assets": [
+        {
+          "name": "impulseResponse",
+          "kind": "impulseResponse",
+          "required": true
+        }
+      ]
+    },
     {
       "type": "HiPassFilter",
       "parameters": [
@@ -3517,6 +3612,59 @@
       },
       "assets": []
     },
+    {
+      "type": "MDSimulator",
+      "parameters": [
+        {
+          "name": "mode",
+          "type": "string",
+          "count": 1,
+          "default": "SP (292 kbps)",
+          "values": [
+            "SP (292 kbps)",
+            "LP2 (132 kbps)",
+            "LP4 (66 kbps)"
+          ]
+        },
+        {
+          "name": "outputGain",
+          "type": "number",
+          "count": 1,
+          "default": 0,
+          "unit": "dB",
+          "minimum": -24,
+          "maximum": 12
+        },
+        {
+          "name": "mix",
+          "type": "number",
+          "count": 1,
+          "default": 100,
+          "unit": "%",
+          "minimum": 0,
+          "maximum": 100
+        }
+      ],
+      "seeded": false,
+      "sampleRates": [
+        44100,
+        48000,
+        88200,
+        96000,
+        176400,
+        192000,
+        352800,
+        384000
+      ],
+      "telemetry": [],
+      "latency": {
+        "kind": "sampleRateDependent",
+        "dependsOn": [
+          "sampleRate"
+        ]
+      },
+      "assets": []
+    },
     {
       "type": "MP3CodecSimulator",
       "parameters": [
@@ -4050,7 +4198,7 @@
           "name": "noiseProfile",
           "type": "number",
           "count": 1,
-          "default": 0,
+          "default": 10,
           "minimum": 0,
           "maximum": 10
         },
@@ -5268,7 +5416,7 @@
           "name": "waveguideGain",
           "type": "number",
           "count": 1,
-          "default": 30,
+          "default": 26,
           "unit": "dB",
           "minimum": -36,
           "maximum": 36
@@ -5350,7 +5498,7 @@
           "name": "waveguideGain",
           "type": "number",
           "count": 1,
-          "default": 30,
+          "default": 26,
           "unit": "dB",
           "minimum": -36,
           "maximum": 36
@@ -5877,7 +6025,7 @@
           "maximum": 100
         }
       ],
-      "seeded": true,
+      "seeded": false,
       "telemetry": [],
       "latency": {
         "kind": "zero"
@@ -6865,6 +7013,78 @@
           "unit": "%",
           "minimum": 0,
           "maximum": 200
+        },
+        {
+          "name": "regionSolo",
+          "type": "boolean",
+          "count": 5,
+          "default": [
+            false,
+            false,
+            false,
+            false,
+            false
+          ]
+        },
+        {
+          "name": "outerBalanceLow",
+          "type": "number",
+          "count": 5,
+          "default": [
+            -100,
+            -100,
+            -100,
+            -100,
+            -100
+          ],
+          "unit": "%",
+          "minimum": -100,
+          "maximum": 100
+        },
+        {
+          "name": "coreBalanceLow",
+          "type": "number",
+          "count": 5,
+          "default": [
+            -100,
+            -100,
+            -100,
+            -100,
+            -100
+          ],
+          "unit": "%",
+          "minimum": -100,
+          "maximum": 100
+        },
+        {
+          "name": "coreBalanceHigh",
+          "type": "number",
+          "count": 5,
+          "default": [
+            100,
+            100,
+            100,
+            100,
+            100
+          ],
+          "unit": "%",
+          "minimum": -100,
+          "maximum": 100
+        },
+        {
+          "name": "outerBalanceHigh",
+          "type": "number",
+          "count": 5,
+          "default": [
+            100,
+            100,
+            100,
+            100,
+            100
+          ],
+          "unit": "%",
+          "minimum": -100,
+          "maximum": 100
         }
       ],
       "seeded": false,
@@ -6899,7 +7119,7 @@
     }
   ],
   "contractDigests": {
-    "publicCatalogSha256": "1f7621279e4fd1cae842bda2498e76f8afbdd2c05990b246732947b520818d62",
-    "privateLayoutSha256": "e63194ca2bd43f224ade8e5b387a89f68678c9e8c838f4a8faca600a61521c84"
+    "publicCatalogSha256": "0f8926c820f825d87f212d7c7fbfa75044caf7aa912bef6a78cc85f820b899c0",
+    "privateLayoutSha256": "61121eb6aec4b52d5492795c2ac81bd4cecfa119b7bfc4e6956fd2b725690685"
   }
 }

package/dist/denormal-noise.js

@@ -0,0 +1,15 @@
+export const DENORMAL_NOISE_AMPLITUDE = 1e-19;
+
+export function addDenormalNoise(audio, channelCount, frameCount, frameOrigin) {
+  const first = (frameOrigin & 1) === 0
+    ? DENORMAL_NOISE_AMPLITUDE
+    : -DENORMAL_NOISE_AMPLITUDE;
+  for (let channel = 0; channel < channelCount; channel++) {
+    const offset = channel * frameCount;
+    let noise = first;
+    for (let frame = 0; frame < frameCount; frame++) {
+      audio[offset + frame] += noise;
+      noise = -noise;
+    }
+  }
+}