astro-smart-links 1.0.1 → 1.1.1

package/README.md

@@ -12,6 +12,11 @@ No routes file, no second build. The integration validates links against the rea
 
 > Migrating from `rehype-smart-links@0.x`? See [Migration](#migration-from-rehype-smart-links).
 
+## Requirements
+
+- Node.js 18.17 or newer.
+- Astro 4 or newer. Both Astro 7's default Sätteri Markdown processor and the unified processor from `@astrojs/markdown-remark` are supported.
+
 ## Installation
 
 ```bash
@@ -113,6 +118,7 @@ npx astro-smart-links check --all --extensions html pdf zip
 | `--json` | Print the report to stdout |
 | `-a, --all` | Treat every file type as a valid route |
 | `-e, --extensions <ext...>` | File extensions to include (default `html`) |
+| `--skip-classes <class...>` | Skip links inside elements with these classes |
 | `--fail-on-broken` | Exit with code 1 when broken links are found |
 | `-q, --quiet` | Only print the summary |
 
@@ -128,6 +134,7 @@ npx astro-smart-links check --all --extensions html pdf zip
 | `target` | `string \| null` | `'_blank'` | `target` attribute for external links |
 | `rel` | `string \| null` | `'noopener noreferrer'` | `rel` attribute for external links |
 | `ignore` | `(string \| RegExp)[]` | `[]` | Hrefs that are never processed (prefix match or RegExp) |
+| `skipClasses` | `string[]` | `[]` | Skip links inside elements with these classes (e.g. `['not-content']`) |
 | `routes` | `string[]` | — | Explicit route list for broken-link detection |
 | `routesFile` | `string` | — | JSON file with a route list |
 | `publicDir` | `string` | — | Directory to scan for routes |

package/README.zh-CN.md

@@ -12,6 +12,11 @@
 
 > 从 `rehype-smart-links@0.x` 迁移？见 [迁移指南](#从-rehype-smart-links-迁移)。
 
+## 环境要求
+
+- Node.js 18.17 或更高版本。
+- Astro 4 或更高版本。同时支持 Astro 7 默认的 Sätteri Markdown 处理器和 `@astrojs/markdown-remark` 的 unified 处理器。
+
 ## 安装
 
 ```bash
@@ -113,6 +118,7 @@ npx astro-smart-links check --all --extensions html pdf zip
 | `--json` | 以 JSON 输出到 stdout |
 | `-a, --all` | 将所有文件类型视为有效路由 |
 | `-e, --extensions <ext...>` | 要包含的文件扩展名（默认 `html`） |
+| `--skip-classes <class...>` | 跳过位于这些类名元素内的链接 |
 | `--fail-on-broken` | 发现断链时以退出码 1 结束 |
 | `-q, --quiet` | 只输出摘要 |
 
@@ -128,6 +134,7 @@ npx astro-smart-links check --all --extensions html pdf zip
 | `target` | `string \| null` | `'_blank'` | 外部链接的 `target` |
 | `rel` | `string \| null` | `'noopener noreferrer'` | 外部链接的 `rel` |
 | `ignore` | `(string \| RegExp)[]` | `[]` | 不处理的链接（前缀匹配或正则） |
+| `skipClasses` | `string[]` | `[]` | 跳过位于这些类名元素内的链接（如 `['not-content']`） |
 | `routes` | `string[]` | — | 显式路由列表 |
 | `routesFile` | `string` | — | 包含路由列表的 JSON 文件 |
 | `publicDir` | `string` | — | 扫描路由的目录 |

package/dist/{chunk-67PNI3F6.js → chunk-JNP2MFPB.js}

@@ -188,7 +188,6 @@ import { join as join2, relative } from "path";
 import rehypeParse from "rehype-parse";
 import rehypeStringify from "rehype-stringify";
 import { unified } from "unified";
-import { visit } from "unist-util-visit";
 function collectHtmlFiles(directory) {
   const files = [];
   const walk = (currentDir) => {
@@ -209,8 +208,14 @@ function routeFromHtmlFile(distDir, htmlFile) {
   relativePath = relativePath.replace(/(?:^|\/)index$/i, "");
   return normalizeRoute(relativePath);
 }
+function hasAnyClass(node, classes) {
+  const current = node.properties?.className;
+  const list = Array.isArray(current) ? current.map(String) : typeof current === "string" ? current.split(/\s+/) : [];
+  return classes.some((className) => list.includes(className));
+}
 function checkDirectory(directory, options = {}) {
   const routes = options.routes ?? scanRoutes(directory, options);
+  const skipClasses = options.skipClasses ?? [];
   const broken = [];
   let checkedLinks = 0;
   for (const htmlFile of collectHtmlFiles(directory)) {
@@ -221,30 +226,37 @@ function checkDirectory(directory, options = {}) {
     const tree = processor.parse(source);
     const pagePath = routeFromHtmlFile(directory, htmlFile);
     let changed = false;
-    visit(tree, "element", (node) => {
-      if (node.tagName !== "a" || !node.properties)
-        return;
-      const href = node.properties.href;
-      if (typeof href !== "string" || href.length === 0)
-        return;
-      const classified = classifyHref(href, {
-        base: options.base,
-        routes,
-        ignore: options.ignore,
-        pagePath
-      });
-      if (classified.type === "ignored")
-        return;
-      checkedLinks++;
-      if (classified.type !== "broken")
-        return;
-      broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
-      if (options.rewrite) {
-        removeClass(node, options.internalLinkClass);
-        addClass(node, options.brokenLinkClass);
-        changed = true;
+    const walk = (parent, insideSkipped) => {
+      for (const child of parent.children) {
+        if (child.type !== "element")
+          continue;
+        const skipped = insideSkipped || skipClasses.length > 0 && hasAnyClass(child, skipClasses);
+        if (child.tagName === "a" && !skipped && child.properties) {
+          const href = child.properties.href;
+          if (typeof href === "string" && href.length > 0) {
+            const classified = classifyHref(href, {
+              base: options.base,
+              routes,
+              ignore: options.ignore,
+              pagePath
+            });
+            if (classified.type !== "ignored") {
+              checkedLinks++;
+              if (classified.type === "broken") {
+                broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
+                if (options.rewrite) {
+                  removeClass(child, options.internalLinkClass);
+                  addClass(child, options.brokenLinkClass);
+                  changed = true;
+                }
+              }
+            }
+          }
+        }
+        walk(child, skipped);
       }
-    });
+    };
+    walk(tree, false);
     if (changed)
       writeFileSync2(htmlFile, processor.stringify(tree));
   }

package/dist/cli.cjs

@@ -35,7 +35,6 @@ var import_node_path2 = require("path");
 var import_rehype_parse = __toESM(require("rehype-parse"), 1);
 var import_rehype_stringify = __toESM(require("rehype-stringify"), 1);
 var import_unified = require("unified");
-var import_unist_util_visit = require("unist-util-visit");
 
 // src/core/normalize.ts
 var SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
@@ -212,8 +211,14 @@ function routeFromHtmlFile(distDir, htmlFile) {
   relativePath = relativePath.replace(/(?:^|\/)index$/i, "");
   return normalizeRoute(relativePath);
 }
+function hasAnyClass(node, classes) {
+  const current = node.properties?.className;
+  const list = Array.isArray(current) ? current.map(String) : typeof current === "string" ? current.split(/\s+/) : [];
+  return classes.some((className) => list.includes(className));
+}
 function checkDirectory(directory, options = {}) {
   const routes = options.routes ?? scanRoutes(directory, options);
+  const skipClasses = options.skipClasses ?? [];
   const broken = [];
   let checkedLinks = 0;
   for (const htmlFile of collectHtmlFiles(directory)) {
@@ -224,30 +229,37 @@ function checkDirectory(directory, options = {}) {
     const tree = processor.parse(source);
     const pagePath = routeFromHtmlFile(directory, htmlFile);
     let changed = false;
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "a" || !node.properties)
-        return;
-      const href = node.properties.href;
-      if (typeof href !== "string" || href.length === 0)
-        return;
-      const classified = classifyHref(href, {
-        base: options.base,
-        routes,
-        ignore: options.ignore,
-        pagePath
-      });
-      if (classified.type === "ignored")
-        return;
-      checkedLinks++;
-      if (classified.type !== "broken")
-        return;
-      broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
-      if (options.rewrite) {
-        removeClass(node, options.internalLinkClass);
-        addClass(node, options.brokenLinkClass);
-        changed = true;
+    const walk = (parent, insideSkipped) => {
+      for (const child of parent.children) {
+        if (child.type !== "element")
+          continue;
+        const skipped = insideSkipped || skipClasses.length > 0 && hasAnyClass(child, skipClasses);
+        if (child.tagName === "a" && !skipped && child.properties) {
+          const href = child.properties.href;
+          if (typeof href === "string" && href.length > 0) {
+            const classified = classifyHref(href, {
+              base: options.base,
+              routes,
+              ignore: options.ignore,
+              pagePath
+            });
+            if (classified.type !== "ignored") {
+              checkedLinks++;
+              if (classified.type === "broken") {
+                broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
+                if (options.rewrite) {
+                  removeClass(child, options.internalLinkClass);
+                  addClass(child, options.brokenLinkClass);
+                  changed = true;
+                }
+              }
+            }
+          }
+        }
+        walk(child, skipped);
       }
-    });
+    };
+    walk(tree, false);
     if (changed)
       (0, import_node_fs2.writeFileSync)(htmlFile, processor.stringify(tree));
   }
@@ -350,8 +362,8 @@ function escapeHtml(value) {
 
 // src/cli.ts
 var program = new import_commander.Command();
-program.name("astro-smart-links").description("CLI utility for astro-smart-links").version("1.0.1");
-program.command("check", { isDefault: true }).description("Check a build directory for broken internal links").option("-d, --dir <path>", "Build directory path", "./dist").option("-o, --output <path>", "Write the report to a file").option("--format <format>", "Report format: json or html", "json").option("--json", "Print the report to stdout as JSON", false).option("-a, --all", "Treat every file type as a valid route", false).option("-e, --extensions <ext...>", "File extensions to treat as routes", ["html"]).option("--fail-on-broken", "Exit with code 1 when broken links are found", false).option("-q, --quiet", "Only print the summary line", false).action((options) => {
+program.name("astro-smart-links").description("CLI utility for astro-smart-links").version("1.1.1");
+program.command("check", { isDefault: true }).description("Check a build directory for broken internal links").option("-d, --dir <path>", "Build directory path", "./dist").option("-o, --output <path>", "Write the report to a file").option("--format <format>", "Report format: json or html", "json").option("--json", "Print the report to stdout as JSON", false).option("-a, --all", "Treat every file type as a valid route", false).option("-e, --extensions <ext...>", "File extensions to treat as routes", ["html"]).option("--skip-classes <class...>", "Skip links inside elements with these classes").option("--fail-on-broken", "Exit with code 1 when broken links are found", false).option("-q, --quiet", "Only print the summary line", false).action((options) => {
   const buildDir = (0, import_node_path3.resolve)(import_node_process.default.cwd(), options.dir);
   const routesFile = options.output ? (0, import_node_path3.resolve)(import_node_process.default.cwd(), options.output) : void 0;
   if (!(0, import_node_fs3.existsSync)(buildDir)) {
@@ -361,6 +373,7 @@ program.command("check", { isDefault: true }).description("Check a build directo
   const { routes, broken, checkedLinks } = checkDirectory(buildDir, {
     includeAllFiles: options.all,
     includeFileExtensions: options.extensions,
+    skipClasses: options.skipClasses,
     rewrite: false,
     routes: scanRoutes(buildDir, {
       includeAllFiles: options.all,

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
   reportToJSON,
   scanRoutes,
   writeRoutesFile
-} from "./chunk-67PNI3F6.js";
+} from "./chunk-JNP2MFPB.js";
 
 // src/cli.ts
 import { existsSync, writeFileSync } from "fs";
@@ -15,8 +15,8 @@ import { resolve } from "path";
 import process from "process";
 import { Command } from "commander";
 var program = new Command();
-program.name("astro-smart-links").description("CLI utility for astro-smart-links").version("1.0.1");
-program.command("check", { isDefault: true }).description("Check a build directory for broken internal links").option("-d, --dir <path>", "Build directory path", "./dist").option("-o, --output <path>", "Write the report to a file").option("--format <format>", "Report format: json or html", "json").option("--json", "Print the report to stdout as JSON", false).option("-a, --all", "Treat every file type as a valid route", false).option("-e, --extensions <ext...>", "File extensions to treat as routes", ["html"]).option("--fail-on-broken", "Exit with code 1 when broken links are found", false).option("-q, --quiet", "Only print the summary line", false).action((options) => {
+program.name("astro-smart-links").description("CLI utility for astro-smart-links").version("1.1.1");
+program.command("check", { isDefault: true }).description("Check a build directory for broken internal links").option("-d, --dir <path>", "Build directory path", "./dist").option("-o, --output <path>", "Write the report to a file").option("--format <format>", "Report format: json or html", "json").option("--json", "Print the report to stdout as JSON", false).option("-a, --all", "Treat every file type as a valid route", false).option("-e, --extensions <ext...>", "File extensions to treat as routes", ["html"]).option("--skip-classes <class...>", "Skip links inside elements with these classes").option("--fail-on-broken", "Exit with code 1 when broken links are found", false).option("-q, --quiet", "Only print the summary line", false).action((options) => {
   const buildDir = resolve(process.cwd(), options.dir);
   const routesFile = options.output ? resolve(process.cwd(), options.output) : void 0;
   if (!existsSync(buildDir)) {
@@ -26,6 +26,7 @@ program.command("check", { isDefault: true }).description("Check a build directo
   const { routes, broken, checkedLinks } = checkDirectory(buildDir, {
     includeAllFiles: options.all,
     includeFileExtensions: options.extensions,
+    skipClasses: options.skipClasses,
     rewrite: false,
     routes: scanRoutes(buildDir, {
       includeAllFiles: options.all,

package/dist/index.cjs

@@ -200,7 +200,7 @@ function writeRoutesFile(routes, routesFilePath) {
 var import_node_fs4 = require("fs");
 var import_node_path3 = require("path");
 var import_node_process = __toESM(require("process"), 1);
-var import_node_url = require("url");
+var import_node_url2 = require("url");
 
 // src/core/check.ts
 var import_node_fs2 = require("fs");
@@ -208,7 +208,6 @@ var import_node_path2 = require("path");
 var import_rehype_parse = __toESM(require("rehype-parse"), 1);
 var import_rehype_stringify = __toESM(require("rehype-stringify"), 1);
 var import_unified = require("unified");
-var import_unist_util_visit = require("unist-util-visit");
 
 // src/core/classify.ts
 function classifyHref(href, context = {}) {
@@ -282,8 +281,14 @@ function routeFromHtmlFile(distDir, htmlFile) {
   relativePath = relativePath.replace(/(?:^|\/)index$/i, "");
   return normalizeRoute(relativePath);
 }
+function hasAnyClass(node, classes) {
+  const current = node.properties?.className;
+  const list = Array.isArray(current) ? current.map(String) : typeof current === "string" ? current.split(/\s+/) : [];
+  return classes.some((className) => list.includes(className));
+}
 function checkDirectory(directory, options = {}) {
   const routes = options.routes ?? scanRoutes(directory, options);
+  const skipClasses = options.skipClasses ?? [];
   const broken = [];
   let checkedLinks = 0;
   for (const htmlFile of collectHtmlFiles(directory)) {
@@ -294,46 +299,50 @@ function checkDirectory(directory, options = {}) {
     const tree = processor.parse(source);
     const pagePath = routeFromHtmlFile(directory, htmlFile);
     let changed = false;
-    (0, import_unist_util_visit.visit)(tree, "element", (node) => {
-      if (node.tagName !== "a" || !node.properties)
-        return;
-      const href = node.properties.href;
-      if (typeof href !== "string" || href.length === 0)
-        return;
-      const classified = classifyHref(href, {
-        base: options.base,
-        routes,
-        ignore: options.ignore,
-        pagePath
-      });
-      if (classified.type === "ignored")
-        return;
-      checkedLinks++;
-      if (classified.type !== "broken")
-        return;
-      broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
-      if (options.rewrite) {
-        removeClass(node, options.internalLinkClass);
-        addClass(node, options.brokenLinkClass);
-        changed = true;
+    const walk = (parent, insideSkipped) => {
+      for (const child of parent.children) {
+        if (child.type !== "element")
+          continue;
+        const skipped = insideSkipped || skipClasses.length > 0 && hasAnyClass(child, skipClasses);
+        if (child.tagName === "a" && !skipped && child.properties) {
+          const href = child.properties.href;
+          if (typeof href === "string" && href.length > 0) {
+            const classified = classifyHref(href, {
+              base: options.base,
+              routes,
+              ignore: options.ignore,
+              pagePath
+            });
+            if (classified.type !== "ignored") {
+              checkedLinks++;
+              if (classified.type === "broken") {
+                broken.push({ href, pathname: classified.pathname ?? href, sourceFile: htmlFile });
+                if (options.rewrite) {
+                  removeClass(child, options.internalLinkClass);
+                  addClass(child, options.brokenLinkClass);
+                  changed = true;
+                }
+              }
+            }
+          }
+        }
+        walk(child, skipped);
       }
-    });
+    };
+    walk(tree, false);
     if (changed)
       (0, import_node_fs2.writeFileSync)(htmlFile, processor.stringify(tree));
   }
   return { routes, broken, checkedLinks };
 }
 
-// src/rehype.ts
-var import_node_fs3 = require("fs");
+// src/core/satteri.ts
+var import_node_url = require("url");
 
 // src/core/transform.ts
-var import_unist_util_visit2 = require("unist-util-visit");
-function getPagePath(file, pagesDir) {
-  if (!pagesDir)
-    return void 0;
-  const filePath = file?.path ?? file?.history?.[0];
-  if (!filePath)
+var import_unist_util_visit = require("unist-util-visit");
+function getPagePath(filePath, pagesDir) {
+  if (!pagesDir || !filePath)
     return void 0;
   const normalizedPagesDir = pagesDir.replace(/[\\/]+$/, "");
   if (!filePath.startsWith(normalizedPagesDir))
@@ -343,94 +352,155 @@ function getPagePath(file, pagesDir) {
   relativePath = relativePath.replace(/(?:^|\/)index$/i, "");
   return relativePath ? `/${relativePath}` : "/";
 }
-function replaceNode(parent, index, node, replacement) {
-  if (replacement !== node && parent && typeof index === "number")
-    parent.children[index] = replacement;
-  return replacement;
-}
-function applyWrapper(node, type, className, meta, options, parent, index) {
-  if (!options.wrapperTemplate)
-    return;
-  const result = options.wrapperTemplate(node, type, meta);
-  if (result && result !== node)
-    replaceNode(parent, index, node, result);
+function transformAnchor(node, href, context, hooks) {
+  const { options, routes } = context;
+  const classified = classifyHref(href, {
+    base: options.base,
+    pagePath: context.pagePath,
+    routes,
+    ignore: options.ignore
+  });
+  if (classified.type === "ignored")
+    return void 0;
+  const type = classified.type;
+  const className = type === "internal" ? options.internalLinkClass : type === "external" ? options.externalLinkClass : options.brokenLinkClass;
+  const meta = {
+    href,
+    pathname: classified.pathname,
+    className,
+    sourceFile: context.sourceFile
+  };
+  const record = {
+    type,
+    href,
+    pathname: classified.pathname,
+    sourceFile: context.sourceFile
+  };
+  options.onLink?.(record);
+  const applyWrapper = () => {
+    if (!options.wrapperTemplate)
+      return false;
+    const result = options.wrapperTemplate(node, type, meta);
+    if (result && result !== node)
+      hooks.replace(node, result);
+    return true;
+  };
+  if (type === "external") {
+    if (options.customExternalLinkTransform) {
+      options.customExternalLinkTransform(node, meta);
+      return record;
+    }
+    if (options.target)
+      node.properties.target = options.target;
+    if (options.rel)
+      node.properties.rel = options.rel;
+    if (applyWrapper())
+      return record;
+    addClass(node, options.externalLinkClass);
+    if (options.content)
+      hooks.appendChild(node, createContentElement(options.contentClass, options.content.value));
+    return record;
+  }
+  if (type === "internal") {
+    if (options.customInternalLinkTransform) {
+      options.customInternalLinkTransform(node, meta);
+      return record;
+    }
+    if (applyWrapper())
+      return record;
+    addClass(node, options.internalLinkClass);
+    return record;
+  }
+  if (options.customBrokenLinkTransform) {
+    options.customBrokenLinkTransform(node, meta);
+    return record;
+  }
+  if (applyWrapper())
+    return record;
+  removeClass(node, options.internalLinkClass);
+  addClass(node, options.brokenLinkClass);
+  return record;
 }
 function transformTree(tree, file, context) {
-  const { options, routes } = context;
-  const pagePath = context.pagePath ?? getPagePath(file, options.pagesDir);
-  const sourceFile = file?.path ?? file?.history?.[0];
+  const sourceFile = context.sourceFile ?? file?.path ?? file?.history?.[0];
+  const pagePath = context.pagePath ?? getPagePath(sourceFile, context.options.pagesDir);
   const counts = { internal: 0, external: 0, broken: 0 };
   const records = [];
-  (0, import_unist_util_visit2.visit)(tree, "element", (node, index, parent) => {
+  (0, import_unist_util_visit.visit)(tree, "element", (node, index, parent) => {
     if (node.tagName !== "a" || !node.properties)
       return;
     const href = node.properties.href;
     if (typeof href !== "string" || href.length === 0)
       return;
-    const classified = classifyHref(href, {
-      base: options.base,
-      pagePath,
-      routes,
-      ignore: options.ignore
-    });
-    if (classified.type === "ignored")
-      return;
-    const type = classified.type;
-    const className = type === "internal" ? options.internalLinkClass : type === "external" ? options.externalLinkClass : options.brokenLinkClass;
-    const meta = {
+    const record = transformAnchor(
+      node,
       href,
-      pathname: classified.pathname,
-      className,
-      sourceFile
-    };
-    counts[type]++;
-    const record = { type, href, pathname: classified.pathname, sourceFile };
-    records.push(record);
-    options.onLink?.(record);
-    if (type === "external") {
-      if (options.customExternalLinkTransform) {
-        options.customExternalLinkTransform(node, meta);
-        return;
-      }
-      if (options.target)
-        node.properties.target = options.target;
-      if (options.rel)
-        node.properties.rel = options.rel;
-      if (options.wrapperTemplate) {
-        applyWrapper(node, "external", options.externalLinkClass, meta, options, parent, index);
-        return;
-      }
-      addClass(node, options.externalLinkClass);
-      if (options.content)
-        node.children.push(createContentElement(options.contentClass, options.content.value));
-      return;
-    }
-    if (type === "internal") {
-      if (options.customInternalLinkTransform) {
-        options.customInternalLinkTransform(node, meta);
-        return;
-      }
-      if (options.wrapperTemplate) {
-        applyWrapper(node, "internal", options.internalLinkClass, meta, options, parent, index);
-        return;
+      { ...context, pagePath, sourceFile },
+      {
+        replace: (_target, replacement) => {
+          if (parent && typeof index === "number")
+            parent.children[index] = replacement;
+        },
+        appendChild: (target, child) => {
+          target.children.push(child);
+        }
       }
-      addClass(node, options.internalLinkClass);
-      return;
-    }
-    if (options.customBrokenLinkTransform) {
-      options.customBrokenLinkTransform(node, meta);
-      return;
-    }
-    if (options.wrapperTemplate) {
-      applyWrapper(node, "broken", options.brokenLinkClass, meta, options, parent, index);
-      return;
+    );
+    if (record) {
+      counts[record.type]++;
+      records.push(record);
     }
-    removeClass(node, options.internalLinkClass);
-    addClass(node, options.brokenLinkClass);
   });
   return { counts, records };
 }
 
+// src/core/satteri.ts
+function cloneHastNode(node) {
+  const clone = { ...node };
+  if (Array.isArray(clone.children))
+    clone.children = clone.children.map((child) => cloneHastNode(child));
+  if (clone.properties && typeof clone.properties === "object")
+    clone.properties = { ...clone.properties };
+  return clone;
+}
+function satteriSmartLinksPlugin(options, routes) {
+  return ({ fileURL }) => {
+    const sourceFile = fileURL ? (0, import_node_url.fileURLToPath)(fileURL) : void 0;
+    const pagePath = getPagePath(sourceFile, options.pagesDir);
+    return {
+      name: "astro-smart-links",
+      element: {
+        filter: ["a"],
+        visit: (node, ctx) => {
+          const href = node.properties?.href;
+          if (typeof href !== "string" || href.length === 0)
+            return;
+          const clone = cloneHastNode(node);
+          let result = clone;
+          transformAnchor(
+            clone,
+            href,
+            { options, routes, pagePath, sourceFile },
+            {
+              replace: (_target, replacement) => {
+                result = replacement;
+              },
+              appendChild: (target, child) => {
+                target.children.push(child);
+              }
+            }
+          );
+          if (result !== node)
+            ctx.replaceNode(node, result);
+        }
+      }
+    };
+  };
+}
+
+// src/rehype.ts
+var import_node_fs3 = require("fs");
+
 // src/types.ts
 var defaultOptions = {
   content: { type: "text", value: "\u2197" },
@@ -639,7 +709,7 @@ function smartLinks(options = {}) {
     hooks: {
       "astro:config:setup": ({ config, updateConfig, logger }) => {
         records.length = 0;
-        projectRoot = (0, import_node_url.fileURLToPath)(config.root);
+        projectRoot = (0, import_node_url2.fileURLToPath)(config.root);
         const adapter = {
           debug: (message) => logger.debug(message),
           info: (message) => logger.info(message),
@@ -655,29 +725,37 @@ function smartLinks(options = {}) {
         resolved = resolveOptions({
           ...linkOptions,
           base: config.base,
-          pagesDir: (0, import_node_url.fileURLToPath)(new URL("pages/", config.srcDir)),
+          pagesDir: (0, import_node_url2.fileURLToPath)(new URL("pages/", config.srcDir)),
           logger: adapter,
           onLink: (record) => {
             records.push(record);
             linkOptions.onLink?.(record);
           }
         });
-        updateConfig({
-          markdown: {
-            rehypePlugins: [
-              [rehypeSmartLinks, resolved]
-            ]
-          }
-        });
+        const processor = config.markdown?.processor;
+        if (processor?.options && Array.isArray(processor.options.hastPlugins)) {
+          processor.options.hastPlugins.push(satteriSmartLinksPlugin(resolved));
+        } else if (processor?.options && Array.isArray(processor.options.rehypePlugins)) {
+          processor.options.rehypePlugins.push([rehypeSmartLinks, resolved]);
+        } else {
+          updateConfig({
+            markdown: {
+              rehypePlugins: [
+                [rehypeSmartLinks, resolved]
+              ]
+            }
+          });
+        }
       },
       "astro:build:done": async ({ dir, logger }) => {
         const current = resolved;
         if (!current)
           return;
-        const distDir = (0, import_node_url.fileURLToPath)(dir);
+        const distDir = (0, import_node_url2.fileURLToPath)(dir);
         const { routes, broken } = checkDirectory(distDir, {
           base: current.base,
           ignore: current.ignore,
+          skipClasses: current.skipClasses,
           includeAllFiles: current.includeAllFiles,
           includeFileExtensions: current.includeFileExtensions,
           rewrite: true,

package/dist/index.d.cts

@@ -56,6 +56,12 @@ interface SmartLinksOptions {
      * normalized pathname (for strings: prefix match).
      */
     ignore?: (string | RegExp)[];
+    /**
+     * Links inside elements carrying one of these classes are skipped by the
+     * build-time check and are never rewritten. Useful for component or demo
+     * markup that opts out of content styles (e.g. Starlight's `not-content`).
+     */
+    skipClasses?: string[];
     /** Explicit list of known routes. When provided, broken links are detected. */
     routes?: string[];
     /** Path to a JSON file containing a list of known routes. */
@@ -147,6 +153,12 @@ interface CheckDirectoryOptions extends ScanRoutesOptions {
     /** Known routes. When omitted, routes are collected by scanning the directory. */
     routes?: Set<string>;
     ignore?: (string | RegExp)[];
+    /**
+     * Links inside elements carrying one of these classes are skipped entirely:
+     * they are not checked and never rewritten. Useful for component or demo
+     * markup that opts out of content styles (e.g. Starlight's `not-content`).
+     */
+    skipClasses?: string[];
     /** Rewrite generated HTML so broken links receive `brokenLinkClass`. */
     rewrite?: boolean;
     internalLinkClass?: string;

package/dist/index.d.ts

@@ -56,6 +56,12 @@ interface SmartLinksOptions {
      * normalized pathname (for strings: prefix match).
      */
     ignore?: (string | RegExp)[];
+    /**
+     * Links inside elements carrying one of these classes are skipped by the
+     * build-time check and are never rewritten. Useful for component or demo
+     * markup that opts out of content styles (e.g. Starlight's `not-content`).
+     */
+    skipClasses?: string[];
     /** Explicit list of known routes. When provided, broken links are detected. */
     routes?: string[];
     /** Path to a JSON file containing a list of known routes. */
@@ -147,6 +153,12 @@ interface CheckDirectoryOptions extends ScanRoutesOptions {
     /** Known routes. When omitted, routes are collected by scanning the directory. */
     routes?: Set<string>;
     ignore?: (string | RegExp)[];
+    /**
+     * Links inside elements carrying one of these classes are skipped entirely:
+     * they are not checked and never rewritten. Useful for component or demo
+     * markup that opts out of content styles (e.g. Starlight's `not-content`).
+     */
+    skipClasses?: string[];
     /** Rewrite generated HTML so broken links receive `brokenLinkClass`. */
     rewrite?: boolean;
     internalLinkClass?: string;

package/dist/index.js

@@ -20,24 +20,21 @@ import {
   routeFromHtmlFile,
   scanRoutes,
   writeRoutesFile
-} from "./chunk-67PNI3F6.js";
+} from "./chunk-JNP2MFPB.js";
 
 // src/integration.ts
 import { writeFileSync } from "fs";
 import { resolve } from "path";
 import process from "process";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
-// src/rehype.ts
-import { existsSync } from "fs";
+// src/core/satteri.ts
+import { fileURLToPath } from "url";
 
 // src/core/transform.ts
 import { visit } from "unist-util-visit";
-function getPagePath(file, pagesDir) {
-  if (!pagesDir)
-    return void 0;
-  const filePath = file?.path ?? file?.history?.[0];
-  if (!filePath)
+function getPagePath(filePath, pagesDir) {
+  if (!pagesDir || !filePath)
     return void 0;
   const normalizedPagesDir = pagesDir.replace(/[\\/]+$/, "");
   if (!filePath.startsWith(normalizedPagesDir))
@@ -47,22 +44,78 @@ function getPagePath(file, pagesDir) {
   relativePath = relativePath.replace(/(?:^|\/)index$/i, "");
   return relativePath ? `/${relativePath}` : "/";
 }
-function replaceNode(parent, index, node, replacement) {
-  if (replacement !== node && parent && typeof index === "number")
-    parent.children[index] = replacement;
-  return replacement;
-}
-function applyWrapper(node, type, className, meta, options, parent, index) {
-  if (!options.wrapperTemplate)
-    return;
-  const result = options.wrapperTemplate(node, type, meta);
-  if (result && result !== node)
-    replaceNode(parent, index, node, result);
+function transformAnchor(node, href, context, hooks) {
+  const { options, routes } = context;
+  const classified = classifyHref(href, {
+    base: options.base,
+    pagePath: context.pagePath,
+    routes,
+    ignore: options.ignore
+  });
+  if (classified.type === "ignored")
+    return void 0;
+  const type = classified.type;
+  const className = type === "internal" ? options.internalLinkClass : type === "external" ? options.externalLinkClass : options.brokenLinkClass;
+  const meta = {
+    href,
+    pathname: classified.pathname,
+    className,
+    sourceFile: context.sourceFile
+  };
+  const record = {
+    type,
+    href,
+    pathname: classified.pathname,
+    sourceFile: context.sourceFile
+  };
+  options.onLink?.(record);
+  const applyWrapper = () => {
+    if (!options.wrapperTemplate)
+      return false;
+    const result = options.wrapperTemplate(node, type, meta);
+    if (result && result !== node)
+      hooks.replace(node, result);
+    return true;
+  };
+  if (type === "external") {
+    if (options.customExternalLinkTransform) {
+      options.customExternalLinkTransform(node, meta);
+      return record;
+    }
+    if (options.target)
+      node.properties.target = options.target;
+    if (options.rel)
+      node.properties.rel = options.rel;
+    if (applyWrapper())
+      return record;
+    addClass(node, options.externalLinkClass);
+    if (options.content)
+      hooks.appendChild(node, createContentElement(options.contentClass, options.content.value));
+    return record;
+  }
+  if (type === "internal") {
+    if (options.customInternalLinkTransform) {
+      options.customInternalLinkTransform(node, meta);
+      return record;
+    }
+    if (applyWrapper())
+      return record;
+    addClass(node, options.internalLinkClass);
+    return record;
+  }
+  if (options.customBrokenLinkTransform) {
+    options.customBrokenLinkTransform(node, meta);
+    return record;
+  }
+  if (applyWrapper())
+    return record;
+  removeClass(node, options.internalLinkClass);
+  addClass(node, options.brokenLinkClass);
+  return record;
 }
 function transformTree(tree, file, context) {
-  const { options, routes } = context;
-  const pagePath = context.pagePath ?? getPagePath(file, options.pagesDir);
-  const sourceFile = file?.path ?? file?.history?.[0];
+  const sourceFile = context.sourceFile ?? file?.path ?? file?.history?.[0];
+  const pagePath = context.pagePath ?? getPagePath(sourceFile, context.options.pagesDir);
   const counts = { internal: 0, external: 0, broken: 0 };
   const records = [];
   visit(tree, "element", (node, index, parent) => {
@@ -71,70 +124,75 @@ function transformTree(tree, file, context) {
     const href = node.properties.href;
     if (typeof href !== "string" || href.length === 0)
       return;
-    const classified = classifyHref(href, {
-      base: options.base,
-      pagePath,
-      routes,
-      ignore: options.ignore
-    });
-    if (classified.type === "ignored")
-      return;
-    const type = classified.type;
-    const className = type === "internal" ? options.internalLinkClass : type === "external" ? options.externalLinkClass : options.brokenLinkClass;
-    const meta = {
+    const record = transformAnchor(
+      node,
       href,
-      pathname: classified.pathname,
-      className,
-      sourceFile
-    };
-    counts[type]++;
-    const record = { type, href, pathname: classified.pathname, sourceFile };
-    records.push(record);
-    options.onLink?.(record);
-    if (type === "external") {
-      if (options.customExternalLinkTransform) {
-        options.customExternalLinkTransform(node, meta);
-        return;
-      }
-      if (options.target)
-        node.properties.target = options.target;
-      if (options.rel)
-        node.properties.rel = options.rel;
-      if (options.wrapperTemplate) {
-        applyWrapper(node, "external", options.externalLinkClass, meta, options, parent, index);
-        return;
-      }
-      addClass(node, options.externalLinkClass);
-      if (options.content)
-        node.children.push(createContentElement(options.contentClass, options.content.value));
-      return;
-    }
-    if (type === "internal") {
-      if (options.customInternalLinkTransform) {
-        options.customInternalLinkTransform(node, meta);
-        return;
-      }
-      if (options.wrapperTemplate) {
-        applyWrapper(node, "internal", options.internalLinkClass, meta, options, parent, index);
-        return;
+      { ...context, pagePath, sourceFile },
+      {
+        replace: (_target, replacement) => {
+          if (parent && typeof index === "number")
+            parent.children[index] = replacement;
+        },
+        appendChild: (target, child) => {
+          target.children.push(child);
+        }
       }
-      addClass(node, options.internalLinkClass);
-      return;
-    }
-    if (options.customBrokenLinkTransform) {
-      options.customBrokenLinkTransform(node, meta);
-      return;
-    }
-    if (options.wrapperTemplate) {
-      applyWrapper(node, "broken", options.brokenLinkClass, meta, options, parent, index);
-      return;
+    );
+    if (record) {
+      counts[record.type]++;
+      records.push(record);
     }
-    removeClass(node, options.internalLinkClass);
-    addClass(node, options.brokenLinkClass);
   });
   return { counts, records };
 }
 
+// src/core/satteri.ts
+function cloneHastNode(node) {
+  const clone = { ...node };
+  if (Array.isArray(clone.children))
+    clone.children = clone.children.map((child) => cloneHastNode(child));
+  if (clone.properties && typeof clone.properties === "object")
+    clone.properties = { ...clone.properties };
+  return clone;
+}
+function satteriSmartLinksPlugin(options, routes) {
+  return ({ fileURL }) => {
+    const sourceFile = fileURL ? fileURLToPath(fileURL) : void 0;
+    const pagePath = getPagePath(sourceFile, options.pagesDir);
+    return {
+      name: "astro-smart-links",
+      element: {
+        filter: ["a"],
+        visit: (node, ctx) => {
+          const href = node.properties?.href;
+          if (typeof href !== "string" || href.length === 0)
+            return;
+          const clone = cloneHastNode(node);
+          let result = clone;
+          transformAnchor(
+            clone,
+            href,
+            { options, routes, pagePath, sourceFile },
+            {
+              replace: (_target, replacement) => {
+                result = replacement;
+              },
+              appendChild: (target, child) => {
+                target.children.push(child);
+              }
+            }
+          );
+          if (result !== node)
+            ctx.replaceNode(node, result);
+        }
+      }
+    };
+  };
+}
+
+// src/rehype.ts
+import { existsSync } from "fs";
+
 // src/types.ts
 var defaultOptions = {
   content: { type: "text", value: "\u2197" },
@@ -249,7 +307,7 @@ function smartLinks(options = {}) {
     hooks: {
       "astro:config:setup": ({ config, updateConfig, logger }) => {
         records.length = 0;
-        projectRoot = fileURLToPath(config.root);
+        projectRoot = fileURLToPath2(config.root);
         const adapter = {
           debug: (message) => logger.debug(message),
           info: (message) => logger.info(message),
@@ -265,29 +323,37 @@ function smartLinks(options = {}) {
         resolved = resolveOptions({
           ...linkOptions,
           base: config.base,
-          pagesDir: fileURLToPath(new URL("pages/", config.srcDir)),
+          pagesDir: fileURLToPath2(new URL("pages/", config.srcDir)),
           logger: adapter,
           onLink: (record) => {
             records.push(record);
             linkOptions.onLink?.(record);
           }
         });
-        updateConfig({
-          markdown: {
-            rehypePlugins: [
-              [rehypeSmartLinks, resolved]
-            ]
-          }
-        });
+        const processor = config.markdown?.processor;
+        if (processor?.options && Array.isArray(processor.options.hastPlugins)) {
+          processor.options.hastPlugins.push(satteriSmartLinksPlugin(resolved));
+        } else if (processor?.options && Array.isArray(processor.options.rehypePlugins)) {
+          processor.options.rehypePlugins.push([rehypeSmartLinks, resolved]);
+        } else {
+          updateConfig({
+            markdown: {
+              rehypePlugins: [
+                [rehypeSmartLinks, resolved]
+              ]
+            }
+          });
+        }
       },
       "astro:build:done": async ({ dir, logger }) => {
         const current = resolved;
         if (!current)
           return;
-        const distDir = fileURLToPath(dir);
+        const distDir = fileURLToPath2(dir);
         const { routes, broken } = checkDirectory(distDir, {
           base: current.base,
           ignore: current.ignore,
+          skipClasses: current.skipClasses,
           includeAllFiles: current.includeAllFiles,
           includeFileExtensions: current.includeFileExtensions,
           rewrite: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "astro-smart-links",
   "type": "module",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "packageManager": "pnpm@11.8.0",
   "description": "An Astro integration that adds smart styling and broken-link detection to internal and external links",
   "author": "EveSunMaple",
@@ -80,11 +80,11 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^3.16.0",
-    "@types/node": "^18.19.86",
+    "@types/node": "^24.0.0",
     "@typescript-eslint/eslint-plugin": "^8.29.0",
     "@typescript-eslint/parser": "^8.29.0",
     "@vitest/ui": "3.1.1",
-    "astro": "^5.6.0",
+    "astro": "^7.3.6",
     "cheerio": "^1.0.0",
     "eslint": "^9.24.0",
     "eslint-plugin-astro": "^1.3.1",