@signalsandsorcery/plugin-sdk 2.40.1 → 2.40.2

package/dist/index.d.mts

@@ -2961,6 +2961,15 @@ interface SDKTrackRowProps {
      * a title suffix. Undefined (all single-track panels) renders nothing.
      */
     linkedSoundHint?: string;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): presence renders a "→ All"
+     * button next to Shuffle that pushes THIS row's current sound to every
+     * linked sibling. The affordance for patch changes made inside a custom
+     * plugin's own editor (Kontakt / Diva…), which fire no change event —
+     * and the only sound-propagation control that works on such tracks,
+     * since Shuffle is Surge-only.
+     */
+    onSyncSoundToGroup?: () => void;
     /** Current MIDI notes for the piano-roll editor (the 'edit' tab). */
     editNotes?: readonly PluginMidiNote[];
     /** Persist edited notes; PRESENCE of this callback enables the Edit tab. */
@@ -2980,7 +2989,7 @@ interface SDKTrackRowProps {
      *  a thin peak meter welds to the bottom of the row. Omit to hide it. */
     levels?: TrackLevelsHandle;
 }
-declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, linkedSoundHint, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
+declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, linkedSoundHint, onSyncSoundToGroup, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
 
 /**
  * Crossfade-pair metadata — family-agnostic types + parsing shared by every
@@ -5053,6 +5062,12 @@ interface CoreTrackHandlers {
     promptChange(trackId: string, prompt: string): void;
     generate(trackId: string): void;
     shuffle(trackId: string): void;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): broadcast the track's CURRENT
+     * sound to its linked siblings — the affordance for patch changes made
+     * inside a plugin's own editor (no change event to hook).
+     */
+    syncSoundToGroup(trackId: string): void;
     copy(trackId: string): void;
     delete(trackId: string): void;
     muteToggle(trackId: string): void;
@@ -5383,6 +5398,12 @@ interface GeneratorPanelCore {
      * soundHistory.restoreTo for panels without broadcastTargets.
      */
     handleRestoreSound(trackId: string, index: number): Promise<void>;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): capture the track's CURRENT
+     * sound and broadcast it to its linked siblings — for edits made inside a
+     * plugin's own editor, which fire no change event.
+     */
+    handleSyncSoundToGroup(trackId: string): Promise<void>;
     handleAddTrack(): Promise<void>;
     handleDeleteTrack(trackId: string): Promise<void>;
     handleExportMidi(): Promise<void>;

package/dist/index.d.ts

@@ -2961,6 +2961,15 @@ interface SDKTrackRowProps {
      * a title suffix. Undefined (all single-track panels) renders nothing.
      */
     linkedSoundHint?: string;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): presence renders a "→ All"
+     * button next to Shuffle that pushes THIS row's current sound to every
+     * linked sibling. The affordance for patch changes made inside a custom
+     * plugin's own editor (Kontakt / Diva…), which fire no change event —
+     * and the only sound-propagation control that works on such tracks,
+     * since Shuffle is Surge-only.
+     */
+    onSyncSoundToGroup?: () => void;
     /** Current MIDI notes for the piano-roll editor (the 'edit' tab). */
     editNotes?: readonly PluginMidiNote[];
     /** Persist edited notes; PRESENCE of this callback enables the Edit tab. */
@@ -2980,7 +2989,7 @@ interface SDKTrackRowProps {
      *  a thin peak meter welds to the bottom of the row. Omit to hide it. */
     levels?: TrackLevelsHandle;
 }
-declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, linkedSoundHint, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
+declare function TrackRow({ track, prompt, runtimeState, soloedOut, fxDetailState, drawerOpen, drawerTab, onTabChange, isGenerating, isAuthenticated, error, hasMidi, generationProgress, estimatedGenerationMs, onPromptChange, onGenerate, onShuffle, onCopy, onDelete, contentSlot, onMuteToggle, onSoloToggle, onVolumeChange, onPanChange, onFxToggle, onFxPresetChange, onFxDryWetChange, externalFxHost, onToggleFxDrawer, onProgressChange, accentColor, instrumentName, instrumentMissing, onToggleDrawer, availableInstruments, currentInstrumentPluginId, onInstrumentSelect, instrumentsLoading, onRefreshInstruments, editorStage, onShowEditor, onBackToInstruments, soundHistory, soundHistoryCursor, onRestoreSound, onToggleFavorite, onImportSound, importSoundLabel, linkedSoundHint, onSyncSoundToGroup, editNotes, onNotesChange, editBars, editBpm, editSnap, onAuditionNote, drag, levels, }: SDKTrackRowProps): React$1.ReactElement;
 
 /**
  * Crossfade-pair metadata — family-agnostic types + parsing shared by every
@@ -5053,6 +5062,12 @@ interface CoreTrackHandlers {
     promptChange(trackId: string, prompt: string): void;
     generate(trackId: string): void;
     shuffle(trackId: string): void;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): broadcast the track's CURRENT
+     * sound to its linked siblings — the affordance for patch changes made
+     * inside a plugin's own editor (no change event to hook).
+     */
+    syncSoundToGroup(trackId: string): void;
     copy(trackId: string): void;
     delete(trackId: string): void;
     muteToggle(trackId: string): void;
