@signalsandsorcery/plugin-sdk 2.38.2 → 2.40.2

package/dist/index.d.ts

@@ -2676,6 +2676,12 @@ interface TrackDrawerProps {
     onImportSound?: () => void;
     /** Button label, e.g. "Import Sample" (drums/instruments) or "Import Preset" (synths). */
     importSoundLabel?: string;
+    /**
+     * Linked-group hint (@since SDK 2.48.0): shown in the drawer header on
+     * every tab, e.g. "🔗 Sound changes apply to all 4 parts". Undefined
+     * renders nothing (all single-track panels).
+     */
+    linkedSoundHint?: string;
     /** Current MIDI notes for the piano-roll editor. */
     editNotes?: readonly PluginMidiNote[];
     /** Persist edited notes; PRESENCE of this callback enables the Edit tab. */
@@ -2689,7 +2695,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, externalFxHost, freeze, 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, freeze, instruments, currentPluginId, isLoading, onSelect, onRefresh, editorStage, onShowEditor, onBackToInstruments, selectedInstrumentName, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, linkedSoundHint, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, }: TrackDrawerProps): React$1.ReactElement;
 
 /**
  * useTrackLevels — drives the cosmetic per-track strip meters.
@@ -2949,6 +2955,21 @@ interface SDKTrackRowProps {
     onImportSound?: () => void;
     /** Sound-import button label ("Import Sample" / "Import Preset"). */
     importSoundLabel?: string;
+    /**
+     * Linked-group hint (@since SDK 2.48.0): when set, the drawer shows this
+     * info line on every tab and the Shuffle button gains a small 🔗 marker +
+     * a title suffix. Undefined (all single-track panels) renders nothing.
+     */
+    linkedSoundHint?: string;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): presence renders a "→ All"
+     * button next to Shuffle that pushes THIS row's current sound to every
+     * linked sibling. The affordance for patch changes made inside a custom
+     * plugin's own editor (Kontakt / Diva…), which fire no change event —
+     * and the only sound-propagation control that works on such tracks,
+     * since Shuffle is Surge-only.
+     */
+    onSyncSoundToGroup?: () => void;
     /** Current MIDI notes for the piano-roll editor (the 'edit' tab). */
     editNotes?: readonly PluginMidiNote[];
     /** Persist edited notes; PRESENCE of this callback enables the Edit tab. */
@@ -2968,7 +2989,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, 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;
+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, linkedSoundHint, onSyncSoundToGroup, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
 
 /**
  * Crossfade-pair metadata — family-agnostic types + parsing shared by every
@@ -3838,6 +3859,29 @@ interface ConfirmDialogProps {
 }
 declare function ConfirmDialog({ open, title, message, confirmLabel, cancelLabel, destructive, onConfirm, onCancel, testIdPrefix, }: ConfirmDialogProps): React$1.ReactElement | null;
 
+/**
+ * GroupCollapseChevron — the shared collapse/expand toggle for voice-group
+ * header bars (ensemble / arp / bass / pad). One component so all four
+ * headers look identical and plugins don't need their own lucide dep; the
+ * state itself is owned by the shell's CollapsibleGroup wrapper and arrives
+ * via GroupRenderContext (`ctx.collapsed` / `ctx.onToggleCollapse`).
+ *
+ * Renders nothing when `onToggle` is absent (pre-2.48 hosts / bare render
+ * contexts), so plugins can mount it unconditionally.
+ *
+ * @since SDK 2.48.0
+ */
+
+interface GroupCollapseChevronProps {
+    /** Whether the group's member rows are hidden. */
+    collapsed?: boolean;
+    /** Toggle handler (GroupRenderContext.onToggleCollapse). Absent ⇒ renders nothing. */
+    onToggle?: () => void;
+    /** Noun for the tooltip, e.g. "ensemble" → "Collapse ensemble". Default "group". */
+    what?: string;
+}
+declare function GroupCollapseChevron({ collapsed, onToggle, what, }: GroupCollapseChevronProps): React$1.ReactElement | null;
+
 /**
  * Modal — the SDK's one modal-stacking primitive (portal + z-tier + backdrop).
  *
@@ -4932,6 +4976,30 @@ interface PanelSoundAdapter {
     importNoun: string;
     /** History label for the lazily-seeded pre-shuffle sound, e.g. 'Previous preset'. */
     previousSoundLabel: string;
