starlight-cannoli-plugins 1.2.18 → 2.0.1

package/dist/{chunk-KQM5EAEK.js → chunk-TTQY54Q6.js}

@@ -1,6 +1,6 @@
-// src/plugins/remark-latex-compile/compile.ts
+// src/plugins/astro-latex-compile/utils.ts
 import { createHash } from "crypto";
-import { spawnSync } from "child_process";
+import { spawn } from "child_process";
 import {
   existsSync,
   mkdirSync,
@@ -11,7 +11,7 @@ import {
 import { join } from "path";
 import { tmpdir } from "os";
 
-// src/plugins/remark-latex-compile/error-parser.ts
+// src/plugins/astro-latex-compile/error-parser.ts
 function parseLatexError(latexOutput) {
   const lines = latexOutput.split("\n");
   const errors = [];
@@ -161,7 +161,7 @@ ${formattedSource}
 `;
 }
 
-// src/plugins/remark-latex-compile/compile.ts
+// src/plugins/astro-latex-compile/utils.ts
 var LATEX_BLOCK_REGEX = /```(?:tex|latex)\s+compile[^\r\n]*\r?\n([\s\S]*?)\r?\n```/g;
 function hashLatexCode(code) {
   const normalized = code.split("\n").map((line) => line.trim()).filter((line) => !line.startsWith("%")).filter(Boolean).join("\n").trim();
@@ -188,7 +188,26 @@ function buildLatexSource(latexCode) {
     "\\end{document}"
   ].join("\n");
 }
-function compileLatexToSvg(latexCode, svgOutputDir) {
+function execProcess(command, args) {
+  return new Promise((resolve, reject) => {
+    let stdout = "";
+    let stderr = "";
+    const proc = spawn(command, args);
+    proc.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    proc.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    proc.on("error", (err) => {
+      reject(err);
+    });
+    proc.on("close", (code) => {
+      resolve({ status: code ?? 1, stdout, stderr });
+    });
+  });
+}
+async function compileLatexToSvg(latexCode, svgOutputDir) {
   const hash = hashLatexCode(latexCode);
   const svgPath = join(svgOutputDir, `${hash}.svg`);
   if (existsSync(svgPath)) {
@@ -201,41 +220,47 @@ function compileLatexToSvg(latexCode, svgOutputDir) {
   const latexSource = buildLatexSource(latexCode);
   try {
     writeFileSync(texFile, latexSource, "utf-8");
-    const latexResult = spawnSync("pdflatex", [
-      "-interaction=nonstopmode",
-      "-output-directory",
-      workDir,
-      texFile
-    ]);
-    if (latexResult.error) {
-      const code = latexResult.error.code;
+    let result;
+    try {
+      result = await execProcess("pdflatex", [
+        "-interaction=nonstopmode",
+        "-output-directory",
+        workDir,
+        texFile
+      ]);
+    } catch (err) {
+      const code = err.code;
       throw new Error(
-        `[remark-latex-compile] pdflatex not found on PATH (${code}).`
+        `[remark-latex-compile] pdflatex not found on PATH (${code}).`,
+        { cause: err }
       );
     }
-    if (latexResult.status !== 0) {
-      const errorOutput = latexResult.stderr?.toString() || latexResult.stdout?.toString() || "";
+    if (result.status !== 0) {
+      const errorOutput = result.stderr || result.stdout || "";
       const userMessage = createCompilationErrorMessage(
         latexSource,
         errorOutput
       );
       throw new Error(userMessage);
     }
-    const dvisvgmResult = spawnSync("dvisvgm", [
-      "--pdf",
-      "--bbox=dvi",
-      pdfFile,
-      "-o",
-      svgPath
-    ]);
-    if (dvisvgmResult.error) {
-      const code = dvisvgmResult.error.code;
+    let svgResult;
+    try {
+      svgResult = await execProcess("dvisvgm", [
+        "--pdf",
+        "--bbox=dvi",
+        pdfFile,
+        "-o",
+        svgPath
+      ]);
+    } catch (err) {
+      const code = err.code;
       throw new Error(
-        `[remark-latex-compile] dvisvgm not found on PATH (${code}).`
+        `[remark-latex-compile] dvisvgm not found on PATH (${code}).`,
+        { cause: err }
       );
     }
-    if (dvisvgmResult.status !== 0) {
-      const errorOutput = dvisvgmResult.stderr?.toString() || dvisvgmResult.stdout?.toString() || "";
+    if (svgResult.status !== 0) {
+      const errorOutput = svgResult.stderr || svgResult.stdout || "";
       throw new Error(
         `[remark-latex-compile] PDF to SVG conversion failed (hash: ${hash}).
 Error: ${errorOutput}`

package/dist/cli/cannoli-latex-cleanup.js

@@ -2,7 +2,7 @@
 import {
   LATEX_BLOCK_REGEX,
   hashLatexCode
-} from "../chunk-KQM5EAEK.js";
+} from "../chunk-TTQY54Q6.js";
 import "../chunk-QGM4M3NI.js";
 
 // scripts/cli/cannoli-latex-cleanup.ts

package/dist/index.d.ts

@@ -1,19 +1,25 @@
 export { starlightIndexOnlySidebar } from './plugins/starlight-index-only-sidebar.js';
-export { starlightSyncDocsToPublic } from './plugins/starlight-sync-docs-to-public.js';
+export { SyncDocsToPublicOptions, syncDocsToPublic } from './plugins/astro-sync-docs-to-public.js';
 export { default as rehypeValidateLinks } from './plugins/rehype-validate-links.js';
+export { astroNormalizePaths } from './plugins/astro-normalize-paths.js';
+import { RemarkLatexCompileOptions } from './plugins/astro-latex-compile.js';
+export { rehypeLatexCompile, default as remarkLatexCompile } from './plugins/astro-latex-compile.js';
 import { AstroIntegration } from 'astro';
-export { r as rehypeLatexCompile, a as remarkLatexCompile, s as starlightLatexCompile } from './index-Ce1VCMrW.js';
 import '@astrojs/starlight/types';
 import 'hast';
 import 'vfile';
+import 'mdast';
 
-/**
- * Astro integration that normalizes img src and anchor href attributes to absolute paths in HTML files after build.
- * This processes resources in Starlight docs that aren't handled by the rehype plugin.
- *
- * Handles the case where Astro converts markdown files into index.html files in subdirectories,
- * which changes the relative path structure.
- */
-declare function astroNormalizePaths(): AstroIntegration;
+interface LatexCompileOptions extends RemarkLatexCompileOptions {
+    /**
+     * When `true`, SVG files in `svgOutputDir` that are no longer referenced by
+     * any `tex compile` block are deleted automatically. In dev mode, stale SVGs
+     * are removed immediately when a block is edited. On build, any remaining
+     * orphans are swept at the end.
+     * @default false
+     */
+    removeOrphanedSvgs?: boolean;
+}
+declare function astroLatexCompile(options: LatexCompileOptions): AstroIntegration;
 
-export { astroNormalizePaths };
+export { type LatexCompileOptions, astroLatexCompile };

package/dist/index.js

@@ -3,91 +3,88 @@ import {
 } from "./chunk-HDL4DZNT.js";
 import {
   rehypeValidateLinks
-} from "./chunk-HRUZQZ5L.js";
+} from "./chunk-FQLJMU2J.js";
 import {
   rehypeLatexCompile,
-  remarkLatexCompile,
-  starlightLatexCompile
-} from "./chunk-DEXMXUQL.js";
+  remarkLatexCompile
+} from "./chunk-IX5UFISR.js";
+import {
+  astroNormalizePaths
+} from "./chunk-AZPHBHBE.js";
 import {
-  starlightSyncDocsToPublic
-} from "./chunk-SBGY6FD3.js";
+  syncDocsToPublic
+} from "./chunk-JOXQGMUL.js";
 import "./chunk-3ATSZG6H.js";
-import "./chunk-KQM5EAEK.js";
+import "./chunk-TTQY54Q6.js";
 import "./chunk-QGM4M3NI.js";
 
-// src/plugins/astro-normalize-paths.ts
-import { readFileSync, writeFileSync, existsSync } from "fs";
-import { sync as globSync } from "glob";
-import { dirname, resolve } from "path";
-function astroNormalizePaths() {
+// src/plugins/astro-latex-compile/astro-integration.ts
+import fs from "fs";
+import { readdir, rm } from "fs/promises";
+import { join, resolve } from "path";
+var DATA_STORE_FILE = "data-store.json";
+function getDataStoreFile(config) {
+  return new URL(DATA_STORE_FILE, config.cacheDir);
+}
+async function clearContentLayerCache(config) {
+  const dataStore = getDataStoreFile(config);
+  if (fs.existsSync(dataStore)) {
+    await fs.promises.rm(dataStore, { force: true });
+  }
+}
+function astroLatexCompile(options) {
+  const referencedHashes = /* @__PURE__ */ new Set();
+  const fileHashMap = /* @__PURE__ */ new Map();
   return {
-    name: "astro-normalize-paths",
+    name: "astro-latex-compile",
     hooks: {
-      "astro:build:done": async ({ dir }) => {
-        const htmlFiles = globSync(`${dir.pathname}/**/*.html`);
-        for (const htmlFile of htmlFiles) {
-          let content = readFileSync(htmlFile, "utf-8");
-          const originalContent = content;
-          const imgRegex = /<img([^>]*?)src=["']([^"']+)["']/g;
-          let match;
-          while ((match = imgRegex.exec(content)) !== null) {
-            const attrs = match[1];
-            const src = match[2];
-            const normalized = normalizeAssetPath(src, htmlFile, dir.pathname);
-            if (normalized && src !== normalized) {
-              console.log(`[astro-normalize-paths] Img path resolution:`);
-              console.log(`  Original: ${src}`);
-              console.log(`  HTML file: ${htmlFile}`);
-              console.log(`  Normalized: ${normalized}`);
-              const oldTag = `<img${attrs}src="${src}"`;
-              const newTag = `<img${attrs}src="${normalized}"`;
-              content = content.replace(oldTag, newTag);
-            }
-          }
-          const anchorRegex = /<a([^>]*?)href=["']([^"']+)["']/g;
-          while ((match = anchorRegex.exec(content)) !== null) {
-            const attrs = match[1];
-            const href = match[2];
-            const normalized = normalizeAssetPath(href, htmlFile, dir.pathname);
-            if (normalized && href !== normalized) {
-              const oldTag = `<a${attrs}href="${href}"`;
-              const newTag = `<a${attrs}href="${normalized}"`;
-              content = content.replace(oldTag, newTag);
-            }
-          }
-          if (content !== originalContent) {
-            writeFileSync(htmlFile, content, "utf-8");
+      "astro:config:setup": async ({ command, config, updateConfig }) => {
+        if (command !== "build" && command !== "dev") return;
+        if (command === "build") {
+          await clearContentLayerCache(config);
+        }
+        const existingPlugins = Array.isArray(config.markdown?.remarkPlugins) ? config.markdown.remarkPlugins.filter(Boolean) : [];
+        const remarkOptions = {
+          ...options,
+          _fileHashMap: options.removeOrphanedSvgs ? fileHashMap : void 0,
+          _referencedHashes: command === "build" && options.removeOrphanedSvgs ? referencedHashes : void 0
+        };
+        updateConfig({
+          markdown: {
+            remarkPlugins: [...existingPlugins, [remarkLatexCompile, remarkOptions]]
           }
+        });
+      },
+      "astro:build:done": async () => {
+        if (!options.removeOrphanedSvgs) return;
+        const svgDir = resolve(options.svgOutputDir);
+        let entries;
+        try {
+          entries = await readdir(svgDir);
+        } catch {
+          return;
+        }
+        const orphans = entries.filter(
+          (f) => f.endsWith(".svg") && !referencedHashes.has(f.slice(0, -4))
+        );
+        await Promise.all(
+          orphans.map((f) => rm(join(svgDir, f), { force: true }))
+        );
+        if (orphans.length > 0) {
+          console.log(
+            `[astro-latex-compile] Removed ${orphans.length} orphaned SVG${orphans.length === 1 ? "" : "s"}.`
+          );
         }
       }
     }
   };
 }
-function normalizeAssetPath(path, htmlFile, siteRootPath) {
-  if (path.startsWith("http") || path.startsWith("data:") || path.startsWith("/")) {
-    return null;
-  }
-  const htmlDir = dirname(htmlFile);
-  const resolvedPath = resolve(htmlDir, path);
-  const siteRoot = resolve(siteRootPath);
-  let absolutePath = resolvedPath.slice(siteRoot.length).replace(/\\/g, "/");
-  if (!existsSync(resolvedPath)) {
-    const parentDir = dirname(htmlDir);
-    const alternativePath = resolve(parentDir, path);
-    if (existsSync(alternativePath)) {
-      absolutePath = alternativePath.slice(siteRoot.length).replace(/\\/g, "/");
-    }
-  }
-  const finalPath = "/" + absolutePath.replace(/^\/+/, "");
-  return finalPath;
-}
 export {
+  astroLatexCompile,
   astroNormalizePaths,
   rehypeLatexCompile,
   rehypeValidateLinks,
   remarkLatexCompile,
   starlightIndexOnlySidebar,
-  starlightLatexCompile,
-  starlightSyncDocsToPublic
+  syncDocsToPublic
 };

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

@@ -0,0 +1,41 @@
+import { Root as Root$1 } from 'mdast';
+import { VFile } from 'vfile';
+import { Root } from 'hast';
+
+interface CompilationResult {
+    hash: string;
+    svgPath: string;
+    wasCompiled: boolean;
+}
+/**
+ * Compile LaTeX code to SVG.
+ *
+ * @param latexCode - The LaTeX code to compile (e.g., TikZ, pgfplots, etc.)
+ * @param svgOutputDir - The directory where SVG files should be written
+ * @returns Result object with hash, svgPath, and whether compilation occurred
+ * @throws Error if compilation fails
+ */
+declare function compileLatexToSvg(latexCode: string, svgOutputDir: string): Promise<CompilationResult>;
+
+declare function rehypeLatexCompile(): (tree: Root, _file: VFile) => void;
+
+interface RemarkLatexCompileOptions {
+    /**
+     * Directory where SVG files should be written.
+     * Must be inside `public/` so Astro serves them as static assets.
+     */
+    svgOutputDir: string;
+    /**
+     * @internal Populated by the Astro integration to track which hashes were
+     * referenced during a build, used for full orphan cleanup at build:done.
+     */
+    _referencedHashes?: Set<string>;
+    /**
+     * @internal Maps each file path to the set of hashes it produced on the
+     * previous remark run. Used to delete stale SVGs when a block changes.
+     */
+    _fileHashMap?: Map<string, Set<string>>;
+}
+declare function remarkLatexCompile(options: RemarkLatexCompileOptions): (tree: Root$1, file: VFile) => Promise<void>;
+
+export { type RemarkLatexCompileOptions, compileLatexToSvg, remarkLatexCompile as default, rehypeLatexCompile };

package/dist/plugins/{remark-latex-compile.js → astro-latex-compile.js}

@@ -1,15 +1,13 @@
 import {
   rehypeLatexCompile,
-  remarkLatexCompile,
-  starlightLatexCompile
-} from "../chunk-DEXMXUQL.js";
+  remarkLatexCompile
+} from "../chunk-IX5UFISR.js";
 import {
   compileLatexToSvg
-} from "../chunk-KQM5EAEK.js";
+} from "../chunk-TTQY54Q6.js";
 import "../chunk-QGM4M3NI.js";
 export {
   compileLatexToSvg,
   remarkLatexCompile as default,
-  rehypeLatexCompile,
-  starlightLatexCompile
+  rehypeLatexCompile
 };

package/dist/plugins/astro-normalize-paths.d.ts

@@ -0,0 +1,12 @@
+import { AstroIntegration } from 'astro';
+
+/**
+ * Astro integration that normalizes img src and anchor href attributes to absolute paths in HTML files after build.
+ * This processes resources in Starlight docs that aren't handled by the rehype plugin.
+ *
+ * Handles the case where Astro converts markdown files into index.html files in subdirectories,
+ * which changes the relative path structure.
+ */
+declare function astroNormalizePaths(): AstroIntegration;
+
+export { astroNormalizePaths, astroNormalizePaths as default };

package/dist/plugins/astro-normalize-paths.js

@@ -0,0 +1,9 @@
+import {
+  astroNormalizePaths,
+  astro_normalize_paths_default
+} from "../chunk-AZPHBHBE.js";
+import "../chunk-QGM4M3NI.js";
+export {
+  astroNormalizePaths,
+  astro_normalize_paths_default as default
+};

package/dist/plugins/{starlight-sync-docs-to-public.d.ts → astro-sync-docs-to-public.d.ts}

@@ -1,7 +1,7 @@
-import { HookParameters } from '@astrojs/starlight/types';
+import { AstroIntegration } from 'astro';
 
 /**
- * Astro/Starlight plugin that syncs a source docs directory to the public directory.
+ * Astro integration that syncs a source docs directory to the public directory.
  *
  * Runs once at build start, and in dev mode watches the source directory for
  * changes and incrementally syncs files — no full directory deletion/recreation.
@@ -20,11 +20,8 @@ interface SyncDocsToPublicOptions {
      */
     ignorePatterns?: string[];
 }
-declare function starlightSyncDocsToPublic(options: SyncDocsToPublicOptions): {
-    name: string;
-    hooks: {
-        "config:setup": (hook: HookParameters<"config:setup">) => void;
-    };
-};
+declare function syncDocsToPublic(options: SyncDocsToPublicOptions): AstroIntegration;
+/** @deprecated Use {@link syncDocsToPublic} instead. */
+declare const starlightSyncDocsToPublic: typeof syncDocsToPublic;
 
-export { type SyncDocsToPublicOptions, starlightSyncDocsToPublic };
+export { type SyncDocsToPublicOptions, starlightSyncDocsToPublic, syncDocsToPublic };

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

@@ -0,0 +1,10 @@
+import {
+  starlightSyncDocsToPublic,
+  syncDocsToPublic
+} from "../chunk-JOXQGMUL.js";
+import "../chunk-3ATSZG6H.js";
+import "../chunk-QGM4M3NI.js";
+export {
+  starlightSyncDocsToPublic,
+  syncDocsToPublic
+};

package/dist/plugins/rehype-validate-links.js

@@ -1,7 +1,7 @@
 import {
   rehypeValidateLinks,
   rehype_validate_links_default
-} from "../chunk-HRUZQZ5L.js";
+} from "../chunk-FQLJMU2J.js";
 import "../chunk-QGM4M3NI.js";
 export {
   rehype_validate_links_default as default,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "1.2.18",
+  "version": "2.0.1",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",
@@ -26,17 +26,13 @@
       "import": "./dist/plugins/astro-normalize-paths.js",
       "types": "./dist/plugins/astro-normalize-paths.d.ts"
     },
-    "./remark-latex-compile": {
-      "import": "./dist/plugins/remark-latex-compile.js",
-      "types": "./dist/plugins/remark-latex-compile.d.ts"
+    "./astro-latex-compile": {
+      "import": "./dist/plugins/astro-latex-compile.js",
+      "types": "./dist/plugins/astro-latex-compile.d.ts"
     },
-    "./starlight-latex-compile": {
-      "import": "./dist/plugins/starlight-latex-compile.js",
-      "types": "./dist/plugins/starlight-latex-compile.d.ts"
-    },
-    "./starlight-sync-docs-to-public": {
-      "import": "./dist/plugins/starlight-sync-docs-to-public.js",
-      "types": "./dist/plugins/starlight-sync-docs-to-public.d.ts"
+    "./astro-sync-docs-to-public": {
+      "import": "./dist/plugins/astro-sync-docs-to-public.js",
+      "types": "./dist/plugins/astro-sync-docs-to-public.d.ts"
     },
     "./styles": "./dist/styles/",
     "./styles/*": "./dist/styles/*"