starlight-cannoli-plugins 1.2.18 → 2.0.1

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
-};

package/dist/chunk-SBGY6FD3.js

@@ -1,191 +0,0 @@
-import {
-  parseFrontmatter
-} from "./chunk-3ATSZG6H.js";
-
-// src/plugins/starlight-sync-docs-to-public.ts
-import { cp, mkdir, readdir, readFile, writeFile, rm, stat } from "fs/promises";
-import { resolve, relative } from "path";
-import { minimatch } from "minimatch";
-var DEFAULT_SRC_DIR = "src/content/docs";
-var DEFAULT_PUBLIC_DIR = "public";
-async function fullSync(srcDir, publicDir, preserveDirs, ignorePatterns) {
-  await mkdir(publicDir, { recursive: true });
-  const items = await readdir(publicDir);
-  for (const item of items) {
-    const itemPath = resolve(publicDir, item);
-    let itemStat;
-    try {
-      itemStat = await stat(itemPath);
-    } catch (err) {
-      if (err?.code === "ENOENT") {
-        continue;
-      }
-      throw err;
-    }
-    if (preserveDirs.includes(item) || !itemStat.isDirectory()) {
-      continue;
-    }
-    await rm(itemPath, { recursive: true, force: true });
-  }
-  await copyWithRetry(srcDir, publicDir, ignorePatterns);
-  console.log(
-    `[starlight-sync-docs-to-public] Synced ${DEFAULT_SRC_DIR}/ \u2192 ${DEFAULT_PUBLIC_DIR}/ (full sync)`
-  );
-}
-async function incrementalSync(changedFilePath, srcDir, publicDir, ignorePatterns) {
-  const rel = relative(srcDir, changedFilePath);
-  if (ignorePatterns.some((pattern) => minimatch(rel, pattern, { dot: true }))) {
-    return;
-  }
-  if (changedFilePath.endsWith(".md") || changedFilePath.endsWith(".mdx")) {
-    try {
-      const frontmatter = parseFrontmatter(changedFilePath);
-      if (frontmatter.draft === true) return;
-    } catch {
-      return;
-    }
-  }
-  const destPath = resolve(publicDir, rel);
-  let srcStat;
-  try {
-    srcStat = await stat(changedFilePath);
-  } catch (err) {
-    if (err?.code === "ENOENT") {
-      await rm(destPath, { recursive: true, force: true });
-      return;
-    }
-    throw err;
-  }
-  if (srcStat.isDirectory()) {
-    await mkdir(destPath, { recursive: true });
-    const files = await readdir(changedFilePath);
-    for (const file of files) {
-      await incrementalSync(
-        resolve(changedFilePath, file),
-        srcDir,
-        publicDir,
-        ignorePatterns
-      );
-    }
-  } else {
-    await mkdir(resolve(destPath, ".."), { recursive: true });
-    const content = await readFile(changedFilePath);
-    await writeFile(destPath, content);
-  }
-  console.log(
-    `[starlight-sync-docs-to-public] Synced ${rel}`
-  );
-}
-async function copyWithRetry(srcDir, publicDir, ignorePatterns) {
-  let lastError;
-  for (let attempt = 0; attempt < 3; attempt++) {
-    try {
-      await cp(srcDir, publicDir, {
-        recursive: true,
-        force: true,
-        filter: (src) => {
-          const rel = relative(srcDir, src);
-          if (rel === "") return true;
-          if (ignorePatterns.some((pattern) => minimatch(rel, pattern, { dot: true }))) {
-            return false;
-          }
-          if (src.endsWith(".md") || src.endsWith(".mdx")) {
-            try {
-              const frontmatter = parseFrontmatter(src);
-              if (frontmatter.draft === true) return false;
-            } catch {
-              return false;
-            }
-          }
-          return true;
-        }
-      });
-      return;
-    } catch (err) {
-      lastError = err;
-      const code = err?.code;
-      const isRaceCondition = code === "EEXIST" || code === "ENOENT";
-      if (!isRaceCondition) {
-        throw err;
-      }
-      if (attempt < 2) {
-        await new Promise((resolve2) => setTimeout(resolve2, 10 * (attempt + 1)));
-      }
-    }
-  }
-  if (lastError) {
-    const code = lastError?.code;
-    if (code === "EEXIST" || code === "ENOENT") {
-      return;
-    }
-    throw lastError;
-  }
-}
-function starlightSyncDocsToPublic(options) {
-  const srcDir = resolve(DEFAULT_SRC_DIR);
-  const publicDir = resolve(DEFAULT_PUBLIC_DIR);
-  const { preserveDirs, ignorePatterns = [] } = options;
-  return {
-    name: "starlight-sync-docs-to-public",
-    hooks: {
-      "config:setup": (hook) => {
-        hook.addIntegration({
-          name: "astro-sync-docs-to-public",
-          hooks: {
-            "astro:build:start": async () => {
-              await fullSync(srcDir, publicDir, preserveDirs, ignorePatterns);
-            },
-            "astro:server:setup": ({ server }) => {
-              let isSyncing = false;
-              let needsResync = false;
-              let lastChangedFile;
-              const performSync = async () => {
-                if (isSyncing) {
-                  needsResync = true;
-                  return;
-                }
-                isSyncing = true;
-                try {
-                  if (lastChangedFile) {
-                    await incrementalSync(
-                      lastChangedFile,
-                      srcDir,
-                      publicDir,
-                      ignorePatterns
-                    );
-                  }
-                  if (needsResync) {
-                    needsResync = false;
-                    lastChangedFile = void 0;
-                    await performSync();
-                  }
-                } catch (err) {
-                  console.error(err);
-                } finally {
-                  isSyncing = false;
-                }
-              };
-              fullSync(srcDir, publicDir, preserveDirs, ignorePatterns).catch(
-                console.error
-              );
-              let debounceTimer = null;
-              server.watcher.add(srcDir);
-              server.watcher.on("all", (_event, filePath) => {
-                if (!filePath.startsWith(srcDir)) return;
-                lastChangedFile = filePath;
-                if (debounceTimer) clearTimeout(debounceTimer);
-                debounceTimer = setTimeout(() => {
-                  performSync();
-                }, 100);
-              });
-            }
-          }
-        });
-      }
-    }
-  };
-}
-
-export {
-  starlightSyncDocsToPublic
-};

