@signalsandsorcery/plugin-sdk 2.38.2 → 2.40.1

package/dist/index.mjs

@@ -1204,6 +1204,7 @@ function TrackDrawer({
   onToggleFavorite,
   onImportSound,
   importSoundLabel,
+  linkedSoundHint,
   editNotes,
   onNotesChange,
   editBars,
@@ -1270,7 +1271,7 @@ function TrackDrawer({
     }
   ) : null;
   const currentSound = soundHistoryCursor >= 0 && soundHistoryCursor < history.length ? history[soundHistoryCursor].label : null;
-  const header = strip || currentSound ? /* @__PURE__ */ jsxs5("div", { className: "flex flex-col gap-1", "data-testid": "sdk-drawer-header", children: [
+  const header = strip || currentSound || linkedSoundHint ? /* @__PURE__ */ jsxs5("div", { className: "flex flex-col gap-1", "data-testid": "sdk-drawer-header", children: [
     strip,
     currentSound && /* @__PURE__ */ jsx5(
       "span",
@@ -1279,6 +1280,14 @@ function TrackDrawer({
         title: currentSound,
         children: currentSound
       }
+    ),
+    linkedSoundHint && /* @__PURE__ */ jsx5(
+      "span",
+      {
+        "data-testid": "sdk-drawer-linked-hint",
+        className: "text-[10px] text-sas-accent/80 px-0.5",
+        children: linkedSoundHint
+      }
     )
   ] }) : null;
   if (effectiveTab === "freeze") {
@@ -2514,6 +2523,7 @@ function TrackRow({
   onToggleFavorite,
   onImportSound,
   importSoundLabel,
+  linkedSoundHint,
   editNotes,
   onNotesChange,
   editBars,
@@ -2679,15 +2689,26 @@ function TrackRow({
               )
             ] }),
             /* @__PURE__ */ jsxs9("div", { className: "flex gap-1 items-center", children: [
-              onShuffle && /* @__PURE__ */ jsx13(
+              onShuffle && /* @__PURE__ */ jsxs9(
                 "button",
                 {
                   "data-testid": "sdk-shuffle-button",
                   onClick: onShuffle,
                   disabled: !hasMidi || isGenerating || !!currentInstrumentPluginId,
-                  className: `w-14 py-0.5 rounded-sm text-xs font-medium transition-colors border ${!hasMidi || isGenerating || !!currentInstrumentPluginId ? "bg-sas-panel border-sas-border text-sas-muted/30 cursor-not-allowed" : "bg-sas-panel-alt border-sas-border text-sas-muted hover:border-sas-accent hover:text-sas-accent"}`,
-                  title: currentInstrumentPluginId ? "Shuffle only works with default Surge XT" : hasMidi ? "Re-roll sound (keep MIDI)" : "Generate MIDI first",
-                  children: "Shuffle"
+                  className: `relative w-14 py-0.5 rounded-sm text-xs font-medium transition-colors border ${!hasMidi || isGenerating || !!currentInstrumentPluginId ? "bg-sas-panel border-sas-border text-sas-muted/30 cursor-not-allowed" : "bg-sas-panel-alt border-sas-border text-sas-muted hover:border-sas-accent hover:text-sas-accent"}`,
+                  title: currentInstrumentPluginId ? "Shuffle only works with default Surge XT" : hasMidi ? linkedSoundHint ? `Re-roll sound (keep MIDI) \u2014 ${linkedSoundHint}` : "Re-roll sound (keep MIDI)" : "Generate MIDI first",
+                  children: [
+                    "Shuffle",
+                    linkedSoundHint && /* @__PURE__ */ jsx13(
+                      "span",
+                      {
+                        "aria-hidden": true,
+                        "data-testid": "sdk-shuffle-linked-marker",
+                        className: "absolute -top-1 -right-1 text-[8px] leading-none",
+                        children: "\u{1F517}"
+                      }
+                    )
+                  ]
                 }
               ),
               freezeBadge && /* @__PURE__ */ jsx13(
@@ -2771,6 +2792,7 @@ function TrackRow({
             onToggleFavorite,
             onImportSound,
             importSoundLabel,
+            linkedSoundHint,
             editNotes,
             onNotesChange,
             editBars,
@@ -4998,9 +5020,38 @@ function TransitionDesigner({
   ] });
 }
 
+// src/components/GroupCollapseChevron.tsx
+import { ChevronDown as ChevronDown2 } from "lucide-react";
+import { jsx as jsx21 } from "react/jsx-runtime";
+function GroupCollapseChevron({
+  collapsed = false,
+  onToggle,
+  what = "group"
+}) {
+  if (!onToggle) return null;
+  return /* @__PURE__ */ jsx21(
+    "button",
+    {
+      type: "button",
+      "data-testid": "sdk-group-collapse",
+      onClick: onToggle,
+      "aria-expanded": !collapsed,
+      title: collapsed ? `Expand ${what}` : `Collapse ${what}`,
+      className: "shrink-0 px-0.5 py-0.5 rounded-sm text-sas-muted hover:text-sas-accent transition-colors",
+      children: /* @__PURE__ */ jsx21(
+        ChevronDown2,
+        {
+          className: `w-3 h-3 transition-transform ${collapsed ? "-rotate-90" : ""}`,
+          strokeWidth: 2.5
+        }
+      )
+    }
+  );
+}
+
 // src/components/PanelMasterStrip.tsx
 import { useMemo as useMemo7, useState as useState15 } from "react";
-import { jsx as jsx21, jsxs as jsxs17 } from "react/jsx-runtime";
+import { jsx as jsx22, jsxs as jsxs17 } from "react/jsx-runtime";
 function PanelMasterStrip({
   bus,
   levels = null,
@@ -5034,7 +5085,7 @@ function PanelMasterStrip({
       className: `flex flex-col gap-1 px-2 py-1.5 rounded-sm border border-sas-border border-l-2 border-l-sas-accent/50 bg-sas-accent/5 transition-opacity ${soloedOut ? "opacity-40" : ""}`,
       children: [
         /* @__PURE__ */ jsxs17("div", { className: "flex items-center gap-2", children: [
-          /* @__PURE__ */ jsx21(
+          /* @__PURE__ */ jsx22(
             "span",
             {
               className: "text-[9px] font-bold tracking-widest text-sas-muted/70 select-none",
@@ -5043,7 +5094,7 @@ function PanelMasterStrip({
             }
           ),
           /* @__PURE__ */ jsxs17("div", { className: "flex-1 min-w-[8rem] flex flex-col gap-0.5", children: [
-            /* @__PURE__ */ jsx21(
+            /* @__PURE__ */ jsx22(
               VolumeSlider,
               {
                 value: dbToSlider(bus.volume),
@@ -5052,7 +5103,7 @@ function PanelMasterStrip({
               }
             ),
             /* @__PURE__ */ jsxs17("div", { className: "flex flex-col gap-px", "data-testid": "bus-meter", children: [
-              /* @__PURE__ */ jsx21(
+              /* @__PURE__ */ jsx22(
                 LevelMeter,
                 {
                   peakDb: levels?.leftDb ?? -120,
@@ -5062,7 +5113,7 @@ function PanelMasterStrip({
                   "data-testid": "bus-meter-left"
                 }
               ),
-              /* @__PURE__ */ jsx21(
+              /* @__PURE__ */ jsx22(
                 LevelMeter,
                 {
                   peakDb: levels?.rightDb ?? -120,
@@ -5073,7 +5124,7 @@ function PanelMasterStrip({
               )
             ] })
           ] }),
-          /* @__PURE__ */ jsx21(
+          /* @__PURE__ */ jsx22(
             "button",
             {
               "data-testid": "bus-mute-button",
@@ -5084,7 +5135,7 @@ function PanelMasterStrip({
               children: "M"
             }
           ),
-          /* @__PURE__ */ jsx21(
+          /* @__PURE__ */ jsx22(
             "button",
             {
               "data-testid": "bus-solo-button",
@@ -5095,14 +5146,14 @@ function PanelMasterStrip({
               children: "S"
             }
           ),
-          /* @__PURE__ */ jsx21("div", { className: "flex items-center gap-1 max-w-[45%] min-w-0 overflow-x-auto", children: bus.fx.map((fx) => /* @__PURE__ */ jsxs17(
+          /* @__PURE__ */ jsx22("div", { className: "flex items-center gap-1 max-w-[45%] min-w-0 overflow-x-auto", children: bus.fx.map((fx) => /* @__PURE__ */ jsxs17(
             "span",
             {
               "data-testid": `bus-fx-chip-${fx.index}`,
               className: `flex items-center gap-1 px-1.5 py-0.5 rounded-sm border text-[10px] whitespace-nowrap ${fx.enabled ? "border-sas-accent/60 text-sas-accent bg-sas-accent/10" : "border-sas-border text-sas-muted/50 bg-sas-panel"}`,
               title: `${fx.name}${fx.enabled ? "" : " (bypassed)"}`,
               children: [
-                /* @__PURE__ */ jsx21(
+                /* @__PURE__ */ jsx22(
                   "button",
                   {
                     "data-testid": `bus-fx-toggle-${fx.index}`,
@@ -5113,7 +5164,7 @@ function PanelMasterStrip({
                     children: fx.enabled ? "\u25CF" : "\u25CB"
                   }
                 ),
-                onShowFxEditor ? /* @__PURE__ */ jsx21(
+                onShowFxEditor ? /* @__PURE__ */ jsx22(
                   "button",
                   {
                     "data-testid": `bus-fx-edit-${fx.index}`,
@@ -5123,8 +5174,8 @@ function PanelMasterStrip({
                     title: `Open ${fx.name} editor`,
                     children: fx.name
                   }
-                ) : /* @__PURE__ */ jsx21("span", { className: "max-w-[80px] truncate", children: fx.name }),
-                /* @__PURE__ */ jsx21(
+                ) : /* @__PURE__ */ jsx22("span", { className: "max-w-[80px] truncate", children: fx.name }),
+                /* @__PURE__ */ jsx22(
                   "button",
                   {
                     "data-testid": `bus-fx-remove-${fx.index}`,
@@ -5139,7 +5190,7 @@ function PanelMasterStrip({
             },
             `${fx.index}:${fx.pluginId}`
           )) }),
-          /* @__PURE__ */ jsx21(
+          /* @__PURE__ */ jsx22(
             "button",
             {
               "data-testid": "bus-fx-add-button",
@@ -5153,7 +5204,7 @@ function PanelMasterStrip({
         ] }),
         fxPickerOpen && /* @__PURE__ */ jsxs17("div", { "data-testid": "bus-fx-picker", className: "flex flex-col gap-2 pt-1", children: [
           /* @__PURE__ */ jsxs17("div", { className: "flex items-center gap-2", children: [
-            /* @__PURE__ */ jsx21(
+            /* @__PURE__ */ jsx22(
               "input",
               {
                 type: "text",
@@ -5163,7 +5214,7 @@ function PanelMasterStrip({
                 className: "sas-input flex-1 px-2 py-1 text-xs"
               }
             ),
-            onRefreshFx && /* @__PURE__ */ jsx21(
+            onRefreshFx && /* @__PURE__ */ jsx22(
               "button",
               {
                 onClick: () => onRefreshFx(),
@@ -5174,7 +5225,7 @@ function PanelMasterStrip({
               }
             )
           ] }),
-          fxLoading && availableFx.length === 0 ? /* @__PURE__ */ jsx21("div", { className: "text-xs text-sas-muted/60 text-center py-3", children: "Scanning plugins..." }) : /* @__PURE__ */ jsxs17("div", { className: "grid grid-cols-3 gap-1 max-h-[140px] overflow-y-auto", children: [
+          fxLoading && availableFx.length === 0 ? /* @__PURE__ */ jsx22("div", { className: "text-xs text-sas-muted/60 text-center py-3", children: "Scanning plugins..." }) : /* @__PURE__ */ jsxs17("div", { className: "grid grid-cols-3 gap-1 max-h-[140px] overflow-y-auto", children: [
             filtered.map((fx) => /* @__PURE__ */ jsxs17(
               "button",
               {
@@ -5183,13 +5234,13 @@ function PanelMasterStrip({
                 className: "flex flex-col items-start px-2 py-1.5 rounded-sm border text-left transition-colors border-sas-border bg-sas-panel-alt text-sas-muted hover:border-sas-accent hover:text-sas-accent",
                 title: `${fx.name} by ${fx.manufacturer} (${fx.type.toUpperCase()})`,
                 children: [
-                  /* @__PURE__ */ jsx21("span", { className: "text-xs font-medium truncate w-full", children: fx.name }),
-                  /* @__PURE__ */ jsx21("span", { className: "text-[9px] text-sas-muted/50 truncate w-full", children: fx.manufacturer || fx.type.toUpperCase() })
+                  /* @__PURE__ */ jsx22("span", { className: "text-xs font-medium truncate w-full", children: fx.name }),
+                  /* @__PURE__ */ jsx22("span", { className: "text-[9px] text-sas-muted/50 truncate w-full", children: fx.manufacturer || fx.type.toUpperCase() })
                 ]
               },
               fx.pluginId
             )),
-            filtered.length === 0 && /* @__PURE__ */ jsx21("div", { className: "col-span-3 text-xs text-sas-muted/60 text-center py-2", children: search.trim() ? "No matches" : "No FX plugins found" })
+            filtered.length === 0 && /* @__PURE__ */ jsx22("div", { className: "col-span-3 text-xs text-sas-muted/60 text-center py-2", children: search.trim() ? "No matches" : "No FX plugins found" })
           ] })
         ] })
       ]
@@ -5316,7 +5367,7 @@ function usePanelBus(host, activeSceneId) {
 
 // src/components/DownloadPackButton.tsx
 import { useCallback as useCallback12, useEffect as useEffect13, useState as useState17 } from "react";
-import { jsx as jsx22, jsxs as jsxs18 } from "react/jsx-runtime";
+import { jsx as jsx23, jsxs as jsxs18 } from "react/jsx-runtime";
 function formatSize(bytes) {
   if (!bytes || bytes <= 0) return "";
   const gb = bytes / 1024 ** 3;
@@ -5405,7 +5456,7 @@ var DownloadPackButton = ({
     className = `${baseClasses} text-sas-muted hover:text-sas-accent border-sas-border hover:border-sas-accent`;
   }
   return /* @__PURE__ */ jsxs18("div", { children: [
-    /* @__PURE__ */ jsx22(
+    /* @__PURE__ */ jsx23(
       "button",
       {
         "data-testid": `download-pack-button-${packId}`,
@@ -5416,12 +5467,12 @@ var DownloadPackButton = ({
         children: buttonLabel
       }
     ),
-    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ jsx22("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
+    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ jsx23("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
   ] });
 };
 
 // src/components/SamplePackCTACard.tsx
-import { jsx as jsx23, jsxs as jsxs19 } from "react/jsx-runtime";
+import { jsx as jsx24, jsxs as jsxs19 } from "react/jsx-runtime";
 var SamplePackCTACard = ({
   host,
   pack,
@@ -5429,7 +5480,7 @@ var SamplePackCTACard = ({
   onDownloadComplete
 }) => {
   if (status === "checking") {
-    return /* @__PURE__ */ jsx23(
+    return /* @__PURE__ */ jsx24(
       "div",
       {
         "data-testid": `sample-pack-cta-checking-${pack.packId}`,
@@ -5446,10 +5497,10 @@ var SamplePackCTACard = ({
       "data-testid": `sample-pack-cta-${pack.packId}`,
       className: "flex flex-col items-center justify-center py-12 px-6 text-center",
       children: [
-        /* @__PURE__ */ jsx23("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
-        /* @__PURE__ */ jsx23("div", { className: "text-base text-sas-text mb-1", children: headline }),
-        /* @__PURE__ */ jsx23("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
-        /* @__PURE__ */ jsx23(
+        /* @__PURE__ */ jsx24("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
+        /* @__PURE__ */ jsx24("div", { className: "text-base text-sas-text mb-1", children: headline }),
+        /* @__PURE__ */ jsx24("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
+        /* @__PURE__ */ jsx24(
           DownloadPackButton,
           {
             host,
@@ -5529,7 +5580,7 @@ function drawWaveform(canvas, peaks, options = {}) {
 }
 
 // src/components/WaveformView.tsx
-import { jsx as jsx24 } from "react/jsx-runtime";
+import { jsx as jsx25 } from "react/jsx-runtime";
 var WaveformView = ({
   host,
   filePath,
@@ -5577,7 +5628,7 @@ var WaveformView = ({
     observer.observe(canvas);
     return () => observer.disconnect();
   }, [peaks, fillStyle]);
-  return /* @__PURE__ */ jsx24(
+  return /* @__PURE__ */ jsx25(
     "canvas",
     {
       ref: canvasRef,
@@ -5589,7 +5640,7 @@ var WaveformView = ({
 
 // src/components/ScrollingWaveform.tsx
 import { useEffect as useEffect15, useRef as useRef14 } from "react";
-import { jsx as jsx25 } from "react/jsx-runtime";
+import { jsx as jsx26 } from "react/jsx-runtime";
 var ScrollingWaveform = ({
   getPeakDb,
   active,
@@ -5665,7 +5716,7 @@ var ScrollingWaveform = ({
       }
     };
   }, [active, getPeakDb, fillStyle]);
-  return /* @__PURE__ */ jsx25(
+  return /* @__PURE__ */ jsx26(
     "canvas",
     {
       ref: canvasRef,
@@ -5677,7 +5728,7 @@ var ScrollingWaveform = ({
 
 // src/components/OffsetScrubber.tsx
 import { useCallback as useCallback13, useEffect as useEffect16, useMemo as useMemo8, useRef as useRef15, useState as useState19 } from "react";
-import { jsx as jsx26, jsxs as jsxs20 } from "react/jsx-runtime";
+import { jsx as jsx27, jsxs as jsxs20 } from "react/jsx-runtime";
 var SLIDER_HEIGHT_PX = 28;
 var TICK_HEIGHT_PX = 14;
 var DOWNBEAT_TICK_HEIGHT_PX = 22;
@@ -5793,7 +5844,7 @@ function OffsetScrubber({
   }, [cuePoints, sampleToFraction]);
   const isDisabled = disabled || !cuePoints || cuePoints.beats.length === 0;
   return /* @__PURE__ */ jsxs20("div", { "data-testid": "offset-scrubber", className: "flex items-center gap-2 w-full", children: [
-    /* @__PURE__ */ jsx26("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
+    /* @__PURE__ */ jsx27("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
     /* @__PURE__ */ jsxs20(
       "div",
       {
@@ -5810,7 +5861,7 @@ function OffsetScrubber({
         "aria-valuenow": draftOffset,
         "aria-disabled": isDisabled,
         children: [
-          /* @__PURE__ */ jsx26(
+          /* @__PURE__ */ jsx27(
             "div",
             {
               "aria-hidden": "true",
@@ -5818,7 +5869,7 @@ function OffsetScrubber({
               style: { left: "50%" }
             }
           ),
-          ticks.map((t) => /* @__PURE__ */ jsx26(
+          ticks.map((t) => /* @__PURE__ */ jsx27(
             "div",
             {
               "data-testid": t.isDownbeat ? "offset-tick-downbeat" : "offset-tick",
@@ -5833,7 +5884,7 @@ function OffsetScrubber({
             },
             t.i
           )),
-          /* @__PURE__ */ jsx26(
+          /* @__PURE__ */ jsx27(
             "div",
             {
               "data-testid": "offset-scrubber-thumb",
@@ -5850,7 +5901,7 @@ function OffsetScrubber({
         ]
       }
     ),
-    /* @__PURE__ */ jsx26(
+    /* @__PURE__ */ jsx27(
       "span",
       {
         "data-testid": "offset-scrubber-readout",
@@ -5858,7 +5909,7 @@ function OffsetScrubber({
         children: formatOffset(draftOffset, sampleRate)
       }
     ),
-    /* @__PURE__ */ jsx26(
+    /* @__PURE__ */ jsx27(
       "button",
       {
         type: "button",
@@ -5870,7 +5921,7 @@ function OffsetScrubber({
         children: "\u2316"
       }
     ),
-    bpmMismatch && /* @__PURE__ */ jsx26(
+    bpmMismatch && /* @__PURE__ */ jsx27(
       "span",
       {
         "data-testid": "offset-bpm-mismatch",
@@ -6883,7 +6934,7 @@ function useTransitionOps({
 }
 
 // src/panel-core/useGeneratorPanelCore.tsx
-import { jsx as jsx27, jsxs as jsxs21 } from "react/jsx-runtime";
+import { jsx as jsx28, jsxs as jsxs21 } from "react/jsx-runtime";
 var EMPTY_PLACEHOLDERS = [];
 function useGeneratorPanelCore({
   ui,
@@ -7294,37 +7345,6 @@ function useGeneratorPanelCore({
     },
     [host, adapter, identity, activeSceneId, isConnected, tracks.length, loadTracks]
   );
-  const handleSoundImportPick = useCallback17(
-    async (sel) => {
-      const target = soundImportTarget;
-      if (!target || !host.getTrackSound) {
-        setSoundImportTarget(null);
-        return;
-      }
-      const noun = adapter.sound.importNoun;
-      const nounTitle = noun.charAt(0).toUpperCase() + noun.slice(1);
-      try {
-        const snap = await host.getTrackSound(sel.sourceTrackDbId);
-        if (!snap || snap.kind !== adapter.sound.acceptedSnapshotKind) {
-          host.showToast(
-            "error",
-            `No ${noun} to import`,
-            `${sel.trackName} has no ${identity.familyKey} ${noun}.`
-          );
-          return;
-        }
-        const descriptor = adapter.sound.descriptorFromSnapshot(snap);
-        await adapter.sound.applySound(target.handle.id, descriptor);
-        soundHistory.record(target.handle.id, descriptor, snap.label);
-        host.showToast("success", `${nounTitle} imported`, `${snap.label} \u2192 ${target.handle.name}`);
-      } catch (err) {
-        host.showToast("error", "Import failed", err instanceof Error ? err.message : String(err));
-      } finally {
-        setSoundImportTarget(null);
-      }
-    },
-    [soundImportTarget, host, adapter, identity.familyKey, soundHistory]
-  );
   const [isExportingMidi, setIsExportingMidi] = useState24(false);
   const handleExportMidi = useCallback17(async () => {
     if (isExportingMidi) return;
@@ -7381,7 +7401,7 @@ function useGeneratorPanelCore({
     const addDisabled = needsContract || !isConnected || !activeSceneId || tracks.length >= identity.maxTracks || isAddingTrack;
     onHeaderContent(
       /* @__PURE__ */ jsxs21("div", { className: "flex gap-1 items-center", children: [
-        features.importTracks && (!canCrossfade || !designerView) && host.listImportableTracks && /* @__PURE__ */ jsx27(
+        features.importTracks && (!canCrossfade || !designerView) && host.listImportableTracks && /* @__PURE__ */ jsx28(
           "button",
           {
             "data-testid": `import-from-scene-${identity.familyKey}-button`,
@@ -7395,7 +7415,7 @@ function useGeneratorPanelCore({
             children: identity.importTrackLabel ?? "Import Track"
           }
         ),
-        (!canCrossfade || !designerView) && /* @__PURE__ */ jsx27(
+        (!canCrossfade || !designerView) && /* @__PURE__ */ jsx28(
           "button",
           {
             "data-testid": `add-${identity.familyKey}-track-button`,
@@ -7430,7 +7450,7 @@ function useGeneratorPanelCore({
             title: designerView ? "Back to the track list" : "Open the transition designer",
             className: "relative overflow-hidden px-2 py-0.5 text-[10px] font-medium rounded-sm border border-sas-accent/40 text-sas-accent transition-colors hover:border-sas-accent disabled:opacity-50",
             children: [
-              transitionSourceTotal > 0 && /* @__PURE__ */ jsx27(
+              transitionSourceTotal > 0 && /* @__PURE__ */ jsx28(
                 "span",
                 {
                   className: "absolute inset-y-0 left-0 bg-sas-accent/25",
@@ -7571,9 +7591,163 @@ function useGeneratorPanelCore({
         name: `${identity.trackNamePrefix}-${Date.now()}${nameSuffix}`,
         ...adapter.createTrackOptions()
       }),
-      resolvedGroups: (metaKey) => resolvedGenericGroupsRef.current[metaKey]?.resolved ?? []
+      resolvedGroups: (metaKey) => resolvedGenericGroupsRef.current[metaKey]?.resolved ?? [],
+      sound: adapter.sound
     };
   }, [host, activeSceneId, updateTrack, loadTracks, soundHistory, engineToDbId, markEditLoaded, identity, adapter]);
+  const broadcastSoundFromTrack = useCallback17(
+    async (sourceTrackId, descriptor, label) => {
+      const targetsOf = adapter.sound.broadcastTargets;
+      if (!targetsOf) return;
+      const source = tracksRef.current.find((t) => t.handle.id === sourceTrackId);
+      if (!source) return;
+      let targets;
+      try {
+        targets = await targetsOf(source, makeServices());
+      } catch (err) {
+        console.warn(`[${logTag}] broadcastTargets failed:`, err);
+        return;
+      }
+      const sourceInstrument = source.instrumentPluginId ?? null;
+      const others = (targets ?? []).filter((t) => {
+        if (t.engineId === sourceTrackId) return false;
+        const live = tracksRef.current.find((x) => x.handle.id === t.engineId);
+        return (live?.instrumentPluginId ?? null) === sourceInstrument;
+      });
+      if (others.length === 0) return;
+      try {
+        await adapter.sound.persistDescriptor?.(sourceTrackId, descriptor, label);
+      } catch {
+      }
+      const appliedIds = /* @__PURE__ */ new Set();
+      const failed = [];
+      for (const target of others) {
+        try {
+          if (soundHistory.list(target.engineId).entries.length === 0) {
+            try {
+              const cap = await adapter.sound.captureSoundDescriptor(target.engineId);
+              if (cap) {
+                soundHistory.record(target.engineId, cap.descriptor, adapter.sound.previousSoundLabel);
+              }
+            } catch {
+            }
+          }
+          await adapter.sound.applySound(target.engineId, descriptor);
+          try {
+            await adapter.sound.persistDescriptor?.(target.engineId, descriptor, label);
+          } catch {
+          }
+          soundHistory.record(target.engineId, descriptor, label);
+          appliedIds.add(target.engineId);
+        } catch (err) {
+          failed.push(target.label ?? target.engineId);
+          console.warn(`[${logTag}] Linked sound apply failed for ${target.engineId}:`, err);
+        }
+      }
+      if (appliedIds.size > 0) {
+        setTracks(
+          (prev) => prev.map(
+            (t) => appliedIds.has(t.handle.id) ? { ...t, shuffleHistory: /* @__PURE__ */ new Set([...t.shuffleHistory, label]) } : t
+          )
+        );
+      }
+      if (failed.length > 0) {
+        host.showToast(
+          "warning",
+          "Linked sound applied to some parts only",
+          `Skipped: ${failed.join(", ")}`
+        );
+      }
+    },
+    [adapter, makeServices, soundHistory, host, logTag]
+  );
+  const broadcastInstrumentFromTrack = useCallback17(
+    async (sourceTrackId, pluginId) => {
+      const targetsOf = adapter.sound.broadcastTargets;
+      if (!targetsOf) return;
+      const source = tracksRef.current.find((t) => t.handle.id === sourceTrackId);
+      if (!source) return;
+      let targets;
+      try {
+        targets = await targetsOf(source, makeServices());
+      } catch (err) {
+        console.warn(`[${logTag}] broadcastTargets failed:`, err);
+        return;
+      }
+      const others = (targets ?? []).filter((t) => t.engineId !== sourceTrackId);
+      if (others.length === 0) return;
+      const failed = [];
+      for (const target of others) {
+        try {
+          await host.setTrackInstrument(target.engineId, pluginId);
+          const descriptor = await host.getTrackInstrument(target.engineId);
+          setTracks(
+            (prev) => prev.map(
+              (t) => t.handle.id === target.engineId ? {
+                ...t,
+                instrumentPluginId: descriptor?.pluginId ?? null,
+                instrumentName: descriptor?.name ?? null,
+                instrumentMissing: descriptor?.missing ?? false
+              } : t
+            )
+          );
+        } catch (err) {
+          failed.push(target.label ?? target.engineId);
+          console.warn(`[${logTag}] Linked instrument apply failed for ${target.engineId}:`, err);
+        }
+      }
+      if (failed.length > 0) {
+        host.showToast(
+          "warning",
+          "Instrument applied to some parts only",
+          `Skipped: ${failed.join(", ")}`
+        );
+      }
+    },
+    [adapter, makeServices, host, logTag]
+  );
+  const handleRestoreSound = useCallback17(
+    async (trackId, index) => {
+      const entry = soundHistory.list(trackId).entries[index];
+      const moved = await soundHistory.restoreTo(trackId, index);
+      if (moved && entry) {
+        await broadcastSoundFromTrack(trackId, entry.descriptor, entry.label);
+      }
+    },
+    [soundHistory, broadcastSoundFromTrack]
+  );
+  const handleSoundImportPick = useCallback17(
+    async (sel) => {
+      const target = soundImportTarget;
+      if (!target || !host.getTrackSound) {
+        setSoundImportTarget(null);
+        return;
+      }
+      const noun = adapter.sound.importNoun;
+      const nounTitle = noun.charAt(0).toUpperCase() + noun.slice(1);
+      try {
+        const snap = await host.getTrackSound(sel.sourceTrackDbId);
+        if (!snap || snap.kind !== adapter.sound.acceptedSnapshotKind) {
+          host.showToast(
+            "error",
+            `No ${noun} to import`,
+            `${sel.trackName} has no ${identity.familyKey} ${noun}.`
+          );
+          return;
+        }
+        const descriptor = adapter.sound.descriptorFromSnapshot(snap);
+        await adapter.sound.applySound(target.handle.id, descriptor);
+        soundHistory.record(target.handle.id, descriptor, snap.label);
+        host.showToast("success", `${nounTitle} imported`, `${snap.label} \u2192 ${target.handle.name}`);
+        await broadcastSoundFromTrack(target.handle.id, descriptor, snap.label);
+      } catch (err) {
+        host.showToast("error", "Import failed", err instanceof Error ? err.message : String(err));
+      } finally {
+        setSoundImportTarget(null);
+      }
+    },
+    [soundImportTarget, host, adapter, identity.familyKey, soundHistory, broadcastSoundFromTrack]
+  );
   const handleGenerate = useCallback17(
     async (trackId) => {
       const track = tracks.find((t) => t.handle.id === trackId);
@@ -7692,7 +7866,10 @@ function useGeneratorPanelCore({
         );
         try {
           const cap = await adapter.sound.captureSoundDescriptor(trackId);
-          if (cap) soundHistory.record(trackId, cap.descriptor, result.appliedName);
+          if (cap) {
+            soundHistory.record(trackId, cap.descriptor, result.appliedName);
+            await broadcastSoundFromTrack(trackId, cap.descriptor, result.appliedName);
+          }
         } catch {
         }
         console.log(`[${logTag}] Sound shuffled: ${result.appliedName} (history ${nextHistory.size})`);
@@ -7701,7 +7878,7 @@ function useGeneratorPanelCore({
         host.showToast("error", "Shuffle failed", msg);
       }
     },
-    [host, adapter, tracks, soundHistory, logTag]
+    [host, adapter, tracks, soundHistory, logTag, broadcastSoundFromTrack]
   );
   const handleCopy = useCallback17(
     async (trackId) => {
@@ -7904,6 +8081,7 @@ function useGeneratorPanelCore({
               } : t
             )
           );
+          await broadcastInstrumentFromTrack(trackId, pluginId);
         } catch (err) {
           const msg = err instanceof Error ? err.message : "Failed to load instrument";
           host.showToast("error", "Instrument load failed", msg);
@@ -7926,6 +8104,7 @@ function useGeneratorPanelCore({
             } : t
           )
         );
+        await broadcastInstrumentFromTrack(trackId, pluginId);
       } catch (err) {
         const msg = err instanceof Error ? err.message : "Failed to load instrument";
         console.error(`[${logTag}] Failed to set instrument:`, err);
@@ -7935,7 +8114,7 @@ function useGeneratorPanelCore({
         );
       }
     },
-    [host, identity.defaultInstrumentPluginId, logTag]
+    [host, identity.defaultInstrumentPluginId, logTag, broadcastInstrumentFromTrack]
   );
   const handleShowEditor = useCallback17(
     async (trackId) => {
@@ -8145,6 +8324,7 @@ function useGeneratorPanelCore({
     handlers,
     handleGenerate,
     handleShuffle,
+    handleRestoreSound,
     handleAddTrack,
     handleDeleteTrack,
     handleExportMidi,
@@ -8175,8 +8355,41 @@ function useGeneratorPanelCore({
 }
 
 // src/panel-core/GeneratorPanelShell.tsx
-import React23, { useCallback as useCallback18 } from "react";
-import { Fragment as Fragment7, jsx as jsx28, jsxs as jsxs22 } from "react/jsx-runtime";
+import { useCallback as useCallback18, useEffect as useEffect20, useState as useState25 } from "react";
+import { Fragment as Fragment7, jsx as jsx29, jsxs as jsxs22 } from "react/jsx-runtime";
+var GROUP_UI_KEY = "groupUi";
+function CollapsibleGroup({
+  ext,
+  group,
+  groupCtx
+}) {
+  const { host, activeSceneId, trackDataKey: trackDataKey2 } = groupCtx.services;
+  const uiKey = trackDataKey2(group.groupId, GROUP_UI_KEY);
+  const [collapsed, setCollapsed] = useState25(false);
+  useEffect20(() => {
+    let cancelled = false;
+    if (!activeSceneId) return void 0;
+    void host.getSceneData(activeSceneId, uiKey).then((raw) => {
+      if (cancelled || !raw || typeof raw !== "object") return;
+      setCollapsed(raw.collapsed === true);
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [host, activeSceneId, uiKey]);
+  const onToggleCollapse = useCallback18(() => {
+    setCollapsed((prev) => {
+      const next = !prev;
+      if (activeSceneId) {
+        void host.setSceneData(activeSceneId, uiKey, { collapsed: next }).catch(() => {
+        });
+      }
+      return next;
+    });
+  }, [host, activeSceneId, uiKey]);
+  return /* @__PURE__ */ jsx29(Fragment7, { children: ext.renderGroup(group, { ...groupCtx, collapsed, onToggleCollapse }) });
+}
 function GeneratorPanelShell({ core, slots }) {
   const {
     ui,
@@ -8199,6 +8412,7 @@ function GeneratorPanelShell({ core, slots }) {
     soundImportTarget,
     setSoundImportTarget,
     handleSoundImportPick,
+    handleRestoreSound,
     handlePortTrack,
     transition,
     crossfadePairsMeta,
@@ -8294,7 +8508,7 @@ function GeneratorPanelShell({ core, slots }) {
         soundHistory: soundHistory.list(id).entries,
         soundHistoryCursor: soundHistory.list(id).cursor,
         onRestoreSound: (i) => {
-          void soundHistory.restoreTo(id, i);
+          void handleRestoreSound(id, i);
         },
         onToggleFavorite: (i) => soundHistory.toggleFavorite(id, i),
         ...importSoundProps,
@@ -8325,6 +8539,7 @@ function GeneratorPanelShell({ core, slots }) {
       handleBackToInstruments,
       setSoundImportTarget,
       soundHistory,
+      handleRestoreSound,
       handleFxToggle,
       handleFxPresetChange,
       handleFxDryWetChange,
@@ -8332,12 +8547,12 @@ function GeneratorPanelShell({ core, slots }) {
     ]
   );
   if (!activeSceneId) {
-    return /* @__PURE__ */ jsx28(
+    return /* @__PURE__ */ jsx29(
       "div",
       {
         "data-testid": `no-scene-placeholder-${identity.familyKey}`,
         className: "flex items-center justify-center py-8",
-        children: /* @__PURE__ */ jsx28(
+        children: /* @__PURE__ */ jsx29(
           "button",
           {
             onClick: () => onSelectScene?.(),
@@ -8349,12 +8564,12 @@ function GeneratorPanelShell({ core, slots }) {
     );
   }
   if (!sceneContext?.hasContract) {
-    return /* @__PURE__ */ jsx28(
+    return /* @__PURE__ */ jsx29(
       "div",
       {
         "data-testid": `no-contract-placeholder-${identity.familyKey}`,
         className: "flex items-center justify-center py-8",
-        children: /* @__PURE__ */ jsx28(
+        children: /* @__PURE__ */ jsx29(
           "button",
           {
             onClick: () => onOpenContract?.(),
@@ -8366,7 +8581,7 @@ function GeneratorPanelShell({ core, slots }) {
     );
   }
   if (features.bulkComposePlaceholders && isComposing) {
-    return /* @__PURE__ */ jsx28("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2", children: /* @__PURE__ */ jsx28(SorceryProgressBar, { isLoading: true, statusText: "COMPOSING...", heightClass: "h-10" }) });
+    return /* @__PURE__ */ jsx29("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2", children: /* @__PURE__ */ jsx29(SorceryProgressBar, { isLoading: true, statusText: "COMPOSING...", heightClass: "h-10" }) });
   }
   const activePlaceholders = features.bulkComposePlaceholders ? placeholders : [];
   if (activePlaceholders.length > 0) {
@@ -8377,18 +8592,18 @@ function GeneratorPanelShell({ core, slots }) {
         tracksByDbId.set(t.handle.id, t);
       }
     }
-    return /* @__PURE__ */ jsx28("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2 space-y-2", children: activePlaceholders.map((ph) => {
+    return /* @__PURE__ */ jsx29("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2 space-y-2", children: activePlaceholders.map((ph) => {
       const loadedTrack = ph.status === "completed" ? tracksByDbId.get(ph.id) : void 0;
       if (loadedTrack) {
-        return /* @__PURE__ */ jsx28(TrackRow, { ...buildRowProps(loadedTrack) }, ph.id);
+        return /* @__PURE__ */ jsx29(TrackRow, { ...buildRowProps(loadedTrack) }, ph.id);
       }
-      return /* @__PURE__ */ jsx28(
+      return /* @__PURE__ */ jsx29(
         "div",
         {
           "data-testid": "bulk-placeholder-track",
           className: "relative rounded-sm border w-full overflow-hidden border-sas-border bg-sas-panel-alt",
           style: { borderLeftColor: identity.placeholderAccentColor, borderLeftWidth: "3px" },
-          children: /* @__PURE__ */ jsx28(SorceryProgressBar, { isLoading: true, statusText: "CONJURING MIDI...", heightClass: "h-10" })
+          children: /* @__PURE__ */ jsx29(SorceryProgressBar, { isLoading: true, statusText: "CONJURING MIDI...", heightClass: "h-10" })
         },
         ph.id
       );
@@ -8400,13 +8615,13 @@ function GeneratorPanelShell({ core, slots }) {
     supportsMeters,
     levels: supportsMeters ? trackLevels : void 0,
     handlers,
-    renderDefaultTrackRow: (track, overrides, drag) => /* @__PURE__ */ jsx28(TrackRow, { ...{ ...buildRowProps(track, drag), ...overrides ?? {} } }, track.handle.id),
+    renderDefaultTrackRow: (track, overrides, drag) => /* @__PURE__ */ jsx29(TrackRow, { ...{ ...buildRowProps(track, drag), ...overrides ?? {} } }, track.handle.id),
     setGroupMute,
     setGroupSolo,
     deleteGroup
   };
   return /* @__PURE__ */ jsxs22("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2 space-y-2", children: [
-    features.importTracks && host.listImportableTracks && /* @__PURE__ */ jsx28(
+    features.importTracks && host.listImportableTracks && /* @__PURE__ */ jsx29(
       ImportTrackModal,
       {
         host,
@@ -8419,7 +8634,7 @@ function GeneratorPanelShell({ core, slots }) {
         testIdPrefix: `${identity.familyKey}-import`
       }
     ),
-    features.importTracks && host.listImportableTracks && host.getTrackSound && /* @__PURE__ */ jsx28(
+    features.importTracks && host.listImportableTracks && host.getTrackSound && /* @__PURE__ */ jsx29(
       ImportTrackModal,
       {
         host,
@@ -8434,7 +8649,7 @@ function GeneratorPanelShell({ core, slots }) {
       }
     ),
     slots?.modals,
-    canCrossfade && xfFromId && xfToId && /* @__PURE__ */ jsx28("div", { className: designerView ? "contents" : "hidden", children: /* @__PURE__ */ jsx28(
+    canCrossfade && xfFromId && xfToId && /* @__PURE__ */ jsx29("div", { className: designerView ? "contents" : "hidden", children: /* @__PURE__ */ jsx29(
       TransitionDesigner,
       {
         host,
@@ -8453,8 +8668,8 @@ function GeneratorPanelShell({ core, slots }) {
         testIdPrefix: `${identity.familyKey}-transition-designer`
       }
     ) }),
-    !(designerView && canCrossfade) && (isLoadingTracks ? /* @__PURE__ */ jsx28("div", { className: "text-sas-muted text-xs text-center py-4", children: "Loading tracks..." }) : /* @__PURE__ */ jsxs22(Fragment7, { children: [
-      panelBus.supported && panelBus.bus && /* @__PURE__ */ jsx28(
+    !(designerView && canCrossfade) && (isLoadingTracks ? /* @__PURE__ */ jsx29("div", { className: "text-sas-muted text-xs text-center py-4", children: "Loading tracks..." }) : /* @__PURE__ */ jsxs22(Fragment7, { children: [
+      panelBus.supported && panelBus.bus && /* @__PURE__ */ jsx29(
         PanelMasterStrip,
         {
           bus: panelBus.bus,
@@ -8475,7 +8690,7 @@ function GeneratorPanelShell({ core, slots }) {
         }
       ),
       slots?.beforeRows,
-      resolvedCrossfadePairs.map((pair) => /* @__PURE__ */ jsx28(
+      resolvedCrossfadePairs.map((pair) => /* @__PURE__ */ jsx29(
         CrossfadeTrackRow,
         {
           accentColor: identity.transitionAccentColor,
@@ -8512,7 +8727,7 @@ function GeneratorPanelShell({ core, slots }) {
         },
         pair.groupId
       )),
-      resolvedSingleFades.map((fade) => /* @__PURE__ */ jsx28(
+      resolvedSingleFades.map((fade) => /* @__PURE__ */ jsx29(
         FadeTrackRow,
         {
           accentColor: identity.transitionAccentColor,
@@ -8537,7 +8752,7 @@ function GeneratorPanelShell({ core, slots }) {
         },
         fade.dbId
       )),
-      resolvedGroupFades.map((group) => /* @__PURE__ */ jsx28(
+      resolvedGroupFades.map((group) => /* @__PURE__ */ jsx29(
         GroupFadeTrackRow,
         {
           accentColor: identity.transitionAccentColor,
@@ -8573,20 +8788,28 @@ function GeneratorPanelShell({ core, slots }) {
         group.groupId
       )),
       (adapter.groupExtensions ?? []).flatMap(
-        (ext) => (resolvedGenericGroups[ext.metaKey]?.resolved ?? []).filter((group) => !group.members.every((m) => fadeMemberDbIds.has(m.dbId))).map((group) => /* @__PURE__ */ jsx28(React23.Fragment, { children: ext.renderGroup(group, groupCtx) }, `${ext.metaKey}:${group.groupId}`))
+        (ext) => (resolvedGenericGroups[ext.metaKey]?.resolved ?? []).filter((group) => !group.members.every((m) => fadeMemberDbIds.has(m.dbId))).map((group) => /* @__PURE__ */ jsx29(
+          CollapsibleGroup,
+          {
+            ext,
+            group,
+            groupCtx
+          },
+          `${ext.metaKey}:${group.groupId}`
+        ))
       ),
       tracks.map((track, index) => {
         if (crossfadeMemberDbIds.has(track.handle.dbId) || fadeMemberDbIds.has(track.handle.dbId) || genericGroupMemberDbIds.has(track.handle.dbId)) {
           return null;
         }
-        return /* @__PURE__ */ jsx28(TrackRow, { ...buildRowProps(track, reorder.dragPropsFor(index)) }, track.handle.id);
+        return /* @__PURE__ */ jsx29(TrackRow, { ...buildRowProps(track, reorder.dragPropsFor(index)) }, track.handle.id);
       }),
       slots?.afterRows
     ] })),
     features.exportMidi && !designerView && !isLoadingTracks && tracks.length > 0 && (() => {
       const hasAnyMidi = tracks.some((t) => t.hasMidi);
       const exportDisabled = isExportingMidi || !hasAnyMidi;
-      return /* @__PURE__ */ jsx28("div", { className: "pt-2", children: /* @__PURE__ */ jsx28(
+      return /* @__PURE__ */ jsx29("div", { className: "pt-2", children: /* @__PURE__ */ jsx29(
         "button",
         {
           "data-testid": "export-midi-tracks-button",
@@ -8641,6 +8864,15 @@ function createSurgeSoundAdapter(host, overrides = {}) {
       });
       return snap.label;
     },
+    persistDescriptor: async (trackId, descriptor, label) => {
+      const { state, stateType } = descriptor;
+      await host.persistTrackPresetState?.(trackId, {
+        state,
+        stateType: stateType ?? "valuetree",
+        name: label
+      }).catch(() => {
+      });
+    },
     descriptorFromSnapshot: (snap) => {
       const preset = snap;
       return { state: preset.state, stateType: preset.stateType };
@@ -8725,18 +8957,183 @@ var SUB = {
   rootOnly: true,
   monoPreference: "low"
 };
+var HORN_MAX_NOTES_PER_BAR = 12;
+var HORN_FOLLOW_PALETTE = "EXACTLY the lead voice's rhythm \u2014 every attack lands together with voice 1";
+var HORN_LEAD = {
+  label: "lead trumpet",
+  role: "brass",
+  registerLow: 60,
+  // C4
+  registerHigh: 84,
+  // C6
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: "tight funk syncopation \u2014 8ths and 16ths, staccato punches, off-beat anticipations",
+  harmonicDiscipline: "the section's melodic top \u2014 chord tones on every hit; quick chromatic approach tones only on pickups",
+  monoPreference: "high"
+};
+var HORN_TRUMPET_2 = {
+  label: "second trumpet",
+  role: "brass",
+  registerLow: 55,
+  // G3
+  registerHigh: 79,
+  // G5
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: HORN_FOLLOW_PALETTE,
+  harmonicDiscipline: "nearest chord tone directly below voice 1 \u2014 tight close voicing",
+  monoPreference: "high"
+};
+var HORN_ALTO = {
+  label: "alto sax",
+  role: "brass",
+  registerLow: 53,
+  // F3
+  registerHigh: 77,
+  // F5
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: HORN_FOLLOW_PALETTE,
+  harmonicDiscipline: "chord tone below the trumpets \u2014 keep the upper stack inside one octave",
+  monoPreference: "high"
+};
+var HORN_TENOR = {
+  label: "tenor sax",
+  role: "brass",
+  registerLow: 46,
+  // Bb2
+  registerHigh: 72,
+  // C5
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: HORN_FOLLOW_PALETTE,
+  harmonicDiscipline: "chord tone under the upper horns \u2014 complete the chord",
+  monoPreference: "low"
+};
+var HORN_TROMBONE = {
+  label: "trombone",
+  role: "brass",
+  registerLow: 43,
+  // G2
+  registerHigh: 67,
+  // G4
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: HORN_FOLLOW_PALETTE,
+  harmonicDiscipline: "chord tone or root below the saxes \u2014 weight in the middle-low stack",
+  monoPreference: "low"
+};
+var HORN_BARI = {
+  label: "baritone sax",
+  role: "brass",
+  registerLow: 36,
+  // C2
+  registerHigh: 60,
+  // C4
+  maxNotesPerBar: HORN_MAX_NOTES_PER_BAR,
+  rhythmPalette: HORN_FOLLOW_PALETTE,
+  harmonicDiscipline: "chord roots and lower chord tones \u2014 the section's bottom anchor",
+  monoPreference: "low"
+};
+var WIND_FLUTE = {
+  label: "flute",
+  role: "winds",
+  registerLow: 60,
+  // C4
+  registerHigh: 93,
+  // A6
+  maxNotesPerBar: 8,
+  rhythmPalette: "8ths and 16ths; runs, turns and trills welcome",
+  harmonicDiscipline: "freest voice \u2014 non-chord tones as passing/neighbor tones on weak beats, resolving by step",
+  monoPreference: "high"
+};
+var WIND_FLUTE_2 = {
+  label: "second flute",
+  role: "winds",
+  registerLow: 60,
+  // C4
+  registerHigh: 86,
+  // D6
+  maxNotesPerBar: 5,
+  rhythmPalette: "quarters with occasional 8th-note motion",
+  harmonicDiscipline: "chord tones; fill gaps the other inner voices leave",
+  monoPreference: "high"
+};
+var WIND_OBOE = {
+  label: "oboe",
+  role: "winds",
+  registerLow: 58,
+  // Bb3
+  registerHigh: 84,
+  // C6
+  maxNotesPerBar: 6,
+  rhythmPalette: "8ths and quarters; move when the flute rests",
+  harmonicDiscipline: "mostly chord tones; may imitate the flute's motifs a bar later",
+  monoPreference: "high"
+};
+var WIND_CLARINET = {
+  label: "clarinet",
+  role: "winds",
+  registerLow: 50,
+  // D3
+  registerHigh: 81,
+  // A5
+  maxNotesPerBar: 4,
+  rhythmPalette: "quarters and halves",
+  harmonicDiscipline: "chord tones with smooth stepwise motion between them",
+  monoPreference: "high"
+};
+var WIND_FRENCH_HORN = {
+  label: "french horn",
+  role: "winds",
+  registerLow: 41,
+  // F2
+  registerHigh: 72,
+  // C5
+  maxNotesPerBar: 4,
+  rhythmPalette: "quarters and halves; long held tones welcome",
+  harmonicDiscipline: "chord tones \u2014 the warm glue in the middle of the ensemble",
+  monoPreference: "low"
+};
+var WIND_BASSOON = {
+  label: "bassoon",
+  role: "winds",
+  registerLow: 34,
+  // Bb1
+  registerHigh: 62,
+  // D4
+  maxNotesPerBar: 3,
+  rhythmPalette: "quarters and halves; brief walking figures at cadences",
+  harmonicDiscipline: "roots and fifths emphasized; passing tones only between chord tones",
+  monoPreference: "low"
+};
 var ENSEMBLE_MIN_VOICES = 2;
 var ENSEMBLE_MAX_VOICES = 6;
-var SPEC_TABLES = {
+var STRINGS_SPEC_TABLES = {
   2: [TOP, BASS],
   3: [TOP, INNER, BASS],
   4: [TOP, COUNTER, TENOR, BASS],
   5: [TOP, COUNTER, INNER, TENOR, SUB],
   6: [TOP, COUNTER, INNER_2, INNER, TENOR, SUB]
 };
-function defaultVoiceSpecs(voiceCount) {
+var HORNS_SPEC_TABLES = {
+  2: [HORN_LEAD, HORN_TENOR],
+  3: [HORN_LEAD, HORN_TENOR, HORN_BARI],
+  4: [HORN_LEAD, HORN_TRUMPET_2, HORN_TENOR, HORN_BARI],
+  5: [HORN_LEAD, HORN_TRUMPET_2, HORN_TENOR, HORN_TROMBONE, HORN_BARI],
+  6: [HORN_LEAD, HORN_TRUMPET_2, HORN_ALTO, HORN_TENOR, HORN_TROMBONE, HORN_BARI]
+};
+var WINDS_SPEC_TABLES = {
+  2: [WIND_FLUTE, WIND_BASSOON],
+  3: [WIND_FLUTE, WIND_CLARINET, WIND_BASSOON],
+  4: [WIND_FLUTE, WIND_OBOE, WIND_FRENCH_HORN, WIND_BASSOON],
+  5: [WIND_FLUTE, WIND_OBOE, WIND_CLARINET, WIND_FRENCH_HORN, WIND_BASSOON],
+  6: [WIND_FLUTE, WIND_FLUTE_2, WIND_OBOE, WIND_CLARINET, WIND_FRENCH_HORN, WIND_BASSOON]
+};
+var SPEC_TABLES_BY_INSTRUMENTATION = {
+  strings: STRINGS_SPEC_TABLES,
+  horns: HORNS_SPEC_TABLES,
+  winds: WINDS_SPEC_TABLES
+};
+function defaultVoiceSpecs(voiceCount, instrumentation = "strings") {
   const n = Math.max(ENSEMBLE_MIN_VOICES, Math.min(ENSEMBLE_MAX_VOICES, Math.round(voiceCount)));
-  return SPEC_TABLES[n].map((spec, voiceIndex) => ({ ...spec, voiceIndex }));
+  return SPEC_TABLES_BY_INSTRUMENTATION[instrumentation][n].map((spec, voiceIndex) => ({ ...spec, voiceIndex }));
 }
 
 // src/ensemble-core/enforce-voice.ts
@@ -8776,10 +9173,14 @@ function enforceVoice(rawNotes, spec, opts) {
       repairs.push(`voice ${spec.voiceIndex}: dropped note outside the ${opts.bars}-bar clip (start ${n.startBeat})`);
       continue;
     }
-    const durationBeats = Math.max(
+    let durationBeats = Math.max(
       MIN_NOTE_DURATION_BEATS,
       Math.min(n.durationBeats, clipEnd - n.startBeat)
     );
+    if (opts.maxNoteDurationBeats !== void 0 && durationBeats > opts.maxNoteDurationBeats) {
+      durationBeats = Math.max(MIN_NOTE_DURATION_BEATS, opts.maxNoteDurationBeats);
+      repairs.push(`voice ${spec.voiceIndex}: trimmed note at beat ${n.startBeat} to the style's ${opts.maxNoteDurationBeats}-beat stab ceiling`);
+    }
     notes.push({ ...n, durationBeats });
   }
   notes = notes.map((n) => {
@@ -8940,12 +9341,19 @@ function describeViolations(analysis, rules) {
     if (pair.onsetIndependence < rules.minOnsetIndependence) {
       out.push(`Voices ${pair.upperVoice + 1} and ${pair.upperVoice + 2} attack together too often (independence ${pair.onsetIndependence.toFixed(2)} < ${rules.minOnsetIndependence}) \u2014 stagger entrances and let one voice move while the other holds.`);
     }
+    if (rules.maxOnsetIndependence !== void 0 && pair.onsetIndependence > rules.maxOnsetIndependence) {
+      out.push(`Voices ${pair.upperVoice + 1} and ${pair.upperVoice + 2} don't attack together enough (independence ${pair.onsetIndependence.toFixed(2)} > ${rules.maxOnsetIndependence}) \u2014 this is a section: give every voice the SAME rhythm as the lead so the hits land as one.`);
+    }
   }
   return out;
 }
 
 // src/ensemble-core/styles.ts
 var ENSEMBLE_STYLES = ["counterpoint", "chorale", "interlock"];
+var STAB_MAX_ONSET_INDEPENDENCE = 0.25;
+var RIFF_MAX_ONSET_INDEPENDENCE = 0.3;
+var UNISON_MAX_ONSET_INDEPENDENCE = 0.15;
+var STAB_MAX_NOTE_DURATION_BEATS = 1;
 var STYLE_RULES = {
   counterpoint: {
     forbidParallelPerfects: true,
@@ -8964,9 +9372,55 @@ var STYLE_RULES = {
     forbidVoiceCrossing: false,
     minOnsetIndependence: 0.6,
     promptParagraph: "STYLE \u2014 INTERLOCK (minimal / systems music): short repeating cells that mesh like gears. Each voice keeps its own ostinato; onsets rarely coincide with the neighboring voice; parallel motion and doubling are welcome when the composite rhythm stays busy and even."
+  },
+  stabs: {
+    forbidParallelPerfects: false,
+    forbidVoiceCrossing: true,
+    minOnsetIndependence: 0,
+    maxOnsetIndependence: STAB_MAX_ONSET_INDEPENDENCE,
+    maxNoteDurationBeats: STAB_MAX_NOTE_DURATION_BEATS,
+    promptParagraph: `STYLE \u2014 STABS (James Brown funk-45 horn punches): short accented chord hits \u2014 single punches and two-to-four-note kicks \u2014 placed on the groove's pressure points: the one, off-beat "ands", and the pickup into the next bar. Every hit is staccato (a 16th to an 8th long) and voiced as ONE tight chord under the lead. Leave REAL space between hits \u2014 the section punctuates the groove, it never carpets it.`
+  },
+  riffs: {
+    forbidParallelPerfects: false,
+    forbidVoiceCrossing: true,
+    minOnsetIndependence: 0,
+    maxOnsetIndependence: RIFF_MAX_ONSET_INDEPENDENCE,
+    promptParagraph: 'STYLE \u2014 RIFFS (funk/soul section soli): ONE syncopated 8th/16th riff, one or two bars long, repeated with small variations for the whole clip \u2014 the entire section plays it together, harmonized in tight close voicings under the lead. Anticipate downbeats (attack the "and" just before the barline), leave air at phrase ends, and let the final hit of a phrase ring a little longer.'
+  },
+  unison: {
+    forbidParallelPerfects: false,
+    forbidVoiceCrossing: false,
+    minOnsetIndependence: 0,
+    maxOnsetIndependence: UNISON_MAX_ONSET_INDEPENDENCE,
+    promptParagraph: "STYLE \u2014 UNISON (the Cold Sweat power line): every voice doubles the SAME riff in octaves \u2014 no harmony, one line, maximum punch. Keep it syncopated and riff-based with space between phrases; octave doubling and parallel motion are the entire point."
   }
 };
 
+// src/ensemble-core/instrumentation.ts
+var ENSEMBLE_INSTRUMENTATIONS = [
+  "strings",
+  "horns",
+  "winds"
+];
+var STYLES_FOR_INSTRUMENTATION = {
+  strings: ["counterpoint", "chorale", "interlock"],
+  horns: ["stabs", "riffs", "unison"],
+  winds: ["counterpoint", "chorale", "interlock"]
+};
+var DEFAULT_STYLE_FOR_INSTRUMENTATION = {
+  strings: "counterpoint",
+  horns: "stabs",
+  winds: "chorale"
+};
+function normalizeInstrumentation(raw) {
+  return ENSEMBLE_INSTRUMENTATIONS.includes(raw) ? raw : "strings";
+}
+function styleForInstrumentation(instrumentation, rawStyle) {
+  const allowed = STYLES_FOR_INSTRUMENTATION[instrumentation];
+  return allowed.includes(rawStyle ?? "") ? rawStyle : DEFAULT_STYLE_FOR_INSTRUMENTATION[instrumentation];
+}
+
 // src/ensemble-core/ensemble-schema.ts
 var SUBMIT_ENSEMBLE_TOOL_NAME = "submit_ensemble";
 function buildSubmitEnsembleParameters(voiceCount) {
@@ -9048,9 +9502,13 @@ function voiceContractLine(spec) {
   const root = spec.rootOnly ? " ROOT PITCH CLASS ONLY (each bar's chord root)." : "";
   return `- Voice ${spec.voiceIndex + 1} (${spec.label}): MIDI ${spec.registerLow}-${spec.registerHigh}, max ${spec.maxNotesPerBar} notes/bar, rhythm: ${spec.rhythmPalette}. ${spec.harmonicDiscipline}.${root}`;
 }
-function buildEnsembleSystemPrompt(specs, style) {
+var WOVEN_PERSONA = {
+  strings: "You are an ensemble composer.",
+  winds: "You are a wind-ensemble composer writing for chamber winds (flutes, oboe, clarinet, french horn, bassoon)."
+};
+function buildWovenPrompt(specs, style, instrumentation) {
   const styleParagraph = STYLE_RULES[style].promptParagraph;
-  return `You are an ensemble composer. Compose ${specs.length} voices as ONE piece of music \u2014 not ${specs.length} independent parts.
+  return `${WOVEN_PERSONA[instrumentation]} Compose ${specs.length} voices as ONE piece of music \u2014 not ${specs.length} independent parts.
 
 Submit your composition by calling the ${SUBMIT_ENSEMBLE_TOOL_NAME} tool with all ${specs.length} voices.
 
@@ -9067,6 +9525,28 @@ ${styleParagraph}
 PER-VOICE CONTRACTS:
 ${specs.map(voiceContractLine).join("\n")}`;
 }
+function buildSectionPrompt(specs, style) {
+  const styleParagraph = STYLE_RULES[style].promptParagraph;
+  return `You are a funk horn-section arranger. Compose ${specs.length} horn parts as ONE section \u2014 ${specs.length} players phrasing like a single instrument, not ${specs.length} independent parts.
+
+Submit your composition by calling the ${SUBMIT_ENSEMBLE_TOOL_NAME} tool with all ${specs.length} voices.
+
+THE SECTION RULES (most important):
+1. The section speaks with ONE rhythm: every voice attacks on the same beats as Voice 1 (the lead). Compose the lead line first, then stack the other voices onto its rhythm exactly \u2014 the style below dictates chord voicing vs octave doubling.
+2. Each voice is a SINGLE monophonic line \u2014 within one voice, no two notes overlap in time and no chords. The chord is the STACK of voices hitting together.
+3. SPACE IS THE GROOVE: short phrases and punches separated by real rests. Never carpet the bar \u2014 the section punctuates around the rhythm section, and the silence between hits is part of the riff.
+4. Follow the chord progression in the musical context exactly \u2014 every hit is voiced from the chord sounding at that beat.
+5. Make it DANCE: this is funk. Syncopate, anticipate downbeats (attack the "and" just before the barline), and accent with velocity \u2014 105-120 on accented hits, 70-90 on lighter punches. Repeat the riff so the clip locks like a loop.
+6. startBeat/durationBeats are in quarter-note beats from the start of the clip; respect each voice's register window and notes-per-bar cap exactly; fill the stated bar length and land the first hit in bar 1 (no long silent intro).
+
+${styleParagraph}
+
+PER-VOICE CONTRACTS:
+${specs.map(voiceContractLine).join("\n")}`;
+}
+function buildEnsembleSystemPrompt(specs, style, instrumentation = "strings") {
+  return instrumentation === "horns" ? buildSectionPrompt(specs, style) : buildWovenPrompt(specs, style, instrumentation);
+}
 function buildViolationRetrySuffix(violations) {
   if (violations.length === 0) return "";
   return `
@@ -9241,10 +9721,12 @@ export {
   DB_MIN,
   DEFAULT_FX_CATEGORY_DETAIL,
   DEFAULT_FX_DRY_WET,
+  DEFAULT_STYLE_FOR_INSTRUMENTATION,
   DRAG_DEAD_ZONE,
   DownloadPackButton,
   EMPTY_FX_DETAIL_STATE,
   EMPTY_FX_STATE,
+  ENSEMBLE_INSTRUMENTATIONS,
   ENSEMBLE_MAX_VOICES,
   ENSEMBLE_MIN_VOICES,
   ENSEMBLE_STYLES,
@@ -9259,7 +9741,9 @@ export {
   FxToggleBar,
   GUTTER_W,
   GeneratorPanelShell,
+  GroupCollapseChevron,
   GroupFadeTrackRow,
+  HORN_MAX_NOTES_PER_BAR,
   ImportTrackModal,
   TrackDrawer as InstrumentDrawer,
   LevelMeter,
@@ -9273,8 +9757,12 @@ export {
   PianoRollEditor,
   PluginError,
   RESIZE_HANDLE_PX,
+  RIFF_MAX_ONSET_INDEPENDENCE,
   ROW_HEIGHT,
   SLIDER_UNITY,
+  STAB_MAX_NOTE_DURATION_BEATS,
+  STAB_MAX_ONSET_INDEPENDENCE,
+  STYLES_FOR_INSTRUMENTATION,
   STYLE_RULES,
   SUBMIT_ENSEMBLE_TOOL_NAME,
   SamplePackCTACard,
@@ -9288,6 +9776,7 @@ export {
   TrackMeterStrip,
   TrackRow,
   TransitionDesigner,
+  UNISON_MAX_ONSET_INDEPENDENCE,
   VolumeSlider,
   WaveformView,
   analyzeEnsemble,
@@ -9322,6 +9811,7 @@ export {
   moveItem,
   nearestPitchWithPc,
   newTrackState,
+  normalizeInstrumentation,
   normalizeSlots,
   padPair,
   padSlots,
@@ -9345,6 +9835,7 @@ export {
   slotsEqual,
   soundIdentity,
   splitFadeEntries,
+  styleForInstrumentation,
   synthesizeCuePoints,
   tokenizePrompt,
   trackDataKey,