@signalsandsorcery/plugin-sdk 2.34.1 → 2.35.1

package/dist/index.js

@@ -53,6 +53,7 @@ __export(index_exports, {
   FadeTrackRow: () => FadeTrackRow,
   FxToggleBar: () => FxToggleBar,
   GUTTER_W: () => GUTTER_W,
+  GeneratorPanelShell: () => GeneratorPanelShell,
   ImportTrackModal: () => ImportTrackModal,
   InstrumentDrawer: () => TrackDrawer,
   LevelMeter: () => LevelMeter,
@@ -90,6 +91,7 @@ __export(index_exports, {
   cellToPx: () => cellToPx,
   centerScrollTop: () => centerScrollTop,
   computePeaks: () => computePeaks,
+  createSurgeSoundAdapter: () => createSurgeSoundAdapter,
   dbIdsFromKeys: () => dbIdsFromKeys,
   dbToSlider: () => dbToSlider,
   defaultFadeGesture: () => defaultFadeGesture,
@@ -97,16 +99,21 @@ __export(index_exports, {
   formatConcurrentTracks: () => formatConcurrentTracks,
   hashString: () => hashString,
   moveItem: () => moveItem,
+  newTrackState: () => newTrackState,
   normalizeSlots: () => normalizeSlots,
   padPair: () => padPair,
   padSlots: () => padSlots,
   parseCrossfadePairs: () => parseCrossfadePairs,
   parseFades: () => parseFades,
+  parseLLMNoteResponse: () => parseLLMNoteResponse,
+  parseTrackGroups: () => parseTrackGroups,
   pickTopKWeighted: () => pickTopKWeighted,
   pitchToName: () => pitchToName,
+  pluginFxToToggleFx: () => pluginFxToToggleFx,
   pxToCell: () => pxToCell,
   reconcileSlots: () => reconcileSlots,
   resizeNoteDuration: () => resizeNoteDuration,
+  resolveTrackGroups: () => resolveTrackGroups,
   rowKey: () => rowKey,
   rowType: () => rowType,
   scorePromptMatch: () => scorePromptMatch,
@@ -115,14 +122,17 @@ __export(index_exports, {
   soundIdentity: () => soundIdentity,
   synthesizeCuePoints: () => synthesizeCuePoints,
   tokenizePrompt: () => tokenizePrompt,
+  trackDataKey: () => trackDataKey,
   transposeNotes: () => transposeNotes,
   useAnySolo: () => useAnySolo,
+  useGeneratorPanelCore: () => useGeneratorPanelCore,
   useSceneState: () => useSceneState,
   useSoundHistory: () => useSoundHistory,
   useTrackLevel: () => useTrackLevel,
   useTrackLevels: () => useTrackLevels,
   useTrackMeter: () => useTrackMeter,
   useTrackReorder: () => useTrackReorder,
+  useTransitionOps: () => useTransitionOps,
   useTransportPlaying: () => useTransportPlaying
 });
 module.exports = __toCommonJS(index_exports);
@@ -4882,6 +4892,9 @@ function synthesizeCuePoints({
   };
 }
 
+// src/panel-core/useGeneratorPanelCore.tsx
+var import_react25 = require("react");
+
 // src/hooks/useSceneState.ts
 var import_react21 = require("react");
 function useSceneState(activeSceneId, initialValue) {
@@ -5043,8 +5056,2326 @@ function useSoundHistory(applySound, opts = {}) {
   );
 }
 
+// src/panel-core/track-state.ts
+function newTrackState(handle, overrides = {}) {
+  return {
+    handle,
+    prompt: "",
+    role: "",
+    runtimeState: { id: handle.id, muted: false, solo: false, volume: 0.75, pan: 0 },
+    fxDetailState: { ...EMPTY_FX_DETAIL_STATE },
+    drawerOpen: false,
+    drawerTab: "fx",
+    editorStage: false,
+    isGenerating: false,
+    error: null,
+    hasMidi: false,
+    generationProgress: 0,
+    editNotes: [],
+    editBars: 4,
+    editBpm: 120,
+    instrumentPluginId: handle.instrumentPluginId ?? null,
+    instrumentName: handle.instrumentName ?? null,
+    instrumentMissing: false,
+    shuffleHistory: /* @__PURE__ */ new Set(),
+    ...overrides
+  };
+}
+
+// src/panel-core/panel-helpers.ts
+function trackDataKey(dbId, suffix) {
+  return `track:${dbId}:${suffix}`;
+}
+function pluginFxToToggleFx(sdkState) {
+  const result = { ...EMPTY_FX_DETAIL_STATE };
+  for (const category of ["eq", "compressor", "chorus", "phaser", "delay", "reverb"]) {
+    const sdkCat = sdkState[category];
+    if (sdkCat) {
+      result[category] = {
+        enabled: sdkCat.enabled,
+        presetIndex: sdkCat.presetIndex,
+        dryWet: sdkCat.dryWet
+      };
+    }
+  }
+  return result;
+}
+function parseLLMNoteResponse(content) {
+  try {
+    let jsonStr = content.trim();
+    const fenceMatch = jsonStr.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    if (fenceMatch) {
+      jsonStr = fenceMatch[1].trim();
+    }
+    const parsed = JSON.parse(jsonStr);
+    if (typeof parsed !== "object" || parsed === null || !("notes" in parsed)) {
+      return null;
+    }
+    const obj = parsed;
+    if (!Array.isArray(obj.notes)) {
+      return null;
+    }
+    const validNotes = [];
+    for (const raw of obj.notes) {
+      if (typeof raw !== "object" || raw === null) continue;
+      const note = raw;
+      const pitch = typeof note.pitch === "number" ? note.pitch : NaN;
+      const startBeat = typeof note.startBeat === "number" ? note.startBeat : NaN;
+      const durationBeats = typeof note.durationBeats === "number" ? note.durationBeats : NaN;
+      const velocity = typeof note.velocity === "number" ? note.velocity : NaN;
+      if (!isNaN(pitch) && pitch >= 0 && pitch <= 127 && !isNaN(startBeat) && startBeat >= 0 && !isNaN(durationBeats) && durationBeats > 0 && !isNaN(velocity) && velocity >= 1 && velocity <= 127) {
+        validNotes.push({
+          pitch: Math.round(pitch),
+          startBeat,
+          durationBeats,
+          velocity: Math.round(velocity)
+        });
+      }
+    }
+    const role = typeof obj.role === "string" ? obj.role : void 0;
+    return { notes: validNotes, role };
+  } catch {
+    return null;
+  }
+}
+
+// src/panel-core/group-meta.ts
+function parseTrackGroups(sceneData, spec) {
+  const pattern = new RegExp(`^track:(.+):${spec.metaKey}$`);
+  const groups = /* @__PURE__ */ new Map();
+  for (const [key, val] of Object.entries(sceneData)) {
+    const match = pattern.exec(key);
+    if (!match) continue;
+    const meta = spec.asMeta(val);
+    if (!meta) continue;
+    const groupId = spec.groupIdOf(meta);
+    const list = groups.get(groupId) ?? [];
+    list.push({ dbId: match[1], meta });
+    groups.set(groupId, list);
+  }
+  const out = [];
+  for (const [groupId, members] of groups) {
+    if (spec.sortMembers) members.sort(spec.sortMembers);
+    out.push({ groupId, members });
+  }
+  return out;
+}
+function resolveTrackGroups(parsedGroups, tracks, getDbId, opts = {}) {
+  const byDbId = /* @__PURE__ */ new Map();
+  for (const t of tracks) byDbId.set(getDbId(t), t);
+  const resolved = [];
+  const memberDbIds = /* @__PURE__ */ new Set();
+  const staleMemberDbIds = [];
+  for (const parsed of parsedGroups) {
+    const live = { groupId: parsed.groupId, members: [] };
+    for (const member of parsed.members) {
+      const track = byDbId.get(member.dbId);
+      if (track) live.members.push({ dbId: member.dbId, meta: member.meta, track });
+      else staleMemberDbIds.push(member.dbId);
+    }
+    if (live.members.length === 0) continue;
+    const complete = opts.isComplete ? opts.isComplete(live, parsed) : live.members.length === parsed.members.length;
+    if (!complete) continue;
+    resolved.push(live);
+    for (const m of live.members) memberDbIds.add(m.dbId);
+  }
+  return { resolved, memberDbIds, staleMemberDbIds };
+}
+
+// src/panel-core/useTransitionOps.ts
+var import_react24 = require("react");
+function useTransitionOps({
+  host,
+  adapter,
+  activeSceneId,
+  isConnected,
+  isAuthenticated,
+  sceneContext,
+  tracks,
+  setTracks,
+  loadTracks,
+  setCrossfadePairsMeta,
+  setFadesMeta,
+  resolvedCrossfadePairs,
+  resolvedFades
+}) {
+  const { identity } = adapter;
+  const appliedFadeAutomationRef = (0, import_react24.useRef)(/* @__PURE__ */ new Set());
+  const applyCrossfadeAutomation = (0, import_react24.useCallback)(
+    async (originTrackId, targetTrackId, bars, bpm, sliderPos) => {
+      if (host.setTrackVolumeAutomation) {
+        const curves = buildCrossfadeVolumeCurves(bars, bpm, sliderPos);
+        await host.setTrackVolumeAutomation(originTrackId, curves.origin).catch(() => {
+        });
+        await host.setTrackVolumeAutomation(targetTrackId, curves.target).catch(() => {
+        });
+      } else {
+        await host.setTrackVolume(originTrackId, EQUAL_POWER_GAIN).catch(() => {
+        });
+        await host.setTrackVolume(targetTrackId, EQUAL_POWER_GAIN).catch(() => {
+        });
+      }
+    },
+    [host]
+  );
+  const applyFadeAutomation = (0, import_react24.useCallback)(
+    async (trackId, direction, bars, bpm, sliderPos, gesture) => {
+      if (!host.setTrackVolumeAutomation) return;
+      const points = buildFadeVolumeCurve(bars, bpm, direction, sliderPos, gesture);
+      await host.setTrackVolumeAutomation(trackId, points).catch(() => {
+      });
+    },
+    [host]
+  );
+  const [isCreatingCrossfade, setIsCreatingCrossfade] = (0, import_react24.useState)(false);
+  const handleCreateCrossfade = (0, import_react24.useCallback)(
+    async (origin, target) => {
+      const scene = activeSceneId;
+      const fromSceneId = sceneContext?.transitionFromSceneId ?? "";
+      const toSceneId = sceneContext?.transitionToSceneId ?? "";
+      if (!scene) throw new Error("No active scene.");
+      if (!isConnected) throw new Error("Systems not connected.");
+      if (!isAuthenticated) throw new Error("Please sign in to generate the bridge.");
+      if (tracks.length + 2 > identity.maxTracks) {
+        throw new Error("Not enough track slots for a crossfade.");
+      }
+      setIsCreatingCrossfade(true);
+      const created = [];
+      try {
+        const role = target.role ?? origin.role ?? "";
+        const mc = await host.getMusicalContext();
+        const [originMidi, targetMidi, originKey, targetKey] = await Promise.all([
+          host.readImportableTrackMidi ? host.readImportableTrackMidi(origin.dbId) : Promise.resolve({ clips: [] }),
+          host.readImportableTrackMidi ? host.readImportableTrackMidi(target.dbId) : Promise.resolve({ clips: [] }),
+          host.getSceneKey ? host.getSceneKey(fromSceneId) : Promise.resolve(null),
+          host.getSceneKey ? host.getSceneKey(toSceneId) : Promise.resolve(null)
+        ]);
+        const userPrompt = buildCrossfadeInpaintPrompt({
+          role,
+          bars: mc.bars,
+          originName: origin.name,
+          targetName: target.name,
+          originKey: originKey ? `${originKey.key} ${originKey.mode}` : null,
+          targetKey: targetKey ? `${targetKey.key} ${targetKey.mode}` : null,
+          originNotes: originMidi.clips[0]?.notes ?? [],
+          targetNotes: targetMidi.clips[0]?.notes ?? []
+        });
+        const llm = await host.generateWithLLM({
+          system: adapter.buildSystemPrompt(host.getValidRoles()),
+          user: userPrompt,
+          responseFormat: "json"
+        });
+        const parsed = adapter.parseNotesResponse(llm.content);
+        if (!parsed || parsed.notes.length === 0) {
+          throw new Error("The bridge generator returned no notes.");
+        }
+        const notes = await host.postProcessMidi(parsed.notes, {
+          quantize: true,
+          removeOverlaps: true
+        });
+        const clip = {
+          startTime: 0,
+          endTime: mc.bars * 4 * 60 / mc.bpm,
+          tempo: mc.bpm,
+          notes
+        };
+        const top = await host.createTrack({
+          name: `${identity.trackNamePrefix}-${Date.now()}-xf-o`,
+          ...adapter.createTrackOptions()
+        });
+        created.push(top);
+        const bottom = await host.createTrack({
+          name: `${identity.trackNamePrefix}-${Date.now()}-xf-t`,
+          ...adapter.createTrackOptions()
+        });
+        created.push(bottom);
+        if (role) {
+          await host.setTrackRole(top.id, role).catch(() => {
+          });
+          await host.setTrackRole(bottom.id, role).catch(() => {
+          });
+        }
+        await host.writeMidiClip(top.id, clip);
+        await host.writeMidiClip(bottom.id, clip);
+        const copySound = async (newTrackId, sourceDbId) => {
+          if (!host.getTrackSound) return "default";
+          const snap = await host.getTrackSound(sourceDbId);
+          if (!snap || snap.kind !== adapter.sound.acceptedSnapshotKind) return "default";
+          return adapter.sound.copySnapshot(newTrackId, snap);
+        };
+        const originLabel = await copySound(top.id, origin.dbId);
+        const targetLabel = await copySound(bottom.id, target.dbId);
+        await applyCrossfadeAutomation(top.id, bottom.id, mc.bars, mc.bpm, 0.5);
+        const groupId = top.dbId;
+        const originMeta = {
+          groupId,
+          slot: "origin",
+          partnerDbId: bottom.dbId,
+          sourceTrackDbId: origin.dbId,
+          sourceSceneId: fromSceneId,
+          sourceName: origin.name,
+          soundLabel: originLabel,
+          sliderPos: 0.5
+        };
+        const targetMeta = {
+          groupId,
+          slot: "target",
+          partnerDbId: top.dbId,
+          sourceTrackDbId: target.dbId,
+          sourceSceneId: toSceneId,
+          sourceName: target.name,
+          soundLabel: targetLabel,
+          sliderPos: 0.5
+        };
+        await host.setSceneData(scene, `track:${top.dbId}:crossfade`, originMeta);
+        await host.setSceneData(scene, `track:${bottom.dbId}:crossfade`, targetMeta);
+        await loadTracks(true);
+        host.showToast("success", "Crossfade created", `${origin.name} \u2192 ${target.name}`);
+      } catch (err) {
+        for (const h of [...created].reverse()) {
+          try {
+            await host.deleteTrack(h.id);
+          } catch {
+          }
+        }
+        throw err instanceof Error ? err : new Error(String(err));
+      } finally {
+        setIsCreatingCrossfade(false);
+      }
+    },
+    [
+      host,
+      adapter,
+      identity,
+      activeSceneId,
+      isConnected,
+      isAuthenticated,
+      tracks.length,
+      sceneContext,
+      applyCrossfadeAutomation,
+      loadTracks
+    ]
+  );
+  const [isCreatingFade, setIsCreatingFade] = (0, import_react24.useState)(false);
+  const handleCreateFade = (0, import_react24.useCallback)(
+    async (selection, direction, gesture) => {
+      const scene = activeSceneId;
+      const fromSceneId = sceneContext?.transitionFromSceneId ?? "";
+      const toSceneId = sceneContext?.transitionToSceneId ?? "";
+      if (!scene) throw new Error("No active scene.");
+      if (!isConnected) throw new Error("Systems not connected.");
+      if (!isAuthenticated) throw new Error("Please sign in to generate the fade.");
+      if (tracks.length + 1 > identity.maxTracks) {
+        throw new Error("Not enough track slots for a fade.");
+      }
+      setIsCreatingFade(true);
+      const created = [];
+      try {
+        const role = selection.role ?? "";
+        const sourceSceneId = direction === "out" ? fromSceneId : toSceneId;
+        const mc = await host.getMusicalContext();
+        const [srcMidi, srcKey] = await Promise.all([
+          host.readImportableTrackMidi ? host.readImportableTrackMidi(selection.dbId) : Promise.resolve({ clips: [] }),
+          host.getSceneKey ? host.getSceneKey(sourceSceneId) : Promise.resolve(null)
+        ]);
+        const srcNotes = srcMidi.clips[0]?.notes ?? [];
+        const keyStr = srcKey ? `${srcKey.key} ${srcKey.mode}` : null;
+        const userPrompt = buildCrossfadeInpaintPrompt({
+          role,
+          bars: mc.bars,
+          originName: direction === "out" ? selection.name : "silence",
+          targetName: direction === "in" ? selection.name : "silence",
+          originKey: direction === "out" ? keyStr : null,
+          targetKey: direction === "in" ? keyStr : null,
+          originNotes: direction === "out" ? srcNotes : [],
+          targetNotes: direction === "in" ? srcNotes : []
+        });
+        const llm = await host.generateWithLLM({
+          system: adapter.buildSystemPrompt(host.getValidRoles()),
+          user: userPrompt,
+          responseFormat: "json"
+        });
+        const parsed = adapter.parseNotesResponse(llm.content);
+        if (!parsed || parsed.notes.length === 0) {
+          throw new Error("The fade generator returned no notes.");
+        }
+        const notes = await host.postProcessMidi(parsed.notes, {
+          quantize: true,
+          removeOverlaps: true
+        });
+        const clip = {
+          startTime: 0,
+          endTime: mc.bars * 4 * 60 / mc.bpm,
+          tempo: mc.bpm,
+          notes
+        };
+        const track = await host.createTrack({
+          name: `${identity.trackNamePrefix}-${Date.now()}-fade-${direction}`,
+          ...adapter.createTrackOptions()
+        });
+        created.push(track);
+        if (role) await host.setTrackRole(track.id, role).catch(() => {
+        });
+        await host.writeMidiClip(track.id, clip);
+        let soundLabel = "default";
+        if (host.getTrackSound) {
+          const snap = await host.getTrackSound(selection.dbId);
+          if (snap && snap.kind === adapter.sound.acceptedSnapshotKind) {
+            soundLabel = await adapter.sound.copySnapshot(track.id, snap);
+          }
+        }
+        await applyFadeAutomation(track.id, direction, mc.bars, mc.bpm, 0.5, gesture);
+        appliedFadeAutomationRef.current.add(track.id);
+        const meta = {
+          direction,
+          gesture,
+          sourceTrackDbId: selection.dbId,
+          sourceSceneId,
+          sourceName: selection.name,
+          soundLabel,
+          sliderPos: 0.5
+        };
+        await host.setSceneData(scene, `track:${track.dbId}:fade`, meta);
+        await loadTracks(true);
+        host.showToast(
+          "success",
+          direction === "in" ? "Fade in created" : "Fade out created",
+          selection.name
+        );
+      } catch (err) {
+        for (const h of [...created].reverse()) {
+          try {
+            await host.deleteTrack(h.id);
+          } catch {
+          }
+        }
+        throw err instanceof Error ? err : new Error(String(err));
+      } finally {
+        setIsCreatingFade(false);
+      }
+    },
+    [
+      host,
+      adapter,
+      identity,
+      activeSceneId,
+      isConnected,
+      isAuthenticated,
+      tracks.length,
+      sceneContext,
+      applyFadeAutomation,
+      loadTracks
+    ]
+  );
+  const handleCrossfadeMute = (0, import_react24.useCallback)(
+    (pair) => {
+      const newMuted = !pair.origin.runtimeState.muted;
+      for (const id of [pair.origin.handle.id, pair.target.handle.id]) {
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === id ? { ...t, runtimeState: { ...t.runtimeState, muted: newMuted } } : t
+          )
+        );
+        host.setTrackMute(id, newMuted).catch(() => {
+        });
+      }
+    },
+    [host, setTracks]
+  );
+  const handleCrossfadeSolo = (0, import_react24.useCallback)(
+    (pair) => {
+      const newSolo = !pair.origin.runtimeState.solo;
+      for (const id of [pair.origin.handle.id, pair.target.handle.id]) {
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === id ? { ...t, runtimeState: { ...t.runtimeState, solo: newSolo } } : t
+          )
+        );
+        host.setTrackSolo(id, newSolo).catch(() => {
+        });
+      }
+    },
+    [host, setTracks]
+  );
+  const handleCrossfadeDelete = (0, import_react24.useCallback)(
+    async (pair) => {
+      try {
+        for (const member of [pair.origin, pair.target]) {
+          await host.deleteTrack(member.handle.id);
+          if (activeSceneId) {
+            await host.deleteSceneData(activeSceneId, `track:${member.handle.dbId}:crossfade`);
+          }
+        }
+        setCrossfadePairsMeta((prev) => prev.filter((p) => p.groupId !== pair.groupId));
+        setTracks(
+          (prev) => prev.filter(
+            (t) => t.handle.id !== pair.origin.handle.id && t.handle.id !== pair.target.handle.id
+          )
+        );
+        host.showToast("success", "Crossfade removed");
+      } catch (err) {
+        host.showToast(
+          "error",
+          "Failed to delete crossfade",
+          err instanceof Error ? err.message : String(err)
+        );
+      }
+    },
+    [host, activeSceneId, setCrossfadePairsMeta, setTracks]
+  );
+  const crossfadeSliderTimers = (0, import_react24.useRef)({});
+  const handleCrossfadeSlider = (0, import_react24.useCallback)(
+    (pair, pos) => {
+      setCrossfadePairsMeta(
+        (prev) => prev.map((p) => p.groupId === pair.groupId ? { ...p, sliderPos: pos } : p)
+      );
+      if (crossfadeSliderTimers.current[pair.groupId]) {
+        clearTimeout(crossfadeSliderTimers.current[pair.groupId]);
+      }
+      crossfadeSliderTimers.current[pair.groupId] = setTimeout(() => {
+        void (async () => {
+          const mc = await host.getMusicalContext();
+          await applyCrossfadeAutomation(
+            pair.origin.handle.id,
+            pair.target.handle.id,
+            mc.bars,
+            mc.bpm,
+            pos
+          );
+          if (activeSceneId) {
+            const sceneData = await host.getAllSceneData(activeSceneId);
+            for (const dbId of [pair.originDbId, pair.targetDbId]) {
+              const meta = asCrossfadeMeta(sceneData[`track:${dbId}:crossfade`]);
+              if (meta) {
+                host.setSceneData(activeSceneId, `track:${dbId}:crossfade`, { ...meta, sliderPos: pos }).catch(() => {
+                });
+              }
+            }
+          }
+        })();
+      }, 200);
+    },
+    [host, activeSceneId, applyCrossfadeAutomation, setCrossfadePairsMeta]
+  );
+  const handleFadeDelete = (0, import_react24.useCallback)(
+    async (fade) => {
+      try {
+        await host.deleteTrack(fade.track.handle.id);
+        if (activeSceneId) {
+          await host.deleteSceneData(activeSceneId, `track:${fade.dbId}:fade`);
+        }
+        setFadesMeta((prev) => prev.filter((f) => f.dbId !== fade.dbId));
+        setTracks((prev) => prev.filter((t) => t.handle.id !== fade.track.handle.id));
+        host.showToast("success", "Fade removed");
+      } catch (err) {
+        host.showToast(
+          "error",
+          "Failed to delete fade",
+          err instanceof Error ? err.message : String(err)
+        );
+      }
+    },
+    [host, activeSceneId, setFadesMeta, setTracks]
+  );
+  const fadeSliderTimers = (0, import_react24.useRef)({});
+  const handleFadeSlider = (0, import_react24.useCallback)(
+    (fade, pos) => {
+      setFadesMeta(
+        (prev) => prev.map((f) => f.dbId === fade.dbId ? { ...f, meta: { ...f.meta, sliderPos: pos } } : f)
+      );
+      if (fadeSliderTimers.current[fade.dbId]) clearTimeout(fadeSliderTimers.current[fade.dbId]);
+      fadeSliderTimers.current[fade.dbId] = setTimeout(() => {
+        void (async () => {
+          const mc = await host.getMusicalContext();
+          await applyFadeAutomation(
+            fade.track.handle.id,
+            fade.meta.direction,
+            mc.bars,
+            mc.bpm,
+            pos,
+            fade.meta.gesture
+          );
+          if (activeSceneId) {
+            const sceneData = await host.getAllSceneData(activeSceneId);
+            const meta = asFadeMeta(sceneData[`track:${fade.dbId}:fade`]);
+            if (meta) {
+              host.setSceneData(activeSceneId, `track:${fade.dbId}:fade`, { ...meta, sliderPos: pos }).catch(() => {
+              });
+            }
+          }
+        })();
+      }, 200);
+    },
+    [host, activeSceneId, applyFadeAutomation, setFadesMeta]
+  );
+  const lastResyncKeyRef = (0, import_react24.useRef)("");
+  (0, import_react24.useEffect)(() => {
+    if (!host.getTrackSound || resolvedCrossfadePairs.length === 0 && resolvedFades.length === 0) {
+      return;
+    }
+    const resyncKey = [
+      ...resolvedCrossfadePairs.map(
+        (p) => `${p.origin.handle.dbId}<${p.originSourceDbId}|${p.target.handle.dbId}<${p.targetSourceDbId}`
+      ),
+      ...resolvedFades.map((f) => `${f.track.handle.dbId}<${f.meta.sourceTrackDbId}`)
+    ].join(",");
+    if (resyncKey === lastResyncKeyRef.current) return;
+    lastResyncKeyRef.current = resyncKey;
+    let cancelled = false;
+    const reapplyIfDrifted = async (layerTrackId, layerDbId, sourceDbId) => {
+      if (!host.getTrackSound || cancelled) return;
+      const [sourceSnap, layerSnap] = await Promise.all([
+        host.getTrackSound(sourceDbId),
+        host.getTrackSound(layerDbId)
+      ]);
+      if (cancelled || !sourceSnap || sourceSnap.kind !== adapter.sound.acceptedSnapshotKind) {
+        return;
+      }
+      if (soundIdentity(sourceSnap) === soundIdentity(layerSnap)) return;
+      try {
+        await adapter.sound.copySnapshot(layerTrackId, sourceSnap);
+      } catch {
+      }
+    };
+    void (async () => {
+      for (const pair of resolvedCrossfadePairs) {
+        await reapplyIfDrifted(pair.origin.handle.id, pair.origin.handle.dbId, pair.originSourceDbId);
+        await reapplyIfDrifted(pair.target.handle.id, pair.target.handle.dbId, pair.targetSourceDbId);
+      }
+      for (const fade of resolvedFades) {
+        await reapplyIfDrifted(fade.track.handle.id, fade.track.handle.dbId, fade.meta.sourceTrackDbId);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [resolvedCrossfadePairs, resolvedFades, host, adapter]);
+  (0, import_react24.useEffect)(() => {
+    if (!host.setTrackVolumeAutomation || resolvedFades.length === 0) return;
+    void (async () => {
+      const mc = await host.getMusicalContext();
+      for (const fade of resolvedFades) {
+        const id = fade.track.handle.id;
+        if (appliedFadeAutomationRef.current.has(id)) continue;
+        appliedFadeAutomationRef.current.add(id);
+        await applyFadeAutomation(
+          id,
+          fade.meta.direction,
+          mc.bars,
+          mc.bpm,
+          fade.meta.sliderPos,
+          fade.meta.gesture
+        );
+      }
+    })();
+  }, [resolvedFades, host, applyFadeAutomation]);
+  return {
+    isCreatingCrossfade,
+    isCreatingFade,
+    handleCreateCrossfade,
+    handleCreateFade,
+    handleCrossfadeMute,
+    handleCrossfadeSolo,
+    handleCrossfadeDelete,
+    handleCrossfadeSlider,
+    handleFadeDelete,
+    handleFadeSlider
+  };
+}
+
+// src/panel-core/useGeneratorPanelCore.tsx
+var import_jsx_runtime23 = require("react/jsx-runtime");
+var EMPTY_PLACEHOLDERS = [];
+function useGeneratorPanelCore({
+  ui,
+  adapter
+}) {
+  const {
+    host,
+    activeSceneId,
+    isAuthenticated,
+    isConnected,
+    onHeaderContent,
+    onLoading,
+    sceneContext,
+    onOpenContract,
+    onExpandSelf,
+    isExpanded
+  } = ui;
+  const { identity, features } = adapter;
+  const logTag = identity.logTag;
+  const adapterRef = (0, import_react25.useRef)(adapter);
+  (0, import_react25.useEffect)(() => {
+    if (adapterRef.current !== adapter) {
+      adapterRef.current = adapter;
+      console.warn(
+        `[${logTag}] GeneratorPanelAdapter identity changed between renders \u2014 wrap it in useMemo(() => createAdapter(host), [host]) to avoid load loops.`
+      );
+    }
+  }, [adapter, logTag]);
+  const supportsMeters = typeof host.getTrackLevels === "function";
+  const trackLevels = useTrackLevels(host, isExpanded);
+  const [tracks, setTracks] = (0, import_react25.useState)([]);
+  const [isLoadingTracks, setIsLoadingTracks] = (0, import_react25.useState)(false);
+  const [importOpen, setImportOpen] = (0, import_react25.useState)(false);
+  const [soundImportTarget, setSoundImportTarget] = (0, import_react25.useState)(null);
+  const [designerView, setDesignerView] = (0, import_react25.useState)(false);
+  const [transitionSourceTotal, setTransitionSourceTotal] = (0, import_react25.useState)(0);
+  const [crossfadePairsMeta, setCrossfadePairsMeta] = (0, import_react25.useState)([]);
+  const [fadesMeta, setFadesMeta] = (0, import_react25.useState)([]);
+  const [genericGroupMetas, setGenericGroupMetas] = (0, import_react25.useState)({});
+  const [isComposing, , setIsComposingForScene] = useSceneState(activeSceneId, false);
+  const [placeholders, , setPlaceholdersForScene] = useSceneState(
+    activeSceneId,
+    EMPTY_PLACEHOLDERS
+  );
+  const saveTimeoutRefs = (0, import_react25.useRef)({});
+  const editLoadStartedRef = (0, import_react25.useRef)(/* @__PURE__ */ new Set());
+  const [availableInstruments, setAvailableInstruments] = (0, import_react25.useState)([]);
+  const [instrumentsLoading, setInstrumentsLoading] = (0, import_react25.useState)(false);
+  const engineToDbIdRef = (0, import_react25.useRef)(/* @__PURE__ */ new Map());
+  const tracksLoadedForSceneRef = (0, import_react25.useRef)(null);
+  const persistSoundHistory = (0, import_react25.useCallback)(
+    (trackId, state) => {
+      if (!activeSceneId) return;
+      const dbId = engineToDbIdRef.current.get(trackId) ?? trackId;
+      host.setSceneData(activeSceneId, trackDataKey(dbId, "soundHistory"), state).catch(() => {
+      });
+    },
+    [host, activeSceneId]
+  );
+  const soundHistory = useSoundHistory(adapter.sound.applySound, {
+    max: adapter.sound.historyMax,
+    onChange: persistSoundHistory
+  });
+  const anySolo = useAnySolo(host);
+  const reorder = useTrackReorder({
+    host,
+    items: tracks,
+    setItems: setTracks,
+    getId: (t) => t.handle.dbId
+  });
+  const loadTracks = (0, import_react25.useCallback)(
+    async (incremental = false) => {
+      const sceneAtStart = activeSceneId;
+      if (!sceneAtStart) {
+        setTracks([]);
+        setCrossfadePairsMeta([]);
+        setFadesMeta([]);
+        setGenericGroupMetas({});
+        tracksLoadedForSceneRef.current = null;
+        setIsLoadingTracks(false);
+        return;
+      }
+      if (!incremental && tracksLoadedForSceneRef.current !== sceneAtStart) {
+        setTracks([]);
+      }
+      tracksLoadedForSceneRef.current = sceneAtStart;
+      if (!incremental) soundHistory.reset();
+      const isStale = () => tracksLoadedForSceneRef.current !== sceneAtStart;
+      if (!incremental) setIsLoadingTracks(true);
+      try {
+        await host.adoptSceneTracks();
+        if (isStale()) return;
+        const handles = await host.getPluginTracks();
+        if (isStale()) return;
+        const sceneData = await host.getAllSceneData(sceneAtStart);
+        if (isStale()) return;
+        const idMap = /* @__PURE__ */ new Map();
+        for (const h of handles) {
+          idMap.set(h.id, h.dbId);
+        }
+        engineToDbIdRef.current = idMap;
+        const trackStates = [];
+        for (const handle of handles) {
+          let runtimeState = {
+            id: handle.id,
+            muted: false,
+            solo: false,
+            volume: 0.75,
+            pan: 0
+          };
+          let hasMidi = false;
+          try {
+            const info = await host.getTrackInfo(handle.id);
+            runtimeState = {
+              id: handle.id,
+              muted: info.muted,
+              solo: info.soloed,
+              volume: info.volume,
+              pan: info.pan
+            };
+            hasMidi = info.hasMidi;
+          } catch {
+          }
+          let fxDetailState = newTrackState(handle).fxDetailState;
+          try {
+            const fxState = await host.getTrackFxState(handle.id);
+            fxDetailState = pluginFxToToggleFx(fxState);
+          } catch {
+          }
+          const promptKey = trackDataKey(handle.dbId, "prompt");
+          let prompt = typeof sceneData[promptKey] === "string" ? sceneData[promptKey] : "";
+          if (!prompt && handle.prompt) {
+            prompt = handle.prompt;
+            host.setSceneData(sceneAtStart, promptKey, prompt).catch(() => {
+            });
+          }
+          if (!hasMidi && handle.role) {
+            hasMidi = true;
+          }
+          let instrumentMissing = false;
+          if (handle.instrumentPluginId) {
+            try {
+              const instrDescriptor = await host.getTrackInstrument(handle.id);
+              if (instrDescriptor?.missing) {
+                instrumentMissing = true;
+              }
+            } catch {
+            }
+          }
+          trackStates.push(
+            newTrackState(handle, {
+              prompt,
+              role: handle.role ?? "",
+              runtimeState,
+              fxDetailState,
+              hasMidi,
+              instrumentMissing
+            })
+          );
+        }
+        if (isStale()) return;
+        setTracks((prev) => {
+          const prevByDbId = new Map(prev.map((p) => [p.handle.dbId, p]));
+          return trackStates.map((ts) => {
+            const carry = prevByDbId.get(ts.handle.dbId);
+            return carry ? { ...ts, editNotes: carry.editNotes, editBars: carry.editBars, editBpm: carry.editBpm } : ts;
+          });
+        });
+        for (const ts of trackStates) {
+          const persisted = sceneData[trackDataKey(ts.handle.dbId, "soundHistory")];
+          if (persisted && typeof persisted === "object") {
+            soundHistory.restore(ts.handle.id, persisted);
+          }
+        }
+        if (!isStale()) {
+          setCrossfadePairsMeta(parseCrossfadePairs(sceneData));
+          setFadesMeta(parseFades(sceneData));
+          if (adapter.groupExtensions && adapter.groupExtensions.length > 0) {
+            const map = {};
+            for (const ext of adapter.groupExtensions) {
+              map[ext.metaKey] = parseTrackGroups(sceneData, ext);
+            }
+            setGenericGroupMetas(map);
+          }
+        }
+      } catch (error) {
+        console.error(`[${logTag}] Failed to load tracks:`, error);
+      } finally {
+        if (tracksLoadedForSceneRef.current === sceneAtStart) {
+          setIsLoadingTracks(false);
+        }
+      }
+    },
+    [host, activeSceneId, soundHistory, adapter, logTag]
+  );
+  (0, import_react25.useEffect)(() => {
+    loadTracks();
+  }, [loadTracks]);
+  (0, import_react25.useEffect)(() => {
+    const map = /* @__PURE__ */ new Map();
+    for (const t of tracks) {
+      map.set(t.handle.id, t.handle.dbId);
+    }
+    engineToDbIdRef.current = map;
+  }, [tracks]);
+  const loadedCompletedIdsRef = (0, import_react25.useRef)(/* @__PURE__ */ new Set());
+  (0, import_react25.useEffect)(() => {
+    if (placeholders.length === 0) {
+      loadedCompletedIdsRef.current.clear();
+      return;
+    }
+    const newCompleted = placeholders.filter(
+      (ph) => ph.status === "completed" && !loadedCompletedIdsRef.current.has(ph.id)
+    );
+    if (newCompleted.length > 0) {
+      for (const ph of newCompleted) {
+        loadedCompletedIdsRef.current.add(ph.id);
+      }
+      console.log(
+        `[${logTag}] ${newCompleted.length} track(s) completed, reloading. IDs:`,
+        newCompleted.map((ph) => ph.id)
+      );
+      loadTracks(true);
+    }
+  }, [placeholders, loadTracks, logTag]);
+  const adoptAndLoad = (0, import_react25.useCallback)(() => {
+    loadTracks(true);
+  }, [loadTracks]);
+  (0, import_react25.useEffect)(() => {
+    const unsub = host.onEngineReady(() => {
+      adoptAndLoad();
+    });
+    return unsub;
+  }, [host, adoptAndLoad]);
+  (0, import_react25.useEffect)(() => {
+    if (typeof host.onAfterAgentMutation !== "function") return;
+    let timer = null;
+    const unsub = host.onAfterAgentMutation(() => {
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        timer = null;
+        loadTracks(true);
+      }, 500);
+    });
+    return () => {
+      unsub?.();
+      if (timer) clearTimeout(timer);
+    };
+  }, [host, loadTracks]);
+  (0, import_react25.useEffect)(() => {
+    const unsub = host.onTrackStateChange((trackId, state) => {
+      setTracks((prev) => prev.map((t) => t.handle.id === trackId ? { ...t, runtimeState: state } : t));
+    });
+    return unsub;
+  }, [host]);
+  (0, import_react25.useEffect)(() => {
+    if (!features.bulkComposePlaceholders) return;
+    console.log(`[${logTag}] Subscribing to composeProgress`);
+    const unsub = host.onComposeProgress((event) => {
+      const targetScene = event.sceneId;
+      if (!targetScene) return;
+      console.log(
+        `[${logTag}] composeProgress event:`,
+        event.phase,
+        "sceneId:",
+        targetScene,
+        "placeholders:",
+        event.placeholders?.length ?? "none"
+      );
+      switch (event.phase) {
+        case "planning":
+          setIsComposingForScene(targetScene, true);
+          setPlaceholdersForScene(targetScene, []);
+          break;
+        case "generating":
+          setIsComposingForScene(targetScene, false);
+          if (event.placeholders) {
+            setPlaceholdersForScene(targetScene, event.placeholders);
+          }
+          break;
+        case "complete":
+        case "error":
+          setIsComposingForScene(targetScene, false);
+          setPlaceholdersForScene(targetScene, EMPTY_PLACEHOLDERS);
+          break;
+      }
+    });
+    return unsub;
+  }, [host, setIsComposingForScene, setPlaceholdersForScene, features.bulkComposePlaceholders, logTag]);
+  (0, import_react25.useEffect)(() => {
+    const refs = saveTimeoutRefs;
+    return () => {
+      for (const timeout of Object.values(refs.current)) {
+        clearTimeout(timeout);
+      }
+    };
+  }, []);
+  const isAddingTrackRef = (0, import_react25.useRef)(false);
+  const [isAddingTrack, setIsAddingTrack] = (0, import_react25.useState)(false);
+  const handleAddTrack = (0, import_react25.useCallback)(async () => {
+    if (isAddingTrackRef.current) return;
+    if (!activeSceneId) {
+      host.showToast("warning", "Select SCENE");
+      return;
+    }
+    if (!isConnected) {
+      host.showToast("warning", "Systems not connected");
+      return;
+    }
+    if (!isAuthenticated) {
+      host.showToast("warning", "Sign In Required", "Please sign in to add tracks");
+      return;
+    }
+    if (tracks.length >= identity.maxTracks) return;
+    isAddingTrackRef.current = true;
+    setIsAddingTrack(true);
+    try {
+      const handle = await host.createTrack({
+        name: `${identity.trackNamePrefix}-${Date.now()}`,
+        ...adapter.createTrackOptions()
+      });
+      setTracks((prev) => [...prev, newTrackState(handle)]);
+      onExpandSelf?.();
+      setTimeout(() => {
+        const inputs = document.querySelectorAll(
+          `[data-testid="${identity.familyKey}-section"] [data-testid="sdk-prompt-input"]`
+        );
+        if (inputs.length > 0) {
+          inputs[inputs.length - 1].focus();
+        }
+      }, 350);
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : "Unknown error";
+      host.showToast("error", "Failed to create track", msg);
+    } finally {
+      isAddingTrackRef.current = false;
+      setIsAddingTrack(false);
+    }
+  }, [host, adapter, identity, activeSceneId, isConnected, isAuthenticated, tracks.length, onExpandSelf]);
+  const handlePortTrack = (0, import_react25.useCallback)(
+    async (sel) => {
+      if (!activeSceneId) {
+        host.showToast("warning", "Select SCENE");
+        return;
+      }
+      if (!isConnected) {
+        host.showToast("warning", "Systems not connected");
+        return;
+      }
+      if (tracks.length >= identity.maxTracks) {
+        host.showToast("warning", "Track limit reached");
+        return;
+      }
+      if (!host.readImportableTrackMidi) return;
+      let handle = null;
+      try {
+        handle = await host.createTrack({
+          name: `${identity.trackNamePrefix}-${Date.now()}`,
+          ...adapter.createTrackOptions()
+        });
+        if (sel.role) {
+          try {
+            await host.setTrackRole(handle.id, sel.role);
+          } catch {
+          }
+        }
+        const midi = await host.readImportableTrackMidi(sel.sourceTrackDbId);
+        const notes = midi.clips[0]?.notes ?? [];
+        if (notes.length > 0) {
+          const mc = await host.getMusicalContext();
+          await host.writeMidiClip(handle.id, {
+            startTime: 0,
+            endTime: mc.bars * 4 * 60 / mc.bpm,
+            tempo: mc.bpm,
+            notes
+          });
+        }
+        await adapter.applyPortedTrackSound(handle, sel.role);
+        host.showToast(
+          "success",
+          `Imported to ${identity.familyKey}`,
+          notes.length ? `${sel.trackName} \u2192 ${identity.familyKey}` : `${sel.trackName} (no MIDI yet)`
+        );
+        await loadTracks(true);
+      } catch (err) {
+        if (handle) {
+          try {
+            await host.deleteTrack(handle.id);
+          } catch {
+          }
+        }
+        host.showToast("error", "Import failed", err instanceof Error ? err.message : String(err));
+      }
+    },
+    [host, adapter, identity, activeSceneId, isConnected, tracks.length, loadTracks]
+  );
+  const handleSoundImportPick = (0, import_react25.useCallback)(
+    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] = (0, import_react25.useState)(false);
+  const handleExportMidi = (0, import_react25.useCallback)(async () => {
+    if (isExportingMidi) return;
+    setIsExportingMidi(true);
+    try {
+      const result = await host.exportTracksAsMidiBundle({
+        defaultName: identity.exportDefaultName ?? "midi-tracks"
+      });
+      if (result.success) {
+        const filename = result.filePath.split("/").pop() || result.filePath;
+        const skippedNote = result.skippedCount > 0 ? ` (${result.skippedCount} empty track${result.skippedCount === 1 ? "" : "s"} skipped)` : "";
+        host.showToast(
+          "success",
+          "MIDI exported",
+          `${result.trackCount} track${result.trackCount === 1 ? "" : "s"} \u2192 ${filename}${skippedNote}`
+        );
+      } else if (!("canceled" in result && result.canceled)) {
+        const errMsg = "error" in result ? result.error : "Unknown error";
+        host.showToast("error", "Export failed", errMsg);
+      }
+    } catch (error) {
+      const msg = error instanceof Error ? error.message : String(error);
+      host.showToast("error", "Export failed", msg);
+    } finally {
+      setIsExportingMidi(false);
+    }
+  }, [host, identity.exportDefaultName, isExportingMidi]);
+  const isBulkActive = !!(isComposing || placeholders.length > 0);
+  const needsContract = !sceneContext?.hasContract;
+  const xfFromId = sceneContext?.transitionFromSceneId ?? null;
+  const xfToId = sceneContext?.transitionToSceneId ?? null;
+  const canCrossfade = features.transitionDesigner && sceneContext?.sceneType === "transition" && !!xfFromId && !!xfToId && !!host.listSceneFamilyTracks;
+  (0, import_react25.useEffect)(() => {
+    if (!canCrossfade) setDesignerView(false);
+  }, [canCrossfade]);
+  (0, import_react25.useEffect)(() => {
+    if (!canCrossfade || !xfFromId || !xfToId || !host.listSceneFamilyTracks) {
+      setTransitionSourceTotal(0);
+      return;
+    }
+    let cancelled = false;
+    void Promise.all([host.listSceneFamilyTracks(xfFromId), host.listSceneFamilyTracks(xfToId)]).then(([a, b]) => {
+      if (!cancelled) setTransitionSourceTotal(a.length + b.length);
+    }).catch(() => {
+      if (!cancelled) setTransitionSourceTotal(0);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [canCrossfade, xfFromId, xfToId, host]);
+  const transitionDone = crossfadePairsMeta.length * 2 + fadesMeta.length;
+  (0, import_react25.useEffect)(() => {
+    if (!onHeaderContent) return;
+    const addDisabled = needsContract || !isConnected || !activeSceneId || tracks.length >= identity.maxTracks || isAddingTrack;
+    onHeaderContent(
+      /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { className: "flex gap-1 items-center", children: [
+        features.importTracks && (!canCrossfade || !designerView) && host.listImportableTracks && /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+          "button",
+          {
+            "data-testid": `import-from-scene-${identity.familyKey}-button`,
+            onClick: (e) => {
+              e.stopPropagation();
+              onExpandSelf?.();
+              setImportOpen(true);
+            },
+            disabled: !activeSceneId || needsContract,
+            className: `px-2 py-0.5 text-[10px] font-medium rounded-sm border transition-colors ${!activeSceneId || needsContract ? "bg-sas-panel border-sas-border text-sas-muted/50 cursor-not-allowed" : "bg-sas-panel-alt border-sas-border text-sas-muted hover:border-sas-accent hover:text-sas-accent"}`,
+            children: identity.importTrackLabel ?? "Import Track"
+          }
+        ),
+        (!canCrossfade || !designerView) && /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+          "button",
+          {
+            "data-testid": `add-${identity.familyKey}-track-button`,
+            onClick: (e) => {
+              e.stopPropagation();
+              if (needsContract) {
+                onOpenContract?.();
+                return;
+              }
+              handleAddTrack();
+            },
+            className: `px-2 py-0.5 text-[10px] font-medium rounded-sm border transition-colors ${addDisabled ? "bg-sas-panel border-sas-border text-sas-muted/50 cursor-not-allowed" : "bg-sas-accent/10 border-sas-accent/30 text-sas-accent hover:bg-sas-accent/20"}`,
+            children: identity.addTrackLabel ?? "Add Track"
+          }
+        ),
+        canCrossfade && /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
+          "button",
+          {
+            "data-testid": `${identity.familyKey}-view-toggle`,
+            onClick: (e) => {
+              e.stopPropagation();
+              if (!designerView) {
+                if (needsContract) {
+                  onOpenContract?.();
+                  return;
+                }
+                onExpandSelf?.();
+              }
+              setDesignerView((v) => !v);
+            },
+            disabled: !designerView && needsContract,
+            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__ */ (0, import_jsx_runtime23.jsx)(
+                "span",
+                {
+                  className: "absolute inset-y-0 left-0 bg-sas-accent/25",
+                  style: { width: `${Math.min(100, transitionDone / transitionSourceTotal * 100)}%` },
+                  "aria-hidden": true
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("span", { className: "relative", children: [
+                "\u21C4 ",
+                designerView ? "Transition" : "Tracks",
+                transitionSourceTotal > 0 ? ` ${transitionDone}/${transitionSourceTotal}` : ""
+              ] })
+            ]
+          }
+        )
+      ] })
+    );
+    return () => {
+      onHeaderContent(null);
+    };
+  }, [
+    onHeaderContent,
+    needsContract,
+    isConnected,
+    activeSceneId,
+    tracks.length,
+    isAddingTrack,
+    handleAddTrack,
+    onOpenContract,
+    host,
+    canCrossfade,
+    designerView,
+    transitionDone,
+    transitionSourceTotal,
+    onExpandSelf,
+    identity,
+    features.importTracks
+  ]);
+  (0, import_react25.useEffect)(() => {
+    if (!onLoading) return;
+    const anyGenerating = tracks.some((t) => t.isGenerating);
+    onLoading(isLoadingTracks || anyGenerating || isBulkActive);
+    return () => {
+      onLoading(false);
+    };
+  }, [onLoading, isLoadingTracks, tracks, isBulkActive]);
+  const handleDeleteTrack = (0, import_react25.useCallback)(
+    async (trackId) => {
+      try {
+        await host.deleteTrack(trackId);
+        const dbId = engineToDbIdRef.current.get(trackId) ?? trackId;
+        if (activeSceneId) {
+          await host.deleteSceneData(activeSceneId, trackDataKey(dbId, "prompt"));
+        }
+        setTracks((prev) => prev.filter((t) => t.handle.id !== trackId));
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : "Unknown error";
+        host.showToast("error", "Failed to delete track", msg);
+      }
+    },
+    [host, activeSceneId]
+  );
+  const handlePromptChange = (0, import_react25.useCallback)(
+    (trackId, prompt) => {
+      setTracks((prev) => prev.map((t) => t.handle.id === trackId ? { ...t, prompt } : t));
+      const dbId = engineToDbIdRef.current.get(trackId) ?? trackId;
+      if (saveTimeoutRefs.current[trackId]) {
+        clearTimeout(saveTimeoutRefs.current[trackId]);
+      }
+      saveTimeoutRefs.current[trackId] = setTimeout(() => {
+        if (activeSceneId) {
+          host.setSceneData(activeSceneId, trackDataKey(dbId, "prompt"), prompt).catch(() => {
+          });
+        }
+      }, 500);
+    },
+    [host, activeSceneId]
+  );
+  const resolvedGenericGroups = (0, import_react25.useMemo)(() => {
+    const out = {};
+    for (const ext of adapter.groupExtensions ?? []) {
+      out[ext.metaKey] = resolveTrackGroups(
+        genericGroupMetas[ext.metaKey] ?? [],
+        tracks,
+        (t) => t.handle.dbId,
+        {
+          isComplete: ext.isComplete
+        }
+      );
+    }
+    return out;
+  }, [adapter, genericGroupMetas, tracks]);
+  const genericGroupMemberDbIds = (0, import_react25.useMemo)(() => {
+    const s = /* @__PURE__ */ new Set();
+    for (const r of Object.values(resolvedGenericGroups)) {
+      for (const dbId of r.memberDbIds) s.add(dbId);
+    }
+    return s;
+  }, [resolvedGenericGroups]);
+  const engineToDbId = (0, import_react25.useCallback)(
+    (trackId) => engineToDbIdRef.current.get(trackId) ?? trackId,
+    []
+  );
+  const updateTrack = (0, import_react25.useCallback)(
+    (trackId, patch) => {
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? typeof patch === "function" ? patch(t) : { ...t, ...patch } : t
+        )
+      );
+    },
+    []
+  );
+  const markEditLoaded = (0, import_react25.useCallback)((trackId) => {
+    editLoadStartedRef.current.add(trackId);
+  }, []);
+  const tracksRef = (0, import_react25.useRef)(tracks);
+  (0, import_react25.useEffect)(() => {
+    tracksRef.current = tracks;
+  }, [tracks]);
+  const resolvedGenericGroupsRef = (0, import_react25.useRef)(resolvedGenericGroups);
+  (0, import_react25.useEffect)(() => {
+    resolvedGenericGroupsRef.current = resolvedGenericGroups;
+  }, [resolvedGenericGroups]);
+  const makeServices = (0, import_react25.useCallback)(() => {
+    return {
+      host,
+      activeSceneId,
+      tracks: tracksRef.current,
+      updateTrack,
+      setTracks,
+      reloadTracks: loadTracks,
+      soundHistory,
+      engineToDbId,
+      trackDataKey,
+      markEditLoaded,
+      createFamilyTrack: (nameSuffix = "") => host.createTrack({
+        name: `${identity.trackNamePrefix}-${Date.now()}${nameSuffix}`,
+        ...adapter.createTrackOptions()
+      }),
+      resolvedGroups: (metaKey) => resolvedGenericGroupsRef.current[metaKey]?.resolved ?? []
+    };
+  }, [host, activeSceneId, updateTrack, loadTracks, soundHistory, engineToDbId, markEditLoaded, identity, adapter]);
+  const handleGenerate = (0, import_react25.useCallback)(
+    async (trackId) => {
+      const track = tracks.find((t) => t.handle.id === trackId);
+      if (!track || !track.prompt.trim()) return;
+      if (!isAuthenticated) {
+        host.showToast("warning", "Sign In Required", "Please sign in to generate MIDI");
+        return;
+      }
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, isGenerating: true, error: null, generationProgress: 0 } : t
+        )
+      );
+      try {
+        await adapter.generation.generate(track, makeServices());
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : "Generation failed";
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === trackId ? { ...t, isGenerating: false, error: msg, generationProgress: 0 } : t
+          )
+        );
+        host.showToast("error", "Generation failed", msg);
+      }
+    },
+    [host, adapter, tracks, isAuthenticated, makeServices]
+  );
+  const handleMuteToggle = (0, import_react25.useCallback)(
+    (trackId) => {
+      const track = tracks.find((t) => t.handle.id === trackId);
+      if (!track) return;
+      const newMuted = !track.runtimeState.muted;
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, muted: newMuted } } : t
+        )
+      );
+      host.setTrackMute(trackId, newMuted).catch(() => {
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, muted: !newMuted } } : t
+          )
+        );
+      });
+    },
+    [host, tracks]
+  );
+  const handleSoloToggle = (0, import_react25.useCallback)(
+    (trackId) => {
+      const track = tracks.find((t) => t.handle.id === trackId);
+      if (!track) return;
+      const newSolo = !track.runtimeState.solo;
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, solo: newSolo } } : t
+        )
+      );
+      host.setTrackSolo(trackId, newSolo).catch(() => {
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, solo: !newSolo } } : t
+          )
+        );
+      });
+    },
+    [host, tracks]
+  );
+  const handleVolumeChange = (0, import_react25.useCallback)(
+    (trackId, volume) => {
+      setTracks(
+        (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, volume } } : t)
+      );
+      host.setTrackVolume(trackId, volume).catch(() => {
+      });
+    },
+    [host]
+  );
+  const handlePanChange = (0, import_react25.useCallback)(
+    (trackId, pan) => {
+      setTracks(
+        (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, runtimeState: { ...t.runtimeState, pan } } : t)
+      );
+      host.setTrackPan(trackId, pan).catch(() => {
+      });
+    },
+    [host]
+  );
+  const handleShuffle = (0, import_react25.useCallback)(
+    async (trackId) => {
+      const track = tracks.find((t) => t.handle.id === trackId);
+      if (!track) return;
+      if (soundHistory.list(trackId).entries.length === 0) {
+        try {
+          const cap = await adapter.sound.captureSoundDescriptor(trackId);
+          if (cap) soundHistory.record(trackId, cap.descriptor, adapter.sound.previousSoundLabel);
+        } catch {
+        }
+      }
+      try {
+        let result;
+        let nextHistory;
+        try {
+          result = await adapter.shuffle.shuffle(track, Array.from(track.shuffleHistory));
+          nextHistory = new Set(track.shuffleHistory);
+        } catch (firstErr) {
+          if (adapter.shuffle.isExhaustedError(firstErr)) {
+            nextHistory = /* @__PURE__ */ new Set();
+            result = await adapter.shuffle.shuffle(track, []);
+          } else {
+            throw firstErr;
+          }
+        }
+        nextHistory.add(result.appliedName);
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, shuffleHistory: nextHistory } : t)
+        );
+        try {
+          const cap = await adapter.sound.captureSoundDescriptor(trackId);
+          if (cap) soundHistory.record(trackId, cap.descriptor, result.appliedName);
+        } catch {
+        }
+        console.log(`[${logTag}] Sound shuffled: ${result.appliedName} (history ${nextHistory.size})`);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : "Shuffle failed";
+        host.showToast("error", "Shuffle failed", msg);
+      }
+    },
+    [host, adapter, tracks, soundHistory, logTag]
+  );
+  const handleCopy = (0, import_react25.useCallback)(
+    async (trackId) => {
+      try {
+        const newHandle = await host.duplicateTrack(trackId);
+        await loadTracks();
+        host.showToast("success", "Track duplicated", newHandle.name);
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : "Copy failed";
+        host.showToast("error", "Copy failed", msg);
+      }
+    },
+    [host, loadTracks]
+  );
+  const handleFxToggle = (0, import_react25.useCallback)(
+    (trackId, category, enabled) => {
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, fxDetailState: { ...t.fxDetailState, [category]: { ...t.fxDetailState[category], enabled } } } : t
+        )
+      );
+      host.toggleTrackFx(trackId, category, enabled).catch(() => {
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === trackId ? {
+              ...t,
+              fxDetailState: {
+                ...t.fxDetailState,
+                [category]: { ...t.fxDetailState[category], enabled: !enabled }
+              }
+            } : t
+          )
+        );
+      });
+    },
+    [host]
+  );
+  const handleFxPresetChange = (0, import_react25.useCallback)(
+    (trackId, category, presetIndex) => {
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, fxDetailState: { ...t.fxDetailState, [category]: { ...t.fxDetailState[category], presetIndex } } } : t
+        )
+      );
+      host.setTrackFxPreset(trackId, category, presetIndex).then((result) => {
+        if (result.dryWet !== void 0) {
+          setTracks(
+            (prev) => prev.map(
+              (t) => t.handle.id === trackId ? {
+                ...t,
+                fxDetailState: {
+                  ...t.fxDetailState,
+                  [category]: { ...t.fxDetailState[category], dryWet: result.dryWet }
+                }
+              } : t
+            )
+          );
+        }
+      }).catch(() => {
+      });
+    },
+    [host]
+  );
+  const handleFxDryWetChange = (0, import_react25.useCallback)(
+    (trackId, category, value) => {
+      setTracks(
+        (prev) => prev.map(
+          (t) => t.handle.id === trackId ? { ...t, fxDetailState: { ...t.fxDetailState, [category]: { ...t.fxDetailState[category], dryWet: value } } } : t
+        )
+      );
+      host.setTrackFxDryWet(trackId, category, value).catch(() => {
+      });
+    },
+    [host]
+  );
+  const toggleFxDrawer = (0, import_react25.useCallback)(
+    (trackId) => {
+      setTracks(
+        (prev) => prev.map((t) => {
+          if (t.handle.id !== trackId) return t;
+          const onFx = t.drawerOpen && t.drawerTab === "fx";
+          return { ...t, drawerOpen: !onFx, drawerTab: "fx", editorStage: false };
+        })
+      );
+      const track = tracks.find((t) => t.handle.id === trackId);
+      const wasOnFx = !!track && track.drawerOpen && track.drawerTab === "fx";
+      if (track && !wasOnFx) {
+        host.getTrackFxState(trackId).then((fxState) => {
+          setTracks(
+            (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, fxDetailState: pluginFxToToggleFx(fxState) } : t)
+          );
+        }).catch(() => {
+        });
+      }
+    },
+    [host, tracks]
+  );
+  const loadEditNotes = (0, import_react25.useCallback)(
+    async (trackId) => {
+      try {
+        const mc = await host.getMusicalContext();
+        let notes = [];
+        if (typeof host.readMidiNotes === "function") {
+          const result = await host.readMidiNotes(trackId);
+          notes = result.clips[0]?.notes ?? [];
+        }
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, editNotes: notes, editBars: mc.bars, editBpm: mc.bpm } : t)
+        );
+      } catch (err) {
+        console.warn(`[${logTag}] Failed to load MIDI for editing:`, err);
+      }
+    },
+    [host, logTag]
+  );
+  const handleNotesChange = (0, import_react25.useCallback)(
+    (trackId, notes) => {
+      setTracks((prev) => prev.map((t) => t.handle.id === trackId ? { ...t, editNotes: notes } : t));
+      const key = `edit:${trackId}`;
+      if (saveTimeoutRefs.current[key]) {
+        clearTimeout(saveTimeoutRefs.current[key]);
+      }
+      saveTimeoutRefs.current[key] = setTimeout(() => {
+        void (async () => {
+          try {
+            if (notes.length === 0) {
+              await host.clearMidi(trackId);
+            } else {
+              const mc = await host.getMusicalContext();
+              await host.writeMidiClip(trackId, {
+                startTime: 0,
+                endTime: mc.bars * 4 * 60 / mc.bpm,
+                tempo: mc.bpm,
+                notes
+              });
+            }
+          } catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            host.showToast("error", "Failed to save edit", msg);
+          }
+        })();
+      }, 300);
+    },
+    [host]
+  );
+  const handleTabChange = (0, import_react25.useCallback)(
+    (trackId, tab) => {
+      setTracks((prev) => prev.map((t) => t.handle.id === trackId ? { ...t, drawerOpen: true, drawerTab: tab } : t));
+      if (tab === "fx") {
+        host.getTrackFxState(trackId).then((fxState) => {
+          setTracks(
+            (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, fxDetailState: pluginFxToToggleFx(fxState) } : t)
+          );
+        }).catch(() => {
+        });
+      } else if (tab === "pick" && availableInstruments.length === 0 && !instrumentsLoading) {
+        setInstrumentsLoading(true);
+        host.getAvailableInstruments().then((instruments) => {
+          setAvailableInstruments(instruments);
+        }).catch(() => {
+        }).finally(() => {
+          setInstrumentsLoading(false);
+        });
+      } else if (tab === "edit" && !editLoadStartedRef.current.has(trackId)) {
+        editLoadStartedRef.current.add(trackId);
+        void loadEditNotes(trackId);
+      }
+    },
+    [host, availableInstruments.length, instrumentsLoading, loadEditNotes]
+  );
+  const handleProgressChange = (0, import_react25.useCallback)((trackId, pct) => {
+    setTracks((prev) => prev.map((t) => t.handle.id === trackId ? { ...t, generationProgress: pct } : t));
+  }, []);
+  const handleToggleDrawer = (0, import_react25.useCallback)((trackId) => {
+    setTracks(
+      (prev) => prev.map((t) => {
+        if (t.handle.id !== trackId) return t;
+        const onSound = t.drawerOpen && t.drawerTab !== "fx";
+        return { ...t, drawerOpen: !onSound, drawerTab: "history", editorStage: false };
+      })
+    );
+  }, []);
+  const handleInstrumentSelect = (0, import_react25.useCallback)(
+    async (trackId, pluginId) => {
+      const isDefaultInstrument = pluginId === (identity.defaultInstrumentPluginId ?? "Surge XT");
+      if (isDefaultInstrument) {
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, drawerOpen: false, editorStage: false } : t)
+        );
+        try {
+          await host.setTrackInstrument(trackId, pluginId);
+          const descriptor = await host.getTrackInstrument(trackId);
+          setTracks(
+            (prev) => prev.map(
+              (t) => t.handle.id === trackId ? {
+                ...t,
+                instrumentPluginId: descriptor?.pluginId ?? null,
+                instrumentName: descriptor?.name ?? null,
+                instrumentMissing: descriptor?.missing ?? false
+              } : t
+            )
+          );
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : "Failed to load instrument";
+          host.showToast("error", "Instrument load failed", msg);
+        }
+        return;
+      }
+      setTracks(
+        (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, drawerTab: "pick", editorStage: true } : t)
+      );
+      try {
+        await host.setTrackInstrument(trackId, pluginId);
+        const descriptor = await host.getTrackInstrument(trackId);
+        setTracks(
+          (prev) => prev.map(
+            (t) => t.handle.id === trackId ? {
+              ...t,
+              instrumentPluginId: descriptor?.pluginId ?? null,
+              instrumentName: descriptor?.name ?? null,
+              instrumentMissing: descriptor?.missing ?? false
+            } : t
+          )
+        );
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "Failed to load instrument";
+        console.error(`[${logTag}] Failed to set instrument:`, err);
+        host.showToast("error", "Instrument load failed", msg);
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, editorStage: false } : t)
+        );
+      }
+    },
+    [host, identity.defaultInstrumentPluginId, logTag]
+  );
+  const handleShowEditor = (0, import_react25.useCallback)(
+    async (trackId) => {
+      try {
+        await host.showInstrumentEditor(trackId);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "Failed to open editor";
+        host.showToast("error", "Editor failed", msg);
+      }
+    },
+    [host]
+  );
+  const handleBackToInstruments = (0, import_react25.useCallback)((trackId) => {
+    setTracks(
+      (prev) => prev.map((t) => t.handle.id === trackId ? { ...t, editorStage: false } : t)
+    );
+  }, []);
+  const handleRefreshInstruments = (0, import_react25.useCallback)(() => {
+    setInstrumentsLoading(true);
+    host.getAvailableInstruments().then((instruments) => {
+      setAvailableInstruments(instruments);
+    }).catch(() => {
+    }).finally(() => {
+      setInstrumentsLoading(false);
+    });
+  }, [host]);
+  const onAuditionNote = (0, import_react25.useCallback)(
+    (trackId, pitch, velocity, ms) => {
+      void host.auditionNote(trackId, pitch, velocity, ms);
+    },
+    [host]
+  );
+  const { resolvedCrossfadePairs, crossfadeMemberDbIds } = (0, import_react25.useMemo)(() => {
+    const byDbId = new Map(tracks.map((t) => [t.handle.dbId, t]));
+    const pairs = [];
+    const members = /* @__PURE__ */ new Set();
+    for (const p of crossfadePairsMeta) {
+      const origin = byDbId.get(p.originDbId);
+      const target = byDbId.get(p.targetDbId);
+      if (origin && target) {
+        pairs.push({ ...p, origin, target });
+        members.add(p.originDbId);
+        members.add(p.targetDbId);
+      }
+    }
+    return { resolvedCrossfadePairs: pairs, crossfadeMemberDbIds: members };
+  }, [tracks, crossfadePairsMeta]);
+  const { resolvedFades, fadeMemberDbIds } = (0, import_react25.useMemo)(() => {
+    const byDbId = new Map(tracks.map((t) => [t.handle.dbId, t]));
+    const list = [];
+    const members = /* @__PURE__ */ new Set();
+    for (const f of fadesMeta) {
+      const track = byDbId.get(f.dbId);
+      if (track) {
+        list.push({ ...f, track });
+        members.add(f.dbId);
+      }
+    }
+    return { resolvedFades: list, fadeMemberDbIds: members };
+  }, [tracks, fadesMeta]);
+  const transition = useTransitionOps({
+    host,
+    adapter,
+    activeSceneId,
+    isConnected,
+    isAuthenticated,
+    sceneContext,
+    tracks,
+    setTracks,
+    loadTracks,
+    setCrossfadePairsMeta,
+    setFadesMeta,
+    resolvedCrossfadePairs,
+    resolvedFades
+  });
+  const setGroupMute = (0, import_react25.useCallback)(
+    (trackIds, muted) => {
+      for (const id of trackIds) {
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === id ? { ...t, runtimeState: { ...t.runtimeState, muted } } : t)
+        );
+        host.setTrackMute(id, muted).catch(() => {
+        });
+      }
+    },
+    [host]
+  );
+  const setGroupSolo = (0, import_react25.useCallback)(
+    (trackIds, solo) => {
+      for (const id of trackIds) {
+        setTracks(
+          (prev) => prev.map((t) => t.handle.id === id ? { ...t, runtimeState: { ...t.runtimeState, solo } } : t)
+        );
+        host.setTrackSolo(id, solo).catch(() => {
+        });
+      }
+    },
+    [host]
+  );
+  const deleteGroup = (0, import_react25.useCallback)(
+    async (members, cleanupKeySuffixes) => {
+      for (const member of members) {
+        try {
+          await host.deleteTrack(member.engineId);
+        } catch {
+        }
+        if (activeSceneId) {
+          for (const suffix of cleanupKeySuffixes) {
+            await host.deleteSceneData(activeSceneId, trackDataKey(member.dbId, suffix)).catch(() => {
+            });
+          }
+        }
+      }
+      const gone = new Set(members.map((m) => m.engineId));
+      setTracks((prev) => prev.filter((t) => !gone.has(t.handle.id)));
+      await loadTracks(true);
+    },
+    [host, activeSceneId, loadTracks]
+  );
+  const handlers = (0, import_react25.useMemo)(
+    () => ({
+      promptChange: handlePromptChange,
+      generate: (trackId) => {
+        void handleGenerate(trackId);
+      },
+      shuffle: (trackId) => {
+        void handleShuffle(trackId);
+      },
+      copy: (trackId) => {
+        void handleCopy(trackId);
+      },
+      delete: (trackId) => {
+        void handleDeleteTrack(trackId);
+      },
+      muteToggle: handleMuteToggle,
+      soloToggle: handleSoloToggle,
+      volumeChange: handleVolumeChange,
+      panChange: handlePanChange,
+      tabChange: handleTabChange,
+      toggleDrawer: handleToggleDrawer,
+      toggleFxDrawer,
+      notesChange: handleNotesChange,
+      progressChange: handleProgressChange
+    }),
+    [
+      handlePromptChange,
+      handleGenerate,
+      handleShuffle,
+      handleCopy,
+      handleDeleteTrack,
+      handleMuteToggle,
+      handleSoloToggle,
+      handleVolumeChange,
+      handlePanChange,
+      handleTabChange,
+      handleToggleDrawer,
+      toggleFxDrawer,
+      handleNotesChange,
+      handleProgressChange
+    ]
+  );
+  return {
+    ui,
+    adapter,
+    tracks,
+    setTracks,
+    isLoadingTracks,
+    loadTracks,
+    engineToDbId,
+    supportsMeters,
+    trackLevels,
+    anySolo,
+    reorder,
+    soundHistory,
+    isComposing,
+    placeholders,
+    isAddingTrack,
+    isExportingMidi,
+    designerView,
+    canCrossfade,
+    needsContract,
+    xfFromId,
+    xfToId,
+    importOpen,
+    setImportOpen,
+    soundImportTarget,
+    setSoundImportTarget,
+    handleSoundImportPick,
+    handlePortTrack,
+    transition,
+    crossfadePairsMeta,
+    fadesMeta,
+    resolvedCrossfadePairs,
+    crossfadeMemberDbIds,
+    resolvedFades,
+    fadeMemberDbIds,
+    resolvedGenericGroups,
+    genericGroupMemberDbIds,
+    availableInstruments,
+    instrumentsLoading,
+    handlers,
+    handleGenerate,
+    handleShuffle,
+    handleAddTrack,
+    handleDeleteTrack,
+    handleExportMidi,
+    handlePromptChange,
+    handleMuteToggle,
+    handleSoloToggle,
+    handleVolumeChange,
+    handlePanChange,
+    handleTabChange,
+    handleToggleDrawer,
+    toggleFxDrawer,
+    handleNotesChange,
+    handleProgressChange,
+    handleCopy,
+    handleFxToggle,
+    handleFxPresetChange,
+    handleFxDryWetChange,
+    handleInstrumentSelect,
+    handleShowEditor,
+    handleBackToInstruments,
+    handleRefreshInstruments,
+    onAuditionNote,
+    makeServices,
+    setGroupMute,
+    setGroupSolo,
+    deleteGroup
+  };
+}
+
+// src/panel-core/GeneratorPanelShell.tsx
+var import_react26 = __toESM(require("react"));
+var import_jsx_runtime24 = require("react/jsx-runtime");
+function GeneratorPanelShell({ core, slots }) {
+  const {
+    ui,
+    adapter,
+    tracks,
+    isLoadingTracks,
+    supportsMeters,
+    trackLevels,
+    anySolo,
+    reorder,
+    soundHistory,
+    isComposing,
+    placeholders,
+    designerView,
+    canCrossfade,
+    xfFromId,
+    xfToId,
+    importOpen,
+    setImportOpen,
+    soundImportTarget,
+    setSoundImportTarget,
+    handleSoundImportPick,
+    handlePortTrack,
+    transition,
+    crossfadePairsMeta,
+    fadesMeta,
+    resolvedCrossfadePairs,
+    crossfadeMemberDbIds,
+    resolvedFades,
+    fadeMemberDbIds,
+    resolvedGenericGroups,
+    genericGroupMemberDbIds,
+    availableInstruments,
+    instrumentsLoading,
+    handlers,
+    isExportingMidi,
+    handleExportMidi,
+    handleFxToggle,
+    handleFxPresetChange,
+    handleFxDryWetChange,
+    handleInstrumentSelect,
+    handleShowEditor,
+    handleBackToInstruments,
+    handleRefreshInstruments,
+    onAuditionNote,
+    loadTracks,
+    makeServices,
+    setGroupMute,
+    setGroupSolo,
+    deleteGroup
+  } = core;
+  const { host, activeSceneId, isAuthenticated, sceneContext, onSelectScene, onOpenContract } = ui;
+  const { identity, features } = adapter;
+  const buildRowProps = (0, import_react26.useCallback)(
+    (track, drag) => {
+      const id = track.handle.id;
+      const pickerProps = features.instrumentPicker ? {
+        instrumentName: track.instrumentName,
+        instrumentMissing: track.instrumentMissing,
+        onToggleDrawer: () => handlers.toggleDrawer(id),
+        availableInstruments,
+        currentInstrumentPluginId: track.instrumentPluginId,
+        onInstrumentSelect: (pluginId) => handleInstrumentSelect(id, pluginId),
+        instrumentsLoading,
+        onRefreshInstruments: handleRefreshInstruments,
+        editorStage: track.editorStage,
+        onShowEditor: () => handleShowEditor(id),
+        onBackToInstruments: () => handleBackToInstruments(id)
+      } : {};
+      const importSoundProps = features.importTracks ? {
+        onImportSound: () => setSoundImportTarget(track),
+        importSoundLabel: adapter.sound.importSoundLabel
+      } : {};
+      const props = {
+        ...drag ? { drag } : {},
+        track: { id, name: track.handle.name, role: track.role },
+        levels: supportsMeters ? trackLevels : void 0,
+        prompt: track.prompt,
+        runtimeState: {
+          muted: track.runtimeState.muted,
+          solo: track.runtimeState.solo,
+          volume: track.runtimeState.volume,
+          pan: track.runtimeState.pan
+        },
+        soloedOut: anySolo && !track.runtimeState.solo,
+        fxDetailState: track.fxDetailState,
+        drawerOpen: track.drawerOpen,
+        drawerTab: track.drawerTab,
+        onTabChange: (tab) => handlers.tabChange(id, tab),
+        isGenerating: track.isGenerating,
+        isAuthenticated,
+        error: track.error,
+        hasMidi: track.hasMidi,
+        generationProgress: track.generationProgress,
+        estimatedGenerationMs: identity.estimatedGenerationMs,
+        onPromptChange: (prompt) => handlers.promptChange(id, prompt),
+        onGenerate: () => handlers.generate(id),
+        onShuffle: () => handlers.shuffle(id),
+        onCopy: () => handlers.copy(id),
+        onDelete: () => handlers.delete(id),
+        onMuteToggle: () => handlers.muteToggle(id),
+        onSoloToggle: () => handlers.soloToggle(id),
+        onVolumeChange: (vol) => handlers.volumeChange(id, vol),
+        onPanChange: (pan) => handlers.panChange(id, pan),
+        onFxToggle: (cat, enabled) => handleFxToggle(id, cat, enabled),
+        onFxPresetChange: (cat, idx) => handleFxPresetChange(id, cat, idx),
+        onFxDryWetChange: (cat, val) => handleFxDryWetChange(id, cat, val),
+        onToggleFxDrawer: () => handlers.toggleFxDrawer(id),
+        onProgressChange: (pct) => handlers.progressChange(id, pct),
+        accentColor: identity.accentColor,
+        ...pickerProps,
+        soundHistory: soundHistory.list(id).entries,
+        soundHistoryCursor: soundHistory.list(id).cursor,
+        onRestoreSound: (i) => {
+          void soundHistory.restoreTo(id, i);
+        },
+        onToggleFavorite: (i) => soundHistory.toggleFavorite(id, i),
+        ...importSoundProps,
+        editNotes: track.editNotes,
+        onNotesChange: (notes) => handlers.notesChange(id, notes),
+        editBars: track.editBars,
+        editBpm: track.editBpm,
+        editSnap: 0.25,
+        onAuditionNote: (pitch, vel, ms) => onAuditionNote(id, pitch, vel, ms)
+      };
+      return adapter.mapTrackRowProps ? adapter.mapTrackRowProps(track, props) : props;
+    },
+    [
+      features.instrumentPicker,
+      features.importTracks,
+      adapter,
+      supportsMeters,
+      trackLevels,
+      anySolo,
+      isAuthenticated,
+      identity,
+      handlers,
+      availableInstruments,
+      instrumentsLoading,
+      handleInstrumentSelect,
+      handleRefreshInstruments,
+      handleShowEditor,
+      handleBackToInstruments,
+      setSoundImportTarget,
+      soundHistory,
+      handleFxToggle,
+      handleFxPresetChange,
+      handleFxDryWetChange,
+      onAuditionNote
+    ]
+  );
+  if (!activeSceneId) {
+    return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+      "div",
+      {
+        "data-testid": `no-scene-placeholder-${identity.familyKey}`,
+        className: "flex items-center justify-center py-8",
+        children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+          "button",
+          {
+            onClick: () => onSelectScene?.(),
+            className: "text-sas-muted text-xs hover:text-sas-accent transition-colors underline underline-offset-2",
+            children: "Select a Scene"
+          }
+        )
+      }
+    );
+  }
+  if (!sceneContext?.hasContract) {
+    return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+      "div",
+      {
+        "data-testid": `no-contract-placeholder-${identity.familyKey}`,
+        className: "flex items-center justify-center py-8",
+        children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+          "button",
+          {
+            onClick: () => onOpenContract?.(),
+            className: "text-sas-muted text-xs hover:text-sas-accent transition-colors underline underline-offset-2",
+            children: "Generate a Contract"
+          }
+        )
+      }
+    );
+  }
+  if (features.bulkComposePlaceholders && isComposing) {
+    return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2", children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(SorceryProgressBar, { isLoading: true, statusText: "COMPOSING...", heightClass: "h-10" }) });
+  }
+  const activePlaceholders = features.bulkComposePlaceholders ? placeholders : [];
+  if (activePlaceholders.length > 0) {
+    const tracksByDbId = /* @__PURE__ */ new Map();
+    for (const t of tracks) {
+      tracksByDbId.set(t.handle.dbId, t);
+      if (t.handle.id !== t.handle.dbId) {
+        tracksByDbId.set(t.handle.id, t);
+      }
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("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__ */ (0, import_jsx_runtime24.jsx)(TrackRow, { ...buildRowProps(loadedTrack) }, ph.id);
+      }
+      return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+        "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__ */ (0, import_jsx_runtime24.jsx)(SorceryProgressBar, { isLoading: true, statusText: "CONJURING MIDI...", heightClass: "h-10" })
+        },
+        ph.id
+      );
+    }) });
+  }
+  const groupCtx = {
+    services: makeServices(),
+    anySolo,
+    supportsMeters,
+    levels: supportsMeters ? trackLevels : void 0,
+    handlers,
+    renderDefaultTrackRow: (track, overrides, drag) => /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(TrackRow, { ...{ ...buildRowProps(track, drag), ...overrides ?? {} } }, track.handle.id),
+    setGroupMute,
+    setGroupSolo,
+    deleteGroup
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)("div", { "data-testid": `${identity.familyKey}-section`, className: "p-2 space-y-2", children: [
+    features.importTracks && host.listImportableTracks && /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+      ImportTrackModal,
+      {
+        host,
+        open: importOpen,
+        onClose: () => setImportOpen(false),
+        onImported: () => {
+          void loadTracks(true);
+        },
+        onPortTrack: host.readImportableTrackMidi ? handlePortTrack : void 0,
+        testIdPrefix: `${identity.familyKey}-import`
+      }
+    ),
+    features.importTracks && host.listImportableTracks && host.getTrackSound && /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+      ImportTrackModal,
+      {
+        host,
+        mode: "sound",
+        open: !!soundImportTarget,
+        title: adapter.sound.importSoundLabel,
+        onClose: () => setSoundImportTarget(null),
+        onImported: () => {
+        },
+        onPick: handleSoundImportPick,
+        testIdPrefix: `${identity.familyKey}-sound-import`
+      }
+    ),
+    slots?.modals,
+    canCrossfade && xfFromId && xfToId && /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { className: designerView ? "contents" : "hidden", children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+      TransitionDesigner,
+      {
+        host,
+        fromSceneId: xfFromId,
+        toSceneId: xfToId,
+        transitionSceneId: activeSceneId ?? "",
+        excludeSourceDbIds: [
+          ...crossfadePairsMeta.flatMap((p) => [p.originSourceDbId, p.targetSourceDbId]),
+          ...fadesMeta.map((f) => f.meta.sourceTrackDbId)
+        ],
+        onCreateCrossfade: transition.handleCreateCrossfade,
+        onCreateFade: transition.handleCreateFade,
+        familyLabel: identity.familyLabel,
+        testIdPrefix: `${identity.familyKey}-transition-designer`
+      }
+    ) }),
+    !(designerView && canCrossfade) && (isLoadingTracks ? /* @__PURE__ */ (0, import_jsx_runtime24.jsx)("div", { className: "text-sas-muted text-xs text-center py-4", children: "Loading tracks..." }) : /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(import_jsx_runtime24.Fragment, { children: [
+      slots?.beforeRows,
+      resolvedCrossfadePairs.map((pair) => /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+        CrossfadeTrackRow,
+        {
+          accentColor: identity.transitionAccentColor,
+          levels: supportsMeters ? trackLevels : void 0,
+          sliderPos: pair.sliderPos,
+          origin: {
+            trackId: pair.origin.handle.id,
+            name: pair.origin.handle.name,
+            role: pair.origin.role,
+            sourceName: pair.originSourceName,
+            soundLabel: pair.originSoundLabel,
+            runtimeState: pair.origin.runtimeState
+          },
+          target: {
+            trackId: pair.target.handle.id,
+            name: pair.target.handle.name,
+            role: pair.target.role,
+            sourceName: pair.targetSourceName,
+            soundLabel: pair.targetSoundLabel,
+            runtimeState: pair.target.runtimeState
+          },
+          onMuteToggle: () => transition.handleCrossfadeMute(pair),
+          onSoloToggle: () => transition.handleCrossfadeSolo(pair),
+          onVolumeChange: (slot, vol) => handlers.volumeChange(
+            slot === "origin" ? pair.origin.handle.id : pair.target.handle.id,
+            vol
+          ),
+          onPanChange: (slot, pan) => handlers.panChange(
+            slot === "origin" ? pair.origin.handle.id : pair.target.handle.id,
+            pan
+          ),
+          onSliderChange: (pos) => transition.handleCrossfadeSlider(pair, pos),
+          onDelete: () => transition.handleCrossfadeDelete(pair)
+        },
+        pair.groupId
+      )),
+      resolvedFades.map((fade) => /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+        FadeTrackRow,
+        {
+          accentColor: identity.transitionAccentColor,
+          levels: supportsMeters ? trackLevels : void 0,
+          direction: fade.meta.direction,
+          gesture: fade.meta.gesture,
+          sliderPos: fade.meta.sliderPos,
+          layer: {
+            trackId: fade.track.handle.id,
+            name: fade.track.handle.name,
+            role: fade.track.role,
+            sourceName: fade.meta.sourceName,
+            soundLabel: fade.meta.soundLabel,
+            runtimeState: fade.track.runtimeState
+          },
+          onMuteToggle: () => handlers.muteToggle(fade.track.handle.id),
+          onSoloToggle: () => handlers.soloToggle(fade.track.handle.id),
+          onVolumeChange: (vol) => handlers.volumeChange(fade.track.handle.id, vol),
+          onPanChange: (pan) => handlers.panChange(fade.track.handle.id, pan),
+          onSliderChange: (pos) => transition.handleFadeSlider(fade, pos),
+          onDelete: () => transition.handleFadeDelete(fade)
+        },
+        fade.dbId
+      )),
+      (adapter.groupExtensions ?? []).flatMap(
+        (ext) => (resolvedGenericGroups[ext.metaKey]?.resolved ?? []).map((group) => /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(import_react26.default.Fragment, { children: ext.renderGroup(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__ */ (0, import_jsx_runtime24.jsx)(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__ */ (0, import_jsx_runtime24.jsx)("div", { className: "pt-2", children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+        "button",
+        {
+          "data-testid": "export-midi-tracks-button",
+          onClick: handleExportMidi,
+          disabled: exportDisabled,
+          title: isExportingMidi ? "Exporting..." : !hasAnyMidi ? "Generate MIDI on at least one track first" : "Export all tracks as a ZIP of .mid files",
+          className: `w-full px-2 py-1.5 text-[10px] uppercase tracking-wide rounded-sm border transition-colors ${exportDisabled ? "text-sas-muted/40 border-transparent hover:border-sas-accent cursor-not-allowed" : "text-sas-muted hover:text-sas-accent border-sas-border hover:border-sas-accent"}`,
+          children: isExportingMidi ? "Exporting..." : "Export Tracks"
+        }
+      ) });
+    })()
+  ] });
+}
+
+// src/panel-core/surge-sound-adapter.ts
+async function getInstrument(host, trackId) {
+  try {
+    const plugins = await host.getTrackPlugins(trackId);
+    const instrument = plugins.find(
+      (p) => !p.name.includes("Volume") && !p.name.includes("Pan") && !p.name.includes("Level")
+    );
+    if (!instrument) return null;
+    return { index: instrument.index, isRaw: !instrument.name.includes("Surge") };
+  } catch {
+    return null;
+  }
+}
+function createSurgeSoundAdapter(host, overrides = {}) {
+  const applySound = async (trackId, descriptor) => {
+    const { state, stateType } = descriptor;
+    const inst = await getInstrument(host, trackId);
+    if (!inst) return;
+    if (stateType === "raw") await host.setRawPluginState(trackId, inst.index, state);
+    else await host.setPluginState(trackId, inst.index, state);
+  };
+  return {
+    applySound,
+    captureSoundDescriptor: async (trackId) => {
+      const inst = await getInstrument(host, trackId);
+      if (!inst) return null;
+      const state = inst.isRaw ? await host.getRawPluginState(trackId, inst.index) : await host.getPluginState(trackId, inst.index);
+      return { descriptor: { state, stateType: inst.isRaw ? "raw" : "valuetree" } };
+    },
+    copySnapshot: async (trackId, snap) => {
+      if (snap.kind !== "preset") return "default";
+      await applySound(trackId, { state: snap.state, stateType: snap.stateType });
+      await host.persistTrackPresetState?.(trackId, {
+        state: snap.state,
+        stateType: snap.stateType ?? "valuetree",
+        name: snap.label
+      }).catch(() => {
+      });
+      return snap.label;
+    },
+    descriptorFromSnapshot: (snap) => {
+      const preset = snap;
+      return { state: preset.state, stateType: preset.stateType };
+    },
+    acceptedSnapshotKind: "preset",
+    historyMax: overrides.historyMax ?? 12,
+    importSoundLabel: overrides.importSoundLabel ?? "Import Preset",
+    importNoun: "preset",
+    previousSoundLabel: "Previous preset"
+  };
+}
+
 // src/constants/sdk-version.ts
-var PLUGIN_SDK_VERSION = "2.34.0";
+var PLUGIN_SDK_VERSION = "2.35.0";
 
 // src/utils/format-concurrent-tracks.ts
 function formatConcurrentTracks(ctx) {
@@ -5211,6 +7542,7 @@ function pickTopKWeighted(scored, options = {}) {
   FadeTrackRow,
   FxToggleBar,
   GUTTER_W,
+  GeneratorPanelShell,
   ImportTrackModal,
   InstrumentDrawer,
   LevelMeter,
@@ -5248,6 +7580,7 @@ function pickTopKWeighted(scored, options = {}) {
   cellToPx,
   centerScrollTop,
   computePeaks,
+  createSurgeSoundAdapter,
   dbIdsFromKeys,
   dbToSlider,
   defaultFadeGesture,
@@ -5255,16 +7588,21 @@ function pickTopKWeighted(scored, options = {}) {
   formatConcurrentTracks,
   hashString,
   moveItem,
+  newTrackState,
   normalizeSlots,
   padPair,
   padSlots,
   parseCrossfadePairs,
   parseFades,
+  parseLLMNoteResponse,
+  parseTrackGroups,
   pickTopKWeighted,
   pitchToName,
+  pluginFxToToggleFx,
   pxToCell,
   reconcileSlots,
   resizeNoteDuration,
+  resolveTrackGroups,
   rowKey,
   rowType,
   scorePromptMatch,
@@ -5273,14 +7611,17 @@ function pickTopKWeighted(scored, options = {}) {
   soundIdentity,
   synthesizeCuePoints,
   tokenizePrompt,
+  trackDataKey,
   transposeNotes,
   useAnySolo,
+  useGeneratorPanelCore,
   useSceneState,
   useSoundHistory,
   useTrackLevel,
   useTrackLevels,
   useTrackMeter,
   useTrackReorder,
+  useTransitionOps,
   useTransportPlaying
 });
 //# sourceMappingURL=index.js.map