pi-studio 0.9.19 → 0.9.21

package/client/studio.css

@@ -392,7 +392,6 @@
     }
 
     body[data-studio-mode="editor-only"] #editorViewSelect,
-    body[data-studio-mode="editor-only"] #rightViewSelect,
     body[data-studio-mode="editor-only"] #sendRunBtn,
     body[data-studio-mode="editor-only"] #queueSteerBtn,
     body[data-studio-mode="editor-only"] #sendEditorBtn,
@@ -424,7 +423,7 @@
     }
 
     body[data-studio-mode="editor-only"] #rightSectionHeader .section-header-main::before {
-      content: "Preview";
+      content: "View";
       font-weight: 600;
       font-size: 14px;
     }
@@ -2506,6 +2505,35 @@
       white-space: nowrap;
     }
 
+    .rendered-markdown .studio-html-artifact-comment-btn {
+      flex: 0 0 auto;
+      min-height: 24px;
+      padding: 0 9px;
+      border: 1px solid var(--control-border);
+      border-radius: 999px;
+      background: var(--panel);
+      color: var(--text);
+      font: inherit;
+      font-size: 11px;
+      line-height: 1;
+      cursor: pointer;
+      white-space: nowrap;
+    }
+
+    .rendered-markdown .studio-html-artifact-comment-btn:not(:disabled):hover,
+    .rendered-markdown .studio-html-artifact-comment-btn:focus-visible {
+      background: var(--control-hover-bg, var(--inline-code-bg));
+      border-color: var(--control-border-hover, var(--accent));
+      outline: none;
+    }
+
+    .rendered-markdown .studio-html-artifact-comment-btn.is-active,
+    .rendered-markdown .studio-html-artifact-shell.is-comment-mode .studio-html-artifact-comment-btn.is-active {
+      background: var(--accent-soft);
+      border-color: var(--accent);
+      color: var(--accent);
+    }
+
     .rendered-markdown .studio-html-artifact-zoom-controls {
       flex: 0 0 auto;
       display: inline-flex;
@@ -4036,6 +4064,83 @@
       line-height: 1.35;
     }
 
