starlight-cannoli-plugins 1.2.13 → 1.2.17

package/README.md

@@ -111,9 +111,20 @@ Use either ` ```tex compile ` or ` ```latex compile ` — both work identically:
 ```
 ````
 
-**Custom Preamble:**
+**Minimal approach:**
 
-Use `% ===` to separate custom preamble from diagram content:
+Use `% ===` to separate an optional custom preamble from your diagram content. The plugin wraps everything in the following document structure:
+
+```latex
+\documentclass[border=5pt]{standalone}
+{your preamble}
+\begin{document}
+\Large
+{your content}
+\end{document}
+```
+
+Example **minimal** tex code block:
 
 ````markdown
 ```tex compile
@@ -127,6 +138,8 @@ Use `% ===` to separate custom preamble from diagram content:
 ```
 ````
 
+If no `% ===` separator is present, the entire block is treated as content and wrapped in the same default document structure (with an empty preamble).
+
 **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:
@@ -149,7 +162,7 @@ If your code block contains both `\documentclass` and `\begin{document}`, the pl
 
 **Custom CSS Classes:**
 
-Add custom CSS classes to the generated `<img>` that defines the compiled LaTeX diagram using `class="..."`:
+Add custom CSS classes the `tex compile` code block to have them applied to the resulting `<img>` element:
 
 ````markdown
 ```tex compile class="bg-white rounded-1"
@@ -317,7 +330,7 @@ export default defineConfig({
 starlightSyncDocsToPublic({
   preserveDirs: ["static"],
   ignorePatterns: ["**/*.txt", "**/drafts/**"],
-})
+});
 ```
 
 ## CLI Utilities

package/dist/{chunk-N2EJVDP3.js → chunk-DEXMXUQL.js}

@@ -6,6 +6,54 @@ import {
 
 // src/plugins/remark-latex-compile/index.ts
 import { resolve } from "path";
+
+// src/plugins/remark-latex-compile/rehype-converter.ts
+import { visit } from "unist-util-visit";
+function rehypeLatexCompile() {
+  return (tree, _file) => {
+    visit(tree, "element", (node, index, parent) => {
+      if (node.tagName !== "pre") return;
+      const codeChild = node.children?.[0];
+      if (!codeChild || codeChild.tagName !== "code") return;
+      const classes = Array.isArray(codeChild.properties?.className) ? codeChild.properties.className : [];
+      if (!classes.includes("language-tex") && !classes.includes("language-latex")) {
+        return;
+      }
+      const codeContent = codeChild.children?.map((child) => typeof child === "string" ? child : child.value || "").join("").trim();
+      if (!codeContent) return;
+      const dataAttribute = codeChild.properties?.["data-meta"];
+      const isCompileBlock = dataAttribute && dataAttribute.includes("compile") || codeContent.includes("compile");
+      if (!isCompileBlock) return;
+      try {
+        const hash = hashLatexCode(codeContent);
+        const svgPath = `/static/tex-svgs/${hash}.svg`;
+        const imgElement = {
+          type: "element",
+          tagName: "img",
+          properties: {
+            src: svgPath,
+            alt: "LaTeX diagram",
+            className: ["tex-compiled"]
+          },
+          children: []
+        };
+        const paragraphElement = {
+          type: "element",
+          tagName: "p",
+          properties: {},
+          children: [imgElement]
+        };
+        if (parent && typeof index === "number") {
+          parent.children[index] = paragraphElement;
+        }
+      } catch (err) {
+        console.error(`[rehype-latex-compile] Error processing code block:`, err);
+      }
+    });
+  };
+}
+
+// src/plugins/remark-latex-compile/index.ts
 function extractClassesFromMeta(meta) {
   const classMatch = meta.match(/class="([^"]+)"/);
   if (classMatch && classMatch[1]) {
@@ -24,10 +72,11 @@ function traverseTree(node, svgOutputDir, filePath, depth = 0) {
         const lineNumber = position?.start?.line || "?";
         try {
           const result = compileLatexToSvg(String(child.value), svgOutputDir);
-          const status = result.wasCompiled ? "compiled" : "used cached";
-          console.log(
-            `[remark-latex-compile] ${filePath}:${lineNumber}: ${status} ${result.hash}.svg`
-          );
+          if (result.wasCompiled) {
+            console.log(
+              `[remark-latex-compile] ${filePath}:${lineNumber}: compiled ${result.hash}.svg`
+            );
+          }
           const customClasses = extractClassesFromMeta(
             String(child.meta || "")
           );
@@ -72,7 +121,7 @@ function remarkLatexCompile(options) {
 }
 
 // src/plugins/remark-latex-compile/astro-integration.ts
-import { readdir, readFile, writeFile } from "fs/promises";
+import { readdir, readFile, cp } from "fs/promises";
 import { resolve as resolve2, join, extname } from "path";
 function createAstroLatexIntegration(options) {
   const svgOutputDir = resolve2(options.svgOutputDir);
@@ -87,16 +136,13 @@ function createAstroLatexIntegration(options) {
         await scanAndCompileLatex(contentDir, svgOutputDir);
       },
       "astro:build:done": async ({ dir }) => {
-        console.log(
-          "[astro-latex-compile] Build done, updating HTML references"
-        );
+        const srcSvgDir = resolve2(svgOutputDir);
+        const outSvgDir = resolve2(dir.pathname, "static/tex-svgs");
         try {
-          await updateHtmlReferences(dir.pathname, contentDir, svgOutputDir);
+          await cp(srcSvgDir, outSvgDir, { recursive: true, force: true });
+          console.log("[astro-latex-compile] Copied SVGs to build output");
         } catch (err) {
-          console.error(
-            "[astro-latex-compile] Error updating HTML references:",
-            err
-          );
+          console.error("[astro-latex-compile] Error copying SVGs:", err);
         }
       }
     }
@@ -111,6 +157,7 @@ async function scanAndCompileLatex(dir, svgOutputDir) {
     } else if (entry.isFile()) {
       const ext = extname(entry.name);
       if (ext === ".md" || ext === ".mdx") {
+        console.log(`[astro-latex-compile] Found markdown file: ${fullPath}`);
         await processMarkdownFile(fullPath, svgOutputDir);
       }
     }
@@ -143,65 +190,6 @@ ${error.message}`;
     }
   }
 }
