starlight-cannoli-plugins 1.2.2 → 1.2.4

package/README.md

@@ -57,7 +57,7 @@ Automatically compiles fenced `tex compile` and `latex compile` code blocks to S
 - Compiles LaTeX/TikZ code blocks to SVG automatically
 - Caches compiled SVGs by content hash (no recompilation if unchanged)
 - Comprehensive error reporting with line numbers and formatted LaTeX source
-- Supports custom preamble via `%---` separator in code blocks
+- Supports custom preamble via `% ===` separator in code blocks
 - Works seamlessly with Starlight's content pipeline
 - Requires `svgOutputDir` configuration (no defaults)
 
@@ -99,6 +99,8 @@ export default defineConfig({
 
 **Markdown Syntax:**
 
+Use either ` ```tex compile ` or ` ```latex compile ` — both work identically:
+
 ````markdown
 ```tex compile
 \begin{tikzpicture}
@@ -111,13 +113,13 @@ export default defineConfig({
 
 **Custom Preamble:**
 
-Use `%---` to separate custom preamble from diagram content:
+Use `% ===` to separate custom preamble from diagram content:
 
 ````markdown
 ```tex compile
 \usepackage{tikz-3dplot}
 
-%---
+% ===
 
 \begin{tikzpicture}
   % diagram code here
@@ -125,6 +127,40 @@ Use `%---` to separate custom preamble from diagram content:
 ```
 ````
 
+**Complete Document Control:**
+
+If your code block contains both `\documentclass` and `\begin{document}`, the plugin treats it as a complete, self-contained LaTeX document and uses it as-is without checking for a `% ===` separator for a preamble:
+
+````markdown
+```tex compile
+\documentclass[border=10pt]{standalone}
+\usepackage{tikz}
+\usepackage{amsmath}
+
+\begin{document}
+
+\begin{equation*}
+  E = mc^2
+\end{equation*}
+
+\end{document}
+```
+````
+
+**Custom CSS Classes:**
+
+Add custom CSS classes to the generated `<img>` that defines the compiled LaTeX diagram using `class="..."`:
+
+````markdown
+```tex compile class="bg-white rounded-1"
+\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
 
 The underlying remark plugin that powers `starlightLatexCompile`. Use this directly in Astro projects that don't use Starlight.

package/dist/{chunk-CLBOVNPT.js → chunk-ETBFVRR2.js}

@@ -173,7 +173,7 @@ function buildLatexSource(latexCode) {
   if (latexCode.includes("\\documentclass") && latexCode.includes("\\begin{document}")) {
     return latexCode.trim();
   }
-  const separatorRegex = /%[ \t]*---/;
+  const separatorRegex = /%[ \t]*===/;
   const parts = latexCode.split(separatorRegex);
   let preamble = "";
   let content = latexCode.trim();
@@ -241,6 +241,13 @@ Error: ${errorOutput}`
 }
 
 // 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;
@@ -250,6 +257,10 @@ function traverseTree(node, svgOutputDir, filePath, depth = 0) {
       if (child.type === "code" && (child.lang === "tex" || child.lang === "latex") && String(child.meta || "").includes("compile")) {
         try {
           const result = compileLatexToSvg(String(child.value), svgOutputDir);
+          const customClasses = extractClassesFromMeta(
+            String(child.meta || "")
+          );
+          const allClasses = ["tex-compiled", ...customClasses];
           children[i] = {
             type: "paragraph",
             children: [
@@ -259,7 +270,7 @@ function traverseTree(node, svgOutputDir, filePath, depth = 0) {
                 alt: "LaTeX diagram",
                 data: {
                   hProperties: {
-                    className: ["tex-compiled"]
+                    className: allClasses
                   }
                 }
               }

package/dist/index.js

@@ -7,7 +7,7 @@ import {
 import {
   remarkLatexCompile,
   starlightLatexCompile
-} from "./chunk-CLBOVNPT.js";
+} from "./chunk-ETBFVRR2.js";
 
 // src/plugins/astro-normalize-paths.ts
 import { readFileSync, writeFileSync, existsSync } from "fs";

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

@@ -2,7 +2,7 @@ import {
   compileLatexToSvg,
   remarkLatexCompile,
   starlightLatexCompile
-} from "../chunk-CLBOVNPT.js";
+} from "../chunk-ETBFVRR2.js";
 export {
   compileLatexToSvg,
   remarkLatexCompile as default,

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

@@ -1,7 +1,7 @@
 import {
   starlightLatexCompile,
   starlight_plugin_default
-} from "../chunk-CLBOVNPT.js";
+} from "../chunk-ETBFVRR2.js";
 export {
   starlight_plugin_default as default,
   starlightLatexCompile

package/package.json

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