+    body[data-studio-mode="editor-only"] .shortcuts-full-only {
+      display: none !important;
+    }
+
+    .scratchpad-recent-panel {
+      flex: 0 0 auto;
+      max-height: 260px;
+      overflow: auto;
+      border-bottom: 1px solid var(--panel-border);
+      background: var(--scratchpad-body-bg, var(--panel));
+      padding: 10px 12px;
+    }
+
+    .scratchpad-recent-panel[hidden] {
+      display: none !important;
+    }
+
+    .scratchpad-recent-empty,
+    .scratchpad-recent-loading {
+      color: var(--studio-info-text, var(--muted));
+      font-size: 12px;
+      padding: 8px 6px;
+    }
+
+    .scratchpad-recent-list {
+      display: grid;
+      gap: 8px;
+    }
+
+    .scratchpad-recent-item {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      gap: 8px 12px;
+      align-items: start;
+      padding: 9px 10px;
+      border: 1px solid var(--border-subtle);
+      border-radius: 10px;
+      background: var(--panel-2);
+    }
+
+    .scratchpad-recent-main {
+      min-width: 0;
+    }
+
+    .scratchpad-recent-title {
+      font-size: 12px;
+      font-weight: 650;
+      color: var(--text);
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    .scratchpad-recent-meta,
+    .scratchpad-recent-preview {
+      font-size: 11px;
+      color: var(--studio-info-text, var(--muted));
+      line-height: 1.35;
+    }
+
+    .scratchpad-recent-preview {
+      margin-top: 3px;
+    }
+
+    .scratchpad-recent-actions {
+      display: inline-flex;
+      gap: 6px;
+      flex-wrap: wrap;
+      justify-content: flex-end;
+    }
+
+    .scratchpad-recent-actions button {
+      padding: 4px 7px;
+      font-size: 11px;
+      line-height: 1.1;
+    }
+
     .scratchpad-textarea {
       width: 100%;
       min-height: 280px;

package/index.ts

@@ -22,6 +22,7 @@ import {
 	transformStudioMarkdownOutsideFences,
 } from "./shared/studio-annotation-scanner.js";
 import { stripStudioMarkdownHtmlComments } from "./shared/studio-markdown-html-comments.js";
+import { normalizeStudioMarkdownSmartFences } from "./shared/studio-markdown-fences.js";
 import {
 	extractStandaloneLatexDefinitionsFromMarkdown,
 	preserveLiteralLatexCommandsInMarkdown,
@@ -209,6 +210,8 @@ interface InitialStudioDocument {
 	resourceDir?: string;
 }
 
+type PersistedStudioReviewNoteAnchorKind = "source" | "html-selection" | "html-element" | "html-page";
+
 interface PersistedStudioReviewNote {
 	id: string;
 	text: string;
@@ -220,11 +223,22 @@ interface PersistedStudioReviewNote {
 	lineEnd: number;
 	selectedText: string;
 	selectedDisplayText?: string;
+	anchorKind?: PersistedStudioReviewNoteAnchorKind;
+	htmlSelector?: string;
+	htmlTag?: string;
+	htmlLabel?: string;
+	htmlPreviewTitle?: string;
+}
+
+interface PersistedStudioScratchpadMetadata {
+	label?: string;
+	updatedAt?: number;
 }
 
 interface StudioPersistentState {
 	version: 2;
 	scratchpadsByDocument: Record<string, string>;
+	scratchpadMetadataByDocument: Record<string, PersistedStudioScratchpadMetadata>;
 	reviewNotesByDocument: Record<string, PersistedStudioReviewNote[]>;
 }
 
@@ -721,10 +735,15 @@ function createEmptyStudioPersistentState(): StudioPersistentState {
 	return {
 		version: 2,
 		scratchpadsByDocument: {},
+		scratchpadMetadataByDocument: {},
 		reviewNotesByDocument: {},
 	};
 }
 
+function normalizePersistedStudioReviewNoteAnchorKind(value: unknown): PersistedStudioReviewNoteAnchorKind {
+	return value === "html-selection" || value === "html-element" || value === "html-page" ? value : "source";
+}
+
 function normalizePersistedStudioReviewNote(value: unknown): PersistedStudioReviewNote | null {
 	if (!value || typeof value !== "object") return null;
 	const candidate = value as Partial<PersistedStudioReviewNote>;
@@ -759,6 +778,11 @@ function normalizePersistedStudioReviewNote(value: unknown): PersistedStudioRevi
 		lineEnd,
 		selectedText: typeof candidate.selectedText === "string" ? candidate.selectedText : "",
 		selectedDisplayText: typeof candidate.selectedDisplayText === "string" ? candidate.selectedDisplayText : "",
+		anchorKind: normalizePersistedStudioReviewNoteAnchorKind(candidate.anchorKind),
+		htmlSelector: typeof candidate.htmlSelector === "string" ? candidate.htmlSelector : "",
+		htmlTag: typeof candidate.htmlTag === "string" ? candidate.htmlTag : "",
+		htmlLabel: typeof candidate.htmlLabel === "string" ? candidate.htmlLabel : "",
+		htmlPreviewTitle: typeof candidate.htmlPreviewTitle === "string" ? candidate.htmlPreviewTitle : "",
 	};
 }
 
@@ -768,6 +792,7 @@ function normalizeStudioPersistentState(value: unknown): StudioPersistentState {
 	const candidate = value as Partial<StudioPersistentState> & {
 		reviewNotesByDocument?: unknown;
 		scratchpadsByDocument?: unknown;
+		scratchpadMetadataByDocument?: unknown;
 		scratchpadText?: unknown;
 	};
 	const reviewNotesByDocument: Record<string, PersistedStudioReviewNote[]> = {};
@@ -791,9 +816,21 @@ function normalizeStudioPersistentState(value: unknown): StudioPersistentState {
 	} else if (typeof candidate.scratchpadText === "string" && candidate.scratchpadText.length > 0) {
 		scratchpadsByDocument[STUDIO_DEFAULT_SCRATCHPAD_DOCUMENT_KEY] = candidate.scratchpadText;
 	}
+	const scratchpadMetadataByDocument: Record<string, PersistedStudioScratchpadMetadata> = {};
+	if (candidate.scratchpadMetadataByDocument && typeof candidate.scratchpadMetadataByDocument === "object") {
+		for (const [documentKey, rawMeta] of Object.entries(candidate.scratchpadMetadataByDocument as Record<string, unknown>)) {
+			if (typeof documentKey !== "string" || !documentKey.trim() || !rawMeta || typeof rawMeta !== "object") continue;
+			const meta = rawMeta as { label?: unknown; updatedAt?: unknown };
+			scratchpadMetadataByDocument[documentKey] = {
+				label: typeof meta.label === "string" ? meta.label : undefined,
+				updatedAt: typeof meta.updatedAt === "number" && Number.isFinite(meta.updatedAt) ? meta.updatedAt : undefined,
+			};
+		}
+	}
 	return {
 		version: 2,
 		scratchpadsByDocument,
+		scratchpadMetadataByDocument,
 		reviewNotesByDocument,
 	};
 }
@@ -836,16 +873,50 @@ async function readPersistedStudioScratchpadText(documentKey: string): Promise<s
 	return typeof value === "string" ? value : "";
 }
 
-async function writePersistedStudioScratchpadText(documentKey: string, text: string): Promise<void> {
+function describePersistedScratchpadKey(documentKey: string): { label: string; kind: string } {
+	const key = String(documentKey || "").trim();
+	if (key.startsWith("file:")) return { label: key.slice(5) || "file", kind: "File" };
+	if (key.startsWith("draft:")) return { label: key.slice(6) || "draft", kind: "Draft" };
+	if (key.startsWith("doc:")) return { label: key.slice(4).replace(/^blank:/, "") || "document", kind: "Document" };
+	return { label: key || "scratchpad", kind: "Scratchpad" };
+}
+
+function summarizeScratchpadText(text: string): string {
+	const normalized = String(text || "").replace(/\s+/g, " ").trim();
+	return normalized.length > 160 ? `${normalized.slice(0, 157)}…` : normalized;
+}
+
+async function listRecentPersistedStudioScratchpads(limit = 20): Promise<Array<{ documentKey: string; label: string; kind: string; updatedAt: number; textPreview: string; textLength: number }>> {
+	const state = await loadStudioPersistentState();
+	return Object.entries(state.scratchpadsByDocument)
+		.filter((entry): entry is [string, string] => typeof entry[0] === "string" && typeof entry[1] === "string" && entry[1].trim().length > 0)
+		.map(([documentKey, text]) => {
+			const fallback = describePersistedScratchpadKey(documentKey);
+			const meta = state.scratchpadMetadataByDocument[documentKey] ?? {};
+			const label = typeof meta.label === "string" && meta.label.trim() ? meta.label.trim() : fallback.label;
+			const updatedAt = typeof meta.updatedAt === "number" && Number.isFinite(meta.updatedAt) ? meta.updatedAt : 0;
+			return { documentKey, label, kind: fallback.kind, updatedAt, textPreview: summarizeScratchpadText(text), textLength: text.length };
+		})
+		.sort((left, right) => (right.updatedAt - left.updatedAt) || left.label.localeCompare(right.label) || left.documentKey.localeCompare(right.documentKey))
+		.slice(0, Math.max(1, Math.min(100, Math.floor(limit) || 20)));
+}
+
+async function writePersistedStudioScratchpadText(documentKey: string, text: string, label?: string): Promise<void> {
 	const key = String(documentKey ?? "").trim();
 	if (!key) return;
 	await mutateStudioPersistentState((state) => {
 		const normalized = String(text ?? "");
 		if (normalized.length === 0) {
 			delete state.scratchpadsByDocument[key];
+			delete state.scratchpadMetadataByDocument[key];
 			return;
 		}
 		state.scratchpadsByDocument[key] = normalized;
+		state.scratchpadMetadataByDocument[key] = {
+			...(state.scratchpadMetadataByDocument[key] ?? {}),
+			label: typeof label === "string" && label.trim() ? label.trim() : state.scratchpadMetadataByDocument[key]?.label,
+			updatedAt: Date.now(),
+		};
 	});
 }
 
@@ -4566,7 +4637,8 @@ function hasStudioYamlHeaderIncludes(markdown: string): boolean {
 function prepareStudioMarkdownForPandoc(markdown: string, options?: { preserveLiteralLatexCommands?: boolean }): string {
 	const shouldPreserveLiteralLatexCommands = options?.preserveLiteralLatexCommands !== false;
 	return mapStudioMarkdownBodyPreservingYamlFrontMatter(markdown, (body) => {
-		const normalizedMath = normalizeMathDelimiters(body);
+		const normalizedFences = normalizeStudioMarkdownSmartFences(body);
+		const normalizedMath = normalizeMathDelimiters(normalizedFences);
 		const latexReady = shouldPreserveLiteralLatexCommands
 			? preserveLiteralLatexCommandsInMarkdown(normalizedMath)
 			: normalizedMath;
@@ -5416,9 +5488,10 @@ function prepareStudioPdfMarkdown(markdown: string, isLatex?: boolean, editorLan
 		&& !isStudioSingleFencedCodeBlock(input)
 		? wrapStudioCodeAsMarkdown(input, effectiveEditorLanguage)
 		: input;
+	const fenceNormalizedSource = effectiveEditorLanguage === "latex" ? source : normalizeStudioMarkdownSmartFences(source);
 	const annotationReadySource = !effectiveEditorLanguage || effectiveEditorLanguage === "markdown" || effectiveEditorLanguage === "latex"
-		? replaceStudioAnnotationMarkersForPdf(source)
-		: source;
+		? replaceStudioAnnotationMarkersForPdf(fenceNormalizedSource)
+		: fenceNormalizedSource;
 	const commentStrippedSource = stripStudioMarkdownHtmlCommentsPreservingYamlFrontMatter(annotationReadySource);
 	return prepareStudioMarkdownForPandoc(commentStrippedSource, {
 		preserveLiteralLatexCommands: !hasStudioYamlHeaderIncludes(annotationReadySource),
@@ -5717,7 +5790,8 @@ function decorateStudioPandocSyntaxHtml(html: string): string {
 
 async function renderStudioMarkdownWithPandoc(markdown: string, isLatex?: boolean, resourcePath?: string, sourcePath?: string): Promise<string> {
 	const pandocCommand = process.env.PANDOC_PATH?.trim() || "pandoc";
-	const markdownWithoutHtmlComments = isLatex ? markdown : stripStudioMarkdownHtmlCommentsPreservingYamlFrontMatter(markdown);
+	const markdownWithNormalizedFences = isLatex ? markdown : normalizeStudioMarkdownSmartFences(markdown);
+	const markdownWithoutHtmlComments = isLatex ? markdownWithNormalizedFences : stripStudioMarkdownHtmlCommentsPreservingYamlFrontMatter(markdownWithNormalizedFences);
 	const markdownWithPreviewPageBreaks = isLatex ? markdownWithoutHtmlComments : replaceStudioPreviewPageBreakCommands(markdownWithoutHtmlComments);
 	const latexSubfigurePreviewTransform = isLatex
 		? preprocessStudioLatexSubfiguresForPreview(markdownWithPreviewPageBreaks)
@@ -10042,14 +10116,14 @@ ${cssVarsBlock}
               <div class="scratchpad-header">
                 <div>
                   <h2 id="reviewNotesTitle">Comments</h2>
-                  <p class="scratchpad-description">Local comments for editor text. Stay out of the text, anchored to selections or lines, and can be converted into inline <span class="review-notes-inline-token">[an: ...]</span> annotations.</p>
+                  <p class="scratchpad-description">Local comments for editor text and editor previews. They stay out of the text; source-anchored comments can be converted into inline <span class="review-notes-inline-token">[an: ...]</span> annotations.</p>
                 </div>
                 <button id="reviewNotesCloseBtn" type="button" class="scratchpad-close-btn" aria-label="Hide comments" title="Hide comments">✕</button>
               </div>
               <div class="review-notes-toolbar">
                 <span id="reviewNotesMeta" class="scratchpad-meta">No comments</span>
               </div>
-              <div id="reviewNotesEmptyState" class="review-notes-empty">No comments yet for this document. Select text in <strong>Editor (Raw)</strong> or <strong>Editor (Preview)</strong> and use <em>Comment</em>, or use <em>Line comment</em> in <strong>Editor (Raw)</strong>.</div>
+              <div id="reviewNotesEmptyState" class="review-notes-empty">No comments yet for this document. Select text in <strong>Editor (Raw)</strong> or <strong>Editor (Preview)</strong> and use <em>Comment</em>, use <em>Line comment</em> in <strong>Editor (Raw)</strong>, or use <em>Comment mode</em> in an editor HTML preview.</div>
               <div id="reviewNotesList" class="review-notes-list" aria-live="polite"></div>
               <div class="review-notes-dock-footer">
                 <div class="scratchpad-actions">
@@ -10085,8 +10159,10 @@ ${cssVarsBlock}
           <span id="exportPreviewControls" class="export-preview-controls">
             <button id="exportPdfBtn" class="export-preview-trigger" type="button" aria-haspopup="menu" aria-expanded="false" title="Choose a format and export the current right-pane preview.">Export right preview</button>
             <div id="exportPreviewMenu" class="export-preview-menu" role="menu" hidden>
-              <button id="exportPreviewPdfBtn" type="button" role="menuitem" data-export-preview-format="pdf">Export as PDF</button>
-              <button id="exportPreviewHtmlBtn" type="button" role="menuitem" data-export-preview-format="html">Export as HTML</button>
+              <button id="exportPreviewPdfStudioBtn" type="button" role="menuitem" data-export-preview-format="pdf-studio">Export PDF and Open in Studio preview tab</button>
+              <button id="exportPreviewPdfBtn" type="button" role="menuitem" data-export-preview-format="pdf-default">Export PDF and Open in default PDF viewer</button>
+              <button id="exportPreviewHtmlStudioBtn" type="button" role="menuitem" data-export-preview-format="html-studio">Export HTML and Open in Studio editor</button>
+              <button id="exportPreviewHtmlBtn" type="button" role="menuitem" data-export-preview-format="html-browser">Export HTML and Open in browser</button>
             </div>
           </span>
         </div>
@@ -10181,14 +10257,14 @@ ${cssVarsBlock}
           <h3>Editor</h3>
           <dl>
             <div><dt>Cmd/Ctrl+S</dt><dd>Save editor</dd></div>
-            <div><dt>Cmd/Ctrl+Enter</dt><dd>Run editor text, or queue steering during an active run</dd></div>
+            <div class="shortcuts-full-only"><dt>Cmd/Ctrl+Enter</dt><dd>Run editor text, or queue steering during an active run</dd></div>
             <div><dt>Option/Alt+Tab or Cmd/Ctrl+Shift+Space</dt><dd>Suggest a completion at the editor cursor</dd></div>
             <div><dt>Tab</dt><dd>Insert a visible completion suggestion; otherwise indent selected editor text</dd></div>
             <div><dt>Esc</dt><dd>Dismiss a visible completion suggestion, close overlays, exit pane focus, or stop an active request</dd></div>
             <div><dt>Shift+Tab</dt><dd>Unindent selected editor text</dd></div>
           </dl>
         </section>
-        <section class="shortcuts-group">
+        <section class="shortcuts-group shortcuts-full-only">
           <h3>Response</h3>
           <dl>
             <div><dt>Alt/Option+←</dt><dd>Previous response when not editing text</dd></div>
@@ -10211,14 +10287,16 @@ ${cssVarsBlock}
       <div class="scratchpad-header">
         <div>
           <h2 id="scratchpadTitle">Scratchpad</h2>
-          <p class="scratchpad-description">Local persistent notes for thoughts you want to park while working on the current Studio document or draft. Closing the scratchpad does not clear it: notes persist locally for this document identity until you edit or clear them. File-backed documents reliably come back across Pi restarts; unsaved drafts stay with their own draft instance until you save them or discard them. Scratchpad text is not run, critiqued, sent, or exported unless you explicitly insert it into the editor.</p>
+          <p class="scratchpad-description">Local persistent notes for thoughts you want to park while working on the current Studio document or draft. Closing the scratchpad does not clear it: notes persist locally for this document identity until you edit or clear them. File-backed documents reliably come back across Pi restarts; unsaved drafts stay with their own draft instance until you save them or discard them. Use Recent… to recover scratchpads from other draft identities after a Studio/Pi restart. Scratchpad text is not run, critiqued, sent, or exported unless you explicitly insert it into the editor.</p>
         </div>
         <button id="scratchpadCloseBtn" type="button" class="scratchpad-close-btn" aria-label="Keep current scratchpad text and close scratchpad" title="Keep current scratchpad text and close scratchpad">✕</button>
       </div>
+      <div id="scratchpadRecentPanel" class="scratchpad-recent-panel" hidden></div>
       <textarea id="scratchpadText" class="scratchpad-textarea" placeholder="Jot quick thoughts, TODOs, or prompt ideas here..."></textarea>
       <div class="scratchpad-footer">
         <span id="scratchpadMeta" class="scratchpad-meta">Empty · local only</span>
         <div class="scratchpad-actions">
+          <button id="scratchpadRecentBtn" type="button" title="Show recent non-empty scratchpads saved for other files and drafts.">Recent…</button>
           <button id="scratchpadInsertBtn" type="button" title="Insert the scratchpad text into the editor at the current selection, or append it if no editor selection is available.">Insert into editor</button>
           <button id="scratchpadCopyBtn" type="button" title="Copy scratchpad text to the clipboard.">Copy</button>
           <button id="scratchpadClearBtn" type="button" title="Clear scratchpad text.">Clear</button>
@@ -12591,6 +12669,12 @@ export default function (pi: ExtensionAPI) {
 	const handleScratchpadStateRequest = async (req: IncomingMessage, res: ServerResponse, requestUrl: URL) => {
 		const method = (req.method ?? "GET").toUpperCase();
 		if (method === "GET") {
+			const action = (requestUrl.searchParams.get("action") ?? "").trim().toLowerCase();
+			if (action === "recent") {
+				const limit = Number.parseInt(requestUrl.searchParams.get("limit") ?? "20", 10);
+				respondJson(res, 200, { ok: true, scratchpads: await listRecentPersistedStudioScratchpads(limit) });
+				return;
+			}
 			const documentKey = (requestUrl.searchParams.get("documentKey") ?? "").trim();
 			if (!documentKey) {
 				respondJson(res, 400, { ok: false, error: "Missing documentKey query parameter." });
@@ -12640,8 +12724,12 @@ export default function (pi: ExtensionAPI) {
 			respondJson(res, 400, { ok: false, error: "Missing scratchpad text in request body." });
 			return;
 		}
+		const label =
+			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { label?: unknown }).label === "string"
+				? (parsedBody as { label: string }).label
+				: undefined;
 
-		await writePersistedStudioScratchpadText(documentKey, text);
+		await writePersistedStudioScratchpadText(documentKey, text, label);
 		respondJson(res, 200, { ok: true });
 	};
 
@@ -12950,6 +13038,11 @@ export default function (pi: ExtensionAPI) {
 			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { editorPdfLanguage?: unknown }).editorPdfLanguage === "string"
 				? (parsedBody as { editorPdfLanguage: string }).editorPdfLanguage
 				: "";
+		const requestedOpenTarget =
+			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { openTarget?: unknown }).openTarget === "string"
+				? (parsedBody as { openTarget: string }).openTarget.trim().toLowerCase()
+				: "default";
+		const openTarget = requestedOpenTarget === "studio" ? "studio" : "default";
 		const editorPdfLanguage = inferStudioPdfLanguage(markdown, requestedEditorPdfLanguage);
 		const isLatex = editorPdfLanguage === "latex"
 			|| (
@@ -12963,17 +13056,48 @@ export default function (pi: ExtensionAPI) {
 			const writeResult = writeStudioPreviewExportFile(buildStudioPreviewExportPath(sourcePath || undefined, userResourceDir || undefined, studioCwd, filename), pdf);
 			const exportId = storePreparedPdfExport(pdf, filename, warning, writeResult.filePath ?? undefined);
 			const token = serverState?.token ?? "";
+			if (openTarget === "studio" && serverState && writeResult.filePath) {
+				const exportedPath = writeResult.filePath;
+				const title = sanitizeStudioPreviewBlockLine(filename || basename(exportedPath) || "PDF preview");
+				const document: InitialStudioDocument = {
+					text: "```studio-pdf\n"
+						+ `path: ${sanitizeStudioPreviewBlockLine(basename(exportedPath))}\n`
+						+ `title: ${title || "PDF preview"}\n`
+						+ "height: 820\n"
+						+ "```\n",
+					label: `${filename || basename(exportedPath) || "PDF"} preview`,
+					source: "blank",
+					resourceDir: dirname(exportedPath),
+				};
+				const docId = storeTransientStudioDocument(document);
+				const url = buildStudioUrl(serverState.port, serverState.token, "editor-only", document, docId);
+				const parsedUrl = new URL(url);
+				respondJson(res, 200, {
+					ok: true,
+					filename,
+					path: writeResult.filePath,
+					writeError: writeResult.error,
+					warning: warning ?? null,
+					openedStudio: true,
+					url,
+					relativeUrl: `${parsedUrl.pathname}${parsedUrl.search}`,
+					downloadUrl: `/export-pdf?token=${encodeURIComponent(token)}&id=${encodeURIComponent(exportId)}`,
+				});
+				return;
+			}
 			let openedExternal = false;
 			let openError: string | null = null;
-			try {
-				const prepared = await ensurePreparedPdfExportFile(exportId);
-				if (!prepared?.filePath) {
-					throw new Error("Prepared PDF file was not available for external open.");
+			if (openTarget !== "studio") {
+				try {
+					const prepared = await ensurePreparedPdfExportFile(exportId);
+					if (!prepared?.filePath) {
+						throw new Error("Prepared PDF file was not available for external open.");
+					}
+					await openPathInDefaultViewer(prepared.filePath);
+					openedExternal = true;
+				} catch (viewerError) {
+					openError = viewerError instanceof Error ? viewerError.message : String(viewerError);
 				}
-				await openPathInDefaultViewer(prepared.filePath);
-				openedExternal = true;
-			} catch (viewerError) {
-				openError = viewerError instanceof Error ? viewerError.message : String(viewerError);
 			}
 			respondJson(res, 200, {
 				ok: true,
@@ -13052,6 +13176,11 @@ export default function (pi: ExtensionAPI) {
 			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { editorHtmlLanguage?: unknown }).editorHtmlLanguage === "string"
 				? (parsedBody as { editorHtmlLanguage: string }).editorHtmlLanguage
 				: "";
+		const requestedOpenTarget =
+			parsedBody && typeof parsedBody === "object" && typeof (parsedBody as { openTarget?: unknown }).openTarget === "string"
+				? (parsedBody as { openTarget: string }).openTarget.trim().toLowerCase()
+				: "browser";
+		const openTarget = requestedOpenTarget === "studio" ? "studio" : "browser";
 		const editorHtmlLanguage = inferStudioPdfLanguage(markdown, requestedEditorHtmlLanguage);
 		const isLatex = editorHtmlLanguage === "latex"
 			|| (
@@ -13077,6 +13206,32 @@ export default function (pi: ExtensionAPI) {
 			const writeResult = writeStudioPreviewExportFile(buildStudioPreviewExportPath(sourcePath || undefined, userResourceDir || undefined, studioCwd, filename), html);
 			const exportId = storePreparedHtmlExport(html, filename, warning, writeResult.filePath ?? undefined);
 			const token = serverState?.token ?? "";
+			if (openTarget === "studio" && serverState) {
+				const exportedPath = writeResult.filePath ?? "";
+				const document: InitialStudioDocument = {
+					text: html.toString("utf-8"),
+					label: filename,
+					source: exportedPath ? "file" : "blank",
+					path: exportedPath || undefined,
+					resourceDir: exportedPath ? dirname(exportedPath) : (userResourceDir || resourcePath || studioCwd),
+					draftId: exportedPath ? undefined : createStudioDraftId(),
+				};
+				const docId = storeTransientStudioDocument(document);
+				const url = buildStudioUrl(serverState.port, serverState.token, "editor-only", document, docId);
+				const parsedUrl = new URL(url);
+				respondJson(res, 200, {
+					ok: true,
+					filename,
+					path: writeResult.filePath,
+					writeError: writeResult.error,
+					warning: warning ?? null,
+					openedStudio: true,
+					url,
+					relativeUrl: `${parsedUrl.pathname}${parsedUrl.search}`,
+					downloadUrl: `/export-html?token=${encodeURIComponent(token)}&id=${encodeURIComponent(exportId)}`,
+				});
+				return;
+			}
 			let openedExternal = false;
 			let openError: string | null = null;
 			try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-studio",
-  "version": "0.9.19",
+  "version": "0.9.21",
   "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",

package/shared/studio-markdown-fences.js

@@ -0,0 +1,22 @@
+const SMART_MARKDOWN_FENCE_CHARS = "`´‘’‚‛“”„‟′‵";
+const SMART_MARKDOWN_FENCE_RE = new RegExp(`^([ \\t]{0,3})([${SMART_MARKDOWN_FENCE_CHARS.replace(/[\\\]^-]/g, "\\$&")}]{3,})([^${SMART_MARKDOWN_FENCE_CHARS.replace(/[\\\]^-]/g, "\\$&")}\\r\\n]*)$`);
+
+function normalizeSmartFenceRun(run) {
+  return "`".repeat(Math.max(3, Array.from(String(run || "")).length));
+}
+
+export function normalizeStudioMarkdownSmartFences(markdown) {
+  return String(markdown ?? "")
+    .replace(/\r\n/g, "\n")
+    .split("\n")
+    .map((line) => {
+      const match = line.match(SMART_MARKDOWN_FENCE_RE);
+      if (!match) return line;
+      const indent = match[1] ?? "";
+      const run = match[2] ?? "";
+      const suffix = match[3] ?? "";
+      if (!/[´‘’‚‛“”„‟′‵]/u.test(run)) return line;
+      return `${indent}${normalizeSmartFenceRun(run)}${suffix}`;
+    })
+    .join("\n");
+}

package/shared/studio-markdown-fences.ts

@@ -0,0 +1,22 @@
+const SMART_MARKDOWN_FENCE_CHARS = "`´‘’‚‛“”„‟′‵";
+const SMART_MARKDOWN_FENCE_RE = new RegExp(`^([ \\t]{0,3})([${SMART_MARKDOWN_FENCE_CHARS.replace(/[\\\]^-]/g, "\\$&")}]{3,})([^${SMART_MARKDOWN_FENCE_CHARS.replace(/[\\\]^-]/g, "\\$&")}\\r\\n]*)$`);
+
+function normalizeSmartFenceRun(run: string): string {
+	return "`".repeat(Math.max(3, Array.from(String(run || "")).length));
+}
+
+export function normalizeStudioMarkdownSmartFences(markdown: string): string {
+	return String(markdown ?? "")
+		.replace(/\r\n/g, "\n")
+		.split("\n")
+		.map((line) => {
+			const match = line.match(SMART_MARKDOWN_FENCE_RE);
+			if (!match) return line;
+			const indent = match[1] ?? "";
+			const run = match[2] ?? "";
+			const suffix = match[3] ?? "";
+			if (!/[´‘’‚‛“”„‟′‵]/u.test(run)) return line;
+			return `${indent}${normalizeSmartFenceRun(run)}${suffix}`;
+		})
+		.join("\n");
+}