pi-studio 0.9.51 → 0.9.52

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.9.52] — 2026-08-28
+
+### Added
+- Add a visible **Enlarge** control for embedded PDF cards, plus **Copy path** alongside PDF actions that operate on the computer running Pi.
+
+### Changed
+- Offer true browser fullscreen only when the current browser exposes the Fullscreen API, while retaining Studio's in-page image, PDF, and HTML focus viewers everywhere.
+- Keep ordinary images and rendered PDF figures unobscured by using their hover zoom cursor and whole-media click target instead of overlay buttons.
+
+### Fixed
+- Restore a clear, explicitly sized H1–H6 hierarchy in rendered Markdown without allowing application-header styles to override document headings.
+- Apply click-to-focus image behavior consistently to Side-question and Quiz Markdown as well as the main Editor, Response, and Working surfaces.
+- Keep image, rendered-PDF, and PDF-card actions interactive after the response pane resets its scroll position by adding clone-safe delegated handling; preserve rendered PDF canvas pixels across the reset so inline and enlarged figures do not become blank; show contextual success/failure feedback for host PDF actions.
+- Hide side-thread-only Markdown save, copy, and editor actions from ordinary Response, Editor Preview, and REPL export menus, with a runtime guard against stale menu activation.
+
 ## [0.9.51] — 2026-08-26
 
 ### Added

package/README.md

@@ -2,6 +2,8 @@
 
 Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace for working with prompts, responses, live working details, Markdown and LaTeX documents, interactive HTML previews, code files, REPL sessions, and other common text-based files side by side. Annotate responses and files, add local comments, write, edit, run prompts, send code to a REPL, browse prompt and response history, request critiques, and use live preview for code, Markdown, LaTeX, and interactive HTML.
 
