@signalsandsorcery/plugin-sdk 2.35.3 → 2.35.5

package/dist/index.d.mts

@@ -141,6 +141,20 @@ interface TrackExternalFxEntry {
     /** False when bypassed. */
     enabled: boolean;
 }
+/**
+ * Outcome of copying a source track's FX chain onto another track
+ * (`copyTrackFxFrom`). Partial success is normal — a third-party plugin
+ * missing from this machine lands in `externalMissing` while everything else
+ * still copies. @since SDK 2.41.0
+ */
+interface TrackFxCopyResult {
+    /** Built-in FX categories (reverb/delay/eq/…) re-applied on the dest. */
+    builtIn: string[];
+    /** External inserts successfully rebuilt on the dest. */
+    externalCopied: number;
+    /** External plugin names that failed to load (missing from this machine). */
+    externalMissing: string[];
+}
 /**
  * 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.
@@ -637,6 +651,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
@@ -692,6 +716,17 @@ interface PluginHost {
     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>;
+    /**
+     * Copy a SOURCE track's whole FX chain (built-in fx-toggle categories AND
+     * external inserts with their states) onto an owned track. The source is
+     * addressed by DB row id and may live in ANOTHER scene (transition
+     * crossfade/fade layers copy from the from/to scenes) — only the DEST is
+     * ownership-asserted, mirroring `getTrackSound`. Partial success is normal:
+     * missing third-party plugins land in `externalMissing` and everything else
+     * still copies. Feature-gate on `typeof host.copyTrackFxFrom === 'function'`.
+     * @since SDK 2.41.0
+     */
+    copyTrackFxFrom?(destTrackId: string, sourceTrackDbId: string): Promise<TrackFxCopyResult>;
     /** Subscribe to transport state changes. Returns unsubscribe function. */
     onTransportEvent(listener: TransportEventListener): UnsubscribeFn;
     /** Subscribe to deck boundary events. Returns unsubscribe function. */
