starlight-cannoli-plugins 2.13.1 → 2.14.0

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

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.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";

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/package.json

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