+See [`ROADMAP.md`](./ROADMAP.md) for the current release plan.
+
 ## Quick demo
 
 [Watch the 2-minute demo (MP4, 2x speed, no audio)](https://github.com/omaclaren/pi-studio/releases/latest/download/pi-studio-demo-2min.mp4)
@@ -52,10 +54,10 @@ _The video shows an earlier version of the Studio interface. The basic workflow
   - shows/hides annotation markers in preview
   - strips markers before send (optional)
   - saves `.annotated.md`
-- Renders Markdown/LaTeX/code previews (math + Mermaid) plus lightweight CSV/TSV table previews, theme-synced with pi, with copy buttons for code blocks and blockquotes; Mermaid previews include Lucide/Logos icon nodes and accessible label contrast over custom fills
+- Renders Markdown/LaTeX/code previews (math + Mermaid) plus lightweight CSV/TSV table previews, theme-synced with pi, with an explicit H1–H6 hierarchy, zoomable images across Studio-owned Markdown surfaces, and copy buttons for code blocks and blockquotes; Mermaid previews include Lucide/Logos icon nodes and accessible label contrast over custom fills
 - Adds a contextual **Editor (Quarto Preview)** right-pane view for file-backed `.qmd`, `.md`, and `.markdown` documents. Studio checks Quarto and the document/project configuration before showing an explicit start action, launches a single loopback `quarto preview` process with `--no-execute`, embeds Quarto's authoritative saved-file output without restyling it, and provides open-in-browser, restart, stop, logs, and unsaved-editor warnings. If Quarto is missing, the view remains available with an actionable dependency message.
 - Renders straight, unfenced interactive HTML in preview via a sandboxed browser iframe with zoom controls, while fenced `html` blocks remain source code
-- Embeds local PDFs in Studio Markdown previews via explicit `studio-pdf` fenced blocks and opens existing PDFs directly with `/studio <path.pdf>`, with Focus, browser-tab, system-viewer, show-in-folder, manual refresh, and opt-in stable-file auto-refresh actions
+- Embeds local PDFs in Studio Markdown previews via explicit `studio-pdf` fenced blocks and opens existing PDFs directly with `/studio <path.pdf>`, with visible enlarge, browser-tab, system-viewer, show-in-folder, copy-path, manual refresh, and opt-in stable-file auto-refresh actions; true browser fullscreen is offered only when the browser supports it
 - Ships optional `pi-studio-dark` and `pi-studio-light` themes tuned for Studio's browser workspace
 - Exports right-pane preview as PDF (pandoc + LaTeX) or standalone HTML into the source file directory, Studio working directory, or Pi session directory; PDF export can open in a Studio preview tab or the default PDF viewer, and HTML export can open in the default browser or in a new Studio editor tab for inspection/commenting, while preserving authored HTML previews as HTML and rendering CSV/TSV editor previews as tables
 - Exports local files headlessly via `/studio-pdf <path>` to `<name>.studio.pdf` or `/studio-html <path>` to `<name>.studio.html`; without a path, those commands export the last model response to a timestamped file. Agent tools `studio_export_pdf` and `studio_export_html` expose the same export pipeline for remote/Telegram-style sessions.

package/ROADMAP.md

@@ -0,0 +1,74 @@
+# Pi Studio roadmap
+
+This is the current planning source of truth for Studio work. `NEXT-STAGE.md` is historical; `TODO.md` tracks smaller backlog items that are not yet assigned to a release.
+
+## Release approach
+
+Studio development follows two tracks:
+
+- **Stable `0.9.x` releases** contain one coherent family of fixes or incremental features and keep `main` releasable.
+- **`0.10.0`** is reserved for the buffer-first document architecture. Risky prereleases should use the npm `next` tag before replacing `latest`.
+
+Changes should be based on capabilities rather than browser, terminal host, or user-agent detection. Muxy, ordinary Chromium browsers, embedded WebKit views, and SSH/headless use are validation environments, not separate product variants.
+
+Each release should finish with:
+
+1. focused regression tests plus the full test suite;
+2. TypeScript and JavaScript syntax checks;
+3. production dependency audit;
+4. exact package-content and byte-level artifact audit;
+5. a fresh npm installation and naturally rendered Studio smoke test.
+
+Publishing, pushing, and tagging remain explicit release actions rather than automatic consequences of merging work.
+
+## 0.9.52 — Rendering and media consistency
+
+A focused portability and affordance pass:
+
+- scope application-header typography so it cannot override rendered Markdown;
+- define an explicit, visibly ordered H1–H6 scale;
+- apply image focus consistently across Studio-owned same-document Markdown surfaces;
+- give embedded PDF cards and rendered PDF figures an obvious enlarge action;
+- expose true browser fullscreen only when the Fullscreen API is available, while retaining Studio's in-page focus viewer everywhere;
+- make local PDF actions clearly refer to the computer running Pi and provide **Copy path** alongside system-viewer and file-manager actions.
+
+This release must not add Muxy-specific branches or attempt to instrument opaque Quarto/authored-HTML iframe contents.
+
+## 0.9.53 — Resource locations
+
+Replace the single-root assumption with explicit resource grants:
+
+- grant the current document directory automatically;
+- allow an exact file or additional folder to be granted explicitly;
+- keep grants session-scoped by default;
+- store canonical server-side paths and retain traversal and symlink-escape checks;
+- use the same grants for Markdown resources, local links, PDFs, Files view, and Side questions;
+- explain that paths, Finder/file-manager actions, and system viewers belong to the computer running Pi;
+- offer **Allow this file**, **Allow this folder for this Studio session**, and **Cancel** when an explicit local link crosses the current boundary.
+
+The resource-location registry should be workspace-level rather than tied to the current editor document so it remains compatible with multiple buffers. Remembering grants per project can follow after the session-only model is proven.
+
+## 0.10.0 — Buffer-first editing
+
+The first architectural `0.10` release should add:
+
+- a `StudioBufferStore` with stable document identity;
+- recovery schema v2 with migration from the single-document schema;
+- buffer-specific text/baseline, dirty state, cursor, selection, scroll, preview context, annotations, and resource directory;
+- tabs at ordinary widths and a compact searchable buffer picker at narrow widths;
+- MRU cycling, next/previous, close, and reopen commands;
+- originating buffer ID and revision targeting for asynchronous Pi work.
+
+PDFs remain preview documents, and conversation history remains session-global. Split panes, arbitrary layouts, project trees, and simultaneous per-buffer Pi conversations are outside the initial `0.10.0` scope.
+
+## Validation matrix
+
+Cross-environment checks should cover, where relevant:
+
+- full and editor-only Studio;
+- file-backed and detached documents;
+- ordinary Chromium and embedded WebKit browser surfaces;
+- local, SSH, and `--no-browser` Pi sessions;
+- paths with spaces, Unicode, traversal attempts, and symlinks;
+- supported and unavailable browser APIs;
+- browser reconstruction, refresh recovery, and clean shutdown.

package/client/studio-client.js

@@ -296,6 +296,7 @@
       let studioPdfFocusOpenLinkEl = null;
       let studioPdfFocusSystemViewerBtn = null;
       let studioPdfFocusRevealBtn = null;
+      let studioPdfFocusCopyPathBtn = null;
       let studioPdfFocusAutoRefreshBtn = null;
       let studioPdfFocusFullscreenBtn = null;
       let studioPdfFocusCloseBtn = null;
@@ -305,6 +306,7 @@
       let studioPdfFocusSourceCard = null;
       let studioPdfFocusStandaloneAutoRefreshState = null;
       const studioPdfCardAutoRefreshStates = new WeakMap();
+      const studioPdfActionFeedbackStates = new WeakMap();
       const STUDIO_PDF_AUTO_REFRESH_INTERVAL_MS = 1_000;
       const STUDIO_PDF_AUTO_REFRESH_STABLE_OBSERVATIONS = 2;
       let studioHtmlFocusOverlayEl = null;
@@ -6715,10 +6717,22 @@
         button.setAttribute("aria-pressed", focused ? "true" : "false");
       }
 