+    /**
+     * Linked-sound groups (@since SDK 2.48.0): the sibling tracks a sound
+     * change on `track` should also apply to, or null/[] when the track is not
+     * in a linked group (or the group's link toggle is OFF). Return ALL linked
+     * members — the core filters: the source track is always dropped, and
+     * preset-level broadcasts (shuffle / history-restore / sound-import) skip
+     * siblings whose instrument differs from the source's (a Surge blob must
+     * not land on Kontakt). Pick-tab instrument swaps broadcast to every
+     * sibling unfiltered — that is what converges a mixed group.
+     */
+    broadcastTargets?(track: GeneratorTrackState, services: GenerationServices): Promise<Array<{
+        engineId: string;
+        dbId: string;
+        label?: string;
+    }> | null>;
+    /**
+     * Persist a descriptor as the track's DURABLE sound identity WITHOUT
+     * re-applying it (the descriptor-space half of copySnapshot). The linked
+     * broadcast calls it per target — and on the source after restore/import,
+     * which apply live-only — so getTrackSound / transitions / agent tools
+     * read the truth. Best-effort; families without a durable store omit it.
+     * @since SDK 2.48.0
+     */
+    persistDescriptor?(trackId: string, descriptor: unknown, label: string): Promise<void>;
 }
 /** The 🎲: pick + apply one new sound, honoring the exclusion cycle. */
 interface PanelShuffleAdapter {
@@ -4971,6 +5039,12 @@ interface GenerationServices {
     createFamilyTrack(nameSuffix?: string): Promise<PluginTrackHandle>;
     /** Resolved groups for a registered group extension. */
     resolvedGroups<M>(metaKey: string): ResolvedTrackGroup<M, GeneratorTrackState>[];
+    /**
+     * The family sound adapter. Always present when built by the core's
+     * makeServices; optional only for pre-2.48 hand-built test services.
+     * @since SDK 2.48.0
+     */
+    sound?: PanelSoundAdapter;
 }
 /**
  * One prompt-driven generation turn. The core owns the wrapper: prompt/auth
@@ -4988,6 +5062,12 @@ interface CoreTrackHandlers {
     promptChange(trackId: string, prompt: string): void;
     generate(trackId: string): void;
     shuffle(trackId: string): void;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): broadcast the track's CURRENT
+     * sound to its linked siblings — the affordance for patch changes made
+     * inside a plugin's own editor (no change event to hook).
+     */
+    syncSoundToGroup(trackId: string): void;
     copy(trackId: string): void;
     delete(trackId: string): void;
     muteToggle(trackId: string): void;
@@ -5024,6 +5104,15 @@ interface GroupRenderContext {
         engineId: string;
         dbId: string;
     }>, cleanupKeySuffixes: string[]): Promise<void>;
+    /**
+     * Whether this group is visually collapsed (@since SDK 2.48.0). The shell
+     * owns the state and persists it per group in scene-data
+     * (`track:<groupId>:groupUi`); renderGroup wraps its member rows in
+     * `{!ctx.collapsed && …}` and renders a GroupCollapseChevron in its header.
+     */
+    collapsed?: boolean;
+    /** Toggle this group's collapsed state (persisted). @since SDK 2.48.0 */
+    onToggleCollapse?: () => void;
 }
 /**
  * A family-registered multi-track group row (the crossfade seam,
@@ -5303,6 +5392,18 @@ interface GeneratorPanelCore {
     handlers: CoreTrackHandlers;
     handleGenerate(trackId: string): Promise<void>;
     handleShuffle(trackId: string): Promise<void>;
+    /**
+     * History-tab restore + linked-group broadcast (@since SDK 2.48.0) — the
+     * shell wires this as every row's onRestoreSound. Identical to
+     * soundHistory.restoreTo for panels without broadcastTargets.
+     */
+    handleRestoreSound(trackId: string, index: number): Promise<void>;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): capture the track's CURRENT
+     * sound and broadcast it to its linked siblings — for edits made inside a
+     * plugin's own editor, which fire no change event.
+     */
+    handleSyncSoundToGroup(trackId: string): Promise<void>;
     handleAddTrack(): Promise<void>;
     handleDeleteTrack(trackId: string): Promise<void>;
     handleExportMidi(): Promise<void>;
