pi-studio 0.5.20 → 0.5.22

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.22] — 2026-03-20
+
+### Fixed
+- Citeproc-rendered LaTeX bibliographies now request a visible `References` section heading in Studio preview/PDF output.
+- LaTeX preview now regroups `subfigure`-based figures so adjacent subfigures keep their shared overall figure/caption structure instead of rendering as unrelated standalone figures, including visible `(a)` / `(b)` subfigure markers and `Figure n` main-caption labels when `.aux` labels are available.
+- LaTeX preview now converts common `algorithm` / `algorithmic` / `algpseudocode` blocks into readable algorithm cards with preserved captions, indentation, and optional line numbers instead of showing the raw environment text.
+- The editor language dropdown is now alphabetised for quicker scanning.
+
+## [0.5.21] — 2026-03-19
+
+### Fixed
+- PDF export now uses a two-step prepare/download flow and opens the generated PDF in the system’s default viewer first, so browser surfaces like cmux do not need to navigate away from the current Studio page.
+- LaTeX preview and PDF export now use the document `.aux` file when available to substitute basic `\eqref{...}`, `\ref{...}`, and `\autoref{...}` values more reliably, and preview decorates block equations with their resolved equation numbers.
+- Upload + working-directory LaTeX workflows now derive the effective source path more reliably, helping Studio find the correct `.aux` file for reference resolution.
+
 ## [0.5.20] — 2026-03-19
 
 ### Fixed

package/client/studio-client.js

@@ -1351,6 +1351,8 @@
 
         let response;
         try {
+          const effectivePath = getEffectiveSavePath();
+          const sourcePath = effectivePath || sourceState.path || "";
           response = await fetch("/render-preview?token=" + encodeURIComponent(token), {
             method: "POST",
             headers: {
@@ -1358,8 +1360,8 @@
             },
             body: JSON.stringify({
               markdown: String(markdown || ""),
-              sourcePath: sourceState.path || "",
-              resourceDir: (!sourceState.path && resourceDirInput) ? resourceDirInput.value.trim() : "",
+              sourcePath: sourcePath,
+              resourceDir: (!sourcePath && resourceDirInput) ? resourceDirInput.value.trim() : "",
             }),
             signal: controller ? controller.signal : undefined,
           });
@@ -1444,16 +1446,17 @@
           return;
         }
 
-        const sourcePath = sourceState.path || "";
-        const resourceDir = (!sourceState.path && resourceDirInput) ? resourceDirInput.value.trim() : "";
+        const effectivePath = getEffectiveSavePath();
+        const sourcePath = effectivePath || sourceState.path || "";
+        const resourceDir = (!sourcePath && resourceDirInput) ? resourceDirInput.value.trim() : "";
         const isEditorPreview = rightView === "editor-preview";
         const editorPdfLanguage = isEditorPreview ? normalizeFenceLanguage(editorLanguage || "") : "";
         const isLatex = isEditorPreview
           ? editorPdfLanguage === "latex"
           : /\\documentclass\b|\\begin\{document\}/.test(markdown);
         let filenameHint = isEditorPreview ? "studio-editor-preview.pdf" : "studio-response-preview.pdf";
-        if (sourceState.path) {
-          const baseName = sourceState.path.split(/[\\/]/).pop() || "studio";
+        if (sourcePath) {
+          const baseName = sourcePath.split(/[\\/]/).pop() || "studio";
           const stem = baseName.replace(/\.[^.]+$/, "") || "studio";
           filenameHint = stem + "-preview.pdf";
         }
@@ -1478,8 +1481,8 @@
             }),
           });
 
+          const contentType = String(response.headers.get("content-type") || "").toLowerCase();
           if (!response.ok) {
-            const contentType = String(response.headers.get("content-type") || "").toLowerCase();
             let message = "PDF export failed with HTTP " + response.status + ".";
             if (contentType.includes("application/json")) {
               const payload = await response.json().catch(() => null);
@@ -1495,6 +1498,53 @@
             throw new Error(message);
           }
 
+          if (contentType.includes("application/json")) {
+            const payload = await response.json().catch(() => null);
+            if (!payload || typeof payload.downloadUrl !== "string") {
+              throw new Error("PDF export prepared successfully, but Studio did not receive a download URL.");
+            }
+
+            const exportWarning = typeof payload.warning === "string" ? payload.warning.trim() : "";
+            const openError = typeof payload.openError === "string" ? payload.openError.trim() : "";
+            const openedExternal = payload.openedExternal === true;
+            let downloadName = typeof payload.filename === "string" && payload.filename.trim()
+              ? payload.filename.trim()
+              : (filenameHint || "studio-preview.pdf");
+            if (!/\.pdf$/i.test(downloadName)) {
+              downloadName += ".pdf";
+            }
+
+            if (openedExternal) {
+              if (exportWarning) {
+                setStatus("Opened PDF in default viewer with warning: " + exportWarning, "warning");
+              } else {
+                setStatus("Opened PDF in default viewer: " + downloadName, "success");
+              }
+              return;
+            }
+
+            const link = document.createElement("a");
+            link.href = payload.downloadUrl;
+            link.download = downloadName;
+            link.rel = "noopener";
+            document.body.appendChild(link);
+            link.click();
+            link.remove();
+
+            if (openError) {
+              if (exportWarning) {
+                setStatus("Opened browser fallback because external viewer failed (" + openError + "). Warning: " + exportWarning, "warning");
+              } else {
+                setStatus("Opened browser fallback because external viewer failed (" + openError + ").", "warning");
+              }
+            } else if (exportWarning) {
+              setStatus("Exported PDF with warning: " + exportWarning, "warning");
+            } else {
+              setStatus("Exported PDF: " + downloadName, "success");
+            }
+            return;
+          }
+
           const exportWarning = String(response.headers.get("x-pi-studio-export-warning") || "").trim();
           const blob = await response.blob();
           const headerFilename = parseContentDispositionFilename(response.headers.get("content-disposition"));
@@ -4030,7 +4080,7 @@
           const text = typeof reader.result === "string" ? reader.result : "";
           setEditorText(text, { preserveScroll: false, preserveSelection: false });
           setSourceState({
-            source: "blank",
+            source: "upload",
             label: "upload: " + file.name,
             path: null,
           });

package/client/studio.css

@@ -569,6 +569,14 @@
       text-align: center;
       margin-bottom: 2em;
     }
