@effetune/dsp 0.5.0 → 0.7.0

package/dist/schemas/graph-v1.schema.json

@@ -64,9 +64,21 @@
         "6",
         "7",
         "8",
+        "9",
+        "10",
+        "11",
+        "12",
+        "13",
+        "14",
+        "15",
+        "16",
         "34",
         "56",
-        "78"
+        "78",
+        "910",
+        "1112",
+        "1314",
+        "1516"
       ],
       "default": "all"
     },
@@ -183,6 +195,9 @@
         {
           "$ref": "#/$defs/GroupDelayEQ"
         },
+        {
+          "$ref": "#/$defs/GroupDelayPEQ"
+        },
         {
           "$ref": "#/$defs/HiPassFilter"
         },
@@ -234,6 +249,9 @@
         {
           "$ref": "#/$defs/HumGenerator"
         },
+        {
+          "$ref": "#/$defs/MDSimulator"
+        },
         {
           "$ref": "#/$defs/MP3CodecSimulator"
         },
@@ -799,7 +817,7 @@
             "matrixRoutes": {
               "type": "string",
               "maxLength": 3072,
-              "pattern": "^(?:p?[0-8][0-8])*$",
+              "pattern": "^(?:p?[0-9a-f][0-9a-f])*$",
               "default": "0011"
             }
           }
@@ -835,12 +853,20 @@
           "properties": {
             "mute": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "boolean"
               },
               "default": [
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
                 false,
                 false,
                 false,
@@ -853,12 +879,20 @@
             },
             "solo": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "boolean"
               },
               "default": [
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
                 false,
                 false,
                 false,
@@ -871,8 +905,8 @@
             },
             "volume": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": -20,
@@ -880,6 +914,14 @@
                 "x-effetune-unit": "dB"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -892,8 +934,8 @@
             },
             "delay": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": 0,
@@ -901,6 +943,14 @@
                 "x-effetune-unit": "ms"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -913,12 +963,20 @@
             },
             "link": {
               "type": "array",
-              "minItems": 7,
-              "maxItems": 7,
+              "minItems": 15,
+              "maxItems": 15,
               "items": {
                 "type": "boolean"
               },
               "default": [
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
+                false,
                 false,
                 false,
                 false,
@@ -3163,6 +3221,67 @@
         }
       }
     },
+    "GroupDelayPEQ": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "parameters",
+        "assets"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "type": {
+          "const": "GroupDelayPEQ"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "channel": {
+          "$ref": "#/$defs/channel"
+        },
+        "parameters": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "latencyMode": {
+              "type": "string",
+              "enum": [
+                "0",
+                "128",
+                "256",
+                "512",
+                "1024"
+              ],
+              "default": "128"
+            },
+            "filterDelaySamples": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 65536,
+              "default": 8192
+            }
+          }
+        },
+        "assets": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "impulseResponse"
+          ],
+          "properties": {
+            "impulseResponse": {
+              "$ref": "#/$defs/assetReference"
+            }
+          }
+        }
+      }
+    },
     "HiPassFilter": {
       "type": "object",
       "additionalProperties": false,
@@ -4524,6 +4643,60 @@
         }
       }
     },
+    "MDSimulator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "parameters"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "type": {
+          "const": "MDSimulator"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "channel": {
+          "$ref": "#/$defs/channel"
+        },
+        "parameters": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "SP (292 kbps)",
+                "LP2 (132 kbps)",
+                "LP4 (66 kbps)"
+              ],
+              "default": "SP (292 kbps)"
+            },
+            "outputGain": {
+              "type": "number",
+              "minimum": -24,
+              "maximum": 12,
+              "x-effetune-unit": "dB",
+              "default": 0
+            },
+            "mix": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "x-effetune-unit": "%",
+              "default": 100
+            }
+          }
+        }
+      }
+    },
     "MP3CodecSimulator": {
       "type": "object",
       "additionalProperties": false,
@@ -5068,7 +5241,7 @@
               "type": "number",
               "minimum": 0,
               "maximum": 10,
-              "default": 0
+              "default": 10
             },
             "wear": {
               "type": "integer",
@@ -6309,7 +6482,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }
@@ -6395,7 +6568,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }
@@ -8081,6 +8254,93 @@
                 100,
                 100
               ]
