starlight-cannoli-plugins 1.0.2 → 1.0.3

package/dist/{chunk-TXRBCETT.js → chunk-H377D3RC.js}

@@ -1,16 +1,33 @@
 // src/plugins/rehype-validate-links.ts
 import { existsSync } from "fs";
 import { sync as globSync } from "glob";
-import { minimatch } from "minimatch";
-import { dirname, join, relative, resolve } from "path";
+import { dirname as dirname2, join, relative, resolve as resolve2 } from "path";
 import { visit } from "unist-util-visit";
+
+// src/plugins/utils/path-utils.ts
+import { dirname, resolve } from "path";
+import { minimatch } from "minimatch";
 var PROJECT_DOCS_DIR = "src/content/docs";
+function isExternalPath(path) {
+  return path.startsWith("http") || path.startsWith("data:") || path.startsWith("/");
+}
 function matchesSkipPattern(path, patterns) {
   if (!patterns || patterns.length === 0) {
     return false;
   }
   return patterns.some((pattern) => minimatch(path, pattern));
 }
+function normalizePath(path, fromFilePath, siteRootPath) {
+  if (isExternalPath(path)) {
+    return null;
+  }
+  const fileDir = dirname(fromFilePath);
+  const resolvedPath = resolve(fileDir, path);
+  const siteRoot = resolve(siteRootPath);
+  return "/" + resolve(resolvedPath).slice(siteRoot.length).replace(/\\/g, "/");
+}
+
+// src/plugins/rehype-validate-links.ts
 function getResolvedLink(href, currentFilePath) {
   let skipValidation = false;
   let processedHref = href;
@@ -38,10 +55,10 @@ function getResolvedLink(href, currentFilePath) {
     relativePath = withoutFragment.slice(1);
     projectAbsolute = join(PROJECT_DOCS_DIR, relativePath);
   } else {
-    const currentFileDir = dirname(currentFilePath);
-    const resolvedAbsPath = resolve(currentFileDir, withoutFragment);
+    const currentFileDir = dirname2(currentFilePath);
+    const resolvedAbsPath = resolve2(currentFileDir, withoutFragment);
     projectAbsolute = resolvedAbsPath;
-    const docsRootAbsolute = resolve(PROJECT_DOCS_DIR);
+    const docsRootAbsolute = resolve2(PROJECT_DOCS_DIR);
     relativePath = relative(docsRootAbsolute, resolvedAbsPath);
   }
   const hasExtension = /\.[a-z0-9]+$/i.test(projectAbsolute);
@@ -96,51 +113,23 @@ function rehypeValidateLinks(options) {
       );
       return;
     }
-    visit(tree, "element", (node, index, parent) => {
-      let resourcePath;
-      let attributeName = null;
-      if (node.tagName === "a") {
-        resourcePath = node.properties?.href;
-        attributeName = "href";
-      } else if (node.tagName === "img") {
-        resourcePath = node.properties?.src;
-        attributeName = "src";
-      }
-      if (!resourcePath || !attributeName) return;
-      const link = getResolvedLink(resourcePath, filePath);
+    visit(tree, "element", (node) => {
+      if (node.tagName !== "a") return;
+      const href = node.properties?.href;
+      if (!href) return;
+      const link = getResolvedLink(href, filePath);
       if (!link) return;
-      if (link.skipValidation) {
-        node.properties = node.properties || {};
-        node.properties[attributeName] = link.site_absolute_href;
-        return;
-      }
-      if (node.properties?.["data-no-link-check"] !== void 0) {
-        node.properties = node.properties || {};
-        node.properties[attributeName] = link.site_absolute_href;
-        return;
-      }
-      if (matchesSkipPattern(link.site_absolute_href, options?.skipPatterns)) {
-        node.properties = node.properties || {};
-        node.properties[attributeName] = link.site_absolute_href;
-        return;
-      }
-      if (index !== void 0 && parent && "children" in parent && Array.isArray(parent.children)) {
-        const nextNode = parent.children[index + 1];
-        if (nextNode && "type" in nextNode && nextNode.type === "comment" && "value" in nextNode && typeof nextNode.value === "string" && nextNode.value.includes("no-link-check")) {
-          node.properties = node.properties || {};
-          node.properties[attributeName] = link.site_absolute_href;
-          return;
-        }
-      }
+      if (link.skipValidation) return;
+      if (node.properties?.["data-no-link-check"] !== void 0) return;
+      if (matchesSkipPattern(link.site_absolute_href, options?.skipPatterns)) return;
       validateLink(link);
-      node.properties = node.properties || {};
-      node.properties[attributeName] = link.site_absolute_href;
     });
   };
 }
 var rehype_validate_links_default = rehypeValidateLinks;
 
 export {
+  normalizePath,
   rehypeValidateLinks,
   rehype_validate_links_default
 };

