nuxt-ai-ready 2.3.3 → 2.3.4

package/dist/module.json

@@ -4,7 +4,7 @@
     "nuxt": ">=4.0.0"
   },
   "configKey": "aiReady",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/runtime/app/plugins/md-alternate.server.js

@@ -1,18 +1,18 @@
 import { defineNuxtPlugin, useHead, useRequestURL, useRuntimeConfig } from "nuxt/app";
 import { joinURL } from "ufo";
-import { toMarkdownPath } from "../../markdown-path.js";
+import { markdownAlternatePath } from "../../markdown-path.js";
 export default defineNuxtPlugin({
   setup() {
     const url = useRequestURL();
     const path = url.pathname;
-    const lastSegment = path.split("/").pop() || "";
-    if (lastSegment.includes("."))
+    const markdownPath = markdownAlternatePath(path);
+    if (!markdownPath)
       return;
     const runtimeConfig = useRuntimeConfig();
     const describedby = runtimeConfig["nuxt-ai-ready"]?.describedby !== false;
     useHead({
       link: [
-        { rel: "alternate", type: "text/markdown", href: toMarkdownPath(path) },
+        { rel: "alternate", type: "text/markdown", href: markdownPath },
         ...describedby ? [{ rel: "describedby", href: joinURL(runtimeConfig.app.baseURL, "llms.txt") }] : []
       ]
     });

package/dist/runtime/markdown-path.d.ts

@@ -1,4 +1,11 @@
-/** True for the `/api` namespace and Nitro's `/_*` and `/@*` internal paths. */
+/** True for the `/api` namespace, Nitro's `/_*` paths, and Vite's `/@*` internals. */
 export declare function isReservedPath(path: string): boolean;
 export declare function normalizePagePath(path: string): string;
 export declare function toMarkdownPath(path: string): string;
+/**
+ * The `.md` sibling a page may advertise, or null when it has none.
+ *
+ * Advertising and serving read the same predicate here, so a page cannot link
+ * a representation the markdown handler declines.
+ */
+export declare function markdownAlternatePath(path: string): string | null;

package/dist/runtime/markdown-path.js

@@ -1,5 +1,5 @@
 const RE_TRAILING_SLASHES = /\/+$/;
-const RE_RESERVED_PATH = /^\/(?:api(?:\/|$)|_|@)/;
+const RE_RESERVED_PATH = /^\/(?:api(?:\/|$)|_|@(?:id|fs|vite|react-refresh)(?:\/|$))/;
 export function isReservedPath(path) {
   return RE_RESERVED_PATH.test(path);
 }
@@ -12,3 +12,11 @@ export function toMarkdownPath(path) {
     return "/index.md";
   return `${normalizedPath}.md`;
 }
+export function markdownAlternatePath(path) {
+  if (isReservedPath(path))
+    return null;
+  const lastSegment = normalizePagePath(path).split("/").pop() || "";
+  if (lastSegment.includes("."))
+    return null;
+  return toMarkdownPath(path);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxt-ai-ready",
   "type": "module",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "description": "Best practice AI & LLM discoverability for Nuxt sites.",
   "author": {
     "name": "Harlan Wilton",