@effetune/dsp 0.1.0 → 0.5.0

package/dist/index.d.ts

@@ -16,10 +16,15 @@ export type {
   DelayOptions,
   TimeAlignmentOptions,
   AMRadioSimulatorOptions,
+  AutoFilterOptions,
   AutoLevelerOptions,
+  AutoPanOptions,
   BandPassFilterOptions,
   BitCrusherOptions,
+  BluetoothSBCSimulatorOptions,
   BrickwallLimiterOptions,
+  CassetteArtifactsOptions,
+  ChorusOptions,
   CombFilterOptions,
   CommonEffectOptions,
   CompressorOptions,
@@ -38,11 +43,14 @@ export type {
   ExpanderOptions,
   FDNReverbOptions,
   FMRadioSimulatorOptions,
+  FrequencyShifterOptions,
   FifteenBandGEQOptions,
   FifteenBandPEQOptions,
   FiveBandDynamicEQOptions,
   FiveBandFIRPEQOptions,
   FiveBandPEQOptions,
+  G726ADPCMSimulatorOptions,
+  GSMFullRateSimulatorOptions,
   GateOptions,
   GroupDelayEQOptions,
   HardClippingOptions,
@@ -55,6 +63,7 @@ export type {
   IRReverbOptions,
   LoPassFilterOptions,
   LoudnessEqualizerOptions,
+  MP3CodecSimulatorOptions,
   MSMatrixOptions,
   ModalResonatorOptions,
   MultibandBalanceOptions,
@@ -65,8 +74,11 @@ export type {
   NarrowRangeOptions,
   NoiseBlenderOptions,
   OscillatorOptions,
+  PhaserOptions,
+  PhaseSelectEQOptions,
   PitchShifterOptions,
   PowerAmpSagOptions,
+  RotarySpeakerOptions,
   RSReverbOptions,
   RoomEQOptions,
   SaturationOptions,
@@ -74,10 +86,12 @@ export type {
   StereoBlendOptions,
   SubSynthOptions,
   SWRadioSimulatorOptions,
+  TapeArtifactsOptions,
   TiltEQOptions,
   ToneControlOptions,
   TransientShaperOptions,
   TremoloOptions,
+  TubeSimulatorOptions,
   VinylArtifactsOptions,
   VinylSimulatorOptions,
   WowFlutterOptions
@@ -100,10 +114,15 @@ export {
   Delay,
   TimeAlignment,
   AMRadioSimulator,
+  AutoFilter,
   AutoLeveler,
+  AutoPan,
   BandPassFilter,
   BitCrusher,
+  BluetoothSBCSimulator,
   BrickwallLimiter,
+  CassetteArtifacts,
+  Chorus,
   CombFilter,
   Compressor,
   CrossfeedFilter,
@@ -120,11 +139,14 @@ export {
   Expander,
   FDNReverb,
   FMRadioSimulator,
+  FrequencyShifter,
   FifteenBandGEQ,
   FifteenBandPEQ,
   FiveBandDynamicEQ,
   FiveBandFIRPEQ,
   FiveBandPEQ,
+  G726ADPCMSimulator,
+  GSMFullRateSimulator,
   Gate,
   GroupDelayEQ,
   HardClipping,
@@ -136,6 +158,7 @@ export {
   IRReverb,
   LoPassFilter,
   LoudnessEqualizer,
+  MP3CodecSimulator,
   MSMatrix,
   ModalResonator,
   MultibandBalance,
@@ -146,8 +169,11 @@ export {
   NarrowRange,
   NoiseBlender,
   Oscillator,
+  Phaser,
+  PhaseSelectEQ,
   PitchShifter,
   PowerAmpSag,
+  RotarySpeaker,
   RSReverb,
   RoomEQ,
   Saturation,
@@ -155,10 +181,12 @@ export {
   StereoBlend,
   SubSynth,
   SWRadioSimulator,
+  TapeArtifacts,
   TiltEQ,
   ToneControl,
   TransientShaper,
   Tremolo,
+  TubeSimulator,
   VinylArtifacts,
   VinylSimulator,
   WowFlutter,
@@ -179,10 +207,15 @@ export {
   createDelay,
   createTimeAlignment,
   createAMRadioSimulator,
+  createAutoFilter,
   createAutoLeveler,
+  createAutoPan,
   createBandPassFilter,
   createBitCrusher,
+  createBluetoothSBCSimulator,
   createBrickwallLimiter,
+  createCassetteArtifacts,
+  createChorus,
   createCombFilter,
   createCompressor,
   createCrossfeedFilter,
@@ -197,11 +230,14 @@ export {
   createExpander,
   createFDNReverb,
   createFMRadioSimulator,
+  createFrequencyShifter,
   createFifteenBandGEQ,
   createFifteenBandPEQ,
   createFiveBandDynamicEQ,
   createFiveBandFIRPEQ,
   createFiveBandPEQ,
+  createG726ADPCMSimulator,
+  createGSMFullRateSimulator,
   createGate,
   createGroupDelayEQ,
   createHardClipping,
@@ -213,6 +249,7 @@ export {
   createIRReverb,
   createLoPassFilter,
   createLoudnessEqualizer,
+  createMP3CodecSimulator,
   createMSMatrix,
   createModalResonator,
   createMultibandBalance,
@@ -223,8 +260,11 @@ export {
   createNarrowRange,
   createNoiseBlender,
   createOscillator,
+  createPhaser,
+  createPhaseSelectEQ,
   createPitchShifter,
   createPowerAmpSag,
+  createRotarySpeaker,
   createRSReverb,
   createRoomEQ,
   createSaturation,
@@ -232,10 +272,12 @@ export {
   createStereoBlend,
   createSubSynth,
   createSWRadioSimulator,
+  createTapeArtifacts,
   createTiltEQ,
   createToneControl,
   createTransientShaper,
   createTremolo,
+  createTubeSimulator,
   createVinylArtifacts,
   createVinylSimulator,
   createWowFlutter
@@ -246,7 +288,12 @@ export type { EffectDefinition } from './effect.js';
 import type { Effect } from './effect.js';
 import type { EffectChannel, EffectType } from './generated-effects.js';
 
-export declare class EffeTuneError extends Error {}
+export declare class EffeTuneError extends Error {
+  readonly code?: string;
+  readonly path?: string;
+  readonly nodeId?: string;
+  readonly edgeId?: string;
+}
 export declare class ValidationError extends EffeTuneError {}
 export declare class EffectError extends EffeTuneError {}
 export declare class AssetError extends EffeTuneError {}
@@ -498,6 +545,226 @@ export declare function createChain(
   options?: CreateChainOptions
 ): Promise<Chain>;
 
+export interface GraphEndpoint {
+  readonly id: string;
+}
+
+export interface GraphNode extends ChainEffect {}
+
+export interface GraphNodeInput extends ChainEffectInput {
+  readonly id: string;
+}
+
+export interface GraphEdge {
+  readonly id: string;
+  readonly source: string;
+  readonly destination: string;
+  readonly gain: number;
+  readonly mute: boolean;
+  readonly pan?: number;
+  readonly mixGroup: string;
+  readonly solo: boolean;
+}
+
+export interface GraphEdgeInput {
+  readonly id: string;
+  readonly source: string;
+  readonly destination: string;
+  readonly gain?: number;
+  readonly mute?: boolean;
+  readonly pan?: number;
+  readonly mixGroup?: string;
+  readonly solo?: boolean;
+}
+
+export interface GraphDocument {
+  readonly version: 1;
+  readonly input: GraphEndpoint;
+  readonly output: GraphEndpoint;
+  readonly nodes: readonly GraphNode[];
+  readonly edges: readonly GraphEdge[];
+}
+
+export interface GraphDocumentInput {
+  readonly version: 1;
+  readonly input: GraphEndpoint;
+  readonly output: GraphEndpoint;
+  readonly nodes: readonly GraphNodeInput[];
+  readonly edges: readonly GraphEdgeInput[];
+}
+
+export interface GraphCompileSnapshot {
+  readonly version: 1;
+  readonly identity: boolean;
+  readonly silence: boolean;
+  readonly effectiveSchedule: readonly string[];
+  readonly nodes: readonly GraphCompileNodeSnapshot[];
+  readonly edges: readonly GraphCompileEdgeSnapshot[];
+  readonly outputLatency: readonly number[];
+  readonly outputCompensation: readonly number[];
+  readonly latencySamples: number;
+  readonly capacity: Readonly<{ bufferSlots: number; workspaceBytes: number }>;
+}
+
+export interface GraphCompileNodeSnapshot {
+  readonly id: string;
+  readonly effective: boolean;
+  readonly dormant: boolean;
+  readonly enabled: boolean;
+  readonly disabledBypass: boolean;
+  readonly scheduleIndex: number | null;
+  readonly bufferSlot: number | null;
+  readonly processingGroup: Readonly<{ firstChannel: number; channelCount: number }>;
+  readonly kernelLatency: number;
+  readonly inputLatency: readonly number[];
+  readonly outputLatency: readonly number[];
+  readonly preNodeCompensation: readonly number[];
+}
+
+export interface GraphCompileEdgeSnapshot {
+  readonly id: string;
+  readonly active: boolean;
+  readonly suppressed: boolean;
+  readonly dormant: boolean;
+  readonly fanInCompensation: readonly number[];
+}
+
+export type GraphVisualizationState =
+  | 'structural'
+  | 'effective'
+  | 'dormant'
+  | 'disabled-bypass'
+  | 'suppressed';
+
+export interface GraphVisualizationEndpoint {
+  readonly id: string;
+  readonly kind: 'input' | 'output';
+}
+
+export interface GraphVisualizationEffectNode {
+  readonly id: string;
+  readonly kind: 'effect';
+  readonly effectType: EffectType;
+  readonly enabled: boolean;
+  readonly effective?: boolean;
+  readonly dormant?: boolean;
+  readonly disabledBypass?: boolean;
+  readonly state: GraphVisualizationState;
+}
+
+export interface GraphVisualizationEdge {
+  readonly id: string;
+  readonly source: string;
+  readonly destination: string;
+  readonly active?: boolean;
+  readonly suppressed?: boolean;
+  readonly dormant?: boolean;
+  readonly state: GraphVisualizationState;
+}
+
+export interface GraphVisualizationSnapshot {
+  readonly version: 1;
+  readonly nodes: readonly (GraphVisualizationEndpoint | GraphVisualizationEffectNode)[];
+  readonly edges: readonly GraphVisualizationEdge[];
+}
+
+export interface GraphStructuralSnapshot {
+  readonly document: GraphDocument;
+  readonly topologicalOrder: readonly string[];
+  readonly incoming: Readonly<Record<string, readonly string[]>>;
+  readonly outgoing: Readonly<Record<string, readonly string[]>>;
+}
+
+export interface CreateGraphOptions extends ArtifactOptions {
+  readonly assetResolver?: AssetResolver | { resolve: AssetResolver };
+}
+
+export interface GraphProcessOptions {
+  readonly sampleRate: number;
+  readonly seed?: number;
+  readonly blockSize?: number;
+}
+
+export interface GraphStreamOptions extends GraphProcessOptions {
+  readonly channels?: number;
+}
+
+export interface GraphRecipeOptions {
+  readonly nodeId?: string;
+  readonly inputId?: string;
+  readonly outputId?: string;
+}
+
+export interface WetDryGraphOptions extends GraphRecipeOptions {
+  readonly wet?: number;
+  readonly dry?: number;
+}
+
+export interface SendReturnGraphOptions extends GraphRecipeOptions {
+  readonly send?: number;
+  readonly returnGain?: number;
+}
+
+export declare class Graph {
+  private constructor();
+  static load(input: string | GraphDocumentInput, options?: CreateGraphOptions): Promise<Graph>;
+  static fromChain(
+    chain: Chain | ChainDocumentInput | readonly (Effect | ChainEffectInput)[],
+    options?: CreateGraphOptions
+  ): Promise<Graph>;
+  static wetDry(effect: Effect | ChainEffectInput, options?: WetDryGraphOptions): GraphDocument;
+  static sendReturn(effect: Effect | ChainEffectInput, options?: SendReturnGraphOptions): GraphDocument;
+  readonly nodes: readonly GraphNode[];
+  readonly edges: readonly GraphEdge[];
+  toJSON(): GraphDocument;
+  toChain(): ChainDocument;
+  serialize(space?: number): string;
+  getNode(id: string): GraphNode | null;
+  getEdge(id: string): GraphEdge | null;
+  incoming(id: string): readonly GraphEdge[];
+  outgoing(id: string): readonly GraphEdge[];
+  structuralSnapshot(): GraphStructuralSnapshot;
+  visualizationSnapshot(): GraphVisualizationSnapshot;
+  stream(options: GraphStreamOptions): Promise<GraphStream>;
+  latencySamples(options: LatencyOptions): Promise<number>;
+  process(audio: readonly Float32Array[], options: GraphProcessOptions): Promise<Float32Array[]>;
+  close(): void;
+}
+
+export declare class GraphStream {
+  readonly graph: GraphDocument;
+  readonly latencySamples: number;
+  readonly compileSnapshot: GraphCompileSnapshot;
+  visualizationSnapshot(): GraphVisualizationSnapshot;
+  setParam(nodeId: string, parameterName: string, value: unknown): this;
+  reset(): this;
+  process(audio: readonly Float32Array[]): Promise<Float32Array[]>;
+  close(): void;
+}
+
+export declare function createGraph(
+  input: string | GraphDocumentInput,
+  options?: CreateGraphOptions
+): Promise<Graph>;
+
+export declare function normalizeGraphDocument(
+  input: string | GraphDocumentInput
+): GraphDocument;
+export declare function graphDocumentFromChain(
+  input: ChainDocumentInput | readonly (Effect | ChainEffectInput)[]
+): GraphDocument;
+export declare function chainDocumentFromGraph(
+  input: GraphDocumentInput
+): ChainDocument;
+export declare function createWetDryGraphDocument(
+  effect: Effect | ChainEffectInput,
+  options?: WetDryGraphOptions
+): GraphDocument;
+export declare function createSendReturnGraphDocument(
+  effect: Effect | ChainEffectInput,
+  options?: SendReturnGraphOptions
+): GraphDocument;
+
 export declare function parsePreset(
   input: string | ChainDocumentInput | readonly (Effect | ChainEffectInput)[]
 ): ChainDocument;

package/dist/index.js

@@ -25,10 +25,15 @@ export {
   Delay,
   TimeAlignment,
   AMRadioSimulator,
+  AutoFilter,
   AutoLeveler,
+  AutoPan,
   BitCrusher,
+  BluetoothSBCSimulator,
   BrickwallLimiter,
   BandPassFilter,
+  CassetteArtifacts,
+  Chorus,
   CombFilter,
   Compressor,
   CrossfeedFilter,
@@ -45,11 +50,14 @@ export {
   Expander,
   FDNReverb,
   FMRadioSimulator,
+  FrequencyShifter,
   FifteenBandGEQ,
   FifteenBandPEQ,
   FiveBandDynamicEQ,
   FiveBandFIRPEQ,
   FiveBandPEQ,
+  G726ADPCMSimulator,
+  GSMFullRateSimulator,
   Gate,
   GroupDelayEQ,
   HardClipping,
@@ -61,6 +69,7 @@ export {
   IRReverb,
   LoPassFilter,
   LoudnessEqualizer,
+  MP3CodecSimulator,
   MSMatrix,
   ModalResonator,
   MultibandBalance,
@@ -71,8 +80,11 @@ export {
   NarrowRange,
   NoiseBlender,
   Oscillator,
+  Phaser,
+  PhaseSelectEQ,
   PitchShifter,
   PowerAmpSag,
+  RotarySpeaker,
   RSReverb,
   RoomEQ,
   Saturation,
@@ -80,10 +92,12 @@ export {
   StereoBlend,
   SubSynth,
   SWRadioSimulator,
+  TapeArtifacts,
   TiltEQ,
   ToneControl,
   TransientShaper,
   Tremolo,
+  TubeSimulator,
   VinylArtifacts,
   VinylSimulator,
   WowFlutter,
@@ -104,10 +118,15 @@ export {
   createDelay,
   createTimeAlignment,
   createAMRadioSimulator,
+  createAutoFilter,
   createAutoLeveler,
+  createAutoPan,
   createBandPassFilter,
   createBitCrusher,
+  createBluetoothSBCSimulator,
   createBrickwallLimiter,
+  createCassetteArtifacts,
+  createChorus,
   createCombFilter,
   createCompressor,
   createCrossfeedFilter,
@@ -122,11 +141,14 @@ export {
   createExpander,
   createFDNReverb,
   createFMRadioSimulator,
+  createFrequencyShifter,
   createFifteenBandGEQ,
   createFifteenBandPEQ,
   createFiveBandDynamicEQ,
   createFiveBandFIRPEQ,
   createFiveBandPEQ,
+  createG726ADPCMSimulator,
+  createGSMFullRateSimulator,
   createGate,
   createGroupDelayEQ,
   createHardClipping,
@@ -138,6 +160,7 @@ export {
   createIRReverb,
   createLoPassFilter,
   createLoudnessEqualizer,
+  createMP3CodecSimulator,
   createMSMatrix,
   createModalResonator,
   createMultibandBalance,
@@ -148,8 +171,11 @@ export {
   createNarrowRange,
   createNoiseBlender,
   createOscillator,
+  createPhaser,
+  createPhaseSelectEQ,
   createPitchShifter,
   createPowerAmpSag,
+  createRotarySpeaker,
   createRSReverb,
   createRoomEQ,
   createSaturation,
@@ -157,10 +183,12 @@ export {
   createStereoBlend,
   createSubSynth,
   createSWRadioSimulator,
+  createTapeArtifacts,
   createTiltEQ,
   createToneControl,
   createTransientShaper,
   createTremolo,
+  createTubeSimulator,
   createVinylArtifacts,
   createVinylSimulator,
   createWowFlutter
@@ -168,6 +196,14 @@ export {
 export { getEffectCatalog } from './catalog.js';
 export { encodeEta1 } from './assets.js';
 export { Chain, createChain, isBundleDocument } from './runtime.js';
+export { Graph, GraphStream, createGraph } from './graph.js';
+export {
+  chainDocumentFromGraph,
+  createSendReturnGraphDocument,
+  createWetDryGraphDocument,
+  graphDocumentFromChain,
+  normalizeGraphDocument
+} from './graph-document.js';
 export { importLegacyPreset, parsePreset } from './preset.js';
 
 import { getEffectCatalog } from './catalog.js';