starlight-cannoli-plugins 1.2.18 → 2.0.0

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

@@ -2,7 +2,7 @@
 import {
   LATEX_BLOCK_REGEX,
   hashLatexCode
-} from "../chunk-KQM5EAEK.js";
+} from "../chunk-47X5MKFJ.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/starlight-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/remark-latex-compile.js';
+export { rehypeLatexCompile, default as remarkLatexCompile } from './plugins/remark-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-S4YMC25A.js";
+import {
+  astroNormalizePaths
+} from "./chunk-AZPHBHBE.js";
 import {
-  starlightSyncDocsToPublic
-} from "./chunk-SBGY6FD3.js";
+  syncDocsToPublic
+} from "./chunk-3OL3VUEB.js";
 import "./chunk-3ATSZG6H.js";
-import "./chunk-KQM5EAEK.js";
+import "./chunk-47X5MKFJ.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/remark-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-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/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/dist/plugins/remark-latex-compile.d.ts

@@ -1,4 +1,41 @@
-export { R as RemarkLatexCompileOptions, c as compileLatexToSvg, a as default, r as rehypeLatexCompile, s as starlightLatexCompile } from '../index-Ce1VCMrW.js';
-import '@astrojs/starlight/types';
-import 'hast';
-import 'vfile';
+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

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

package/dist/plugins/starlight-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/starlight-sync-docs-to-public.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "1.2.18",
+  "version": "2.0.0",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",
@@ -30,10 +30,6 @@
       "import": "./dist/plugins/remark-latex-compile.js",
       "types": "./dist/plugins/remark-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"

package/dist/chunk-DEXMXUQL.js

