@effetune/dsp 0.4.0 → 0.6.0

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/errors.js

@@ -2,6 +2,10 @@ export class EffeTuneError extends Error {
   constructor(message, options) {
     super(message, options);
     this.name = new.target.name;
+    if (options?.code !== undefined) this.code = options.code;
+    if (options?.path !== undefined) this.path = options.path;
+    if (options?.nodeId !== undefined) this.nodeId = options.nodeId;
+    if (options?.edgeId !== undefined) this.edgeId = options.edgeId;
   }
 }
 
@@ -29,3 +33,20 @@ export function errorFromMessage(errorType, message, fallback) {
   const ErrorType = ERROR_TYPES[errorType] ?? EffeTuneRuntimeError;
   return new ErrorType(message || fallback);
 }
+
+// Chain-level validation reports the human-readable message; Graph document
+// normalization needs the machine-readable cause to classify the failure. The
+// detail rides on a symbol key so Chain behaviour, serialization and existing
+// error shapes stay unchanged.
+export const VALIDATION_DETAIL = Symbol.for('effetune.validationDetail');
+
+export function withValidationDetail(error, detail) {
+  if (error instanceof EffeTuneError && error[VALIDATION_DETAIL] === undefined) {
+    error[VALIDATION_DETAIL] = detail;
+  }
+  return error;
+}
+
+export function validationDetail(error) {
+  return error?.[VALIDATION_DETAIL];
+}

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" | "DopplerDistortion" | "PitchShifter" | "Tremolo" | "WowFlutter" | "Oscillator" | "HornResonator" | "HornResonatorPlus" | "ModalResonator" | "DattorroPlateReverb" | "FDNReverb" | "IRReverb" | "RSReverb" | "DynamicSaturation" | "Exciter" | "HardClipping" | "HarmonicDistortion" | "MultibandSaturation" | "Saturation" | "SubSynth" | "TubeSimulator" | "CrossfeedFilter" | "MSMatrix" | "MultibandBalance" | "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";
@@ -1004,6 +1031,66 @@ export declare class VinylSimulator extends Effect {
 
 export declare function createVinylSimulator(options?: VinylSimulatorOptions): VinylSimulator;
 
+export interface AutoFilterOptions extends CommonEffectOptions {
+  readonly mode?: "LFO" | "Envelope";
+  readonly filterType?: "Low-pass" | "Band-pass" | "High-pass";
+  readonly minimumFrequency?: number;
+  readonly maximumFrequency?: number;
+  readonly resonance?: number;
+  readonly mix?: number;
+  readonly rate?: number;
+  readonly waveform?: "Sine" | "Triangle";
+  readonly stereoPhase?: number;
+  readonly sensitivity?: number;
+  readonly attack?: number;
+  readonly release?: number;
+  readonly direction?: "Up" | "Down";
+  readonly assets?: never;
+}
+
+export declare class AutoFilter extends Effect {
+  static readonly effectType: "AutoFilter";
+  constructor(options?: AutoFilterOptions);
+}
+
+export declare function createAutoFilter(options?: AutoFilterOptions): AutoFilter;
+
+export interface AutoPanOptions extends CommonEffectOptions {
+  readonly rate?: number;
+  readonly depth?: number;
+  readonly center?: number;
+  readonly width?: number;
+  readonly waveform?: "Sine" | "Triangle";
+  readonly phase?: number;
+  readonly assets?: never;
+}
+
+export declare class AutoPan extends Effect {
+  static readonly effectType: "AutoPan";
+  constructor(options?: AutoPanOptions);
+}
+
+export declare function createAutoPan(options?: AutoPanOptions): AutoPan;
+
+export interface ChorusOptions extends CommonEffectOptions {
+  readonly mode?: "Chorus" | "Stereo Chorus" | "Ensemble" | "Flanger" | "Vibrato";
+  readonly rate?: number;
+  readonly delay?: number;
+  readonly depth?: number;
+  readonly voices?: number;
+  readonly stereoSpread?: number;
+  readonly feedback?: number;
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class Chorus extends Effect {
+  static readonly effectType: "Chorus";
+  constructor(options?: ChorusOptions);
+}
+
+export declare function createChorus(options?: ChorusOptions): Chorus;
+
 export interface DopplerDistortionOptions extends CommonEffectOptions {
   readonly coilForce?: number;
   readonly speakerMass?: number;
@@ -1019,6 +1106,46 @@ export declare class DopplerDistortion extends Effect {
 
 export declare function createDopplerDistortion(options?: DopplerDistortionOptions): DopplerDistortion;
 
+export interface FrequencyShifterOptions extends CommonEffectOptions {
+  readonly mode?: "Shift" | "Ring Mod" | "Barber-pole";
+  readonly shift?: number;
+  readonly carrierFrequency?: number;
+  readonly minimumShift?: number;
+  readonly maximumShift?: number;
+  readonly rate?: number;
+  readonly direction?: "Up" | "Down";
+  readonly stereoPhase?: number;
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class FrequencyShifter extends Effect {
+  static readonly effectType: "FrequencyShifter";
+  constructor(options?: FrequencyShifterOptions);
+}
+
+export declare function createFrequencyShifter(options?: FrequencyShifterOptions): FrequencyShifter;
+
+export interface PhaserOptions extends CommonEffectOptions {
+  readonly mode?: "Classic" | "Barber-pole";
+  readonly rate?: number;
+  readonly centerFrequency?: number;
+  readonly range?: number;
+  readonly stages?: 2 | 4 | 6 | 8 | 10 | 12;
+  readonly feedback?: number;
+  readonly stereoPhase?: number;
+  readonly direction?: "Up" | "Down";
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class Phaser extends Effect {
+  static readonly effectType: "Phaser";
+  constructor(options?: PhaserOptions);
+}
+
+export declare function createPhaser(options?: PhaserOptions): Phaser;
+
 export interface PitchShifterOptions extends CommonEffectOptions {
   readonly pitchShift?: number;
   readonly fineTune?: number;
@@ -1034,6 +1161,26 @@ export declare class PitchShifter extends Effect {
 
 export declare function createPitchShifter(options?: PitchShifterOptions): PitchShifter;
 
+export interface RotarySpeakerOptions extends CommonEffectOptions {
+  readonly speedState?: "Stop" | "Slow" | "Fast";
+  readonly speed?: number;
+  readonly acceleration?: number;
+  readonly crossover?: number;
+  readonly rotorBalance?: number;
+  readonly stereoWidth?: number;
+  readonly dopplerDepth?: number;
+  readonly amplitudeDepth?: number;
+  readonly mix?: number;
+  readonly assets?: never;
+}
+
+export declare class RotarySpeaker extends Effect {
+  static readonly effectType: "RotarySpeaker";
+  constructor(options?: RotarySpeakerOptions);
+}
+
+export declare function createRotarySpeaker(options?: RotarySpeakerOptions): RotarySpeaker;
+
 export interface TremoloOptions extends CommonEffectOptions {
   readonly rate?: number;
   readonly depth?: number;
@@ -1195,6 +1342,7 @@ export interface IRReverbOptions extends CommonEffectOptions {
   readonly latency?: 0 | 128 | 256 | 512 | 1024;
   readonly convolutionRate?: "auto" | "full" | "half" | "quarter";
   readonly wetLevel?: number;
+  readonly dryEnabled?: boolean;
   readonly dryLevel?: number;
   readonly preDelay?: number;
   readonly assets: IRReverbAssets;
@@ -1345,7 +1493,7 @@ export declare function createSubSynth(options?: SubSynthOptions): SubSynth;
 
 export interface TubeSimulatorOptions extends CommonEffectOptions {
   readonly inputVolume?: number;
-  readonly tube?: "12AX7" | "12AT7" | "12AU7";
+  readonly tube?: "12AX7" | "12AT7" | "12AU7" | "Bypass";
   readonly bias?: number;
   readonly plateVoltage?: number;
   readonly sourceImpedance?: number;
@@ -1354,8 +1502,8 @@ export interface TubeSimulatorOptions extends CommonEffectOptions {
   readonly mix?: number;
   readonly inputReference?: number;
   readonly negativeFeedback?: number;
-  readonly outputStage?: "Line" | "Power";
-  readonly powerTube?: "EL84" | "EL34";
+  readonly outputStage?: "Line" | "Power" | "SingleEnded";
+  readonly powerTube?: "EL84" | "EL34" | "6L6GC" | "KT88";
   readonly powerBPlus?: number;
   readonly cathodeResistor?: number;
   readonly screenTap?: "0" | "20" | "43";
@@ -1364,6 +1512,10 @@ export interface TubeSimulatorOptions extends CommonEffectOptions {
   readonly actualSpeakerLoad?: number;
   readonly safetyTrim?: number;
   readonly autoGainReduction?: boolean;
+  readonly seTube?: "300B" | "2A3";
+  readonly seBPlus?: number;
+  readonly seCathodeResistor?: number;
+  readonly sePrimaryImpedance?: "2.5" | "3.5" | "5.0";
   readonly assets?: never;
 }
 
@@ -1419,6 +1571,32 @@ export declare class MultibandBalance extends Effect {
 
 export declare function createMultibandBalance(options?: MultibandBalanceOptions): MultibandBalance;
 
+export interface PhaseSelectEQOptions extends CommonEffectOptions {
+  readonly regionEnabled?: readonly [boolean, boolean, boolean, boolean, boolean];
+  readonly outerFrequencyLow?: readonly [number, number, number, number, number];
+  readonly coreFrequencyLow?: readonly [number, number, number, number, number];
+  readonly coreFrequencyHigh?: readonly [number, number, number, number, number];
+  readonly outerFrequencyHigh?: readonly [number, number, number, number, number];
+  readonly outerPhaseLow?: readonly [number, number, number, number, number];
+  readonly corePhaseLow?: readonly [number, number, number, number, number];
+  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;
+}
+
+export declare class PhaseSelectEQ extends Effect {
+  static readonly effectType: "PhaseSelectEQ";
+  constructor(options?: PhaseSelectEQOptions);
+}
+
+export declare function createPhaseSelectEQ(options?: PhaseSelectEQOptions): PhaseSelectEQ;
+
 export interface StereoBlendOptions extends CommonEffectOptions {
   readonly stereo?: number;
   readonly assets?: never;
@@ -1467,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;
@@ -1484,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;
@@ -1491,8 +1671,14 @@ export interface EffectOptionsByType {
   readonly TapeArtifacts: TapeArtifactsOptions;
   readonly VinylArtifacts: VinylArtifactsOptions;
   readonly VinylSimulator: VinylSimulatorOptions;
+  readonly AutoFilter: AutoFilterOptions;
+  readonly AutoPan: AutoPanOptions;
+  readonly Chorus: ChorusOptions;
   readonly DopplerDistortion: DopplerDistortionOptions;
+  readonly FrequencyShifter: FrequencyShifterOptions;
+  readonly Phaser: PhaserOptions;
   readonly PitchShifter: PitchShifterOptions;
+  readonly RotarySpeaker: RotarySpeakerOptions;
   readonly Tremolo: TremoloOptions;
   readonly WowFlutter: WowFlutterOptions;
   readonly Oscillator: OscillatorOptions;
@@ -1514,6 +1700,7 @@ export interface EffectOptionsByType {
   readonly CrossfeedFilter: CrossfeedFilterOptions;
   readonly MSMatrix: MSMatrixOptions;
   readonly MultibandBalance: MultibandBalanceOptions;
+  readonly PhaseSelectEQ: PhaseSelectEQOptions;
   readonly StereoBlend: StereoBlendOptions;
 }
 
@@ -1553,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;
@@ -1570,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;
@@ -1577,8 +1766,14 @@ export interface EffectClassByType {
   readonly TapeArtifacts: TapeArtifacts;
   readonly VinylArtifacts: VinylArtifacts;
   readonly VinylSimulator: VinylSimulator;
+  readonly AutoFilter: AutoFilter;
+  readonly AutoPan: AutoPan;
+  readonly Chorus: Chorus;
   readonly DopplerDistortion: DopplerDistortion;
+  readonly FrequencyShifter: FrequencyShifter;
+  readonly Phaser: Phaser;
   readonly PitchShifter: PitchShifter;
+  readonly RotarySpeaker: RotarySpeaker;
   readonly Tremolo: Tremolo;
   readonly WowFlutter: WowFlutter;
   readonly Oscillator: Oscillator;
@@ -1600,6 +1795,7 @@ export interface EffectClassByType {
   readonly CrossfeedFilter: CrossfeedFilter;
   readonly MSMatrix: MSMatrix;
   readonly MultibandBalance: MultibandBalance;
+  readonly PhaseSelectEQ: PhaseSelectEQ;
   readonly StereoBlend: StereoBlend;
 }