starlight-cannoli-plugins 2.17.1 → 2.17.2

package/README.md

@@ -364,11 +364,15 @@ export default defineConfig({
 
 - `preserveDirs` (required): Names of child directories inside `public/` to preserve during sync. These will not be deleted when re-syncing.
 - `ignorePatterns` (optional): Glob patterns for files to exclude from syncing. Patterns are matched against paths relative to `src/content/docs/`.
+- `exposePageSrcButton` (optional, default: `false`): Injects a client-side script on every page that adds a `⋮` dropdown next to the page's `<h1>` with "Copy Page", "Copy raw URL", and "View raw" actions for the page's raw markdown source.
+- `enableAskAiOption` (optional, default: `false`): Adds "Ask ChatGPT", "Ask Claude", and "Ask Gemini" entries to the same `⋮` dropdown, each opening the respective chat app in a new tab with a prompt pre-filled to read the page's raw markdown URL. Independent of `exposePageSrcButton` — enabling this on its own still injects the dropdown button, containing only the "Ask" entries.
 
 ```ts
 syncDocsToPublic({
   preserveDirs: ["static"],
   ignorePatterns: ["**/*.txt", "**/drafts/**"],
+  exposePageSrcButton: true,
+  enableAskAiOption: true,
 });
 ```
 

package/dist/{chunk-4ZJKEEDA.js → chunk-BM7LMGAH.js}

@@ -138,17 +138,18 @@ var DEFAULT_SRC_DIR = "src/content/docs";
 var DEFAULT_PUBLIC_DIR = "public";
 function validateOptions(options) {
   const mdProbePaths = ["test.md", "test.mdx", "foo/test.md", "foo/test.mdx"];
-  if (!options.exposePageSrcButton) return;
+  const needsRawMd = options.exposePageSrcButton || options.enableAskAiOption;
+  if (!needsRawMd) return;
   const offendingMdPatterns = (options.ignorePatterns ?? []).filter(
     (pattern) => mdProbePaths.some((probe) => minimatch(probe, pattern, { dot: true }))
   );
   const offendingMtPatternsStr = offendingMdPatterns.map((p) => `    - "${p}"`).join("\n");
   if (offendingMdPatterns.length > 0) {
     throw new Error(
-      `The 'exposePageSrcButton' option is enabled but the following 'ignorePatterns' values conflict with it: 
+      `The 'exposePageSrcButton'/'enableAskAiOption' option is enabled but the following 'ignorePatterns' values conflict with it: 
 ${offendingMtPatternsStr}
 
-Since these ignore patterns match md/mdx files, the page source button would break. Either disable 'exposePageSrcButton' or remove these patterns.`
+Since these ignore patterns match md/mdx files, the page action button would break. Either disable these options or remove these patterns.`
     );
   }
 }
@@ -256,7 +257,8 @@ function syncDocsToPublic(options) {
   const {
     preserveDirs: rawPreserveDirs,
     ignorePatterns = [],
-    exposePageSrcButton = false
+    exposePageSrcButton = false,
+    enableAskAiOption = false
   } = options;
   const preserveDirs = rawPreserveDirs.map((d) => d.replace(/\/+$/, ""));
   return {
@@ -264,7 +266,7 @@ function syncDocsToPublic(options) {
     hooks: {
       "astro:config:setup": ({ injectScript }) => {
         validateOptions(options);
-        if (exposePageSrcButton) {
+        if (exposePageSrcButton || enableAskAiOption) {
           injectScript(
             "page",
             `
@@ -288,8 +290,16 @@ function syncDocsToPublic(options) {
               import.meta.url
             );
           }
-          const scriptPath = fileURLToPath(pageScriptUrl);
-          injectScript("page", `import ${JSON.stringify(scriptPath)};`);
+          const scriptPath = JSON.stringify(fileURLToPath(pageScriptUrl));
+          const actionBarOptions = JSON.stringify({
+            exposePageSrcButton,
+            enableAskAiOption
+          });
+          injectScript(
+            "page",
+            `import { initPageActionBar } from ${scriptPath};
+initPageActionBar(${actionBarOptions});`
+          );
         }
       },
       "astro:build:start": async () => {

package/dist/index.js

@@ -16,7 +16,7 @@ import {
 import "./chunk-LJWSZSPB.js";
 import {
   syncDocsToPublic
-} from "./chunk-4ZJKEEDA.js";
+} from "./chunk-BM7LMGAH.js";
 import {
   parseFrontmatter
 } from "./chunk-EEPQVOZC.js";

package/dist/plugins/astro-sync-docs-to-public/page-script.d.ts

@@ -1,2 +1,7 @@
+interface ActionBarOptions {
+    exposePageSrcButton: boolean;
+    enableAskAiOption: boolean;
+}
+declare function initPageActionBar(options: ActionBarOptions): void;
 
-export {  }
+export { initPageActionBar };

package/dist/plugins/astro-sync-docs-to-public/page-script.js

@@ -1,3 +1,5 @@
+import "../../chunk-4VNS5WPM.js";
+
 // src/plugins/astro-sync-docs-to-public/page-script.ts
 function showBanner(message, variant) {
   const banner = document.createElement("div");
@@ -28,7 +30,21 @@ async function getRawMdUrl() {
   }
   return new URL("index.md", base).toString();
 }
-function createActionBar() {
+var LLM_ASK_TARGETS = [
+  {
+    label: "Ask ChatGPT",
+    buildUrl: (prompt) => `https://chatgpt.com/?${new URLSearchParams({ q: prompt })}`
+  },
+  {
+    label: "Ask Claude",
+    buildUrl: (prompt) => `https://claude.ai/new?${new URLSearchParams({ q: prompt })}`
+  },
+  {
+    label: "Ask Gemini",
+    buildUrl: (prompt) => `https://gemini.google.com/app?${new URLSearchParams({ q: prompt })}`
+  }
+];
+function createActionBar(options) {
   const bar = document.createElement("div");
   bar.className = "page-src-action-bar";
   const menuBtn = document.createElement("button");
@@ -39,29 +55,48 @@ function createActionBar() {
   }
   const menu = document.createElement("div");
   menu.className = "page-src-action-bar__menu";
-  const menuItems = [
-    {
-      label: "Copy Page",
-      action: () => {
-        setLoading(true);
-        getRawMdUrl().then((url) => fetch(url)).then((resp) => resp.text()).then((text) => navigator.clipboard.writeText(text)).then(() => showBanner("Page source copied to clipboard!", "success")).catch(() => showBanner("Failed to copy page source.", "error")).finally(() => setLoading(false));
-      }
-    },
-    {
-      label: "Copy raw URL",
-      action: () => {
-        setLoading(true);
-        getRawMdUrl().then((url) => navigator.clipboard.writeText(url)).then(() => showBanner("Raw URL copied to clipboard!", "success")).catch(() => showBanner("Failed to copy raw URL.", "error")).finally(() => setLoading(false));
-      }
-    },
-    {
-      label: "View raw",
-      action: () => {
-        setLoading(true);
-        getRawMdUrl().then((url) => window.open(url, "_blank")).catch(() => showBanner("Failed to open raw source.", "error")).finally(() => setLoading(false));
+  const menuItems = [];
+  if (options.exposePageSrcButton) {
+    menuItems.push(
+      {
+        label: "Copy Page",
+        action: () => {
+          setLoading(true);
+          getRawMdUrl().then((url) => fetch(url)).then((resp) => resp.text()).then((text) => navigator.clipboard.writeText(text)).then(
+            () => showBanner("Page source copied to clipboard!", "success")
+          ).catch(() => showBanner("Failed to copy page source.", "error")).finally(() => setLoading(false));
+        }
+      },
+      {
+        label: "Copy raw URL",
+        action: () => {
+          setLoading(true);
+          getRawMdUrl().then((url) => navigator.clipboard.writeText(url)).then(() => showBanner("Raw URL copied to clipboard!", "success")).catch(() => showBanner("Failed to copy raw URL.", "error")).finally(() => setLoading(false));
+        }
+      },
+      {
+        label: "View raw",
+        action: () => {
+          setLoading(true);
+          getRawMdUrl().then((url) => window.open(url, "_blank")).catch(() => showBanner("Failed to open raw source.", "error")).finally(() => setLoading(false));
+        }
       }
+    );
+  }
+  if (options.enableAskAiOption) {
+    for (const { label, buildUrl } of LLM_ASK_TARGETS) {
+      menuItems.push({
+        label,
+        action: () => {
+          setLoading(true);
+          getRawMdUrl().then((url) => {
+            const prompt = `Read from ${url} so I can ask questions about it.`;
+            window.open(buildUrl(prompt), "_blank");
+          }).catch(() => showBanner(`Failed to open ${label}.`, "error")).finally(() => setLoading(false));
+        }
+      });
     }
-  ];
+  }
   for (const item of menuItems) {
     const btn = document.createElement("button");
     btn.className = "page-src-action-bar__menu-item";
@@ -93,13 +128,15 @@ function createActionBar() {
   bar.appendChild(menu);
   return bar;
 }
-function main() {
+function initPageActionBar(options) {
   const h1 = document.querySelector(".sl-container > h1");
   if (h1 === null) return;
   const wrapper = document.createElement("div");
   wrapper.className = "page-src-h1-wrapper";
   h1.replaceWith(wrapper);
   wrapper.appendChild(h1);
-  wrapper.appendChild(createActionBar());
+  wrapper.appendChild(createActionBar(options));
 }
-main();
+export {
+  initPageActionBar
+};

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

@@ -17,6 +17,15 @@ interface SyncDocsToPublicOptions {
      * dev and build modes.
      */
     exposePageSrcButton?: boolean;
+    /**
+     * When true, adds "Ask ChatGPT", "Ask Claude", and "Ask Gemini" entries to
+     * the page action dropdown menu, each opening the respective chat app with
+     * a prompt pre-filled to read the current page's raw markdown URL.
+     *
+     * Independent of `exposePageSrcButton` — enabling this on its own still
+     * injects the dropdown button, containing only the "Ask" entries.
+     */
+    enableAskAiOption?: boolean;
 }
 declare function syncDocsToPublic(options: SyncDocsToPublicOptions): AstroIntegration;
 

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

@@ -1,6 +1,6 @@
 import {
   syncDocsToPublic
-} from "../chunk-4ZJKEEDA.js";
+} from "../chunk-BM7LMGAH.js";
 import "../chunk-EEPQVOZC.js";
 import "../chunk-7D2KLZGE.js";
 import "../chunk-4VNS5WPM.js";

package/package.json

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