@@ -3012,6 +3047,18 @@ interface FadeMeta {
     soundLabel: string;
     /** Fade position 0..1 — WHERE in time the fade midpoint sits. */
     sliderPos: number;
+    /**
+     * GROUP fades (verbatim multi-track fades, e.g. a bass voice group): shared
+     * id linking every member track of one fade — by convention the first
+     * member copy's dbId. Absent on classic single-track fades; old metas parse
+     * unchanged. All members of a group share direction/gesture/sliderPos.
+     * @since SDK 2.41.0
+     */
+    groupId?: string;
+    /** Stable member order within the group (e.g. bass voiceIndex). @since SDK 2.41.0 */
+    memberIndex?: number;
+    /** Per-member caption, e.g. the bass voice partition label. @since SDK 2.41.0 */
+    memberLabel?: string;
 }
 /** A fade entry resolved from scene data: the fade track's dbId + its metadata. */
 interface FadeEntry {
@@ -3026,6 +3073,34 @@ declare function asFadeMeta(val: unknown): FadeMeta | null;
  * fade is intrinsically a single track.
  */
 declare function parseFades(sceneData: Record<string, unknown>): FadeEntry[];
+/**
+ * One GROUP fade assembled from its member entries: N tracks fading together
+ * as a unit (verbatim group fades — e.g. a copied bass voice group). Scalars
+ * (direction/gesture/sliderPos) come from the first member; creation writes
+ * them identically across members. Generic over the entry type so callers can
+ * split live-resolved entries without losing their extra fields.
+ * @since SDK 2.41.0
+ */
+interface GroupFadeEntryOf<E extends FadeEntry> {
+    groupId: string;
+    direction: FadeDirection;
+    gesture: FadeGesture;
+    sliderPos: number;
+    /** Members sorted by memberIndex (creation order fallback). */
+    members: E[];
+}
+/** The plain-entry specialization (scene-data parse results). @since SDK 2.41.0 */
+type GroupFadeEntry = GroupFadeEntryOf<FadeEntry>;
+/**
+ * Partition parsed fade entries into classic single-track fades and group
+ * fades (entries sharing a `groupId`). Pure; keyed for the panel-core render
+ * split — drift-resync and curve re-apply deliberately keep iterating the
+ * FLAT entry list so they need no group awareness. @since SDK 2.41.0
+ */
+declare function splitFadeEntries<E extends FadeEntry>(entries: E[]): {
+    singles: E[];
+    groups: GroupFadeEntryOf<E>[];
+};
 /**
  * Build a ONE-sided volume-automation curve for a fade over `bars` at `bpm`.
  *
@@ -3125,6 +3200,55 @@ interface FadeTrackRowProps {
 }
 declare function FadeTrackRow({ layer, direction, gesture, effect, sliderPos, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onDelete, onSliderChange, levels, accentColor, }: FadeTrackRowProps): React$1.ReactElement;
 
+/**
+ * GroupFadeTrackRow — a transition GROUP fade: N verbatim-copied member tracks
+ * (a bass voice group) fading together under ONE slider.
+ *
+ * The multi-track sibling of {@link FadeTrackRow}: a header with the direction
+ * badge + group label + group mute/solo/delete, one locked TrackRow per member
+ * (per-member volume/pan/mute/solo stay live; sound/generation controls are
+ * omitted — "controlled by omission"), and a single shared fade slider. The
+ * copies are byte-exact (MIDI + preset + FX), so unlike a generated fade there
+ * is no per-member gesture nuance — the whole group rides one 'volume' curve.
+ *
+ * @since SDK 2.41.0
+ */
+
+/** One member track of the group fade. */
+interface GroupFadeMemberLayer extends FadeLayer {
+    /** Short per-member caption, e.g. the bass partition ('low', 'offbeats'). */
+    memberLabel?: string;
+}
+interface GroupFadeTrackRowProps {
+    /** Header label, e.g. 'Bassline (3 voices)'. */
+    groupLabel: string;
+    /** 'in' (enters across the loop) or 'out' (leaves across the loop). */
+    direction: FadeDirection;
+    /** Shown read-only (group fades are always 'volume'). */
+    gesture: FadeGesture;
+    /** Fade position 0..1 — WHERE in time the fade sits. Defaults centered. */
+    sliderPos?: number;
+    /** Member tracks in group order. */
+    members: GroupFadeMemberLayer[];
+    /** Per-member controls (members are normal tracks). */
+    onMemberMuteToggle: (trackId: string) => void;
+    onMemberSoloToggle: (trackId: string) => void;
+    onMemberVolumeChange: (trackId: string, volume: number) => void;
+    onMemberPanChange: (trackId: string, pan: number) => void;
+    /** Group controls — act on every member together. */
+    onMuteAll: () => void;
+    onSoloAll: () => void;
+    /** Delete the whole group fade (all member tracks). */
+    onDelete: () => void;
+    /** Move the fade point for the whole group. Omit to render read-only. */
+    onSliderChange?: (pos: number) => void;
+    /** Shared meter handle (welds a peak meter to each member). */
+    levels?: TrackLevelsHandle;
+    /** Left-border accent. Defaults to transition purple. */
+    accentColor?: string;
+}
+declare function GroupFadeTrackRow({ groupLabel, direction, gesture, sliderPos, members, onMemberMuteToggle, onMemberSoloToggle, onMemberVolumeChange, onMemberPanChange, onMuteAll, onSoloAll, onDelete, onSliderChange, levels, accentColor, }: GroupFadeTrackRowProps): React$1.ReactElement;
+
 /**
  * FadeModal — "add a fade" picker for a transition scene.
  *
@@ -3345,10 +3469,23 @@ interface TransitionDesignerProps {
      * Build a crossfade pair — the panel's existing handler (create two tracks, one
      * morphed clip, copy each preset). Should reject on failure. Safe to call
      * concurrently.
+     *
+     * OMIT for a FADE-ONLY board (group families like bass, where a 1:1 MIDI
+     * crossfade is undefined): the two index-paired columns become two stacked
+     * one-sided sections (origin subjects fade out, target subjects fade in)
+     * with no drag/gap/pairing. @since optional in SDK 2.41.0
      */
-    onCreateCrossfade: (origin: CrossfadeSelection, target: CrossfadeSelection) => Promise<void>;
+    onCreateCrossfade?: (origin: CrossfadeSelection, target: CrossfadeSelection) => Promise<void>;
     /** Build a one-sided fade — the panel's existing handler. Should reject on failure. */
     onCreateFade: (selection: FadeSelection, direction: FadeDirection, gesture: FadeGesture) => Promise<void>;
+    /**
+     * Collapse a column's family tracks into designer SUBJECTS (group families:
+     * one cell per voice group, carrying the anchor's dbId). Applied per column
+     * after `listSceneFamilyTracks`. @since SDK 2.41.0
+     */
+    mapColumnSubjects?: (sceneId: string, tracks: SceneFamilyTrack[]) => Promise<SceneFamilyTrack[]>;
+    /** Per-row progress estimate override for fades (LLM-free creates). @since SDK 2.41.0 */
+    fadeEstimateMs?: number;
     /**
      * Build an AUDIO-only one-sided transition (stutter / chopped / delay). When
      * provided, one-sided rows render an effect selector; absent (MIDI panels) →
@@ -3360,7 +3497,7 @@ interface TransitionDesignerProps {
     /** data-testid prefix. */
     testIdPrefix?: string;
 }
