@signalsandsorcery/plugin-sdk 2.25.1 → 2.28.1

package/dist/index.mjs

@@ -2465,6 +2465,8 @@ function parseCrossfadePairs(sceneData) {
       sliderPos: g.origin.meta.sliderPos,
       originDbId: g.origin.dbId,
       targetDbId: g.target.dbId,
+      originSourceDbId: g.origin.meta.sourceTrackDbId,
+      targetSourceDbId: g.target.meta.sourceTrackDbId,
       originSourceName: g.origin.meta.sourceName,
       originSoundLabel: g.origin.meta.soundLabel,
       targetSourceName: g.target.meta.sourceName,
@@ -2568,9 +2570,448 @@ function buildCrossfadeInpaintPrompt(input) {
   return lines.join("\n");
 }
 
+// src/fade-meta.ts
+function asFadeMeta(val) {
+  if (!val || typeof val !== "object") return null;
+  const m = val;
+  if (m.direction !== "in" && m.direction !== "out") return null;
+  if (m.gesture !== "volume" && m.gesture !== "build") return null;
+  return {
+    direction: m.direction,
+    gesture: m.gesture,
+    sourceTrackDbId: typeof m.sourceTrackDbId === "string" ? m.sourceTrackDbId : "",
+    sourceSceneId: typeof m.sourceSceneId === "string" ? m.sourceSceneId : "",
+    sourceName: typeof m.sourceName === "string" ? m.sourceName : "",
+    soundLabel: typeof m.soundLabel === "string" ? m.soundLabel : "",
+    sliderPos: typeof m.sliderPos === "number" ? m.sliderPos : 0.5
+  };
+}
+function parseFades(sceneData) {
+  const out = [];
+  for (const [key, val] of Object.entries(sceneData)) {
+    const match = /^track:(.+):fade$/.exec(key);
+    if (!match) continue;
+    const meta = asFadeMeta(val);
+    if (!meta) continue;
+    out.push({ dbId: match[1], meta });
+  }
+  return out;
+}
+function buildFadeVolumeCurve(bars, bpm, direction, sliderPos, gesture, steps = 32) {
+  const durationSeconds = bars * 4 * 60 / Math.max(1, bpm);
+  if (gesture === "build") {
+    return [
+      { time: 0, db: 0 },
+      { time: Math.round(durationSeconds * 1e3) / 1e3, db: 0 }
+    ];
+  }
+  const s = Math.min(0.98, Math.max(0.02, sliderPos));
+  const round = (n) => Math.round(n * 1e3) / 1e3;
+  const points = [];
+  for (let i = 0; i <= steps; i++) {
+    const x = i / steps;
+    const time = round(x * durationSeconds);
+    const theta = x <= s ? x / s * (Math.PI / 4) : Math.PI / 4 + (x - s) / (1 - s) * (Math.PI / 4);
+    const gain = direction === "out" ? Math.cos(theta) : Math.sin(theta);
+    points.push({ time, db: Math.round(gainToDb(gain) * 100) / 100 });
+  }
+  return points;
+}
+var TEXTURAL_ROLES = /* @__PURE__ */ new Set([
+  "pads",
+  "pad",
+  "strings",
+  "atmospheres",
+  "atmosphere",
+  "atmos",
+  "drones",
+  "drone",
+  "soundscapes",
+  "soundscape"
+]);
+function defaultFadeGesture(role) {
+  if (!role) return "build";
+  const norm = role.toLowerCase().replace(/[\s_-]+/g, " ").trim();
+  if (TEXTURAL_ROLES.has(norm)) return "volume";
+  for (const token of norm.split(" ")) {
+    if (TEXTURAL_ROLES.has(token)) return "volume";
+  }
+  return "build";
+}
+
+// src/components/FadeTrackRow.tsx
+import React10 from "react";
+import { Fragment as Fragment3, jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+function FadeCaption({
+  layer,
+  direction,
+  gesture
+}) {
+  const tag = direction === "in" ? "Fade in" : "Fade out";
+  return /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-1.5 min-w-0 px-2 py-0.5", children: [
+    /* @__PURE__ */ jsx13("span", { className: "text-[9px] font-bold uppercase tracking-wide text-sas-accent flex-shrink-0", children: tag }),
+    /* @__PURE__ */ jsx13("span", { className: "text-[11px] text-sas-text truncate", title: layer.sourceName ?? layer.name, children: layer.sourceName ?? layer.name }),
+    layer.soundLabel && /* @__PURE__ */ jsxs9("span", { className: "text-[9px] text-sas-muted/60 truncate flex-shrink-0", title: layer.soundLabel, children: [
+      "\xB7 ",
+      layer.soundLabel
+    ] }),
+    /* @__PURE__ */ jsxs9("span", { className: "text-[9px] text-sas-muted/50 flex-shrink-0", title: `Fade gesture: ${gesture}`, children: [
+      "\xB7 ",
+      gesture
+    ] })
+  ] });
+}
+function FadeTrackRow({
+  layer,
+  direction,
+  gesture,
+  sliderPos = 0.5,
+  onMuteToggle,
+  onSoloToggle,
+  onVolumeChange,
+  onPanChange,
+  onDelete,
+  onSliderChange,
+  levels,
+  accentColor = "#9333EA"
+}) {
+  const [confirmDelete, setConfirmDelete] = React10.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";
+  return /* @__PURE__ */ jsxs9(
+    "div",
+    {
+      "data-testid": "fade-track-row",
+      className: "w-full rounded-sm border border-sas-border bg-sas-panel/40 overflow-hidden",
+      style: { borderLeftColor: accentColor, borderLeftWidth: "3px" },
+      children: [
+        /* @__PURE__ */ jsxs9("div", { className: "flex items-center justify-between px-2 py-1 bg-sas-panel-alt/60", children: [
+          /* @__PURE__ */ jsx13(
+            "span",
+            {
+              "data-testid": "fade-direction-badge",
+              className: "text-[10px] font-bold uppercase tracking-wide",
+              style: { color: accentColor },
+              children: badge
+            }
+          ),
+          /* @__PURE__ */ jsx13(
+            "button",
+            {
+              "data-testid": "fade-delete-button",
+              onClick: () => setConfirmDelete(true),
+              className: "text-sas-danger/70 hover:text-sas-danger px-1 transition-colors text-sm",
+              title: "Delete fade",
+              "aria-label": "Delete fade",
+              children: "x"
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx13(
+          TrackRow,
+          {
+            track: { id: layer.trackId, name: "", role: layer.role },
+            runtimeState: layer.runtimeState,
+            fxDetailState: EMPTY_FX_DETAIL_STATE,
+            drawerOpen: false,
+            drawerTab: "fx",
+            levels,
+            accentColor,
+            contentSlot: /* @__PURE__ */ jsx13(FadeCaption, { layer, direction, gesture }),
+            onMuteToggle,
+            onSoloToggle,
+            onVolumeChange,
+            onPanChange
+          }
+        ),
+        /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-2 px-3 py-1.5", "data-testid": "fade-slider-row", children: [
+          /* @__PURE__ */ jsx13(
+            "span",
+            {
+              className: "text-[9px] text-sas-muted/60 truncate max-w-[70px] text-right flex-shrink-0",
+              title: leftLabel,
+              children: leftLabel
+            }
+          ),
+          /* @__PURE__ */ jsx13(
+            "input",
+            {
+              type: "range",
+              "data-testid": "fade-slider",
+              min: 0,
+              max: 1,
+              step: 0.01,
+              value: sliderPos,
+              disabled: !onSliderChange,
+              onChange: onSliderChange ? (e) => onSliderChange(Number(e.target.value)) : void 0,
+              style: { accentColor },
+              className: "flex-1 disabled:opacity-60 disabled:cursor-not-allowed",
+              "aria-label": "Fade position"
+            }
+          ),
+          /* @__PURE__ */ jsx13(
+            "span",
+            {
+              className: "text-[9px] text-sas-muted/60 truncate max-w-[70px] flex-shrink-0",
+              title: rightLabel,
+              children: rightLabel
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx13(
+          ConfirmDialog,
+          {
+            open: confirmDelete,
+            title: "Delete fade?",
+            message: /* @__PURE__ */ jsx13(Fragment3, { children: "This fade track will be permanently removed from this scene. This cannot be undone." }),
+            confirmLabel: "Delete",
+            onConfirm: () => {
+              setConfirmDelete(false);
+              onDelete();
+            },
+            onCancel: () => setConfirmDelete(false),
+            testIdPrefix: "fade-delete-confirm"
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/components/FadeModal.tsx
+import { useCallback as useCallback4, useEffect as useEffect6, useMemo as useMemo3, useRef as useRef7, useState as useState7 } from "react";
+import { Fragment as Fragment4, jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
+function shortId(dbId) {
+  return dbId.length > 8 ? dbId.slice(0, 8) : dbId;
+}
+var normRole = (r) => (r ?? "").toLowerCase().trim();
+function computeOrphans(from, to, excludeSet) {
+  const bucket = (list) => {
+    const m = /* @__PURE__ */ new Map();
+    for (const t of list) {
+      const k = normRole(t.role);
+      const arr = m.get(k);
+      if (arr) arr.push(t);
+      else m.set(k, [t]);
+    }
+    return m;
+  };
+  const fromByRole = bucket(from);
+  const toByRole = bucket(to);
+  const roles = /* @__PURE__ */ new Set([...fromByRole.keys(), ...toByRole.keys()]);
+  const fadeOut = [];
+  const fadeIn = [];
+  for (const role of roles) {
+    const f = fromByRole.get(role) ?? [];
+    const t = toByRole.get(role) ?? [];
+    const shared = Math.min(f.length, t.length);
+    fadeOut.push(...f.slice(shared));
+    fadeIn.push(...t.slice(shared));
+  }
+  return {
+    fadeOut: fadeOut.filter((x) => !excludeSet.has(x.dbId)),
+    fadeIn: fadeIn.filter((x) => !excludeSet.has(x.dbId))
+  };
+}
+function OrphanRow({
+  track,
+  gesture,
+  selected,
+  disabled,
+  onSelect,
+  testId
+}) {
+  const primary = track.prompt?.trim() || track.name;
+  const meta = [track.role, shortId(track.dbId), gesture].filter(Boolean).join(" \xB7 ");
+  return /* @__PURE__ */ jsxs10(
+    "button",
+    {
+      type: "button",
+      role: "radio",
+      "aria-checked": selected,
+      "data-testid": testId,
+      "data-value": track.dbId,
+      onClick: onSelect,
+      disabled,
+      className: `w-full text-left px-2 py-1.5 rounded-sm border transition-colors disabled:opacity-50 ${selected ? "bg-sas-accent/15 border-sas-accent" : "bg-sas-panel border-sas-border hover:border-sas-accent/50"}`,
+      children: [
+        /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-text truncate", title: primary, children: primary }),
+        meta && /* @__PURE__ */ jsx14("div", { className: "text-[10px] text-sas-muted truncate mt-0.5", title: track.dbId, children: meta })
+      ]
+    }
+  );
+}
+function FadeModal({
+  host,
+  open,
+  fromSceneId,
+  toSceneId,
+  fromSceneName,
+  toSceneName,
+  excludeSourceDbIds,
+  onClose,
+  onCreate,
+  testIdPrefix = "fade-modal"
+}) {
+  const [load, setLoad] = useState7({ status: "loading" });
+  const [selectedDbId, setSelectedDbId] = useState7("");
+  const [isCreating, setIsCreating] = useState7(false);
+  const [error, setError] = useState7(null);
+  const [fromName, setFromName] = useState7(null);
+  const [toName, setToName] = useState7(null);
+  const cancelRef = useRef7(null);
+  const refresh = useCallback4(async () => {
+    if (!host.listSceneFamilyTracks) {
+      setLoad({ status: "error", message: "This host does not support fades." });
+      return;
+    }
+    setLoad({ status: "loading" });
+    try {
+      const [from, to, fName, tName] = 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)
+      ]);
+      setFromName(fName);
+      setToName(tName);
+      setLoad({ status: "ready", from, to });
+    } catch (err) {
+      setLoad({ status: "error", message: err instanceof Error ? err.message : "Failed to load tracks." });
+    }
+  }, [host, fromSceneId, toSceneId]);
+  useEffect6(() => {
+    if (open) {
+      setError(null);
+      setIsCreating(false);
+      setSelectedDbId("");
+      void refresh();
+    }
+  }, [open, refresh]);
+  const excludeSet = useMemo3(() => new Set(excludeSourceDbIds ?? []), [excludeSourceDbIds]);
+  const { fadeOut, fadeIn } = useMemo3(
+    () => load.status === "ready" ? computeOrphans(load.from, load.to, excludeSet) : { fadeOut: [], fadeIn: [] },
+    [load, excludeSet]
+  );
+  const allOrphans = useMemo3(
+    () => [
+      ...fadeOut.map((t) => ({ track: t, direction: "out" })),
+      ...fadeIn.map((t) => ({ track: t, direction: "in" }))
+    ],
+    [fadeOut, fadeIn]
+  );
+  useEffect6(() => {
+    if (!allOrphans.some((o) => o.track.dbId === selectedDbId)) {
+      setSelectedDbId(allOrphans[0]?.track.dbId ?? "");
+    }
+  }, [allOrphans, selectedDbId]);
+  const selected = allOrphans.find((o) => o.track.dbId === selectedDbId) ?? null;
+  const canCreate = !isCreating && !!selected;
+  const handleClose = useCallback4(() => {
+    if (!isCreating) onClose();
+  }, [isCreating, onClose]);
+  const handleCreate = useCallback4(async () => {
+    if (!selected) return;
+    setIsCreating(true);
+    setError(null);
+    try {
+      await onCreate(
+        { dbId: selected.track.dbId, name: selected.track.name, role: selected.track.role },
+        selected.direction,
+        defaultFadeGesture(selected.track.role)
+      );
+      onClose();
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "Failed to create fade.");
+      setIsCreating(false);
+    }
+  }, [selected, onCreate, onClose]);
+  const fromLabel = fromName ?? fromSceneName ?? null;
+  const toLabel = toName ?? toSceneName ?? null;
+  if (!open) return null;
+  const renderSection = (heading, list, section) => {
+    if (list.length === 0) return null;
+    return /* @__PURE__ */ jsxs10("div", { className: "block", children: [
+      /* @__PURE__ */ jsx14("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: heading }),
+      /* @__PURE__ */ jsx14(
+        "div",
+        {
+          role: "radiogroup",
+          "aria-label": heading,
+          "data-testid": `${testIdPrefix}-${section === "out" ? "fade-out" : "fade-in"}-list`,
+          className: "mt-1 space-y-1 max-h-40 overflow-y-auto pr-0.5",
+          children: list.map((t) => /* @__PURE__ */ jsx14(
+            OrphanRow,
+            {
+              track: t,
+              gesture: defaultFadeGesture(t.role),
+              selected: t.dbId === selectedDbId,
+              disabled: isCreating,
+              onSelect: () => setSelectedDbId(t.dbId),
+              testId: `${testIdPrefix}-option-${t.dbId}`
+            },
+            t.dbId
+          ))
+        }
+      )
+    ] });
+  };
+  return /* @__PURE__ */ jsx14(Modal, { open, onClose: handleClose, testIdPrefix, initialFocusRef: cancelRef, children: /* @__PURE__ */ jsxs10(
+    "div",
+    {
+      className: "bg-sas-panel border border-sas-border rounded-md shadow-xl w-[420px] max-w-[92vw] p-4 space-y-3",
+      onClick: (e) => e.stopPropagation(),
+      "data-testid": `${testIdPrefix}-box`,
+      children: [
+        /* @__PURE__ */ jsx14("h3", { className: "text-sm font-bold text-sas-text", children: "Add fade" }),
+        /* @__PURE__ */ jsxs10("p", { className: "text-[11px] text-sas-muted leading-relaxed", children: [
+          "Tracks with no counterpart between",
+          " ",
+          /* @__PURE__ */ jsx14("span", { className: "text-sas-text", children: fromLabel ?? "the origin scene" }),
+          " and",
+          " ",
+          /* @__PURE__ */ jsx14("span", { className: "text-sas-text", children: toLabel ?? "the target scene" }),
+          " can gracefully fade out (leaving) or fade in (entering) across this transition."
+        ] }),
+        load.status === "loading" && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-muted py-4 text-center", children: "Loading tracks\u2026" }),
+        load.status === "error" && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-danger py-4 text-center", children: load.message }),
+        load.status === "ready" && (allOrphans.length === 0 ? /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-muted py-4 text-center", "data-testid": `${testIdPrefix}-empty`, children: "Every track has a counterpart in the other scene \u2014 nothing to fade. Use \u201C+ Crossfade\u201D to bridge matching tracks." }) : /* @__PURE__ */ jsxs10(Fragment4, { children: [
+          renderSection(`Fade out${fromLabel ? ` (from ${fromLabel})` : ""}`, fadeOut, "out"),
+          renderSection(`Fade in${toLabel ? ` (to ${toLabel})` : ""}`, fadeIn, "in")
+        ] })),
+        error && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-danger", "data-testid": `${testIdPrefix}-error`, children: error }),
+        /* @__PURE__ */ jsxs10("div", { className: "flex justify-end gap-2 pt-1", children: [
+          /* @__PURE__ */ jsx14(
+            "button",
+            {
+              ref: cancelRef,
+              "data-testid": `${testIdPrefix}-cancel`,
+              onClick: onClose,
+              disabled: isCreating,
+              className: "px-3 py-1 text-xs rounded-sm border border-sas-border text-sas-muted hover:text-sas-text disabled:opacity-50",
+              children: "Cancel"
+            }
+          ),
+          /* @__PURE__ */ jsx14(
+            "button",
+            {
+              "data-testid": `${testIdPrefix}-confirm`,
+              onClick: handleCreate,
+              disabled: !canCreate,
+              className: `px-3 py-1 text-xs rounded-sm border transition-colors ${canCreate ? "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: isCreating ? "Generating fade\u2026" : "Create fade"
+            }
+          )
+        ] })
+      ]
+    }
+  ) });
+}
+
 // src/components/ImportTrackModal.tsx
-import { useCallback as useCallback4, useEffect as useEffect6, useState as useState7 } from "react";
-import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+import { useCallback as useCallback5, useEffect as useEffect7, useState as useState8 } from "react";
+import { jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
 function ImportTrackModal({
   host,
   open,
@@ -2582,10 +3023,10 @@ function ImportTrackModal({
   onPick,
   onPortTrack
 }) {
-  const [load, setLoad] = useState7({ status: "loading" });
-  const [selectedSceneId, setSelectedSceneId] = useState7(null);
-  const [importingTrackId, setImportingTrackId] = useState7(null);
-  const refresh = useCallback4(async () => {
+  const [load, setLoad] = useState8({ status: "loading" });
+  const [selectedSceneId, setSelectedSceneId] = useState8(null);
+  const [importingTrackId, setImportingTrackId] = useState8(null);
+  const refresh = useCallback5(async () => {
     if (!host.listImportableTracks) {
       setLoad({ status: "error", message: "This host does not support importing tracks." });
       return;
@@ -2601,14 +3042,14 @@ function ImportTrackModal({
       setLoad({ status: "error", message: err instanceof Error ? err.message : "Failed to load scenes." });
     }
   }, [host, mode, onPortTrack]);
-  useEffect6(() => {
+  useEffect7(() => {
     if (open) {
       setSelectedSceneId(null);
       setImportingTrackId(null);
       void refresh();
     }
   }, [open, refresh]);
-  const handleImport = useCallback4(
+  const handleImport = useCallback5(
     async (track, sourceSceneId, sceneName, isSameScene) => {
       if (isSameScene && onPortTrack) {
         if (!track.importable) return;
@@ -2649,16 +3090,16 @@ function ImportTrackModal({
   if (!open) return null;
   const scenes = load.status === "ready" ? load.scenes : [];
   const selectedScene = scenes.find((s) => s.sceneId === selectedSceneId) ?? null;
-  return /* @__PURE__ */ jsx13(Modal, { open, onClose, testIdPrefix, children: /* @__PURE__ */ jsxs9(
+  return /* @__PURE__ */ jsx15(Modal, { open, onClose, testIdPrefix, children: /* @__PURE__ */ jsxs11(
     "div",
     {
       className: "w-[420px] max-h-[70vh] overflow-hidden flex flex-col rounded-md border border-sas-border bg-sas-panel shadow-xl",
       onClick: (e) => e.stopPropagation(),
       "data-testid": `${testIdPrefix}-modal`,
       children: [
-        /* @__PURE__ */ jsxs9("div", { className: "flex items-center justify-between px-3 py-2 border-b border-sas-border", children: [
-          /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-2", children: [
-            selectedScene && /* @__PURE__ */ jsx13(
+        /* @__PURE__ */ jsxs11("div", { className: "flex items-center justify-between px-3 py-2 border-b border-sas-border", children: [
+          /* @__PURE__ */ jsxs11("div", { className: "flex items-center gap-2", children: [
+            selectedScene && /* @__PURE__ */ jsx15(
               "button",
               {
                 className: "text-sas-muted hover:text-sas-accent text-xs",
@@ -2667,9 +3108,9 @@ function ImportTrackModal({
                 children: "\u2190"
               }
             ),
-            /* @__PURE__ */ jsx13("span", { className: "text-sm font-medium text-sas-text", children: selectedScene ? selectedScene.sceneName : title })
+            /* @__PURE__ */ jsx15("span", { className: "text-sm font-medium text-sas-text", children: selectedScene ? selectedScene.sceneName : title })
           ] }),
-          /* @__PURE__ */ jsx13(
+          /* @__PURE__ */ jsx15(
             "button",
             {
               className: "text-sas-muted hover:text-sas-accent text-sm",
@@ -2679,30 +3120,30 @@ function ImportTrackModal({
             }
           )
         ] }),
-        /* @__PURE__ */ jsxs9("div", { className: "overflow-y-auto p-2 flex-1", children: [
-          load.status === "loading" && /* @__PURE__ */ jsx13("div", { className: "py-8 text-center text-xs text-sas-muted", "data-testid": `${testIdPrefix}-loading`, children: "Loading scenes\u2026" }),
-          load.status === "error" && /* @__PURE__ */ jsx13("div", { className: "py-8 text-center text-xs text-red-400", "data-testid": `${testIdPrefix}-error`, children: load.message }),
-          load.status === "ready" && scenes.length === 0 && /* @__PURE__ */ jsx13("div", { className: "py-8 text-center text-xs text-sas-muted", "data-testid": `${testIdPrefix}-empty`, children: mode === "sound" ? "No other scenes have a sound to import." : "No other scenes have a compatible track to import." }),
-          load.status === "ready" && scenes.length > 0 && !selectedScene && /* @__PURE__ */ jsx13("ul", { className: "flex flex-col gap-1", "data-testid": `${testIdPrefix}-scene-list`, children: scenes.map((scene) => /* @__PURE__ */ jsx13("li", { children: /* @__PURE__ */ jsxs9(
+        /* @__PURE__ */ jsxs11("div", { className: "overflow-y-auto p-2 flex-1", children: [
+          load.status === "loading" && /* @__PURE__ */ jsx15("div", { className: "py-8 text-center text-xs text-sas-muted", "data-testid": `${testIdPrefix}-loading`, children: "Loading scenes\u2026" }),
+          load.status === "error" && /* @__PURE__ */ jsx15("div", { className: "py-8 text-center text-xs text-red-400", "data-testid": `${testIdPrefix}-error`, children: load.message }),
+          load.status === "ready" && scenes.length === 0 && /* @__PURE__ */ jsx15("div", { className: "py-8 text-center text-xs text-sas-muted", "data-testid": `${testIdPrefix}-empty`, children: mode === "sound" ? "No other scenes have a sound to import." : "No other scenes have a compatible track to import." }),
+          load.status === "ready" && scenes.length > 0 && !selectedScene && /* @__PURE__ */ jsx15("ul", { className: "flex flex-col gap-1", "data-testid": `${testIdPrefix}-scene-list`, children: scenes.map((scene) => /* @__PURE__ */ jsx15("li", { children: /* @__PURE__ */ jsxs11(
             "button",
             {
               className: "w-full flex items-center justify-between px-2 py-1.5 rounded-sm border border-sas-border bg-sas-panel-alt text-left text-xs text-sas-text hover:border-sas-accent hover:text-sas-accent transition-colors",
               onClick: () => setSelectedSceneId(scene.sceneId),
               "data-testid": `${testIdPrefix}-scene`,
               children: [
-                /* @__PURE__ */ jsx13("span", { className: "truncate", children: scene.sceneName }),
-                /* @__PURE__ */ jsxs9("span", { className: "text-sas-muted", children: [
+                /* @__PURE__ */ jsx15("span", { className: "truncate", children: scene.sceneName }),
+                /* @__PURE__ */ jsxs11("span", { className: "text-sas-muted", children: [
                   scene.tracks.length,
                   " \u2192"
                 ] })
               ]
             }
           ) }, scene.sceneId)) }),
-          selectedScene && /* @__PURE__ */ jsx13("ul", { className: "flex flex-col gap-1", "data-testid": `${testIdPrefix}-track-list`, children: selectedScene.tracks.map((track) => {
+          selectedScene && /* @__PURE__ */ jsx15("ul", { className: "flex flex-col gap-1", "data-testid": `${testIdPrefix}-track-list`, children: selectedScene.tracks.map((track) => {
             const busy = importingTrackId === track.trackId;
             const gated = mode === "track" && !track.importable;
             const disabled = gated || busy;
-            return /* @__PURE__ */ jsx13("li", { children: /* @__PURE__ */ jsxs9(
+            return /* @__PURE__ */ jsx15("li", { children: /* @__PURE__ */ jsxs11(
               "button",
               {
                 className: `w-full flex items-center justify-between px-2 py-1.5 rounded-sm border text-left text-xs transition-colors ${disabled ? "bg-sas-panel border-sas-border text-sas-muted/50 cursor-not-allowed" : "bg-sas-panel-alt border-sas-border text-sas-text hover:border-sas-accent hover:text-sas-accent"}`,
@@ -2712,14 +3153,14 @@ function ImportTrackModal({
                 "data-testid": `${testIdPrefix}-track`,
                 "data-importable": mode === "sound" || track.importable ? "true" : "false",
                 children: [
-                  /* @__PURE__ */ jsxs9("span", { className: "truncate", children: [
+                  /* @__PURE__ */ jsxs11("span", { className: "truncate", children: [
                     track.name,
-                    track.role ? /* @__PURE__ */ jsxs9("span", { className: "text-sas-muted", children: [
+                    track.role ? /* @__PURE__ */ jsxs11("span", { className: "text-sas-muted", children: [
                       " \xB7 ",
                       track.role
                     ] }) : null
                   ] }),
-                  busy ? /* @__PURE__ */ jsx13("span", { className: "text-sas-muted", children: "\u2026" }) : gated ? /* @__PURE__ */ jsx13("span", { className: "text-sas-muted", children: "\u2298" }) : null
+                  busy ? /* @__PURE__ */ jsx15("span", { className: "text-sas-muted", children: "\u2026" }) : gated ? /* @__PURE__ */ jsx15("span", { className: "text-sas-muted", children: "\u2298" }) : null
                 ]
               }
             ) }, track.dbId);
@@ -2731,8 +3172,38 @@ function ImportTrackModal({
 }
 
 // src/components/CrossfadeModal.tsx
-import { useCallback as useCallback5, useEffect as useEffect7, useMemo as useMemo3, useRef as useRef7, useState as useState8 } from "react";
-import { Fragment as Fragment3, jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
+import { useCallback as useCallback6, useEffect as useEffect8, useMemo as useMemo4, useRef as useRef8, useState as useState9 } from "react";
+import { Fragment as Fragment5, jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
+function shortId2(dbId) {
+  return dbId.length > 8 ? dbId.slice(0, 8) : dbId;
+}
+function CandidateRow({
+  track,
+  selected,
+  disabled,
+  onSelect,
+  testId
+}) {
+  const primary = track.prompt?.trim() || track.name;
+  const meta = [track.role, shortId2(track.dbId)].filter(Boolean).join(" \xB7 ");
+  return /* @__PURE__ */ jsxs12(
+    "button",
+    {
+      type: "button",
+      role: "radio",
+      "aria-checked": selected,
+      "data-testid": testId,
+      "data-value": track.dbId,
+      onClick: onSelect,
+      disabled,
+      className: `w-full text-left px-2 py-1.5 rounded-sm border transition-colors disabled:opacity-50 ${selected ? "bg-sas-accent/15 border-sas-accent" : "bg-sas-panel border-sas-border hover:border-sas-accent/50"}`,
+      children: [
+        /* @__PURE__ */ jsx16("div", { className: "text-xs text-sas-text truncate", title: primary, children: primary }),
+        meta && /* @__PURE__ */ jsx16("div", { className: "text-[10px] text-sas-muted truncate mt-0.5", title: track.dbId, children: meta })
+      ]
+    }
+  );
+}
 function CrossfadeModal({
   host,
   open,
@@ -2740,34 +3211,40 @@ function CrossfadeModal({
   toSceneId,
   fromSceneName,
   toSceneName,
+  excludeSourceDbIds,
   onClose,
   onCreate,
   testIdPrefix = "crossfade-modal"
 }) {
-  const [load, setLoad] = useState8({ status: "loading" });
-  const [originDbId, setOriginDbId] = useState8("");
-  const [targetDbId, setTargetDbId] = useState8("");
-  const [isCreating, setIsCreating] = useState8(false);
-  const [error, setError] = useState8(null);
-  const cancelRef = useRef7(null);
-  const refresh = useCallback5(async () => {
+  const [load, setLoad] = useState9({ status: "loading" });
+  const [originDbId, setOriginDbId] = useState9("");
+  const [targetDbId, setTargetDbId] = useState9("");
+  const [isCreating, setIsCreating] = useState9(false);
+  const [error, setError] = useState9(null);
+  const [fromName, setFromName] = useState9(null);
+  const [toName, setToName] = useState9(null);
+  const cancelRef = useRef8(null);
+  const refresh = useCallback6(async () => {
     if (!host.listSceneFamilyTracks) {
       setLoad({ status: "error", message: "This host does not support crossfade tracks." });
       return;
     }
     setLoad({ status: "loading" });
     try {
-      const [origin, target] = await Promise.all([
+      const [origin, target, fName, tName] = await Promise.all([
         host.listSceneFamilyTracks(fromSceneId),
-        host.listSceneFamilyTracks(toSceneId)
+        host.listSceneFamilyTracks(toSceneId),
+        host.getSceneName ? host.getSceneName(fromSceneId) : Promise.resolve(null),
+        host.getSceneName ? host.getSceneName(toSceneId) : Promise.resolve(null)
       ]);
+      setFromName(fName);
+      setToName(tName);
       setLoad({ status: "ready", origin, target });
-      setOriginDbId(origin[0]?.dbId ?? "");
     } catch (err) {
       setLoad({ status: "error", message: err instanceof Error ? err.message : "Failed to load tracks." });
     }
   }, [host, fromSceneId, toSceneId]);
-  useEffect7(() => {
+  useEffect8(() => {
     if (open) {
       setError(null);
       setIsCreating(false);
@@ -2776,27 +3253,32 @@ function CrossfadeModal({
       void refresh();
     }
   }, [open, refresh]);
-  const originTrack = useMemo3(
-    () => load.status === "ready" ? load.origin.find((t) => t.dbId === originDbId) ?? null : null,
-    [load, originDbId]
+  const excludeSet = useMemo4(() => new Set(excludeSourceDbIds ?? []), [excludeSourceDbIds]);
+  const originCandidates = useMemo4(
+    () => load.status === "ready" ? load.origin.filter((t) => !excludeSet.has(t.dbId)) : [],
+    [load, excludeSet]
   );
-  const originRole = originTrack?.role;
-  const targetCandidates = useMemo3(() => {
-    if (load.status !== "ready") return [];
-    if (!originRole) return load.target;
-    return load.target.filter((t) => t.role === originRole);
-  }, [load, originRole]);
-  useEffect7(() => {
+  const targetCandidates = useMemo4(
+    () => load.status === "ready" ? load.target.filter((t) => !excludeSet.has(t.dbId)) : [],
+    [load, excludeSet]
+  );
+  useEffect8(() => {
+    if (!originCandidates.some((t) => t.dbId === originDbId)) {
+      setOriginDbId(originCandidates[0]?.dbId ?? "");
+    }
+  }, [originCandidates, originDbId]);
+  useEffect8(() => {
     if (!targetCandidates.some((t) => t.dbId === targetDbId)) {
       setTargetDbId(targetCandidates[0]?.dbId ?? "");
     }
   }, [targetCandidates, targetDbId]);
+  const originTrack = originCandidates.find((t) => t.dbId === originDbId) ?? null;
   const targetTrack = targetCandidates.find((t) => t.dbId === targetDbId) ?? null;
   const canCreate = !isCreating && !!originTrack && !!targetTrack;
-  const handleClose = useCallback5(() => {
+  const handleClose = useCallback6(() => {
     if (!isCreating) onClose();
   }, [isCreating, onClose]);
-  const handleCreate = useCallback5(async () => {
+  const handleCreate = useCallback6(async () => {
     if (!originTrack || !targetTrack) return;
     setIsCreating(true);
     setError(null);
@@ -2811,79 +3293,100 @@ function CrossfadeModal({
       setIsCreating(false);
     }
   }, [originTrack, targetTrack, onCreate, onClose]);
+  const fromLabel = fromName ?? fromSceneName ?? null;
+  const toLabel = toName ?? toSceneName ?? null;
   if (!open) return null;
-  return /* @__PURE__ */ jsx14(Modal, { open, onClose: handleClose, testIdPrefix, initialFocusRef: cancelRef, children: /* @__PURE__ */ jsxs10(
+  return /* @__PURE__ */ jsx16(Modal, { open, onClose: handleClose, testIdPrefix, initialFocusRef: cancelRef, children: /* @__PURE__ */ jsxs12(
     "div",
     {
       className: "bg-sas-panel border border-sas-border rounded-md shadow-xl w-[420px] max-w-[92vw] p-4 space-y-3",
       onClick: (e) => e.stopPropagation(),
       "data-testid": `${testIdPrefix}-box`,
       children: [
-        /* @__PURE__ */ jsx14("h3", { className: "text-sm font-bold text-sas-text", children: "Add crossfade" }),
-        /* @__PURE__ */ jsxs10("p", { className: "text-[11px] text-sas-muted leading-relaxed", children: [
+        /* @__PURE__ */ jsx16("h3", { className: "text-sm font-bold text-sas-text", children: "Add crossfade" }),
+        /* @__PURE__ */ jsxs12("p", { className: "text-[11px] text-sas-muted leading-relaxed", children: [
           "Bridge a track from",
           " ",
-          /* @__PURE__ */ jsx14("span", { className: "text-sas-text", children: fromSceneName ?? "the origin scene" }),
+          /* @__PURE__ */ jsx16("span", { className: "text-sas-text", children: fromLabel ?? "the origin scene" }),
           " into one from",
           " ",
-          /* @__PURE__ */ jsx14("span", { className: "text-sas-text", children: toSceneName ?? "the target scene" }),
+          /* @__PURE__ */ jsx16("span", { className: "text-sas-text", children: toLabel ?? "the target scene" }),
           ". Both layers share one generated part; each keeps its own preset."
         ] }),
-        load.status === "loading" && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-muted py-4 text-center", children: "Loading tracks\u2026" }),
-        load.status === "error" && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-danger py-4 text-center", children: load.message }),
-        load.status === "ready" && (load.origin.length === 0 ? /* @__PURE__ */ jsx14(
+        load.status === "loading" && /* @__PURE__ */ jsx16("div", { className: "text-xs text-sas-muted py-4 text-center", children: "Loading tracks\u2026" }),
+        load.status === "error" && /* @__PURE__ */ jsx16("div", { className: "text-xs text-sas-danger py-4 text-center", children: load.message }),
+        load.status === "ready" && (originCandidates.length === 0 ? /* @__PURE__ */ jsxs12(
           "div",
           {
             className: "text-xs text-sas-muted py-4 text-center",
             "data-testid": `${testIdPrefix}-empty-origin`,
-            children: "No matching tracks in the origin scene. Add one there first."
+            children: [
+              "No available tracks in ",
+              fromLabel ?? "the origin scene",
+              ". Add one (or free one from another crossfade) first."
+            ]
           }
-        ) : /* @__PURE__ */ jsxs10(Fragment3, { children: [
-          /* @__PURE__ */ jsxs10("label", { className: "block", children: [
-            /* @__PURE__ */ jsx14("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: "Origin (top)" }),
-            /* @__PURE__ */ jsx14(
-              "select",
+        ) : /* @__PURE__ */ jsxs12(Fragment5, { children: [
+          /* @__PURE__ */ jsxs12("div", { className: "block", children: [
+            /* @__PURE__ */ jsxs12("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: [
+              "Origin ",
+              fromLabel ? `(${fromLabel})` : "(top)"
+            ] }),
+            /* @__PURE__ */ jsx16(
+              "div",
               {
-                "data-testid": `${testIdPrefix}-origin-select`,
-                value: originDbId,
-                onChange: (e) => setOriginDbId(e.target.value),
-                disabled: isCreating,
-                className: "sas-input w-full mt-0.5 text-xs",
-                children: load.origin.map((t) => /* @__PURE__ */ jsxs10("option", { value: t.dbId, children: [
-                  t.name,
-                  t.role ? ` \xB7 ${t.role}` : ""
-                ] }, t.dbId))
+                role: "radiogroup",
+                "aria-label": "Origin track",
+                "data-testid": `${testIdPrefix}-origin-list`,
+                className: "mt-1 space-y-1 max-h-40 overflow-y-auto pr-0.5",
+                children: originCandidates.map((t) => /* @__PURE__ */ jsx16(
+                  CandidateRow,
+                  {
+                    track: t,
+                    selected: t.dbId === originDbId,
+                    disabled: isCreating,
+                    onSelect: () => setOriginDbId(t.dbId),
+                    testId: `${testIdPrefix}-origin-option-${t.dbId}`
+                  },
+                  t.dbId
+                ))
               }
             )
           ] }),
-          /* @__PURE__ */ jsxs10("label", { className: "block", children: [
-            /* @__PURE__ */ jsxs10("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: [
-              "Target (bottom)",
-              originRole ? ` \xB7 ${originRole}` : ""
+          /* @__PURE__ */ jsxs12("div", { className: "block", children: [
+            /* @__PURE__ */ jsxs12("span", { className: "text-[10px] uppercase tracking-wide text-sas-muted", children: [
+              "Target ",
+              toLabel ? `(${toLabel})` : "(bottom)"
             ] }),
-            targetCandidates.length === 0 ? /* @__PURE__ */ jsxs10("div", { className: "text-xs text-sas-danger mt-0.5", "data-testid": `${testIdPrefix}-empty-target`, children: [
-              "No ",
-              originRole ?? "matching",
-              " track in the target scene to crossfade into."
-            ] }) : /* @__PURE__ */ jsx14(
-              "select",
+            targetCandidates.length === 0 ? /* @__PURE__ */ jsxs12("div", { className: "text-xs text-sas-danger mt-0.5", "data-testid": `${testIdPrefix}-empty-target`, children: [
+              "No available tracks in ",
+              toLabel ?? "the target scene",
+              " to crossfade into."
+            ] }) : /* @__PURE__ */ jsx16(
+              "div",
               {
-                "data-testid": `${testIdPrefix}-target-select`,
-                value: targetDbId,
-                onChange: (e) => setTargetDbId(e.target.value),
-                disabled: isCreating,
-                className: "sas-input w-full mt-0.5 text-xs",
-                children: targetCandidates.map((t) => /* @__PURE__ */ jsxs10("option", { value: t.dbId, children: [
-                  t.name,
-                  t.role ? ` \xB7 ${t.role}` : ""
-                ] }, t.dbId))
+                role: "radiogroup",
+                "aria-label": "Target track",
+                "data-testid": `${testIdPrefix}-target-list`,
+                className: "mt-1 space-y-1 max-h-40 overflow-y-auto pr-0.5",
+                children: targetCandidates.map((t) => /* @__PURE__ */ jsx16(
+                  CandidateRow,
+                  {
+                    track: t,
+                    selected: t.dbId === targetDbId,
+                    disabled: isCreating,
+                    onSelect: () => setTargetDbId(t.dbId),
+                    testId: `${testIdPrefix}-target-option-${t.dbId}`
+                  },
+                  t.dbId
+                ))
               }
             )
           ] })
         ] })),
-        error && /* @__PURE__ */ jsx14("div", { className: "text-xs text-sas-danger", "data-testid": `${testIdPrefix}-error`, children: error }),
-        /* @__PURE__ */ jsxs10("div", { className: "flex justify-end gap-2 pt-1", children: [
-          /* @__PURE__ */ jsx14(
+        error && /* @__PURE__ */ jsx16("div", { className: "text-xs text-sas-danger", "data-testid": `${testIdPrefix}-error`, children: error }),
+        /* @__PURE__ */ jsxs12("div", { className: "flex justify-end gap-2 pt-1", children: [
+          /* @__PURE__ */ jsx16(
             "button",
             {
               ref: cancelRef,
@@ -2894,7 +3397,7 @@ function CrossfadeModal({
               children: "Cancel"
             }
           ),
-          /* @__PURE__ */ jsx14(
+          /* @__PURE__ */ jsx16(
             "button",
             {
               "data-testid": `${testIdPrefix}-confirm`,
@@ -2911,8 +3414,8 @@ function CrossfadeModal({
 }
 
 // src/components/DownloadPackButton.tsx
-import { useCallback as useCallback6, useEffect as useEffect8, useState as useState9 } from "react";
-import { jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
+import { useCallback as useCallback7, useEffect as useEffect9, useState as useState10 } from "react";
+import { jsx as jsx17, jsxs as jsxs13 } from "react/jsx-runtime";
 function formatSize(bytes) {
   if (!bytes || bytes <= 0) return "";
   const gb = bytes / 1024 ** 3;
@@ -2928,10 +3431,10 @@ var DownloadPackButton = ({
   variant = "compact",
   onDownloadComplete
 }) => {
-  const [status, setStatus] = useState9("idle");
-  const [progress, setProgress] = useState9(0);
-  const [errorMessage, setErrorMessage] = useState9(null);
-  useEffect8(() => {
+  const [status, setStatus] = useState10("idle");
+  const [progress, setProgress] = useState10(0);
+  const [errorMessage, setErrorMessage] = useState10(null);
+  useEffect9(() => {
     const unsub = host.onSamplePackProgress(packId, (p) => {
       setStatus(p.status);
       setProgress(p.progress);
@@ -2946,7 +3449,7 @@ var DownloadPackButton = ({
     });
     return unsub;
   }, [host, packId, onDownloadComplete]);
-  const handleClick = useCallback6(async () => {
+  const handleClick = useCallback7(async () => {
     if (status !== "idle" && status !== "error") return;
     try {
       setStatus("downloading");
@@ -3000,8 +3503,8 @@ var DownloadPackButton = ({
   } else {
     className = `${baseClasses} text-sas-muted hover:text-sas-accent border-sas-border hover:border-sas-accent`;
   }
-  return /* @__PURE__ */ jsxs11("div", { children: [
-    /* @__PURE__ */ jsx15(
+  return /* @__PURE__ */ jsxs13("div", { children: [
+    /* @__PURE__ */ jsx17(
       "button",
       {
         "data-testid": `download-pack-button-${packId}`,
@@ -3012,12 +3515,12 @@ var DownloadPackButton = ({
         children: buttonLabel
       }
     ),
-    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ jsx15("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
+    variant === "large" && status === "error" && errorMessage && /* @__PURE__ */ jsx17("div", { className: "text-xs text-sas-danger mt-2", "data-testid": `download-pack-error-${packId}`, children: errorMessage })
   ] });
 };
 
 // src/components/SamplePackCTACard.tsx
-import { jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
+import { jsx as jsx18, jsxs as jsxs14 } from "react/jsx-runtime";
 var SamplePackCTACard = ({
   host,
   pack,
@@ -3025,7 +3528,7 @@ var SamplePackCTACard = ({
   onDownloadComplete
 }) => {
   if (status === "checking") {
-    return /* @__PURE__ */ jsx16(
+    return /* @__PURE__ */ jsx18(
       "div",
       {
         "data-testid": `sample-pack-cta-checking-${pack.packId}`,
@@ -3036,16 +3539,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__ */ jsxs12(
+  return /* @__PURE__ */ jsxs14(
     "div",
     {
       "data-testid": `sample-pack-cta-${pack.packId}`,
       className: "flex flex-col items-center justify-center py-12 px-6 text-center",
       children: [
-        /* @__PURE__ */ jsx16("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
-        /* @__PURE__ */ jsx16("div", { className: "text-base text-sas-text mb-1", children: headline }),
-        /* @__PURE__ */ jsx16("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
-        /* @__PURE__ */ jsx16(
+        /* @__PURE__ */ jsx18("div", { className: "text-sm uppercase tracking-wide text-sas-muted mb-2", children: status === "stale" ? "Update available" : "Sample library not installed" }),
+        /* @__PURE__ */ jsx18("div", { className: "text-base text-sas-text mb-1", children: headline }),
+        /* @__PURE__ */ jsx18("div", { className: "text-xs text-sas-muted mb-6 max-w-md", children: sublabel }),
+        /* @__PURE__ */ jsx18(
           DownloadPackButton,
           {
             host,
@@ -3062,7 +3565,7 @@ var SamplePackCTACard = ({
 };
 
 // src/components/WaveformView.tsx
-import { useEffect as useEffect9, useRef as useRef8, useState as useState10 } from "react";
+import { useEffect as useEffect10, useRef as useRef9, useState as useState11 } from "react";
 
 // src/components/waveform.ts
 function computePeaks(audioBuffer, bins, targetSamples) {
@@ -3125,7 +3628,7 @@ function drawWaveform(canvas, peaks, options = {}) {
 }
 
 // src/components/WaveformView.tsx
-import { jsx as jsx17 } from "react/jsx-runtime";
+import { jsx as jsx19 } from "react/jsx-runtime";
 var WaveformView = ({
   host,
   filePath,
@@ -3134,9 +3637,9 @@ var WaveformView = ({
   fillStyle,
   targetSamples
 }) => {
-  const canvasRef = useRef8(null);
-  const [peaks, setPeaks] = useState10(null);
-  useEffect9(() => {
+  const canvasRef = useRef9(null);
+  const [peaks, setPeaks] = useState11(null);
+  useEffect10(() => {
     let cancelled = false;
     let audioContext = null;
     (async () => {
@@ -3162,7 +3665,7 @@ var WaveformView = ({
       cancelled = true;
     };
   }, [host, filePath, bins, targetSamples]);
-  useEffect9(() => {
+  useEffect10(() => {
     if (!peaks) return;
     const canvas = canvasRef.current;
     if (!canvas) return;
@@ -3173,7 +3676,7 @@ var WaveformView = ({
     observer.observe(canvas);
     return () => observer.disconnect();
   }, [peaks, fillStyle]);
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx19(
     "canvas",
     {
       ref: canvasRef,
@@ -3184,8 +3687,8 @@ var WaveformView = ({
 };
 
 // src/components/ScrollingWaveform.tsx
-import { useEffect as useEffect10, useRef as useRef9 } from "react";
-import { jsx as jsx18 } from "react/jsx-runtime";
+import { useEffect as useEffect11, useRef as useRef10 } from "react";
+import { jsx as jsx20 } from "react/jsx-runtime";
 var ScrollingWaveform = ({
   getPeakDb,
   active,
@@ -3193,11 +3696,11 @@ var ScrollingWaveform = ({
   className,
   fillStyle
 }) => {
-  const canvasRef = useRef9(null);
-  const ringRef = useRef9(new Float32Array(columns));
-  const writeIdxRef = useRef9(0);
-  const rafRef = useRef9(null);
-  useEffect10(() => {
+  const canvasRef = useRef10(null);
+  const ringRef = useRef10(new Float32Array(columns));
+  const writeIdxRef = useRef10(0);
+  const rafRef = useRef10(null);
+  useEffect11(() => {
     if (ringRef.current.length !== columns) {
       const next = new Float32Array(columns);
       const prev = ringRef.current;
@@ -3209,7 +3712,7 @@ var ScrollingWaveform = ({
       writeIdxRef.current = writeIdxRef.current % columns;
     }
   }, [columns]);
-  useEffect10(() => {
+  useEffect11(() => {
     if (!active) {
       if (rafRef.current !== null) {
         cancelAnimationFrame(rafRef.current);
@@ -3261,7 +3764,7 @@ var ScrollingWaveform = ({
       }
     };
   }, [active, getPeakDb, fillStyle]);
-  return /* @__PURE__ */ jsx18(
+  return /* @__PURE__ */ jsx20(
     "canvas",
     {
       ref: canvasRef,
@@ -3272,8 +3775,8 @@ var ScrollingWaveform = ({
 };
 
 // src/components/OffsetScrubber.tsx
-import { useCallback as useCallback7, useEffect as useEffect11, useMemo as useMemo4, useRef as useRef10, useState as useState11 } from "react";
-import { jsx as jsx19, jsxs as jsxs13 } from "react/jsx-runtime";
+import { useCallback as useCallback8, useEffect as useEffect12, useMemo as useMemo5, useRef as useRef11, useState as useState12 } from "react";
+import { jsx as jsx21, jsxs as jsxs15 } from "react/jsx-runtime";
 var SLIDER_HEIGHT_PX = 28;
 var TICK_HEIGHT_PX = 14;
 var DOWNBEAT_TICK_HEIGHT_PX = 22;
@@ -3286,40 +3789,40 @@ function OffsetScrubber({
   onChange,
   disabled = false
 }) {
-  const trackRef = useRef10(null);
-  const [draftOffset, setDraftOffset] = useState11(offsetSamples);
-  const [isDragging, setIsDragging] = useState11(false);
-  useEffect11(() => {
+  const trackRef = useRef11(null);
+  const [draftOffset, setDraftOffset] = useState12(offsetSamples);
+  const [isDragging, setIsDragging] = useState12(false);
+  useEffect12(() => {
     if (!isDragging) setDraftOffset(offsetSamples);
   }, [offsetSamples, isDragging]);
   const sampleRate = cuePoints?.sample_rate ?? 44100;
   const detectedBpm = cuePoints?.detected_bpm ?? projectBpm;
-  const beatsForRange = useMemo4(() => {
+  const beatsForRange = useMemo5(() => {
     return Math.round(60 / projectBpm * sampleRate);
   }, [projectBpm, sampleRate]);
   const rangeSamples = beatsForRange * meter;
-  const sampleToFraction = useCallback7(
+  const sampleToFraction = useCallback8(
     (sample) => {
       const clamped = Math.max(-rangeSamples, Math.min(rangeSamples, sample));
       return (clamped + rangeSamples) / (2 * rangeSamples);
     },
     [rangeSamples]
   );
-  const fractionToSample = useCallback7(
+  const fractionToSample = useCallback8(
     (fraction) => {
       const clamped = Math.max(0, Math.min(1, fraction));
       return Math.round(clamped * 2 * rangeSamples - rangeSamples);
     },
     [rangeSamples]
   );
-  const snapTargets = useMemo4(() => {
+  const snapTargets = useMemo5(() => {
     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 = useCallback7(
+  const snapToBeat = useCallback8(
     (sample) => {
       if (snapTargets.length === 0) return sample;
       let best = snapTargets[0];
@@ -3335,7 +3838,7 @@ function OffsetScrubber({
     },
     [snapTargets]
   );
-  const handlePointerDown = useCallback7(
+  const handlePointerDown = useCallback8(
     (e) => {
       if (disabled || !cuePoints) return;
       e.preventDefault();
@@ -3369,7 +3872,7 @@ function OffsetScrubber({
     },
     [disabled, cuePoints, fractionToSample, onChange, snapToBeat]
   );
-  const handleResetToZero = useCallback7(() => {
+  const handleResetToZero = useCallback8(() => {
     if (disabled) return;
     setDraftOffset(0);
     onChange(0);
@@ -3377,7 +3880,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 = useMemo4(() => {
+  const ticks = useMemo5(() => {
     if (!cuePoints) return [];
     const downbeat = cuePoints.beats[0] ?? 0;
     return cuePoints.beats.map((b, i) => {
@@ -3388,9 +3891,9 @@ function OffsetScrubber({
     });
   }, [cuePoints, sampleToFraction]);
   const isDisabled = disabled || !cuePoints || cuePoints.beats.length === 0;
-  return /* @__PURE__ */ jsxs13("div", { "data-testid": "offset-scrubber", className: "flex items-center gap-2 w-full", children: [
-    /* @__PURE__ */ jsx19("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
-    /* @__PURE__ */ jsxs13(
+  return /* @__PURE__ */ jsxs15("div", { "data-testid": "offset-scrubber", className: "flex items-center gap-2 w-full", children: [
+    /* @__PURE__ */ jsx21("span", { className: "text-[9px] text-sas-muted/60 uppercase tracking-wide flex-shrink-0", children: "Align" }),
+    /* @__PURE__ */ jsxs15(
       "div",
       {
         ref: trackRef,
@@ -3406,7 +3909,7 @@ function OffsetScrubber({
         "aria-valuenow": draftOffset,
         "aria-disabled": isDisabled,
         children: [
-          /* @__PURE__ */ jsx19(
+          /* @__PURE__ */ jsx21(
             "div",
             {
               "aria-hidden": "true",
@@ -3414,7 +3917,7 @@ function OffsetScrubber({
               style: { left: "50%" }
             }
           ),
-          ticks.map((t) => /* @__PURE__ */ jsx19(
+          ticks.map((t) => /* @__PURE__ */ jsx21(
             "div",
             {
               "data-testid": t.isDownbeat ? "offset-tick-downbeat" : "offset-tick",
@@ -3429,7 +3932,7 @@ function OffsetScrubber({
             },
             t.i
           )),
-          /* @__PURE__ */ jsx19(
+          /* @__PURE__ */ jsx21(
             "div",
             {
               "data-testid": "offset-scrubber-thumb",
@@ -3446,7 +3949,7 @@ function OffsetScrubber({
         ]
       }
     ),
-    /* @__PURE__ */ jsx19(
+    /* @__PURE__ */ jsx21(
       "span",
       {
         "data-testid": "offset-scrubber-readout",
@@ -3454,7 +3957,7 @@ function OffsetScrubber({
         children: formatOffset(draftOffset, sampleRate)
       }
     ),
-    /* @__PURE__ */ jsx19(
+    /* @__PURE__ */ jsx21(
       "button",
       {
         type: "button",
@@ -3466,7 +3969,7 @@ function OffsetScrubber({
         children: "\u2316"
       }
     ),
-    bpmMismatch && /* @__PURE__ */ jsx19(
+    bpmMismatch && /* @__PURE__ */ jsx21(
       "span",
       {
         "data-testid": "offset-bpm-mismatch",
@@ -3538,13 +4041,13 @@ function synthesizeCuePoints({
 }
 
 // src/hooks/useSceneState.ts
-import { useState as useState12, useCallback as useCallback8, useRef as useRef11 } from "react";
+import { useState as useState13, useCallback as useCallback9, useRef as useRef12 } from "react";
 function useSceneState(activeSceneId, initialValue) {
-  const [stateMap, setStateMap] = useState12(() => /* @__PURE__ */ new Map());
-  const activeSceneIdRef = useRef11(activeSceneId);
+  const [stateMap, setStateMap] = useState13(() => /* @__PURE__ */ new Map());
+  const activeSceneIdRef = useRef12(activeSceneId);
   activeSceneIdRef.current = activeSceneId;
   const currentValue = activeSceneId !== null && stateMap.has(activeSceneId) ? stateMap.get(activeSceneId) : initialValue;
-  const setForCurrentScene = useCallback8((value) => {
+  const setForCurrentScene = useCallback9((value) => {
     const sid = activeSceneIdRef.current;
     if (sid === null) return;
     setStateMap((prev) => {
@@ -3555,7 +4058,7 @@ function useSceneState(activeSceneId, initialValue) {
       return newMap;
     });
   }, [initialValue]);
-  const setForScene = useCallback8((sceneId, value) => {
+  const setForScene = useCallback9((sceneId, value) => {
     setStateMap((prev) => {
       const current = prev.has(sceneId) ? prev.get(sceneId) : initialValue;
       const next = typeof value === "function" ? value(current) : value;
@@ -3568,10 +4071,10 @@ function useSceneState(activeSceneId, initialValue) {
 }
 
 // src/hooks/useAnySolo.ts
-import { useEffect as useEffect12, useState as useState13 } from "react";
+import { useEffect as useEffect13, useState as useState14 } from "react";
 function useAnySolo(host) {
-  const [anySolo, setAnySolo] = useState13(false);
-  useEffect12(() => {
+  const [anySolo, setAnySolo] = useState14(false);
+  useEffect13(() => {
     let active = true;
     const refresh = () => {
       host.isAnySoloActive().then((v) => {
@@ -3590,7 +4093,7 @@ function useAnySolo(host) {
 }
 
 // src/hooks/useSoundHistory.ts
-import { useCallback as useCallback9, useMemo as useMemo5, useRef as useRef12, useState as useState14 } from "react";
+import { useCallback as useCallback10, useMemo as useMemo6, useRef as useRef13, useState as useState15 } from "react";
 var EMPTY = { entries: [], cursor: -1 };
 function sameDescriptor(a, b) {
   if (a === b) return true;
@@ -3602,14 +4105,14 @@ function sameDescriptor(a, b) {
 }
 function useSoundHistory(applySound, opts = {}) {
   const max = Math.max(2, opts.max ?? 24);
-  const applyRef = useRef12(applySound);
+  const applyRef = useRef13(applySound);
   applyRef.current = applySound;
-  const onChangeRef = useRef12(opts.onChange);
+  const onChangeRef = useRef13(opts.onChange);
   onChangeRef.current = opts.onChange;
-  const dataRef = useRef12({});
-  const [, setVersion] = useState14(0);
-  const bump = useCallback9(() => setVersion((v) => v + 1), []);
-  const commit = useCallback9(
+  const dataRef = useRef13({});
+  const [, setVersion] = useState15(0);
+  const bump = useCallback10(() => setVersion((v) => v + 1), []);
+  const commit = useCallback10(
     (trackId, next, notify) => {
       dataRef.current = { ...dataRef.current, [trackId]: next };
       bump();
@@ -3617,7 +4120,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [bump]
   );
-  const record = useCallback9(
+  const record = useCallback10(
     (trackId, descriptor, label) => {
       const h = dataRef.current[trackId];
       const current = h && h.cursor >= 0 ? h.entries[h.cursor] : void 0;
@@ -3632,7 +4135,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [max, commit]
   );
-  const restoreTo = useCallback9(
+  const restoreTo = useCallback10(
     async (trackId, index) => {
       const h = dataRef.current[trackId];
       if (!h || index < 0 || index >= h.entries.length || index === h.cursor) return false;
@@ -3642,7 +4145,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const undo = useCallback9(
+  const undo = useCallback10(
     (trackId) => {
       const h = dataRef.current[trackId];
       if (!h || h.cursor <= 0) return Promise.resolve(false);
@@ -3650,7 +4153,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [restoreTo]
   );
-  const toggleFavorite = useCallback9(
+  const toggleFavorite = useCallback10(
     (trackId, index) => {
       const h = dataRef.current[trackId];
       if (!h || index < 0 || index >= h.entries.length) return;
@@ -3659,7 +4162,7 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const restore = useCallback9(
+  const restore = useCallback10(
     (trackId, state) => {
       const entries = Array.isArray(state?.entries) ? [...state.entries] : [];
       const raw = typeof state?.cursor === "number" ? state.cursor : entries.length - 1;
@@ -3668,15 +4171,15 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [commit]
   );
-  const list = useCallback9(
+  const list = useCallback10(
     (trackId) => dataRef.current[trackId] ?? EMPTY,
     []
   );
-  const canUndo = useCallback9((trackId) => {
+  const canUndo = useCallback10((trackId) => {
     const h = dataRef.current[trackId];
     return !!h && h.cursor > 0;
   }, []);
-  const clear = useCallback9(
+  const clear = useCallback10(
     (trackId) => {
       if (dataRef.current[trackId]) {
         const next = { ...dataRef.current };
@@ -3688,18 +4191,18 @@ function useSoundHistory(applySound, opts = {}) {
     },
     [bump]
   );
-  const reset = useCallback9(() => {
+  const reset = useCallback10(() => {
     dataRef.current = {};
     bump();
   }, [bump]);
-  return useMemo5(
+  return useMemo6(
     () => ({ record, undo, restoreTo, list, canUndo, clear, reset, restore, toggleFavorite }),
     [record, undo, restoreTo, list, canUndo, clear, reset, restore, toggleFavorite]
   );
 }
 
 // src/hooks/useTrackReorder.ts
-import { useCallback as useCallback10, useRef as useRef13, useState as useState15 } from "react";
+import { useCallback as useCallback11, useRef as useRef14, useState as useState16 } from "react";
 function moveItem(arr, from, to) {
   const next = arr.slice();
   if (from === to || from < 0 || to < 0 || from >= next.length || to >= next.length) {
@@ -3716,12 +4219,12 @@ function useTrackReorder({
   getId,
   onError
 }) {
-  const [draggingIndex, setDraggingIndex] = useState15(null);
-  const [dragOverIndex, setDragOverIndex] = useState15(null);
-  const fromRef = useRef13(null);
-  const itemsRef = useRef13(items);
+  const [draggingIndex, setDraggingIndex] = useState16(null);
+  const [dragOverIndex, setDragOverIndex] = useState16(null);
+  const fromRef = useRef14(null);
+  const itemsRef = useRef14(items);
   itemsRef.current = items;
-  const dragPropsFor = useCallback10(
+  const dragPropsFor = useCallback11(
     (index) => ({
       handleProps: {
         draggable: true,
@@ -3783,7 +4286,7 @@ function useTrackReorder({
 }
 
 // src/constants/sdk-version.ts
-var PLUGIN_SDK_VERSION = "2.25.0";
+var PLUGIN_SDK_VERSION = "2.28.0";
 
 // src/utils/format-concurrent-tracks.ts
 function formatConcurrentTracks(ctx) {
@@ -3943,6 +4446,8 @@ export {
   FX_DISPLAY_LABELS,
   FX_ENGINE_PLUGIN_NAMES,
   FX_PRESET_CONFIGS,
+  FadeModal,
+  FadeTrackRow,
   FxToggleBar,
   GUTTER_W,
   ImportTrackModal,
@@ -3961,6 +4466,7 @@ export {
   SamplePackCTACard,
   ScrollingWaveform,
   SorceryProgressBar,
+  TEXTURAL_ROLES,
   TrackDrawer,
   TrackMeterStrip,
   TrackRow,
@@ -3968,17 +4474,21 @@ export {
   WaveformView,
   analyzeWavPeak,
   asCrossfadeMeta,
+  asFadeMeta,
   buildCrossfadeInpaintPrompt,
   buildCrossfadeVolumeCurves,
+  buildFadeVolumeCurve,
   calculateTimeBasedTarget,
   cellToPx,
   centerScrollTop,
   computePeaks,
   dbToSlider,
+  defaultFadeGesture,
   drawWaveform,
   formatConcurrentTracks,
   moveItem,
   parseCrossfadePairs,
+  parseFades,
   pickTopKWeighted,
   pitchToName,
   pxToCell,