+            },
+            "regionSolo": {
+              "type": "array",
+              "minItems": 5,
+              "maxItems": 5,
+              "items": {
+                "type": "boolean"
+              },
+              "default": [
+                false,
+                false,
+                false,
+                false,
+                false
+              ]
+            },
+            "outerBalanceLow": {
+              "type": "array",
+              "minItems": 5,
+              "maxItems": 5,
+              "items": {
+                "type": "number",
+                "minimum": -100,
+                "maximum": 100,
+                "x-effetune-unit": "%"
+              },
+              "default": [
+                -100,
+                -100,
+                -100,
+                -100,
+                -100
+              ]
+            },
+            "coreBalanceLow": {
+              "type": "array",
+              "minItems": 5,
+              "maxItems": 5,
+              "items": {
+                "type": "number",
+                "minimum": -100,
+                "maximum": 100,
+                "x-effetune-unit": "%"
+              },
+              "default": [
+                -100,
+                -100,
+                -100,
+                -100,
+                -100
+              ]
+            },
+            "coreBalanceHigh": {
+              "type": "array",
+              "minItems": 5,
+              "maxItems": 5,
+              "items": {
+                "type": "number",
+                "minimum": -100,
+                "maximum": 100,
+                "x-effetune-unit": "%"
+              },
+              "default": [
+                100,
+                100,
+                100,
+                100,
+                100
+              ]
+            },
+            "outerBalanceHigh": {
+              "type": "array",
+              "minItems": 5,
+              "maxItems": 5,
+              "items": {
+                "type": "number",
+                "minimum": -100,
+                "maximum": 100,
+                "x-effetune-unit": "%"
+              },
+              "default": [
+                100,
+                100,
+                100,
+                100,
+                100
+              ]
             }
           }
         }

package/dist/semantics.js

@@ -1,6 +1,8 @@
 import { DSP_PARAM_PACKERS } from './internal/dsp-params.generated.js';
 import { getEffectDefinition, getEffectImplementation } from './catalog.js';