+      function isStudioFullscreenAvailable(element) {
+        return Boolean(
+          element
+          && typeof element.requestFullscreen === "function"
+          && typeof document.exitFullscreen === "function"
+        );
+      }
+
       function syncStudioHtmlFocusFullscreenButton() {
         const button = studioHtmlFocusFullscreenBtn;
         if (!button) return;
         const shell = studioHtmlFocusShellEl;
+        const available = isStudioFullscreenAvailable(shell);
+        button.hidden = !available;
+        button.setAttribute("aria-hidden", available ? "false" : "true");
+        if (!available) return;
         const isFullscreen = Boolean(shell && document.fullscreenElement && document.fullscreenElement === shell);
         button.replaceChildren(makeStudioUiRefreshIcon(isFullscreen ? "fullscreen-exit" : "fullscreen"));
         const label = isFullscreen ? "Exit fullscreen" : "Fullscreen";
@@ -7191,9 +7205,9 @@
         systemViewerBtn.type = "button";
         systemViewerBtn.className = "studio-pdf-focus-btn studio-pdf-focus-system-viewer";
         systemViewerBtn.textContent = "System viewer";
-        systemViewerBtn.title = "Open the local PDF in the operating system's default PDF viewer.";
+        systemViewerBtn.title = "Open the local PDF in the default viewer on the computer running Pi.";
         systemViewerBtn.addEventListener("click", () => {
-          void runStudioPdfLocalAction("system-viewer", studioPdfFocusResourceQuery);
+          void runStudioPdfLocalAction("system-viewer", studioPdfFocusResourceQuery, systemViewerBtn);
         });
         actions.appendChild(systemViewerBtn);
 
@@ -7201,12 +7215,22 @@
         revealBtn.type = "button";
         revealBtn.className = "studio-pdf-focus-btn studio-pdf-focus-reveal";
         revealBtn.textContent = "Show in folder";
-        revealBtn.title = "Reveal the local PDF in Finder or the system file manager.";
+        revealBtn.title = "Reveal the local PDF in the file manager on the computer running Pi.";
         revealBtn.addEventListener("click", () => {
-          void runStudioPdfLocalAction("reveal", studioPdfFocusResourceQuery);
+          void runStudioPdfLocalAction("reveal", studioPdfFocusResourceQuery, revealBtn);
         });
         actions.appendChild(revealBtn);
 
+        const copyPathBtn = document.createElement("button");
+        copyPathBtn.type = "button";
+        copyPathBtn.className = "studio-pdf-focus-btn studio-pdf-focus-copy-path";
+        copyPathBtn.textContent = "Copy path";
+        copyPathBtn.title = "Copy the PDF path on the computer running Pi.";
+        copyPathBtn.addEventListener("click", () => {
+          void copyStudioPdfResourcePath(studioPdfFocusResourceQuery, copyPathBtn);
+        });
+        actions.appendChild(copyPathBtn);
+
         const refreshBtn = document.createElement("button");
         refreshBtn.type = "button";
         refreshBtn.className = "studio-pdf-focus-btn studio-pdf-focus-refresh";
@@ -7282,6 +7306,7 @@
         studioPdfFocusOpenLinkEl = openLink;
         studioPdfFocusSystemViewerBtn = systemViewerBtn;
         studioPdfFocusRevealBtn = revealBtn;
+        studioPdfFocusCopyPathBtn = copyPathBtn;
         studioPdfFocusAutoRefreshBtn = autoRefreshBtn;
         studioPdfFocusFullscreenBtn = fullscreenBtn;
         studioPdfFocusCloseBtn = closeBtn;
@@ -7576,9 +7601,33 @@
         return setStudioPdfAutoRefreshEnabled(state, !state.enabled);
       }
 