package/dist/index.d.ts

@@ -1,5 +1,14 @@
 export { starlightIndexOnlySidebar } from './plugins/starlight-index-only-sidebar.js';
 export { default as rehypeValidateLinks } from './plugins/rehype-validate-links.js';
+import { AstroIntegration } from 'astro';
 import '@astrojs/starlight/types';
 import 'hast';
 import 'vfile';
+
+/**
+ * Astro integration that normalizes img src and anchor href attributes to absolute paths in HTML files after build.
+ * This processes resources in Starlight docs that aren't handled by the rehype plugin.
+ */
+declare function astroNormalizePaths(): AstroIntegration;
+
+export { astroNormalizePaths };

package/dist/index.js

@@ -2,9 +2,55 @@ import {
   starlightIndexOnlySidebar
 } from "./chunk-NTIYGHZG.js";
 import {
+  normalizePath,
   rehypeValidateLinks
-} from "./chunk-TXRBCETT.js";
+} from "./chunk-H377D3RC.js";
+
+// src/plugins/astro-normalize-paths.ts
+import { readFileSync, writeFileSync } from "fs";
+import { sync as globSync } from "glob";
+function astroNormalizePaths() {
+  return {
+    name: "astro-normalize-paths",
+    hooks: {
+      "astro:build:done": async ({ dir }) => {
+        const htmlFiles = globSync(`${dir.pathname}/**/*.html`);
+        for (const htmlFile of htmlFiles) {
+          let content = readFileSync(htmlFile, "utf-8");
+          const originalContent = content;
+          const imgRegex = /<img([^>]*?)src=["']([^"']+)["']/g;
+          let match;
+          while ((match = imgRegex.exec(content)) !== null) {
+            const attrs = match[1];
+            const src = match[2];
+            const normalized = normalizePath(src, htmlFile, dir.pathname);
+            if (normalized && src !== normalized) {
+              const oldTag = `<img${attrs}src="${src}"`;
+              const newTag = `<img${attrs}src="${normalized}"`;
+              content = content.replace(oldTag, newTag);
+            }
+          }
+          const anchorRegex = /<a([^>]*?)href=["']([^"']+)["']/g;
+          while ((match = anchorRegex.exec(content)) !== null) {
+            const attrs = match[1];
+            const href = match[2];
+            const normalized = normalizePath(href, htmlFile, dir.pathname);
+            if (normalized && href !== normalized) {
+              const oldTag = `<a${attrs}href="${href}"`;
+              const newTag = `<a${attrs}href="${normalized}"`;
+              content = content.replace(oldTag, newTag);
+            }
+          }
+          if (content !== originalContent) {
+            writeFileSync(htmlFile, content, "utf-8");
+          }
+        }
+      }
+    }
+  };
+}
 export {
+  astroNormalizePaths,
   rehypeValidateLinks,
   starlightIndexOnlySidebar
 };

package/dist/plugins/rehype-validate-links.d.ts

@@ -5,7 +5,8 @@ type TRehypeValidateLinksOptions = {
     skipPatterns?: string[];
 };
 /**
- * Rehype plugin to validate all internal links and convert them to absolute paths
+ * Rehype plugin to validate all internal links (checks validity only, no path normalization).
+ * This plugin verifies that link targets exist; path normalization is handled by separate integrations.
  */
 declare function rehypeValidateLinks(options?: TRehypeValidateLinksOptions): (tree: Root, file: VFile) => void;
 

package/dist/plugins/rehype-validate-links.js

@@ -1,7 +1,7 @@
 import {
   rehypeValidateLinks,
   rehype_validate_links_default
-} from "../chunk-TXRBCETT.js";
+} from "../chunk-H377D3RC.js";
 export {
   rehype_validate_links_default as default,
   rehypeValidateLinks

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",
@@ -19,6 +19,10 @@
       "import": "./dist/plugins/rehype-validate-links.js",
       "types": "./dist/plugins/rehype-validate-links.d.ts"
     },
+    "./astro-normalize-paths": {
+      "import": "./dist/plugins/astro-normalize-paths.js",
+      "types": "./dist/plugins/astro-normalize-paths.d.ts"
+    },
     "./styles": "./src/styles/",
     "./styles/*": "./src/styles/*"
   },