starlight-cannoli-plugins 2.5.5 → 2.6.0

package/README.md

@@ -79,6 +79,14 @@ 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.
+
+```ts
+astroLatexCompile({
+  svgOutputDir: "public/static/tex-svgs",
+  texInputDirs: ["src/latex//"], // search src/latex/ and all its subdirectories
+});
+```
 
 **Usage:**
 
@@ -162,20 +170,21 @@ If your code block contains both `\documentclass` and `\begin{document}`, the pl
 ```
 ````
 
-**Custom CSS Classes:**
+**Meta Attributes:**
+
+The following attributes can be added to the opening fence:
 
-Add custom CSS classes the `tex compile` code block to have them applied to the resulting `<img>` element:
+- `class="..."`: CSS classes applied to the resulting `<img>` element (space-separated). The `tex-compiled` class is always included.
+- `alt="..."`: Alt text for the resulting `<img>` element. Defaults to `"LaTeX diagram"` if omitted.
 
 ````markdown
-```tex compile class="bg-white rounded-1"
+```tex compile class="bg-white rounded-1" alt="A commutative diagram"
 \begin{tikzpicture}
   \node {Custom styled diagram};
 \end{tikzpicture}
 ```
 ````
 
-The img element will have classes: `tex-compiled bg-white rounded-1` (note: the `tex-compiled` class is always included by default).
-
 ### 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.

package/dist/{chunk-Z6DVEB7O.js → chunk-Q33KZ2RB.js}

@@ -2,6 +2,7 @@
 import { rm } from "fs/promises";
 import { join as join2, resolve } from "path";
 import { visit, SKIP } from "unist-util-visit";
+import { MetaOptions } from "@expressive-code/core";
 
 // src/plugins/astro-latex-compile/utils.ts
 import { createHash } from "crypto";
@@ -165,11 +166,11 @@ ${formattedSource}
 
 // src/plugins/utils/process-utils.ts
 import { spawn } from "child_process";
