starlight-cannoli-plugins 2.14.0 → 2.14.2

package/README.md

@@ -231,28 +231,6 @@ The following attributes can be added to the opening fence:
 ```
 ````
 
-### Remark LaTeX Compile (low-level)
-
-The underlying remark plugin used by `astroLatexCompile`. Use this directly if you need to wire the transformer into a custom pipeline — most users should use `astroLatexCompile` instead.
-
-**Usage:**
-
-```ts
-// astro.config.mjs
-import { defineConfig } from "astro/config";
-import { remarkLatexCompile } from "starlight-cannoli-plugins/astro-latex-compile";
-
-export default defineConfig({
-  markdown: {
-    remarkPlugins: [
-      [remarkLatexCompile, { svgOutputDir: "public/static/tex-svgs" }],
-    ],
-  },
-});
-```
-
-Note: when used directly (without `astroLatexCompile`), the Starlight content layer cache is not cleared automatically, so SVGs may not recompile on repeat builds in Starlight projects.
-
 ### Rehype Validate Links
 
 A rehype plugin that validates all internal links in your Markdown/MDX files at build time. Links without matching files will cause the build to fail.

package/dist/{chunk-ETBDUEFH.js → chunk-RAKGKJJO.js}

@@ -112,7 +112,7 @@ function formatLatexError(parsed) {
   const warningCount = parsed.errors.filter(
     (e) => e.severity === "warning"
   ).length;
-  let output = `${RED}[remark-latex-compile] LaTeX compilation failed${RESET}
+  let output = `${RED}[astro-latex-compile] LaTeX compilation failed${RESET}
 `;
   output += `${RED}${errorCount} error${errorCount !== 1 ? "s" : ""}${RESET}`;
   if (warningCount > 0) {
@@ -412,7 +412,7 @@ function buildLatexSource(latexCode) {
     return latexCode.trim();
   }
   throw new Error(
-    `[remark-latex-compile] Code block is not a complete LaTeX document. Blocks must contain both \\documentclass and \\begin{document}.`
+    `[astro-latex-compile] Code block is not a complete LaTeX document. Blocks must contain both \\documentclass and \\begin{document}.`
   );
 }
 async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = [], inputsSalt = "") {
@@ -442,7 +442,7 @@ async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = [], inp
     } catch (err) {
       const code = err.code;
       throw new Error(
-        `[remark-latex-compile] pdflatex not found on PATH (${code}).`,
+        `[astro-latex-compile] pdflatex not found on PATH (${code}).`,
         { cause: err }
       );
     }
