pi-studio 0.5.48 → 0.5.50

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `pi-studio` are documented here.
 
 ## [Unreleased]
 
+## [0.5.50] — 2026-04-09
+
+### Added
+- Editor-preview comments now also work for minimal structured LaTeX preview content, including headings, prose paragraphs, references sections, and whole display equations.
+- Preview-side selection affordances now include a transient **Jump** action alongside **Comment**, so you can reveal the corresponding raw-editor span without creating a local comment first.
+
+### Fixed
+- LaTeX preview comment mapping now follows Studio's rendered structure more closely, including title-block abstracts, loose prose after decorated display equations, bibliography/reference sections, and paragraph alignment around figures and rendered citation/reference text.
+- Preview comment controls for display equations now anchor to the outer rendered equation frame, improving visibility and making preview jump targeting more reliable.
+
+## [0.5.49] — 2026-04-09
+
+### Fixed
+- Markdown editor-preview comments are now substantially more robust on real pandoc-rendered documents, including smart punctuation and ellipsis normalization, mixed prose plus display-math sections, standalone display equations treated as whole units, MathJax fallback display math, standalone page-break commands, and raw-TeX commands that disappear from preview output.
+- Preview comment block matching now avoids unsafe tiny substring fallbacks, so extra blank-line splits that create short paragraphs like `or` no longer derail later Markdown comment targets.
+- Markdown HTML comments like `<!-- ... -->` are now stripped more consistently across both the main pandoc preview path and plain-markdown fallback rendering, including edge cases after unmatched inline backticks at line breaks.
+
 ## [0.5.48] — 2026-04-07
 
 ### Added

package/README.md

@@ -18,7 +18,7 @@ Extension for [pi](https://pi.dev) that opens a local two-pane browser workspace
 - Supports one canonical full Studio view per Pi session, plus additional editor-only companion views when you just want extra editing/preview surfaces
 - Runs editor text directly, or asks for structured critique (auto/writing/code focus)
 - Includes a local persistent scratchpad for quick notes you want to keep out of the main editor until you're ready to copy or insert them
-- Includes local comments anchored to selections/lines, shown in a docked **Comments** rail, with **Comment** actions from raw-editor selections plus editor-preview selections for Markdown and code/text/diff previews, alongside optional inline `[an: ...]` toggles when you want comments reflected in the document text
+- Includes local comments anchored to selections/lines, shown in a docked **Comments** rail, with **Comment** actions from raw-editor selections plus editor-preview selections for Markdown, LaTeX, and code/text/diff previews, alongside a transient preview **Jump** action and optional inline `[an: ...]` toggles when you want comments reflected in the document text
 - Browses response history (`Prev/Next/Last`) and loads either:
   - response text
   - critique notes/full critique

package/client/studio-annotation-helpers.js

@@ -510,6 +510,71 @@
     });
   }
 
+  function stripMarkdownHtmlCommentsInSegment(markdown) {
+    const source = String(markdown || "");
+    let out = "";
+    let index = 0;
+    let codeSpanFenceLength = 0;
+    let inHtmlComment = false;
+
+    while (index < source.length) {
+      if (inHtmlComment) {
+        if (source.startsWith("-->", index)) {
+          inHtmlComment = false;
+          index += 3;
+          continue;
+        }
+        const ch = source[index];
+        if (ch === "\n" || ch === "\r") out += ch;
+        index += 1;
+        continue;
+      }
+
+      if (codeSpanFenceLength > 0) {
+        const fence = "`".repeat(codeSpanFenceLength);
+        if (source.startsWith(fence, index)) {
+          out += fence;
+          index += codeSpanFenceLength;
+          codeSpanFenceLength = 0;
+          continue;
+        }
+        const ch = source[index];
+        out += ch;
+        index += 1;
+        if (ch === "\n" || ch === "\r") {
+          codeSpanFenceLength = 0;
+        }
+        continue;
+      }
+
+      const backtickMatch = source.slice(index).match(/^`+/);
+      if (backtickMatch) {
+        const fence = backtickMatch[0] || "`";
+        codeSpanFenceLength = fence.length;
+        out += fence;
+        index += fence.length;
+        continue;
+      }
+
+      if (source.startsWith("<!--", index)) {
+        inHtmlComment = true;
+        index += 4;
+        continue;
+      }
+
+      out += source[index];
+      index += 1;
+    }
+
+    return out;
+  }
+
+  function stripMarkdownHtmlComments(text) {
+    return transformMarkdownOutsideFences(text, function(segment) {
+      return stripMarkdownHtmlCommentsInSegment(segment);
+    });
+  }
+
   function prepareMarkdownForPandocPreview(markdown, placeholderPrefix) {
     const placeholders = [];
     const prefix = typeof placeholderPrefix === "string" && placeholderPrefix
@@ -536,6 +601,7 @@
     renderPreviewAnnotationHtml: renderPreviewAnnotationHtml,
     replaceInlineAnnotationMarkers: replaceInlineAnnotationMarkers,
     stripAnnotationMarkers: stripAnnotationMarkers,
+    stripMarkdownHtmlComments: stripMarkdownHtmlComments,
     transformMarkdownOutsideFences: transformMarkdownOutsideFences,
   });