-      async function runStudioPdfLocalAction(action, resourceQuery) {
+      function flashStudioPdfActionFeedback(buttonEl, label, level) {
+        if (!(buttonEl instanceof HTMLButtonElement)) return;
+        const existing = studioPdfActionFeedbackStates.get(buttonEl) || null;
+        if (existing && existing.timer) window.clearTimeout(existing.timer);
+        const state = {
+          baselineText: existing ? existing.baselineText : buttonEl.textContent,
+          baselineAriaLabel: existing ? existing.baselineAriaLabel : buttonEl.getAttribute("aria-label"),
+          timer: null,
+        };
+        studioPdfActionFeedbackStates.set(buttonEl, state);
+        buttonEl.textContent = String(label || "Done");
+        buttonEl.dataset.studioActionFeedback = level === "warning" ? "warning" : "success";
+        buttonEl.setAttribute("aria-label", String(label || "Done"));
+        state.timer = window.setTimeout(() => {
+          if (studioPdfActionFeedbackStates.get(buttonEl) !== state) return;
+          buttonEl.textContent = state.baselineText;
+          if (state.baselineAriaLabel === null) buttonEl.removeAttribute("aria-label");
+          else buttonEl.setAttribute("aria-label", state.baselineAriaLabel);
+          delete buttonEl.dataset.studioActionFeedback;
+          studioPdfActionFeedbackStates.delete(buttonEl);
+        }, 2_200);
+      }
+
+      async function runStudioPdfLocalAction(action, resourceQuery, actionButton) {
         const query = normalizeStudioPdfResourceQuery(resourceQuery);
         if (!query) {
+          flashStudioPdfActionFeedback(actionButton, "Unavailable", "warning");
           setStatus("Could not resolve this PDF's local path.", "warning");
           return false;
         }
@@ -7589,11 +7638,13 @@
             method: "POST",
             body: JSON.stringify(query),
           });
+          flashStudioPdfActionFeedback(actionButton, openInSystemViewer ? "Opened ✓" : "Shown ✓", "success");
           setStatus(payload && payload.message
             ? payload.message
             : (openInSystemViewer ? "Opened PDF in the system viewer." : "Revealed PDF in the file manager."), "success");
           return true;
         } catch (error) {
+          flashStudioPdfActionFeedback(actionButton, "Failed", "warning");
           setStatus((error && error.message)
             ? error.message
             : (openInSystemViewer ? "Could not open PDF in the system viewer." : "Could not reveal PDF in the file manager."), "warning");
@@ -7605,6 +7656,31 @@
         const available = Boolean(normalizeStudioPdfResourceQuery(studioPdfFocusResourceQuery));
         if (studioPdfFocusSystemViewerBtn) studioPdfFocusSystemViewerBtn.disabled = !available;
         if (studioPdfFocusRevealBtn) studioPdfFocusRevealBtn.disabled = !available;
+        if (studioPdfFocusCopyPathBtn) studioPdfFocusCopyPathBtn.disabled = !available;
+      }
+
+      async function copyStudioPdfResourcePath(resourceQuery, actionButton) {
+        const query = normalizeStudioPdfResourceQuery(resourceQuery);
+        if (!query) {
+          flashStudioPdfActionFeedback(actionButton, "Unavailable", "warning");
+          setStatus("Could not resolve this PDF's local path.", "warning");
+          return false;
+        }
+        try {
+          const payload = await fetchStudioJson("/local-preview-link", {
+            query: { ...query, action: "resolve" },
+          });
+          const path = payload && typeof payload.path === "string" ? payload.path : "";
+          if (!path) throw new Error("Studio did not return a PDF path.");
+          if (!(await writeTextToClipboard(path))) throw new Error("Clipboard write failed.");
+          flashStudioPdfActionFeedback(actionButton, "Copied ✓", "success");
+          setStatus("Copied PDF path from the computer running Pi.", "success");
+          return true;
+        } catch (error) {
+          flashStudioPdfActionFeedback(actionButton, "Failed", "warning");
+          setStatus((error && error.message) ? error.message : "Could not copy this PDF's local path.", "warning");
+          return false;
+        }
       }
 
       function buildRefreshedStudioPdfViewerUrl(value) {
@@ -7731,6 +7807,10 @@
 
       function syncStudioPdfFocusFullscreenButton() {
         if (!studioPdfFocusFullscreenBtn) return;
+        const available = isStudioFullscreenAvailable(studioPdfFocusDialogEl);
+        studioPdfFocusFullscreenBtn.hidden = !available;
+        studioPdfFocusFullscreenBtn.setAttribute("aria-hidden", available ? "false" : "true");
+        if (!available) return;
         const isFullscreen = Boolean(document.fullscreenElement && studioPdfFocusDialogEl && document.fullscreenElement === studioPdfFocusDialogEl);
         studioPdfFocusFullscreenBtn.replaceChildren(makeStudioUiRefreshIcon(isFullscreen ? "fullscreen-exit" : "fullscreen"));
         const label = isFullscreen ? "Exit fullscreen" : "Fullscreen";
@@ -7789,6 +7869,16 @@
         studioPdfFocusFrameEl.title = String(title || "PDF focus viewer").trim() || "PDF focus viewer";
       }
 
+      function getStudioPdfCardResourceQuery(card) {
+        return card && card.dataset
+          ? normalizeStudioPdfResourceQuery({
+              path: card.dataset.studioPdfPath || "",
+              sourcePath: card.dataset.studioPdfSourcePath || "",
+              resourceDir: card.dataset.studioPdfResourceDir || "",
+            })
+          : null;
+      }
+
       function openStudioPdfFocusFromButton(buttonEl) {
         if (!buttonEl) return false;
         const card = buttonEl.closest && buttonEl.closest(".studio-pdf-card");
@@ -7798,13 +7888,7 @@
           || String(card && card.dataset ? (card.dataset.studioPdfTitle || "") : "").trim()
           || "PDF preview";
         const sourceFrame = card && typeof card.querySelector === "function" ? card.querySelector("iframe.studio-pdf-frame") : null;
-        const resourceQuery = card && card.dataset
-          ? normalizeStudioPdfResourceQuery({
-              path: card.dataset.studioPdfPath || "",
-              sourcePath: card.dataset.studioPdfSourcePath || "",
-              resourceDir: card.dataset.studioPdfResourceDir || "",
-            })
-          : null;
+        const resourceQuery = getStudioPdfCardResourceQuery(card);
         if (!viewerUrl) return false;
         openStudioPdfFocusViewer(viewerUrl, title, sourceFrame, resourceQuery, card);
         return true;
@@ -7824,6 +7908,73 @@
         }
       }
 