+
+    .rendered-markdown #bibliography {
+      margin-bottom: 0.75em;
+    }
+
+    .rendered-markdown #refs {
+      margin-top: 0.5em;
+    }
     .rendered-markdown #title-block-header .title {
       margin-bottom: 0.25em;
     }
@@ -758,10 +766,135 @@
       max-width: 100%;
     }
 
+    .rendered-markdown .studio-subfigure-group {
+      margin: 1.25em auto;
+    }
+
+    .rendered-markdown .studio-subfigure-grid {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 1rem;
+      justify-content: center;
+      align-items: flex-start;
+    }
+
+    .rendered-markdown .studio-subfigure-entry {
+      flex: 1 1 220px;
+      margin: 0;
+      max-width: 100%;
+    }
+
+    .rendered-markdown .studio-subfigure-entry img {
+      width: 100%;
+      height: auto;
+      display: block;
+    }
+
+    .rendered-markdown .studio-subfigure-entry > figcaption,
+    .rendered-markdown .studio-subfigure-group > figcaption {
+      text-align: center;
+    }
+
+    .rendered-markdown .studio-subfigure-group > figcaption {
+      margin-top: 0.8em;
+    }
+
+    .rendered-markdown .studio-subfigure-caption-label,
+    .rendered-markdown .studio-figure-caption-label {
+      font-weight: 600;
+    }
+
+    .rendered-markdown .studio-subfigure-caption-label {
+      margin-right: 0.35em;
+    }
+
+    .rendered-markdown .studio-figure-caption-label {
+      margin-right: 0.45em;
+    }
+
+    .rendered-markdown .studio-algorithm-block {
+      margin: 1.25em 0;
+      border: 1px solid var(--md-codeblock-border);
+      border-radius: 10px;
+      background: var(--panel-2);
+      overflow: hidden;
+    }
+
+    .rendered-markdown .studio-algorithm-block > figcaption {
+      padding: 0.8em 1em 0.65em;
+      border-bottom: 1px solid var(--border-muted);
+      background: rgba(127, 127, 127, 0.06);
+      text-align: left;
+    }
+
+    .rendered-markdown .studio-algorithm-caption-label {
+      font-weight: 600;
+      margin-right: 0.45em;
+    }
+
+    .rendered-markdown .studio-algorithm-body {
+      padding: 0.7em 0.9em 0.85em;
+      font-family: var(--font-mono);
+      font-size: 0.95em;
+    }
+
+    .rendered-markdown .studio-algorithm-line {
+      display: grid;
+      grid-template-columns: 2.6em minmax(0, 1fr);
+      gap: 0.8em;
+      align-items: baseline;
+      padding: 0.08em 0;
+    }
+
+    .rendered-markdown .studio-algorithm-line-number {
+      color: var(--muted);
+      text-align: right;
+      font-variant-numeric: tabular-nums;
+      user-select: none;
+    }
+
+    .rendered-markdown .studio-algorithm-line-content {
+      min-width: 0;
+      padding-left: calc(var(--studio-algorithm-indent, 0) * 1.35em);
+      white-space: pre-wrap;
+      overflow-wrap: anywhere;
+    }
+
+    .rendered-markdown .studio-algorithm-line-content math {
+      font-size: 1em;
+    }
+
     .rendered-markdown math {
       font-family: "STIX Two Math", "Cambria Math", "Latin Modern Math", "STIXGeneral", serif;
     }
 
+    .rendered-markdown .studio-display-equation {
+      position: relative;
+      margin: 1em 0;
+    }
+
+    .rendered-markdown .studio-display-equation-body {
+      padding-right: 4.5em;
+      overflow-x: auto;
+      overflow-y: hidden;
+    }
+
+    .rendered-markdown .studio-display-equation-body math[display="block"] {
+      margin: 0;
+    }
+
+    .rendered-markdown .studio-display-equation-number {
+      position: absolute;
+      top: 50%;
+      right: 0;
+      transform: translateY(-50%);
+      color: var(--muted);
+      font-size: 0.95em;
+      line-height: 1;
+      white-space: nowrap;
+      font-variant-numeric: tabular-nums;
+    }
+
     .rendered-markdown math[display="block"] {
       display: block;
       margin: 1em 0;