blume 1.1.2 → 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))) {
@@ -3106,6 +3118,7 @@ var referencesFor = (kind, block, defaultLabel, renderer, display, basePath) =>
       label,
       renderer,
       route,
+      scalar: block.scalar,
       slug: routeSlug(route),
       spec: source.spec,
       theme: block.theme
@@ -3467,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 {
@@ -3553,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";
@@ -3627,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;
@@ -3650,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,
@@ -4327,6 +4343,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   page={{ title: seo.title ?? title, description: seo.description ?? frontmatter.description, route }}
   headings={headings}
   toc={data.config.toc}
+  dateFormat={data.config.dateFormat}
   themeMode={data.config.theme.mode}
   fontCssVars={data.fontCssVars}
   searchEnabled={data.config.search.enabled}
@@ -4365,6 +4382,7 @@ import RootLayout from "blume/components/layout/RootLayout.astro";
 import Update from "blume/components/content/Update.astro";
 import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
+import { resolveDateFormatOptions } from "blume/core/date-format.ts";
 import { layoutOverrides } from "../generated/components.ts";
 import data from "blume:data";
 
@@ -4392,8 +4410,9 @@ const localeMeta = i18n
 const dir = localeMeta?.dir ?? "ltr";
 const htmlLang = i18n ? i18n.defaultLocale : "en";
 
-// Formatted in the same locale as the chrome, and in UTC, to match the
-// per-page "last updated" stamp.
+// Formatted in the same locale as the chrome, and with the configured
+// \`dateFormat\` (UTC by default), to match the per-page "last updated" stamp.
+const dateFormatOptions = resolveDateFormatOptions(data.config.dateFormat);
 const formatDate = (value: string | null | undefined) => {
   if (!value) {
     return;
@@ -4401,10 +4420,7 @@ const formatDate = (value: string | null | undefined) => {
   const date = new Date(value);
   return Number.isNaN(date.getTime())
     ? undefined
-    : new Intl.DateTimeFormat(htmlLang, {
-        dateStyle: "long",
-        timeZone: "UTC",
-      }).format(date);
+    : new Intl.DateTimeFormat(htmlLang, dateFormatOptions).format(date);
 };
 
 const slugify = (text: string) =>
@@ -5124,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) {
@@ -5139,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 {
@@ -5221,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
   });
@@ -5239,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),
@@ -7994,6 +8019,19 @@ var lastModifiedConfigSchema = z2.union([
   z2.boolean(),
   z2.strictObject({ type: z2.enum(["git", "frontmatter"]).default("git") })
 ]);
+var dateFormatConfigSchema = z2.strictObject({
+  calendar: z2.string().optional(),
+  dateStyle: z2.enum(["full", "long", "medium", "short"]).optional(),
+  day: z2.enum(["numeric", "2-digit"]).optional(),
+  era: z2.enum(["long", "short", "narrow"]).optional(),
+  month: z2.enum(["numeric", "2-digit", "long", "short", "narrow"]).optional(),
+  numberingSystem: z2.string().optional(),
+  timeZone: z2.string().optional(),
+  weekday: z2.enum(["long", "short", "narrow"]).optional(),
+  year: z2.enum(["numeric", "2-digit"]).optional()
+}).refine((value) => value.dateStyle === undefined || value.weekday === undefined && value.era === undefined && value.year === undefined && value.month === undefined && value.day === undefined, {
+  message: "dateFormat.dateStyle can't be combined with weekday/era/year/month/day; use one or the other."
+});
 var codeConfigSchema = z2.strictObject({
   icons: z2.boolean().default(true),
   wrap: z2.boolean().default(false)
@@ -8012,12 +8050,14 @@ var openapiSourceSchema = z2.strictObject({
   route: z2.string().optional(),
   spec: z2.string()
 });
+var scalarConfigSchema = z2.record(z2.string(), z2.unknown()).optional();
 var openapiConfigSchema = z2.strictObject({
   codeSamples: z2.array(z2.string()).default(["curl", "js", "python"]),
   enabled: z2.boolean().default(false),
   expandSchemas: z2.boolean().default(false),
   renderer: z2.enum(["blume", "scalar"]).default("blume"),
   route: z2.string().default("/reference"),
+  scalar: scalarConfigSchema,
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
@@ -8025,6 +8065,7 @@ var openapiConfigSchema = z2.strictObject({
 var asyncapiConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(false),
   route: z2.string().default("/events"),
+  scalar: scalarConfigSchema,
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
@@ -8069,6 +8110,7 @@ var blumeConfigSchema = z2.strictObject({
   banner: bannerConfigSchema.optional(),
   basePath: z2.string().optional().transform((value) => normalizeBasePath(value)),
   content: contentConfigSchema.default({}),
+  dateFormat: dateFormatConfigSchema.default({ dateStyle: "long" }),
   deployment: deploymentConfigSchema.default({}),
   description: z2.string().optional(),
   examples: examplesConfigSchema.default("examples"),
@@ -8173,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") {
@@ -8655,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) => {
@@ -8862,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 : "",
@@ -9158,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 === "") {
@@ -9187,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;
@@ -9209,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);
 };
@@ -9288,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) {
@@ -9301,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;
 };
@@ -9580,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 = [];
@@ -9587,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) {
@@ -9602,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);
@@ -9629,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 };
 };
@@ -9779,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 = "";
@@ -10399,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;
@@ -10418,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);
@@ -10444,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);
@@ -10679,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) => {
@@ -10886,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"));
@@ -11246,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: {
@@ -11351,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);
@@ -11734,6 +11829,22 @@ var youtube = ({ props }) => {
   const title = typeof props.title === "string" && props.title !== "" ? props.title : "Watch on YouTube";
   return `[${title}](https://www.youtube.com/watch?v=${videoId}${start})`;
 };
+var fencedBlock = (lang, code) => {
+  const trimmed = code.replace(/(?<!\n)\n+$/u, "");
+  const runs = trimmed.match(/`+/gu);
+  const longest = runs ? Math.max(...runs.map((run) => run.length)) : 0;
+  const fence = "`".repeat(Math.max(3, longest + 1));
+  return `${fence}${lang}
+${trimmed}
+${fence}`;
+};
+var exampleComponentSerializers = (examples) => ({
+  Component: ({ props }) => {
+    const path = typeof props.path === "string" ? props.path : undefined;
+    const example = path === undefined ? undefined : examples[path];
+    return example ? fencedBlock(example.lang, example.source) : null;
+  }
+});
 var SERIALIZERS = {
   Callout: callout,
   Steps: steps,
@@ -11929,10 +12040,14 @@ var buildIndex = (project) => {
 var buildFull = async (project) => {
   const { config } = project;
   const pages = eligiblePages(project).toSorted((a, b) => a.route.localeCompare(b.route));
+  const components = {
+    ...exampleComponentSerializers(project.examples ?? {}),
+    ...config.ai.markdownComponents
+  };
   const sections = await Promise.all(pages.map(async (page) => {
     const raw = await readEntryText(project, page);
     const parsed = frontmatter_default(raw);
-    const body = downlevelComponents(applyAgentVisibility(parsed.content), config.ai.markdownComponents, parsed.data).trim();
+    const body = downlevelComponents(applyAgentVisibility(parsed.content), components, parsed.data).trim();
     const url = pageUrl(page.route, config.deployment.site, normalizeBasePath(config.deployment.base));
     return [`# ${page.title}`, `Source: ${url}`, "", body].join(`
 `);
@@ -12539,6 +12654,7 @@ import {
   lstat,
   mkdir as mkdir6,
   readFile as readFile14,
+  readlink,
   realpath,
   rename,
   rm as rm2,
@@ -12547,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
@@ -12574,6 +12690,10 @@ import { readFile as readFile10 } from "node:fs/promises";
 var agentMarkdown = (entry) => entry.md ?? entry.mdx;
 var buildRawMarkdown = async (project) => {
   const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
+  const components = {
+    ...exampleComponentSerializers(project.examples ?? {}),
+    ...project.config.ai.markdownComponents
+  };
   const readRoute = async (route) => {
     const page = pageById.get(route.id);
     if (page) {
@@ -12583,7 +12703,7 @@ var buildRawMarkdown = async (project) => {
   };
   const entries = await Promise.all(project.manifest.routes.map(async (route) => {
     const source = applyAgentVisibility(await readRoute(route));
-    const md = downlevelComponents(source, project.config.ai.markdownComponents, frontmatter_default(source).data);
+    const md = downlevelComponents(source, components, frontmatter_default(source).data);
     const entry = md === source ? { mdx: source } : { md, mdx: source };
     return [route.path, entry];
   }));
@@ -13351,7 +13471,8 @@ var buildReferenceFiles = async (options) => {
       content: scalarReferenceTemplate({
         configuration: {
           ...spec.config,
-          ...themeConfiguration(config, ref.theme)
+          ...themeConfiguration(config, ref.theme),
+          ...ref.scalar
         },
         dataImport: `${"../".repeat(depth + 1)}generated/data.json`,
         route: ref.route,
@@ -13582,6 +13703,13 @@ ${THEME_MAPPING}
   letter-spacing: 0;
 }
 
+/* A heading can carry one long unbreakable token — an OpenAPI operation's title
+   is \`METHOD /very/long/{path}\` when the spec sets no summary — which would run
+   off the content column. Break it across lines instead of overflowing. */
+.prose :where(h1, h2, h3, h4, h5, h6) {
+  overflow-wrap: break-word;
+}
+
 .prose :where(h1) {
   font-size: 3rem;
   line-height: 1.1;
@@ -14132,6 +14260,16 @@ var OVERRIDES = `
   padding-right: 1.25rem;
 }
 
+/* Twoslash blocks keep \`overflow: visible\` so popups can escape, which means
+   long lines can't scroll — they'd push past the viewport on narrow screens.
+   Wrap them on mobile instead; hover popups still position against the token. */
+@media (max-width: 640px) {
+  .prose pre.twoslash code {
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+  }
+}
+
 /* The rich renderer renders each popup's type signature as a nested Shiki
    pre. Strip the code-block chrome (border, radius, padding, background) so it
    sits flush inside the popup, which owns the frame. */
@@ -14410,6 +14548,10 @@ var discoverExamples = async (root, pattern = "examples") => {
   }
   return { examples, warnings };
 };
+var exampleMarkdownLookup = (examples) => Object.fromEntries(examples.map((example) => [
+  example.path,
+  { lang: example.lang, source: example.source }
+]));
 
 // src/astro/generate.ts
 var BLUME_SRC = join26(packageRoot(), "src");
@@ -14421,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;
   }
@@ -14441,12 +14583,13 @@ var resolveAstroPackageJson = (modulesDir) => {
     return null;
   }
 };
-var resolvedAstroPath = (fromDir) => {
+var resolvedAstroHit = (fromDir) => {
   let dir = normalize3(fromDir);
   while (true) {
-    const resolved = resolveAstroPackageJson(join26(dir, "node_modules"));
-    if (resolved) {
-      return resolved;
+    const modulesDir = join26(dir, "node_modules");
+    const pkg = resolveAstroPackageJson(modulesDir);
+    if (pkg) {
+      return { modulesDir, pkg };
     }
     const parent = dirname9(dir);
     if (parent === dir) {
@@ -14455,6 +14598,13 @@ var resolvedAstroPath = (fromDir) => {
     dir = parent;
   }
 };
+var sameRealDir = (a, b) => {
+  try {
+    return realpathSync(a) === realpathSync(b);
+  } catch {
+    return false;
+  }
+};
 var depsCandidates = (pkgDir) => [
   join26(pkgDir, "node_modules"),
   dirname9(pkgDir)
@@ -14471,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 });
@@ -14523,16 +14678,17 @@ var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
   const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
   const blumeAstro = resolveAstroPackageJson(astroDir);
   await dropStaleDepsLink(join26(outDir, "node_modules"), pkgDir);
-  const outDirAstro = resolvedAstroPath(outDir);
-  const astroCorrect = blumeAstro !== null && outDirAstro === blumeAstro;
-  if (astroCorrect && mdxDir === astroDir) {
+  const outDirHit = resolvedAstroHit(outDir);
+  const astroCorrect = blumeAstro !== null && outDirHit?.pkg === blumeAstro;
+  const walkLandsInDeps = astroCorrect && outDirHit !== null && sameRealDir(outDirHit.modulesDir, astroDir);
+  if (walkLandsInDeps && mdxDir === astroDir) {
     return null;
   }
   if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
     await linkDepsJunction(join26(outDir, "node_modules"), mdxDir);
     return null;
   }
-  return astroConflictWarning(blumeAstro, outDirAstro);
+  return astroConflictWarning(blumeAstro, outDirHit?.pkg ?? null);
 };
 var ISLAND_FRAMEWORK_DEPS = {
   svelte: "@astrojs/svelte",
@@ -14561,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;
@@ -14823,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,
@@ -14965,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 {
@@ -14973,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;
@@ -15018,6 +15186,7 @@ var generateRuntime = async (project) => {
     tags: overrideTags,
     warnings: overrideWarnings
   } = componentSlots;
+  project.examples = exampleMarkdownLookup(exampleDiscovery.examples);
   const frameworks = new Set([
     ...islandDiscovery.islands.map((island) => island.framework),
     ...exampleDiscovery.examples.map((example) => example.framework),
@@ -15032,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({
@@ -15039,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,
@@ -15056,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,
@@ -15160,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,
@@ -15196,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;
@@ -15248,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"));
@@ -15690,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;
@@ -15868,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 () => {
@@ -16112,6 +16287,8 @@ var eject = async (root) => {
   const askEnabled = config.ai.ask?.enabled ?? false;
   const exportPdf = config.export.pdf;
   const exportEpub = config.export.epub;
+  const examples = await discoverExamples(root, config.examples.source);
+  project.examples = exampleMarkdownLookup(examples.examples);
   const [
     pages,
     needsReactRaw,
@@ -16119,8 +16296,7 @@ var eject = async (root) => {
     userTheme,
     userExamplesCss,
     rawMarkdown,
-    islands,
-    examples
+    islands
   ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(root),
@@ -16128,8 +16304,7 @@ var eject = async (root) => {
     context.themeFile ? readFile15(context.themeFile, "utf-8") : Promise.resolve(""),
     readExamplesCss(root, config.examples.css),
     buildRawMarkdown(project),
-    discoverIslands(root),
-    discoverExamples(root, config.examples.source)
+    discoverIslands(root)
   ]);
   const frameworks = new Set([
     ...islands.islands.map((island) => island.framework),
@@ -16399,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";
@@ -16609,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") }
@@ -16624,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) => [
@@ -16718,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({
@@ -16732,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."
   });
@@ -16901,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);
@@ -17008,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;
@@ -17023,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;
@@ -17299,5 +17474,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=7D02660AA9B8797064756E2164756E21
+//# debugId=5D342B2E16EE6E0464756E2164756E21
 //# sourceMappingURL=index.js.map