-declare function TransitionDesigner({ host, fromSceneId, toSceneId, transitionSceneId, excludeSourceDbIds, onCreateCrossfade, onCreateFade, onCreateAudioTransition, familyLabel, testIdPrefix, }: TransitionDesignerProps): React$1.ReactElement;
+declare function TransitionDesigner({ host, fromSceneId, toSceneId, transitionSceneId, excludeSourceDbIds, onCreateCrossfade, onCreateFade, onCreateAudioTransition, mapColumnSubjects, fadeEstimateMs, familyLabel, testIdPrefix, }: TransitionDesignerProps): React$1.ReactElement;
 
 /**
  * Transition Designer — pure helpers for the per-panel transition staging board.
@@ -4658,6 +4795,72 @@ interface PanelGroupExtension<M = unknown> extends GroupParseSpec<M> {
     isComplete?(group: ResolvedTrackGroup<M, GeneratorTrackState>, parsed: TrackGroupMeta<M>): boolean;
     renderGroup(group: ResolvedTrackGroup<M, GeneratorTrackState>, ctx: GroupRenderContext): ReactNode;
 }
+/**
+ * One member of a verbatim group fade — a SOURCE track (from/to scene) whose
+ * MIDI + sound + FX are copied byte-exact into the transition scene.
+ * @since SDK 2.41.0
+ */
+interface VerbatimFadeMember {
+    /** Source track DB row id. */
+    dbId: string;
+    /** Source track display name (per-member fade caption). */
+    name: string;
+    role?: string;
+    /** Stable order within the group (bass: voiceIndex; anchor = 0). */
+    memberIndex: number;
+    /** Short per-member label, e.g. the bass partition ('low', 'offbeats'). */
+    memberLabel?: string;
+    /** Opaque family meta round-tripped into `writeGroupMetas` (bass: BassVoiceMeta). */
+    familyMeta?: unknown;
+}
+/**
+ * Group-shaped transition behavior for families whose "track" is a VOICE
+ * GROUP of N tracks (bass basslines). Registering this switches the panel's
+ * Transition Designer to FADE-ONLY (`fadeOnly: true` is the only supported
+ * mode — a 1:1 MIDI crossfade is undefined between groups of different voice
+ * counts) with one board cell per GROUP, and `onCreateFade` routes to the
+ * core's `handleCreateVerbatimGroupFade`: every member is copied VERBATIM
+ * (MIDI clamped to the transition span + exact sound + FX chain — NO LLM) and
+ * the whole group fades together under one slider. @since SDK 2.41.0
+ */
+interface PanelTransitionGroupAdapter {
+    /** v1: group families are fade-only; crossfade rows never render. */
+    fadeOnly: true;
+    /**
+     * Collapse a scene's family tracks into designer SUBJECTS: one entry per
+     * group (carrying the ANCHOR's dbId so exclude/row keys work unchanged)
+     * plus loose tracks passed through. Called per column after
+     * `listSceneFamilyTracks`.
+     */
+    mapColumnSubjects(sceneId: string, tracks: SceneFamilyTrack[]): Promise<SceneFamilyTrack[]>;
+    /**
+     * Expand a subject (anchor dbId) back into its ordered members. A loose
+     * track returns a single member with memberIndex 0.
+     */
+    expandSubject(sceneId: string, subjectDbId: string): Promise<VerbatimFadeMember[]>;
+    /**
+     * Persist the family's own group metas for the COPIED tracks in the
+     * transition scene (bass: `track:<newDbId>:bassVoice` rows sharing
+     * groupId = newAnchorDbId) so the Tracks view renders them as a proper
+     * family group.
+     */
+    writeGroupMetas(transitionSceneId: string, copies: Array<{
+        newDbId: string;
+        member: VerbatimFadeMember;
+    }>, newAnchorDbId: string): Promise<void>;
+    /** Scene-data key suffixes to delete per member on rollback/delete (bass: ['bassVoice']). */
+    cleanupKeySuffixes: string[];
+    /**
+     * Default fade midpoint per direction. Bass staggers them (out→0.35,
+     * in→0.65) so the outgoing and incoming groups avoid low-end overlap.
+     * Default 0.5.
+     */
+    defaultSliderPos?(direction: 'in' | 'out'): number;
+    /** Progress-bar pacing for one group fade (LLM-free; default the designer's fade estimate). */
+    fadeEstimateMs?: number;
+    /** Group-fade row header label, e.g. `Bassline (3 voices)`. Default `Group (N tracks)`. */
+    groupRowLabel?(memberCount: number): string;
+}
 interface GeneratorPanelAdapter<M = unknown> {
     identity: PanelIdentity;
     features: PanelFeatureFlags;
@@ -4677,6 +4880,12 @@ interface GeneratorPanelAdapter<M = unknown> {
     generation: PanelGenerationStrategy;
     /** Custom multi-track group rows (bass voice groups). */
     groupExtensions?: PanelGroupExtension<M>[];
+    /**
+     * Group-shaped transition behavior (fade-only designer + verbatim group
+     * fades). Registering this is what lights up `features.transitionDesigner`
+     * for group families. @since SDK 2.41.0
+     */
+    transitionGroup?: PanelTransitionGroupAdapter;
     /** Patch the default TrackRow props per row (drum's sampleName fallback). */
     mapTrackRowProps?(track: GeneratorTrackState, props: SDKTrackRowProps): SDKTrackRowProps;
 }
@@ -4712,6 +4921,8 @@ interface ResolvedCrossfadePair extends CrossfadePairMeta {
 interface ResolvedFade extends FadeEntry {
     track: GeneratorTrackState;
 }
+/** A GROUP fade (verbatim multi-track fade) resolved against live track state. @since SDK 2.41.0 */
+type ResolvedGroupFade = GroupFadeEntryOf<ResolvedFade>;
 interface UseTransitionOpsInputs {
     host: PluginHost;
     adapter: GeneratorPanelAdapter;
@@ -4738,6 +4949,16 @@ interface TransitionOps {
     handleCrossfadeSlider(pair: ResolvedCrossfadePair, pos: number): void;
     handleFadeDelete(fade: ResolvedFade): Promise<void>;
     handleFadeSlider(fade: ResolvedFade, pos: number): void;
+    /** True while any verbatim group fade is being created. @since SDK 2.41.0 */
+    isCreatingGroupFade: boolean;
+    /**
+     * Verbatim GROUP fade (adapter.transitionGroup families): copy every member
+     * of the subject's voice group byte-exact (MIDI + sound + FX — NO LLM) into
+     * the transition scene and fade them together. @since SDK 2.41.0
+     */
+    handleCreateVerbatimGroupFade(subject: FadeSelection, direction: FadeDirection): Promise<void>;
+    handleGroupFadeSlider(group: ResolvedGroupFade, pos: number): void;
+    handleGroupFadeDelete(group: ResolvedGroupFade): Promise<void>;
 }
 declare function useTransitionOps({ host, adapter, activeSceneId, isConnected, isAuthenticated, sceneContext, tracks, setTracks, loadTracks, setCrossfadePairsMeta, setFadesMeta, resolvedCrossfadePairs, resolvedFades, }: UseTransitionOpsInputs): TransitionOps;
 
@@ -4808,6 +5029,10 @@ interface GeneratorPanelCore {
     crossfadeMemberDbIds: Set<string>;
     resolvedFades: ResolvedFade[];
     fadeMemberDbIds: Set<string>;
+    /** Classic single-track fades (resolvedFades minus group members). @since SDK 2.41.0 */
+    resolvedSingleFades: ResolvedFade[];
+    /** Verbatim group fades, memberIndex-ordered. @since SDK 2.41.0 */
+    resolvedGroupFades: ResolvedGroupFade[];
     resolvedGenericGroups: Record<string, ResolvedGroupsResult<unknown, GeneratorTrackState>>;
     genericGroupMemberDbIds: Set<string>;
     availableInstruments: InstrumentDescriptor[];
@@ -4944,7 +5169,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.39.0";
+declare const PLUGIN_SDK_VERSION = "2.40.0";
 
 /**
  * FX Preset Definitions
@@ -5092,4 +5317,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 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 };
+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 GroupFadeEntry, type GroupFadeEntryOf, type GroupFadeMemberLayer, GroupFadeTrackRow, type GroupFadeTrackRowProps, 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 PanelTransitionGroupAdapter, 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 ResolvedGroupFade, 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 VerbatimFadeMember, 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, splitFadeEntries, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };