@effetune/dsp 0.4.0 → 0.5.0

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,7 +1,7 @@
 // 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";
+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 EffectChannel = "all" | "stereo" | "left" | "right" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "34" | "56" | "78";
 
@@ -1004,6 +1004,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 +1079,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 +1134,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 +1315,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 +1466,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 +1475,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 +1485,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 +1544,27 @@ 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 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;
@@ -1491,8 +1637,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 +1666,7 @@ export interface EffectOptionsByType {
   readonly CrossfeedFilter: CrossfeedFilterOptions;
   readonly MSMatrix: MSMatrixOptions;
   readonly MultibandBalance: MultibandBalanceOptions;
+  readonly PhaseSelectEQ: PhaseSelectEQOptions;
   readonly StereoBlend: StereoBlendOptions;
 }
 
@@ -1577,8 +1730,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 +1759,7 @@ export interface EffectClassByType {
   readonly CrossfeedFilter: CrossfeedFilter;
   readonly MSMatrix: MSMatrix;
   readonly MultibandBalance: MultibandBalance;
+  readonly PhaseSelectEQ: PhaseSelectEQ;
   readonly StereoBlend: StereoBlend;
 }