starlight-cannoli-plugins 2.12.0 → 2.13.0

package/dist/{chunk-3GUF4GRX.js → chunk-JFHWCFHF.js}

@@ -1,6 +1,6 @@
 import {
   parseFrontmatter
-} from "./chunk-NCXV367P.js";
+} from "./chunk-WFN7OFMJ.js";
 
 // src/plugins/starlight-index-only-sidebar/index.ts
 import { join as join2 } from "path";

package/dist/{chunk-TRGFYY3Y.js → chunk-O2TZASB7.js}

@@ -22,7 +22,12 @@ function expressiveCodeEmphasis() {
         if (terms.length === 0) return;
         for (const line of context.codeBlock.getLines()) {
           for (const term of terms) {
-            const regex = new RegExp(`\\b${escapeRegex(term)}\\b`, "g");
+            const left = /\w/.test(term[0]) ? "\\b" : "(?<!\\S)";
+            const right = /\w/.test(term[term.length - 1]) ? "\\b" : "(?!\\S)";
+            const regex = new RegExp(
+              `${left}${escapeRegex(term)}${right}`,
+              "g"
+            );
             for (const match of line.text.matchAll(regex)) {
               line.addAnnotation(
                 new EmphasisAnnotation({

package/dist/{chunk-K65RRBFX.js → chunk-QPHWDN2I.js}

@@ -1,6 +1,6 @@
 import {
   parseFrontmatter
-} from "./chunk-NCXV367P.js";
+} from "./chunk-WFN7OFMJ.js";
 
 // src/plugins/astro-sync-docs-to-public/index.ts
 import { fileURLToPath } from "url";

package/dist/{chunk-G2PJENXJ.js → chunk-WFEFWQAK.js}

@@ -1,7 +1,11 @@
+import {
+  parseFrontmatter
+} from "./chunk-C2VXRQOK.js";
+
 // src/plugins/astro-latex-compile/index.ts
-import { existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 import { rm } from "fs/promises";
-import { join as join2, resolve as resolve2 } from "path";
+import { join as join2, relative as relative2, resolve as resolve2 } from "path";
 import { visit, SKIP } from "unist-util-visit";
 import { MetaOptions } from "@expressive-code/core";
 
@@ -10,11 +14,13 @@ import { createHash } from "crypto";
 import {
   existsSync,
   mkdirSync,
+  readdirSync,
+  readFileSync,
   writeFileSync,
   rmSync,
   mkdtempSync
 } from "fs";
-import { basename, dirname, join, resolve } from "path";
+import { basename, dirname, join, relative, resolve } from "path";
 import { tmpdir } from "os";
 import sharp from "sharp";
 
@@ -188,15 +194,70 @@ function execProcess(command, args, options) {
   });
 }
 
+// src/plugins/utils/html-builder.ts
+import { JSDOM } from "jsdom";
+var { document } = new JSDOM("").window;
+var HtmlSanitizer = {
+  tempElement: document.createElement("div"),
+  sanitize(htmlString) {
+    this.tempElement.textContent = htmlString;
+    return this.tempElement.innerHTML;
+  }
+};
+var HtmlString = class extends String {
+  element = null;
+  constructor(value) {
+    super(value);
+  }
+  asElement() {
+    if (this.element !== null) {
+      return this.element;
+    }
+    const temp = document.createElement("div");
+    temp.innerHTML = this.valueOf();
+    if (temp.childElementCount > 1) {
+      throw new Error("html template does not accept more than 1 element");
+    }
+    const child = temp.firstElementChild;
+    if (child === null) {
+      throw new Error("html template produced no elements");
+    }
+    this.element = child;
+    return this.element;
+  }
+};
+function html(literalValues, ...interpolatedValues) {
+  let result = "";
+  interpolatedValues.forEach((currentInterpolatedVal, idx) => {
+    const literalVal = literalValues[idx];
+    let interpolatedVal = "";
+    if (Array.isArray(currentInterpolatedVal)) {
+      interpolatedVal = currentInterpolatedVal.join("\n");
+    } else if (typeof currentInterpolatedVal !== "boolean") {
+      interpolatedVal = currentInterpolatedVal.toString();
+    }
+    const isSanitize = !literalVal.endsWith("$");
+    if (isSanitize) {
+      result += literalVal;
+      result += HtmlSanitizer.sanitize(interpolatedVal);
+    } else {
+      result += literalVal.slice(0, -1);
+      result += interpolatedVal;
+    }
+  });
+  result += literalValues.slice(-1);
+  return new HtmlString(result);
+}
+
 // src/plugins/astro-latex-compile/utils.ts
 var CONTENT_ROOT = "src/content/docs/";
-function computeJpgPath(tempOutputDir, filePath, blockId, hash) {
+function computeJpgPath(tempOutputDir, filePath, blockId) {
   const normalized = filePath.replace(/\\/g, "/");
   const idx = normalized.indexOf(CONTENT_ROOT);
   const relativePath = idx !== -1 ? normalized.slice(idx + CONTENT_ROOT.length) : basename(normalized);
   const dir = dirname(relativePath);
   const filename = basename(relativePath);
-  const jpgFilename = `${filename}--${blockId}--${hash}.jpg`;
+  const jpgFilename = `${filename}--${blockId}.jpg`;
   const base = resolve(tempOutputDir);
   return dir === "." ? join(base, jpgFilename) : join(base, dir, jpgFilename);
 }
@@ -255,33 +316,107 @@ async function writeJpgError(jpgPath, header, errorText) {
   mkdirSync(dirname(jpgPath), { recursive: true });
   await sharp(Buffer.from(svg)).flatten({ background: { r: 255, g: 255, b: 255 } }).jpeg({ quality: 90 }).toFile(jpgPath);
 }
-function hashLatexCode(code) {
+function computeLineOffset(_latexCode) {
+  return 0;
+}
+function buildErrorHtml(header, errorMsg, latexCode) {
+  const clean = stripAnsi(errorMsg);
+  const sourceIdx = clean.indexOf("LaTeX source:");
+  const summary = (sourceIdx !== -1 ? clean.slice(0, sourceIdx) : clean).trimEnd();
+  const compiledLineNums = [];
+  const linePattern = /Error \(line (\d+)\)/g;
+  let m;
+  while ((m = linePattern.exec(summary)) !== null) {
+    compiledLineNums.push(parseInt(m[1], 10));
+  }
+  const offset = computeLineOffset(latexCode);
+  const errorLineSet = new Set(
+    compiledLineNums.map((n) => n - offset).filter((n) => n > 0)
+  );
+  const codeLines = latexCode.split("\n");
+  const lineWidth = String(codeLines.length).length;
+  const summaryLines = summary.split("\n").map((line) => line.trim()).filter(Boolean).map((line) => html`<div>${line}</div>`);
+  const codeBlock = new HtmlString(
+    codeLines.map((line, i) => {
+      const lineNum = i + 1;
+      const isError = errorLineSet.has(lineNum);
+      const gutter = String(lineNum).padStart(lineWidth);
+      const bg = isError ? "background:var(--cannoli-error-low);" : "";
+      return html`<span style="${bg}display:block;padding:0 14px"
+          ><span style="color:var(--sl-color-gray-3);user-select:none"
+            >${gutter} │ </span
+          >${line}</span
+        >`.toString();
+    }).join("")
+  );
+  return html`<div
+    class="not-content"
+    style="border:1px solid var(--cannoli-error-low);border-radius:6px;overflow:hidden;margin:1.5em 0;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:13px;line-height:1.5;display:flex;flex-direction:column"
+  >
+    <div
+      style="background:var(--cannoli-error);color:var(--sl-color-black);padding:8px 14px;font-weight:700"
+    >
+      &#9888;&nbsp;LaTeX Compilation Error &mdash; ${header}
+    </div>
+    <div
+      style="background:var(--cannoli-error-low);color:var(--cannoli-error-high);padding:10px 14px;border-bottom:1px solid var(--cannoli-error)"
+    >
+      $${summaryLines}
+    </div>
+    <pre
+      style="margin:0;background:var(--sl-color-gray-6);color:var(--sl-color-text);overflow-x:auto"
+    ><code style="display:block;padding:8px 0;font-size:12px">$${codeBlock}</code></pre>
+  </div>`.toString();
+}
+function collectTexInputFiles(dir, recursive) {
+  const files = [];
+  try {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory() && recursive) {
+        files.push(...collectTexInputFiles(full, recursive));
+      } else if (entry.isFile()) {
+        files.push(full);
+      }
+    }
+  } catch {
+  }
+  return files.sort();
+}
+function computeTexInputDirsSalt(texInputDirs) {
+  if (texInputDirs.length === 0) return "";
+  const hash = createHash("md5");
+  let hasAnyFile = false;
+  for (const dir of texInputDirs) {
+    const recursive = dir.endsWith("//");
+    const resolved = resolve(dir.endsWith("/") ? dir.slice(0, -1) : dir);
+    for (const filePath of collectTexInputFiles(resolved, recursive)) {
+      try {
+        hash.update(relative(process.cwd(), filePath));
+        hash.update(readFileSync(filePath));
+        hasAnyFile = true;
+      } catch {
+      }
+    }
+  }
+  return hasAnyFile ? hash.digest("hex").slice(0, 16) : "";
+}
+function hashLatexCode(code, salt = "") {
   const normalized = code.split("\n").map((line) => line.trim()).filter((line) => !line.startsWith("%")).filter(Boolean).join("\n").trim();
-  return createHash("md5").update(normalized).digest("hex").slice(0, 16);
+  const h = createHash("md5").update(normalized);
+  if (salt) h.update(salt);
+  return h.digest("hex").slice(0, 16);
 }
 function buildLatexSource(latexCode) {
   if (latexCode.includes("\\documentclass") && latexCode.includes("\\begin{document}")) {
     return latexCode.trim();
   }
-  const separatorRegex = /%[ \t]*===/;
-  const parts = latexCode.split(separatorRegex);
-  let preamble = "";
-  let content = latexCode.trim();
-  if (parts.length === 2) {
-    preamble = parts[0].trim();
-    content = parts[1].trim();
-  }
-  return [
-    "\\documentclass[border=5pt]{standalone}",
-    preamble,
-    "\\begin{document}",
-    "\\Large",
-    content,
-    "\\end{document}"
-  ].join("\n");
+  throw new Error(
+    `[remark-latex-compile] Code block is not a complete LaTeX document. Blocks must contain both \\documentclass and \\begin{document}.`
+  );
 }
-async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = []) {
-  const hash = hashLatexCode(latexCode);
+async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = [], inputsSalt = "") {
+  const hash = hashLatexCode(latexCode, inputsSalt);
   const svgPath = join(svgOutputDir, `${hash}.svg`);
   if (existsSync(svgPath)) {
     return { hash, svgPath, wasCompiled: false };
@@ -352,6 +487,16 @@ Error: ${errorOutput}`
 }
 
 // src/plugins/astro-latex-compile/index.ts
+function getFrontmatterOffset(absoluteFilePath) {
+  try {
+    const original = readFileSync2(absoluteFilePath, "utf-8");
+    const { rawFrontmatter } = parseFrontmatter(original);
+    if (!rawFrontmatter) return 0;
+    return rawFrontmatter.split("\n").length - 1 + 2;
+  } catch {
+    return 0;
+  }
+}
 function remarkLatexCompile(options) {
   const svgOutputDir = resolve2(options.svgOutputDir);
   return async function transformer(tree, file) {
@@ -364,29 +509,31 @@ function remarkLatexCompile(options) {
     });
     if (nodes.length === 0) return;
     const filePath = file.path || "unknown";
+    const relFilePath = filePath !== "unknown" ? relative2(process.cwd(), filePath) : "unknown";
+    const frontmatterOffset = filePath !== "unknown" ? getFrontmatterOffset(filePath) : 0;
+    const inputsSalt = computeTexInputDirsSalt(options.texInputDirs ?? []);
     const results = await Promise.all(
       nodes.map(async ({ node, index, parent }) => {
-        const lineNumberStr = node.position?.start.line ?? "?";
+        const lineNumberStr = node.position?.start.line !== void 0 ? String(node.position.start.line + frontmatterOffset) : "?";
         const blockId = new MetaOptions(node.meta ?? "").getInteger("blockid");
-        const contentHash = hashLatexCode(node.value);
-        const canWriteJpg = !!options.tempOutputDir && blockId !== void 0;
+        const jpgPath = options.tempOutputDir && blockId !== void 0 ? computeJpgPath(options.tempOutputDir, filePath, blockId) : null;
         try {
           const result = await compileLatexToSvg(
             node.value,
             svgOutputDir,
-            options.texInputDirs ?? []
+            options.texInputDirs ?? [],
+            inputsSalt
           );
           if (result.wasCompiled) {
             console.log(
-              `[remark-latex-compile] ${filePath}:${lineNumberStr}: compiled ${result.hash}.svg`
+              `[remark-latex-compile] ${relFilePath}:${lineNumberStr}: compiled ${result.hash}.svg`
             );
           }
           options._referencedHashes?.add(result.hash);
-          const jpgPath = canWriteJpg ? computeJpgPath(options.tempOutputDir, filePath, blockId, contentHash) : null;
-          if (jpgPath && !existsSync2(jpgPath)) {
+          if (jpgPath) {
             await writeJpgFromSvg(result.svgPath, jpgPath);
             console.log(
-              `[remark-latex-compile] ${filePath}:${lineNumberStr}: wrote ${jpgPath}`
+              `[remark-latex-compile] ${relFilePath}:${lineNumberStr}: wrote ${jpgPath}`
             );
           }
           return {
@@ -402,14 +549,13 @@ function remarkLatexCompile(options) {
           const match = errorMsg.match(/\n\n([\s\S]+)/);
           const details = match ? match[1] : errorMsg;
           console.error(
-            `[remark-latex-compile] ${filePath}:${lineNumberStr}
+            `[remark-latex-compile] ${relFilePath}:${lineNumberStr}
 ${details}`
           );
-          const jpgPath = canWriteJpg ? computeJpgPath(options.tempOutputDir, filePath, blockId, `${contentHash}--error`) : null;
-          if (jpgPath && !existsSync2(jpgPath)) {
+          if (jpgPath) {
             await writeJpgError(
               jpgPath,
-              `${filePath}:${lineNumberStr}`,
+              `${relFilePath}:${lineNumberStr}`,
               errorMsg
             );
           }
@@ -457,9 +603,22 @@ ${details}`
       options._fileJpgPathMap.set(filePath, newJpgPaths);
     }
     for (let i = results.length - 1; i >= 0; i--) {
-      const { index, parent, result } = results[i];
+      const { index, parent, result, error } = results[i];
       const { node } = nodes[i];
-      if (!result) continue;
+      if (!result) {
+        const lineNumberStr = node.position?.start.line !== void 0 ? String(node.position.start.line + frontmatterOffset) : "?";
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        const errorNode = {
+          type: "html",
+          value: buildErrorHtml(
+            `${relFilePath}:${lineNumberStr}`,
+            errorMsg,
+            node.value
+          )
+        };
+        parent.children.splice(index, 1, errorNode);
+        continue;
+      }
       const metaOptions = new MetaOptions(node.meta ?? "");
       const customClasses = metaOptions.getString("class")?.split(/\s+/).filter(Boolean) ?? [];
       const altText = metaOptions.getString("alt") ?? "LaTeX diagram";

package/dist/chunk-WFN7OFMJ.js

@@ -0,0 +1,28 @@
+import {
+  parseFrontmatter
+} from "./chunk-C2VXRQOK.js";
+
+// src/plugins/utils/workspace-utils.ts
+import * as fs from "fs";
+function parseFrontmatter2(filePath) {
+  let content;
+  try {
+    content = fs.readFileSync(filePath, "utf-8");
+  } catch {
+    return {};
+  }
+  try {
+    const { frontmatter } = parseFrontmatter(content);
+    return frontmatter;
+  } catch (err) {
+    console.warn(
+      `[parseFrontmatter] Failed to parse frontmatter in ${filePath}:`,
+      err
+    );
+    return {};
+  }
+}
+
+export {
+  parseFrontmatter2 as parseFrontmatter
+};

package/dist/index.js

@@ -1,27 +1,29 @@
 import {
   expressiveCodeEmphasis
-} from "./chunk-TRGFYY3Y.js";
+} from "./chunk-O2TZASB7.js";
 import {
   starlightIndexOnlySidebar
-} from "./chunk-3GUF4GRX.js";
+} from "./chunk-JFHWCFHF.js";
 import {
   rehypeValidateLinks
 } from "./chunk-3UMY7T6G.js";
 import {
   remarkLatexCompile
-} from "./chunk-G2PJENXJ.js";
+} from "./chunk-WFEFWQAK.js";
 import {
   astroNormalizePaths
 } from "./chunk-TLOFSB33.js";
 import "./chunk-LJWSZSPB.js";
 import {
   syncDocsToPublic
-} from "./chunk-K65RRBFX.js";
+} from "./chunk-QPHWDN2I.js";
+import {
+  parseFrontmatter
+} from "./chunk-WFN7OFMJ.js";
 import {
-  parseFrontmatter,
   remarkParse,
   unified
-} from "./chunk-NCXV367P.js";
+} from "./chunk-C2VXRQOK.js";
 import {
   starlightDomPatches
 } from "./chunk-PPNIMJPX.js";

package/dist/plugins/astro-latex-compile.d.ts

@@ -14,7 +14,7 @@ interface CompilationResult {
  * @returns Result object with hash, svgPath, and whether compilation occurred
  * @throws Error if compilation fails
  */
-declare function compileLatexToSvg(latexCode: string, svgOutputDir: string, texInputDirs?: string[]): Promise<CompilationResult>;
+declare function compileLatexToSvg(latexCode: string, svgOutputDir: string, texInputDirs?: string[], inputsSalt?: string): Promise<CompilationResult>;
 
 interface RemarkLatexCompileOptions {
     /**

package/dist/plugins/astro-latex-compile.js

@@ -1,7 +1,8 @@
 import {
   compileLatexToSvg,
   remarkLatexCompile
-} from "../chunk-G2PJENXJ.js";
+} from "../chunk-WFEFWQAK.js";
+import "../chunk-C2VXRQOK.js";
 import "../chunk-4VNS5WPM.js";
 export {
   compileLatexToSvg,

package/dist/plugins/astro-sync-docs-to-public.js

@@ -1,7 +1,8 @@
 import {
   syncDocsToPublic
-} from "../chunk-K65RRBFX.js";
-import "../chunk-NCXV367P.js";
+} from "../chunk-QPHWDN2I.js";
+import "../chunk-WFN7OFMJ.js";
+import "../chunk-C2VXRQOK.js";
 import "../chunk-4VNS5WPM.js";
 export {
   syncDocsToPublic

package/dist/plugins/expressive-code-emphasis.js

@@ -1,6 +1,6 @@
 import {
   expressiveCodeEmphasis
-} from "../chunk-TRGFYY3Y.js";
+} from "../chunk-O2TZASB7.js";
 import "../chunk-4VNS5WPM.js";
 export {
   expressiveCodeEmphasis

package/dist/plugins/starlight-index-only-sidebar.js

@@ -1,7 +1,8 @@
 import {
   starlightIndexOnlySidebar
-} from "../chunk-3GUF4GRX.js";
-import "../chunk-NCXV367P.js";
+} from "../chunk-JFHWCFHF.js";
+import "../chunk-WFN7OFMJ.js";
+import "../chunk-C2VXRQOK.js";
 import "../chunk-4VNS5WPM.js";
 export {
   starlightIndexOnlySidebar

package/dist/styles/_starlight.scss

@@ -2,6 +2,21 @@
 
 $DARK_MODE_ROTATE: 178deg;
 
+/********** Custom Error Colors **********/
+// Starlight's --sl-color-red-* sit at hsl(349°) which reads as pink/magenta.
+// These replacements use true red (0°) for a more conventional error appearance.
+:root {
+  --cannoli-error-low: hsl(0, 70%, 94%);
+  --cannoli-error: hsl(0, 72%, 42%);
+  --cannoli-error-high: hsl(0, 72%, 28%);
+}
+
+[data-theme="dark"] {
+  --cannoli-error-low: hsl(0, 55%, 16%);
+  --cannoli-error: hsl(0, 75%, 60%);
+  --cannoli-error-high: hsl(0, 80%, 82%);
+}
+
 .sl-container:where(.astro-7nkwcw3z) {
   max-width: 50rem;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",