-async function updateHtmlReferences(buildDir, contentDir, svgOutputDir) {
-  const latexHashes = [];
-  const entries = await readdir(contentDir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(contentDir, entry.name);
-    if (entry.isDirectory()) {
-      await scanMarkdownForHashes(fullPath, latexHashes);
-    }
-  }
-  await updateHtmlDirWithHashes(buildDir, latexHashes, svgOutputDir);
-}
-async function scanMarkdownForHashes(dir, hashes) {
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      await scanMarkdownForHashes(fullPath, hashes);
-    } else if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".mdx"))) {
-      const content = await readFile(fullPath, "utf-8");
-      const latexBlockRegex = new RegExp(
-        LATEX_BLOCK_REGEX.source,
-        LATEX_BLOCK_REGEX.flags
-      );
-      const matches = content.matchAll(latexBlockRegex);
-      for (const match of matches) {
-        const latexCode = match[1];
-        const hash = hashLatexCode(latexCode);
-        hashes.push(hash);
-      }
-    }
-  }
-}
-async function updateHtmlDirWithHashes(dir, hashes, svgOutputDir) {
-  let hashIndex = 0;
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      await updateHtmlDirWithHashes(fullPath, hashes, svgOutputDir);
-    } else if (entry.isFile() && entry.name.endsWith(".html")) {
-      let content = await readFile(fullPath, "utf-8");
-      let modified = false;
-      const pathSegments = svgOutputDir.split("/").slice(-2).join("/");
-      const htmlPath = `/${pathSegments}`;
-      const svgRegex = new RegExp(`src="${htmlPath}/[a-f0-9]+\\.svg"`, "g");
-      content = content.replace(svgRegex, (match) => {
-        if (hashIndex < hashes.length) {
-          modified = true;
-          return `src="${htmlPath}/${hashes[hashIndex++]}.svg"`;
-        }
-        return match;
-      });
-      if (modified) {
-        await writeFile(fullPath, content, "utf-8");
-        console.log(`[astro-latex-compile] Updated ${fullPath}`);
-      }
-    }
-  }
-}
 
 // src/plugins/remark-latex-compile/starlight-plugin.ts
 function starlightLatexCompile(options) {
@@ -236,5 +224,6 @@ var starlight_plugin_default = starlightLatexCompile;
 export {
   starlightLatexCompile,
   starlight_plugin_default,
+  rehypeLatexCompile,
   remarkLatexCompile
 };

package/dist/chunk-SBGY6FD3.js

@@ -0,0 +1,191 @@
+import {
+  parseFrontmatter
+} from "./chunk-3ATSZG6H.js";
+
+// src/plugins/starlight-sync-docs-to-public.ts
+import { cp, mkdir, readdir, readFile, writeFile, rm, stat } from "fs/promises";
+import { resolve, relative } from "path";
+import { minimatch } from "minimatch";
+var DEFAULT_SRC_DIR = "src/content/docs";
+var DEFAULT_PUBLIC_DIR = "public";
+async function fullSync(srcDir, publicDir, preserveDirs, ignorePatterns) {
+  await mkdir(publicDir, { recursive: true });
+  const items = await readdir(publicDir);
+  for (const item of items) {
+    const itemPath = resolve(publicDir, item);
+    let itemStat;
+    try {
+      itemStat = await stat(itemPath);
+    } catch (err) {
+      if (err?.code === "ENOENT") {
+        continue;
+      }
+      throw err;
+    }
+    if (preserveDirs.includes(item) || !itemStat.isDirectory()) {
+      continue;
+    }
+    await rm(itemPath, { recursive: true, force: true });
+  }
+  await copyWithRetry(srcDir, publicDir, ignorePatterns);
+  console.log(
+    `[starlight-sync-docs-to-public] Synced ${DEFAULT_SRC_DIR}/ \u2192 ${DEFAULT_PUBLIC_DIR}/ (full sync)`
+  );
+}
+async function incrementalSync(changedFilePath, srcDir, publicDir, ignorePatterns) {
+  const rel = relative(srcDir, changedFilePath);
+  if (ignorePatterns.some((pattern) => minimatch(rel, pattern, { dot: true }))) {
+    return;
+  }
+  if (changedFilePath.endsWith(".md") || changedFilePath.endsWith(".mdx")) {
+    try {
+      const frontmatter = parseFrontmatter(changedFilePath);
+      if (frontmatter.draft === true) return;
+    } catch {
+      return;
+    }
+  }
+  const destPath = resolve(publicDir, rel);
+  let srcStat;
+  try {
+    srcStat = await stat(changedFilePath);
+  } catch (err) {
+    if (err?.code === "ENOENT") {
+      await rm(destPath, { recursive: true, force: true });
+      return;
+    }
+    throw err;
+  }
+  if (srcStat.isDirectory()) {
+    await mkdir(destPath, { recursive: true });
+    const files = await readdir(changedFilePath);
+    for (const file of files) {
+      await incrementalSync(
+        resolve(changedFilePath, file),
+        srcDir,
+        publicDir,
+        ignorePatterns
+      );
+    }
+  } else {
+    await mkdir(resolve(destPath, ".."), { recursive: true });
+    const content = await readFile(changedFilePath);
+    await writeFile(destPath, content);
+  }
+  console.log(
+    `[starlight-sync-docs-to-public] Synced ${rel}`
+  );
+}
+async function copyWithRetry(srcDir, publicDir, ignorePatterns) {
+  let lastError;
+  for (let attempt = 0; attempt < 3; attempt++) {
+    try {
+      await cp(srcDir, publicDir, {
+        recursive: true,
+        force: true,
+        filter: (src) => {
+          const rel = relative(srcDir, src);
+          if (rel === "") return true;
+          if (ignorePatterns.some((pattern) => minimatch(rel, pattern, { dot: true }))) {
+            return false;
+          }
+          if (src.endsWith(".md") || src.endsWith(".mdx")) {
+            try {
+              const frontmatter = parseFrontmatter(src);
+              if (frontmatter.draft === true) return false;
+            } catch {
+              return false;
+            }
+          }
+          return true;
+        }
+      });
+      return;
+    } catch (err) {
+      lastError = err;
+      const code = err?.code;
+      const isRaceCondition = code === "EEXIST" || code === "ENOENT";
+      if (!isRaceCondition) {
+        throw err;
+      }
+      if (attempt < 2) {
+        await new Promise((resolve2) => setTimeout(resolve2, 10 * (attempt + 1)));
+      }
+    }
+  }
+  if (lastError) {
+    const code = lastError?.code;
+    if (code === "EEXIST" || code === "ENOENT") {
+      return;
+    }
+    throw lastError;
+  }
+}
+function starlightSyncDocsToPublic(options) {
+  const srcDir = resolve(DEFAULT_SRC_DIR);
+  const publicDir = resolve(DEFAULT_PUBLIC_DIR);
+  const { preserveDirs, ignorePatterns = [] } = options;
+  return {
+    name: "starlight-sync-docs-to-public",
+    hooks: {
+      "config:setup": (hook) => {
+        hook.addIntegration({
+          name: "astro-sync-docs-to-public",
+          hooks: {
+            "astro:build:start": async () => {
+              await fullSync(srcDir, publicDir, preserveDirs, ignorePatterns);
+            },
+            "astro:server:setup": ({ server }) => {
+              let isSyncing = false;
+              let needsResync = false;
+              let lastChangedFile;
+              const performSync = async () => {
+                if (isSyncing) {
+                  needsResync = true;
+                  return;
+                }
+                isSyncing = true;
+                try {
+                  if (lastChangedFile) {
+                    await incrementalSync(
+                      lastChangedFile,
+                      srcDir,
+                      publicDir,
+                      ignorePatterns
+                    );
+                  }
+                  if (needsResync) {
+                    needsResync = false;
+                    lastChangedFile = void 0;
+                    await performSync();
+                  }
+                } catch (err) {
+                  console.error(err);
+                } finally {
+                  isSyncing = false;
+                }
+              };
+              fullSync(srcDir, publicDir, preserveDirs, ignorePatterns).catch(
+                console.error
+              );
+              let debounceTimer = null;
+              server.watcher.add(srcDir);
+              server.watcher.on("all", (_event, filePath) => {
+                if (!filePath.startsWith(srcDir)) return;
+                lastChangedFile = filePath;
+                if (debounceTimer) clearTimeout(debounceTimer);
+                debounceTimer = setTimeout(() => {
+                  performSync();
+                }, 100);
+              });
+            }
+          }
+        });
+      }
+    }
+  };
+}
+
+export {
+  starlightSyncDocsToPublic
+};

package/dist/{index-B9CyKYB4.d.ts → index-Ce1VCMrW.d.ts}

@@ -1,4 +1,6 @@
 import { HookParameters } from '@astrojs/starlight/types';
+import { Root } from 'hast';
+import { VFile } from 'vfile';
 
 interface CompilationResult {
     hash: string;
@@ -30,6 +32,8 @@ declare function starlightLatexCompile(options: StarlightLatexCompileOptions): {
     };
 };
 
+declare function rehypeLatexCompile(): (tree: Root, _file: VFile) => void;
+
 interface RemarkLatexCompileOptions {
     /**
      * Directory where SVG files should be written.
@@ -38,4 +42,4 @@ interface RemarkLatexCompileOptions {
 }
 declare function remarkLatexCompile(options: RemarkLatexCompileOptions): (tree: Record<string, unknown>, file: unknown) => void;
 
-export { type RemarkLatexCompileOptions as R, type StarlightLatexCompileOptions as S, compileLatexToSvg as c, remarkLatexCompile as r, starlightLatexCompile as s };
+export { type RemarkLatexCompileOptions as R, type StarlightLatexCompileOptions as S, remarkLatexCompile as a, compileLatexToSvg as c, rehypeLatexCompile as r, starlightLatexCompile as s };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { starlightIndexOnlySidebar } from './plugins/starlight-index-only-sideba
 export { starlightSyncDocsToPublic } from './plugins/starlight-sync-docs-to-public.js';
 export { default as rehypeValidateLinks } from './plugins/rehype-validate-links.js';
 import { AstroIntegration } from 'astro';
-export { r as remarkLatexCompile, s as starlightLatexCompile } from './index-B9CyKYB4.js';
+export { r as rehypeLatexCompile, a as remarkLatexCompile, s as starlightLatexCompile } from './index-Ce1VCMrW.js';
 import '@astrojs/starlight/types';
 import 'hast';
 import 'vfile';

package/dist/index.js

@@ -5,12 +5,13 @@ import {
   rehypeValidateLinks
 } from "./chunk-HRUZQZ5L.js";
 import {
+  rehypeLatexCompile,
   remarkLatexCompile,
   starlightLatexCompile
-} from "./chunk-N2EJVDP3.js";
+} from "./chunk-DEXMXUQL.js";
 import {
   starlightSyncDocsToPublic
-} from "./chunk-GE24XGG7.js";
+} from "./chunk-SBGY6FD3.js";
 import "./chunk-3ATSZG6H.js";
 import "./chunk-KQM5EAEK.js";
 import "./chunk-QGM4M3NI.js";
@@ -83,6 +84,7 @@ function normalizeAssetPath(path, htmlFile, siteRootPath) {
 }
 export {
   astroNormalizePaths,
+  rehypeLatexCompile,
   rehypeValidateLinks,
   remarkLatexCompile,
   starlightIndexOnlySidebar,

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

@@ -1,2 +1,4 @@
-export { R as RemarkLatexCompileOptions, c as compileLatexToSvg, r as default, s as starlightLatexCompile } from '../index-B9CyKYB4.js';
+export { R as RemarkLatexCompileOptions, c as compileLatexToSvg, a as default, r as rehypeLatexCompile, s as starlightLatexCompile } from '../index-Ce1VCMrW.js';
 import '@astrojs/starlight/types';
+import 'hast';
+import 'vfile';

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

@@ -1,7 +1,8 @@
 import {
+  rehypeLatexCompile,
   remarkLatexCompile,
   starlightLatexCompile
-} from "../chunk-N2EJVDP3.js";
+} from "../chunk-DEXMXUQL.js";
 import {
   compileLatexToSvg
 } from "../chunk-KQM5EAEK.js";
@@ -9,5 +10,6 @@ import "../chunk-QGM4M3NI.js";
 export {
   compileLatexToSvg,
   remarkLatexCompile as default,
+  rehypeLatexCompile,
   starlightLatexCompile
 };

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

@@ -1,2 +1,4 @@
 import '@astrojs/starlight/types';
-export { S as StarlightLatexCompileOptions, s as default, s as starlightLatexCompile } from '../index-B9CyKYB4.js';
+export { S as StarlightLatexCompileOptions, s as default, s as starlightLatexCompile } from '../index-Ce1VCMrW.js';
+import 'hast';
+import 'vfile';

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

@@ -1,7 +1,7 @@
 import {
   starlightLatexCompile,
   starlight_plugin_default
-} from "../chunk-N2EJVDP3.js";
+} from "../chunk-DEXMXUQL.js";
 import "../chunk-KQM5EAEK.js";
 import "../chunk-QGM4M3NI.js";
 export {

package/dist/plugins/starlight-sync-docs-to-public.d.ts

@@ -4,7 +4,7 @@ import { HookParameters } from '@astrojs/starlight/types';
  * Astro/Starlight plugin that syncs a source docs directory to the public directory.
  *
  * Runs once at build start, and in dev mode watches the source directory for
- * changes and re-syncs automatically — no need to restart the dev server.
+ * changes and incrementally syncs files — no full directory deletion/recreation.
  */
 
 interface SyncDocsToPublicOptions {

package/dist/plugins/starlight-sync-docs-to-public.js

@@ -1,6 +1,6 @@
 import {
   starlightSyncDocsToPublic
-} from "../chunk-GE24XGG7.js";
+} from "../chunk-SBGY6FD3.js";
 import "../chunk-3ATSZG6H.js";
 import "../chunk-QGM4M3NI.js";
 export {

package/dist/styles/_bootstrap-utilities.scss

@@ -4769,5 +4769,3 @@
     display: none !important;
   }
 }
-
-/*# sourceMappingURL=_bootstrap-utilities.scss.map */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "1.2.13",
+  "version": "1.2.17",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",
@@ -60,7 +60,7 @@
     "app:dev": "npm run app:preprocess && rm -rf .astro/ && astro dev --port 5600",
     "app:build": "npm run app:preprocess && rm -rf .astro/ && astro build",
     "app:preview": "astro build && astro preview --port 5600",
-    "app:preprocess": "npx sass --quiet src/styles/_bootstrap-utilities-builder.scss src/styles/_bootstrap-utilities.scss",
+    "app:preprocess": "npx sass --quiet --no-source-map src/styles/_bootstrap-utilities-builder.scss src/styles/_bootstrap-utilities.scss",
     "app:help": "astro --help",
     "app:check": "astro check",
     "lib:build": "npm run app:preprocess && tsup && cp -r src/styles dist/",
@@ -71,8 +71,8 @@
   },
   "dependencies": {
     "eslint-cannoli-plugins": "^1.0.13",
-    "glob": "^13.0.6",
-    "minimatch": "^10.2.4",
+    "glob": "^11.0.0",
+    "minimatch": "^9.0.0",
     "unist-util-visit": "^5.0.0",
     "yaml": "^2.4.0"
   },

