@signalsandsorcery/plugin-sdk 2.35.2 → 2.35.4

package/dist/index.d.mts

@@ -120,6 +120,38 @@ interface PanelBusState {
     /** User FX chain, top-to-bottom (master section excluded). */
     fx: PanelBusFxEntry[];
 }
+/**
+ * One third-party (VST3/AU) FX insert on a TRACK's plugin chain, as shown to
+ * the panel UI. The track's instrument, the built-in FX-toggle plugins
+ * (reverb/delay/eq/…) and the Volume & Pan master section are filtered OUT —
+ * this list is only the user's external inserts. Same shape as
+ * `PanelBusFxEntry` by design: the drawer and the bus strip share UI idioms.
+ * @since SDK 2.39.0
+ */
+interface TrackExternalFxEntry {
+    /**
+     * ENGINE chain index — pass this back to remove/bypass/editor calls.
+     * Not contiguous from 0: the instrument and built-in FX share the chain.
+     */
+    index: number;
+    /** Scanned plugin id (the picker's `InstrumentDescriptor.pluginId`). */
+    pluginId: string;
+    /** Display name. */
+    name: string;
+    /** False when bypassed. */
+    enabled: boolean;
+}
+/**
+ * Stereo peak levels of a panel bus's OUTPUT (post-FX, post-fader). dBFS,
+ * floored at -120 ("no signal"). Drives the strip's stereo meter.
+ * @since SDK 2.38.0
+ */
+interface PanelBusLevels {
+    leftDb: number;
+    rightDb: number;
+    /** Latched overload since the last read. */
+    clipped: boolean;
+}
 /** Every generator plugin must implement this interface. */
 interface GeneratorPlugin {
     /** Unique ID, npm-style scope: '@sas/synth-generator', '@user/my-plugin' */
@@ -605,6 +637,16 @@ interface PluginHost {
      * picker components consume one type.
      */
     getAvailableFx?(): Promise<InstrumentDescriptor[]>;
+    /**
+     * Force a plugin re-scan and return the refreshed FX list. Unlike
+     * `getAvailableFx` (served from a cache), this re-walks the plugin
+     * directories AND clears the engine's failed-probe blacklist, so a plugin
+     * installed mid-session, or one that crashed a previous scan and was
+     * blacklisted, reappears without an app restart. Backs the FX picker's
+     * "Rescan" button. Slow (20-60s). Absent on pre-2.40 hosts — callers should
+     * fall back to `getAvailableFx`. @since SDK 2.40.0
+     */
+    rescanAvailableFx?(): Promise<InstrumentDescriptor[]>;
     /**
      * The panel's bus state for a scene. `{ engaged: false, … }` when the
      * panel has no bus there — reading NEVER creates one. When engaged, this
@@ -614,6 +656,12 @@ interface PluginHost {
      * is the panel's whole reload story.
      */
     getPanelBusState?(sceneId: string): Promise<PanelBusState>;
+    /**
+     * Stereo output levels for the strip's bus meter (~30 Hz poll). Null when
+     * the bus is disengaged/unrealized or the engine is unavailable — render
+     * the meter floored. Never engages a bus. @since SDK 2.38.0
+     */
+    getPanelBusLevels?(sceneId: string): Promise<PanelBusLevels | null>;
     /** Master fader in dB (engages the bus on first use). */
     setPanelBusVolume?(sceneId: string, volumeDb: number): Promise<void>;
     /** Bus mute — silences the whole panel (multiplies with per-track mutes). */
@@ -636,6 +684,24 @@ interface PluginHost {
      * scene, persisted state deleted. The panel returns to flat routing.
      */
     disengagePanelBus?(sceneId: string): Promise<void>;
+    /**
+     * The track's external FX inserts (instrument + built-ins filtered out).
+     * Reading also converges persisted state: on the first read of a session
+     * the host re-applies saved raw plugin states, and after a `.sasproj`
+     * import it rebuilds missing inserts from the persisted blob.
+     */
+    getTrackExternalFx?(trackId: string): Promise<TrackExternalFxEntry[]>;
+    /**
+     * Add an FX plugin (by scanned pluginId, from `getAvailableFx`) to the
+     * track's chain, inserted before Volume & Pan. Instruments are rejected.
+     */
+    loadTrackExternalFx?(trackId: string, pluginId: string): Promise<TrackExternalFxEntry>;
+    /** Remove an external FX by its `TrackExternalFxEntry.index`. */
+    removeTrackExternalFx?(trackId: string, fxIndex: number): Promise<void>;
+    /** Bypass toggle for an external FX by its `TrackExternalFxEntry.index`. */
+    setTrackExternalFxEnabled?(trackId: string, fxIndex: number, enabled: boolean): Promise<void>;
+    /** Open the native editor window for an external FX. */
+    showTrackExternalFxEditor?(trackId: string, fxIndex: number): Promise<void>;
     /** Subscribe to transport state changes. Returns unsubscribe function. */
     onTransportEvent(listener: TransportEventListener): UnsubscribeFn;
     /** Subscribe to deck boundary events. Returns unsubscribe function. */
@@ -2354,6 +2420,14 @@ interface TrackDrawerProps {
     onFxDryWetChange?: (category: FxCategory, value: number) => void;
     /** Disable FX controls (e.g. while the track is generating). */
     fxDisabled?: boolean;
+    /**
+     * Third-party FX section under the toggle bar (@since SDK 2.39.0): pass the
+     * panel's host and the section manages its own state
+     * (TrackExternalFxSection). Renders nothing on hosts without the surface,
+     * so panels can pass this unconditionally. Omit to keep a built-ins-only
+     * FX tab.
+     */
+    externalFxHost?: PluginHost;
     /** Available instrument plugins from engine scan. */
     instruments?: InstrumentDescriptor[];
     /** Currently loaded instrument plugin ID (null = default Surge XT). */
@@ -2395,7 +2469,7 @@ interface TrackDrawerProps {
     /** Optional single-note preview when the user adds a note. */
     onAuditionNote?: (pitch: number, velocity: number, durationMs: number) => void;
 }
-declare function TrackDrawer({ activeTab, onTabChange, trackId, fxState, onFxToggle, onFxPresetChange, onFxDryWetChange, fxDisabled, instruments, currentPluginId, isLoading, onSelect, onRefresh, editorStage, onShowEditor, onBackToInstruments, selectedInstrumentName, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, }: TrackDrawerProps): React$1.ReactElement;
+declare function TrackDrawer({ activeTab, onTabChange, trackId, fxState, onFxToggle, onFxPresetChange, onFxDryWetChange, fxDisabled, externalFxHost, instruments, currentPluginId, isLoading, onSelect, onRefresh, editorStage, onShowEditor, onBackToInstruments, selectedInstrumentName, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, }: TrackDrawerProps): React$1.ReactElement;
 
 /**
  * useTrackLevels — drives the cosmetic per-track strip meters.
@@ -2611,6 +2685,10 @@ interface SDKTrackRowProps {
     onFxPresetChange?: (cat: FxCategory, idx: number) => void;
     /** FX dry/wet */
     onFxDryWetChange?: (cat: FxCategory, val: number) => void;
+    /** Third-party FX section in the drawer's FX tab — pass the panel's host
+     *  (self-contained; renders nothing on hosts without the surface).
+     *  @since SDK 2.39.0 */
+    externalFxHost?: PluginHost;
     /** Open/close FX (optional — omit to hide FX button) */
     onToggleFxDrawer?: () => void;
     /** Progress persistence callback */
@@ -2670,7 +2748,7 @@ interface SDKTrackRowProps {
      *  a thin peak meter welds to the bottom of the row. Omit to hide it. */
     levels?: TrackLevelsHandle;
 }
-declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
+declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
 
 /**
  * Crossfade-pair metadata — family-agnostic types + parsing shared by every
@@ -3616,6 +3694,11 @@ declare const VolumeSlider: React$1.FC<VolumeSliderProps>;
 interface PanelMasterStripProps {
     /** Bus state from `host.getPanelBusState(sceneId)`. */
     bus: PanelBusState;
+    /**
+     * Stereo output levels from `host.getPanelBusLevels` (polled by
+     * usePanelBus). Null floors the meter (disengaged / engine quiet).
+     */
+    levels?: PanelBusLevels | null;
     /** FX descriptors from `host.getAvailableFx()` (lazy-load on picker open). */
     availableFx?: InstrumentDescriptor[];
     /** True while `availableFx` is loading. */
@@ -3642,7 +3725,7 @@ interface PanelMasterStripProps {
     /** Optional: open the FX plugin's native editor window. */
     onShowFxEditor?: (fxIndex: number) => void;
 }
-declare function PanelMasterStrip({ bus, availableFx, fxLoading, soloedOut, disabled, fxPickerOpen, onToggleFxPicker, onRefreshFx, onVolumeChange, onMuteToggle, onSoloToggle, onAddFx, onRemoveFx, onToggleFxEnabled, onShowFxEditor, }: PanelMasterStripProps): React$1.ReactElement;
+declare function PanelMasterStrip({ bus, levels, availableFx, fxLoading, soloedOut, disabled, fxPickerOpen, onToggleFxPicker, onRefreshFx, onVolumeChange, onMuteToggle, onSoloToggle, onAddFx, onRemoveFx, onToggleFxEnabled, onShowFxEditor, }: PanelMasterStripProps): React$1.ReactElement;
 
 /**
  * usePanelBus — panel-side state + handlers for the PanelMasterStrip
@@ -3664,6 +3747,8 @@ interface UsePanelBusResult {
     supported: boolean;
     /** Null until the first load completes for the current scene. */
     bus: PanelBusState | null;
+    /** Stereo output levels (null = disengaged / floored). Polled at ~15 Hz. */
+    levels: PanelBusLevels | null;
     availableFx: InstrumentDescriptor[];
     fxLoading: boolean;
     fxPickerOpen: boolean;
@@ -3680,6 +3765,65 @@ interface UsePanelBusResult {
 }
 declare function usePanelBus(host: PluginHost, activeSceneId: string | null): UsePanelBusResult;
 
+/**
+ * TrackExternalFxSection — the TrackDrawer FX-tab block for one track's
+ * third-party (VST3/AU) FX inserts, below the built-in FX toggle bar.
+ *
+ * SELF-CONTAINED by design: give it the host and a track id and it manages
+ * its own fetch/mutation state via useTrackExternalFx. That keeps per-panel
+ * wiring to a single prop (six panels consume this) instead of ten
+ * callbacks. Renders nothing on hosts without the surface (pre-2.39), so
+ * panels can pass the prop unconditionally.
+ *
+ * Visual idiom mirrors PanelMasterStrip's FX chips + picker grid: chip =
+ * bypass dot + name (opens the native editor) + remove ✕; the picker is the
+ * TrackDrawer Pick-tab grid over FX descriptors with a search box.
+ */
+
+interface TrackExternalFxSectionProps {
+    /** The panel's host — used directly; the section manages its own state. */
+    host: PluginHost;
+    /** ENGINE track id (the same id the panel passes to getTrackFxState). */
+    trackId: string;
+    /** Disable all controls (e.g. while the track is generating). */
+    disabled?: boolean;
+}
+declare function TrackExternalFxSection({ host, trackId, disabled, }: TrackExternalFxSectionProps): React$1.ReactElement | null;
+
+/**
+ * useTrackExternalFx — panel-side state + handlers for one track's
+ * third-party FX inserts (the TrackDrawer FX-tab section; the per-track
+ * sibling of usePanelBus).
+ *
+ * Feature-gated: `supported` is false on hosts without the track-external-FX
+ * surface (pre-2.39 app builds) and consumers must render nothing then.
+ * Reading converges persisted state host-side (raw-state replay on the
+ * session's first read; rebuild after a `.sasproj` import), so the mount
+ * read is the whole reload story.
+ *
+ * Mutations follow the strip's pattern: host call → list reload. Errors
+ * surface via the host's platform toast; the section re-reads whatever
+ * state is true afterwards.
+ */
+
+interface UseTrackExternalFxResult {
+    /** False on pre-2.39 hosts — render no section. */
+    supported: boolean;
+    /** Null until the first load completes for the current track. */
+    fx: TrackExternalFxEntry[] | null;
+    availableFx: InstrumentDescriptor[];
+    fxLoading: boolean;
+    pickerOpen: boolean;
+    setPickerOpen: (open: boolean) => void;
+    refreshFx: () => void;
+    reload: () => Promise<void>;
+    onAddFx: (pluginId: string) => void;
+    onRemoveFx: (fxIndex: number) => void;
+    onToggleFxEnabled: (fxIndex: number, enabled: boolean) => void;
+    onShowFxEditor: (fxIndex: number) => void;
+}
+declare function useTrackExternalFx(host: PluginHost, trackId: string): UseTrackExternalFxResult;
+
 /**
  * PanSlider Component
  *
@@ -4810,7 +4954,7 @@ declare function useAnySolo(host: Pick<PluginHost, 'isAnySoloActive' | 'onTrackS
  * Registry checks semver.gte(PLUGIN_SDK_VERSION, manifest.minHostVersion)
  * during activation and marks incompatible plugins accordingly.
  */
-declare const PLUGIN_SDK_VERSION = "2.37.0";
+declare const PLUGIN_SDK_VERSION = "2.40.0";
 
 /**
  * FX Preset Definitions
@@ -4958,4 +5102,4 @@ interface PickTopKOptions {
  */
 declare function pickTopKWeighted<T>(scored: ReadonlyArray<ScoredCandidate<T>>, options?: PickTopKOptions): T | null;
 
-export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, EQUAL_POWER_GAIN, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildFadeVolumeCurve, buildRowSlots, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, drawWaveform, formatConcurrentTracks, hashString, moveItem, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };
+export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, EQUAL_POWER_GAIN, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusLevels, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackExternalFxResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildFadeVolumeCurve, buildRowSlots, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, drawWaveform, formatConcurrentTracks, hashString, moveItem, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };

package/dist/index.d.ts

@@ -120,6 +120,38 @@ interface PanelBusState {
     /** User FX chain, top-to-bottom (master section excluded). */
     fx: PanelBusFxEntry[];
 }
+/**
+ * One third-party (VST3/AU) FX insert on a TRACK's plugin chain, as shown to
+ * the panel UI. The track's instrument, the built-in FX-toggle plugins
+ * (reverb/delay/eq/…) and the Volume & Pan master section are filtered OUT —
+ * this list is only the user's external inserts. Same shape as
+ * `PanelBusFxEntry` by design: the drawer and the bus strip share UI idioms.
+ * @since SDK 2.39.0
+ */
+interface TrackExternalFxEntry {
+    /**
+     * ENGINE chain index — pass this back to remove/bypass/editor calls.
+     * Not contiguous from 0: the instrument and built-in FX share the chain.
+     */
+    index: number;
+    /** Scanned plugin id (the picker's `InstrumentDescriptor.pluginId`). */
+    pluginId: string;
+    /** Display name. */
+    name: string;
+    /** False when bypassed. */
+    enabled: boolean;
+}
+/**
+ * Stereo peak levels of a panel bus's OUTPUT (post-FX, post-fader). dBFS,
+ * floored at -120 ("no signal"). Drives the strip's stereo meter.
+ * @since SDK 2.38.0
+ */
+interface PanelBusLevels {
+    leftDb: number;
+    rightDb: number;
+    /** Latched overload since the last read. */
+    clipped: boolean;
+}
 /** Every generator plugin must implement this interface. */
 interface GeneratorPlugin {
     /** Unique ID, npm-style scope: '@sas/synth-generator', '@user/my-plugin' */
@@ -605,6 +637,16 @@ interface PluginHost {
      * picker components consume one type.
      */
     getAvailableFx?(): Promise<InstrumentDescriptor[]>;
+    /**
+     * Force a plugin re-scan and return the refreshed FX list. Unlike
+     * `getAvailableFx` (served from a cache), this re-walks the plugin
+     * directories AND clears the engine's failed-probe blacklist, so a plugin
+     * installed mid-session, or one that crashed a previous scan and was
+     * blacklisted, reappears without an app restart. Backs the FX picker's
+     * "Rescan" button. Slow (20-60s). Absent on pre-2.40 hosts — callers should
+     * fall back to `getAvailableFx`. @since SDK 2.40.0
+     */
+    rescanAvailableFx?(): Promise<InstrumentDescriptor[]>;
     /**
      * The panel's bus state for a scene. `{ engaged: false, … }` when the
      * panel has no bus there — reading NEVER creates one. When engaged, this
@@ -614,6 +656,12 @@ interface PluginHost {
      * is the panel's whole reload story.
      */
     getPanelBusState?(sceneId: string): Promise<PanelBusState>;
+    /**
+     * Stereo output levels for the strip's bus meter (~30 Hz poll). Null when
+     * the bus is disengaged/unrealized or the engine is unavailable — render
+     * the meter floored. Never engages a bus. @since SDK 2.38.0
+     */
+    getPanelBusLevels?(sceneId: string): Promise<PanelBusLevels | null>;
     /** Master fader in dB (engages the bus on first use). */
     setPanelBusVolume?(sceneId: string, volumeDb: number): Promise<void>;
     /** Bus mute — silences the whole panel (multiplies with per-track mutes). */
@@ -636,6 +684,24 @@ interface PluginHost {
      * scene, persisted state deleted. The panel returns to flat routing.
      */
     disengagePanelBus?(sceneId: string): Promise<void>;
+    /**
+     * The track's external FX inserts (instrument + built-ins filtered out).
+     * Reading also converges persisted state: on the first read of a session
+     * the host re-applies saved raw plugin states, and after a `.sasproj`
+     * import it rebuilds missing inserts from the persisted blob.
+     */
+    getTrackExternalFx?(trackId: string): Promise<TrackExternalFxEntry[]>;
+    /**
+     * Add an FX plugin (by scanned pluginId, from `getAvailableFx`) to the
+     * track's chain, inserted before Volume & Pan. Instruments are rejected.
+     */
+    loadTrackExternalFx?(trackId: string, pluginId: string): Promise<TrackExternalFxEntry>;
+    /** Remove an external FX by its `TrackExternalFxEntry.index`. */
+    removeTrackExternalFx?(trackId: string, fxIndex: number): Promise<void>;
+    /** Bypass toggle for an external FX by its `TrackExternalFxEntry.index`. */
+    setTrackExternalFxEnabled?(trackId: string, fxIndex: number, enabled: boolean): Promise<void>;
+    /** Open the native editor window for an external FX. */
+    showTrackExternalFxEditor?(trackId: string, fxIndex: number): Promise<void>;
     /** Subscribe to transport state changes. Returns unsubscribe function. */
     onTransportEvent(listener: TransportEventListener): UnsubscribeFn;
     /** Subscribe to deck boundary events. Returns unsubscribe function. */
@@ -2354,6 +2420,14 @@ interface TrackDrawerProps {
     onFxDryWetChange?: (category: FxCategory, value: number) => void;
     /** Disable FX controls (e.g. while the track is generating). */
     fxDisabled?: boolean;
+    /**
+     * Third-party FX section under the toggle bar (@since SDK 2.39.0): pass the
+     * panel's host and the section manages its own state
+     * (TrackExternalFxSection). Renders nothing on hosts without the surface,
+     * so panels can pass this unconditionally. Omit to keep a built-ins-only
+     * FX tab.
+     */
+    externalFxHost?: PluginHost;
     /** Available instrument plugins from engine scan. */
     instruments?: InstrumentDescriptor[];
     /** Currently loaded instrument plugin ID (null = default Surge XT). */
@@ -2395,7 +2469,7 @@ interface TrackDrawerProps {
     /** Optional single-note preview when the user adds a note. */
     onAuditionNote?: (pitch: number, velocity: number, durationMs: number) => void;
 }
-declare function TrackDrawer({ activeTab, onTabChange, trackId, fxState, onFxToggle, onFxPresetChange, onFxDryWetChange, fxDisabled, instruments, currentPluginId, isLoading, onSelect, onRefresh, editorStage, onShowEditor, onBackToInstruments, selectedInstrumentName, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, }: TrackDrawerProps): React$1.ReactElement;
+declare function TrackDrawer({ activeTab, onTabChange, trackId, fxState, onFxToggle, onFxPresetChange, onFxDryWetChange, fxDisabled, externalFxHost, instruments, currentPluginId, isLoading, onSelect, onRefresh, editorStage, onShowEditor, onBackToInstruments, selectedInstrumentName, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, }: TrackDrawerProps): React$1.ReactElement;
 
 /**
  * useTrackLevels — drives the cosmetic per-track strip meters.
@@ -2611,6 +2685,10 @@ interface SDKTrackRowProps {
     onFxPresetChange?: (cat: FxCategory, idx: number) => void;
     /** FX dry/wet */
     onFxDryWetChange?: (cat: FxCategory, val: number) => void;
+    /** Third-party FX section in the drawer's FX tab — pass the panel's host
+     *  (self-contained; renders nothing on hosts without the surface).
+     *  @since SDK 2.39.0 */
+    externalFxHost?: PluginHost;
     /** Open/close FX (optional — omit to hide FX button) */
     onToggleFxDrawer?: () => void;
     /** Progress persistence callback */
@@ -2670,7 +2748,7 @@ interface SDKTrackRowProps {
      *  a thin peak meter welds to the bottom of the row. Omit to hide it. */
     levels?: TrackLevelsHandle;
 }
-declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
+declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
 
 /**
  * Crossfade-pair metadata — family-agnostic types + parsing shared by every
@@ -3616,6 +3694,11 @@ declare const VolumeSlider: React$1.FC<VolumeSliderProps>;
 interface PanelMasterStripProps {
     /** Bus state from `host.getPanelBusState(sceneId)`. */
     bus: PanelBusState;
+    /**
+     * Stereo output levels from `host.getPanelBusLevels` (polled by
+     * usePanelBus). Null floors the meter (disengaged / engine quiet).
+     */
+    levels?: PanelBusLevels | null;
     /** FX descriptors from `host.getAvailableFx()` (lazy-load on picker open). */
     availableFx?: InstrumentDescriptor[];
     /** True while `availableFx` is loading. */
@@ -3642,7 +3725,7 @@ interface PanelMasterStripProps {
     /** Optional: open the FX plugin's native editor window. */
     onShowFxEditor?: (fxIndex: number) => void;
 }
-declare function PanelMasterStrip({ bus, availableFx, fxLoading, soloedOut, disabled, fxPickerOpen, onToggleFxPicker, onRefreshFx, onVolumeChange, onMuteToggle, onSoloToggle, onAddFx, onRemoveFx, onToggleFxEnabled, onShowFxEditor, }: PanelMasterStripProps): React$1.ReactElement;
+declare function PanelMasterStrip({ bus, levels, availableFx, fxLoading, soloedOut, disabled, fxPickerOpen, onToggleFxPicker, onRefreshFx, onVolumeChange, onMuteToggle, onSoloToggle, onAddFx, onRemoveFx, onToggleFxEnabled, onShowFxEditor, }: PanelMasterStripProps): React$1.ReactElement;
 
 /**
  * usePanelBus — panel-side state + handlers for the PanelMasterStrip
@@ -3664,6 +3747,8 @@ interface UsePanelBusResult {
     supported: boolean;
     /** Null until the first load completes for the current scene. */
     bus: PanelBusState | null;
+    /** Stereo output levels (null = disengaged / floored). Polled at ~15 Hz. */
+    levels: PanelBusLevels | null;
     availableFx: InstrumentDescriptor[];
     fxLoading: boolean;
     fxPickerOpen: boolean;
@@ -3680,6 +3765,65 @@ interface UsePanelBusResult {
 }
 declare function usePanelBus(host: PluginHost, activeSceneId: string | null): UsePanelBusResult;
 
+/**
+ * TrackExternalFxSection — the TrackDrawer FX-tab block for one track's
+ * third-party (VST3/AU) FX inserts, below the built-in FX toggle bar.
+ *
+ * SELF-CONTAINED by design: give it the host and a track id and it manages
+ * its own fetch/mutation state via useTrackExternalFx. That keeps per-panel
+ * wiring to a single prop (six panels consume this) instead of ten
+ * callbacks. Renders nothing on hosts without the surface (pre-2.39), so
+ * panels can pass the prop unconditionally.
+ *
+ * Visual idiom mirrors PanelMasterStrip's FX chips + picker grid: chip =
+ * bypass dot + name (opens the native editor) + remove ✕; the picker is the
+ * TrackDrawer Pick-tab grid over FX descriptors with a search box.
+ */
+
+interface TrackExternalFxSectionProps {
+    /** The panel's host — used directly; the section manages its own state. */
+    host: PluginHost;
+    /** ENGINE track id (the same id the panel passes to getTrackFxState). */
+    trackId: string;
+    /** Disable all controls (e.g. while the track is generating). */
+    disabled?: boolean;
+}
+declare function TrackExternalFxSection({ host, trackId, disabled, }: TrackExternalFxSectionProps): React$1.ReactElement | null;
+
+/**
+ * useTrackExternalFx — panel-side state + handlers for one track's
+ * third-party FX inserts (the TrackDrawer FX-tab section; the per-track
+ * sibling of usePanelBus).
+ *
+ * Feature-gated: `supported` is false on hosts without the track-external-FX
+ * surface (pre-2.39 app builds) and consumers must render nothing then.
+ * Reading converges persisted state host-side (raw-state replay on the
+ * session's first read; rebuild after a `.sasproj` import), so the mount
+ * read is the whole reload story.
+ *
+ * Mutations follow the strip's pattern: host call → list reload. Errors
+ * surface via the host's platform toast; the section re-reads whatever
+ * state is true afterwards.
+ */
+
+interface UseTrackExternalFxResult {
+    /** False on pre-2.39 hosts — render no section. */
+    supported: boolean;
+    /** Null until the first load completes for the current track. */
+    fx: TrackExternalFxEntry[] | null;
+    availableFx: InstrumentDescriptor[];
+    fxLoading: boolean;
+    pickerOpen: boolean;
+    setPickerOpen: (open: boolean) => void;
+    refreshFx: () => void;
+    reload: () => Promise<void>;
+    onAddFx: (pluginId: string) => void;
+    onRemoveFx: (fxIndex: number) => void;
+    onToggleFxEnabled: (fxIndex: number, enabled: boolean) => void;
+    onShowFxEditor: (fxIndex: number) => void;
+}
+declare function useTrackExternalFx(host: PluginHost, trackId: string): UseTrackExternalFxResult;
+
 /**
  * PanSlider Component
  *
@@ -4810,7 +4954,7 @@ declare function useAnySolo(host: Pick<PluginHost, 'isAnySoloActive' | 'onTrackS
  * Registry checks semver.gte(PLUGIN_SDK_VERSION, manifest.minHostVersion)
  * during activation and marks incompatible plugins accordingly.
  */
-declare const PLUGIN_SDK_VERSION = "2.37.0";
+declare const PLUGIN_SDK_VERSION = "2.40.0";
 
 /**
  * FX Preset Definitions
@@ -4958,4 +5102,4 @@ interface PickTopKOptions {
  */
 declare function pickTopKWeighted<T>(scored: ReadonlyArray<ScoredCandidate<T>>, options?: PickTopKOptions): T | null;
 
-export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, EQUAL_POWER_GAIN, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildFadeVolumeCurve, buildRowSlots, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, drawWaveform, formatConcurrentTracks, hashString, moveItem, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };
+export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, EQUAL_POWER_GAIN, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusLevels, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackExternalFxResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildFadeVolumeCurve, buildRowSlots, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, drawWaveform, formatConcurrentTracks, hashString, moveItem, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };