@signalsandsorcery/plugin-sdk 2.35.4 → 2.35.6

package/dist/index.d.ts

@@ -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.
@@ -540,8 +554,12 @@ interface PluginHost {
      * @since SDK 1.4.0
      */
     readTextFile(absolutePath: string): Promise<string | null>;
-    /** Get the FULL generation context for the active scene. */
-    getGenerationContext(excludeTrackId?: string): Promise<PluginGenerationContext>;
+    /**
+     * Get the FULL generation context for the active scene. Pass
+     * `opts.pinTrackDbIds` to pin reference tracks past the note budget
+     * (see `PluginGenerationContextOptions`). @since SDK 2.42.0 (opts)
+     */
+    getGenerationContext(excludeTrackId?: string, opts?: PluginGenerationContextOptions): Promise<PluginGenerationContext>;
     /** Get lightweight musical context (no concurrent track MIDI data). */
     getMusicalContext(): Promise<MusicalContext>;
     /** Get the active scene ID. Null if no scene is active. */
@@ -616,6 +634,16 @@ interface PluginHost {
      * @since SDK 2.22.0
      */
     listSceneFamilyTracks?(sceneDbId: string): Promise<SceneFamilyTrack[]>;
+    /**
+     * Enumerate ALL tracks in the ACTIVE scene — unfiltered by plugin family or
+     * ownership (unlike `listSceneFamilyTracks`). Read-only; names are
+     * display-only per the Track Identity rule (use `dbId` for any lookup).
+     * Powers reference-track pickers ("write in counterpoint against these") —
+     * the returned `dbId`s feed `PluginGenerationContextOptions.pinTrackDbIds`.
+     * Returns [] when no project/scene is bound. Optional — callers MUST
+     * null-check (see `listImportableTracks`). @since SDK 2.42.0
+     */
+    listSceneTracks?(): Promise<SceneTrackSummary[]>;
     /**
      * Read a specific scene's musical key (tonic + mode) by db id. Labels the
      * SOURCE keys of a crossfade's origin/target patterns — the active-scene
@@ -702,6 +730,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. */
@@ -1397,6 +1436,24 @@ interface ImportCandidateScene {
      */
     sameScene?: boolean;
 }
+/**
+ * One track in the ACTIVE scene, returned by `host.listSceneTracks` —
+ * unfiltered by family/ownership. `name` is display-only (Track Identity
+ * rule); `dbId` is the stable selector for `pinTrackDbIds`.
+ * @since SDK 2.42.0
+ */
+interface SceneTrackSummary {
+    /** Stable DB row id (`tracks.id`). */
+    dbId: string;
+    /** Display name — never use as an identifier. */
+    name: string;
+    /** Canonical role (`InstrumentType`) when stamped. */
+    role?: string;
+    /** User-typed prompt that produced the track, when stored. */
+    prompt?: string;
+    /** True when the track has saved MIDI (i.e. it can serve as a reference). */
+    hasMidi: boolean;
+}
 /**
  * A source track's current sound, as returned by `host.getTrackSound`. The
  * discriminant matches the panel that reads it: drums → 'sample', instruments →
@@ -1708,6 +1765,35 @@ interface PluginConcurrentTrackInfo {
     truncated?: boolean;
     /** The track's full note count before per-track truncation. */
     originalNoteCount?: number;
+    /**
+     * Track display name — CONTEXT/DISPLAY ONLY (prompts, pickers). Never an
+     * identifier: names are non-unique and mutable; use `trackId`/`dbId` for
+     * any lookup. @since SDK 2.42.0
+     */
+    name?: string;
+    /** Stable DB row id (`tracks.id`) — correlates with `pinTrackDbIds` and
+     *  `listSceneTracks()` entries. @since SDK 2.42.0 */
+    dbId?: string;
+    /**
+     * True when this track was pinned via
+     * `PluginGenerationContextOptions.pinTrackDbIds` — i.e. it is REFERENCE
+     * material the caller explicitly asked to write against, exempt from the
+     * note budget. Formatters render pinned tracks in a distinct REFERENCE
+     * block. @since SDK 2.42.0
+     */
+    pinned?: boolean;
+}
+/**
+ * Options for `getGenerationContext`. @since SDK 2.42.0
+ */
+interface PluginGenerationContextOptions {
+    /**
+     * DB row ids (`tracks.id`) of reference tracks that must ALWAYS be included
+     * whole — exempt from the cross-track note budget (ambient tracks fill the
+     * remaining budget). Powers "write in counterpoint against THESE tracks".
+     * Unknown ids and tracks without saved MIDI are ignored.
+     */
+    pinTrackDbIds?: readonly string[];
 }
 interface PluginChordSegment {
     chord: string;
@@ -3022,6 +3108,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 {
@@ -3036,6 +3134,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`.
  *
@@ -3135,6 +3261,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.
  *
@@ -3355,10 +3530,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) →
@@ -3370,7 +3558,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.
@@ -4668,6 +4856,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;
@@ -4687,6 +4941,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;
 }
@@ -4722,6 +4982,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;
@@ -4748,6 +5010,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;
 
@@ -4818,6 +5090,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[];
@@ -4901,6 +5177,252 @@ 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).
+ *
+ * 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`).
+ *
+ * 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
+ */
+interface EnsembleVoiceSpec {
+    /** 0 = top voice; increases downward. */
+    voiceIndex: number;
+    /** Human label for the track row + prompt ("high florid line"). */
+    label: string;
+    /** InstrumentType to stamp on the voice's track (drives preset category). */
+    role: string;
+    /** Playable window (MIDI note numbers, inclusive). Enforced by octave-fold. */
+    registerLow: number;
+    registerHigh: number;
+    /** Density budget — hard cap, enforced by weakest-note thinning. */
+    maxNotesPerBar: number;
+    /** Prompt text: rhythmic vocabulary for this voice. */
+    rhythmPalette: string;
+    /** Prompt text: harmonic discipline for this voice. */
+    harmonicDiscipline: string;
+    /** When true the voice plays ONLY each bar's chord-root pitch class. */
+    rootOnly?: boolean;
+    /**
+     * Equal-onset survivor during the per-voice monophony sweep: top voices
+     * keep the highest pitch, bottom voices the lowest (mirrors how ears
+     * track outer voices).
+     */
+    monoPreference: 'high' | 'low';
+}
+/** 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.
+ */
+declare function defaultVoiceSpecs(voiceCount: number): EnsembleVoiceSpec[];
+
+/**
+ * ensemble-core: HARD per-voice enforcement — the mechanical layer between
+ * the LLM's jointly-composed voices and the clips that get written. In the
+ * platform's bass-plugin tradition, everything here is deterministic
+ * analysis/repair of written notes, never LLM intention:
+ *
+ *   clip clamp → octave-fold into the voice's register window →
+ *   root-only pinning (anchor voices) → in-scale snap (optional) →
+ *   per-voice monophony sweep → per-bar density thinning
+ *
+ * Each voice stays a single line (monophonic); OVERLAP BETWEEN voices is the
+ * point of counterpoint and is never touched here. Soft, style-dependent
+ * rules (parallels, crossings, onset independence) live in
+ * analyze-ensemble.ts — they are reported, not repaired.
+ *
+ * Pure functions; inputs are never mutated. @since SDK 2.42.0
+ */
+
+/** Structural match for PluginMidiNote — keeps this module dependency-free. */
+interface EnsembleNote {
+    pitch: number;
+    startBeat: number;
+    durationBeats: number;
+    velocity: number;
+    channel?: number;
+}
+interface EnforceVoiceOptions {
+    /** Clip length in bars (4/4 assumed, matching the platform grid). */
+    bars: number;
+    /**
+     * Chord-root pitch class (0-11) for a given bar, or null when unknown.
+     * Required for `rootOnly` voices to mean anything; when absent, rootOnly
+     * degrades to plain register enforcement.
+     */
+    chordRootPcAtBar?: (bar: number) => number | null;
+    /**
+     * Scale pitch classes (0-11) for the scene key. When provided, non-scale
+     * pitches snap to the nearest scale pitch class (chord tones supplied via
+     * `chordPcsAtBar` are exempt — a sounding 7th over its chord is not an
+     * error even outside the scale).
+     */
+    scalePcs?: ReadonlySet<number>;
+    /** Chord-tone pitch classes for a bar — exemptions for the scale snap. */
+    chordPcsAtBar?: (bar: number) => ReadonlySet<number> | null;
+}
+interface EnforceVoiceResult {
+    notes: EnsembleNote[];
+    /** Human/LLM-readable descriptions of every repair performed. */
+    repairs: string[];
+}
+declare const MIN_NOTE_DURATION_BEATS = 0.0625;
+/** Octave-fold a pitch into [low, high], preserving pitch class when possible. */
+declare function foldPitchToRegister(pitch: number, low: number, high: number): number;
+/** Nearest pitch within [low, high] having pitch class `pc` (ties go low). */
+declare function nearestPitchWithPc(reference: number, pc: number, low: number, high: number): number;
+/**
+ * Enforce one voice's hard contract. Order matters: register first (so
+ * root-only/scale snaps operate in-window), monophony before density (the
+ * sweep can merge/trim what thinning would otherwise count).
+ */
+declare function enforceVoice(rawNotes: readonly EnsembleNote[], spec: EnsembleVoiceSpec, opts: EnforceVoiceOptions): EnforceVoiceResult;
+
+/**
+ * ensemble-core: SOFT cross-voice analysis — the "do the voices actually
+ * talk to each other?" metrics. Nothing here repairs notes; violations are
+ * REPORTED so the caller can (a) feed them back to the LLM for one guided
+ * retry and (b) surface honest telemetry. Which findings count as
+ * violations is style-dependent (see styles.ts) — parallels are a defect in
+ * counterpoint and a feature in minimal interlock.
+ *
+ * Pure functions; deterministic; fixture-testable without an LLM.
+ * @since SDK 2.42.0
+ */
+
+type MotionKind = 'contrary' | 'oblique' | 'similar' | 'parallel';
+interface AdjacentPairAnalysis {
+    /** Upper voice index of the pair (pairs with upperVoice + 1). */
+    upperVoice: number;
+    /** Fraction of the upper voice's onsets NOT shared with the lower voice. */
+    onsetIndependence: number;
+    /** Distribution of motion kinds across consecutive shared onsets. */
+    motion: Record<MotionKind, number>;
+    /** Consecutive perfect 5ths/octaves moving in similar motion. */
+    parallelPerfects: Array<{
+        atBeat: number;
+        intervalPc: 0 | 7;
+    }>;
+    /** Beats where the nominally-upper voice sounds BELOW the lower voice. */
+    crossings: number[];
+}
+interface EnsembleAnalysis {
+    pairs: AdjacentPairAnalysis[];
+    /** Fraction of ALL onsets (across voices) that land on a shared beat. */
+    homorhythmScore: number;
+}
+/**
+ * Analyze adjacent voice pairs (voice i against voice i+1, top-down order).
+ * Voices with no notes yield neutral entries rather than poisoning the run.
+ */
+declare function analyzeEnsemble(voices: ReadonlyArray<readonly EnsembleNote[]>): EnsembleAnalysis;
+/**
+ * Render style-filtered violations as short instructions an LLM can act on
+ * in a retry ("Between voice 1 and voice 2, avoid parallel octaves at beat
+ * 6"). Empty array = the ensemble passes this style's soft rules.
+ */
+declare function describeViolations(analysis: EnsembleAnalysis, rules: {
+    forbidParallelPerfects: boolean;
+    forbidVoiceCrossing: boolean;
+    minOnsetIndependence: 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
+ * `host.generateWithLLMTools` with `functionCallingConfig.mode: 'ANY'` +
+ * `allowedFunctionNames: [SUBMIT_ENSEMBLE_TOOL_NAME]`, which forces a
+ * schema-constrained call instead of free text (the `generateWithLLM`
+ * `responseFormat` field is a dead letter — this is the reliable path).
+ *
+ * Parsing is defensive: the model's args pass through structural checks and
+ * per-note validation; a voice the model omits comes back as an empty note
+ * list so the caller can decide whether that is acceptable for the style.
+ *
+ * @since SDK 2.42.0
+ */
+
+declare const SUBMIT_ENSEMBLE_TOOL_NAME = "submit_ensemble";
+/**
+ * JSON-Schema `parameters` for the submit_ensemble tool. Gemini function
+ * calling accepts standard JSON Schema here.
+ */
+declare function buildSubmitEnsembleParameters(voiceCount: number): Record<string, unknown>;
+interface ParsedEnsemble {
+    /** Index-aligned: entry v = notes for voiceIndex v (possibly empty). */
+    voiceNotes: EnsembleNote[][];
+    /** Structural oddities worth logging (wrong count, dropped notes…). */
+    warnings: string[];
+}
+/**
+ * Validate + normalize the functionCall args into per-voice note lists.
+ * Returns null only when nothing usable came back.
+ */
+declare function parseEnsembleArgs(args: unknown, voiceCount: number): ParsedEnsemble | null;
+
+/**
+ * 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
+ * mechanical, host-side).
+ *
+ * The musical context (key/BPM/chords/contract) arrives via the host's
+ * generateWithLLM(Tools) auto-prefix — this prompt states the ENSEMBLE
+ * rules and the per-voice contracts only.
+ *
+ * @since SDK 2.42.0
+ */
+
+declare function buildEnsembleSystemPrompt(specs: readonly EnsembleVoiceSpec[], style: EnsembleStyle): string;
+/**
+ * Build the retry user-message suffix from soft-rule violations — one
+ * guided second attempt, quota-conscious (callers should not loop).
+ */
+declare function buildViolationRetrySuffix(violations: readonly string[]): string;
+
 /**
  * useSceneState — Scene-keyed state hook for plugin developers.
  *
@@ -4954,7 +5476,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.40.0";
+declare const PLUGIN_SDK_VERSION = "2.42.0";
 
 /**
  * FX Preset Definitions
@@ -5019,8 +5541,19 @@ declare function dbToSlider(db: number): number;
  * grouped by chord) so the model sees velocity / start-beat /
  * duration / pitch verbatim and can reason about feel + harmony.
  *
+ * Tracks pinned via `PluginGenerationContextOptions.pinTrackDbIds` render
+ * FIRST under a REFERENCE TRACKS header with an explicit counterpoint
+ * instruction — they are the parts the caller asked to write against,
+ * not merely ambient context.
+ *
  * Returns the empty string when there are no concurrent tracks — call
  * sites can `if (block) push(block)` rather than baking in a placeholder.
+ *
+ * NOTE: maintained as byte-identical copies in
+ * `sas-plugin-sdk/src/utils/format-concurrent-tracks.ts` (panels) and
+ * `sas-app/src/shared/utils/format-concurrent-tracks.ts` (main process,
+ * which must not import SDK runtime). The parity test
+ * `format-concurrent-tracks-parity.test.ts` pins the two together.
  */
 
 declare function formatConcurrentTracks(ctx: PluginGenerationContext): string;
@@ -5102,4 +5635,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 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 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 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, analyzeEnsemble, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildEnsembleSystemPrompt, buildFadeVolumeCurve, buildRowSlots, buildSubmitEnsembleParameters, buildViolationRetrySuffix, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, defaultVoiceSpecs, describeViolations, drawWaveform, enforceVoice, foldPitchToRegister, formatConcurrentTracks, hashString, moveItem, nearestPitchWithPc, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseEnsembleArgs, 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 };