blume 1.1.3 → 1.1.4

package/dist/cli/index.js

@@ -1581,6 +1581,13 @@ var normalizePath = (path) => {
   const trimmed = path.replace(/\/+$/u, "");
   return trimmed === "" ? "/" : trimmed;
 };
+var decodePath = (path) => {
+  try {
+    return decodeURI(path);
+  } catch {
+    return path;
+  }
+};
 var siteOrigin = (site) => {
   if (!site) {
     return null;
@@ -1611,7 +1618,7 @@ var resolveHref = (pageUrl, href, origin, deployBase = "") => {
       return {
         hash: parsed.hash.slice(1),
         kind: "self-origin",
-        path: normalizePath(stripBasePath(deployBase, parsed.pathname))
+        path: normalizePath(stripBasePath(deployBase, decodePath(parsed.pathname)))
       };
     }
     return { kind: "external", url: parsed.toString() };
@@ -1626,7 +1633,7 @@ var resolveHref = (pageUrl, href, origin, deployBase = "") => {
   return {
     hash: resolved.hash.slice(1),
     kind: "internal",
-    path: normalizePath(stripBasePath(deployBase, resolved.pathname))
+    path: normalizePath(stripBasePath(deployBase, decodePath(resolved.pathname)))
   };
 };
 
@@ -1825,17 +1832,20 @@ var contentChecks = {
 };
 
 // src/audit/checks/duplicates.ts
-var isNonCanonical = (page) => {
+var isNonCanonical = (page, deployBase) => {
   if (!page.canonical) {
     return false;
   }
   try {
-    return new URL(page.canonical).pathname.replace(/\/$/u, "") !== page.url.replace(/\/$/u, "");
+    return stripBasePath(deployBase, decodePath(new URL(page.canonical).pathname)).replace(/\/$/u, "") !== page.url.replace(/\/$/u, "");
   } catch {
     return false;
   }
 };
-var comparable = (context) => context.pages.filter((page) => page.indexable && !page.route?.fallback && !isNonCanonical(page));
+var comparable = (context) => {
+  const deployBase = normalizeBasePath(context.project.config.deployment.base);
+  return context.pages.filter((page) => page.indexable && !page.route?.fallback && !isNonCanonical(page, deployBase));
+};
 var reportGroups = (context, pages, id, key, describe, frontmatterKey) => {
   const groups = new Map;
   for (const page of pages) {
@@ -2009,12 +2019,12 @@ var PLATFORMS = [
   {
     adapter: "vercel",
     detect: (env) => Boolean(env.VERCEL),
-    site: (env) => toUrl(env.VERCEL_PROJECT_PRODUCTION_URL ?? env.VERCEL_URL)
+    site: (env) => toUrl(env.VERCEL_PROJECT_PRODUCTION_URL) ?? toUrl(env.VERCEL_URL)
   },
   {
     adapter: "netlify",
     detect: (env) => Boolean(env.NETLIFY),
-    site: (env) => toUrl(env.URL ?? env.DEPLOY_PRIME_URL ?? env.DEPLOY_URL)
+    site: (env) => toUrl(env.URL) ?? toUrl(env.DEPLOY_PRIME_URL) ?? toUrl(env.DEPLOY_URL)
   },
   {
     adapter: "cloudflare",
@@ -2073,7 +2083,7 @@ var canonicalChecks = (context, page) => {
     }
     return found;
   }
-  const target = normalizePath(canonical.pathname);
+  const target = normalizePath(stripBasePath(normalizeBasePath(context.project.config.deployment.base), decodePath(canonical.pathname)));
   if (target === normalizePath(page.url)) {
     return found;
   }
@@ -2401,7 +2411,7 @@ var probeAll = async (urls, options = {}) => {
 var CLIENT_ERROR = 400;
 var SERVER_ERROR = 500;
 var SLOW_MS = 1500;
-var liveUrl = (origin, page) => new URL(page.url, origin).toString();
+var liveUrl = (origin, page, deployBase) => new URL(`${deployBase}${page.url}`, origin).toString();
 var badResponse = (context, page, result) => {
   const site = pageSite(context, page);
   if (result.timedOut) {
@@ -2445,12 +2455,13 @@ var networkChecks = {
       return [];
     }
     const found = [];
-    const targets = context.pages.map((page) => liveUrl(origin, page));
-    const robotsUrl = new URL("/robots.txt", origin).toString();
-    const sitemapUrl = new URL("/sitemap.xml", origin).toString();
+    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const targets = context.pages.map((page) => liveUrl(origin, page, deployBase));
+    const robotsUrl = new URL(`${deployBase}/robots.txt`, origin).toString();
+    const sitemapUrl = new URL(`${deployBase}/sitemap.xml`, origin).toString();
     const results = await probeAll([...targets, robotsUrl, sitemapUrl]);
     for (const page of context.pages) {
-      const result = results.get(liveUrl(origin, page));
+      const result = results.get(liveUrl(origin, page, deployBase));
       if (!result) {
         continue;
       }
@@ -2717,23 +2728,23 @@ var MAX_SITEMAP_BYTES = 50 * 1024 * 1024;
 var MAX_SITEMAP_URLS = 50000;
 var LASTMOD_SLACK_MS = 24 * 60 * 60 * 1000;
 var ERROR_ROUTES2 = new Set(["/404", "/500"]);
-var sitemapPaths = (context) => {
+var sitemapPaths = (context, deployBase) => {
   const paths = new Map;
   for (const loc of context.sitemap?.urls ?? []) {
     try {
-      paths.set(normalizePath(new URL(loc).pathname), loc);
+      paths.set(normalizePath(stripBasePath(deployBase, decodePath(new URL(loc).pathname))), loc);
     } catch {}
   }
   return paths;
 };
-var canonicalPath = (canonical) => {
+var canonicalPath = (canonical, deployBase) => {
   try {
-    return normalizePath(new URL(canonical).pathname);
+    return normalizePath(stripBasePath(deployBase, decodePath(new URL(canonical).pathname)));
   } catch {
     return null;
   }
 };
-var checkListedUrl = (context, loc, origin, file) => {
+var checkListedUrl = (context, loc, origin, file, deployBase) => {
   let parsed;
   try {
     parsed = new URL(loc);
@@ -2747,7 +2758,7 @@ var checkListedUrl = (context, loc, origin, file) => {
       finding("BLUME_AUDIT_SITEMAP_OUT_OF_SCOPE", { file, url: loc }, `sitemap.xml lists ${loc}, which is on another origin.`)
     ];
   }
-  const path = normalizePath(stripBasePath(normalizeBasePath(context.project.config.deployment.base), parsed.pathname));
+  const path = normalizePath(stripBasePath(deployBase, decodePath(parsed.pathname)));
   const page = context.byUrl.get(path);
   if (!page) {
     const redirect = context.redirects.find((entry) => normalizePath(entry.from) === path);
@@ -2759,7 +2770,7 @@ var checkListedUrl = (context, loc, origin, file) => {
   if (!page.indexable) {
     found.push(finding("BLUME_AUDIT_NOINDEX_IN_SITEMAP", pageSite(context, page, ["noindex"]), `${path} is in the sitemap but declares robots "${page.robots}".`));
   }
-  const canonical = page.canonical && canonicalPath(page.canonical);
+  const canonical = page.canonical && canonicalPath(page.canonical, deployBase);
   if (canonical && canonical !== path) {
     found.push(finding("BLUME_AUDIT_NON_CANONICAL_IN_SITEMAP", pageSite(context, page, ["seo", "canonical"]), `${path} is in the sitemap but canonicalizes to ${canonical}.`));
   }
@@ -2795,9 +2806,10 @@ var sitemapChecks = {
       }
     }
     const origin = siteOrigin(site);
-    const listed = sitemapPaths(context);
+    const deployBase = normalizeBasePath(context.project.config.deployment.base);
+    const listed = sitemapPaths(context, deployBase);
     for (const loc of sitemap.urls) {
-      found.push(...checkListedUrl(context, loc, origin, sitemap.file));
+      found.push(...checkListedUrl(context, loc, origin, sitemap.file, deployBase));
     }
     for (const page of context.pages) {
       if (!page.indexable || ERROR_ROUTES2.has(page.url) || listed.has(normalizePath(page.url))) {
@@ -3468,6 +3480,13 @@ var astroOutDir = (context) => context.distDir ?? `${context.root}/dist`;
 var adapterRoot = (context) => dirname5(astroOutDir(context));
 var REACT_EXCLUDE = String.raw`exclude: [/\/node_modules\/\.vite\//]`;
 var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugins: [[${JSON.stringify(compilerPath)}, { target: "19" }]] }, ${REACT_EXCLUDE} })` : `react({ ${REACT_EXCLUDE} })`;
+var devWatchOption = (outDir, contentWatchesRuntimeDir) => contentWatchesRuntimeDir ? `
+      // Astro's cache dir sits inside the docs collection, whose watcher would
+      // otherwise churn (and can loop) on Astro's own writes. Trade-off: .md
+      // body edits need a dev-server restart in this layout.
+      watch: {
+        ignored: ${JSON.stringify([join8(outDir, ".astro", "**")])},
+      },` : "";
 var astroConfigTemplate = (options) => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
@@ -3554,6 +3573,7 @@ var astroConfigTemplate = (options) => {
     integrations.push("svelte()");
   }
   integrations.push(`blumeIntegration(${JSON.stringify({ base: deployment.base, contentRoutes, pages })})`);
+  const watchOption = devWatchOption(context.outDir, options.contentWatchesRuntimeDir);
   return `// Generated by Blume. Do not edit; this file is recreated on each run.
 ${defineConfigImport}
 import mdx from "@astrojs/mdx";
@@ -3628,22 +3648,17 @@ export default defineConfig({
     server: {
       fs: {
         allow: ${JSON.stringify(fsAllow)},
-      },
-      // Keep the file watcher out of Astro's own cache dir. In a migrated
-      // (root-rooted) project the docs collection is rooted at the project dir,
-      // so its glob-loader watcher would otherwise fire on every write Astro
-      // makes under .blume/.astro (data-store.json, content module manifests,
-      // self-hosted fonts) -- pure noise the loader logs as "No entry type
-      // found". Vite appends this to its default ignores.
-      watch: {
-        ignored: ${JSON.stringify([join8(context.outDir, ".astro", "**")])},
-      },
+      },${watchOption}
     },
   },
 });
 `;
 };
 var stagedContentDir = (outDir) => join8(outDir, "content");
+var runtimeDirWithin = (base, outDir) => {
+  const rel = relative5(base, outDir);
+  return rel && !rel.startsWith("..") && !isAbsolute(rel) ? rel : null;
+};
 var astroGlobBase = (base) => isAbsolute(base) ? pathToFileURL(base).href : base;
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
@@ -3651,8 +3666,8 @@ var contentConfigTemplate = (options) => {
   const collectionBase = options.collection?.base ?? context.contentRoot;
   const includeGlobs = options.collection?.include ?? config.content.include;
   const excludeGlobs = options.collection?.exclude ?? config.content.exclude;
-  const outDirRel = relative5(collectionBase, context.outDir);
-  const outDirIgnore = outDirRel && !outDirRel.startsWith("..") && !isAbsolute(outDirRel) ? [`!${outDirRel}/**`] : [];
+  const outDirRel = runtimeDirWithin(collectionBase, context.outDir);
+  const outDirIgnore = outDirRel ? [`!${outDirRel}/**`] : [];
   const filesystem = options.filesystem ?? true;
   const docsPattern = filesystem ? [
     ...includeGlobs,
@@ -5125,6 +5140,10 @@ var crawlStaticDir = async (options) => {
 };
 
 // src/audit/redirects.ts
+var pathOnly = (value) => {
+  const cut = value.search(/[?#]/u);
+  return cut === -1 ? value : value.slice(0, cut);
+};
 var resolveRedirects = (redirects, pageUrls) => {
   const byFrom = new Map;
   for (const redirect of redirects) {
@@ -5140,7 +5159,7 @@ var resolveRedirects = (redirects, pageUrls) => {
         chain.push(current);
         break;
       }
-      const next = normalizePath(current);
+      const next = normalizePath(pathOnly(current));
       if (seen.has(next)) {
         chain.push(next);
         return {
@@ -5222,8 +5241,9 @@ var matches = (id, terms) => {
 var runAudit = async (options) => {
   const { project } = options;
   const staticDir = deployStaticDir(project.config, project.context);
+  const basePath = normalizeBasePath(project.config.basePath);
   const crawl = await crawlStaticDir({
-    basePath: normalizeBasePath(project.config.basePath),
+    basePath,
     manifest: project.manifest,
     staticDir
   });
@@ -5240,7 +5260,11 @@ var runAudit = async (options) => {
     origin,
     pages: crawl.pages,
     project,
-    redirects: resolveRedirects(project.config.redirects, new Set([...byUrl.keys(), ...crawl.files.keys()].map((path) => normalizePath(path)))),
+    redirects: resolveRedirects(project.config.redirects.map((redirect) => ({
+      ...redirect,
+      from: withBasePath(basePath, redirect.from),
+      to: withBasePath(basePath, redirect.to)
+    })), new Set([...byUrl.keys(), ...crawl.files.keys()].map((path) => normalizePath(path)))),
     robots: crawl.robots,
     sitemap: crawl.sitemap,
     sources: await readSources(crawl.pages),
@@ -8191,9 +8215,10 @@ var detectLocale = (parts, i18n) => {
 var localePlacement = (rel, ext, i18n) => {
   const base = rel.slice(0, rel.length - ext.length);
   if (base.endsWith(".$")) {
+    const shared = `${base.slice(0, -2)}${ext}`;
     return {
       locales: i18n.locales.map((locale2) => locale2.code),
-      navPath: `${base.slice(0, -2)}${ext}`
+      navPath: i18n.parser === "dir" ? detectLocale(shared.split("/"), i18n).rest.join("/") : shared
     };
   }
   if (i18n.parser === "dot") {
@@ -8673,7 +8698,8 @@ var normalizeRef = (ref) => {
     return "/";
   }
   const withSlash = ref.startsWith("/") ? ref : `/${ref}`;
-  const trimmed = withSlash.endsWith("/index") ? withSlash.slice(0, -"/index".length) : withSlash;
+  const noTrailing = withSlash.replace(/\/+$/u, "");
+  const trimmed = noTrailing.endsWith("/index") ? noTrailing.slice(0, -"/index".length) : noTrailing;
   return trimmed === "" ? "/" : trimmed;
 };
 var routeForRef = (ref, byRoute, basePath) => {
@@ -8880,7 +8906,10 @@ var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n
     basePath: options.basePath ?? "",
     diagnostics,
     display: options.navigation.sidebar.display,
-    featured: options.navigation.featured,
+    featured: options.navigation.featured?.map((link) => ({
+      ...link,
+      href: localizePath(link.href)
+    })),
     folderMeta: options.folderMeta,
     localizedRoot: localizeRoute("/", code, i18n),
     metaPrefix: i18n.parser === "dir" && code !== i18n.defaultLocale ? code : "",
@@ -9176,6 +9205,7 @@ var WORD_SPLIT2 = /[-_]/u;
 var stripNumericPrefix = (segment) => segment.replace(NUMERIC_PREFIX2, "");
 var groupLabel = (segment) => segment.match(GROUP_FOLDER2)?.groups?.label ?? null;
 var slugify2 = (text) => text.toLowerCase().trim().replaceAll(/[^\w\s-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
+var slugifyPath = (text) => text.split("/").map(slugify2).filter(Boolean).join("/");
 var titleCase = (value) => value.split(WORD_SPLIT2).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 var addRouteSegment = (part, segments, groups) => {
   if (part === "") {
@@ -9205,11 +9235,18 @@ var mapRoute = (relativePath) => {
 };
 var CODE_FENCE = /^(?<delimiter>```|~~~)/u;
 var nextFenceState = (line, fence) => {
-  const delimiter = line.trimStart().match(CODE_FENCE)?.groups?.delimiter;
+  const trimmed = line.trimStart();
+  const delimiter = trimmed.match(CODE_FENCE)?.groups?.delimiter;
   if (delimiter === undefined) {
     return fence;
   }
   if (fence === null) {
+    if (delimiter === "```") {
+      const run = trimmed.match(/^`+/u)?.[0].length ?? 0;
+      if (trimmed.slice(run).includes("`")) {
+        return fence;
+      }
+    }
     return delimiter;
   }
   return fence === delimiter ? null : fence;
@@ -9227,6 +9264,9 @@ var linesWithoutFrontMatter = (body) => {
   if (!/^-{3}\s*$/u.test(lines[0] ?? "")) {
     return lines;
   }
+  if ((lines[1] ?? "").trim() === "") {
+    return lines;
+  }
   const close = lines.findIndex((line, index) => index > 0 && FRONT_MATTER_CLOSE.test(line));
   return close === -1 ? lines : lines.slice(close + 1);
 };
@@ -9306,8 +9346,10 @@ var extractHeadings = (body) => {
   }
   return headings;
 };
-var MD_LINK = /\[[^\]]*\]\((?<target>[^)\s]+)(?:\s+"[^"]*")?\)/gu;
+var MD_LINK = /\[(?<label>(?:[^[\]]|\[[^\]]*\])*)\]\((?<target>(?:[^()\s]|\([^()\s]*\))+)(?<title>\s+"[^"]*")?\)/gu;
+var MD_IMAGE = /!\[[^\]]*\]\((?<target>(?:[^()\s]|\([^()\s]*\))+)(?<title>\s+"[^"]*")?\)/gu;
 var INLINE_CODE = /`[^`]*`/gu;
+var targetOffsetIn = (matched, target, title) => matched.length - 1 - (title?.length ?? 0) - target.length;
 var scanLinkLine = (line, lineNumber, fence, links) => {
   const next = nextFenceState(line, fence);
   if (fence !== null || next !== null) {
@@ -9319,12 +9361,24 @@ var scanLinkLine = (line, lineNumber, fence, links) => {
     if (target === undefined || match.index === undefined) {
       continue;
     }
-    const targetOffset = match.index + match[0].indexOf("](") + "](".length;
+    const targetOffset = targetOffsetIn(match[0], target, match.groups?.title);
     links.push({
-      column: targetOffset + 1,
+      column: match.index + targetOffset + 1,
       line: lineNumber,
       target
     });
+    const label = match[0].slice(0, targetOffset - "](".length);
+    for (const image of label.matchAll(MD_IMAGE)) {
+      const imageTarget = image.groups?.target;
+      if (imageTarget === undefined || image.index === undefined) {
+        continue;
+      }
+      links.push({
+        column: match.index + image.index + targetOffsetIn(image[0], imageTarget, image.groups?.title) + 1,
+        line: lineNumber,
+        target: imageTarget
+      });
+    }
   }
   return next;
 };
@@ -9598,6 +9652,24 @@ var operationKey = (method, path, operationId) => {
   return fromId || slugify3(`${method}-${path}`);
 };
 var isOperation = (value) => typeof value === "object" && value !== null;
+var tagSlugger = () => {
+  const assigned = new Map;
+  const taken = new Set;
+  return (name) => {
+    const existing = assigned.get(name);
+    if (existing) {
+      return existing;
+    }
+    const base = slugify3(name) || "operations";
+    let slug = base;
+    for (let suffix = 2;taken.has(slug); suffix += 1) {
+      slug = `${base}-${suffix}`;
+    }
+    taken.add(slug);
+    assigned.set(name, slug);
+    return slug;
+  };
+};
 var extractOperations = (document, baseRoute) => {
   const operations = [];
   const tagOrder = [];
@@ -9605,6 +9677,7 @@ var extractOperations = (document, baseRoute) => {
   const tagMeta = new Map((document.tags ?? []).map((tag) => [tag.name, tag.description ?? ""]));
   const seen = new Set;
   const warnings = [];
+  const slugForTag = tagSlugger();
   for (const [path, rawItem] of Object.entries(document.paths ?? {})) {
     const item = rawItem;
     if (!item) {
@@ -9620,7 +9693,7 @@ var extractOperations = (document, baseRoute) => {
         continue;
       }
       const tag = operation.tags?.[0] ?? UNTAGGED;
-      const tagSlug = slugify3(tag) || "operations";
+      const tagSlug = slugForTag(tag);
       if (!tagsSeen.has(tag)) {
         tagsSeen.add(tag);
         tagOrder.push(tag);
@@ -9647,7 +9720,7 @@ var extractOperations = (document, baseRoute) => {
   const tags = tagOrder.map((name) => ({
     description: tagMeta.get(name) ?? "",
     name,
-    slug: slugify3(name) || "operations"
+    slug: slugForTag(name)
   }));
   return { operations, tags, warnings };
 };
@@ -9797,15 +9870,14 @@ var parseSpec = async (spec, root, options = {}) => {
 };
 
 // src/openapi/render-mdx.ts
-var MDX_UNSAFE = /[<>{}]/gu;
+var MDX_UNSAFE = /[<{}]/gu;
 var ENTITIES = {
   "<": "&lt;",
-  ">": "&gt;",
   "{": "&#123;",
   "}": "&#125;"
 };
 var MDX_ESM_KEYWORD = /^(?<keyword>import|export)\b/gmu;
-var BACKTICK_CODE = /(?<bt>`+)[\s\S]*?\k<bt>/gu;
+var BACKTICK_CODE = /(?<!`)(?<bt>`+)(?!`)[\s\S]*?(?<!`)\k<bt>(?!`)/gu;
 var escapeProse = (text) => text.replace(MDX_UNSAFE, (char) => ENTITIES[char] ?? char).replace(MDX_ESM_KEYWORD, (keyword) => `&#${keyword.codePointAt(0)};${keyword.slice(1)}`);
 var mdxSafe = (text) => {
   let out = "";
@@ -10417,7 +10489,7 @@ import { join as join15 } from "pathe";
 // src/core/sources/assets.ts
 import { mkdir as mkdir5, writeFile as writeFile5 } from "node:fs/promises";
 import { extname as extname4, join as join14 } from "pathe";
-var MD_IMAGE = /!\[(?<alt>[^\]]*)\]\((?<url>[^)\s]+)\)/gu;
+var MD_IMAGE2 = /!\[(?<alt>[^\]]*)\]\((?<url>[^)\s]+)\)/gu;
 var REMOTE = /^https?:\/\//u;
 var SAFE_EXT = /^\.[a-z0-9]+$/iu;
 var CODE_FENCE_BLOCK = /^(?<fence>`{3,}|~{3,})[^\n]*\n[\s\S]*?^\k<fence>[^\n]*(?=\n|$)/gmu;
@@ -10436,7 +10508,7 @@ var materializeAssets = async (markdown, ctx) => {
     return `\x00blume-fence-${fences.length - 1}\x00`;
   });
   const urls = new Set;
-  for (const match of masked.matchAll(MD_IMAGE)) {
+  for (const match of masked.matchAll(MD_IMAGE2)) {
     const url = match.groups?.url;
     if (url && REMOTE.test(url)) {
       urls.add(url);
@@ -10462,7 +10534,7 @@ var materializeAssets = async (markdown, ctx) => {
       });
     }
   }));
-  const rewritten = masked.replaceAll(MD_IMAGE, (match, alt, url) => {
+  const rewritten = masked.replaceAll(MD_IMAGE2, (match, alt, url) => {
     const local = rewrites.get(url);
     return local ? `![${alt}](${local})` : match;
   }).replaceAll(FENCE_TOKEN, (token, index) => fences[Number(index)] ?? token);
@@ -10697,7 +10769,7 @@ ${nested}`;
       data.sidebar = { order };
     }
     const slugProp = richToMarkdown(page.properties[props.slug ?? "Slug"]?.rich_text);
-    const slug = slugify2(slugProp || title) || page.id;
+    const slug = slugifyPath(slugProp || title) || page.id;
     return { data, slug };
   };
   const toEntry2 = async (client, page) => {
@@ -10904,7 +10976,7 @@ var sanitySource = (options, ctx) => {
   let snapshot = new Map;
   const toEntry2 = (doc) => {
     const slugValue = asString(getPath(doc, fields.slug ?? "slug.current")) ?? asString(doc._id) ?? "untitled";
-    const slug = slugify2(slugValue) || slugify2(asString(doc._id) ?? "") || "untitled";
+    const slug = slugifyPath(slugValue) || slugify2(asString(doc._id) ?? "") || "untitled";
     const data = {};
     const title = asString(getPath(doc, fields.title ?? "title"));
     const description = asString(getPath(doc, fields.description ?? "description"));
@@ -11264,6 +11336,16 @@ var shouldFail = (result, gate) => {
   const failing = failingSeverities(gate);
   return result.diagnostics.some((d) => failing.has(d.severity));
 };
+var launchAgentCode = async (bin, prompt) => {
+  try {
+    return await launchAgent(bin, prompt);
+  } catch (error) {
+    if (error?.code !== "ENOENT") {
+      throw error;
+    }
+    return WINDOWS_COMMAND_NOT_FOUND;
+  }
+};
 var auditCommand = defineCommand2({
   args: {
     claude: {
@@ -11369,12 +11451,7 @@ var auditCommand = defineCommand2({
       process.stderr.write(`  Handing ${count} finding${count === 1 ? "" : "s"} to ${cli.name}…
 
 `);
-      let code;
-      try {
-        code = await launchAgent(cli.bin, fixPrompt(report));
-      } catch {
-        code = WINDOWS_COMMAND_NOT_FOUND;
-      }
+      const code = await launchAgentCode(cli.bin, fixPrompt(report));
       if (code === WINDOWS_COMMAND_NOT_FOUND) {
         logger.error(`${cli.name} (\`${cli.bin}\`) was not found on PATH. Install it with \`${cli.install}\`.`);
         process.exit(1);
@@ -12577,6 +12654,7 @@ import {
   lstat,
   mkdir as mkdir6,
   readFile as readFile14,
+  readlink,
   realpath,
   rename,
   rm as rm2,
@@ -12585,7 +12663,7 @@ import {
 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { pathToFileURL as pathToFileURL3 } from "node:url";
-import { basename as basename3, dirname as dirname9, join as join26, normalize as normalize3, relative as relative13 } from "pathe";
+import { basename as basename3, dirname as dirname9, join as join26, normalize as normalize3, relative as relative13, resolve as resolve7 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
 // src/ai/ask-data.ts
@@ -14485,12 +14563,12 @@ var canResolveFrom = (fromDir, spec) => {
     return false;
   }
 };
-var resolveReactCompiler = (config, needsReact) => {
+var resolveReactCompiler = (config, needsReact, pkgDir = packageRoot()) => {
   if (!(needsReact && config.react.compiler)) {
     return null;
   }
   try {
-    return createRequire5(pathToFileURL3(join26(packageRoot(), "_.js")).href).resolve("babel-plugin-react-compiler");
+    return createRequire5(pathToFileURL3(join26(pkgDir, "_.js")).href).resolve("babel-plugin-react-compiler");
   } catch {
     return null;
   }
@@ -14543,6 +14621,11 @@ var linkDepsJunction = async (link, depsDir) => {
     if (!existing.isSymbolicLink()) {
       return;
     }
+    try {
+      if (resolve7(dirname9(link), await readlink(link)) === resolve7(depsDir)) {
+        return;
+      }
+    } catch {}
     await rm2(link, { force: true });
   }
   await mkdir6(dirname9(link), { recursive: true });
@@ -14634,6 +14717,15 @@ var deploymentAdapterWarnings = (deployment, root) => {
   }
   return [];
 };
+var searchProviderWarnings = (provider, root, pkgDir = packageRoot()) => {
+  const warnings = [];
+  for (const dep of searchProviderMeta(provider).runtimeDeps) {
+    if (!(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))) {
+      warnings.push(`Search provider "${provider}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`);
+    }
+  }
+  return warnings;
+};
 var examplesCssFile = (root, config) => config.examples.css ? join26(root, config.examples.css) : null;
 var writeExamplesPreview = async (options) => {
   const { config, hasExamples, root, srcDir, write } = options;
@@ -14896,6 +14988,7 @@ var buildRuntimeData = (project) => {
       basePath: config.basePath,
       codeThemes: config.markdown.codeBlocks.theme,
       codeWrap: config.markdown.code.wrap,
+      dateFormat: config.dateFormat,
       description: config.description,
       favicon: resolveFavicon(project),
       feedback: config.feedback,
@@ -15038,6 +15131,7 @@ var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   }
   await write(join26(srcDir, "pages", "404.astro"), notFoundPageTemplate());
 };
+var diagnosticWarning = (diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message;
 var buildComponentSlots = async (componentsFile) => {
   const analysis = componentsFile ? analyzeComponentOverrides(await readFile14(componentsFile, "utf-8"), componentsFile) : null;
   return {
@@ -15046,6 +15140,7 @@ var buildComponentSlots = async (componentsFile) => {
     warnings: analysis ? analysis.warnings : []
   };
 };
+var contentWatchesRuntimeDir = (hasFilesystemSource, collectionBase, context) => hasFilesystemSource && runtimeDirWithin(collectionBase, context.outDir) !== null;
 var generateRuntime = async (project) => {
   const { context, config } = project;
   const out = context.outDir;
@@ -15106,6 +15201,7 @@ var generateRuntime = async (project) => {
   pages.push(...mcp.discoveryPages);
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
+  const docsCollection = resolveDocsCollection(config, context);
   const [structural] = await Promise.all([
     Promise.all([
       write(join26(out, "astro.config.mjs"), astroConfigTemplate({
@@ -15113,6 +15209,7 @@ var generateRuntime = async (project) => {
         askPath,
         config,
         contentRoutes: project.manifest.routes.map((route) => route.path),
+        contentWatchesRuntimeDir: contentWatchesRuntimeDir(hasFilesystemSource, docsCollection.base, context),
         context,
         dataPath,
         examplesPath,
@@ -15130,7 +15227,7 @@ var generateRuntime = async (project) => {
       write(join26(out, "tsconfig.json"), runtimeTsconfigTemplate()),
       write(join26(srcDir, "env.d.ts"), envTemplate()),
       write(join26(srcDir, "content.config.ts"), contentConfigTemplate({
-        collection: resolveDocsCollection(config, context),
+        collection: docsCollection,
         config,
         context,
         filesystem: hasFilesystemSource,
@@ -15234,18 +15331,12 @@ var generateRuntime = async (project) => {
   warnings.push(...[
     ...validateNavTargets(project.graph.navigation, navTargetRoutes),
     ...validateSearchPopularIcons(config.search.popular)
-  ].map((diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message));
+  ].map(diagnosticWarning));
   const knownComponentTags = new Set([
     ...islandDiscovery.islands.map((island) => island.name),
     ...overrideTags
   ]);
-  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map((diagnostic) => diagnostic.suggestion ? `${diagnostic.message} ${diagnostic.suggestion}` : diagnostic.message));
-  for (const dep of searchProviderMeta(config.search.provider).runtimeDeps) {
-    if (!(canResolveFrom(context.root, dep) || canResolveFrom(packageRoot(), dep))) {
-      warnings.push(`Search provider "${config.search.provider}" needs "${dep}", which isn't installed. Run \`npm install ${dep}\` (or your package manager's equivalent).`);
-    }
-  }
-  warnings.push(...deploymentAdapterWarnings(config.deployment, context.root), ...islandFrameworkWarnings(frameworks, context.root));
+  warnings.push(...validateUsedComponents(project.graph.pages, knownComponentTags, new Set(registry.map((item) => item.name))).map(diagnosticWarning), ...searchProviderWarnings(config.search.provider, context.root), ...deploymentAdapterWarnings(config.deployment, context.root), ...islandFrameworkWarnings(frameworks, context.root));
   if (hasScalarReferences(config)) {
     const references = await buildReferenceFiles({
       config,
@@ -15270,7 +15361,7 @@ var generateRuntime = async (project) => {
 
 // src/cli/env.ts
 import { existsSync as existsSync15, readFileSync as readFileSync10 } from "node:fs";
-import { dirname as dirname10, join as join27, resolve as resolve7 } from "pathe";
+import { dirname as dirname10, join as join27, resolve as resolve8 } from "pathe";
 var ENV_LINE = /^\s*(?:export\s+)?(?<key>[A-Za-z_][A-Za-z0-9_]*)\s*=\s*(?<value>.*?)\s*$/u;
 var DOUBLE_QUOTED2 = /^"(?<body>[\s\S]*)"$/u;
 var SINGLE_QUOTED = /^'(?<body>[\s\S]*)'$/u;
@@ -15322,7 +15413,7 @@ var loadFile = (path) => {
   } catch {}
 };
 var loadEnvFiles = (startDir) => {
-  let dir = resolve7(startDir);
+  let dir = resolve8(startDir);
   let done = false;
   while (!done) {
     loadFile(join27(dir, ".env.local"));
@@ -15764,6 +15855,7 @@ var checkCommand = defineCommand4({
 import { watch } from "node:fs";
 import { dev } from "astro";
 import { defineCommand as defineCommand5 } from "citty";
+import { basename as basename4, dirname as dirname11 } from "pathe";
 
 // src/astro/integration.ts
 var overlayServer = null;
@@ -15942,17 +16034,26 @@ var devCommand = defineCommand5({
     if (boundPort !== port) {
       runRegenerate();
     }
+    const dirTargets = [project.context.pagesRoot].filter((target) => target !== null);
     const fileTargets = [
-      project.context.pagesRoot,
       project.context.configFile,
       project.context.themeFile,
       project.context.componentsFile
     ].filter((target) => target !== null);
     const disposers = [
       ...project.sources.map((source) => source.watch?.(regenerate)),
-      ...fileTargets.map((target) => {
+      ...dirTargets.map((target) => {
         const watcher = watch(target, { recursive: true }, regenerate);
         return () => watcher.close();
+      }),
+      ...fileTargets.map((target) => {
+        const name = basename4(target);
+        const watcher = watch(dirname11(target), (_event, filename) => {
+          if (!filename || filename === name) {
+            regenerate();
+          }
+        });
+        return () => watcher.close();
       })
     ].filter((dispose) => dispose !== undefined);
     const shutdown = async () => {
@@ -16473,7 +16574,7 @@ var updatePackageScripts = async (root) => {
 // src/cli/init/scaffold.ts
 import { existsSync as existsSync19 } from "node:fs";
 import { mkdir as mkdir8, writeFile as writeFile11 } from "node:fs/promises";
-import { basename as basename4, dirname as dirname11, isAbsolute as isAbsolute9, join as join33, relative as relative15 } from "pathe";
+import { basename as basename5, dirname as dirname12, isAbsolute as isAbsolute9, join as join33, relative as relative15 } from "pathe";
 
 // src/core/package-json.ts
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
@@ -16683,7 +16784,7 @@ var extraDepsFor = (sources) => ({
 var buildPlan = (root, answers) => {
   const files = [
     {
-      content: blumePackageJson(toPackageName(basename4(root)), extraDepsFor(answers.sources)),
+      content: blumePackageJson(toPackageName(basename5(root)), extraDepsFor(answers.sources)),
       path: join33(root, "package.json")
     },
     { content: buildConfig(answers), path: join33(root, "blume.config.ts") }
@@ -16698,14 +16799,14 @@ var writeFileSafe = async (file, log) => {
     log.info(`Skipped existing ${file.path}`);
     return false;
   }
-  await mkdir8(dirname11(file.path), { recursive: true });
+  await mkdir8(dirname12(file.path), { recursive: true });
   await writeFile11(file.path, file.content, "utf-8");
   log.success(`Created ${file.path}`);
   return true;
 };
 var applyPlan = async (files, log) => {
   const created = await Promise.all(files.map((file) => writeFileSafe(file, log)));
-  const createdPackage = files.some((file, index) => created[index] && basename4(file.path) === "package.json");
+  const createdPackage = files.some((file, index) => created[index] && basename5(file.path) === "package.json");
   return { createdPackage };
 };
 var envVarsFor = (sources) => [
@@ -16792,10 +16893,10 @@ The blume package remains importable.`);
 // src/cli/commands/init.ts
 import * as clack from "@clack/prompts";
 import { defineCommand as defineCommand8 } from "citty";
-import { resolve as resolve9 } from "pathe";
+import { resolve as resolve10 } from "pathe";
 
 // src/cli/init/questions.ts
-import { basename as basename5, resolve as resolve8 } from "pathe";
+import { basename as basename6, resolve as resolve9 } from "pathe";
 var cancelled = (value) => typeof value === "symbol";
 var collectAnswers = async (prompter, flags, defaults) => {
   const directory = flags.directory ?? await prompter.text({
@@ -16806,9 +16907,9 @@ var collectAnswers = async (prompter, flags, defaults) => {
   if (cancelled(directory)) {
     return null;
   }
-  const root = resolve8(defaults.cwd, directory);
+  const root = resolve9(defaults.cwd, directory);
   const title = await prompter.text({
-    initialValue: titleize(basename5(root)),
+    initialValue: titleize(basename6(root)),
     message: "What's your docs site called?",
     validate: (value) => value?.trim() ? undefined : "Give your docs site a name."
   });
@@ -16975,7 +17076,7 @@ var initCommand = defineCommand8({
         title: "My Docs"
       };
     }
-    const root = resolve9(cwd, answers.directory);
+    const root = resolve10(cwd, answers.directory);
     if (validateContentDir(root, answers.contentDir) !== undefined) {
       logger.error(`Invalid --content-dir "${answers.contentDir}" (must be a path inside the project).`);
       process.exit(1);
@@ -17082,7 +17183,7 @@ import { join as join37 } from "pathe";
 
 // src/core/links.ts
 import { existsSync as existsSync21 } from "node:fs";
-import { basename as basename6, join as join36 } from "pathe";
+import { basename as basename7, join as join36 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -17097,7 +17198,7 @@ var DOC_EXT = /\.(?:md|mdx)$/iu;
 var FILE_EXT = /\.[a-z0-9]+$/iu;
 var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync21(join36(ctx.publicDir, resolved));
 var NUMERIC_PREFIX3 = /^\d+[-_.]/u;
-var isIndexPage = (page2) => /^index\.(?:md|mdx)$/iu.test(basename6(page2.navPath).replace(NUMERIC_PREFIX3, ""));
+var isIndexPage = (page2) => /^index\.(?:md|mdx)$/iu.test(basename7(page2.navPath).replace(NUMERIC_PREFIX3, ""));
 var applyRelativePart = (segments, part) => {
   if (part === "" || part === ".") {
     return;
@@ -17373,5 +17474,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=74F150F28E9B859A64756E2164756E21
+//# debugId=5D342B2E16EE6E0464756E2164756E21
 //# sourceMappingURL=index.js.map