voxflow 1.15.2 → 1.15.4

package/lib/stage-ui/slice/template.js

@@ -231,6 +231,121 @@ function renderSliceStageHtml({ sourcePath, port }) {
     }
     .render-btn.completed:hover { filter: none; text-decoration: underline; }
 
+    /* Secondary (de-emphasised) render variant for "the other path". When the
+       user has no cached login, local becomes primary and cloud takes this
+       style; when they're logged in, local takes this style. The pair is
+       always visible — the emphasis just flips. */
+    .render-btn.secondary {
+      background: transparent; color: var(--text);
+      border-color: var(--border); font-weight: 500;
+    }
+    .render-btn.secondary:hover:not(:disabled) {
+      border-color: var(--accent); filter: none;
+    }
+    .render-btn.secondary.completed { color: var(--accent); }
+
+    /* Local-render mini-progress bar shown next to the local button while a
+       job is rendering. Sits inline with the button so the header doesn't
+       reflow. */
+    .render-local-progress {
+      display: inline-flex; align-items: center; gap: 6px;
+      font-size: 11px; color: var(--muted);
+      font-variant-numeric: tabular-nums;
+    }
+    .render-local-progress.hidden { display: none; }
+    .render-local-progress .bar {
+      width: 90px; height: 4px; border-radius: 2px;
+      background: var(--panel-2); overflow: hidden;
+      border: 1px solid var(--border);
+    }
+    .render-local-progress .bar > span {
+      display: block; height: 100%;
+      background: var(--accent);
+      transition: width 0.15s ease;
+    }
+
+    /* Toast that confirms the local mp4 was written. Persistent — user
+       dismisses with the close button. The "Open in Finder" link is a
+       file:// href; browser security may block click-to-open without a
+       prior user gesture, so we render it as a plain link. */
+    .local-render-toast {
+      position: fixed; right: 16px; bottom: 16px; z-index: 60;
+      max-width: 360px;
+      background: var(--panel); color: var(--text);
+      border: 1px solid var(--good); border-radius: 8px;
+      box-shadow: 0 8px 32px rgba(0,0,0,0.2);
+      padding: 10px 12px;
+      font-size: 12px;
+      display: none; flex-direction: column; gap: 6px;
+    }
+    .local-render-toast.open { display: flex; }
+    .local-render-toast .toast-head {
+      display: flex; align-items: center; gap: 6px;
+      font-weight: 600; color: var(--good);
+    }
+    .local-render-toast .toast-head .grow { flex: 1; }
+    .local-render-toast .toast-head .close {
+      appearance: none; border: 0; background: transparent;
+      color: var(--muted); font-size: 16px; line-height: 1;
+      padding: 0 4px; cursor: pointer;
+    }
+    .local-render-toast .path {
+      font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+      font-size: 11px; color: var(--muted); word-break: break-all;
+    }
+    .local-render-toast .actions { display: flex; gap: 8px; }
+    .local-render-toast .actions a, .local-render-toast .actions button {
+      appearance: none; cursor: pointer; font: inherit;
+      font-size: 11px; padding: 4px 8px; border-radius: 4px;
+      border: 1px solid var(--border); background: var(--panel-2);
+      color: var(--text); text-decoration: none;
+    }
+    .local-render-toast .actions a:hover,
+    .local-render-toast .actions button:hover { border-color: var(--accent); }
+
+    /* Inline-edit affordance — textarea replaces the caption / narration / title
+       text in place. Mirrors the original element's metrics so the card layout
+       doesn't jump when the user clicks to edit. */
+    .stage-card .editable {
+      cursor: text;
+      border-radius: 3px;
+      padding: 1px 3px; margin: -1px -3px;
+      transition: background 0.12s ease, outline 0.12s ease;
+    }
+    .stage-card .editable:hover {
+      background: rgba(0,0,0,0.04);
+      outline: 1px dashed rgba(0,0,0,0.2);
+    }
+    .stage-card[data-card-bg="dark"] .editable:hover {
+      background: rgba(255,255,255,0.06);
+      outline: 1px dashed rgba(255,255,255,0.25);
+    }
+    .stage-card textarea.inline-edit {
+      width: 100%; min-height: 1.6em;
+      font: inherit; color: inherit;
+      background: rgba(0,0,0,0.05);
+      border: 1px solid currentColor; border-radius: 3px;
+      padding: 2px 4px; margin: -2px -4px;
+      resize: none; outline: none;
+      box-shadow: 0 0 0 2px color-mix(in srgb, currentColor 25%, transparent);
+    }
+    .stage-card[data-card-bg="dark"] textarea.inline-edit {
+      background: rgba(255,255,255,0.08);
+    }
+    .stage-card .inline-edit-err {
+      position: absolute; left: 10px; right: 10px; bottom: 10px;
+      background: var(--bad); color: white;
+      font-size: 10px; line-height: 1.3;
+      padding: 4px 6px; border-radius: 4px;
+      z-index: 5;
+    }
+    .stage-card .inline-edit-hint {
+      position: absolute; left: 10px; right: 10px; bottom: 4px;
+      font-size: 9px; color: var(--muted); letter-spacing: 0.04em;
+      text-align: center; pointer-events: none; opacity: 0.7;
+      z-index: 4;
+    }
+
     .render-modal-body { display: flex; flex-direction: column; gap: 8px; padding: 4px 0 6px; }
     .render-modal-body .quota-line {
       display: flex; justify-content: space-between; align-items: baseline;
@@ -432,6 +547,49 @@ function renderSliceStageHtml({ sourcePath, port }) {
     .deck-toolbar button.copied {
       color: var(--good); border-color: var(--good);
     }
+    /* ─── Audition (▶) — voice picker + per-card play + status ────────────── */
+    .toolbar-divider {
+      width: 1px; align-self: stretch;
+      background: var(--border); margin: 2px 4px;
+    }
+    .voice-picker {
+      display: inline-flex; align-items: center; gap: 6px;
+      border: 1px solid var(--border); border-radius: 8px;
+      padding: 0 8px; font-size: 12px;
+    }
+    .voice-picker:focus-within { border-color: var(--accent); }
+    .voice-picker-icon { color: var(--muted); font-size: 12px; }
+    #voice-picker-input {
+      appearance: none; border: 0; background: transparent;
+      font: inherit; color: var(--text); font-size: 12px;
+      padding: 6px 0; width: 180px; outline: none;
+    }
+    .stage-card .card-actions button[data-action="audition"] .audition-icon {
+      display: inline-block; margin-right: 4px; font-size: 9px;
+    }
+    .stage-card .card-actions button[data-action="audition"].playing {
+      background: rgba(88,81,184,0.92); color: #fff;
+    }
+    .stage-card .card-actions button[data-action="audition"].loading {
+      background: rgba(0,0,0,0.45); color: #fff; cursor: progress;
+    }
+    .stage-card .card-actions button[data-action="audition"].error {
+      background: rgba(239,68,68,0.92); color: #fff;
+    }
+    .audition-status {
+      display: inline-flex; align-items: center;
+      font-size: 11px; color: var(--muted);
+      padding: 4px 10px; border-radius: 6px;
+      max-width: 320px;
+      overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+    }
+    .audition-status[data-state="loading"] { color: var(--accent); }
+    .audition-status[data-state="cache"] {
+      color: var(--good); background: rgba(34,197,94,0.08);
+    }
+    .audition-status[data-state="error"] {
+      color: #b91c1c; background: rgba(239,68,68,0.08);
+    }
 
     .selection-fab {
       position: fixed; z-index: 50;
@@ -600,9 +758,17 @@ function renderSliceStageHtml({ sourcePath, port }) {
       <span class="dot" id="dot"></span>
       <span id="status-label">connecting…</span>
     </div>
-    <button class="render-btn" id="render-btn" type="button" aria-label="Render this deck to mp4 (cloud)">
-      <span class="icon">▶</span>
-      <span id="render-btn-label">Render mp4</span>
+    <span class="render-local-progress hidden" id="render-local-progress" aria-live="polite">
+      <span class="bar"><span id="render-local-progress-fill" style="width:0%"></span></span>
+      <span id="render-local-progress-label">0%</span>
+    </span>
+    <button class="render-btn" id="render-local-btn" type="button" aria-label="Render this deck to mp4 locally (no cloud, no quota)" title="Render locally with @remotion/renderer — no network, no quota">
+      <span class="icon">⬇</span>
+      <span id="render-local-btn-label">Render mp4 (local)</span>
+    </button>
+    <button class="render-btn secondary" id="render-btn" type="button" aria-label="Render this deck to mp4 (cloud)" title="Submit to cloud renderer — costs 200 quota">
+      <span class="icon">☁</span>
+      <span id="render-btn-label">Render mp4 (cloud)</span>
     </button>
     <button class="versions-btn" id="versions-btn" type="button" aria-label="Show version history" aria-expanded="false">
       <span class="icon">📚</span>
@@ -642,7 +808,14 @@ function renderSliceStageHtml({ sourcePath, port }) {
         <button id="copy-json-btn" type="button" disabled title="Copy raw deck.json to clipboard">Copy JSON</button>
         <button id="download-json-btn" type="button" disabled title="Save deck.json to disk">Download .json</button>
         <button id="copy-md-btn" type="button" disabled title="Copy as Markdown — paste into Notion / blog / 飞书">Copy as Markdown</button>
+        <span class="toolbar-divider" aria-hidden="true"></span>
+        <label class="voice-picker" title="Voice ID override (empty = let card.voiceover.voiceId or default win)">
+          <span class="voice-picker-icon" aria-hidden="true">♪</span>
+          <input id="voice-picker-input" type="text" placeholder="Voice (default)" spellcheck="false" autocomplete="off" aria-label="Voice override for audition" />
+        </label>
+        <span class="audition-status" id="audition-status" hidden aria-live="polite"></span>
       </div>
+      <audio id="audition-audio" preload="none"></audio>
       <div id="cards-pane" class="empty">Waiting for deck…</div>
     </section>
     <section>
@@ -662,6 +835,21 @@ function renderSliceStageHtml({ sourcePath, port }) {
     <span>✏</span><span>Edit selection with AI</span>
   </button>
 
+  <div class="local-render-toast" id="local-render-toast" role="status" aria-live="polite">
+    <div class="toast-head">
+      <span>✓</span>
+      <span>Local render complete</span>
+      <span class="grow"></span>
+      <button class="close" id="local-render-toast-close" type="button" aria-label="Close">×</button>
+    </div>
+    <div class="path" id="local-render-toast-path"></div>
+    <div class="actions">
+      <a id="local-render-toast-open" href="#" target="_blank" rel="noopener">Open mp4</a>
+      <a id="local-render-toast-reveal" href="#">Open folder</a>
+      <button id="local-render-toast-copy" type="button">Copy path</button>
+    </div>
+  </div>
+
   <div class="modal-backdrop" id="render-modal" role="dialog" aria-modal="true" aria-labelledby="render-modal-title" hidden>
     <div class="modal">
       <div class="modal-header">
@@ -880,6 +1068,123 @@ function renderSliceStageHtml({ sourcePath, port }) {
         copyTextToClipboard(formatCardAsText(card), btn);
       });
 
+      // ─── Per-card Audition (▶) — fetch /api/audition, play in <audio>. ────
+      // Voice override comes from the toolbar voice-picker input; empty input
+      // means let the server bridge resolve via the documented precedence
+      // (card.voiceover.voiceId → card.voiceId → SYNTHESIZE_DEFAULTS.voice).
+      // Status bar surfaces loading / cache HIT / upstream error so the user
+      // can spot quota or auth issues without opening browser devtools.
+      var auditionAudio = document.getElementById('audition-audio');
+      var auditionStatus = document.getElementById('audition-status');
+      var voicePickerInput = document.getElementById('voice-picker-input');
+      var currentAuditionBtn = null;
+
+      function setAuditionStatus(state, message) {
+        if (!auditionStatus) return;
+        if (!state) {
+          auditionStatus.hidden = true;
+          auditionStatus.removeAttribute('data-state');
+          auditionStatus.textContent = '';
+          return;
+        }
+        auditionStatus.hidden = false;
+        auditionStatus.dataset.state = state;
+        auditionStatus.textContent = message || '';
+      }
+
+      function resetAuditionBtn(btn) {
+        if (!btn) return;
+        btn.classList.remove('playing', 'loading', 'error');
+        var icon = btn.querySelector('.audition-icon');
+        if (icon) icon.textContent = '▶';
+      }
+
+      cardsPane.addEventListener('click', function (ev) {
+        var btn = ev.target.closest && ev.target.closest('[data-action="audition"]');
+        if (!btn || !currentDeck) return;
+        var idx = parseInt(btn.getAttribute('data-card-index'), 10);
+        if (!Number.isFinite(idx)) return;
+
+        // Click on the currently playing button = stop + reset.
+        if (currentAuditionBtn === btn && !auditionAudio.paused) {
+          auditionAudio.pause();
+          auditionAudio.currentTime = 0;
+          resetAuditionBtn(btn);
+          currentAuditionBtn = null;
+          setAuditionStatus(null);
+          return;
+        }
+        // Reset a previously playing button (if any) when starting a new one.
+        if (currentAuditionBtn && currentAuditionBtn !== btn) {
+          resetAuditionBtn(currentAuditionBtn);
+        }
+
+        currentAuditionBtn = btn;
+        btn.classList.remove('error');
+        btn.classList.add('loading');
+        var icon = btn.querySelector('.audition-icon');
+        if (icon) icon.textContent = '⟳';
+        setAuditionStatus('loading', 'Synthesizing card ' + (idx + 1) + '…');
+
+        var voiceOverride = (voicePickerInput && voicePickerInput.value.trim()) || '';
+        var url = '/api/audition?card=' + encodeURIComponent(idx)
+          + (voiceOverride ? '&voice=' + encodeURIComponent(voiceOverride) : '');
+
+        fetch(url, { method: 'GET', credentials: 'same-origin' })
+          .then(function (res) {
+            var cache = res.headers.get('X-Audition-Cache') || '';
+            if (!res.ok) {
+              return res.json().then(function (j) {
+                throw new Error((j && j.message) || ('HTTP ' + res.status));
+              }, function () {
+                throw new Error('HTTP ' + res.status);
+              });
+            }
+            return res.blob().then(function (blob) { return { blob: blob, cache: cache }; });
+          })
+          .then(function (out) {
+            var objectUrl = URL.createObjectURL(out.blob);
+            auditionAudio.src = objectUrl;
+            return auditionAudio.play().then(function () {
+              btn.classList.remove('loading');
+              btn.classList.add('playing');
+              if (icon) icon.textContent = '❚❚';
+              setAuditionStatus(
+                out.cache === 'HIT' ? 'cache' : 'loading',
+                out.cache === 'HIT' ? 'Cache hit — no quota used.' : 'Playing card ' + (idx + 1) + '.'
+              );
+            });
+          })
+          .catch(function (err) {
+            btn.classList.remove('loading', 'playing');
+            btn.classList.add('error');
+            if (icon) icon.textContent = '!';
+            setAuditionStatus('error', String(err && err.message || err));
+            setTimeout(function () {
+              if (currentAuditionBtn === btn) currentAuditionBtn = null;
+              resetAuditionBtn(btn);
+            }, 3000);
+          });
+      });
+
+      auditionAudio.addEventListener('ended', function () {
+        if (currentAuditionBtn) {
+          resetAuditionBtn(currentAuditionBtn);
+          currentAuditionBtn = null;
+        }
+        setAuditionStatus(null);
+      });
+      auditionAudio.addEventListener('error', function () {
+        if (currentAuditionBtn) {
+          currentAuditionBtn.classList.remove('loading', 'playing');
+          currentAuditionBtn.classList.add('error');
+          var ic = currentAuditionBtn.querySelector('.audition-icon');
+          if (ic) ic.textContent = '!';
+          currentAuditionBtn = null;
+        }
+        setAuditionStatus('error', 'Audio playback failed.');
+      });
+
       // For highlighting cards that just changed on hot-reload, we keep a
       // hash of each card's stringified JSON. On the next deck event we
       // diff per-index and add the just-changed CSS class to whichever
@@ -924,16 +1229,34 @@ function renderSliceStageHtml({ sourcePath, port }) {
           if (Array.isArray(card.title)) titleArr = card.title;
           else if (typeof card.title === 'string') titleArr = [card.title];
           else titleArr = ['(card ' + (i + 1) + ')'];
+          // Each title line is independently editable — saving rewrites the
+          // entire title[] array, so a click on line 0 mutates only that
+          // index and leaves the rest as-is.
           titleHtml = '<div class="title-text">'
-            + titleArr.map(function (line) {
-                return '<span class="line">' + escapeHtml(line) + '</span>';
+            + titleArr.map(function (line, lineIdx) {
+                return '<span class="line editable" data-edit-field="title" data-edit-index="'
+                  + lineIdx + '" title="Click to edit, Esc to cancel, Cmd/Ctrl+Enter to save">'
+                  + escapeHtml(line) + '</span>';
               }).join('')
             + '</div>';
         } else {
           var caption = typeof card.caption === 'string' ? card.caption : ('Card ' + (i + 1));
           var narration = typeof card.narration === 'string' ? card.narration : '';
-          titleHtml = '<div class="caption">' + escapeHtml(caption) + '</div>'
-            + (narration ? '<div class="narration">' + escapeHtml(narration) + '</div>' : '');
+          // body cards may have caption + narration; only caption is editable
+          // here when caption exists (some cards lack caption — quote/data/list).
+          // Narration is editable on every non-title card.
+          var captionHtml = (typeof card.caption === 'string')
+            ? '<div class="caption editable" data-edit-field="caption" title="Click to edit">'
+                + escapeHtml(caption) + '</div>'
+            : '<div class="caption">' + escapeHtml(caption) + '</div>';
+          var narrationHtml = narration
+            ? '<div class="narration editable" data-edit-field="narration" title="Click to edit narration">'
+                + escapeHtml(narration) + '</div>'
+            : (kind === 'body'
+                ? '<div class="narration editable" data-edit-field="narration" data-empty="1"'
+                  + ' title="Click to add narration" style="opacity:0.4">+ narration</div>'
+                : '');
+          titleHtml = captionHtml + narrationHtml;
         }
 
         var figureChip = card.figureKeyword
@@ -961,6 +1284,10 @@ function renderSliceStageHtml({ sourcePath, port }) {
           + '<div class="body">' + titleHtml + '</div>'
           + '<div class="accent-bar"></div>'
           + '<div class="card-actions">'
+              + '<button type="button" data-action="audition" data-card-index="' + i + '"'
+              + ' aria-label="Audition card ' + (i + 1) + ' voiceover" title="Play TTS preview — uses card.voiceover or card.narration, costs 100 quota first time then cached">'
+              + '<span class="audition-icon" aria-hidden="true">▶</span>Audition'
+              + '</button>'
               + '<button type="button" data-action="copy-card" data-card-index="' + i + '"'
               + ' aria-label="Copy card ' + (i + 1) + ' as text">Copy text</button>'
           + '</div>'
@@ -1099,6 +1426,40 @@ function renderSliceStageHtml({ sourcePath, port }) {
         es.addEventListener('open', function () {
           setStatus('good', 'live');
         });
+
+        // ─── Local-render progress fan-in (same SSE channel as deck) ──────
+        es.addEventListener('render-local-progress', function (e) {
+          try {
+            var msg = JSON.parse(e.data);
+            if (!msg || msg.jobId !== renderLocalJobId) return;
+            var pct = (typeof msg.progress === 'number' ? msg.progress : 0) * 100;
+            showLocalProgress(pct);
+            if (renderLocalState !== 'rendering') {
+              renderLocalState = 'rendering';
+              refreshRenderLocalBtn();
+            }
+          } catch (_) { /* malformed — ignore */ }
+        });
+        es.addEventListener('render-local-done', function (e) {
+          try {
+            var msg = JSON.parse(e.data);
+            if (!msg || msg.jobId !== renderLocalJobId) return;
+            renderLocalState = 'completed';
+            refreshRenderLocalBtn();
+            hideLocalProgress();
+            showToast(msg.outputPath);
+          } catch (_) { /* ignore */ }
+        });
+        es.addEventListener('render-local-error', function (e) {
+          try {
+            var msg = JSON.parse(e.data);
+            if (!msg || msg.jobId !== renderLocalJobId) return;
+            renderLocalState = 'failed';
+            refreshRenderLocalBtn();
+            hideLocalProgress();
+            alert('Local render failed: ' + (msg.message || 'unknown error'));
+          } catch (_) { /* ignore */ }
+        });
       }
       connect();
 
@@ -1461,6 +1822,298 @@ function renderSliceStageHtml({ sourcePath, port }) {
 
       refreshRenderBtn();
 
+      // ─── Render to MP4 (local, @remotion/renderer) ──────────────────────
+      // Mirrors the cloud renderer state machine but skips the JWT / quota
+      // dance. Progress arrives on the deck SSE channel (server fans out
+      // render-local-progress / render-local-done / render-local-error) so
+      // we add listeners inside connect()/onmessage below — see the SSE
+      // wiring further down for that fan-in.
+      var renderLocalBtn = document.getElementById('render-local-btn');
+      var renderLocalBtnLabel = document.getElementById('render-local-btn-label');
+      var renderLocalProgress = document.getElementById('render-local-progress');
+      var renderLocalProgressFill = document.getElementById('render-local-progress-fill');
+      var renderLocalProgressLabel = document.getElementById('render-local-progress-label');
+      var toast = document.getElementById('local-render-toast');
+      var toastPath = document.getElementById('local-render-toast-path');
+      var toastOpen = document.getElementById('local-render-toast-open');
+      var toastReveal = document.getElementById('local-render-toast-reveal');
+      var toastCopy = document.getElementById('local-render-toast-copy');
+      var toastClose = document.getElementById('local-render-toast-close');
+
+      var renderLocalState = 'idle';     // idle | submitting | rendering | completed | failed
+      var renderLocalJobId = null;
+      var renderLocalOutput = null;
+
+      function refreshRenderLocalBtn() {
+        renderLocalBtn.classList.remove('completed');
+        if (renderLocalState === 'idle' || renderLocalState === 'failed') {
+          renderLocalBtn.disabled = false;
+          renderLocalBtnLabel.textContent = 'Render mp4 (local)';
+        } else if (renderLocalState === 'submitting') {
+          renderLocalBtn.disabled = true;
+          renderLocalBtnLabel.textContent = 'Starting…';
+        } else if (renderLocalState === 'rendering') {
+          renderLocalBtn.disabled = true;
+          renderLocalBtnLabel.textContent = 'Rendering…';
+        } else if (renderLocalState === 'completed') {
+          renderLocalBtn.disabled = false;
+          renderLocalBtn.classList.add('completed');
+          renderLocalBtnLabel.textContent = 'Re-render local';
+        }
+      }
+      function showLocalProgress(pct) {
+        renderLocalProgress.classList.remove('hidden');
+        var clamped = Math.max(0, Math.min(100, pct));
+        renderLocalProgressFill.style.width = clamped.toFixed(1) + '%';
+        renderLocalProgressLabel.textContent = clamped.toFixed(0) + '%';
+      }
+      function hideLocalProgress() {
+        renderLocalProgress.classList.add('hidden');
+        renderLocalProgressFill.style.width = '0%';
+        renderLocalProgressLabel.textContent = '0%';
+      }
+      function showToast(outputPath) {
+        renderLocalOutput = outputPath;
+        toastPath.textContent = outputPath;
+        // file:// link only renders if the user copy-pastes — Chrome blocks
+        // file:// navigation from http://. We still expose the URL via Copy
+        // path, and the anchor itself is a no-op fallback.
+        var fileUrl = 'file://' + outputPath;
+        toastOpen.setAttribute('href', fileUrl);
+        toastReveal.setAttribute('href', 'file://' + outputPath.replace(/[^/]+$/, ''));
+        toast.classList.add('open');
+      }
+      function hideToast() { toast.classList.remove('open'); }
+
+      toastClose.addEventListener('click', hideToast);
+      toastCopy.addEventListener('click', function () {
+        if (!renderLocalOutput) return;
+        copyTextToClipboard(renderLocalOutput, toastCopy);
+      });
+
+      renderLocalBtn.addEventListener('click', function () {
+        if (renderLocalState === 'rendering' || renderLocalState === 'submitting') return;
+        if (!currentDeck || !Array.isArray(currentDeck.cards)) {
+          alert('No deck loaded — fix the JSON parse error first.');
+          return;
+        }
+        renderLocalState = 'submitting';
+        refreshRenderLocalBtn();
+        showLocalProgress(0);
+        hideToast();
+        fetch('/api/render-local', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          credentials: 'omit',
+          body: JSON.stringify({}),  // server reads the live snapshot
+        })
+          .then(function (r) { return r.json().then(function (j) { return { status: r.status, json: j }; }); })
+          .then(function (resp) {
+            if (resp.status !== 200 || resp.json.code !== 'success') {
+              renderLocalState = 'failed';
+              refreshRenderLocalBtn();
+              hideLocalProgress();
+              alert('Local render failed: ' + (resp.json.message || ('HTTP ' + resp.status)));
+              return;
+            }
+            renderLocalJobId = resp.json.jobId;
+            renderLocalOutput = resp.json.outputPath;
+            renderLocalState = 'rendering';
+            refreshRenderLocalBtn();
+          })
+          .catch(function (err) {
+            renderLocalState = 'failed';
+            refreshRenderLocalBtn();
+            hideLocalProgress();
+            alert('Network error: ' + err.message);
+          });
+      });
+
+      // Auth-state probe — flips the visual emphasis between local and cloud
+      // render. When the user is logged out (no cached JWT), the local
+      // button stays primary and the cloud button gets the secondary style
+      // (already the default in the HTML). Logged in: emphasis flips.
+      fetch('/api/auth-state', { credentials: 'omit' })
+        .then(function (r) { return r.ok ? r.json() : null; })
+        .then(function (j) {
+          if (!j) return;
+          if (j.tokenAvailable) {
+            // Cloud → primary, local → secondary
+            renderBtn.classList.remove('secondary');
+            renderLocalBtn.classList.add('secondary');
+          }
+        })
+        .catch(function () { /* leave defaults; logged-out is the safer assumption */ });
+
+      refreshRenderLocalBtn();
+
+      // ─── Inline edit (caption / narration / title rows) ─────────────────
+      // Conservative scope: only "safe" text fields are click-to-edit. theme,
+      // figureKeyword, kind, and card add/delete still require external
+      // editor (or AI-prompt flow above). Save trigger: blur or Cmd/Ctrl+
+      // Enter. Cancel: Escape.
+      var activeInlineEdit = null;  // { node, originalText, cardIdx, field, lineIdx }
+
+      function cancelInlineEdit() {
+        if (!activeInlineEdit) return;
+        var ed = activeInlineEdit;
+        activeInlineEdit = null;
+        var ta = ed.node.querySelector && ed.node.querySelector('textarea.inline-edit');
+        // Restore original text — we re-render the card label from
+        // currentDeck so theme styles re-apply cleanly.
+        ed.node.textContent = ed.originalText;
+        if (ed.errNode && ed.errNode.parentNode) ed.errNode.parentNode.removeChild(ed.errNode);
+        if (ed.hintNode && ed.hintNode.parentNode) ed.hintNode.parentNode.removeChild(ed.hintNode);
+      }
+
+      function applyEditToDeck(deck, cardIdx, field, lineIdx, newValue) {
+        // Returns a shallow-copied deck with the single field replaced.
+        // Never mutates the original; the save endpoint validates the result.
+        var copy = JSON.parse(JSON.stringify(deck));
+        var card = copy.cards && copy.cards[cardIdx];
+        if (!card) return null;
+        if (field === 'caption') card.caption = newValue;
+        else if (field === 'narration') {
+          if (newValue === '') {
+            delete card.narration;
+          } else {
+            card.narration = newValue;
+          }
+        }
+        else if (field === 'title') {
+          if (!Array.isArray(card.title)) card.title = [];
+          card.title[lineIdx] = newValue;
+        }
+        return copy;
+      }
+
+      function commitInlineEdit(newValue) {
+        if (!activeInlineEdit) return;
+        var ed = activeInlineEdit;
+        if (newValue === ed.originalText) {
+          cancelInlineEdit();
+          return;
+        }
+        var updatedDeck = applyEditToDeck(currentDeck, ed.cardIdx, ed.field, ed.lineIdx, newValue);
+        if (!updatedDeck) { cancelInlineEdit(); return; }
+
+        // Optimistically swap in the new text so the user sees it instantly;
+        // server validation may still reject (rare — schema caps). If it
+        // does, we restore originalText and surface the error inline.
+        var node = ed.node;
+        node.textContent = newValue;
+        var ta = node.querySelector && node.querySelector('textarea.inline-edit');
+        if (ta) ta.remove();
+        if (ed.hintNode && ed.hintNode.parentNode) ed.hintNode.parentNode.removeChild(ed.hintNode);
+        if (ed.errNode && ed.errNode.parentNode) ed.errNode.parentNode.removeChild(ed.errNode);
+        node.style.opacity = '0.6';
+
+        var snapshot = ed;
+        activeInlineEdit = null;
+
+        fetch('/api/deck', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          credentials: 'omit',
+          body: JSON.stringify({ deck: updatedDeck }),
+        })
+          .then(function (r) { return r.json().then(function (j) { return { status: r.status, json: j }; }); })
+          .then(function (resp) {
+            node.style.opacity = '';
+            if (resp.status !== 200 || resp.json.code !== 'success') {
+              // Restore + surface the validation error inline. The file
+              // watcher will not have fired (we didn't write), so the page
+              // text needs explicit revert.
+              node.textContent = snapshot.originalText;
+              var card = node.closest && node.closest('.stage-card');
+              if (card) {
+                var err = document.createElement('div');
+                err.className = 'inline-edit-err';
+                err.textContent = resp.json.message || 'Save rejected';
+                card.appendChild(err);
+                setTimeout(function () { if (err.parentNode) err.parentNode.removeChild(err); }, 3500);
+              }
+              return;
+            }
+            // Success — watcher will broadcast deck SSE, which re-renders
+            // the card with the new value + diff highlight ring. Nothing
+            // more to do here.
+          })
+          .catch(function (err) {
+            node.style.opacity = '';
+            node.textContent = snapshot.originalText;
+            alert('Save failed: ' + err.message);
+          });
+      }
+
+      function startInlineEdit(node) {
+        if (activeInlineEdit) return;
+        var card = node.closest && node.closest('.stage-card');
+        if (!card) return;
+        var cardIdx = parseInt(card.getAttribute('data-card-idx'), 10);
+        if (!Number.isFinite(cardIdx)) return;
+        var field = node.getAttribute('data-edit-field');
+        var lineIdx = parseInt(node.getAttribute('data-edit-index') || '0', 10);
+        if (!Number.isFinite(lineIdx)) lineIdx = 0;
+        var isEmpty = node.getAttribute('data-empty') === '1';
+        var original = isEmpty ? '' : node.textContent;
+        var ta = document.createElement('textarea');
+        ta.className = 'inline-edit';
+        ta.value = original;
+        // Approximate visual metrics so the card doesn't reflow noticeably.
+        var rect = node.getBoundingClientRect();
+        ta.style.minHeight = Math.max(20, rect.height) + 'px';
+        ta.rows = field === 'narration' ? 4 : 2;
+        node.textContent = '';
+        node.appendChild(ta);
+        var hint = document.createElement('div');
+        hint.className = 'inline-edit-hint';
+        hint.textContent = 'Cmd/Ctrl+Enter: save · Esc: cancel · blur: save';
+        card.appendChild(hint);
+
+        activeInlineEdit = {
+          node: node,
+          originalText: original,
+          cardIdx: cardIdx,
+          field: field,
+          lineIdx: lineIdx,
+          hintNode: hint,
+          errNode: null,
+        };
+
+        ta.focus();
+        ta.setSelectionRange(0, ta.value.length);
+
+        ta.addEventListener('keydown', function (e) {
+          if (e.key === 'Escape') {
+            e.preventDefault();
+            cancelInlineEdit();
+          } else if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+            e.preventDefault();
+            commitInlineEdit(ta.value);
+          }
+        });
+        ta.addEventListener('blur', function () {
+          // Use rAF so escape-keydown (which calls cancelInlineEdit) wins the
+          // race against blur. By the time rAF fires, activeInlineEdit will
+          // be null if the user pressed Escape.
+          requestAnimationFrame(function () {
+            if (!activeInlineEdit || activeInlineEdit.node !== node) return;
+            commitInlineEdit(ta.value);
+          });
+        });
+      }
+
+      cardsPane.addEventListener('click', function (ev) {
+        var target = ev.target.closest && ev.target.closest('.editable');
+        if (!target) return;
+        // Don't intercept clicks while an edit is already running on this
+        // same node — the textarea inside catches its own events.
+        if (target.querySelector && target.querySelector('textarea.inline-edit')) return;
+        ev.stopPropagation();
+        startInlineEdit(target);
+      });
+
       // ─── Edit-with-AI: prompt builder (mirrors stage-core/edit-prompt.js) ─
       // Kept as a small in-browser duplicate because the template is an
       // inline string — pulling the Node module across the boundary would