starlight-cannoli-plugins 2.1.10 → 2.3.0

package/dist/index.d.ts

@@ -1,15 +1,27 @@
 export { starlightIndexOnlySidebar } from './plugins/starlight-index-only-sidebar.js';
+import { AstroIntegration } from 'astro';
 export { SyncDocsToPublicOptions, syncDocsToPublic } from './plugins/astro-sync-docs-to-public.js';
 export { default as rehypeValidateLinks } from './plugins/rehype-validate-links.js';
 export { astroNormalizePaths } from './plugins/astro-normalize-paths.js';
 import { RemarkLatexCompileOptions } from './plugins/astro-latex-compile.js';
 export { default as remarkLatexCompile } from './plugins/astro-latex-compile.js';
-import { AstroIntegration } from 'astro';
 import '@astrojs/starlight/types';
 import 'hast';
 import 'vfile';
 import 'mdast';
 
+interface DomPatchesOptions {
+    /** Hide line number gutters on single-line code blocks. @default false */
+    hideSingleLineGutters?: boolean;
+    /** Wrap `<details>` content (excluding `<summary>`) in a `.details-wrapper` div. @default false */
+    wrapDetailsContent?: boolean;
+}
+/**
+ * Astro integration that injects a client-side script to apply DOM patches
+ * on every page. Each patch can be individually enabled or disabled via options.
+ */
+declare function starlightDomPatches(options?: DomPatchesOptions): AstroIntegration;
+
 interface LatexCompileOptions extends RemarkLatexCompileOptions {
     /**
      * When `true`, SVG files in `svgOutputDir` that are no longer referenced by
@@ -22,4 +34,4 @@ interface LatexCompileOptions extends RemarkLatexCompileOptions {
 }
 declare function astroLatexCompile(options: LatexCompileOptions): AstroIntegration;
 
-export { type LatexCompileOptions, astroLatexCompile };
+export { type DomPatchesOptions, type LatexCompileOptions, astroLatexCompile, starlightDomPatches };

package/dist/index.js

@@ -16,6 +16,46 @@ import {
 import "./chunk-IY4A67ZP.js";
 import "./chunk-QGM4M3NI.js";
 
+// src/plugins/starlight-dom-patches/index.ts
+import { fileURLToPath } from "url";
+function starlightDomPatches(options = {}) {
+  const { hideSingleLineGutters = false, wrapDetailsContent = false } = options;
+  return {
+    name: "starlight-dom-patches",
+    hooks: {
+      "astro:config:setup": ({ injectScript }) => {
+        const currentFile = fileURLToPath(import.meta.url);
+        let pageScriptUrl;
+        if (currentFile.endsWith(".ts")) {
+          pageScriptUrl = new URL("./page-script.ts", import.meta.url);
+        } else if (currentFile.endsWith("starlight-dom-patches.js")) {
+          pageScriptUrl = new URL(
+            "./starlight-dom-patches/page-script.js",
+            import.meta.url
+          );
+        } else {
+          pageScriptUrl = new URL(
+            "./plugins/starlight-dom-patches/page-script.js",
+            import.meta.url
+          );
+        }
+        const scriptPath = JSON.stringify(fileURLToPath(pageScriptUrl));
+        const imports = [
+          hideSingleLineGutters ? "hideSingleLineGutters" : null,
+          wrapDetailsContent ? "wrapDetailsContent" : null
+        ].filter(Boolean);
+        if (imports.length === 0) return;
+        const calls = imports.map((fn) => `${fn}();`).join("\n");
+        injectScript(
+          "page",
+          `import { ${imports.join(", ")} } from ${scriptPath};
+${calls}`
+        );
+      }
+    }
+  };
+}
+
 // src/plugins/astro-latex-compile/astro-integration.ts
 import fs from "fs";
 import { readdir, rm } from "fs/promises";
@@ -82,6 +122,7 @@ export {
   astroNormalizePaths,
   rehypeValidateLinks,
   remarkLatexCompile,
+  starlightDomPatches,
   starlightIndexOnlySidebar,
   syncDocsToPublic
 };

package/package.json

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