@waveform-playlist/browser 15.0.0 → 15.2.0

package/dist/tone.d.mts

@@ -1,8 +1,10 @@
-import { TrackEffectsFunction as TrackEffectsFunction$1, Fade, WaveformDataObject, RenderMode, SpectrogramConfig, ColorMapValue, ClipTrack } from '@waveform-playlist/core';
+import { TrackEffectsFunction, Fade, WaveformDataObject, RenderMode, SpectrogramConfig, ColorMapValue, ClipTrack } from '@waveform-playlist/core';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { EffectsFunction, TrackEffectsFunction as TrackEffectsFunction$2 } from '@waveform-playlist/playout';
-import { Analyser, ToneAudioNode, InputNode } from 'tone';
+import { EffectsFunction, TrackEffectsFunction as TrackEffectsFunction$1 } from '@waveform-playlist/playout';
+import { Analyser, Volume, ToneAudioNode, Gain, InputNode } from 'tone';
+import * as _dawcore_wam from '@dawcore/wam';
+import { WamPluginInstance } from '@dawcore/wam';
 
 /**
  * Configuration for a single audio track to load
@@ -26,7 +28,7 @@ interface AudioTrackConfig {
     volume?: number;
     pan?: number;
     color?: string;
-    effects?: TrackEffectsFunction$1;
+    effects?: TrackEffectsFunction;
     startTime?: number;
     duration?: number;
     offset?: number;
@@ -142,7 +144,7 @@ interface EffectParameter {
 interface EffectDefinition {
     id: string;
     name: string;
-    category: 'delay' | 'reverb' | 'modulation' | 'distortion' | 'filter' | 'dynamics' | 'spatial';
+    category: 'delay' | 'reverb' | 'modulation' | 'distortion' | 'filter' | 'dynamics' | 'spatial' | 'wam';
     description: string;
     parameters: EffectParameter[];
 }
@@ -154,66 +156,6 @@ declare const effectCategories: {
     name: string;
 }[];
 
-interface ActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface UseDynamicEffectsReturn {
-    activeEffects: ActiveEffect[];
-    availableEffects: EffectDefinition[];
-    addEffect: (effectId: string) => void;
-    removeEffect: (instanceId: string) => void;
-    updateParameter: (instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (instanceId: string) => void;
-    reorderEffects: (fromIndex: number, toIndex: number) => void;
-    clearAllEffects: () => void;
-    masterEffects: EffectsFunction;
-    /**
-     * Creates a fresh effects function for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineEffectsFunction: () => EffectsFunction | undefined;
-    analyserRef: React.RefObject<Analyser | null>;
-}
-/**
- * Hook for managing a dynamic chain of audio effects with real-time parameter updates
- */
-declare function useDynamicEffects(fftSize?: number): UseDynamicEffectsReturn;
-
-interface TrackActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface TrackEffectsState {
-    trackId: string;
-    activeEffects: TrackActiveEffect[];
-}
-interface UseTrackDynamicEffectsReturn {
-    trackEffectsState: Map<string, TrackActiveEffect[]>;
-    addEffectToTrack: (trackId: string, effectId: string) => void;
-    removeEffectFromTrack: (trackId: string, instanceId: string) => void;
-    updateTrackEffectParameter: (trackId: string, instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (trackId: string, instanceId: string) => void;
-    clearTrackEffects: (trackId: string) => void;
-    getTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$2 | undefined;
-    /**
-     * Creates a fresh effects function for a track for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$2 | undefined;
-    availableEffects: EffectDefinition[];
-}
-/**
- * Hook for managing dynamic effects per track with real-time parameter updates
- */
-declare function useTrackDynamicEffects(): UseTrackDynamicEffectsReturn;
-
 /**
  * WAV file encoder
  * Converts AudioBuffer to WAV format Blob
@@ -223,8 +165,16 @@ interface WavEncoderOptions {
     bitDepth?: 16 | 32;
 }
 
-/** Function type for per-track effects (same as in @waveform-playlist/core) */
-type TrackEffectsFunction = (graphEnd: unknown, destination: unknown, isOffline: boolean) => void | (() => void);
+/** Cleanup returned by an offline effects function (disposes offline instances / WAM clones). */
+type OfflineEffectsCleanup = void | (() => void);
+/**
+ * Master-chain effects function for offline rendering. May return a Promise —
+ * WAM entries are re-instantiated asynchronously on the offline context.
+ * Every live EffectsFunction is assignable to this type.
+ */
+type OfflineEffectsFunction = (masterVolume: Volume, destination: ToneAudioNode, isOffline: boolean) => OfflineEffectsCleanup | Promise<OfflineEffectsCleanup>;
+/** Per-track variant of OfflineEffectsFunction. */
+type OfflineTrackEffectsFunction = (graphEnd: Gain, masterGainNode: ToneAudioNode, isOffline: boolean) => OfflineEffectsCleanup | Promise<OfflineEffectsCleanup>;
 interface ExportOptions extends WavEncoderOptions {
     /** Filename for download (without extension) */
     filename?: string;
@@ -237,16 +187,17 @@ interface ExportOptions extends WavEncoderOptions {
     /** Whether to apply effects (fades, etc.) - defaults to true */
     applyEffects?: boolean;
     /**
-     * Optional Tone.js effects function for master effects. When provided, export renders
-     * through the effects chain. The function receives isOffline=true.
+     * Optional effects function for master effects. When provided, export renders
+     * through the effects chain (WAM entries included — re-instantiated on the
+     * offline context). The function receives isOffline=true and may be async.
      */
-    effectsFunction?: EffectsFunction;
+    effectsFunction?: OfflineEffectsFunction;
     /**
      * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
+     * Takes a trackId and returns an offline effects function for that track.
      * This is used instead of track.effects to avoid AudioContext mismatch issues.
      */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
+    createOfflineTrackEffects?: (trackId: string) => OfflineTrackEffectsFunction | undefined;
     /** Progress callback (0-1) */
     onProgress?: (progress: number) => void;
 }
@@ -276,10 +227,104 @@ interface TrackState {
 }
 /**
  * Hook for exporting the waveform playlist to WAV format.
- * Uses Tone.Offline for non-real-time rendering, mirroring the live playback graph.
+ * Uses a Tone offline render (native OfflineAudioContext in native-context mode),
+ * mirroring the live playback graph.
  */
 declare function useExportWav(): UseExportWavReturn;
 
+interface ActiveEffect {
+    instanceId: string;
+    effectId: string;
+    /** 'native' = built-in Tone effect; 'wam' = hosted WAM plugin. */
+    kind: 'native' | 'wam';
+    /** Module URL for wam entries. */
+    url?: string;
+    definition: EffectDefinition;
+    params: Record<string, number | string | boolean>;
+    bypassed: boolean;
+}
+interface UseDynamicEffectsReturn {
+    activeEffects: ActiveEffect[];
+    availableEffects: EffectDefinition[];
+    addEffect: (effectId: string) => void;
+    /**
+     * Hosts a WAM plugin from a module URL and appends it to the master chain.
+     * Requires native-context mode — call configureGlobalContext({ nativeAudioContext: true })
+     * from @waveform-playlist/playout before any audio initialization.
+     * WAM entries render in offline WAV export (re-instantiated on the offline context).
+     * Resolves with the new entry's instanceId.
+     */
+    addWamEffect: (url: string, initialState?: unknown) => Promise<string>;
+    /** Live plugin handle for a hosted WAM entry (for GUI mounting via WamEffectGui). */
+    getWamPlugin: (instanceId: string) => WamPluginInstance | undefined;
+    removeEffect: (instanceId: string) => void;
+    updateParameter: (instanceId: string, paramName: string, value: number | string | boolean) => void;
+    toggleBypass: (instanceId: string) => void;
+    reorderEffects: (fromIndex: number, toIndex: number) => void;
+    clearAllEffects: () => void;
+    masterEffects: EffectsFunction;
+    /**
+     * Creates a fresh effects function for offline rendering. Native effects are
+     * re-created on the offline context; WAM entries are re-instantiated from
+     * their URL-cached factories with the live instance's state transferred.
+     * The returned function may be async and may reject — a WAV export never
+     * silently renders without an effect the live chain has.
+     */
+    createOfflineEffectsFunction: () => OfflineEffectsFunction | undefined;
+    analyserRef: React.RefObject<Analyser | null>;
+}
+/**
+ * Hook for managing a dynamic chain of audio effects with real-time parameter updates
+ */
+declare function useDynamicEffects(fftSize?: number): UseDynamicEffectsReturn;
+
+interface TrackActiveEffect {
+    instanceId: string;
+    effectId: string;
+    /** 'native' = built-in Tone effect; 'wam' = hosted WAM plugin. */
+    kind: 'native' | 'wam';
+    /** Module URL for wam entries. */
+    url?: string;
+    definition: EffectDefinition;
+    params: Record<string, number | string | boolean>;
+    bypassed: boolean;
+}
+interface TrackEffectsState {
+    trackId: string;
+    activeEffects: TrackActiveEffect[];
+}
+interface UseTrackDynamicEffectsReturn {
+    trackEffectsState: Map<string, TrackActiveEffect[]>;
+    addEffectToTrack: (trackId: string, effectId: string) => void;
+    /**
+     * Hosts a WAM plugin from a module URL and appends it to a track's effect chain.
+     * Requires native-context mode — call configureGlobalContext({ nativeAudioContext: true })
+     * from @waveform-playlist/playout before any audio initialization.
+     * WAM entries render in offline WAV export (re-instantiated on the offline context).
+     * Resolves with the new entry's instanceId.
+     */
+    addWamEffectToTrack: (trackId: string, url: string, initialState?: unknown) => Promise<string>;
+    /** Live plugin handle for a hosted WAM entry on a track (for GUI mounting via WamEffectGui). */
+    getTrackWamPlugin: (trackId: string, instanceId: string) => WamPluginInstance | undefined;
+    removeEffectFromTrack: (trackId: string, instanceId: string) => void;
+    updateTrackEffectParameter: (trackId: string, instanceId: string, paramName: string, value: number | string | boolean) => void;
+    toggleBypass: (trackId: string, instanceId: string) => void;
+    clearTrackEffects: (trackId: string) => void;
+    getTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$1 | undefined;
+    /**
+     * Creates a fresh effects function for a track for offline rendering.
+     * Native effects are re-created on the offline context; WAM entries are
+     * re-instantiated with the live instance's state transferred. May reject —
+     * a WAV export never silently renders without an effect the live chain has.
+     */
+    createOfflineTrackEffectsFunction: (trackId: string) => OfflineTrackEffectsFunction | undefined;
+    availableEffects: EffectDefinition[];
+}
+/**
+ * Hook for managing dynamic effects per track with real-time parameter updates
+ */
+declare function useTrackDynamicEffects(): UseTrackDynamicEffectsReturn;
+
 /**
  * useDynamicTracks — imperative hook for runtime track additions.
  *
@@ -372,7 +417,7 @@ declare function useOutputMeter(options?: UseOutputMeterOptions): UseOutputMeter
  */
 
 interface EffectInstance {
-    effect: ToneAudioNode;
+    effect: ToneAudioNode | AudioNode;
     id: string;
     instanceId: string;
     dispose: () => void;
@@ -389,8 +434,8 @@ declare function createEffectInstance(definition: EffectDefinition, initialParam
  * Create a chain of effects connected in series
  */
 declare function createEffectChain(effects: EffectInstance[]): {
-    input: ToneAudioNode;
-    output: ToneAudioNode;
+    input: ToneAudioNode | AudioNode;
+    output: ToneAudioNode | AudioNode;
     dispose: () => void;
 };
 
@@ -408,15 +453,15 @@ interface ExportWavButtonProps {
     /** Whether to apply effects (fades, etc.) - defaults to true */
     applyEffects?: boolean;
     /**
-     * Optional Tone.js effects function for master effects. When provided, export will use Tone.Offline
-     * to render through the effects chain. The function receives isOffline=true.
+     * Optional effects function for master effects. When provided, export renders
+     * through the effects chain (WAM entries included). May be async.
      */
-    effectsFunction?: EffectsFunction;
+    effectsFunction?: OfflineEffectsFunction;
     /**
      * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
+     * Takes a trackId and returns an offline effects function for that track.
      */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
+    createOfflineTrackEffects?: (trackId: string) => OfflineTrackEffectsFunction | undefined;
     /** CSS class name */
     className?: string;
     /** Callback when export completes */
@@ -426,4 +471,33 @@ interface ExportWavButtonProps {
 }
 declare const ExportWavButton: React__default.FC<ExportWavButtonProps>;
 
-export { type ActiveEffect, type AudioTrackConfig, type EffectDefinition, type EffectInstance, type EffectParameter, type ExportOptions, type ExportResult, ExportWavButton, type ExportWavButtonProps, type ParameterType, type TrackActiveEffect, type TrackEffectsState, type TrackLoadError, type TrackSource, type UseDynamicEffectsReturn, type UseDynamicTracksReturn, type UseExportWavReturn, type UseOutputMeterOptions, type UseOutputMeterReturn, type UseTrackDynamicEffectsReturn, createEffectChain, createEffectInstance, effectCategories, effectDefinitions, getEffectDefinition, getEffectsByCategory, useAudioTracks, useDynamicEffects, useDynamicTracks, useExportWav, useMasterAnalyser, useOutputMeter, useTrackDynamicEffects };
+interface WamEffectGuiProps {
+    /** Live plugin handle from getWamPlugin/getTrackWamPlugin. */
+    plugin: WamPluginInstance | undefined;
+    className?: string;
+}
+/**
+ * Mounts a WAM plugin's own GUI (plugin.createGui), falling back to the
+ * generic parameter panel from @dawcore/wam for headless plugins. The GUI is
+ * destroyed on unmount — GUI and audio lifecycles are independent, so this
+ * never interrupts sound.
+ */
+declare const WamEffectGui: React__default.FC<WamEffectGuiProps>;
+
+/**
+ * Dynamic loader for the optional '@dawcore/wam' peer (the @dawcore/midi
+ * loadMidiImpl pattern). Keeps WAM hosting out of the bundle for consumers
+ * that never use it; `import type` from '@dawcore/wam' elsewhere is fine
+ * (erased at runtime).
+ */
+type WamModule = typeof _dawcore_wam;
+declare function loadWamModule(): Promise<WamModule>;
+
+interface WamEffectInstance extends EffectInstance {
+    kind: 'wam';
+    plugin: WamPluginInstance;
+    url?: string;
+}
+declare function createWamEffectInstance(plugin: WamPluginInstance): WamEffectInstance;
+
+export { type ActiveEffect, type AudioTrackConfig, type EffectDefinition, type EffectInstance, type EffectParameter, type ExportOptions, type ExportResult, ExportWavButton, type ExportWavButtonProps, type OfflineEffectsCleanup, type OfflineEffectsFunction, type OfflineTrackEffectsFunction, type ParameterType, type TrackActiveEffect, type TrackEffectsState, type TrackLoadError, type TrackSource, type UseDynamicEffectsReturn, type UseDynamicTracksReturn, type UseExportWavReturn, type UseOutputMeterOptions, type UseOutputMeterReturn, type UseTrackDynamicEffectsReturn, WamEffectGui, type WamEffectGuiProps, type WamEffectInstance, createEffectChain, createEffectInstance, createWamEffectInstance, effectCategories, effectDefinitions, getEffectDefinition, getEffectsByCategory, loadWamModule, useAudioTracks, useDynamicEffects, useDynamicTracks, useExportWav, useMasterAnalyser, useOutputMeter, useTrackDynamicEffects };

package/dist/tone.d.ts

@@ -1,8 +1,10 @@
-import { TrackEffectsFunction as TrackEffectsFunction$1, Fade, WaveformDataObject, RenderMode, SpectrogramConfig, ColorMapValue, ClipTrack } from '@waveform-playlist/core';
+import { TrackEffectsFunction, Fade, WaveformDataObject, RenderMode, SpectrogramConfig, ColorMapValue, ClipTrack } from '@waveform-playlist/core';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { EffectsFunction, TrackEffectsFunction as TrackEffectsFunction$2 } from '@waveform-playlist/playout';
-import { Analyser, ToneAudioNode, InputNode } from 'tone';
+import { EffectsFunction, TrackEffectsFunction as TrackEffectsFunction$1 } from '@waveform-playlist/playout';
+import { Analyser, Volume, ToneAudioNode, Gain, InputNode } from 'tone';
+import * as _dawcore_wam from '@dawcore/wam';
+import { WamPluginInstance } from '@dawcore/wam';
 
 /**
  * Configuration for a single audio track to load
@@ -26,7 +28,7 @@ interface AudioTrackConfig {
     volume?: number;
     pan?: number;
     color?: string;
-    effects?: TrackEffectsFunction$1;
+    effects?: TrackEffectsFunction;
     startTime?: number;
     duration?: number;
     offset?: number;
@@ -142,7 +144,7 @@ interface EffectParameter {
 interface EffectDefinition {
     id: string;
     name: string;
-    category: 'delay' | 'reverb' | 'modulation' | 'distortion' | 'filter' | 'dynamics' | 'spatial';
+    category: 'delay' | 'reverb' | 'modulation' | 'distortion' | 'filter' | 'dynamics' | 'spatial' | 'wam';
     description: string;
     parameters: EffectParameter[];
 }
@@ -154,66 +156,6 @@ declare const effectCategories: {
     name: string;
 }[];
 
-interface ActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface UseDynamicEffectsReturn {
-    activeEffects: ActiveEffect[];
-    availableEffects: EffectDefinition[];
-    addEffect: (effectId: string) => void;
-    removeEffect: (instanceId: string) => void;
-    updateParameter: (instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (instanceId: string) => void;
-    reorderEffects: (fromIndex: number, toIndex: number) => void;
-    clearAllEffects: () => void;
-    masterEffects: EffectsFunction;
-    /**
-     * Creates a fresh effects function for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineEffectsFunction: () => EffectsFunction | undefined;
-    analyserRef: React.RefObject<Analyser | null>;
-}
-/**
- * Hook for managing a dynamic chain of audio effects with real-time parameter updates
- */
-declare function useDynamicEffects(fftSize?: number): UseDynamicEffectsReturn;
-
-interface TrackActiveEffect {
-    instanceId: string;
-    effectId: string;
-    definition: EffectDefinition;
-    params: Record<string, number | string | boolean>;
-    bypassed: boolean;
-}
-interface TrackEffectsState {
-    trackId: string;
-    activeEffects: TrackActiveEffect[];
-}
-interface UseTrackDynamicEffectsReturn {
-    trackEffectsState: Map<string, TrackActiveEffect[]>;
-    addEffectToTrack: (trackId: string, effectId: string) => void;
-    removeEffectFromTrack: (trackId: string, instanceId: string) => void;
-    updateTrackEffectParameter: (trackId: string, instanceId: string, paramName: string, value: number | string | boolean) => void;
-    toggleBypass: (trackId: string, instanceId: string) => void;
-    clearTrackEffects: (trackId: string) => void;
-    getTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$2 | undefined;
-    /**
-     * Creates a fresh effects function for a track for offline rendering.
-     * This creates new effect instances that work in the offline AudioContext.
-     */
-    createOfflineTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$2 | undefined;
-    availableEffects: EffectDefinition[];
-}
-/**
- * Hook for managing dynamic effects per track with real-time parameter updates
- */
-declare function useTrackDynamicEffects(): UseTrackDynamicEffectsReturn;
-
 /**
  * WAV file encoder
  * Converts AudioBuffer to WAV format Blob
@@ -223,8 +165,16 @@ interface WavEncoderOptions {
     bitDepth?: 16 | 32;
 }
 
-/** Function type for per-track effects (same as in @waveform-playlist/core) */
-type TrackEffectsFunction = (graphEnd: unknown, destination: unknown, isOffline: boolean) => void | (() => void);
+/** Cleanup returned by an offline effects function (disposes offline instances / WAM clones). */
+type OfflineEffectsCleanup = void | (() => void);
+/**
+ * Master-chain effects function for offline rendering. May return a Promise —
+ * WAM entries are re-instantiated asynchronously on the offline context.
+ * Every live EffectsFunction is assignable to this type.
+ */
+type OfflineEffectsFunction = (masterVolume: Volume, destination: ToneAudioNode, isOffline: boolean) => OfflineEffectsCleanup | Promise<OfflineEffectsCleanup>;
+/** Per-track variant of OfflineEffectsFunction. */
+type OfflineTrackEffectsFunction = (graphEnd: Gain, masterGainNode: ToneAudioNode, isOffline: boolean) => OfflineEffectsCleanup | Promise<OfflineEffectsCleanup>;
 interface ExportOptions extends WavEncoderOptions {
     /** Filename for download (without extension) */
     filename?: string;
@@ -237,16 +187,17 @@ interface ExportOptions extends WavEncoderOptions {
     /** Whether to apply effects (fades, etc.) - defaults to true */
     applyEffects?: boolean;
     /**
-     * Optional Tone.js effects function for master effects. When provided, export renders
-     * through the effects chain. The function receives isOffline=true.
+     * Optional effects function for master effects. When provided, export renders
+     * through the effects chain (WAM entries included — re-instantiated on the
+     * offline context). The function receives isOffline=true and may be async.
      */
-    effectsFunction?: EffectsFunction;
+    effectsFunction?: OfflineEffectsFunction;
     /**
      * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
+     * Takes a trackId and returns an offline effects function for that track.
      * This is used instead of track.effects to avoid AudioContext mismatch issues.
      */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
+    createOfflineTrackEffects?: (trackId: string) => OfflineTrackEffectsFunction | undefined;
     /** Progress callback (0-1) */
     onProgress?: (progress: number) => void;
 }
@@ -276,10 +227,104 @@ interface TrackState {
 }
 /**
  * Hook for exporting the waveform playlist to WAV format.
- * Uses Tone.Offline for non-real-time rendering, mirroring the live playback graph.
+ * Uses a Tone offline render (native OfflineAudioContext in native-context mode),
+ * mirroring the live playback graph.
  */
 declare function useExportWav(): UseExportWavReturn;
 
+interface ActiveEffect {
+    instanceId: string;
+    effectId: string;
+    /** 'native' = built-in Tone effect; 'wam' = hosted WAM plugin. */
+    kind: 'native' | 'wam';
+    /** Module URL for wam entries. */
+    url?: string;
+    definition: EffectDefinition;
+    params: Record<string, number | string | boolean>;
+    bypassed: boolean;
+}
+interface UseDynamicEffectsReturn {
+    activeEffects: ActiveEffect[];
+    availableEffects: EffectDefinition[];
+    addEffect: (effectId: string) => void;
+    /**
+     * Hosts a WAM plugin from a module URL and appends it to the master chain.
+     * Requires native-context mode — call configureGlobalContext({ nativeAudioContext: true })
+     * from @waveform-playlist/playout before any audio initialization.
+     * WAM entries render in offline WAV export (re-instantiated on the offline context).
+     * Resolves with the new entry's instanceId.
+     */
+    addWamEffect: (url: string, initialState?: unknown) => Promise<string>;
+    /** Live plugin handle for a hosted WAM entry (for GUI mounting via WamEffectGui). */
+    getWamPlugin: (instanceId: string) => WamPluginInstance | undefined;
+    removeEffect: (instanceId: string) => void;
+    updateParameter: (instanceId: string, paramName: string, value: number | string | boolean) => void;
+    toggleBypass: (instanceId: string) => void;
+    reorderEffects: (fromIndex: number, toIndex: number) => void;
+    clearAllEffects: () => void;
+    masterEffects: EffectsFunction;
+    /**
+     * Creates a fresh effects function for offline rendering. Native effects are
+     * re-created on the offline context; WAM entries are re-instantiated from
+     * their URL-cached factories with the live instance's state transferred.
+     * The returned function may be async and may reject — a WAV export never
+     * silently renders without an effect the live chain has.
+     */
+    createOfflineEffectsFunction: () => OfflineEffectsFunction | undefined;
+    analyserRef: React.RefObject<Analyser | null>;
+}
+/**
+ * Hook for managing a dynamic chain of audio effects with real-time parameter updates
+ */
+declare function useDynamicEffects(fftSize?: number): UseDynamicEffectsReturn;
+
+interface TrackActiveEffect {
+    instanceId: string;
+    effectId: string;
+    /** 'native' = built-in Tone effect; 'wam' = hosted WAM plugin. */
+    kind: 'native' | 'wam';
+    /** Module URL for wam entries. */
+    url?: string;
+    definition: EffectDefinition;
+    params: Record<string, number | string | boolean>;
+    bypassed: boolean;
+}
+interface TrackEffectsState {
+    trackId: string;
+    activeEffects: TrackActiveEffect[];
+}
+interface UseTrackDynamicEffectsReturn {
+    trackEffectsState: Map<string, TrackActiveEffect[]>;
+    addEffectToTrack: (trackId: string, effectId: string) => void;
+    /**
+     * Hosts a WAM plugin from a module URL and appends it to a track's effect chain.
+     * Requires native-context mode — call configureGlobalContext({ nativeAudioContext: true })
+     * from @waveform-playlist/playout before any audio initialization.
+     * WAM entries render in offline WAV export (re-instantiated on the offline context).
+     * Resolves with the new entry's instanceId.
+     */
+    addWamEffectToTrack: (trackId: string, url: string, initialState?: unknown) => Promise<string>;
+    /** Live plugin handle for a hosted WAM entry on a track (for GUI mounting via WamEffectGui). */
+    getTrackWamPlugin: (trackId: string, instanceId: string) => WamPluginInstance | undefined;
+    removeEffectFromTrack: (trackId: string, instanceId: string) => void;
+    updateTrackEffectParameter: (trackId: string, instanceId: string, paramName: string, value: number | string | boolean) => void;
+    toggleBypass: (trackId: string, instanceId: string) => void;
+    clearTrackEffects: (trackId: string) => void;
+    getTrackEffectsFunction: (trackId: string) => TrackEffectsFunction$1 | undefined;
+    /**
+     * Creates a fresh effects function for a track for offline rendering.
+     * Native effects are re-created on the offline context; WAM entries are
+     * re-instantiated with the live instance's state transferred. May reject —
+     * a WAV export never silently renders without an effect the live chain has.
+     */
+    createOfflineTrackEffectsFunction: (trackId: string) => OfflineTrackEffectsFunction | undefined;
+    availableEffects: EffectDefinition[];
+}
+/**
+ * Hook for managing dynamic effects per track with real-time parameter updates
+ */
+declare function useTrackDynamicEffects(): UseTrackDynamicEffectsReturn;
+
 /**
  * useDynamicTracks — imperative hook for runtime track additions.
  *
@@ -372,7 +417,7 @@ declare function useOutputMeter(options?: UseOutputMeterOptions): UseOutputMeter
  */
 
 interface EffectInstance {
-    effect: ToneAudioNode;
+    effect: ToneAudioNode | AudioNode;
     id: string;
     instanceId: string;
     dispose: () => void;
@@ -389,8 +434,8 @@ declare function createEffectInstance(definition: EffectDefinition, initialParam
  * Create a chain of effects connected in series
  */
 declare function createEffectChain(effects: EffectInstance[]): {
-    input: ToneAudioNode;
-    output: ToneAudioNode;
+    input: ToneAudioNode | AudioNode;
+    output: ToneAudioNode | AudioNode;
     dispose: () => void;
 };
 
@@ -408,15 +453,15 @@ interface ExportWavButtonProps {
     /** Whether to apply effects (fades, etc.) - defaults to true */
     applyEffects?: boolean;
     /**
-     * Optional Tone.js effects function for master effects. When provided, export will use Tone.Offline
-     * to render through the effects chain. The function receives isOffline=true.
+     * Optional effects function for master effects. When provided, export renders
+     * through the effects chain (WAM entries included). May be async.
      */
-    effectsFunction?: EffectsFunction;
+    effectsFunction?: OfflineEffectsFunction;
     /**
      * Optional function to create offline track effects.
-     * Takes a trackId and returns a TrackEffectsFunction for offline rendering.
+     * Takes a trackId and returns an offline effects function for that track.
      */
-    createOfflineTrackEffects?: (trackId: string) => TrackEffectsFunction | undefined;
+    createOfflineTrackEffects?: (trackId: string) => OfflineTrackEffectsFunction | undefined;
     /** CSS class name */
     className?: string;
     /** Callback when export completes */
@@ -426,4 +471,33 @@ interface ExportWavButtonProps {
 }
 declare const ExportWavButton: React__default.FC<ExportWavButtonProps>;
 
-export { type ActiveEffect, type AudioTrackConfig, type EffectDefinition, type EffectInstance, type EffectParameter, type ExportOptions, type ExportResult, ExportWavButton, type ExportWavButtonProps, type ParameterType, type TrackActiveEffect, type TrackEffectsState, type TrackLoadError, type TrackSource, type UseDynamicEffectsReturn, type UseDynamicTracksReturn, type UseExportWavReturn, type UseOutputMeterOptions, type UseOutputMeterReturn, type UseTrackDynamicEffectsReturn, createEffectChain, createEffectInstance, effectCategories, effectDefinitions, getEffectDefinition, getEffectsByCategory, useAudioTracks, useDynamicEffects, useDynamicTracks, useExportWav, useMasterAnalyser, useOutputMeter, useTrackDynamicEffects };
+interface WamEffectGuiProps {
+    /** Live plugin handle from getWamPlugin/getTrackWamPlugin. */
+    plugin: WamPluginInstance | undefined;
+    className?: string;
+}
+/**
+ * Mounts a WAM plugin's own GUI (plugin.createGui), falling back to the
+ * generic parameter panel from @dawcore/wam for headless plugins. The GUI is
+ * destroyed on unmount — GUI and audio lifecycles are independent, so this
+ * never interrupts sound.
+ */
+declare const WamEffectGui: React__default.FC<WamEffectGuiProps>;
+
+/**
+ * Dynamic loader for the optional '@dawcore/wam' peer (the @dawcore/midi
+ * loadMidiImpl pattern). Keeps WAM hosting out of the bundle for consumers
+ * that never use it; `import type` from '@dawcore/wam' elsewhere is fine
+ * (erased at runtime).
+ */
+type WamModule = typeof _dawcore_wam;
+declare function loadWamModule(): Promise<WamModule>;
+
+interface WamEffectInstance extends EffectInstance {
+    kind: 'wam';
+    plugin: WamPluginInstance;
+    url?: string;
+}
+declare function createWamEffectInstance(plugin: WamPluginInstance): WamEffectInstance;
+
+export { type ActiveEffect, type AudioTrackConfig, type EffectDefinition, type EffectInstance, type EffectParameter, type ExportOptions, type ExportResult, ExportWavButton, type ExportWavButtonProps, type OfflineEffectsCleanup, type OfflineEffectsFunction, type OfflineTrackEffectsFunction, type ParameterType, type TrackActiveEffect, type TrackEffectsState, type TrackLoadError, type TrackSource, type UseDynamicEffectsReturn, type UseDynamicTracksReturn, type UseExportWavReturn, type UseOutputMeterOptions, type UseOutputMeterReturn, type UseTrackDynamicEffectsReturn, WamEffectGui, type WamEffectGuiProps, type WamEffectInstance, createEffectChain, createEffectInstance, createWamEffectInstance, effectCategories, effectDefinitions, getEffectDefinition, getEffectsByCategory, loadWamModule, useAudioTracks, useDynamicEffects, useDynamicTracks, useExportWav, useMasterAnalyser, useOutputMeter, useTrackDynamicEffects };