@signalsandsorcery/plugin-sdk 2.35.1 → 2.35.3

package/dist/index.d.ts

@@ -86,6 +86,72 @@ interface InstrumentDescriptor {
     /** Whether this plugin is currently installed/available */
     missing?: boolean;
 }
+/**
+ * One FX plugin in a panel bus's chain, as shown to the panel UI. The
+ * engine's Volume & Pan master section and level meter are filtered OUT —
+ * they are the strip's fader/meter, not user FX chips.
+ * @since SDK 2.36.0
+ */
+interface PanelBusFxEntry {
+    /**
+     * ENGINE chain index — pass this back to remove/bypass/editor calls.
+     * Not necessarily contiguous from 0: hidden master-section plugins share
+     * the same chain.
+     */
+    index: number;
+    /** Scanned plugin id (the picker's `InstrumentDescriptor.pluginId`). */
+    pluginId: string;
+    /** Display name. */
+    name: string;
+    /** False when bypassed. */
+    enabled: boolean;
+}
+/**
+ * A panel's mix-bus state for one scene (docs/panel-bus.md §9).
+ * @since SDK 2.36.0
+ */
+interface PanelBusState {
+    /** False = the panel has no bus in this scene (flat routing). */
+    engaged: boolean;
+    /** Master fader in dB (0 = unity). */
+    volume: number;
+    muted: boolean;
+    soloed: boolean;
+    /** 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' */
@@ -565,6 +631,67 @@ interface PluginHost {
      * origin/target scenes). Optional — callers MUST null-check. @since SDK 2.26.0
      */
     getSceneName?(sceneDbId: string): Promise<string | null>;
+    /**
+     * FX plugins available for the bus picker (scanned, non-instrument).
+     * Same descriptor shape as `getAvailableInstruments` by design — the SDK
+     * picker components consume one type.
+     */
+    getAvailableFx?(): 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
+     * also (re)realizes the bus in the engine (adopt-by-marker; rebuild from
+     * the persisted blob only after a `.sasproj` import) and routes any
+     * not-yet-routed panel tracks through it, so calling it from `loadTracks`
+     * 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). */
+    setPanelBusMute?(sceneId: string, muted: boolean): Promise<void>;
+    /** Panel solo — composes with track solo via the engine's solo rules. */
+    setPanelBusSolo?(sceneId: string, soloed: boolean): Promise<void>;
+    /**
+     * Add an FX plugin (by scanned pluginId) to the bus chain, engaging the
+     * bus if needed. Instruments are rejected engine-side.
+     */
+    loadPanelBusFx?(sceneId: string, pluginId: string): Promise<PanelBusFxEntry>;
+    /** Remove a bus FX by its `PanelBusFxEntry.index`. */
+    removePanelBusFx?(sceneId: string, fxIndex: number): Promise<void>;
+    /** Bypass toggle for a bus FX by its `PanelBusFxEntry.index`. */
+    setPanelBusFxEnabled?(sceneId: string, fxIndex: number, enabled: boolean): Promise<void>;
+    /** Open the native editor window for a bus FX. */
+    showPanelBusFxEditor?(sceneId: string, fxIndex: number): Promise<void>;
+    /**
+     * Disengage the bus: FX chain removed, tracks reparented back under the
+     * 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. */
@@ -2283,6 +2410,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). */
@@ -2324,7 +2459,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.
@@ -2540,6 +2675,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 */
@@ -2599,7 +2738,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
@@ -3528,6 +3667,153 @@ interface VolumeSliderProps {
 }
 declare const VolumeSlider: React$1.FC<VolumeSliderProps>;
 
+/**
+ * PanelMasterStrip — the panel's mix-bus master section (docs/panel-bus.md §10).
+ *
+ * One compact strip: BUS label + master fader + M/S + the bus FX chain as
+ * chips (bypass toggle, remove, optional native-editor open) + an "FX +"
+ * picker that reuses the TrackDrawer Pick-tab grid idiom over FX descriptors.
+ *
+ * Fully CONTROLLED and presentational: the panel owns `bus` (from
+ * `host.getPanelBusState`), the picker-open flag, and wires every callback to
+ * the corresponding `host.*PanelBus*` method. A disengaged bus renders the
+ * same strip at neutral values — the first interaction engages it host-side,
+ * so there is no separate "create bus" affordance to learn.
+ */
+
+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. */
+    fxLoading?: boolean;
+    /**
+     * Another panel/track solo is active and this bus is NOT soloed — render
+     * dimmed, mirroring TrackRow's soloed-out treatment. Feed
+     * `anySolo && !bus.soloed` from the panel's `useAnySolo(host)` hook.
+     */
+    soloedOut?: boolean;
+    /** Disable all controls (e.g. while the panel is generating). */
+    disabled?: boolean;
+    /** Controlled FX-picker visibility. */
+    fxPickerOpen: boolean;
+    onToggleFxPicker: (open: boolean) => void;
+    /** Re-scan / refresh the FX list. */
+    onRefreshFx?: () => void;
+    onVolumeChange: (volumeDb: number) => void;
+    onMuteToggle: () => void;
+    onSoloToggle: () => void;
+    onAddFx: (pluginId: string) => void;
+    onRemoveFx: (fxIndex: number) => void;
+    onToggleFxEnabled: (fxIndex: number, enabled: boolean) => void;
+    /** Optional: open the FX plugin's native editor window. */
+    onShowFxEditor?: (fxIndex: number) => void;
+}
+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
+ * (docs/panel-bus.md §11).
+ *
+ * Feature-gated: `supported` is false on hosts without the panel-bus surface
+ * (older app builds), and every consumer should render nothing in that case —
+ * the strip must never appear on a host that can't back it. Reading state
+ * NEVER engages a bus; the first mutation (fader move / FX add) does, host-side.
+ *
+ * Reload story: state re-reads on scene change and after every mutation.
+ * `getPanelBusState` host-side also (re)realizes the bus (adopt-by-marker)
+ * and routes not-yet-routed panel tracks, so calling `reload()` from the
+ * panel's track-reload path keeps everything converged with zero extra wiring.
+ */
+
+interface UsePanelBusResult {
+    /** False on pre-2.36 hosts — render no strip. */
+    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;
+    setFxPickerOpen: (open: boolean) => void;
+    refreshFx: () => void;
+    reload: () => Promise<void>;
+    onVolumeChange: (volumeDb: number) => void;
+    onMuteToggle: () => void;
+    onSoloToggle: () => void;
+    onAddFx: (pluginId: string) => void;
+    onRemoveFx: (fxIndex: number) => void;
+    onToggleFxEnabled: (fxIndex: number, enabled: boolean) => void;
+    onShowFxEditor: (fxIndex: number) => void;
+}
+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
  *
@@ -4658,7 +4944,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.35.0";
+declare const PLUGIN_SDK_VERSION = "2.39.0";
 
 /**
  * FX Preset Definitions
@@ -4806,4 +5092,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 PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, 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 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, 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 };