starlight-cannoli-plugins 2.13.1 → 2.14.1

package/README.md

@@ -142,7 +142,8 @@ dvisvgm --version
 
 - `svgOutputDir` (required): Directory where compiled SVG files are written. Must be inside `public/` so Astro serves them as static assets.
 - `removeOrphanedSvgs` (optional, default: `false`): When `true`, SVG files 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.
-- `texInputDirs` (optional): Directories added to the TeX input search path (`TEXINPUTS`), allowing `\input{}` and `\include{}` to resolve files from your project. Use a trailing `/` to search only that directory, or `//` to search it recursively. Multiple directories are supported.
+- `svgClassname` (optional): Default CSS class(es) applied to every compiled SVG `<img>` element. Individual blocks can override this with a `class` meta tag value. The `tex-compiled` class is always present and cannot be overridden.
+- `texInputDirs` (optional): Directories added to the TeX input search path (`TEXINPUTS`), allowing `\input{}` and `\include{}` to resolve files from your project. Use a trailing `/` to search only that directory, or `//` to search it recursively. Multiple directories are supported. When any file in these directories changes, all cached SVGs are invalidated and recompiled.
 - `tempOutputDir` (optional): When set, a JPEG copy of each compiled diagram is written to this directory, mirroring the folder structure of `src/content/docs/`. Only blocks that carry a `blockid=<n>` meta tag produce a JPEG — blocks without it are ignored. The filename format is `<originating-file>--<blockid>--<hash>.jpg` (e.g. `tex-test.md--5--abc123.jpg`). JPEGs are deleted automatically when their block is removed, its `blockid` changes, or its content changes. SVG output is unaffected — the JPEG is complementary and intended for local inspection.
 
 ```ts
@@ -230,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-57RXO5LG.js → chunk-ETBDUEFH.js}

@@ -620,14 +620,15 @@ ${details}`
         continue;
       }
       const metaOptions = new MetaOptions(node.meta ?? "");
-      const customClasses = metaOptions.getString("class")?.split(/\s+/).filter(Boolean) ?? [];
+      const blockClass = metaOptions.getString("class");
+      const extraClasses = (blockClass !== void 0 ? blockClass : options.svgClassname ?? "").split(/\s+/).filter(Boolean);
       const altText = metaOptions.getString("alt") ?? "LaTeX diagram";
       const imageNode = {
         type: "image",
         url: `/static/tex-svgs/${result.hash}.svg`,
         alt: altText,
         data: {
-          hProperties: { className: ["tex-compiled", ...customClasses] }
+          hProperties: { className: ["tex-compiled", ...extraClasses] }
         }
       };
       const paragraph = {

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 { RemarkLatexCompileOptions } 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 = {

package/dist/index.js

@@ -9,7 +9,7 @@ import {
 } from "./chunk-3UMY7T6G.js";
 import {
   remarkLatexCompile
-} from "./chunk-57RXO5LG.js";
+} from "./chunk-ETBDUEFH.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,8 +269,17 @@ 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);
         }
@@ -299,7 +328,6 @@ export {
   astroNormalizePaths,
   expressiveCodeEmphasis,
   rehypeValidateLinks,
-  remarkLatexCompile,
   starlightDomPatches,
   starlightIndexOnlySidebar,
   starlightIndexSourcedSidebar,

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

@@ -22,6 +22,12 @@ interface RemarkLatexCompileOptions {
      * Must be inside `public/` so Astro serves them as static assets.
      */
     svgOutputDir: string;
+    /**
+     * Default CSS class(es) applied to every compiled SVG `<img>` element.
+     * Individual blocks can override this with a `class` meta tag value.
+     * The `tex-compiled` class is always present and cannot be overridden.
+     */
+    svgClassname?: string;
     /**
      * Directories added to the TeX input search path via TEXINPUTS, allowing
      * \input{} and \include{} to resolve files from your project. Use a trailing

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

@@ -1,7 +1,7 @@
 import {
   compileLatexToSvg,
   remarkLatexCompile
-} from "../chunk-57RXO5LG.js";
+} from "../chunk-ETBDUEFH.js";
 import "../chunk-C2VXRQOK.js";
 import "../chunk-4VNS5WPM.js";
 export {

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.13.1",
+  "version": "2.14.1",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",