package/dist/index-Ce1VCMrW.d.ts

@@ -1,45 +0,0 @@
-import { HookParameters } from '@astrojs/starlight/types';
-import { Root } from 'hast';
-import { VFile } from 'vfile';
-
-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): CompilationResult;
-
-/**
- * Starlight plugin wrapper for remark-latex-compile.
- *
- * This plugin hooks into Starlight's config:setup to inject the remark-latex-compile
- * plugin and the build-time Astro integration for scanning markdown files.
- */
-
-type StarlightLatexCompileOptions = RemarkLatexCompileOptions;
-declare function starlightLatexCompile(options: StarlightLatexCompileOptions): {
-    name: string;
-    hooks: {
-        "config:setup": (hook: HookParameters<"config:setup">) => void;
-    };
-};
-
-declare function rehypeLatexCompile(): (tree: Root, _file: VFile) => void;
-
-interface RemarkLatexCompileOptions {
-    /**
-     * Directory where SVG files should be written.
-     */
-    svgOutputDir: string;
-}
-declare function remarkLatexCompile(options: RemarkLatexCompileOptions): (tree: Record<string, unknown>, file: unknown) => void;
-
-export { type RemarkLatexCompileOptions as R, type StarlightLatexCompileOptions as S, remarkLatexCompile as a, compileLatexToSvg as c, rehypeLatexCompile as r, starlightLatexCompile as s };

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

@@ -1,4 +0,0 @@
-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';

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

@@ -1,4 +0,0 @@
-import '@astrojs/starlight/types';
-export { S as StarlightLatexCompileOptions, s as default, s as starlightLatexCompile } from '../index-Ce1VCMrW.js';
-import 'hast';
-import 'vfile';

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

@@ -1,10 +0,0 @@
-import {
-  starlightLatexCompile,
-  starlight_plugin_default
-} from "../chunk-DEXMXUQL.js";
-import "../chunk-KQM5EAEK.js";
-import "../chunk-QGM4M3NI.js";
-export {
-  starlight_plugin_default as default,
-  starlightLatexCompile
-};

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

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