@signalsandsorcery/plugin-sdk 2.28.1 → 2.34.1

package/dist/index.js

@@ -30,6 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AUDIO_EFFECTS: () => AUDIO_EFFECTS,
+  AUDIO_EFFECT_LABEL: () => AUDIO_EFFECT_LABEL,
   ConfirmDialog: () => ConfirmDialog,
   CrossfadeModal: () => CrossfadeModal,
   CrossfadeTrackRow: () => CrossfadeTrackRow,
@@ -68,34 +70,49 @@ __export(index_exports, {
   ScrollingWaveform: () => ScrollingWaveform,
   SorceryProgressBar: () => SorceryProgressBar,
   TEXTURAL_ROLES: () => TEXTURAL_ROLES,
+  TRANSITION_DESIGNER_DRAFT_KEY: () => TRANSITION_DESIGNER_DRAFT_KEY,
   TrackDrawer: () => TrackDrawer,
   TrackMeterStrip: () => TrackMeterStrip,
   TrackRow: () => TrackRow,
+  TransitionDesigner: () => TransitionDesigner,
   VolumeSlider: () => VolumeSlider,
   WaveformView: () => WaveformView,
   analyzeWavPeak: () => analyzeWavPeak,
+  asAudioEffect: () => asAudioEffect,
   asCrossfadeMeta: () => asCrossfadeMeta,
   asFadeMeta: () => asFadeMeta,
+  asTransitionDesignerDraft: () => asTransitionDesignerDraft,
   buildCrossfadeInpaintPrompt: () => buildCrossfadeInpaintPrompt,
   buildCrossfadeVolumeCurves: () => buildCrossfadeVolumeCurves,
   buildFadeVolumeCurve: () => buildFadeVolumeCurve,
+  buildRowSlots: () => buildRowSlots,
   calculateTimeBasedTarget: () => calculateTimeBasedTarget,
   cellToPx: () => cellToPx,
   centerScrollTop: () => centerScrollTop,
   computePeaks: () => computePeaks,
+  dbIdsFromKeys: () => dbIdsFromKeys,
   dbToSlider: () => dbToSlider,
   defaultFadeGesture: () => defaultFadeGesture,
   drawWaveform: () => drawWaveform,
   formatConcurrentTracks: () => formatConcurrentTracks,
+  hashString: () => hashString,
   moveItem: () => moveItem,
+  normalizeSlots: () => normalizeSlots,
+  padPair: () => padPair,
+  padSlots: () => padSlots,
   parseCrossfadePairs: () => parseCrossfadePairs,
   parseFades: () => parseFades,
   pickTopKWeighted: () => pickTopKWeighted,
   pitchToName: () => pitchToName,
   pxToCell: () => pxToCell,
+  reconcileSlots: () => reconcileSlots,
   resizeNoteDuration: () => resizeNoteDuration,
+  rowKey: () => rowKey,
+  rowType: () => rowType,
   scorePromptMatch: () => scorePromptMatch,
   sliderToDb: () => sliderToDb,
+  slotsEqual: () => slotsEqual,
+  soundIdentity: () => soundIdentity,
   synthesizeCuePoints: () => synthesizeCuePoints,
   tokenizePrompt: () => tokenizePrompt,
   transposeNotes: () => transposeNotes,
@@ -1455,6 +1472,7 @@ var LevelMeter = ({
 
 // src/hooks/useTrackLevels.ts
 var import_react5 = require("react");
+var meterDiagRLast = /* @__PURE__ */ new Map();
 var POLL_INTERVAL_MS = 33;
 var HIDDEN_RECHECK_MS = 250;
 var METER_FLOOR_DB = -120;
@@ -1586,6 +1604,11 @@ function useTrackMeter(handle, trackId) {
     }
     const update = () => {
       const level = handle.getLevel(trackId);
+      const dNow = Date.now();
+      if ((meterDiagRLast.get(trackId) ?? 0) < dNow - 3e3) {
+        meterDiagRLast.set(trackId, dNow);
+        console.log(`[MeterDiagR] lookup trackId=${trackId} \u2192 ${level === null ? "MISS (no level for this id)" : "hit"}`);
+      }
       const now = performance.now();
       const dtSec = lastTickRef.current ? Math.max(0, (now - lastTickRef.current) / 1e3) : 0;
       lastTickRef.current = now;
@@ -2287,8 +2310,7 @@ function TrackRow({
                 {
                   "data-testid": "sdk-mute-button",
                   onClick: onMuteToggle,
-                  disabled: isGenerating,
-                  className: `px-1.5 py-0.5 text-xs font-bold rounded transition-colors ${isGenerating ? "bg-sas-panel text-sas-muted/50 cursor-not-allowed" : isMuted ? "bg-red-600 text-white" : "bg-sas-panel-alt text-sas-muted hover:bg-sas-border"}`,
+                  className: `px-1.5 py-0.5 text-xs font-bold rounded transition-colors ${isMuted ? "bg-red-600 text-white" : "bg-sas-panel-alt text-sas-muted hover:bg-sas-border"}`,
                   title: isMuted ? "Unmute track" : "Mute track",
                   children: "M"
                 }
@@ -2539,6 +2561,18 @@ function CrossfadeTrackRow({
 }
 
 // src/crossfade-meta.ts
+function hashString(s) {
+  let h = 5381;
+  for (let i = 0; i < s.length; i++) h = (h << 5) + h ^ s.charCodeAt(i) | 0;
+  return (h >>> 0).toString(36);
+}
+function soundIdentity(snap) {
+  if (!snap) return "";
+  if (snap.kind === "preset") return `p:${hashString(snap.state)}`;
+  if (snap.kind === "sample") return `s:${snap.samplePath}`;
+  if (snap.kind === "instrument") return `i:${snap.instrumentId ?? ""}:${hashString(JSON.stringify(snap.zones))}`;
+  return "";
+}
 var EQUAL_POWER_GAIN = 0.707;
 function asCrossfadeMeta(val) {
   if (!val || typeof val !== "object") return null;
@@ -2688,9 +2722,11 @@ function asFadeMeta(val) {
   const m = val;
   if (m.direction !== "in" && m.direction !== "out") return null;
   if (m.gesture !== "volume" && m.gesture !== "build") return null;
+  const effect = m.effect === "stutter" || m.effect === "chopped" || m.effect === "delay" || m.effect === "fade" ? m.effect : void 0;
   return {
     direction: m.direction,
     gesture: m.gesture,
+    effect,
     sourceTrackDbId: typeof m.sourceTrackDbId === "string" ? m.sourceTrackDbId : "",
     sourceSceneId: typeof m.sourceSceneId === "string" ? m.sourceSceneId : "",
     sourceName: typeof m.sourceName === "string" ? m.sourceName : "",
@@ -2777,6 +2813,7 @@ function FadeTrackRow({
   layer,
   direction,
   gesture,
+  effect,
   sliderPos = 0.5,
   onMuteToggle,
   onSoloToggle,
@@ -2790,7 +2827,8 @@ function FadeTrackRow({
   const [confirmDelete, setConfirmDelete] = import_react11.default.useState(false);
   const leftLabel = direction === "in" ? "(silent)" : layer.sourceName ?? layer.name;
   const rightLabel = direction === "in" ? layer.sourceName ?? layer.name : "(silent)";
-  const badge = direction === "in" ? "\u2197 Fade in" : "\u2198 Fade out";
+  const verb = effect && effect !== "fade" ? effect.charAt(0).toUpperCase() + effect.slice(1) : "Fade";
+  const badge = direction === "in" ? `\u2197 ${verb} in` : `\u2198 ${verb} out`;
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
     "div",
     {
@@ -3525,9 +3563,701 @@ function CrossfadeModal({
   ) });
 }
 
-// src/components/DownloadPackButton.tsx
+// src/components/TransitionDesigner.tsx
+var import_react16 = require("react");
+
+// src/hooks/useTrackReorder.ts
 var import_react15 = require("react");
+function moveItem(arr, from, to) {
+  const next = arr.slice();
+  if (from === to || from < 0 || to < 0 || from >= next.length || to >= next.length) {
+    return next;
+  }
+  const [moved] = next.splice(from, 1);
+  next.splice(to, 0, moved);
+  return next;
+}
+function useTrackReorder({
+  host,
+  items,
+  setItems,
+  getId,
+  onError
+}) {
+  const [draggingIndex, setDraggingIndex] = (0, import_react15.useState)(null);
+  const [dragOverIndex, setDragOverIndex] = (0, import_react15.useState)(null);
+  const fromRef = (0, import_react15.useRef)(null);
+  const itemsRef = (0, import_react15.useRef)(items);
+  itemsRef.current = items;
+  const dragPropsFor = (0, import_react15.useCallback)(
+    (index) => ({
+      handleProps: {
+        draggable: true,
+        onDragStart: (e) => {
+          fromRef.current = index;
+          setDraggingIndex(index);
+          if (e.dataTransfer) {
+            e.dataTransfer.effectAllowed = "move";
+            try {
+              e.dataTransfer.setData("text/plain", String(index));
+            } catch {
+            }
+          }
+        },
+        onDragEnd: () => {
+          fromRef.current = null;
+          setDraggingIndex(null);
+          setDragOverIndex(null);
+        }
+      },
+      rowProps: {
+        onDragEnter: (e) => {
+          if (fromRef.current === null) return;
+          e.preventDefault();
+          setDragOverIndex(index);
+        },
+        onDragOver: (e) => {
+          if (fromRef.current === null) return;
+          e.preventDefault();
+          if (e.dataTransfer) e.dataTransfer.dropEffect = "move";
+          setDragOverIndex((cur) => cur === index ? cur : index);
+        },
+        onDragLeave: () => {
+          setDragOverIndex((cur) => cur === index ? null : cur);
+        },
+        onDrop: (e) => {
+          e.preventDefault();
+          const from = fromRef.current;
+          fromRef.current = null;
+          setDraggingIndex(null);
+          setDragOverIndex(null);
+          if (from === null || from === index) return;
+          const prev = itemsRef.current;
+          const next = moveItem(prev, from, index);
+          setItems(next);
+          const ids = next.map(getId);
+          Promise.resolve(host.reorderTracks(ids)).catch((err) => {
+            setItems(prev);
+            onError?.(err);
+          });
+        }
+      },
+      isDragging: draggingIndex === index,
+      isDragTarget: dragOverIndex === index && draggingIndex !== index
+    }),
+    [host, setItems, getId, onError, draggingIndex, dragOverIndex]
+  );
+  return { dragPropsFor, draggingIndex, dragOverIndex };
+}
+
+// src/transition-designer-meta.ts
+var TRANSITION_DESIGNER_DRAFT_KEY = "transitionDesigner:draft";
+var AUDIO_EFFECTS = ["fade", "stutter", "chopped", "delay"];
+var AUDIO_EFFECT_LABEL = {
+  fade: "Fade",
+  stutter: "Stutter",
+  chopped: "Chopped",
+  delay: "Delay"
+};
+function asAudioEffect(v) {
+  return v === "fade" || v === "stutter" || v === "chopped" || v === "delay" ? v : null;
+}
+function rowType(hasOrigin, hasTarget) {
+  if (hasOrigin && hasTarget) return "crossfade";
+  if (hasOrigin) return "fade-out";
+  if (hasTarget) return "fade-in";
+  return null;
+}
+function asTransitionDesignerDraft(val) {
+  if (!val || typeof val !== "object") return null;
+  const d = val;
+  const clean = (a) => Array.isArray(a) ? a.filter((x) => x === null || typeof x === "string") : [];
+  const cleanEffects = (e) => {
+    const out = {};
+    if (e && typeof e === "object") {
+      for (const [k, v] of Object.entries(e)) {
+        const eff = asAudioEffect(v);
+        if (eff) out[k] = eff;
+      }
+    }
+    return out;
+  };
+  return {
+    originOrder: clean(d.originOrder),
+    targetOrder: clean(d.targetOrder),
+    rowEffects: cleanEffects(d.rowEffects)
+  };
+}
+function reconcileSlots(saved, poolIds) {
+  const pool = new Set(poolIds);
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const slot of saved ?? []) {
+    if (slot === null) {
+      out.push(null);
+      continue;
+    }
+    if (pool.has(slot) && !seen.has(slot)) {
+      out.push(slot);
+      seen.add(slot);
+    }
+  }
+  for (const id of poolIds) {
+    if (!seen.has(id)) {
+      out.push(id);
+      seen.add(id);
+    }
+  }
+  return out;
+}
+function buildRowSlots(originSlots, targetSlots) {
+  const n = Math.max(originSlots.length, targetSlots.length);
+  const rows = [];
+  for (let i = 0; i < n; i++) {
+    const originId = originSlots[i] ?? null;
+    const targetId = targetSlots[i] ?? null;
+    rows.push({ originId, targetId, type: rowType(originId !== null, targetId !== null) });
+  }
+  return rows;
+}
+function normalizeSlots(originSlots, targetSlots) {
+  const rows = buildRowSlots(originSlots, targetSlots).filter(
+    (r) => r.originId !== null || r.targetId !== null
+  );
+  const trimTrailing = (a) => {
+    let end = a.length;
+    while (end > 0 && a[end - 1] === null) end--;
+    return a.slice(0, end);
+  };
+  return {
+    originOrder: trimTrailing(rows.map((r) => r.originId)),
+    targetOrder: trimTrailing(rows.map((r) => r.targetId))
+  };
+}
+function padSlots(slots, n) {
+  if (slots.length >= n) return slots.slice();
+  return [...slots, ...new Array(n - slots.length).fill(null)];
+}
+function padPair(originSlots, targetSlots) {
+  const n = Math.max(originSlots.length, targetSlots.length);
+  return [padSlots(originSlots, n), padSlots(targetSlots, n)];
+}
+function slotsEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+function rowKey(row) {
+  if (row.type === "crossfade") return `xf:${row.originId}|${row.targetId}`;
+  if (row.type === "fade-out") return `fo:${row.originId}`;
+  if (row.type === "fade-in") return `fi:${row.targetId}`;
+  return null;
+}
+function dbIdsFromKeys(keys) {
+  const out = /* @__PURE__ */ new Set();
+  for (const k of keys) {
+    const body = k.slice(3);
+    if (k.startsWith("xf:")) {
+      const sep = body.indexOf("|");
+      out.add(body.slice(0, sep));
+      out.add(body.slice(sep + 1));
+    } else {
+      out.add(body);
+    }
+  }
+  return out;
+}
+
+// src/components/TransitionDesigner.tsx
 var import_jsx_runtime17 = require("react/jsx-runtime");
+var CROSSFADE_ESTIMATE_MS = 15e3;
+var FADE_ESTIMATE_MS = 11e3;
+var CREATE_ALL_CONCURRENCY = 5;
+var TYPE_LABEL = {
+  crossfade: "Crossfade",
+  "fade-out": "Fade out",
+  "fade-in": "Fade in"
+};
+function shortId3(dbId) {
+  return dbId.length > 8 ? dbId.slice(0, 8) : dbId;
+}
+function TransitionDesigner({
+  host,
+  fromSceneId,
+  toSceneId,
+  transitionSceneId,
+  excludeSourceDbIds,
+  onCreateCrossfade,
+  onCreateFade,
+  onCreateAudioTransition,
+  familyLabel,
+  testIdPrefix = "transition-designer"
+}) {
+  const [load, setLoad] = (0, import_react16.useState)({ status: "loading" });
+  const [fromName, setFromName] = (0, import_react16.useState)(null);
+  const [toName, setToName] = (0, import_react16.useState)(null);
+  const [originSlots, setOriginSlots] = (0, import_react16.useState)([]);
+  const [targetSlots, setTargetSlots] = (0, import_react16.useState)([]);
+  const [creatingKeys, setCreatingKeys] = (0, import_react16.useState)(() => /* @__PURE__ */ new Set());
+  const [rowErrors, setRowErrors] = (0, import_react16.useState)({});
+  const [rowEffects, setRowEffects] = (0, import_react16.useState)({});
+  const rowEffectsRef = (0, import_react16.useRef)(rowEffects);
+  rowEffectsRef.current = rowEffects;
+  const audioEffectsEnabled = !!onCreateAudioTransition;
+  const excludeRef = (0, import_react16.useRef)(excludeSourceDbIds);
+  excludeRef.current = excludeSourceDbIds;
+  const originSlotsRef = (0, import_react16.useRef)(originSlots);
+  originSlotsRef.current = originSlots;
+  const targetSlotsRef = (0, import_react16.useRef)(targetSlots);
+  targetSlotsRef.current = targetSlots;
+  const creatingKeysRef = (0, import_react16.useRef)(creatingKeys);
+  creatingKeysRef.current = creatingKeys;
+  const dragRef = (0, import_react16.useRef)(null);
+  const [dragging, setDragging] = (0, import_react16.useState)(null);
+  const [dragOver, setDragOver] = (0, import_react16.useState)(null);
+  const excludeSet = (0, import_react16.useMemo)(() => new Set(excludeSourceDbIds ?? []), [excludeSourceDbIds]);
+  const originPool = (0, import_react16.useMemo)(
+    () => load.status === "ready" ? load.origin.filter((t) => !excludeSet.has(t.dbId)) : [],
+    [load, excludeSet]
+  );
+  const targetPool = (0, import_react16.useMemo)(
+    () => load.status === "ready" ? load.target.filter((t) => !excludeSet.has(t.dbId)) : [],
+    [load, excludeSet]
+  );
+  const originById = (0, import_react16.useMemo)(() => new Map(originPool.map((t) => [t.dbId, t])), [originPool]);
+  const targetById = (0, import_react16.useMemo)(() => new Map(targetPool.map((t) => [t.dbId, t])), [targetPool]);
+  const originByIdRef = (0, import_react16.useRef)(originById);
+  originByIdRef.current = originById;
+  const targetByIdRef = (0, import_react16.useRef)(targetById);
+  targetByIdRef.current = targetById;
+  const refresh = (0, import_react16.useCallback)(async () => {
+    if (!host.listSceneFamilyTracks) {
+      setLoad({ status: "error", message: "This host does not support transition tracks." });
+      return;
+    }
+    setLoad({ status: "loading" });
+    try {
+      const [origin, target, fName, tName, draftRaw] = await Promise.all([
+        host.listSceneFamilyTracks(fromSceneId),
+        host.listSceneFamilyTracks(toSceneId),
+        host.getSceneName ? host.getSceneName(fromSceneId) : Promise.resolve(null),
+        host.getSceneName ? host.getSceneName(toSceneId) : Promise.resolve(null),
+        host.getSceneData ? host.getSceneData(transitionSceneId, TRANSITION_DESIGNER_DRAFT_KEY) : Promise.resolve(null)
+      ]);
+      const draft = asTransitionDesignerDraft(draftRaw);
+      const exSet = new Set(excludeRef.current ?? []);
+      const originIds = origin.filter((t) => !exSet.has(t.dbId)).map((t) => t.dbId);
+      const targetIds = target.filter((t) => !exSet.has(t.dbId)).map((t) => t.dbId);
+      const [po, pt] = padPair(
+        reconcileSlots(draft?.originOrder, originIds),
+        reconcileSlots(draft?.targetOrder, targetIds)
+      );
+      setOriginSlots(po);
+      setTargetSlots(pt);
+      setRowEffects(draft?.rowEffects ?? {});
+      setFromName(fName);
+      setToName(tName);
+      setLoad({ status: "ready", origin, target });
+    } catch (err) {
+      setLoad({
+        status: "error",
+        message: err instanceof Error ? err.message : "Failed to load tracks."
+      });
+    }
+  }, [host, fromSceneId, toSceneId, transitionSceneId]);
+  (0, import_react16.useEffect)(() => {
+    void refresh();
+  }, [refresh]);
+  (0, import_react16.useEffect)(() => {
+    if (load.status !== "ready") return;
+    const [po, pt] = padPair(
+      reconcileSlots(originSlotsRef.current, originPool.map((t) => t.dbId)),
+      reconcileSlots(targetSlotsRef.current, targetPool.map((t) => t.dbId))
+    );
+    if (!slotsEqual(po, originSlotsRef.current)) setOriginSlots(po);
+    if (!slotsEqual(pt, targetSlotsRef.current)) setTargetSlots(pt);
+  }, [originPool, targetPool, load.status]);
+  const mutate = (0, import_react16.useCallback)(
+    (nextOrigin, nextTarget) => {
+      const norm = normalizeSlots(nextOrigin, nextTarget);
+      const [po, pt] = padPair(norm.originOrder, norm.targetOrder);
+      setOriginSlots(po);
+      setTargetSlots(pt);
+      if (host.setSceneData) {
+        host.setSceneData(transitionSceneId, TRANSITION_DESIGNER_DRAFT_KEY, { ...norm, rowEffects: rowEffectsRef.current }).catch(() => {
+        });
+      }
+    },
+    [host, transitionSceneId]
+  );
+  const setRowEffect = (0, import_react16.useCallback)(
+    (sourceDbId, effect) => {
+      setRowEffects((prev) => {
+        const next = { ...prev, [sourceDbId]: effect };
+        if (host.setSceneData) {
+          const norm = normalizeSlots(originSlotsRef.current, targetSlotsRef.current);
+          host.setSceneData(transitionSceneId, TRANSITION_DESIGNER_DRAFT_KEY, { ...norm, rowEffects: next }).catch(() => {
+          });
+        }
+        return next;
+      });
+    },
+    [host, transitionSceneId]
+  );
+  const insertGapAbove = (0, import_react16.useCallback)(
+    (col, index) => {
+      const slots = col === "origin" ? originSlots : targetSlots;
+      const next = [...slots.slice(0, index), null, ...slots.slice(index)];
+      if (col === "origin") mutate(next, targetSlots);
+      else mutate(originSlots, next);
+    },
+    [originSlots, targetSlots, mutate]
+  );
+  const removeGap = (0, import_react16.useCallback)(
+    (col, index) => {
+      const slots = col === "origin" ? originSlots : targetSlots;
+      const next = slots.filter((_, i) => i !== index);
+      if (col === "origin") mutate(next, targetSlots);
+      else mutate(originSlots, next);
+    },
+    [originSlots, targetSlots, mutate]
+  );
+  const handleDrop = (0, import_react16.useCallback)(
+    (col, to) => {
+      const from = dragRef.current;
+      dragRef.current = null;
+      setDragging(null);
+      setDragOver(null);
+      if (!from || from.col !== col || from.index === to) return;
+      if (col === "origin") mutate(moveItem(originSlots, from.index, to), targetSlots);
+      else mutate(originSlots, moveItem(targetSlots, from.index, to));
+    },
+    [originSlots, targetSlots, mutate]
+  );
+  const rows = (0, import_react16.useMemo)(() => buildRowSlots(originSlots, targetSlots), [originSlots, targetSlots]);
+  const creatingDbIds = (0, import_react16.useMemo)(() => dbIdsFromKeys(creatingKeys), [creatingKeys]);
+  const eligibleCount = (0, import_react16.useMemo)(
+    () => rows.filter((r) => {
+      const k = rowKey(r);
+      return k !== null && !creatingKeys.has(k);
+    }).length,
+    [rows, creatingKeys]
+  );
+  const createRow = (0, import_react16.useCallback)(
+    async (row) => {
+      const key = rowKey(row);
+      if (!key || !row.type || creatingKeysRef.current.has(key)) return;
+      setCreatingKeys((prev) => new Set(prev).add(key));
+      setRowErrors((prev) => {
+        if (!(key in prev)) return prev;
+        const next = { ...prev };
+        delete next[key];
+        return next;
+      });
+      try {
+        if (row.type === "crossfade") {
+          const o = row.originId ? originByIdRef.current.get(row.originId) : void 0;
+          const t = row.targetId ? targetByIdRef.current.get(row.targetId) : void 0;
+          if (!o || !t) throw new Error("Track is no longer available \u2014 refresh and retry.");
+          await onCreateCrossfade(
+            { dbId: o.dbId, name: o.name, role: o.role },
+            { dbId: t.dbId, name: t.name, role: t.role }
+          );
+        } else if (row.type === "fade-out") {
+          const o = row.originId ? originByIdRef.current.get(row.originId) : void 0;
+          if (!o) throw new Error("Track is no longer available \u2014 refresh and retry.");
+          const eff = rowEffectsRef.current[o.dbId] ?? "fade";
+          if (eff !== "fade" && onCreateAudioTransition) {
+            await onCreateAudioTransition({ dbId: o.dbId, name: o.name, role: o.role }, "out", eff);
+          } else {
+            await onCreateFade({ dbId: o.dbId, name: o.name, role: o.role }, "out", defaultFadeGesture(o.role));
+          }
+        } else {
+          const t = row.targetId ? targetByIdRef.current.get(row.targetId) : void 0;
+          if (!t) throw new Error("Track is no longer available \u2014 refresh and retry.");
+          const eff = rowEffectsRef.current[t.dbId] ?? "fade";
+          if (eff !== "fade" && onCreateAudioTransition) {
+            await onCreateAudioTransition({ dbId: t.dbId, name: t.name, role: t.role }, "in", eff);
+          } else {
+            await onCreateFade({ dbId: t.dbId, name: t.name, role: t.role }, "in", defaultFadeGesture(t.role));
+          }
+        }
+      } catch (err) {
+        setRowErrors((prev) => ({
+          ...prev,
+          [key]: err instanceof Error ? err.message : "Failed to create transition."
+        }));
+      } finally {
+        setCreatingKeys((prev) => {
+          const next = new Set(prev);
+          next.delete(key);
+          return next;
+        });
+      }
+    },
+    [onCreateCrossfade, onCreateFade, onCreateAudioTransition]
+  );
+  const createAll = (0, import_react16.useCallback)(async () => {
+    const eligible = buildRowSlots(originSlotsRef.current, targetSlotsRef.current).filter((r) => {
+      const k = rowKey(r);
+      return k !== null && !creatingKeysRef.current.has(k);
+    });
+    if (eligible.length === 0) return;
+    let cursor = 0;
+    const worker = async () => {
+      while (cursor < eligible.length) {
+        const row = eligible[cursor];
+        cursor += 1;
+        await createRow(row);
+      }
+    };
+    await Promise.all(
+      Array.from({ length: Math.min(CREATE_ALL_CONCURRENCY, eligible.length) }, () => worker())
+    );
+  }, [createRow]);
+  const fromLabel = fromName ?? "origin";
+  const toLabel = toName ?? "target";
+  const cellDragProps = (col, index, locked) => ({
+    draggable: !locked,
+    onDragStart: (e) => {
+      if (locked) return;
+      dragRef.current = { col, index };
+      setDragging({ col, index });
+      if (e.dataTransfer) {
+        e.dataTransfer.effectAllowed = "move";
+        try {
+          e.dataTransfer.setData("text/plain", String(index));
+        } catch {
+        }
+      }
+    },
+    onDragEnd: () => {
+      dragRef.current = null;
+      setDragging(null);
+      setDragOver(null);
+    },
+    onDragEnter: (e) => {
+      const d = dragRef.current;
+      if (!d || d.col !== col) return;
+      e.preventDefault();
+      setDragOver({ col, index });
+    },
+    onDragOver: (e) => {
+      const d = dragRef.current;
+      if (!d || d.col !== col) return;
+      e.preventDefault();
+      if (e.dataTransfer) e.dataTransfer.dropEffect = "move";
+    },
+    onDragLeave: () => {
+      setDragOver((cur) => cur && cur.col === col && cur.index === index ? null : cur);
+    },
+    onDrop: (e) => {
+      e.preventDefault();
+      handleDrop(col, index);
+    }
+  });
+  const renderCell = (col, index, slotId) => {
+    const byId = col === "origin" ? originById : targetById;
+    const track = slotId ? byId.get(slotId) : void 0;
+    const locked = slotId !== null && creatingDbIds.has(slotId);
+    const isDragging = dragging?.col === col && dragging.index === index;
+    const isDragTarget = dragOver?.col === col && dragOver.index === index && !isDragging;
+    const base = "group relative rounded-sm border px-2 py-1.5 text-left transition-colors select-none";
+    const tone = isDragTarget ? "border-sas-accent bg-sas-accent/10" : "border-sas-border bg-sas-panel";
+    if (slotId === null) {
+      return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
+        "div",
+        {
+          ...cellDragProps(col, index, false),
+          "data-testid": `${testIdPrefix}-${col}-gap-${index}`,
+          className: `${base} ${tone} border-dashed flex items-center justify-between ${isDragging ? "opacity-40" : "opacity-70"}`,
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: "\u2014 gap \u2014" }),
+            /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+              "button",
+              {
+                type: "button",
+                "data-testid": `${testIdPrefix}-${col}-remove-gap-${index}`,
+                onClick: () => removeGap(col, index),
+                title: "Remove gap",
+                className: "text-[10px] text-sas-muted hover:text-sas-danger",
+                children: "\u2715"
+              }
+            )
+          ]
+        }
+      );
+    }
+    const primary = track ? track.prompt?.trim() || track.name : slotId;
+    const meta = track ? [track.role, shortId3(track.dbId)].filter(Boolean).join(" \xB7 ") : "missing";
+    return /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+      "div",
+      {
+        ...cellDragProps(col, index, locked),
+        "data-testid": `${testIdPrefix}-${col}-cell-${slotId}`,
+        "data-value": slotId,
+        className: `${base} ${tone} ${isDragging ? "opacity-40" : ""} ${locked ? "opacity-60" : "cursor-grab active:cursor-grabbing"}`,
+        title: track ? track.dbId : "Track no longer available",
+        children: /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "flex items-start gap-1", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-sas-muted/60 text-xs leading-tight pt-0.5", "aria-hidden": true, children: "\u283F" }),
+          /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "min-w-0 flex-1", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "text-xs text-sas-text truncate", children: primary }),
+            meta && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "text-[10px] text-sas-muted truncate mt-0.5", children: meta })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+            "button",
+            {
+              type: "button",
+              "data-testid": `${testIdPrefix}-${col}-insert-gap-${index}`,
+              onClick: () => insertGapAbove(col, index),
+              disabled: locked,
+              title: "Insert a gap above (make this a fade)",
+              className: "text-[10px] text-sas-muted opacity-0 group-hover:opacity-100 hover:text-sas-accent disabled:opacity-30",
+              children: "+gap"
+            }
+          )
+        ] })
+      }
+    );
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "space-y-2", "data-testid": `${testIdPrefix}-box`, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "flex items-center justify-between gap-3 pb-1 border-b border-sas-border", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("p", { className: "text-[11px] text-sas-muted leading-snug min-w-0", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-sas-text", children: fromLabel }),
+        " \u2192",
+        " ",
+        /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-sas-text", children: toLabel }),
+        familyLabel ? ` \xB7 ${familyLabel}` : "",
+        " \xB7 line up a track on each side to crossfade; leave one blank (or insert a gap) to fade."
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "flex items-center gap-2 shrink-0", children: [
+        creatingKeys.size > 0 && /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "text-[10px] text-sas-accent whitespace-nowrap", "data-testid": `${testIdPrefix}-creating-count`, children: [
+          creatingKeys.size,
+          " creating\u2026"
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
+          "button",
+          {
+            type: "button",
+            "data-testid": `${testIdPrefix}-create-all`,
+            onClick: createAll,
+            disabled: eligibleCount === 0,
+            title: "Create every staged transition at once (runs several concurrently)",
+            className: `px-2 py-0.5 text-[10px] font-medium rounded-sm border transition-colors whitespace-nowrap ${eligibleCount > 0 ? "bg-sas-accent/20 border-sas-accent text-sas-accent hover:bg-sas-accent hover:text-sas-bg" : "bg-sas-panel border-sas-border text-sas-muted/50 cursor-not-allowed"}`,
+            children: [
+              "Create all",
+              eligibleCount > 0 ? ` (${eligibleCount})` : ""
+            ]
+          }
+        )
+      ] })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "grid grid-cols-[1fr_auto_1fr] gap-2", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted truncate", children: [
+        "Origin (",
+        fromLabel,
+        ")"
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted text-center px-2", children: "Transition" }),
+      /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted truncate text-right", children: [
+        "Target (",
+        toLabel,
+        ")"
+      ] })
+    ] }),
+    load.status === "loading" && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "text-xs text-sas-muted py-6 text-center", children: "Loading tracks\u2026" }),
+    load.status === "error" && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "text-xs text-sas-danger py-6 text-center", "data-testid": `${testIdPrefix}-error`, children: load.message }),
+    load.status === "ready" && (rows.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "text-xs text-sas-muted py-6 text-center", "data-testid": `${testIdPrefix}-empty`, children: [
+      "No tracks to arrange in this panel for either scene. Add tracks to ",
+      fromLabel,
+      " or ",
+      toLabel,
+      " ",
+      "first (or free one by deleting an existing crossfade/fade)."
+    ] }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "space-y-2", children: rows.map((row, i) => {
+      const key = rowKey(row);
+      const isCreatingThis = key !== null && creatingKeys.has(key);
+      const errMsg = key !== null ? rowErrors[key] : void 0;
+      return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
+        "div",
+        {
+          "data-testid": `${testIdPrefix}-row-${i}`,
+          className: "grid grid-cols-[1fr_auto_1fr] gap-2 items-center",
+          children: [
+            renderCell("origin", i, row.originId),
+            /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "w-[160px] flex flex-col items-center gap-1", children: [
+              !row.type ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-[10px] text-sas-muted/50", children: "\u2014" }) : row.type === "crossfade" ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                "span",
+                {
+                  "data-testid": `${testIdPrefix}-type-${i}`,
+                  className: "text-[10px] font-medium px-1.5 py-0.5 rounded-sm border border-sas-accent/50 text-sas-accent",
+                  children: TYPE_LABEL[row.type]
+                }
+              ) : audioEffectsEnabled ? /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { className: "flex items-center gap-1", "data-testid": `${testIdPrefix}-type-${i}`, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                  "select",
+                  {
+                    "data-testid": `${testIdPrefix}-effect-${i}`,
+                    value: rowEffects[row.originId ?? row.targetId] ?? "fade",
+                    onChange: (e) => {
+                      const id = row.originId ?? row.targetId;
+                      if (id) setRowEffect(id, e.target.value);
+                    },
+                    className: "text-[10px] bg-sas-panel border border-sas-border rounded-sm px-1 py-0.5 text-sas-text",
+                    children: AUDIO_EFFECTS.map((eff) => /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("option", { value: eff, children: AUDIO_EFFECT_LABEL[eff] }, eff))
+                  }
+                ),
+                /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("span", { className: "text-[9px] text-sas-muted", children: row.type === "fade-out" ? "out" : "in" })
+              ] }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                "span",
+                {
+                  "data-testid": `${testIdPrefix}-type-${i}`,
+                  className: "text-[10px] font-medium px-1.5 py-0.5 rounded-sm border border-sas-border text-sas-muted",
+                  children: TYPE_LABEL[row.type]
+                }
+              ),
+              isCreatingThis ? /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "w-full", children: /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                SorceryProgressBar,
+                {
+                  isLoading: true,
+                  heightClass: "h-5",
+                  statusText: "CREATING",
+                  estimatedDurationMs: row.type === "crossfade" ? CROSSFADE_ESTIMATE_MS : FADE_ESTIMATE_MS
+                }
+              ) }) : /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                "button",
+                {
+                  type: "button",
+                  "data-testid": `${testIdPrefix}-create-${i}`,
+                  onClick: () => createRow(row),
+                  disabled: !row.type,
+                  className: `w-full px-2 py-0.5 text-[10px] font-medium rounded-sm border transition-colors ${row.type ? "bg-sas-accent/20 border-sas-accent text-sas-accent hover:bg-sas-accent hover:text-sas-bg" : "bg-sas-panel border-sas-border text-sas-muted/50 cursor-not-allowed"}`,
+                  children: "Create"
+                }
+              ),
+              errMsg && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+                "span",
+                {
+                  "data-testid": `${testIdPrefix}-row-error-${i}`,
+                  className: "text-[10px] text-sas-danger text-center leading-tight",
+                  children: errMsg
+                }
+              )
+            ] }),
+            renderCell("target", i, row.targetId)
+          ]
+        },
+        i
+      );
+    }) }))
+  ] });
+}
+
+// src/components/DownloadPackButton.tsx
+var import_react17 = require("react");
+var import_jsx_runtime18 = require("react/jsx-runtime");
 function formatSize(bytes) {
   if (!bytes || bytes <= 0) return "";
   const gb = bytes / 1024 ** 3;
@@ -3543,10 +4273,10 @@ var DownloadPackButton = ({
   variant = "compact",
   onDownloadComplete
 }) => {
-  const [status, setStatus] = (0, import_react15.useState)("idle");
-  const [progress, setProgress] = (0, import_react15.useState)(0);
-  const [errorMessage, setErrorMessage] = (0, import_react15.useState)(null);
-  (0, import_react15.useEffect)(() => {
+  const [status, setStatus] = (0, import_react17.useState)("idle");
+  const [progress, setProgress] = (0, import_react17.useState)(0);
+  const [errorMessage, setErrorMessage] = (0, import_react17.useState)(null);
+  (0, import_react17.useEffect)(() => {
     const unsub = host.onSamplePackProgress(packId, (p) => {
       setStatus(p.status);
       setProgress(p.progress);
@@ -3561,7 +4291,7 @@ var DownloadPackButton = ({
     });
     return unsub;
   }, [host, packId, onDownloadComplete]);
-  const handleClick = (0, import_react15.useCallback)(async () => {
+  const handleClick = (0, import_react17.useCallback)(async () => {
     if (status !== "idle" && status !== "error") return;
     try {
       setStatus("downloading");
@@ -3615,8 +4345,8 @@ var DownloadPackButton = ({
   } else {
     className = `${baseClasses} text-sas-muted hover:text-sas-accent border-sas-border hover:border-sas-accent`;
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)("div", { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime17.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
       "button",
       {
         "data-testid": `download-pack-button-${packId}`,
@@ -3627,12 +4357,12 @@ var DownloadPackButton = ({
         children: buttonLabel
       }
     ),
-    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ (0, import_jsx_runtime17.jsx)("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
+    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
   ] });
 };
 
 // src/components/SamplePackCTACard.tsx
-var import_jsx_runtime18 = require("react/jsx-runtime");
+var import_jsx_runtime19 = require("react/jsx-runtime");
 var SamplePackCTACard = ({
   host,
   pack,
@@ -3640,7 +4370,7 @@ var SamplePackCTACard = ({
   onDownloadComplete
 }) => {
   if (status === "checking") {
-    return /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+    return /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
       "div",
       {
         "data-testid": `sample-pack-cta-checking-${pack.packId}`,
@@ -3651,16 +4381,16 @@ var SamplePackCTACard = ({
   }
   const headline = status === "stale" ? `${pack.displayName} update available` : `${pack.displayName} not installed`;
   const sublabel = status === "stale" ? `A newer version is available for download.` : pack.description;
-  return /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)(
     "div",
     {
       "data-testid": `sample-pack-cta-${pack.packId}`,
       className: "flex flex-col items-center justify-center py-12 px-6 text-center",
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
-        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "text-base text-sas-text mb-1", children: headline }),
-        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
-        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
+        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { className: "text-base text-sas-text mb-1", children: headline }),
+        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
+        /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
           DownloadPackButton,
           {
             host,
@@ -3677,7 +4407,7 @@ var SamplePackCTACard = ({
 };
 
 // src/components/WaveformView.tsx
-var import_react16 = require("react");
+var import_react18 = require("react");
 
 // src/components/waveform.ts
 function computePeaks(audioBuffer, bins, targetSamples) {
@@ -3740,7 +4470,7 @@ function drawWaveform(canvas, peaks, options = {}) {
 }
 
 // src/components/WaveformView.tsx
-var import_jsx_runtime19 = require("react/jsx-runtime");
+var import_jsx_runtime20 = require("react/jsx-runtime");
 var WaveformView = ({
   host,
   filePath,
@@ -3749,9 +4479,9 @@ var WaveformView = ({
   fillStyle,
   targetSamples
 }) => {
-  const canvasRef = (0, import_react16.useRef)(null);
-  const [peaks, setPeaks] = (0, import_react16.useState)(null);
-  (0, import_react16.useEffect)(() => {
+  const canvasRef = (0, import_react18.useRef)(null);
+  const [peaks, setPeaks] = (0, import_react18.useState)(null);
+  (0, import_react18.useEffect)(() => {
     let cancelled = false;
     let audioContext = null;
     (async () => {
@@ -3777,7 +4507,7 @@ var WaveformView = ({
       cancelled = true;
     };
   }, [host, filePath, bins, targetSamples]);
-  (0, import_react16.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (!peaks) return;
     const canvas = canvasRef.current;
     if (!canvas) return;
@@ -3788,7 +4518,7 @@ var WaveformView = ({
     observer.observe(canvas);
     return () => observer.disconnect();
   }, [peaks, fillStyle]);
-  return /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
     "canvas",
     {
       ref: canvasRef,
@@ -3799,8 +4529,8 @@ var WaveformView = ({
 };
 
 // src/components/ScrollingWaveform.tsx
-var import_react17 = require("react");
-var import_jsx_runtime20 = require("react/jsx-runtime");
+var import_react19 = require("react");
+var import_jsx_runtime21 = require("react/jsx-runtime");
 var ScrollingWaveform = ({
   getPeakDb,
   active,
@@ -3808,11 +4538,11 @@ var ScrollingWaveform = ({
   className,
   fillStyle
 }) => {
-  const canvasRef = (0, import_react17.useRef)(null);
-  const ringRef = (0, import_react17.useRef)(new Float32Array(columns));
-  const writeIdxRef = (0, import_react17.useRef)(0);
-  const rafRef = (0, import_react17.useRef)(null);
-  (0, import_react17.useEffect)(() => {
+  const canvasRef = (0, import_react19.useRef)(null);
+  const ringRef = (0, import_react19.useRef)(new Float32Array(columns));
+  const writeIdxRef = (0, import_react19.useRef)(0);
+  const rafRef = (0, import_react19.useRef)(null);
+  (0, import_react19.useEffect)(() => {
     if (ringRef.current.length !== columns) {
       const next = new Float32Array(columns);
       const prev = ringRef.current;
@@ -3824,7 +4554,7 @@ var ScrollingWaveform = ({
       writeIdxRef.current = writeIdxRef.current % columns;
     }
   }, [columns]);
-  (0, import_react17.useEffect)(() => {
+  (0, import_react19.useEffect)(() => {
     if (!active) {
       if (rafRef.current !== null) {
         cancelAnimationFrame(rafRef.current);
@@ -3876,7 +4606,7 @@ var ScrollingWaveform = ({
       }
     };
   }, [active, getPeakDb, fillStyle]);
-  return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+  return /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
     "canvas",
     {
       ref: canvasRef,
@@ -3887,8 +4617,8 @@ var ScrollingWaveform = ({
 };
 
 // src/components/OffsetScrubber.tsx
-var import_react18 = require("react");
-var import_jsx_runtime21 = require("react/jsx-runtime");
+var import_react20 = require("react");
+var import_jsx_runtime22 = require("react/jsx-runtime");
 var SLIDER_HEIGHT_PX = 28;
 var TICK_HEIGHT_PX = 14;
 var DOWNBEAT_TICK_HEIGHT_PX = 22;
@@ -3901,40 +4631,40 @@ function OffsetScrubber({
   onChange,
   disabled = false
 }) {
-  const trackRef = (0, import_react18.useRef)(null);
-  const [draftOffset, setDraftOffset] = (0, import_react18.useState)(offsetSamples);
-  const [isDragging, setIsDragging] = (0, import_react18.useState)(false);
-  (0, import_react18.useEffect)(() => {
+  const trackRef = (0, import_react20.useRef)(null);
+  const [draftOffset, setDraftOffset] = (0, import_react20.useState)(offsetSamples);
+  const [isDragging, setIsDragging] = (0, import_react20.useState)(false);
+  (0, import_react20.useEffect)(() => {
     if (!isDragging) setDraftOffset(offsetSamples);
   }, [offsetSamples, isDragging]);
   const sampleRate = cuePoints?.sample_rate ?? 44100;
   const detectedBpm = cuePoints?.detected_bpm ?? projectBpm;
-  const beatsForRange = (0, import_react18.useMemo)(() => {
+  const beatsForRange = (0, import_react20.useMemo)(() => {
     return Math.round(60 / projectBpm * sampleRate);
   }, [projectBpm, sampleRate]);
   const rangeSamples = beatsForRange * meter;
-  const sampleToFraction = (0, import_react18.useCallback)(
+  const sampleToFraction = (0, import_react20.useCallback)(
     (sample) => {
       const clamped = Math.max(-rangeSamples, Math.min(rangeSamples, sample));
       return (clamped + rangeSamples) / (2 * rangeSamples);
     },
     [rangeSamples]
   );
-  const fractionToSample = (0, import_react18.useCallback)(
+  const fractionToSample = (0, import_react20.useCallback)(
     (fraction) => {
       const clamped = Math.max(0, Math.min(1, fraction));
       return Math.round(clamped * 2 * rangeSamples - rangeSamples);
     },
     [rangeSamples]
   );
-  const snapTargets = (0, import_react18.useMemo)(() => {
+  const snapTargets = (0, import_react20.useMemo)(() => {
     if (!cuePoints || cuePoints.beats.length === 0) return [];
     const downbeat = cuePoints.beats[0];
     const positives = cuePoints.beats.map((b) => b - downbeat);
     const negatives = positives.slice(1).map((p) => -p);
     return [...negatives, ...positives].sort((a, b) => a - b);
   }, [cuePoints]);
-  const snapToBeat = (0, import_react18.useCallback)(
+  const snapToBeat = (0, import_react20.useCallback)(
     (sample) => {
       if (snapTargets.length === 0) return sample;
       let best = snapTargets[0];
@@ -3950,7 +4680,7 @@ function OffsetScrubber({
     },
     [snapTargets]
   );
-  const handlePointerDown = (0, import_react18.useCallback)(
+  const handlePointerDown = (0, import_react20.useCallback)(
     (e) => {
       if (disabled || !cuePoints) return;
       e.preventDefault();
@@ -3984,7 +4714,7 @@ function OffsetScrubber({
     },
     [disabled, cuePoints, fractionToSample, onChange, snapToBeat]
   );
-  const handleResetToZero = (0, import_react18.useCallback)(() => {
+  const handleResetToZero = (0, import_react20.useCallback)(() => {
     if (disabled) return;
     setDraftOffset(0);
     onChange(0);
@@ -3992,7 +4722,7 @@ function OffsetScrubber({
   const thumbFraction = sampleToFraction(draftOffset);
   const thumbLeftPct = `${(thumbFraction * 100).toFixed(2)}%`;
   const bpmMismatch = cuePoints?.detected_bpm != null && Math.abs(cuePoints.detected_bpm - projectBpm) > 1;
-  const ticks = (0, import_react18.useMemo)(() => {
+  const ticks = (0, import_react20.useMemo)(() => {
     if (!cuePoints) return [];
     const downbeat = cuePoints.beats[0] ?? 0;
     return cuePoints.beats.map((b, i) => {
@@ -4003,9 +4733,9 @@ function OffsetScrubber({
     });
   }, [cuePoints, sampleToFraction]);
   const isDisabled = disabled || !cuePoints || cuePoints.beats.length === 0;
-  return /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)("div", { "data-testid": "offset-scrubber", className: "flex items-center gap-2 w-full", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("div", { "data-testid": "offset-scrubber", className: "flex items-center gap-2 w-full", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(
       "div",
       {
         ref: trackRef,
@@ -4021,7 +4751,7 @@ function OffsetScrubber({
         "aria-valuenow": draftOffset,
         "aria-disabled": isDisabled,
         children: [
-          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
             "div",
             {
               "aria-hidden": "true",
@@ -4029,7 +4759,7 @@ function OffsetScrubber({
               style: { left: "50%" }
             }
           ),
-          ticks.map((t) => /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          ticks.map((t) => /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
             "div",
             {
               "data-testid": t.isDownbeat ? "offset-tick-downbeat" : "offset-tick",
@@ -4044,7 +4774,7 @@ function OffsetScrubber({
             },
             t.i
           )),
-          /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+          /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
             "div",
             {
               "data-testid": "offset-scrubber-thumb",
@@ -4061,7 +4791,7 @@ function OffsetScrubber({
         ]
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
       "span",
       {
         "data-testid": "offset-scrubber-readout",
@@ -4069,7 +4799,7 @@ function OffsetScrubber({
         children: formatOffset(draftOffset, sampleRate)
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
       "button",
       {
         type: "button",
@@ -4081,7 +4811,7 @@ function OffsetScrubber({
         children: "\u2316"
       }
     ),
-    bpmMismatch && /* @__PURE__ */ (0, import_jsx_runtime21.jsx)(
+    bpmMismatch && /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(
       "span",
       {
         "data-testid": "offset-bpm-mismatch",
@@ -4153,13 +4883,13 @@ function synthesizeCuePoints({
 }
 
 // src/hooks/useSceneState.ts
-var import_react19 = require("react");
+var import_react21 = require("react");
 function useSceneState(activeSceneId, initialValue) {
-  const [stateMap, setStateMap] = (0, import_react19.useState)(() => /* @__PURE__ */ new Map());
-  const activeSceneIdRef = (0, import_react19.useRef)(activeSceneId);
+  const [stateMap, setStateMap] = (0, import_react21.useState)(() => /* @__PURE__ */ new Map());
+  const activeSceneIdRef = (0, import_react21.useRef)(activeSceneId);
   activeSceneIdRef.current = activeSceneId;
   const currentValue = activeSceneId !== null && stateMap.has(activeSceneId) ? stateMap.get(activeSceneId) : initialValue;
-  const setForCurrentScene = (0, import_react19.useCallback)((value) => {
+  const setForCurrentScene = (0, import_react21.useCallback)((value) => {
     const sid = activeSceneIdRef.current;
     if (sid === null) return;
     setStateMap((prev) => {
@@ -4170,7 +4900,7 @@ function useSceneState(activeSceneId, initialValue) {
       return newMap;
     });
   }, [initialValue]);
-  const setForScene = (0, import_react19.useCallback)((sceneId, value) => {
+  const setForScene = (0, import_react21.useCallback)((sceneId, value) => {
     setStateMap((prev) => {
       const current = prev.has(sceneId) ? prev.get(sceneId) : initialValue;
       const next = typeof value === "function" ? value(current) : value;
@@ -4183,10 +4913,10 @@ function useSceneState(activeSceneId, initialValue) {
 }
 
 // src/hooks/useAnySolo.ts
-var import_react20 = require("react");
+var import_react22 = require("react");
 function useAnySolo(host) {
-  const [anySolo, setAnySolo] = (0, import_react20.useState)(false);
-  (0, import_react20.useEffect)(() => {
+  const [anySolo, setAnySolo] = (0, import_react22.useState)(false);
+  (0, import_react22.useEffect)(() => {
     let active = true;
     const refresh = () => {
       host.isAnySoloActive().then((v) => {
@@ -4205,7 +4935,7 @@ function useAnySolo(host) {
 }
 
 // src/hooks/useSoundHistory.ts
-var import_react21 = require("react");
+var import_react23 = require("react");
 var EMPTY = { entries: [], cursor: -1 };
 function sameDescriptor(a, b) {
   if (a === b) return true;
@@ -4217,14 +4947,14 @@ function sameDescriptor(a, b) {
 }
 function useSoundHistory(applySound, opts = {}) {
   const max = Math.max(2, opts.max ?? 24);
-  const applyRef = (0, import_react21.useRef)(applySound);
+  const applyRef = (0, import_react23.useRef)(applySound);
   applyRef.current = applySound;
-  const onChangeRef = (0, import_react21.useRef)(opts.onChange);
+  const onChangeRef = (0, import_react23.useRef)(opts.onChange);
   onChangeRef.current = opts.onChange;
-  const dataRef = (0, import_react21.useRef)({});
-  const [, setVersion] = (0, import_react21.useState)(0);
-  const bump = (0, import_react21.useCallback)(() => setVersion((v) => v + 1), []);
-  const commit = (0, import_react21.useCallback)(
+  const dataRef = (0, import_react23.useRef)({});
+  const [, setVersion] = (0, import_react23.useState)(0);
+  const bump = (0, import_react23.useCallback)(() => setVersion((v) => v + 1), []);
+  const commit = (0, import_react23.useCallback)(
     (trackId, next, notify) => {
       dataRef.current = { ...dataRef.current, [trackId]: next };
       bump();
@@ -4232,7 +4962,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [bump]
   );
-  const record = (0, import_react21.useCallback)(
+  const record = (0, import_react23.useCallback)(
     (trackId, descriptor, label) => {
       const h = dataRef.current[trackId];
       const current = h && h.cursor >= 0 ? h.entries[h.cursor] : void 0;
@@ -4247,7 +4977,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [max, commit]
   );
-  const restoreTo = (0, import_react21.useCallback)(
+  const restoreTo = (0, import_react23.useCallback)(
     async (trackId, index) => {
       const h = dataRef.current[trackId];
       if (!h || index < 0 || index >= h.entries.length || index === h.cursor) return false;
@@ -4257,7 +4987,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const undo = (0, import_react21.useCallback)(
+  const undo = (0, import_react23.useCallback)(
     (trackId) => {
       const h = dataRef.current[trackId];
       if (!h || h.cursor <= 0) return Promise.resolve(false);
@@ -4265,7 +4995,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [restoreTo]
   );
-  const toggleFavorite = (0, import_react21.useCallback)(
+  const toggleFavorite = (0, import_react23.useCallback)(
     (trackId, index) => {
       const h = dataRef.current[trackId];
       if (!h || index < 0 || index >= h.entries.length) return;
@@ -4274,7 +5004,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const restore = (0, import_react21.useCallback)(
+  const restore = (0, import_react23.useCallback)(
     (trackId, state) => {
       const entries = Array.isArray(state?.entries) ? [...state.entries] : [];
       const raw = typeof state?.cursor === "number" ? state.cursor : entries.length - 1;
@@ -4283,15 +5013,15 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const list = (0, import_react21.useCallback)(
+  const list = (0, import_react23.useCallback)(
     (trackId) => dataRef.current[trackId] ?? EMPTY,
     []
   );
-  const canUndo = (0, import_react21.useCallback)((trackId) => {
+  const canUndo = (0, import_react23.useCallback)((trackId) => {
     const h = dataRef.current[trackId];
     return !!h && h.cursor > 0;
   }, []);
-  const clear = (0, import_react21.useCallback)(
+  const clear = (0, import_react23.useCallback)(
     (trackId) => {
       if (dataRef.current[trackId]) {
         const next = { ...dataRef.current };
@@ -4303,102 +5033,18 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [bump]
   );
-  const reset = (0, import_react21.useCallback)(() => {
+  const reset = (0, import_react23.useCallback)(() => {
     dataRef.current = {};
     bump();
   }, [bump]);
-  return (0, import_react21.useMemo)(
+  return (0, import_react23.useMemo)(
     () => ({ record, undo, restoreTo, list, canUndo, clear, reset, restore, toggleFavorite }),
     [record, undo, restoreTo, list, canUndo, clear, reset, restore, toggleFavorite]
   );
 }
 
-// src/hooks/useTrackReorder.ts
-var import_react22 = require("react");
-function moveItem(arr, from, to) {
-  const next = arr.slice();
-  if (from === to || from < 0 || to < 0 || from >= next.length || to >= next.length) {
-    return next;
-  }
-  const [moved] = next.splice(from, 1);
-  next.splice(to, 0, moved);
-  return next;
-}
-function useTrackReorder({
-  host,
-  items,
-  setItems,
-  getId,
-  onError
-}) {
-  const [draggingIndex, setDraggingIndex] = (0, import_react22.useState)(null);
-  const [dragOverIndex, setDragOverIndex] = (0, import_react22.useState)(null);
-  const fromRef = (0, import_react22.useRef)(null);
-  const itemsRef = (0, import_react22.useRef)(items);
-  itemsRef.current = items;
-  const dragPropsFor = (0, import_react22.useCallback)(
-    (index) => ({
-      handleProps: {
-        draggable: true,
-        onDragStart: (e) => {
-          fromRef.current = index;
-          setDraggingIndex(index);
-          if (e.dataTransfer) {
-            e.dataTransfer.effectAllowed = "move";
-            try {
-              e.dataTransfer.setData("text/plain", String(index));
-            } catch {
-            }
-          }
-        },
-        onDragEnd: () => {
-          fromRef.current = null;
-          setDraggingIndex(null);
-          setDragOverIndex(null);
-        }
-      },
-      rowProps: {
-        onDragEnter: (e) => {
-          if (fromRef.current === null) return;
-          e.preventDefault();
-          setDragOverIndex(index);
-        },
-        onDragOver: (e) => {
-          if (fromRef.current === null) return;
-          e.preventDefault();
-          if (e.dataTransfer) e.dataTransfer.dropEffect = "move";
-          setDragOverIndex((cur) => cur === index ? cur : index);
-        },
-        onDragLeave: () => {
-          setDragOverIndex((cur) => cur === index ? null : cur);
-        },
-        onDrop: (e) => {
-          e.preventDefault();
-          const from = fromRef.current;
-          fromRef.current = null;
-          setDraggingIndex(null);
-          setDragOverIndex(null);
-          if (from === null || from === index) return;
-          const prev = itemsRef.current;
-          const next = moveItem(prev, from, index);
-          setItems(next);
-          const ids = next.map(getId);
-          Promise.resolve(host.reorderTracks(ids)).catch((err) => {
-            setItems(prev);
-            onError?.(err);
-          });
-        }
-      },
-      isDragging: draggingIndex === index,
-      isDragTarget: dragOverIndex === index && draggingIndex !== index
-    }),
-    [host, setItems, getId, onError, draggingIndex, dragOverIndex]
-  );
-  return { dragPropsFor, draggingIndex, dragOverIndex };
-}
-
 // src/constants/sdk-version.ts
-var PLUGIN_SDK_VERSION = "2.28.0";
+var PLUGIN_SDK_VERSION = "2.34.0";
 
 // src/utils/format-concurrent-tracks.ts
 function formatConcurrentTracks(ctx) {
@@ -4542,6 +5188,8 @@ function pickTopKWeighted(scored, options = {}) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AUDIO_EFFECTS,
+  AUDIO_EFFECT_LABEL,
   ConfirmDialog,
   CrossfadeModal,
   CrossfadeTrackRow,
@@ -4580,34 +5228,49 @@ function pickTopKWeighted(scored, options = {}) {
   ScrollingWaveform,
   SorceryProgressBar,
   TEXTURAL_ROLES,
+  TRANSITION_DESIGNER_DRAFT_KEY,
   TrackDrawer,
   TrackMeterStrip,
   TrackRow,
+  TransitionDesigner,
   VolumeSlider,
   WaveformView,
   analyzeWavPeak,
+  asAudioEffect,
   asCrossfadeMeta,
   asFadeMeta,
+  asTransitionDesignerDraft,
   buildCrossfadeInpaintPrompt,
   buildCrossfadeVolumeCurves,
   buildFadeVolumeCurve,
+  buildRowSlots,
   calculateTimeBasedTarget,
   cellToPx,
   centerScrollTop,
   computePeaks,
+  dbIdsFromKeys,
   dbToSlider,
   defaultFadeGesture,
   drawWaveform,
   formatConcurrentTracks,
+  hashString,
   moveItem,
+  normalizeSlots,
+  padPair,
+  padSlots,
   parseCrossfadePairs,
   parseFades,
   pickTopKWeighted,
   pitchToName,
   pxToCell,
+  reconcileSlots,
   resizeNoteDuration,
+  rowKey,
+  rowType,
   scorePromptMatch,
   sliderToDb,
+  slotsEqual,
+  soundIdentity,
   synthesizeCuePoints,
   tokenizePrompt,
   transposeNotes,