+      function consumeStudioPreviewMediaEvent(event) {
+        event.preventDefault();
+        event.stopPropagation();
+        if (typeof event.stopImmediatePropagation === "function") event.stopImmediatePropagation();
+      }
+
+      function handleStudioPreviewMediaKeydown(event) {
+        if (!event || (event.key !== "Enter" && event.key !== " ")) return;
+        const target = event.target;
+        const imageEl = target instanceof Element ? target.closest("img.studio-image-focus-target") : null;
+        if (!imageEl) return;
+        consumeStudioPreviewMediaEvent(event);
+        if (!openPreviewImageElementInFocus(imageEl)) setStatus("Could not open image focus view.", "warning");
+      }
+
+      function handleStudioPreviewMediaActivation(event) {
+        const target = event && event.target;
+        if (!(target instanceof Element)) return;
+
+        const imageEl = target.closest("img.studio-image-focus-target");
+        if (imageEl) {
+          consumeStudioPreviewMediaEvent(event);
+          if (!openPreviewImageElementInFocus(imageEl)) setStatus("Could not open image focus view.", "warning");
+          return;
+        }
+
+        const pdfFigureEl = target.closest(".studio-pdf-preview-focus-target");
+        if (pdfFigureEl && !target.closest("button, a")) {
+          consumeStudioPreviewMediaEvent(event);
+          if (!openPreviewPdfFigureInFocus(pdfFigureEl)) setStatus("Could not enlarge this PDF figure preview.", "warning");
+          return;
+        }
+
+        const actionBtn = target.closest(
+          ".studio-pdf-card-system-viewer, .studio-pdf-card-reveal, .studio-pdf-card-copy-path, .studio-pdf-card-refresh, .studio-pdf-card-auto-refresh"
+        );
+        if (!actionBtn) return;
+        const card = actionBtn.closest(".studio-pdf-card");
+        if (!card) return;
+        consumeStudioPreviewMediaEvent(event);
+        const resourceQuery = getStudioPdfCardResourceQuery(card);
+        if (actionBtn.classList.contains("studio-pdf-card-system-viewer")) {
+          void runStudioPdfLocalAction("system-viewer", resourceQuery, actionBtn);
+          return;
+        }
+        if (actionBtn.classList.contains("studio-pdf-card-reveal")) {
+          void runStudioPdfLocalAction("reveal", resourceQuery, actionBtn);
+          return;
+        }
+        if (actionBtn.classList.contains("studio-pdf-card-copy-path")) {
+          void copyStudioPdfResourcePath(resourceQuery, actionBtn);
+          return;
+        }
+        if (actionBtn.classList.contains("studio-pdf-card-refresh")) {
+          const refreshed = refreshStudioPdfCard(card);
+          flashStudioPdfActionFeedback(actionBtn, refreshed ? "Refreshed ✓" : "Failed", refreshed ? "success" : "warning");
+          if (!refreshed) setStatus("Could not refresh this PDF preview.", "warning");
+          return;
+        }
+        const state = ensureStudioPdfCardAutoRefreshState(card, resourceQuery);
+        if (!state) {
+          setStatus("Could not resolve this PDF for auto-refresh.", "warning");
+          return;
+        }
+        setStudioPdfCardAutoRefresh(card, !state.enabled);
+      }
+
       function isStudioImageFocusOpen() {
         return Boolean(studioImageFocusOverlayEl && studioImageFocusOverlayEl.hidden === false);
       }
