@effetune/dsp 0.5.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.5.0 exposes all 90 catalog types through the generic Chain and
-`createEffect` APIs and 90 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 -->
 
@@ -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,16 +168,17 @@ 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.
 

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

@@ -1,11 +1,11 @@
 {
   "abiVersion": 1,
-  "sourceDigest": "sha256:00067361c0a5d99d45cf1d82c9bf6551d0403f895a8fa49ca21a6c79baf5c4d1",
+  "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:b50736a00940789be0f1ac4cfb8ab918c1ac1226fb9223703c0847d50b82d9e6",
+    "digest": "sha256:0dab4b4c5ba1de2a9998e5f2e8bee1b3d31b654b1029fa1be0c677ef6aa295d1",
     "inputs": [
       {
         "id": "dsp/core/abi.cpp",
@@ -35,7 +35,7 @@
       {
         "id": "dsp/core/engine.cpp",
         "kind": "file",
-        "sha256": "sha256:be4717516d9fb48de4a4fb68f5338a490ac4a060c571a22237514f311c2c1126"
+        "sha256": "sha256:2d492ff232ddc0d6b64843dba7a08d3f2834c9bb4b0ee923d9a93e2b71c29ec2"
       },
       {
         "id": "dsp/core/engine.h",
@@ -115,7 +115,7 @@
       {
         "id": "dsp/plugins/lofi/g726_adpcm_simulator/params.json",
         "kind": "file",
-        "sha256": "sha256:fccbe3d6b852a1f29f86a1f3d1cc6acf855dbfa7d4472cbb2c211abd52ccd61f"
+        "sha256": "sha256:d7ecbfdc5d087b12319c3501e685021b148cd0e21e4f87b36463cbffbabbc879"
       },
       {
         "id": "dsp/registry.inc#G726ADPCMSimulatorPlugin-entry",
@@ -160,7 +160,7 @@
       {
         "id": "tools/dsp-parity/runners.mjs",
         "kind": "file",
-        "sha256": "sha256:2149fe3fd23139997563d401277b0ea5cdc1b893d310f970fc4e5f9b8517d11c"
+        "sha256": "sha256:fe1da8063d168c1b9f142a6217a097230bbf8783bd1d8f4bcb8ac807d78d862f"
       },
       {
         "id": "tools/dsp-parity/stimuli.mjs",
@@ -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": 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;

package/dist/catalog/effects-v1.json

@@ -2217,6 +2217,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 +3560,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": [
@@ -6865,6 +6961,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 +7067,7 @@
     }
   ],
   "contractDigests": {
-    "publicCatalogSha256": "1f7621279e4fd1cae842bda2498e76f8afbdd2c05990b246732947b520818d62",
-    "privateLayoutSha256": "e63194ca2bd43f224ade8e5b387a89f68678c9e8c838f4a8faca600a61521c84"
+    "publicCatalogSha256": "3c5f527bbc305e612b94c8e56e7a9eb7bc42ed35574354bb2f60f42e5dfc96af",
+    "privateLayoutSha256": "10371b5016b454f9e056d84f4a43d050e01a6b40ba0d9eb8dd3939f4fba2550c"
   }
 }

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;
+    }
+  }
+}

package/dist/effect.js

@@ -12,6 +12,7 @@ const ASSET_NAMES_BY_EFFECT = new Map([
   ['FIRCrossover', ['impulseResponse']],
   ['FiveBandFIRPEQ', ['impulseResponse']],
   ['GroupDelayEQ', ['impulseResponse']],
+  ['GroupDelayPEQ', ['impulseResponse']],
   ['IRReverb', ['impulseResponse']],
   ['RoomEQ', ['impulseResponse']]
 ]);

package/dist/generated-effects.d.ts

@@ -1,8 +1,8 @@
 // Generated by scripts/gen-dsp-library-bindings.mjs. Do not edit.
 import { Effect } from './effect.js';
 
-export type EffectType = "LevelMeter" | "Oscilloscope" | "Spectrogram" | "SpectrumAnalyzer" | "StereoMeter" | "ChannelDivider" | "DCOffset" | "FIRCrossover" | "Matrix" | "MultiChannelPanel" | "Mute" | "PolarityInversion" | "StereoBalance" | "Volume" | "Delay" | "TimeAlignment" | "AutoLeveler" | "BrickwallLimiter" | "Compressor" | "Expander" | "Gate" | "MultibandCompressor" | "MultibandExpander" | "MultibandTransient" | "PowerAmpSag" | "TransientShaper" | "BandPassFilter" | "CombFilter" | "EarphoneCableSim" | "FifteenBandGEQ" | "FifteenBandPEQ" | "FiveBandDynamicEQ" | "FiveBandFIRPEQ" | "FiveBandPEQ" | "GroupDelayEQ" | "HiPassFilter" | "LoPassFilter" | "LoudnessEqualizer" | "NarrowRange" | "RoomEQ" | "TiltEQ" | "ToneControl" | "AMRadioSimulator" | "BitCrusher" | "BluetoothSBCSimulator" | "CassetteArtifacts" | "DigitalErrorEmulator" | "DSD64IMDSimulator" | "FMRadioSimulator" | "G726ADPCMSimulator" | "GSMFullRateSimulator" | "HumGenerator" | "MP3CodecSimulator" | "NoiseBlender" | "SimpleJitter" | "SWRadioSimulator" | "TapeArtifacts" | "VinylArtifacts" | "VinylSimulator" | "AutoFilter" | "AutoPan" | "Chorus" | "DopplerDistortion" | "FrequencyShifter" | "Phaser" | "PitchShifter" | "RotarySpeaker" | "Tremolo" | "WowFlutter" | "Oscillator" | "HornResonator" | "HornResonatorPlus" | "ModalResonator" | "DattorroPlateReverb" | "FDNReverb" | "IRReverb" | "RSReverb" | "DynamicSaturation" | "Exciter" | "HardClipping" | "HarmonicDistortion" | "MultibandSaturation" | "Saturation" | "SubSynth" | "TubeSimulator" | "CrossfeedFilter" | "MSMatrix" | "MultibandBalance" | "PhaseSelectEQ" | "StereoBlend";
-type RequiredAssetEffectType = "FIRCrossover" | "FiveBandFIRPEQ" | "GroupDelayEQ" | "RoomEQ" | "IRReverb";
+export type EffectType = "LevelMeter" | "Oscilloscope" | "Spectrogram" | "SpectrumAnalyzer" | "StereoMeter" | "ChannelDivider" | "DCOffset" | "FIRCrossover" | "Matrix" | "MultiChannelPanel" | "Mute" | "PolarityInversion" | "StereoBalance" | "Volume" | "Delay" | "TimeAlignment" | "AutoLeveler" | "BrickwallLimiter" | "Compressor" | "Expander" | "Gate" | "MultibandCompressor" | "MultibandExpander" | "MultibandTransient" | "PowerAmpSag" | "TransientShaper" | "BandPassFilter" | "CombFilter" | "EarphoneCableSim" | "FifteenBandGEQ" | "FifteenBandPEQ" | "FiveBandDynamicEQ" | "FiveBandFIRPEQ" | "FiveBandPEQ" | "GroupDelayEQ" | "GroupDelayPEQ" | "HiPassFilter" | "LoPassFilter" | "LoudnessEqualizer" | "NarrowRange" | "RoomEQ" | "TiltEQ" | "ToneControl" | "AMRadioSimulator" | "BitCrusher" | "BluetoothSBCSimulator" | "CassetteArtifacts" | "DigitalErrorEmulator" | "DSD64IMDSimulator" | "FMRadioSimulator" | "G726ADPCMSimulator" | "GSMFullRateSimulator" | "HumGenerator" | "MDSimulator" | "MP3CodecSimulator" | "NoiseBlender" | "SimpleJitter" | "SWRadioSimulator" | "TapeArtifacts" | "VinylArtifacts" | "VinylSimulator" | "AutoFilter" | "AutoPan" | "Chorus" | "DopplerDistortion" | "FrequencyShifter" | "Phaser" | "PitchShifter" | "RotarySpeaker" | "Tremolo" | "WowFlutter" | "Oscillator" | "HornResonator" | "HornResonatorPlus" | "ModalResonator" | "DattorroPlateReverb" | "FDNReverb" | "IRReverb" | "RSReverb" | "DynamicSaturation" | "Exciter" | "HardClipping" | "HarmonicDistortion" | "MultibandSaturation" | "Saturation" | "SubSynth" | "TubeSimulator" | "CrossfeedFilter" | "MSMatrix" | "MultibandBalance" | "PhaseSelectEQ" | "StereoBlend";
+type RequiredAssetEffectType = "FIRCrossover" | "FiveBandFIRPEQ" | "GroupDelayEQ" | "GroupDelayPEQ" | "RoomEQ" | "IRReverb";
 export type EffectChannel = "all" | "stereo" | "left" | "right" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "34" | "56" | "78";
 
 export interface CommonEffectOptions {
@@ -555,6 +555,19 @@ export declare class GroupDelayEQ extends Effect {
 
 export declare function createGroupDelayEQ(options: GroupDelayEQOptions): GroupDelayEQ;
 
+export interface GroupDelayPEQOptions extends CommonEffectOptions {
+  readonly latencyMode?: "0" | "128" | "256" | "512" | "1024";
+  readonly filterDelaySamples?: number;
+  readonly assets: IRReverbAssets;
+}
+
+export declare class GroupDelayPEQ extends Effect {
+  static readonly effectType: "GroupDelayPEQ";
+  constructor(options: GroupDelayPEQOptions);
+}
+
+export declare function createGroupDelayPEQ(options: GroupDelayPEQOptions): GroupDelayPEQ;
+
 export interface HiPassFilterOptions extends CommonEffectOptions {
   readonly frequency?: number;
   readonly slope?: 0 | -12 | -24 | -36 | -48 | -60 | -72 | -84 | -96;
@@ -853,6 +866,20 @@ export declare class HumGenerator extends Effect {
 
 export declare function createHumGenerator(options?: HumGeneratorOptions): HumGenerator;
 
+export interface MDSimulatorOptions extends CommonEffectOptions {
+  readonly mode?: "SP (292 kbps)" | "LP2 (132 kbps)" | "LP4 (66 kbps)";
+  readonly outputGain?: number;
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class MDSimulator extends Effect {
+  static readonly effectType: "MDSimulator";
+  constructor(options?: MDSimulatorOptions);
+}
+
+export declare function createMDSimulator(options?: MDSimulatorOptions): MDSimulator;
+
 export interface MP3CodecSimulatorOptions extends CommonEffectOptions {
   readonly codecRate?: "22.05 kHz (MPEG-2)" | "44.1 kHz (MPEG-1)";
   readonly bitrate?: "32" | "48" | "64" | "80" | "96" | "112" | "128" | "160" | "192" | "224" | "256" | "320";
@@ -1555,6 +1582,11 @@ export interface PhaseSelectEQOptions extends CommonEffectOptions {
   readonly corePhaseHigh?: readonly [number, number, number, number, number];
   readonly outerPhaseHigh?: readonly [number, number, number, number, number];
   readonly gain?: readonly [number, number, number, number, number];
+  readonly regionSolo?: readonly [boolean, boolean, boolean, boolean, boolean];
+  readonly outerBalanceLow?: readonly [number, number, number, number, number];
+  readonly coreBalanceLow?: readonly [number, number, number, number, number];
+  readonly coreBalanceHigh?: readonly [number, number, number, number, number];
+  readonly outerBalanceHigh?: readonly [number, number, number, number, number];
   readonly assets?: never;
 }
 
@@ -1613,6 +1645,7 @@ export interface EffectOptionsByType {
   readonly FiveBandFIRPEQ: FiveBandFIRPEQOptions;
   readonly FiveBandPEQ: FiveBandPEQOptions;
   readonly GroupDelayEQ: GroupDelayEQOptions;
+  readonly GroupDelayPEQ: GroupDelayPEQOptions;
   readonly HiPassFilter: HiPassFilterOptions;
   readonly LoPassFilter: LoPassFilterOptions;
   readonly LoudnessEqualizer: LoudnessEqualizerOptions;
@@ -1630,6 +1663,7 @@ export interface EffectOptionsByType {
   readonly G726ADPCMSimulator: G726ADPCMSimulatorOptions;
   readonly GSMFullRateSimulator: GSMFullRateSimulatorOptions;
   readonly HumGenerator: HumGeneratorOptions;
+  readonly MDSimulator: MDSimulatorOptions;
   readonly MP3CodecSimulator: MP3CodecSimulatorOptions;
   readonly NoiseBlender: NoiseBlenderOptions;
   readonly SimpleJitter: SimpleJitterOptions;
@@ -1706,6 +1740,7 @@ export interface EffectClassByType {
   readonly FiveBandFIRPEQ: FiveBandFIRPEQ;
   readonly FiveBandPEQ: FiveBandPEQ;
   readonly GroupDelayEQ: GroupDelayEQ;
+  readonly GroupDelayPEQ: GroupDelayPEQ;
   readonly HiPassFilter: HiPassFilter;
   readonly LoPassFilter: LoPassFilter;
   readonly LoudnessEqualizer: LoudnessEqualizer;
@@ -1723,6 +1758,7 @@ export interface EffectClassByType {
   readonly G726ADPCMSimulator: G726ADPCMSimulator;
   readonly GSMFullRateSimulator: GSMFullRateSimulator;
   readonly HumGenerator: HumGenerator;
+  readonly MDSimulator: MDSimulator;
   readonly MP3CodecSimulator: MP3CodecSimulator;
   readonly NoiseBlender: NoiseBlender;
   readonly SimpleJitter: SimpleJitter;