starlight-cannoli-plugins 1.2.1 → 1.2.3

package/README.md

@@ -99,6 +99,8 @@ export default defineConfig({
 
 **Markdown Syntax:**
 
+Use either ` ```tex compile ` or ` ```latex compile ` — both work identically:
+
 ````markdown
 ```tex compile
 \begin{tikzpicture}
@@ -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-T4UKGKU6.js → chunk-PRDYMCUY.js}

@@ -170,6 +170,9 @@ function hashLatexCode(code) {
   return createHash("md5").update(normalized).digest("hex").slice(0, 16);
 }
 function buildLatexSource(latexCode) {
+  if (latexCode.includes("\\documentclass") && latexCode.includes("\\begin{document}")) {
+    return latexCode.trim();
+  }
   const separatorRegex = /%[ \t]*---/;
   const parts = latexCode.split(separatorRegex);
   let preamble = "";
@@ -238,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;
@@ -247,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: [
@@ -256,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-T4UKGKU6.js";
+} from "./chunk-PRDYMCUY.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-T4UKGKU6.js";
+} from "../chunk-PRDYMCUY.js";
 export {
   compileLatexToSvg,
   remarkLatexCompile as default,

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

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

package/package.json

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