@@ -1,229 +0,0 @@
-import {
-  LATEX_BLOCK_REGEX,
-  compileLatexToSvg,
-  hashLatexCode
-} from "./chunk-KQM5EAEK.js";
-
-// src/plugins/remark-latex-compile/index.ts
-import { resolve } from "path";
-
-// src/plugins/remark-latex-compile/rehype-converter.ts
-import { visit } from "unist-util-visit";
-function rehypeLatexCompile() {
-  return (tree, _file) => {
-    visit(tree, "element", (node, index, parent) => {
-      if (node.tagName !== "pre") return;
-      const codeChild = node.children?.[0];
-      if (!codeChild || codeChild.tagName !== "code") return;
-      const classes = Array.isArray(codeChild.properties?.className) ? codeChild.properties.className : [];
-      if (!classes.includes("language-tex") && !classes.includes("language-latex")) {
-        return;
-      }
-      const codeContent = codeChild.children?.map((child) => typeof child === "string" ? child : child.value || "").join("").trim();
-      if (!codeContent) return;
-      const dataAttribute = codeChild.properties?.["data-meta"];
-      const isCompileBlock = dataAttribute && dataAttribute.includes("compile") || codeContent.includes("compile");
-      if (!isCompileBlock) return;
-      try {
-        const hash = hashLatexCode(codeContent);
-        const svgPath = `/static/tex-svgs/${hash}.svg`;
-        const imgElement = {
-          type: "element",
-          tagName: "img",
-          properties: {
-            src: svgPath,
-            alt: "LaTeX diagram",
-            className: ["tex-compiled"]
-          },
-          children: []
-        };
-        const paragraphElement = {
-          type: "element",
-          tagName: "p",
-          properties: {},
-          children: [imgElement]
-        };
-        if (parent && typeof index === "number") {
-          parent.children[index] = paragraphElement;
-        }
-      } catch (err) {
-        console.error(`[rehype-latex-compile] Error processing code block:`, err);
-      }
-    });
-  };
-}
-
-// src/plugins/remark-latex-compile/index.ts
-function extractClassesFromMeta(meta) {
-  const classMatch = meta.match(/class="([^"]+)"/);
-  if (classMatch && classMatch[1]) {
-    return classMatch[1].split(/\s+/).filter(Boolean);
-  }
-  return [];
-}
-function traverseTree(node, svgOutputDir, filePath, depth = 0) {
-  if (!node) return;
-  const children = node.children;
-  if (Array.isArray(children)) {
-    for (let i = 0; i < children.length; i++) {
-      const child = children[i];
-      if (child.type === "code" && (child.lang === "tex" || child.lang === "latex") && String(child.meta || "").includes("compile")) {
-        const position = child.position;
-        const lineNumber = position?.start?.line || "?";
-        try {
-          const result = compileLatexToSvg(String(child.value), svgOutputDir);
-          if (result.wasCompiled) {
-            console.log(
-              `[remark-latex-compile] ${filePath}:${lineNumber}: compiled ${result.hash}.svg`
-            );
-          }
-          const customClasses = extractClassesFromMeta(
-            String(child.meta || "")
-          );
-          const allClasses = ["tex-compiled", ...customClasses];
-          children[i] = {
-            type: "paragraph",
-            children: [
-              {
-                type: "image",
-                url: `/static/tex-svgs/${result.hash}.svg`,
-                alt: "LaTeX diagram",
-                data: {
-                  hProperties: {
-                    className: allClasses
-                  }
-                }
-              }
-            ]
-          };
-        } catch (err) {
-          if (process.env.NODE_ENV !== "production") {
-            const errorMsg = err instanceof Error ? err.message : String(err);
-            const match = errorMsg.match(/\n\n([\s\S]+)/);
-            const details = match ? match[1] : errorMsg;
-            console.error(`${filePath}:${lineNumber}
-${details}`);
-          }
-        }
-      } else {
-        traverseTree(child, svgOutputDir, filePath, depth + 1);
-      }
-    }
-  }
-}
-function remarkLatexCompile(options) {
-  const svgOutputDir = resolve(options.svgOutputDir);
-  return (tree, file) => {
-    const fileObj = file;
-    const filePath = String(fileObj?.path || fileObj?.filename || "unknown");
-    traverseTree(tree, svgOutputDir, filePath, 0);
-  };
-}
-
-// src/plugins/remark-latex-compile/astro-integration.ts
-import { readdir, readFile, cp } from "fs/promises";
-import { resolve as resolve2, join, extname } from "path";
-function createAstroLatexIntegration(options) {
-  const svgOutputDir = resolve2(options.svgOutputDir);
-  const contentDir = options?.contentDir ? resolve2(options.contentDir) : resolve2("src/content/docs");
-  return {
-    name: "astro-latex-compile",
-    hooks: {
-      "astro:build:start": async () => {
-        console.log(
-          "[astro-latex-compile] Build start, scanning for tex/latex compile blocks"
-        );
-        await scanAndCompileLatex(contentDir, svgOutputDir);
-      },
-      "astro:build:done": async ({ dir }) => {
-        const srcSvgDir = resolve2(svgOutputDir);
-        const outSvgDir = resolve2(dir.pathname, "static/tex-svgs");
-        try {
-          await cp(srcSvgDir, outSvgDir, { recursive: true, force: true });
-          console.log("[astro-latex-compile] Copied SVGs to build output");
-        } catch (err) {
-          console.error("[astro-latex-compile] Error copying SVGs:", err);
-        }
-      }
-    }
-  };
-}
-async function scanAndCompileLatex(dir, svgOutputDir) {
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      await scanAndCompileLatex(fullPath, svgOutputDir);
-    } else if (entry.isFile()) {
-      const ext = extname(entry.name);
-      if (ext === ".md" || ext === ".mdx") {
-        console.log(`[astro-latex-compile] Found markdown file: ${fullPath}`);
-        await processMarkdownFile(fullPath, svgOutputDir);
-      }
-    }
-  }
-}
-function getLineNumber(content, position) {
-  return content.substring(0, position).split("\n").length;
-}
-async function processMarkdownFile(filePath, svgOutputDir) {
-  const content = await readFile(filePath, "utf-8");
-  const latexBlockRegex = new RegExp(
-    LATEX_BLOCK_REGEX.source,
-    LATEX_BLOCK_REGEX.flags
-  );
-  const matches = content.matchAll(latexBlockRegex);
-  for (const match of matches) {
-    const latexCode = match[1];
-    const lineNumber = getLineNumber(content, match.index || 0);
-    try {
-      const result = compileLatexToSvg(latexCode, svgOutputDir);
-      const status = result.wasCompiled ? "compiled" : "used cached";
-      console.log(
-        `[astro-latex-compile] ${filePath}:${lineNumber}: ${status} ${result.hash}.svg`
-      );
-    } catch (err) {
-      const error = err instanceof Error ? err : new Error(String(err));
-      error.message = `${filePath}:${lineNumber}
-${error.message}`;
-      throw error;
-    }
-  }
-}
-
-// src/plugins/remark-latex-compile/starlight-plugin.ts
-function starlightLatexCompile(options) {
-  return {
-    name: "starlight-latex-compile",
-    hooks: {
-      "config:setup": (hook) => {
-        hook.addIntegration({
-          name: "latex-compile-remark-integration",
-          hooks: {
-            "astro:config:setup": ({ updateConfig, config }) => {
-              const existingPlugins = (Array.isArray(config.markdown?.remarkPlugins) ? config.markdown.remarkPlugins : []).filter((p) => p !== void 0 && p !== null);
-              updateConfig({
-                markdown: {
-                  remarkPlugins: [...existingPlugins, [remarkLatexCompile, options]]
-                }
-              });
-            }
-          }
-        });
-        hook.addIntegration(
-          createAstroLatexIntegration({
-            svgOutputDir: options.svgOutputDir
-          })
-        );
-      }
-    }
-  };
-}
-var starlight_plugin_default = starlightLatexCompile;
-
-export {
-  starlightLatexCompile,
-  starlight_plugin_default,
-  rehypeLatexCompile,
-  remarkLatexCompile
-};