package/dist/chunk-GE24XGG7.js

@@ -1,88 +0,0 @@
-import {
-  parseFrontmatter
-} from "./chunk-3ATSZG6H.js";
-
-// src/plugins/starlight-sync-docs-to-public.ts
-import { cp, mkdir, readdir, rm, stat } from "fs/promises";
-import { resolve, relative } from "path";
-import { minimatch } from "minimatch";
-var DEFAULT_SRC_DIR = "src/content/docs";
-var DEFAULT_PUBLIC_DIR = "public";
-async function syncDirs(srcDir, publicDir, preserveDirs, ignorePatterns, changedFile) {
-  await mkdir(publicDir, { recursive: true });
-  const items = await readdir(publicDir);
-  for (const item of items) {
-    const itemPath = resolve(publicDir, item);
-    const itemStat = await stat(itemPath);
-    if (preserveDirs.includes(item) || !itemStat.isDirectory()) {
-      continue;
-    }
-    await rm(itemPath, { recursive: true, force: true });
-  }
-  await cp(srcDir, publicDir, {
-    recursive: true,
-    force: true,
-    filter: (src) => {
-      const rel = relative(srcDir, src);
-      if (rel === "") return true;
-      if (ignorePatterns.some((pattern) => minimatch(rel, pattern, { dot: true }))) {
-        return false;
-      }
-      if (src.endsWith(".md") || src.endsWith(".mdx")) {
-        const frontmatter = parseFrontmatter(src);
-        if (frontmatter.draft === true) return false;
-      }
-      return true;
-    }
-  });
-  const fileInfo = changedFile ? ` (changed: ${changedFile.replace(srcDir + "/", "")})` : "";
-  console.log(
-    `[starlight-sync-docs-to-public] Synced ${DEFAULT_SRC_DIR}/ \u2192 ${DEFAULT_PUBLIC_DIR}/ ${fileInfo}`
-  );
-}
-function starlightSyncDocsToPublic(options) {
-  const srcDir = resolve(DEFAULT_SRC_DIR);
-  const publicDir = resolve(DEFAULT_PUBLIC_DIR);
-  const { preserveDirs, ignorePatterns = [] } = options;
-  return {
-    name: "starlight-sync-docs-to-public",
-    hooks: {
-      "config:setup": (hook) => {
-        hook.addIntegration({
-          name: "astro-sync-docs-to-public",
-          hooks: {
-            "astro:build:start": async () => {
-              await syncDirs(srcDir, publicDir, preserveDirs, ignorePatterns);
-            },
-            "astro:server:setup": ({ server }) => {
-              syncDirs(srcDir, publicDir, preserveDirs, ignorePatterns).catch(
-                console.error
-              );
-              let debounceTimer = null;
-              let lastChangedFile;
-              server.watcher.add(srcDir);
-              server.watcher.on("all", (_event, filePath) => {
-                if (!filePath.startsWith(srcDir)) return;
-                lastChangedFile = filePath;
-                if (debounceTimer) clearTimeout(debounceTimer);
-                debounceTimer = setTimeout(() => {
-                  syncDirs(
-                    srcDir,
-                    publicDir,
-                    preserveDirs,
-                    ignorePatterns,
-                    lastChangedFile
-                  ).catch(console.error);
-                }, 100);
-              });
-            }
-          }
-        });
-      }
-    }
-  };
-}
-
-export {
-  starlightSyncDocsToPublic
-};