@@ -5380,22 +5481,127 @@ interface SurgeSoundAdapterOverrides {
 declare function createSurgeSoundAdapter(host: PluginHost, overrides?: SurgeSoundAdapterOverrides): PanelSoundAdapter;
 
 /**
- * ensemble-core: voice specifications — the register + complexity hierarchy
- * as DATA. The first live per-voice register map in the platform (the only
- * prior per-role [low,high] table, MusicTheory.getSuggestedRegister, was
- * dead code).
+ * ensemble-core: style packs. A style = which SOFT rules are violations +
+ * a prompt paragraph steering the joint composition. Hard rules (register,
+ * per-voice monophony, density caps, root-only anchors) apply to every
+ * style — see enforce-voice.ts. Explicitly NOT just baroque: parallels are
+ * a defect in `counterpoint`, the whole point of `interlock`, and the very
+ * mechanism of the horn-section styles (`stabs` / `riffs` / `unison`),
+ * which additionally INVERT the coordination rule — togetherness is
+ * required, not forbidden (`maxOnsetIndependence`).
+ *
+ * Which styles are offered under which parent instrumentation lives in
+ * instrumentation.ts (STYLES_FOR_INSTRUMENTATION).
+ *
+ * @since SDK 2.42.0 (horn-section styles @since 2.39.0 — see instrumentation.ts)
+ */
+type EnsembleStyle = 'counterpoint' | 'chorale' | 'interlock' | 'stabs' | 'riffs' | 'unison';
+/**
+ * The WOVEN (strings/winds) trio. Kept under the historical name because
+ * pre-instrumentation stored configs and consumers validate against it;
+ * per-mode lists live in instrumentation.ts.
+ */
+declare const ENSEMBLE_STYLES: readonly EnsembleStyle[];
+interface EnsembleStyleRules {
+    /** Consecutive perfect 5ths/octaves between adjacent voices are violations. */
+    forbidParallelPerfects: boolean;
+    /** A nominally-upper voice sounding below its neighbor is a violation. */
+    forbidVoiceCrossing: boolean;
+    /**
+     * Minimum fraction of an upper voice's onsets that must NOT coincide with
+     * its lower neighbor (0 = homorhythm fine, 1 = fully independent).
+     */
+    minOnsetIndependence: number;
+    /**
+     * Section styles only: the CEILING on that same fraction — a pair whose
+     * upper voice attacks apart from its lower neighbor more than this is a
+     * violation (the section must hit together). Absent = no ceiling.
+     */
+    maxOnsetIndependence?: number;
+    /**
+     * Mechanical per-note duration ceiling in beats, enforced by
+     * enforceVoice (stab styles — a punch must not become a pad). Absent =
+     * no cap.
+     */
+    maxNoteDurationBeats?: number;
+    /** Prompt paragraph injected into the system prompt for this style. */
+    promptParagraph: string;
+}
+/**
+ * Section-style togetherness ceilings + the stab length, exported in the
+ * bass-plugin tradition — tune by ear, not by refactor. Independence is the
+ * fraction of an upper voice's onsets its lower neighbor does NOT share:
+ * 0.25 tolerates a stray pickup note per phrase, 0.15 demands lockstep.
+ */
+declare const STAB_MAX_ONSET_INDEPENDENCE = 0.25;
+declare const RIFF_MAX_ONSET_INDEPENDENCE = 0.3;
+declare const UNISON_MAX_ONSET_INDEPENDENCE = 0.15;
+/** A stab longer than a quarter note is a pad — mechanically trimmed. */
+declare const STAB_MAX_NOTE_DURATION_BEATS = 1;
+declare const STYLE_RULES: Record<EnsembleStyle, EnsembleStyleRules>;
+
+/**
+ * ensemble-core: the INSTRUMENTATION axis — which family of ensemble the
+ * voices model. The parent selection gates the style list (a funk horn
+ * section has no 'chorale'; a string ensemble has no 'stabs') and picks the
+ * voice-spec table (registers, roles, rhythm palettes — see voice-spec.ts).
+ *
+ * Sound coupling stays category-level ONLY: specs stamp the generally
+ * correct role ('strings' / 'brass' / 'winds') and registers use REAL
+ * instrument ranges — users routinely swap the placeholder Surge XT patch
+ * for a sampled library (Kontakt, Omnisphere), so the written MIDI must sit
+ * where real sections play, not where any particular synth patch flatters.
  *
- * The shape encodes the product intent: the TOP voice is the highest-pitched
- * and most complex line; complexity decreases with register; the bottom
- * voice is a sparse anchor (root pitch classes only when `rootOnly`).
+ * @since SDK 2.39.0
+ */
+
+type EnsembleInstrumentation = 'strings' | 'horns' | 'winds';
+declare const ENSEMBLE_INSTRUMENTATIONS: readonly EnsembleInstrumentation[];
+/**
+ * Styles selectable under each parent instrumentation. Strings and winds
+ * share the WOVEN trio (independent/held-line writing); horns get the
+ * SECTION trio (rhythmic-unison funk writing) — the two families obey
+ * opposite coordination rules (see ensemble-prompt.ts).
+ */
+declare const STYLES_FOR_INSTRUMENTATION: Record<EnsembleInstrumentation, readonly EnsembleStyle[]>;
+declare const DEFAULT_STYLE_FOR_INSTRUMENTATION: Record<EnsembleInstrumentation, EnsembleStyle>;
+/** Clamp an arbitrary stored/hinted value into the closed instrumentation domain. */
+declare function normalizeInstrumentation(raw: unknown): EnsembleInstrumentation;
+/**
+ * Clamp a stored/hinted style into the instrumentation's own list — a group
+ * switched from Strings to Horns with 'counterpoint' still stored lands on
+ * the horn default instead of a style the mode can't honor.
+ */
+declare function styleForInstrumentation(instrumentation: EnsembleInstrumentation, rawStyle: string | undefined | null): EnsembleStyle;
+
+/**
+ * ensemble-core: voice specifications — the register + complexity hierarchy
+ * as DATA, one table set per INSTRUMENTATION (see instrumentation.ts). The
+ * first live per-voice register map in the platform (the only prior
+ * per-role [low,high] table, MusicTheory.getSuggestedRegister, was dead
+ * code).
+ *
+ * The WOVEN families (strings, winds) encode the original product intent:
+ * the TOP voice is the highest-pitched and most complex line; complexity
+ * decreases with register; the bottom voice is a sparse anchor. The
+ * SECTION family (horns) deliberately breaks that pyramid: every player
+ * shares the lead's rhythm, so caps are EQUAL and generous — density
+ * thinning is a runaway guard there, never a shaping tool (unequal caps
+ * would punch holes in unison hits).
+ *
+ * Horn/wind registers are REAL instrument ranges in concert pitch
+ * (comfortable working tessitura, not extremes) — the Surge XT patch is a
+ * placeholder and users re-target sampled libraries, so the MIDI must sit
+ * where actual sections play.
  *
  * All thresholds are exported constants in the bass-plugin tradition —
  * tune by ear, not by refactor. Roles are plain strings validated by the
  * host at stamp time (`host.getValidRoles()`); the SDK deliberately ships
  * no role list.
  *
- * @since SDK 2.42.0
+ * @since SDK 2.42.0 (horns/winds tables @since 2.39.0)
  */
+
 interface EnsembleVoiceSpec {
     /** 0 = top voice; increases downward. */
     voiceIndex: number;
@@ -5421,16 +5627,19 @@ interface EnsembleVoiceSpec {
      */
     monoPreference: 'high' | 'low';
 }
+/** Equal per-voice cap for horn tables — a runaway guard, not a shaper. */
+declare const HORN_MAX_NOTES_PER_BAR = 12;
 /** Supported ensemble sizes. */
 declare const ENSEMBLE_MIN_VOICES = 2;
 declare const ENSEMBLE_MAX_VOICES = 6;
 /**
- * Default voice specs for an N-voice ensemble, top voice first. Clamps N to
- * the supported range. Returned objects are fresh copies — callers may
- * override fields (e.g. style packs narrowing registers) without touching
- * the tables.
+ * Default voice specs for an N-voice ensemble of the given instrumentation,
+ * top voice first. Clamps N to the supported range; instrumentation
+ * defaults to 'strings' (the pre-instrumentation behavior, unchanged).
+ * Returned objects are fresh copies — callers may override fields (e.g.
+ * style packs narrowing registers) without touching the tables.
  */
-declare function defaultVoiceSpecs(voiceCount: number): EnsembleVoiceSpec[];
+declare function defaultVoiceSpecs(voiceCount: number, instrumentation?: EnsembleInstrumentation): EnsembleVoiceSpec[];
 
 /**
  * ensemble-core: HARD per-voice enforcement — the mechanical layer between
@@ -5476,6 +5685,12 @@ interface EnforceVoiceOptions {
     scalePcs?: ReadonlySet<number>;
     /** Chord-tone pitch classes for a bar — exemptions for the scale snap. */
     chordPcsAtBar?: (bar: number) => ReadonlySet<number> | null;
+    /**
+     * Style-level per-note duration ceiling in beats (stab styles — see
+     * STYLE_RULES[*].maxNoteDurationBeats). A punch must not become a pad;
+     * longer notes are trimmed, never dropped.
+     */
+    maxNoteDurationBeats?: number;
 }
 interface EnforceVoiceResult {
     notes: EnsembleNote[];
@@ -5541,34 +5756,10 @@ declare function describeViolations(analysis: EnsembleAnalysis, rules: {
     forbidParallelPerfects: boolean;
     forbidVoiceCrossing: boolean;
     minOnsetIndependence: number;
+    /** Section styles: independence ABOVE this is the violation (see styles.ts). */
+    maxOnsetIndependence?: number;
 }): string[];
 
-/**
- * ensemble-core: style packs. A style = which SOFT rules are violations +
- * a prompt paragraph steering the joint composition. Hard rules (register,
- * per-voice monophony, density caps, root-only anchors) apply to every
- * style — see enforce-voice.ts. Explicitly NOT just baroque: parallels are
- * a defect in `counterpoint` and the whole point of `interlock`.
- *
- * @since SDK 2.42.0
- */
-type EnsembleStyle = 'counterpoint' | 'chorale' | 'interlock';
-declare const ENSEMBLE_STYLES: readonly EnsembleStyle[];
-interface EnsembleStyleRules {
-    /** Consecutive perfect 5ths/octaves between adjacent voices are violations. */
-    forbidParallelPerfects: boolean;
-    /** A nominally-upper voice sounding below its neighbor is a violation. */
-    forbidVoiceCrossing: boolean;
-    /**
-     * Minimum fraction of an upper voice's onsets that must NOT coincide with
-     * its lower neighbor (0 = homorhythm fine, 1 = fully independent).
-     */
-    minOnsetIndependence: number;
-    /** Prompt paragraph injected into the system prompt for this style. */
-    promptParagraph: string;
-}
-declare const STYLE_RULES: Record<EnsembleStyle, EnsembleStyleRules>;
-
 /**
  * ensemble-core: the `submit_ensemble` function-calling contract — how the
  * ONE joint LLM call returns all voices as structured JSON. Built for
@@ -5604,21 +5795,30 @@ declare function parseEnsembleArgs(args: unknown, voiceCount: number): ParsedEns
 
 /**
  * ensemble-core: the joint-composition system prompt. ONE call composes ALL
- * voices together — the coordination (imitation, staggered entrances,
- * contrary motion) has to be planned across voices, which is exactly what
- * per-track generation can never do. Mirrors the bass plugin's prompt
- * discipline: numbered load-bearing rules, register/density contracts
- * stated per voice, sound selection nowhere in sight (that stays
+ * voices together — the coordination has to be planned across voices, which
+ * is exactly what per-track generation can never do. Mirrors the bass
+ * plugin's prompt discipline: numbered load-bearing rules, register/density
+ * contracts stated per voice, sound selection nowhere in sight (that stays
  * mechanical, host-side).
  *
+ * The numbered rules are INSTRUMENTATION-dependent — the two families obey
+ * opposite coordination physics:
+ *
+ *   WOVEN (strings, winds): independent lines that converse — imitation,
+ *   contrary motion, staggered entrances, avoid attacking together.
+ *
+ *   SECTION (horns): one instrument with many bells — every voice attacks
+ *   WITH the lead, voiced under it, short and syncopated, biased hard
+ *   toward dance/funk (James Brown stabs, rhythmic punches).
+ *
  * The musical context (key/BPM/chords/contract) arrives via the host's
- * generateWithLLM(Tools) auto-prefix — this prompt states the ENSEMBLE
+ * generateWithLLM(Tools) auto-prefix — this prompt states the ensemble
  * rules and the per-voice contracts only.
  *
- * @since SDK 2.42.0
+ * @since SDK 2.42.0 (section rules @since 2.39.0)
  */
 
-declare function buildEnsembleSystemPrompt(specs: readonly EnsembleVoiceSpec[], style: EnsembleStyle): string;
+declare function buildEnsembleSystemPrompt(specs: readonly EnsembleVoiceSpec[], style: EnsembleStyle, instrumentation?: EnsembleInstrumentation): string;
 /**
  * Build the retry user-message suffix from soft-rule violations — one
  * guided second attempt, quota-conscious (callers should not loop).
@@ -5837,4 +6037,4 @@ interface PickTopKOptions {
  */
 declare function pickTopKWeighted<T>(scored: ReadonlyArray<ScoredCandidate<T>>, options?: PickTopKOptions): T | null;
 
-export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AdjacentPairAnalysis, 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, ENSEMBLE_MAX_VOICES, ENSEMBLE_MIN_VOICES, ENSEMBLE_STYLES, EQUAL_POWER_GAIN, type EnforceVoiceOptions, type EnforceVoiceResult, type EnsembleAnalysis, type EnsembleNote, type EnsembleStyle, type EnsembleStyleRules, type EnsembleVoiceSpec, 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 FreezeDep, 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, MIN_NOTE_DURATION_BEATS, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MotionKind, 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 ParsedEnsemble, 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 PluginGenerationContextOptions, 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, STYLE_RULES, SUBMIT_ENSEMBLE_TOOL_NAME, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type SceneTrackSummary, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetOptions, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SurgeXtStatus, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, type TrackCreatedContext, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, TrackFreezeSection, type TrackFreezeSectionProps, type TrackFreezeState, 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 UseTrackFreezeResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VerbatimFadeMember, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeEnsemble, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildEnsembleSystemPrompt, buildFadeVolumeCurve, buildRowSlots, buildSubmitEnsembleParameters, buildViolationRetrySuffix, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, defaultVoiceSpecs, describeViolations, drawWaveform, effectivePxPerBeat, enforceVoice, foldPitchToRegister, formatConcurrentTracks, hashString, moveItem, nearestPitchWithPc, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseEnsembleArgs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, promptEnterToGenerate, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, splitFadeEntries, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackFreeze, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };
+export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AdjacentPairAnalysis, 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, DEFAULT_STYLE_FOR_INSTRUMENTATION, 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, ENSEMBLE_INSTRUMENTATIONS, ENSEMBLE_MAX_VOICES, ENSEMBLE_MIN_VOICES, ENSEMBLE_STYLES, EQUAL_POWER_GAIN, type EnforceVoiceOptions, type EnforceVoiceResult, type EnsembleAnalysis, type EnsembleInstrumentation, type EnsembleNote, type EnsembleStyle, type EnsembleStyleRules, type EnsembleVoiceSpec, 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 FreezeDep, 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, GroupCollapseChevron, type GroupCollapseChevronProps, type GroupFadeEntry, type GroupFadeEntryOf, type GroupFadeMemberLayer, GroupFadeTrackRow, type GroupFadeTrackRowProps, type GroupParseSpec, type GroupRenderContext, HORN_MAX_NOTES_PER_BAR, 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, MIN_NOTE_DURATION_BEATS, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MotionKind, 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 ParsedEnsemble, 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 PluginGenerationContextOptions, 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, RIFF_MAX_ONSET_INDEPENDENCE, 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, STAB_MAX_NOTE_DURATION_BEATS, STAB_MAX_ONSET_INDEPENDENCE, STYLES_FOR_INSTRUMENTATION, STYLE_RULES, SUBMIT_ENSEMBLE_TOOL_NAME, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type SceneTrackSummary, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetOptions, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SurgeXtStatus, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, type TrackCreatedContext, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, TrackFreezeSection, type TrackFreezeSectionProps, type TrackFreezeState, 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, UNISON_MAX_ONSET_INDEPENDENCE, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackExternalFxResult, type UseTrackFreezeResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VerbatimFadeMember, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeEnsemble, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildEnsembleSystemPrompt, buildFadeVolumeCurve, buildRowSlots, buildSubmitEnsembleParameters, buildViolationRetrySuffix, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, defaultVoiceSpecs, describeViolations, drawWaveform, effectivePxPerBeat, enforceVoice, foldPitchToRegister, formatConcurrentTracks, hashString, moveItem, nearestPitchWithPc, newTrackState, normalizeInstrumentation, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseEnsembleArgs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, promptEnterToGenerate, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, splitFadeEntries, styleForInstrumentation, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackFreeze, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };