@effetune/dsp 0.6.0 → 0.7.0

package/README.md

@@ -3,7 +3,7 @@
 <!-- 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.6.0 exposes all 92 catalog types through the generic Chain and
+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 -->
@@ -182,11 +182,11 @@ 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.
 
@@ -231,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:c00f5411a8fe68c2139dd6a5903e1f480229387a9e7057bd6e246fc2676cddec",
+  "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:0dab4b4c5ba1de2a9998e5f2e8bee1b3d31b654b1029fa1be0c677ef6aa295d1",
+    "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:2d492ff232ddc0d6b64843dba7a08d3f2834c9bb4b0ee923d9a93e2b71c29ec2"
+        "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:d7ecbfdc5d087b12319c3501e685021b148cd0e21e4f87b36463cbffbabbc879"
+        "sha256": "sha256:128c5eb52ac4eecd786065ecc778005a88fef91fb8fb7ea49e74028415f2b5dc"
       },
       {
         "id": "dsp/registry.inc#G726ADPCMSimulatorPlugin-entry",
@@ -160,7 +160,7 @@
       {
         "id": "tools/dsp-parity/runners.mjs",
         "kind": "file",
-        "sha256": "sha256:fe1da8063d168c1b9f142a6217a097230bbf8783bd1d8f4bcb8ac807d78d862f"
+        "sha256": "sha256:cd67baecc50e260dddedb992f50de963caecf9ec7c6fc76bbf415b3fd4b478ec"
       },
       {
         "id": "tools/dsp-parity/stimuli.mjs",
@@ -454,7 +454,7 @@
     },
     {
       "name": "MultiChannelPanelPlugin",
-      "hash": 4191368224,
+      "hash": 2638026937,
       "byteCapacity": 0,
       "assets": []
     },
@@ -999,7 +999,7 @@
     }
   ],
   "sizes": {
-    "baseline": 1167544,
-    "simd": 1286159
+    "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;

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,
@@ -4146,7 +4198,7 @@
           "name": "noiseProfile",
           "type": "number",
           "count": 1,
-          "default": 0,
+          "default": 10,
           "minimum": 0,
           "maximum": 10
         },
@@ -5364,7 +5416,7 @@
           "name": "waveguideGain",
           "type": "number",
           "count": 1,
-          "default": 30,
+          "default": 26,
           "unit": "dB",
           "minimum": -36,
           "maximum": 36
@@ -5446,7 +5498,7 @@
           "name": "waveguideGain",
           "type": "number",
           "count": 1,
-          "default": 30,
+          "default": 26,
           "unit": "dB",
           "minimum": -36,
           "maximum": 36
@@ -5973,7 +6025,7 @@
           "maximum": 100
         }
       ],
-      "seeded": true,
+      "seeded": false,
       "telemetry": [],
       "latency": {
         "kind": "zero"
@@ -7067,7 +7119,7 @@
     }
   ],
   "contractDigests": {
-    "publicCatalogSha256": "3c5f527bbc305e612b94c8e56e7a9eb7bc42ed35574354bb2f60f42e5dfc96af",
-    "privateLayoutSha256": "10371b5016b454f9e056d84f4a43d050e01a6b40ba0d9eb8dd3939f4fba2550c"
+    "publicCatalogSha256": "0f8926c820f825d87f212d7c7fbfa75044caf7aa912bef6a78cc85f820b899c0",
+    "privateLayoutSha256": "61121eb6aec4b52d5492795c2ac81bd4cecfa119b7bfc4e6956fd2b725690685"
   }
 }

package/dist/effect.js

@@ -2,8 +2,8 @@ import { AssetError, ValidationError } from './errors.js';
 
 export const EFFECT_CHANNELS = Object.freeze([
   'all', 'stereo', 'left', 'right',
-  '1', '2', '3', '4', '5', '6', '7', '8',
-  '34', '56', '78'
+  '1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16',
+  '34', '56', '78', '910', '1112', '1314', '1516'
 ]);
 
 const COMMON_KEYS = new Set(['id', 'enabled', 'channel', 'assets', 'parameters']);
@@ -86,6 +86,32 @@ export function validateParameterValue(effectType, definition, value) {
   return Array.isArray(value) ? Object.freeze([...value]) : value;
 }
 
+export function canonicalizeProcessingParameters(effectType, parameters) {
+  const canonical = { ...parameters };
+  if (effectType === 'AutoFilter' &&
+      canonical.minimumFrequency > canonical.maximumFrequency) {
+    [canonical.minimumFrequency, canonical.maximumFrequency] =
+      [canonical.maximumFrequency, canonical.minimumFrequency];
+  } else if (effectType === 'Chorus' && canonical.depth > canonical.delay) {
+    canonical.depth = canonical.delay;
+  } else if (effectType === 'FrequencyShifter' &&
+      canonical.minimumShift > canonical.maximumShift) {
+    [canonical.minimumShift, canonical.maximumShift] =
+      [canonical.maximumShift, canonical.minimumShift];
+  } else if (effectType === 'MultibandCompressor' || effectType === 'MultibandExpander' ||
+      effectType === 'MultibandBalance' || effectType === 'MultibandTransient' ||
+      effectType === 'MultibandSaturation') {
+    const count = effectType === 'MultibandTransient' || effectType === 'MultibandSaturation'
+      ? 2 : 4;
+    for (let index = 2; index <= count; index++) {
+      const key = `frequency${index}`;
+      const previous = canonical[`frequency${index - 1}`];
+      if (canonical[key] < previous) canonical[key] = previous;
+    }
+  }
+  return canonical;
+}
+
 function normalizeBaseAssets(effectType, assets) {
   const assetNames = ASSET_NAMES_BY_EFFECT.get(effectType);
   if (!assetNames) {

package/dist/generated-effects.d.ts

@@ -3,7 +3,7 @@ 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" | "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 type EffectChannel = "all" | "stereo" | "left" | "right" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "34" | "56" | "78" | "910" | "1112" | "1314" | "1516";
 
 export interface CommonEffectOptions {
   readonly id?: string;
@@ -139,11 +139,11 @@ export declare class Matrix extends Effect {
 export declare function createMatrix(options?: MatrixOptions): Matrix;
 
 export interface MultiChannelPanelOptions extends CommonEffectOptions {
-  readonly mute?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
-  readonly solo?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
-  readonly volume?: readonly [number, number, number, number, number, number, number, number];
-  readonly delay?: readonly [number, number, number, number, number, number, number, number];
-  readonly link?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly mute?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly solo?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
+  readonly volume?: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+  readonly delay?: readonly [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
+  readonly link?: readonly [boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean, boolean];
   readonly assets?: never;
 }