pi-studio 0.5.33 → 0.5.35

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.35] — 2026-03-27
+
+### Fixed
+- Diff/file exports via `/studio-pdf <path>` now also make inline math scripts in diff-line annotation badges verbatim-safe inside Pandoc's generated `Highlighting` environment, so subscripts/superscripts like `$x_n$` and `$\epsilon_n=\frac{1}{n}$` render correctly instead of showing literal underscores in the exported PDF.
+
+## [0.5.34] — 2026-03-27
+
+### Changed
+- Preview-side fenced `text`/`plaintext` blocks now soft-wrap long lines instead of forcing horizontal scrolling, while code/diff blocks keep their existing scrollable behavior.
+
+### Fixed
+- Preview annotation pills once again render inline math within long `[an: ...]` notes instead of leaving `$...$` / `\(...\)` fragments as literal text.
+- Diff/file exports via `/studio-pdf <path>` now also preserve math inside diff-line annotation badges such as `[an: add note $\epsilon_n=\frac{1}{n}$]`, instead of leaving escaped TeX literals in the exported PDF.
+
 ## [0.5.33] — 2026-03-27
 
 ### Changed

package/client/studio-client.js

@@ -1697,6 +1697,32 @@
         }
       }
 
+      async function renderAnnotationMathInElement(targetEl) {
+        if (!targetEl || typeof targetEl.querySelectorAll !== "function") return;
+
+        const markers = Array.from(targetEl.querySelectorAll(".annotation-preview-marker")).filter((node) => {
+          const text = typeof node.textContent === "string" ? node.textContent : "";
+          return /\\\(|\\\[|\$\$?|\\[A-Za-z]+/.test(text);
+        });
+        if (markers.length === 0) return;
+
+        let mathJax;
+        try {
+          mathJax = await ensureMathJax();
+        } catch (error) {
+          console.error("Annotation MathJax load failed:", error);
+          appendMathFallbackNotice(targetEl, MATHJAX_UNAVAILABLE_MESSAGE);
+          return;
+        }
+
+        try {
+          await mathJax.typesetPromise(markers);
+        } catch (error) {
+          console.error("Annotation math render failed:", error);
+          appendMathFallbackNotice(targetEl, MATHJAX_RENDER_FAIL_MESSAGE);
+        }
+      }
+
       function applyPreviewAnnotationPlaceholdersToElement(targetEl, placeholders) {
         if (!targetEl || !Array.isArray(placeholders) || placeholders.length === 0) return;
         if (typeof document.createTreeWalker !== "function") return;
@@ -2258,6 +2284,7 @@
           finishPreviewRender(targetEl);
           targetEl.innerHTML = sanitizeRenderedHtml(renderedHtml, markdown);
           applyPreviewAnnotationPlaceholdersToElement(targetEl, previewPrepared.placeholders);
+          await renderAnnotationMathInElement(targetEl);
           decoratePdfEmbeds(targetEl);
           await renderPdfPreviewsInElement(targetEl);
           const annotationMode = (pane === "source" || pane === "response")

package/client/studio.css

@@ -742,6 +742,22 @@
       color: var(--md-codeblock);
     }
 
+    .rendered-markdown pre.text,
+    .rendered-markdown pre.plaintext,
+    .rendered-markdown pre.sourceCode.txt {
+      white-space: pre-wrap;
+      overflow-x: hidden;
+      overflow-wrap: anywhere;
+      word-break: break-word;
+    }
+
+    .rendered-markdown pre.text code,
+    .rendered-markdown pre.plaintext code,
+    .rendered-markdown pre.sourceCode.txt code,
+    .rendered-markdown pre.sourceCode.txt code > span {
+      white-space: inherit;
+    }
+
     .rendered-markdown :not(pre) > code {
       background: rgba(127, 127, 127, 0.13);
       border: 1px solid var(--md-codeblock-border);

package/index.ts

@@ -4056,6 +4056,91 @@ function isStudioGeneratedDiffHighlightingBlock(lines: string[]): boolean {
 	return hasAdditionOrDeletion && hasDiffStructure;
 }
 
+function decodeStudioGeneratedCodeLatexText(text: string): string {
+	return String(text ?? "")
+		.replace(/\\textbackslash\{\}/g, "\\")
+		.replace(/\\textasciitilde\{\}/g, "~")
+		.replace(/\\textasciicircum\{\}/g, "^")
+		.replace(/\\([{}$&#_%])/g, "$1");
+}
+
+function readStudioVerbatimMathOperand(expr: string, startIndex: number): { operand: string; nextIndex: number } | null {
+	if (startIndex >= expr.length) return null;
+	const first = expr[startIndex]!;
+
+	if (first === "{") {
+		let depth = 1;
+		let index = startIndex + 1;
+		while (index < expr.length) {
+			const char = expr[index]!;
+			if (char === "{") {
+				depth += 1;
+			} else if (char === "}") {
+				depth -= 1;
+				if (depth === 0) {
+					return {
+						operand: expr.slice(startIndex + 1, index),
+						nextIndex: index + 1,
+					};
+				}
+			}
+			index += 1;
+		}
+		return {
+			operand: expr.slice(startIndex + 1),
+			nextIndex: expr.length,
+		};
+	}
+
+	if (first === "\\") {
+		let index = startIndex + 1;
+		while (index < expr.length && /[A-Za-z]/.test(expr[index]!)) {
+			index += 1;
+		}
+		if (index === startIndex + 1 && index < expr.length) {
+			index += 1;
+		}
+		return {
+			operand: expr.slice(startIndex, index),
+			nextIndex: index,
+		};
+	}
+
+	return {
+		operand: first,
+		nextIndex: startIndex + 1,
+	};
+}
+
+function makeStudioHighlightingMathScriptsVerbatimSafe(text: string): string {
+	const rewriteExpr = (expr: string): string => {
+		let out = "";
+		for (let index = 0; index < expr.length; index += 1) {
+			const char = expr[index]!;
+			if (char !== "_" && char !== "^") {
+				out += char;
+				continue;
+			}
+
+			const operand = readStudioVerbatimMathOperand(expr, index + 1);
+			if (!operand || !operand.operand) {
+				out += char;
+				continue;
+			}
+
+			out += char === "_" ? `\\sb{${operand.operand}}` : `\\sp{${operand.operand}}`;
+			index = operand.nextIndex - 1;
+		}
+		return out;
+	};
+
+	return String(text ?? "")
+		.replace(/\\\(([\s\S]*?)\\\)/g, (_match, expr: string) => `\\(${rewriteExpr(expr)}\\)`)
+		.replace(/\\\[([\s\S]*?)\\\]/g, (_match, expr: string) => `\\[${rewriteExpr(expr)}\\]`)
+		.replace(/\$\$([\s\S]*?)\$\$/g, (_match, expr: string) => `$$${rewriteExpr(expr)}$$`)
+		.replace(/\$([^$\n]+?)\$/g, (_match, expr: string) => `$${rewriteExpr(expr)}$`);
+}
+
 function replaceStudioAnnotationMarkersInDiffTokenLine(line: string, macroName: string): string {
 	const tokenMatch = line.match(new RegExp(`^\\\\${macroName}\\{([\\s\\S]*)\\}$`));
 	if (!tokenMatch) return line;
@@ -4075,9 +4160,10 @@ function replaceStudioAnnotationMarkersInDiffTokenLine(line: string, macroName:
 			rewritten += wrapText(body.slice(lastIndex, start));
 		}
 
-		const markerText = (match[1] ?? "").replace(/\s{2,}/g, " ").trim();
-		if (markerText) {
-			rewritten += `\\studioannotation{${markerText}}`;
+		const markerText = decodeStudioGeneratedCodeLatexText((match[1] ?? "").replace(/\s{2,}/g, " ").trim());
+		const cleaned = makeStudioHighlightingMathScriptsVerbatimSafe(escapeStudioPdfLatexText(markerText));
+		if (cleaned) {
+			rewritten += `\\studioannotation{${cleaned}}`;
 		}
 
 		lastIndex = start + token.length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.5.33",
+  "version": "0.5.35",
   "description": "Two-pane browser workspace for pi with prompt/response editing, annotations, critiques, prompt/response history, and live Markdown/LaTeX/code preview",
   "type": "module",
   "license": "MIT",