@@ -466,14 +466,14 @@ async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = [], inp
     } catch (err) {
       const code = err.code;
       throw new Error(
-        `[remark-latex-compile] dvisvgm not found on PATH (${code}).`,
+        `[astro-latex-compile] dvisvgm not found on PATH (${code}).`,
         { cause: err }
       );
     }
     if (svgResult.status !== 0) {
       const errorOutput = svgResult.stderr || svgResult.stdout || "";
       throw new Error(
-        `[remark-latex-compile] PDF to SVG conversion failed (hash: ${hash}).
+        `[astro-latex-compile] PDF to SVG conversion failed (hash: ${hash}).
 Error: ${errorOutput}`
       );
     }
@@ -497,7 +497,7 @@ function getFrontmatterOffset(absoluteFilePath) {
     return 0;
   }
 }
-function remarkLatexCompile(options) {
+function latexCompileTransformer(options) {
   const svgOutputDir = resolve2(options.svgOutputDir);
   return async function transformer(tree, file) {
     const nodes = [];
@@ -526,14 +526,14 @@ function remarkLatexCompile(options) {
           );
           if (result.wasCompiled) {
             console.log(
-              `[remark-latex-compile] ${relFilePath}:${lineNumberStr}: compiled ${result.hash}.svg`
+              `[astro-latex-compile] ${relFilePath}:${lineNumberStr}: compiled ${result.hash}.svg`
             );
           }
           options._referencedHashes?.add(result.hash);
           if (jpgPath) {
             await writeJpgFromSvg(result.svgPath, jpgPath);
             console.log(
-              `[remark-latex-compile] ${relFilePath}:${lineNumberStr}: wrote ${jpgPath}`
+              `[astro-latex-compile] ${relFilePath}:${lineNumberStr}: wrote ${jpgPath}`
             );
           }
           return {
@@ -549,7 +549,7 @@ function remarkLatexCompile(options) {
           const match = errorMsg.match(/\n\n([\s\S]+)/);
           const details = match ? match[1] : errorMsg;
           console.error(
-            `[remark-latex-compile] ${relFilePath}:${lineNumberStr}
+            `[astro-latex-compile] ${relFilePath}:${lineNumberStr}
 ${details}`
           );
           if (jpgPath) {
@@ -578,7 +578,7 @@ ${details}`
       const staleHashes = [...oldHashes].filter((h) => !newHashes.has(h));
       for (const staleHash of staleHashes) {
         console.warn(
-          `[remark-latex-compile] Removing orphaned svg: ${staleHash}.svg`
+          `[astro-latex-compile] Removing orphaned svg: ${staleHash}.svg`
         );
       }
       await Promise.all(
@@ -596,7 +596,7 @@ ${details}`
       const staleJpgPaths = [...oldJpgPaths].filter((p) => !newJpgPaths.has(p));
       for (const stalePath of staleJpgPaths) {
         console.warn(
-          `[remark-latex-compile] Removing orphaned jpg: ${stalePath}`
+          `[astro-latex-compile] Removing orphaned jpg: ${stalePath}`
         );
       }
       await Promise.all(staleJpgPaths.map((p) => rm(p, { force: true })));
@@ -642,5 +642,5 @@ ${details}`
 
 export {
   compileLatexToSvg,
-  remarkLatexCompile
+  latexCompileTransformer
 };

package/dist/index.d.ts

@@ -4,14 +4,13 @@ export { DomPatchesOptions, starlightDomPatches } from './plugins/starlight-dom-
 export { SyncDocsToPublicOptions, syncDocsToPublic } from './plugins/astro-sync-docs-to-public.js';
 export { rehypeValidateLinks } from './plugins/rehype-validate-links.js';
 export { astroNormalizePaths } from './plugins/astro-normalize-paths.js';
-import { RemarkLatexCompileOptions } from './plugins/astro-latex-compile.js';
-export { remarkLatexCompile } from './plugins/astro-latex-compile.js';
 export { expressiveCodeEmphasis } from './plugins/expressive-code-emphasis.js';
 import { AstroIntegration } from 'astro';
+import { LatexCompilePluginOptions } from './plugins/astro-latex-compile.js';
 import 'hast';
 import 'vfile';
-import 'mdast';
 import 'expressive-code';
+import 'mdast';
 
 type TBadgeVariant = "note" | "danger" | "success" | "caution" | "tip" | "default";
 type TIndexMarker = {
@@ -67,7 +66,7 @@ declare function starlightIndexSourcedSidebar(options: TOptions): {
     };
 };
 
-interface LatexCompileOptions extends RemarkLatexCompileOptions {
+interface LatexCompileOptions extends LatexCompilePluginOptions {
     /**
      * When `true`, SVG files in `svgOutputDir` that are no longer referenced by
      * any `tex compile` block are deleted automatically. In dev mode, stale SVGs

package/dist/index.js

@@ -8,8 +8,8 @@ import {
   rehypeValidateLinks
 } from "./chunk-3UMY7T6G.js";
 import {
-  remarkLatexCompile
-} from "./chunk-ETBDUEFH.js";
+  latexCompileTransformer
+} from "./chunk-RAKGKJJO.js";
 import {
   astroNormalizePaths
 } from "./chunk-TLOFSB33.js";
@@ -232,6 +232,26 @@ function starlightIndexSourcedSidebar(options) {
 import fs2 from "fs";
 import { readdir, rm } from "fs/promises";
 import { join as join3, resolve as resolve2 } from "path";
+var js = String.raw;
+var DARK_MODE_ROTATE = "178deg";
+var INJECTED_CSS = `
+: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%);
+}
+.tex-compiled {
+  background-color: transparent;
+}
+html[data-theme="dark"] .tex-compiled {
+  filter: invert(1) hue-rotate(${DARK_MODE_ROTATE});
+}
+`;
 var DATA_STORE_FILE = "data-store.json";
 function getDataStoreFile(config) {
   return new URL(DATA_STORE_FILE, config.cacheDir);
@@ -249,13 +269,22 @@ function astroLatexCompile(options) {
   return {
     name: "astro-latex-compile",
     hooks: {
-      "astro:config:setup": async ({ command, config, updateConfig }) => {
+      "astro:config:setup": async ({
+        command,
+        config,
+        updateConfig,
+        injectScript
+      }) => {
         if (command !== "build" && command !== "dev") return;
+        injectScript(
+          "page",
+          js`{ const s = document.createElement("style"); s.textContent = ${JSON.stringify(INJECTED_CSS)}; document.head.appendChild(s); }`
+        );
         if (command === "build") {
           await clearContentLayerCache(config);
         }
         const existingPlugins = Array.isArray(config.markdown?.remarkPlugins) ? config.markdown.remarkPlugins.filter(Boolean) : [];
-        const remarkOptions = {
+        const pluginOptions = {
           ...options,
           _fileHashMap: options.removeOrphanedSvgs ? fileHashMap : void 0,
           _referencedHashes: command === "build" && options.removeOrphanedSvgs ? referencedHashes : void 0,
@@ -265,7 +294,7 @@ function astroLatexCompile(options) {
           markdown: {
             remarkPlugins: [
               ...existingPlugins,
-              [remarkLatexCompile, remarkOptions]
+              [latexCompileTransformer, pluginOptions]
             ]
           }
         });
@@ -299,7 +328,6 @@ export {
   astroNormalizePaths,
   expressiveCodeEmphasis,
   rehypeValidateLinks,
-  remarkLatexCompile,
   starlightDomPatches,
   starlightIndexOnlySidebar,
   starlightIndexSourcedSidebar,

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

@@ -16,7 +16,7 @@ interface CompilationResult {
  */
 declare function compileLatexToSvg(latexCode: string, svgOutputDir: string, texInputDirs?: string[], inputsSalt?: string): Promise<CompilationResult>;
 
-interface RemarkLatexCompileOptions {
+interface LatexCompilePluginOptions {
     /**
      * Directory where SVG files should be written.
      * Must be inside `public/` so Astro serves them as static assets.
@@ -51,15 +51,15 @@ interface RemarkLatexCompileOptions {
     _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.
+     * previous run. Used to delete stale SVGs when a block changes.
      */
     _fileHashMap?: Map<string, Set<string>>;
     /**
      * @internal Maps each file path to the set of JPG paths it produced on the
-     * previous remark run. Used to delete stale JPGs when a block changes.
+     * previous run. Used to delete stale JPGs when a block changes.
      */
     _fileJpgPathMap?: Map<string, Set<string>>;
 }
-declare function remarkLatexCompile(options: RemarkLatexCompileOptions): (tree: Root, file: VFile) => Promise<void>;
+declare function latexCompileTransformer(options: LatexCompilePluginOptions): (tree: Root, file: VFile) => Promise<void>;
 
-export { type RemarkLatexCompileOptions, compileLatexToSvg, remarkLatexCompile };
+export { type LatexCompilePluginOptions, compileLatexToSvg, latexCompileTransformer };

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

@@ -1,10 +1,10 @@
 import {
   compileLatexToSvg,
-  remarkLatexCompile
-} from "../chunk-ETBDUEFH.js";
+  latexCompileTransformer
+} from "../chunk-RAKGKJJO.js";
 import "../chunk-C2VXRQOK.js";
 import "../chunk-4VNS5WPM.js";
 export {
   compileLatexToSvg,
-  remarkLatexCompile
+  latexCompileTransformer
 };

package/dist/styles/_starlight.scss

@@ -2,21 +2,6 @@
 
 $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;
 }
@@ -267,11 +252,3 @@ img.note-svg {
     filter: invert(1) hue-rotate($DARK_MODE_ROTATE);
   }
 }
-
-.tex-compiled {
-  background-color: transparent;
-
-  html[data-theme="dark"] & {
-    filter: invert(1) hue-rotate($DARK_MODE_ROTATE);
-  }
-}

package/package.json

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