-import { Effect, validateChannel, validateParameterValue } from './effect.js';
+import {
+  Effect, canonicalizeProcessingParameters, validateChannel, validateParameterValue
+} from './effect.js';
 import {
   AssetError,
   EffeTuneError,
@@ -15,6 +17,7 @@ const STREAM_RECONFIGURATION_PARAMETERS = new Map([
   ['FIRCrossover', new Set(['bandCount', 'latencyMode', 'filterDelaySamples'])],
   ['FiveBandFIRPEQ', new Set(['latencyMode', 'filterDelaySamples'])],
   ['GroupDelayEQ', new Set(['latencyMode', 'filterDelaySamples'])],
+  ['GroupDelayPEQ', new Set(['latencyMode', 'filterDelaySamples'])],
   ['IRReverb', new Set(['channelMode', 'latency', 'convolutionRate'])],
   ['RoomEQ', new Set(['latencyMode', 'filterDelaySamples'])]
 ]);
@@ -230,6 +233,7 @@ function toInternalValue(transform, value) {
 }
 
 export function packEffect(effect) {
+  const parameters = canonicalizeProcessingParameters(effect.type, effect.parameters);
   const implementation = getEffectImplementation(effect.type);
   const packer = DSP_PARAM_PACKERS.get(implementation.internalType);
   if (!packer || (packer.hash >>> 0) !== (implementation.layoutHash >>> 0)) {
@@ -237,7 +241,7 @@ export function packEffect(effect) {
   }
   const internal = {};
   for (const mapping of implementation.packedParameters) {
-    const value = effect.parameters[mapping.publicName];
+    const value = parameters[mapping.publicName];
     if (mapping.count === 1) {
       internal[mapping.keys[0]] = toInternalValue(mapping.transform, value);
     } else {
@@ -248,7 +252,7 @@ export function packEffect(effect) {
   }
   const structured = implementation.structuredParameter;
   if (structured) {
-    internal[structured.key] = effect.parameters[structured.publicName];
+    internal[structured.key] = parameters[structured.publicName];
   }
   // The generated packer reports capacity limits with plain JavaScript errors.
   // Translating them here keeps every public entry point (process, stream, setParam)
@@ -301,18 +305,7 @@ export function setEffectParameter(effect, parameterName, value) {
 
 export function canonicalizeEffectForProcessing(effect) {
   const canonical = cloneEffect(effect);
-  const parameters = canonical.parameters;
-  if (effect.type === 'AutoFilter' &&
-      parameters.minimumFrequency > parameters.maximumFrequency) {
-    [parameters.minimumFrequency, parameters.maximumFrequency] =
-      [parameters.maximumFrequency, parameters.minimumFrequency];
-  } else if (effect.type === 'Chorus' && parameters.depth > parameters.delay) {
-    parameters.depth = parameters.delay;
-  } else if (effect.type === 'FrequencyShifter' &&
-      parameters.minimumShift > parameters.maximumShift) {
-    [parameters.minimumShift, parameters.maximumShift] =
-      [parameters.maximumShift, parameters.minimumShift];
-  }
+  canonical.parameters = canonicalizeProcessingParameters(effect.type, canonical.parameters);
   return canonical;
 }
 
@@ -327,8 +320,8 @@ export function validateStreamParameterUpdate(effect, parameterName) {
 
 export function channelRange(channel, channelCount) {
   validateChannel(channel);
-  if (!Number.isInteger(channelCount) || channelCount < 1 || channelCount > 8) {
-    throw new ValidationError('Audio must contain between 1 and 8 channels.');
+  if (!Number.isInteger(channelCount) || channelCount < 1 || channelCount > 16) {
+    throw new ValidationError('Audio must contain between 1 and 16 channels.');
   }
   if (channel === 'all') return { start: 0, count: channelCount };
   if (channel === 'stereo') return { start: 0, count: channelCount >= 2 ? 2 : 1 };
@@ -337,8 +330,9 @@ export function channelRange(channel, channelCount) {
     if (channelCount < 2) throw new ValidationError('The right channel is unavailable in mono audio.');
     return { start: 1, count: 1 };
   }
-  if (channel === '34' || channel === '56' || channel === '78') {
-    const start = Number(channel[0]) - 1;
+  const pairStart = { '34': 2, '56': 4, '78': 6, '910': 8, '1112': 10, '1314': 12, '1516': 14 }[channel];
+  if (pairStart !== undefined) {
+    const start = pairStart;
     if (channelCount < start + 2) {
       throw new ValidationError(`Channel pair ${channel} is unavailable in ${channelCount}-channel audio.`);
     }

package/dist/telemetry.js

@@ -34,7 +34,7 @@ function common(node, kind, sequence, dropped) {
 function decodeLevel(payload, node, sequence, dropped) {
   if (payload.byteLength < 16) return null;
   const channelCount = payload.getUint32(0, true);
-  if (channelCount < 1 || channelCount > 8 || payload.byteLength !== 8 + channelCount * 8) {
+  if (channelCount < 1 || channelCount > 16 || payload.byteLength !== 8 + channelCount * 8) {
     return null;
   }
   const clipFlags = payload.getUint32(4 + channelCount * 8, true);

package/dist/worklet.js

@@ -8,6 +8,7 @@ import {
 } from './errors.js';
 import {
   normalizeChainDocument,
+  canonicalizeEffectForProcessing,
   channelRange,
   packEffect,
   setEffectParameter,
@@ -42,8 +43,8 @@ function cloneDocument(document) {
 }
 
 function validateChannels(channels) {
-  if (!Number.isInteger(channels) || channels < 1 || channels > 8) {
-    throw new ValidationError('channels must be an integer from 1 to 8.');
+  if (!Number.isInteger(channels) || channels < 1 || channels > 16) {
+    throw new ValidationError('channels must be an integer from 1 to 16.');
   }
   return channels;
 }
@@ -124,7 +125,11 @@ export class EffeTuneNode extends AudioWorkletNodeBase {
         })()
       : input;
     const { chain, manifest } = splitBundle(source);
-    const document = normalizeChainDocument(chain);
+    const normalized = normalizeChainDocument(chain);
+    const document = {
+      version: 1,
+      chain: normalized.chain.map(canonicalizeEffectForProcessing)
+    };
     const resolvedAssets = await resolveChainAssets(document, {
       assetResolver: options.assetResolver,
       manifest
@@ -359,7 +364,9 @@ export class EffeTuneNode extends AudioWorkletNodeBase {
       if (index < 0) throw new ValidationError(`Unknown effect id: ${effectId}`);
       const effects = [...this._document.chain];
       validateStreamParameterUpdate(effects[index], parameterName);
-      effects[index] = setEffectParameter(effects[index], parameterName, value);
+      effects[index] = canonicalizeEffectForProcessing(
+        setEffectParameter(effects[index], parameterName, value)
+      );
       if (effects[index].enabled) {
         const packed = packEffect(effects[index]);
         await this._command({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effetune/dsp",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "EffeTune's deterministic WebAssembly audio effects for JavaScript and AudioWorklet",
   "type": "module",
   "license": "MIT",