@effetune/dsp 0.6.0 → 0.7.0

package/dist/internal/ir-asset-payload.js

@@ -10,13 +10,13 @@ export const IR_ASSET_TOPOLOGY = Object.freeze({
   matrix: 4
 });
 
-const MAX_CHANNELS = 8;
-const MAX_MATRIX_PATHS = 8;
+const MAX_CHANNELS = 16;
+const MAX_MATRIX_PATHS = 16;
 const MATRIX_PATH_BYTES = 12;
 
 function validateChannels(channels) {
   if (!Array.isArray(channels) || channels.length < 1 || channels.length > MAX_CHANNELS) {
-    throw new TypeError('IR channels must contain between 1 and 8 Float32Array values');
+    throw new TypeError('IR channels must contain between 1 and 16 Float32Array values');
   }
   const frames = channels[0] instanceof Float32Array ? channels[0].length : 0;
   if (frames === 0) throw new TypeError('IR channels must not be empty');
@@ -42,7 +42,7 @@ function validateTopology(topology, paths, channelCount) {
     return [];
   }
   if (!Array.isArray(paths) || paths.length < 1 || paths.length > MAX_MATRIX_PATHS) {
-    throw new TypeError('Matrix topology requires between 1 and 8 paths');
+    throw new TypeError('Matrix topology requires between 1 and 16 paths');
   }
   return paths.map(path => {
     const inputSlot = path?.inputSlot;

package/dist/internal/ir-plugin-contract.js

@@ -5,7 +5,7 @@ export const IR_KERNEL_ASSET_CAPACITY_BYTES = 32 * 1024 * 1024;
 
 const KERNEL_FIXED_FOOTPRINT_BYTES = 2 * 1024 * 1024;
 const KERNEL_PATH_FRAME_BYTES = 16;
-const CONVOLVER_IMPL_BYTES_UPPER_BOUND = 512;
+const CONVOLVER_IMPL_BYTES_UPPER_BOUND = 16 * 1024;
 const CONVOLVER_STAGE_BYTES_UPPER_BOUND = 512;
 const PFFFT_SETUP_FIXED_BYTES_UPPER_BOUND = 136;
 const MATRIX_PATH_BYTES = 12;
@@ -24,18 +24,22 @@ function topologyInputCount(topology, processingChannels, inputCount = 0) {
 }
 
 export function selectedIrChannelCount(channel, engineChannels) {
-  if (!Number.isInteger(engineChannels) || engineChannels < 1 || engineChannels > 8) return 0;
+  if (!Number.isInteger(engineChannels) || engineChannels < 1 || engineChannels > 16) return 0;
   if (channel === 'A') return engineChannels;
   if (channel === null || channel === undefined) return engineChannels >= 2 ? 2 : 1;
-  if (channel === 'L' || channel === 'R' || /^[1-8]$/.test(String(channel))) return 1;
+  if (channel === 'L' || channel === 'R' || /^([1-9]|1[0-6])$/.test(String(channel))) return 1;
   if (channel === '34') return engineChannels >= 4 ? 2 : 0;
   if (channel === '56') return engineChannels >= 6 ? 2 : 0;
   if (channel === '78') return engineChannels >= 8 ? 2 : 0;
+  if (channel === '910') return engineChannels >= 10 ? 2 : 0;
+  if (channel === '1112') return engineChannels >= 12 ? 2 : 0;
+  if (channel === '1314') return engineChannels >= 14 ? 2 : 0;
+  if (channel === '1516') return engineChannels >= 16 ? 2 : 0;
   return 0;
 }
 
 function diagonalPaths(channelCount, selectedChannels) {
-  const count = Math.min(channelCount, selectedChannels, 8);
+  const count = Math.min(channelCount, selectedChannels, 16);
   return Array.from({ length: count }, (_, index) => ({
     inputSlot: index,
     outputSlot: index,
@@ -102,7 +106,7 @@ export function estimateIrConvolverMemoryUpperBound({
 export function resolveIrProcessingConfig({
   sampleRate,
   channelCount,
-  engineChannels = 8,
+  engineChannels = 16,
   selectedChannels,
   channel,
   channelMode = 'auto',
@@ -112,7 +116,7 @@ export function resolveIrProcessingConfig({
   if (!Number.isFinite(sampleRate) || sampleRate <= 0) {
     return { valid: false, message: 'The current audio sample rate is unavailable.' };
   }
-  if (!Number.isInteger(channelCount) || channelCount < 1 || channelCount > 8) {
+  if (!Number.isInteger(channelCount) || channelCount < 1 || channelCount > 16) {
     return { valid: false, message: 'This impulse response has an unsupported channel count.' };
   }
   const routedChannels = selectedChannels ?? selectedIrChannelCount(channel, engineChannels);

package/dist/preset.js

@@ -58,7 +58,7 @@ function legacyChannel(value) {
     stereo: 'stereo'
   };
   const normalized = mapping[value] ?? value;
-  if (['1', '2', '3', '4', '5', '6', '7', '8', '34', '56', '78'].includes(normalized)) {
+  if (['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16', '34', '56', '78', '910', '1112', '1314', '1516'].includes(normalized)) {
     return normalized;
   }
   if (['all', 'stereo', 'left', 'right'].includes(normalized)) return normalized;
@@ -309,7 +309,11 @@ function expandLegacyShortKeyArraysV1(parameters, { effectLabel, itemLabel, memb
         `Legacy ${effectLabel} contains unsupported or incomplete ${itemLabel} settings.`
       );
     }
-    parameters[publicName] = values;
+    // App presets retain eight channels when the extended channels are at their defaults.
+    const originalCount = legacyName === 'l' ? 7 : 8;
+    const defaultValue = legacyName === 'v' || legacyName === 'd' ? 0 : false;
+    parameters[publicName] = values.length === originalCount
+      ? [...values, ...Array(8).fill(defaultValue)] : values;
   }
 }
 

package/dist/runtime.js

@@ -17,8 +17,8 @@ import {
 const PARAMETER_EVENT_KEYS = new Set(['frame', 'effectId', 'parameters']);
 
 function validateAudio(audio) {
-  if (!Array.isArray(audio) || audio.length < 1 || audio.length > 8) {
-    throw new ValidationError('Audio must be an array containing between 1 and 8 Float32Array channels.');
+  if (!Array.isArray(audio) || audio.length < 1 || audio.length > 16) {
+    throw new ValidationError('Audio must be an array containing between 1 and 16 Float32Array channels.');
   }
   const frames = audio[0] instanceof Float32Array ? audio[0].length : -1;
   for (const channel of audio) {
@@ -390,8 +390,8 @@ export class Chain {
   } = {}) {
     this._assertOpen();
     const rate = validateSampleRate(sampleRate);
-    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.');
     }
     const frames = validateBlockSize(blockSize);
     const normalizedSeed = validateSeed(seed);
@@ -434,8 +434,8 @@ export class Chain {
   } = {}) {
     this._assertOpen();
     const rate = validateSampleRate(sampleRate);
-    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.');
     }
     const framesPerBlock = validateBlockSize(blockSize);
     const normalizedSeed = validateSeed(seed);

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

@@ -116,7 +116,7 @@
             "channels": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 8
+              "maximum": 16
             },
             "frames": {
               "type": "integer",
@@ -142,12 +142,12 @@
             "pathCount": {
               "type": "integer",
               "minimum": 0,
-              "maximum": 8
+              "maximum": 16
             },
             "paths": {
               "type": "array",
               "minItems": 1,
-              "maxItems": 8,
+              "maxItems": 16,
               "description": "Matrix routes. Distinct inputSlot values must be exactly 0..N-1, and N must not exceed the selected effect processing-channel count.",
               "items": {
                 "type": "object",
@@ -161,18 +161,18 @@
                   "inputSlot": {
                     "type": "integer",
                     "minimum": 0,
-                    "maximum": 7,
+                    "maximum": 15,
                     "description": "Zero-based matrix input; the set of input slots must be contiguous from 0."
                   },
                   "outputSlot": {
                     "type": "integer",
                     "minimum": 0,
-                    "maximum": 7
+                    "maximum": 15
                   },
                   "irChannel": {
                     "type": "integer",
                     "minimum": 0,
-                    "maximum": 7
+                    "maximum": 15
                   }
                 }
               }
@@ -198,7 +198,7 @@
                   "pathCount": {
                     "type": "integer",
                     "minimum": 1,
-                    "maximum": 8
+                    "maximum": 16
                   }
                 }
               },

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

@@ -39,9 +39,21 @@
         "6",
         "7",
         "8",
+        "9",
+        "10",
+        "11",
+        "12",
+        "13",
+        "14",
+        "15",
+        "16",
         "34",
         "56",
-        "78"
+        "78",
+        "910",
+        "1112",
+        "1314",
+        "1516"
       ],
       "default": "all"
     },
@@ -780,7 +792,7 @@
             "matrixRoutes": {
               "type": "string",
               "maxLength": 3072,
-              "pattern": "^(?:p?[0-8][0-8])*$",
+              "pattern": "^(?:p?[0-9a-f][0-9a-f])*$",
               "default": "0011"
             }
           }
@@ -816,12 +828,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,
@@ -834,12 +854,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,
@@ -852,8 +880,8 @@
             },
             "volume": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": -20,
@@ -861,6 +889,14 @@
                 "x-effetune-unit": "dB"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -873,8 +909,8 @@
             },
             "delay": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": 0,
@@ -882,6 +918,14 @@
                 "x-effetune-unit": "ms"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -894,12 +938,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,
@@ -5164,7 +5216,7 @@
               "type": "number",
               "minimum": 0,
               "maximum": 10,
-              "default": 0
+              "default": 10
             },
             "wear": {
               "type": "integer",
@@ -6405,7 +6457,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }
@@ -6491,7 +6543,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }

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"
     },
@@ -805,7 +817,7 @@
             "matrixRoutes": {
               "type": "string",
               "maxLength": 3072,
-              "pattern": "^(?:p?[0-8][0-8])*$",
+              "pattern": "^(?:p?[0-9a-f][0-9a-f])*$",
               "default": "0011"
             }
           }
@@ -841,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,
@@ -859,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,
@@ -877,8 +905,8 @@
             },
             "volume": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": -20,
@@ -886,6 +914,14 @@
                 "x-effetune-unit": "dB"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -898,8 +934,8 @@
             },
             "delay": {
               "type": "array",
-              "minItems": 8,
-              "maxItems": 8,
+              "minItems": 16,
+              "maxItems": 16,
               "items": {
                 "type": "number",
                 "minimum": 0,
@@ -907,6 +943,14 @@
                 "x-effetune-unit": "ms"
               },
               "default": [
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
                 0,
                 0,
                 0,
@@ -919,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,
@@ -5189,7 +5241,7 @@
               "type": "number",
               "minimum": 0,
               "maximum": 10,
-              "default": 0
+              "default": 10
             },
             "wear": {
               "type": "integer",
@@ -6430,7 +6482,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }
@@ -6516,7 +6568,7 @@
               "minimum": -36,
               "maximum": 36,
               "x-effetune-unit": "dB",
-              "default": 30
+              "default": 26
             }
           }
         }

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,
@@ -231,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)) {
@@ -238,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 {
@@ -249,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)
@@ -302,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;
 }
 
@@ -328,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 };
@@ -338,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.6.0",
+  "version": "0.7.0",
   "description": "EffeTune's deterministic WebAssembly audio effects for JavaScript and AudioWorklet",
   "type": "module",
   "license": "MIT",