@@ -5383,6 +5398,12 @@ interface GeneratorPanelCore {
      * soundHistory.restoreTo for panels without broadcastTargets.
      */
     handleRestoreSound(trackId: string, index: number): Promise<void>;
+    /**
+     * One-shot linked sync (@since SDK 2.48.0): capture the track's CURRENT
+     * sound and broadcast it to its linked siblings — for edits made inside a
+     * plugin's own editor, which fire no change event.
+     */
+    handleSyncSoundToGroup(trackId: string): Promise<void>;
     handleAddTrack(): Promise<void>;
     handleDeleteTrack(trackId: string): Promise<void>;
     handleExportMidi(): Promise<void>;

package/dist/index.js

@@ -2700,6 +2700,7 @@ function TrackRow({
   onImportSound,
   importSoundLabel,
   linkedSoundHint,
+  onSyncSoundToGroup,
   editNotes,
   onNotesChange,
   editBars,
@@ -2887,6 +2888,17 @@ function TrackRow({
                   ]
                 }
               ),
+              onSyncSoundToGroup && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+                "button",
+                {
+                  "data-testid": "sdk-sync-sound-button",
+                  onClick: onSyncSoundToGroup,
+                  disabled: isGenerating,
+                  className: `px-1.5 py-0.5 rounded-sm text-xs font-medium transition-colors border whitespace-nowrap ${isGenerating ? "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: "Apply THIS part's current sound to all linked parts \u2014 use after picking a patch inside the plugin's own editor",
+                  children: "\u2192 All"
+                }
+              ),
               freezeBadge && /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
                 "span",
                 {
@@ -7882,6 +7894,26 @@ function useGeneratorPanelCore({
     },
     [adapter, makeServices, host, logTag]
   );
+  const handleSyncSoundToGroup = (0, import_react31.useCallback)(
+    async (trackId) => {
+      const track = tracksRef.current.find((t) => t.handle.id === trackId);
+      if (!track) return;
+      let cap = null;
+      try {
+        cap = await adapter.sound.captureSoundDescriptor(trackId);
+      } catch {
+        cap = null;
+      }
+      if (!cap) {
+        host.showToast("warning", "Nothing to sync", "This track has no sound to copy yet.");
+        return;
+      }
+      const hist = soundHistory.list(trackId);
+      const label = (hist.cursor >= 0 ? hist.entries[hist.cursor]?.label : void 0) ?? track.instrumentName ?? "Current sound";
+      await broadcastSoundFromTrack(trackId, cap.descriptor, label);
+    },
+    [adapter, soundHistory, host, broadcastSoundFromTrack]
+  );
   const handleRestoreSound = (0, import_react31.useCallback)(
     async (trackId, index) => {
       const entry = soundHistory.list(trackId).entries[index];
@@ -8423,6 +8455,9 @@ function useGeneratorPanelCore({
       shuffle: (trackId) => {
         void handleShuffle(trackId);
       },
+      syncSoundToGroup: (trackId) => {
+        void handleSyncSoundToGroup(trackId);
+      },
       copy: (trackId) => {
         void handleCopy(trackId);
       },
@@ -8443,6 +8478,7 @@ function useGeneratorPanelCore({
       handlePromptChange,
       handleGenerate,
       handleShuffle,
+      handleSyncSoundToGroup,
       handleCopy,
       handleDeleteTrack,
       handleMuteToggle,
@@ -8501,6 +8537,7 @@ function useGeneratorPanelCore({
     handleGenerate,
     handleShuffle,
     handleRestoreSound,
+    handleSyncSoundToGroup,
     handleAddTrack,
     handleDeleteTrack,
     handleExportMidi,