-function execProcess(command, args) {
+function execProcess(command, args, options) {
   return new Promise((resolve2, reject) => {
     let stdout = "";
     let stderr = "";
-    const proc = spawn(command, args);
+    const proc = spawn(command, args, { env: options?.env });
     proc.stdout.on("data", (data) => {
       stdout += data.toString();
     });
@@ -211,7 +212,7 @@ function buildLatexSource(latexCode) {
     "\\end{document}"
   ].join("\n");
 }
-async function compileLatexToSvg(latexCode, svgOutputDir) {
+async function compileLatexToSvg(latexCode, svgOutputDir, texInputDirs = []) {
   const hash = hashLatexCode(latexCode);
   const svgPath = join(svgOutputDir, `${hash}.svg`);
   if (existsSync(svgPath)) {
@@ -224,14 +225,17 @@ async function compileLatexToSvg(latexCode, svgOutputDir) {
   const latexSource = buildLatexSource(latexCode);
   try {
     writeFileSync(texFile, latexSource, "utf-8");
+    const pdflatexEnv = texInputDirs.length > 0 ? {
+      ...process.env,
+      TEXINPUTS: `${texInputDirs.join(":")}:${process.env.TEXINPUTS ?? ""}`
+    } : void 0;
     let result;
     try {
-      result = await execProcess("pdflatex", [
-        "-interaction=nonstopmode",
-        "-output-directory",
-        workDir,
-        texFile
-      ]);
+      result = await execProcess(
+        "pdflatex",
+        ["-interaction=nonstopmode", "-output-directory", workDir, texFile],
+        { env: pdflatexEnv }
+      );
     } catch (err) {
       const code = err.code;
       throw new Error(
@@ -280,13 +284,6 @@ Error: ${errorOutput}`
 }
 
 // src/plugins/astro-latex-compile/index.ts
-function extractClassesFromMeta(meta) {
-  const classMatch = meta.match(/class="([^"]+)"/);
-  if (classMatch?.[1]) {
-    return classMatch[1].split(/\s+/).filter(Boolean);
-  }
-  return [];
-}
 function remarkLatexCompile(options) {
   const svgOutputDir = resolve(options.svgOutputDir);
   return async function transformer(tree, file) {
@@ -303,7 +300,11 @@ function remarkLatexCompile(options) {
       nodes.map(async ({ node, index, parent }) => {
         const lineNumber = node.position?.start.line ?? "?";
         try {
-          const result = await compileLatexToSvg(node.value, svgOutputDir);
+          const result = await compileLatexToSvg(
+            node.value,
+            svgOutputDir,
+            options.texInputDirs ?? []
+          );
           if (result.wasCompiled) {
             console.log(
               `[remark-latex-compile] ${filePath}:${lineNumber}: compiled ${result.hash}.svg`
@@ -345,11 +346,13 @@ ${details}`
       const { index, parent, result } = results[i];
       const { node } = nodes[i];
       if (!result) continue;
-      const customClasses = extractClassesFromMeta(node.meta ?? "");
+      const metaOptions = new MetaOptions(node.meta ?? "");
+      const customClasses = metaOptions.getString("class")?.split(/\s+/).filter(Boolean) ?? [];
+      const altText = metaOptions.getString("alt") ?? "LaTeX diagram";
       const imageNode = {
         type: "image",
         url: `/static/tex-svgs/${result.hash}.svg`,
-        alt: "LaTeX diagram",
+        alt: altText,
         data: {
           hProperties: { className: ["tex-compiled", ...customClasses] }
         }

package/dist/{chunk-2Z7KWWVF.js → chunk-TRGFYY3Y.js}

@@ -12,17 +12,13 @@ var EmphasisAnnotation = class extends ExpressiveCodeAnnotation {
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function parseEmphTerms(meta) {
-  const match = meta.match(/\bemph="([^"]+)"/);
-  if (!match) return [];
-  return match[1].split(",").map((t) => t.trim()).filter(Boolean);
-}
 function expressiveCodeEmphasis() {
   return definePlugin({
     name: "expressiveCodeEmphasis",
     hooks: {
       preprocessCode: (context) => {
-        const terms = parseEmphTerms(context.codeBlock.meta);
+        const emphValue = context.codeBlock.metaOptions.getString("emph");
+        const terms = emphValue ? emphValue.split(",").map((t) => t.trim()).filter(Boolean) : [];
         if (terms.length === 0) return;
         for (const line of context.codeBlock.getLines()) {
           for (const term of terms) {

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   expressiveCodeEmphasis
-} from "./chunk-2Z7KWWVF.js";
+} from "./chunk-TRGFYY3Y.js";
 import {
   starlightIndexOnlySidebar
 } from "./chunk-N2I2GJW3.js";
@@ -9,7 +9,7 @@ import {
 } from "./chunk-3UMY7T6G.js";
 import {
   remarkLatexCompile
-} from "./chunk-Z6DVEB7O.js";
+} from "./chunk-Q33KZ2RB.js";
 import {
   astroNormalizePaths
 } from "./chunk-TLOFSB33.js";

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

@@ -14,7 +14,7 @@ interface CompilationResult {
  * @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 compileLatexToSvg(latexCode: string, svgOutputDir: string, texInputDirs?: string[]): Promise<CompilationResult>;
 
 interface RemarkLatexCompileOptions {
     /**
@@ -22,6 +22,13 @@ interface RemarkLatexCompileOptions {
      * Must be inside `public/` so Astro serves them as static assets.
      */
     svgOutputDir: string;
+    /**
+     * Directories added to the TeX input search path via TEXINPUTS, allowing
+     * \input{} and \include{} to resolve files from your project. Use a trailing
+     * slash for the directory itself, or double trailing slash for recursive
+     * search (e.g. "src/latex/" or "src/latex//").
+     */
+    texInputDirs?: string[];
     /**
      * @internal Populated by the Astro integration to track which hashes were
      * referenced during a build, used for full orphan cleanup at build:done.

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

@@ -1,7 +1,7 @@
 import {
   compileLatexToSvg,
   remarkLatexCompile
-} from "../chunk-Z6DVEB7O.js";
+} from "../chunk-Q33KZ2RB.js";
 import "../chunk-QGM4M3NI.js";
 export {
   compileLatexToSvg,

package/dist/plugins/expressive-code-emphasis.js

@@ -1,6 +1,6 @@
 import {
   expressiveCodeEmphasis
-} from "../chunk-2Z7KWWVF.js";
+} from "../chunk-TRGFYY3Y.js";
 import "../chunk-QGM4M3NI.js";
 export {
   expressiveCodeEmphasis

package/dist/styles/_starlight.scss

@@ -1,5 +1,7 @@
 /********** Starlight Overrides **********/
 
+$DARK_MODE_ROTATE: 178deg;
+
 .sl-container:where(.astro-7nkwcw3z) {
   max-width: 50rem;
 }
@@ -127,7 +129,7 @@ div > div[class="page"] > svg {
   html:not([data-theme="light"]) & {
     stroke: white;
     fill: white;
-    filter: invert(1) hue-rotate(168deg);
+    filter: invert(1) hue-rotate($DARK_MODE_ROTATE);
   }
 }
 
@@ -175,7 +177,7 @@ img.note-svg {
   }
 
   html:not([data-theme="light"]) & {
-    filter: invert(1) hue-rotate(168deg);
+    filter: invert(1) hue-rotate($DARK_MODE_ROTATE);
   }
 }
 
@@ -183,6 +185,6 @@ img.note-svg {
   background-color: transparent;
 
   html[data-theme="dark"] & {
-    filter: invert(1) hue-rotate(168deg);
+    filter: invert(1) hue-rotate($DARK_MODE_ROTATE);
   }
 }

package/package.json

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