@@ -7976,6 +8127,10 @@
 
       function syncStudioImageFocusFullscreenButton() {
         if (!studioImageFocusFullscreenBtn) return;
+        const available = isStudioFullscreenAvailable(studioImageFocusDialogEl);
+        studioImageFocusFullscreenBtn.hidden = !available;
+        studioImageFocusFullscreenBtn.setAttribute("aria-hidden", available ? "false" : "true");
+        if (!available) return;
         const isFullscreen = Boolean(document.fullscreenElement && studioImageFocusDialogEl && document.fullscreenElement === studioImageFocusDialogEl);
         studioImageFocusFullscreenBtn.replaceChildren(makeStudioUiRefreshIcon(isFullscreen ? "fullscreen-exit" : "fullscreen"));
         const label = isFullscreen ? "Exit fullscreen" : "Fullscreen";
@@ -8212,6 +8367,39 @@
         });
       }
 
+      function openPreviewPdfFigureInFocus(previewEl) {
+        const canvas = previewEl && typeof previewEl.querySelector === "function"
+          ? previewEl.querySelector("canvas")
+          : null;
+        if (!(canvas instanceof HTMLCanvasElement)) return false;
+        try {
+          const dataUrl = canvas.toDataURL("image/png");
+          const title = String(previewEl.getAttribute("title") || "PDF figure preview").trim() || "PDF figure preview";
+          return openStudioImageFocusViewer(dataUrl, title);
+        } catch {
+          return false;
+        }
+      }
+
+      function decoratePreviewPdfFigures(targetEl) {
+        if (!targetEl || typeof targetEl.querySelectorAll !== "function") return;
+        const previews = Array.from(targetEl.querySelectorAll(".studio-pdf-preview"));
+        previews.forEach((previewEl) => {
+          if (!(previewEl instanceof HTMLElement)) return;
+          if (previewEl.dataset && previewEl.dataset.studioPdfFigureFocusDecorated === "1") return;
+          if (!previewEl.querySelector("canvas")) return;
+          previewEl.classList.add("studio-pdf-preview-focus-target");
+          previewEl.title = "PDF figure preview (page 1). Click to enlarge.";
+          if (previewEl.dataset) previewEl.dataset.studioPdfFigureFocusDecorated = "1";
+
+          previewEl.addEventListener("click", (event) => {
+            if (event.target instanceof Element && event.target.closest("button, a")) return;
+            event.preventDefault();
+            if (!openPreviewPdfFigureInFocus(previewEl)) setStatus("Could not enlarge this PDF figure preview.", "warning");
+          });
+        });
+      }
+
       function createStudioPdfCard(block, useEditorResourceContext) {
         const options = block && block.options ? block.options : {};
         const path = String(options.path || "").trim();
@@ -8244,12 +8432,13 @@
           focusBtn.type = "button";
           focusBtn.className = "studio-pdf-card-action studio-pdf-card-focus";
           focusBtn.title = "Open this PDF in a larger Studio overlay.";
-          focusBtn.setAttribute("aria-label", "Focus PDF");
+          focusBtn.setAttribute("aria-label", "Enlarge PDF");
           if (focusBtn.dataset) {
             focusBtn.dataset.studioPdfViewerUrl = viewerUrl;
             focusBtn.dataset.studioPdfTitle = title;
           }
           focusBtn.appendChild(makeStudioUiRefreshIcon("focus"));
+          focusBtn.appendChild(document.createTextNode("Enlarge"));
           focusBtn.addEventListener("click", handleStudioPdfFocusButtonClick);
           titleGroup.appendChild(focusBtn);
         }
@@ -8276,11 +8465,11 @@
           systemViewerBtn.type = "button";
           systemViewerBtn.className = "studio-pdf-card-action studio-pdf-card-system-viewer";
           systemViewerBtn.textContent = "System viewer";
-          systemViewerBtn.title = "Open the local PDF in the operating system's default PDF viewer.";
+          systemViewerBtn.title = "Open the local PDF in the default viewer on the computer running Pi.";
           systemViewerBtn.addEventListener("click", (event) => {
             event.preventDefault();
             event.stopPropagation();
-            void runStudioPdfLocalAction("system-viewer", resourceQuery);
+            void runStudioPdfLocalAction("system-viewer", resourceQuery, systemViewerBtn);
           });
           actions.appendChild(systemViewerBtn);
 
@@ -8288,14 +8477,26 @@
           revealBtn.type = "button";
           revealBtn.className = "studio-pdf-card-action studio-pdf-card-reveal";
           revealBtn.textContent = "Show in folder";
-          revealBtn.title = "Reveal the local PDF in Finder or the system file manager.";
+          revealBtn.title = "Reveal the local PDF in the file manager on the computer running Pi.";
           revealBtn.addEventListener("click", (event) => {
             event.preventDefault();
             event.stopPropagation();
-            void runStudioPdfLocalAction("reveal", resourceQuery);
+            void runStudioPdfLocalAction("reveal", resourceQuery, revealBtn);
           });
           actions.appendChild(revealBtn);
 
+          const copyPathBtn = document.createElement("button");
+          copyPathBtn.type = "button";
+          copyPathBtn.className = "studio-pdf-card-action studio-pdf-card-copy-path";
+          copyPathBtn.textContent = "Copy path";
+          copyPathBtn.title = "Copy the PDF path on the computer running Pi.";
+          copyPathBtn.addEventListener("click", (event) => {
+            event.preventDefault();
+            event.stopPropagation();
+            void copyStudioPdfResourcePath(resourceQuery, copyPathBtn);
+          });
+          actions.appendChild(copyPathBtn);
+
           const refreshBtn = document.createElement("button");
           refreshBtn.type = "button";
           refreshBtn.className = "studio-pdf-card-action studio-pdf-card-refresh";
@@ -9238,6 +9439,32 @@
         });
       }
 
+      function copyResponsePaneCanvasState(sourceEl, replacementEl) {
+        if (!sourceEl || !replacementEl || typeof sourceEl.querySelectorAll !== "function" || typeof replacementEl.querySelectorAll !== "function") {
+          return false;
+        }
+        const sourceCanvases = Array.from(sourceEl.querySelectorAll("canvas"));
+        const replacementCanvases = Array.from(replacementEl.querySelectorAll("canvas"));
+        if (sourceCanvases.length !== replacementCanvases.length) return false;
+
+        for (let index = 0; index < sourceCanvases.length; index += 1) {
+          const sourceCanvas = sourceCanvases[index];
+          const replacementCanvas = replacementCanvases[index];
+          if (!(sourceCanvas instanceof HTMLCanvasElement) || !(replacementCanvas instanceof HTMLCanvasElement)) return false;
+          if (sourceCanvas.width < 1 || sourceCanvas.height < 1) continue;
+          try {
+            replacementCanvas.width = sourceCanvas.width;
+            replacementCanvas.height = sourceCanvas.height;
+            const context = replacementCanvas.getContext("2d");
+            if (!context) return false;
+            context.drawImage(sourceCanvas, 0, 0);
+          } catch {
+            return false;
+          }
+        }
+        return true;
+      }
+
       function replaceResponsePaneWithClone() {
         const currentEl = critiqueViewEl;
         if (!currentEl || !currentEl.parentNode || typeof currentEl.cloneNode !== "function") {
@@ -9245,7 +9472,7 @@
         }
 
         const replacement = currentEl.cloneNode(true);
-        if (!replacement || replacement.nodeType !== 1) {
+        if (!replacement || replacement.nodeType !== 1 || !copyResponsePaneCanvasState(currentEl, replacement)) {
           return currentEl;
         }
 
@@ -10019,6 +10246,10 @@
 
       function exportRightPaneFormat(format) {
         closeExportPreviewMenu();
+        if (String(format || "").startsWith("side-markdown-") && rightView !== "side-questions") {
+          setStatus("Side-thread Markdown export is available only in Side questions.", "warning");
+          return false;
+        }
         if (format === "side-markdown-save") {
           return saveSideQuestionTranscriptMarkdown();
         }
@@ -10259,6 +10490,7 @@
           await renderAnnotationMathInElement(targetEl);
           decoratePdfEmbeds(targetEl);
           await renderPdfPreviewsInElement(targetEl);
+          decoratePreviewPdfFigures(targetEl);
           const annotationMode = (pane === "source" || pane === "response")
             ? (annotationsEnabled ? "highlight" : "hide")
             : "none";
@@ -12141,6 +12373,7 @@
             await renderMermaidInElement(target);
             await renderMathFallbackInElement(target);
             decorateCopyablePreviewBlocks(target);
+            decoratePreviewImages(target);
           } catch (error) {
             console.error("Side-question markdown preview failed:", error);
             target.classList.add("side-question-markdown-failed");
@@ -15015,9 +15248,11 @@
             await renderAnnotationMathInElement(target);
             decoratePdfEmbeds(target);
             await renderPdfPreviewsInElement(target);
+            decoratePreviewPdfFigures(target);
             await renderMermaidInElement(target);
             await renderMathFallbackInElement(target);
             decorateCopyablePreviewBlocks(target);
+            decoratePreviewImages(target);
             if (preserveScroll) restoreQuizScrollTopSoon(scrollTop);
           } catch (error) {
             console.error("Quiz markdown preview render failed:", error);
@@ -23552,6 +23787,9 @@
         });
       }
 
+      document.addEventListener("click", handleStudioPreviewMediaActivation, true);
+      document.addEventListener("keydown", handleStudioPreviewMediaKeydown, true);
+
       document.addEventListener("click", (event) => {
         const target = event.target;
         const focusBtn = target instanceof Element ? target.closest(".studio-pdf-card-focus") : null;

package/client/studio.css

@@ -29,7 +29,7 @@
       justify-content: space-between;
     }
 
-    h1 {
+    body > header h1 {
       margin: 0;
       font-size: 18px;
       font-weight: 600;
@@ -202,6 +202,10 @@
       font-weight: 450;
     }
 
+    .export-preview-menu button[hidden] {
+      display: none !important;
+    }
+
     .export-preview-menu button:not(:disabled):hover,
     .export-preview-menu button:not(:disabled):focus-visible {
       background: var(--panel-2);
@@ -1182,6 +1186,7 @@
     .rendered-markdown h4,
     .rendered-markdown h5,
     .rendered-markdown h6 {
+      display: block;
       margin-top: 1.2em;
       margin-bottom: 0.5em;
       line-height: 1.25;
@@ -1190,17 +1195,39 @@
     }
 
     .rendered-markdown h1 {
-      font-size: 1.6em;
+      font-size: 1.7em;
+      font-weight: 720;
       border-bottom: 0;
       padding-bottom: 0;
     }
 
     .rendered-markdown h2 {
-      font-size: 1.25em;
+      font-size: 1.4em;
+      font-weight: 700;
       border-bottom: 0;
       padding-bottom: 0;
     }
 
+    .rendered-markdown h3 {
+      font-size: 1.2em;
+      font-weight: 680;
+    }
+
+    .rendered-markdown h4 {
+      font-size: 1.08em;
+      font-weight: 660;
+    }
+
+    .rendered-markdown h5 {
+      font-size: 1em;
+      font-weight: 650;
+    }
+
+    .rendered-markdown h6 {
+      font-size: 0.92em;
+      font-weight: 650;
+    }
+
     .rendered-markdown #title-block-header {
       text-align: center;
       margin-bottom: 2em;
@@ -1767,6 +1794,7 @@
     }
 
     .rendered-markdown .studio-pdf-preview {
+      position: relative;
       display: block;
       max-width: 100%;
       border: 1px solid var(--md-table-border);
@@ -1776,6 +1804,10 @@
       line-height: 0;
     }
 
+    .rendered-markdown .studio-pdf-preview-focus-target {
+      cursor: zoom-in;
+    }
+
     .rendered-markdown .studio-pdf-preview[data-fig-align="center"] {
       margin-left: auto;
       margin-right: auto;
@@ -1881,6 +1913,19 @@
       border-color: var(--control-border);
     }
 
+    .rendered-markdown button.studio-pdf-card-action[data-studio-action-feedback="success"],
+    .studio-pdf-focus-btn[data-studio-action-feedback="success"] {
+      background: var(--accent-soft);
+      color: var(--accent);
+      border-color: color-mix(in srgb, var(--accent) 45%, var(--control-border));
+    }
+
+    .rendered-markdown button.studio-pdf-card-action[data-studio-action-feedback="warning"],
+    .studio-pdf-focus-btn[data-studio-action-feedback="warning"] {
+      color: var(--warn);
+      border-color: color-mix(in srgb, var(--warn) 45%, var(--control-border));
+    }
+
     .rendered-markdown button.studio-pdf-card-auto-refresh[aria-pressed="true"] {
       background: transparent;
       color: var(--accent);
@@ -1896,13 +1941,14 @@
     }
 
     .rendered-markdown button.studio-pdf-card-focus {
-      width: 29px;
+      width: auto;
       min-width: 29px;
       min-height: 29px;
-      padding: 0;
+      padding: 0 8px;
       display: inline-flex;
       align-items: center;
       justify-content: center;
+      gap: 5px;
     }
 
     .rendered-markdown button.studio-pdf-card-focus .studio-refresh-icon {
@@ -2075,6 +2121,10 @@
       height: 14px;
     }
 
+    .studio-pdf-focus-fullscreen[hidden] {
+      display: none !important;
+    }
+
     .studio-pdf-focus-fullscreen,
     .studio-pdf-focus-close {
       width: 29px;
@@ -5429,7 +5479,7 @@
       gap: 9px;
     }
 
-    body.studio-ui-refresh h1 {
+    body.studio-ui-refresh > header h1 {
       font-size: 16px;
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.51",
+  "version": "0.9.52",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, active quiz, prompt/response history, live previews, and tmux-backed REPL/literate REPL workflows",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,7 @@
     "themes",
     "README.md",
     "CHANGELOG.md",
+    "ROADMAP.md",
     "WORKFLOW.md",
     "assets/screenshots",
     "assets/demo"