blume 1.7.0 → 1.7.2

package/dist/cli/index.js

@@ -1,26 +1,165 @@
 #!/usr/bin/env node
-import {
-  normalizeHostArgs
-} from "./chunk-bcy492zc.js";
-import {
-  reportInternalError
-} from "./chunk-btfr9yvw.js";
-import {
-  loadEnvFiles
-} from "./chunk-vt8fgygt.js";
-import {
-  getBlumeVersion
-} from "./chunk-4xyggvgf.js";
-import"./chunk-6kzzpsx8.js";
-import"./chunk-ey89bjj1.js";
-import {
-  __require,
-  commandMeta
-} from "./chunk-2aj8ddew.js";
 
 // src/cli/index.ts
 import { defineCommand, runMain } from "citty";
 
+// src/core/version.ts
+import { readFileSync } from "node:fs";
+import { join as join2 } from "pathe";
+
+// src/core/package-root.ts
+import { existsSync } from "node:fs";
+import { dirname, join } from "pathe";
+var findPackageRoot = (start) => {
+  let dir = start;
+  while (!existsSync(join(dir, "package.json"))) {
+    const parent = dirname(dir);
+    if (parent === dir) {
+      throw new Error("blume: unable to locate the package root");
+    }
+    dir = parent;
+  }
+  return dir;
+};
+var cached;
+var packageRoot = () => {
+  cached ??= findPackageRoot(import.meta.dirname);
+  return cached;
+};
+
+// src/core/version.ts
+var cached2;
+var getBlumeVersion = () => {
+  if (cached2 === undefined) {
+    const pkgPath = join2(packageRoot(), "package.json");
+    cached2 = JSON.parse(readFileSync(pkgPath, "utf-8")).version;
+  }
+  return cached2;
+};
+
+// src/cli/command-meta.ts
+var commandMeta = {
+  add: {
+    description: "Install a source component or template from the registry.",
+    name: "add"
+  },
+  audit: {
+    description: "Audit the built site for SEO and site-health issues.",
+    name: "audit"
+  },
+  build: {
+    description: "Build the docs site for production.",
+    name: "build"
+  },
+  check: {
+    description: "Type-check the docs site with astro check.",
+    name: "check"
+  },
+  dev: {
+    description: "Start the Blume development server.",
+    name: "dev"
+  },
+  doctor: {
+    description: "Diagnose common configuration and content problems.",
+    name: "doctor"
+  },
+  eject: {
+    description: "Promote the generated runtime into an owned Astro project.",
+    name: "eject"
+  },
+  eval: {
+    description: "Test the docs: an agent answers your questions using only the documentation.",
+    name: "eval"
+  },
+  init: {
+    description: "Scaffold a minimal Blume project.",
+    name: "init"
+  },
+  "mcp-stdio": {
+    description: "Serve an MCP data snapshot over stdio (internal, used by `blume eval`).",
+    name: "mcp-stdio"
+  },
+  preview: {
+    description: "Preview the last production build.",
+    name: "preview"
+  },
+  sync: {
+    description: "Re-fetch remote content sources and regenerate the runtime.",
+    name: "sync"
+  },
+  translate: {
+    description: "Translate docs into the configured locales with a local agent CLI.",
+    name: "translate"
+  },
+  validate: {
+    description: "Validate internal, anchor, asset, and external links.",
+    name: "validate"
+  },
+  version: {
+    description: "Freeze the current docs as an archived version.",
+    name: "version"
+  }
+};
+
+// src/cli/env.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { config } from "dotenv";
+import { dirname as dirname2, join as join3, resolve } from "pathe";
+var loadEnvFiles = (startDir) => {
+  const paths = [];
+  let dir = resolve(startDir);
+  let done = false;
+  while (!done) {
+    paths.push(join3(dir, ".env.local"), join3(dir, ".env"));
+    const parent = dirname2(dir);
+    done = existsSync2(join3(dir, ".git")) || parent === dir;
+    dir = parent;
+  }
+  config({ path: paths, quiet: true });
+};
+
+// src/cli/host-args.ts
+var normalizeHostArgs = (rawArgs) => rawArgs.map((arg, index) => {
+  if (arg !== "--host") {
+    return arg;
+  }
+  const next = rawArgs[index + 1];
+  return next === undefined || next.startsWith("-") ? "--host=" : arg;
+});
+var normalizeHost = (host) => host === "" ? true : host ?? false;
+
+// src/cli/internal-error.ts
+import { colors } from "consola/utils";
+var ISSUES_URL = "https://github.com/haydenbleasel/blume/issues";
+var BLUME_FRAME = /(?<abs>(?:\/[^\s()]*\/|[A-Za-z]:\\[^\s()]*\\)\.blume[/\\][^\s()]*)/gu;
+var BLUME_MARKER = /[/\\]\.blume[/\\]/u;
+var remapBlumeStack = (stack) => stack.replaceAll(BLUME_FRAME, (match) => {
+  const marker = match.search(BLUME_MARKER);
+  return `${match.slice(marker + 1)} (generated)`;
+});
+var reportInternalError = (error) => {
+  const err = error instanceof Error ? error : new Error(String(error));
+  const lines = [
+    `${colors.red(colors.bold("BLUME_INTERNAL"))} An unexpected error occurred.`,
+    `  ${err.message}`
+  ];
+  const stack = remapBlumeStack(err.stack ?? "").split(`
+`).slice(1, 5).map((line) => line.trim()).filter(Boolean);
+  if (stack.length > 0) {
+    lines.push("", colors.dim(stack.join(`
+`)));
+  }
+  lines.push("", "This is likely a bug in Blume. Please report it with the details below:", colors.dim([
+    `  Blume:    ${getBlumeVersion()}`,
+    `  Node:     ${process.version}`,
+    `  Platform: ${process.platform} ${process.arch}`
+  ].join(`
+`)), `  ${ISSUES_URL}`);
+  process.stderr.write(`${lines.join(`
+`)}
+`);
+};
+
 // src/cli/lazy-command.ts
 var lazyCommand = (meta, load, key) => {
   const command = async () => {
@@ -48,6 +187,211 @@ var lazyCommand = (meta, load, key) => {
   };
 };
 
+// src/cli/log.ts
+import { consola } from "consola";
+import { relative as relative2 } from "pathe";
+
+// src/core/diagnostics.ts
+import { colors as colors2 } from "consola/utils";
+import { relative } from "pathe";
+
+class BlumeError extends Error {
+  diagnostic;
+  constructor(diagnostic) {
+    super(diagnostic.message);
+    this.name = "BlumeError";
+    this.diagnostic = diagnostic;
+  }
+}
+var DOCS_BASE = "https://useblume.dev";
+var DOCS_DEPLOYMENT = "/docs/deployment";
+var DOCS_REFERENCE_CLI = "/docs/reference/cli";
+var DOCS_CONTENT_SOURCES = "/docs/content/sources";
+var DOCS_CONTENT_NAVIGATION = "/docs/content/navigation";
+var DOCS_CONTENT_INCLUDES = "/docs/content/includes";
+var DOCS_PATHS = new Map(Object.entries({
+  BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,
+  BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,
+  BLUME_CONFIG_INVALID: "/docs/configuration",
+  BLUME_CONFIG_LOAD_FAILED: "/docs/configuration",
+  BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,
+  BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,
+  BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,
+  BLUME_FRONTMATTER_INVALID: "/docs/reference/frontmatter",
+  BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,
+  BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,
+  BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,
+  BLUME_MDX_CURLY_ANCHOR: "/docs/content/syntax",
+  BLUME_META_INVALID: "/docs/content/meta",
+  BLUME_META_LOAD_FAILED: "/docs/content/meta",
+  BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,
+  BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_INDEX_TITLE_MISMATCH: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,
+  BLUME_NODE_VERSION: "/docs/quickstart",
+  BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_SIDEBAR_DISPLAY_IGNORED: DOCS_CONTENT_NAVIGATION,
+  BLUME_SOURCE_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_MISCONFIGURED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,
+  BLUME_UNKNOWN_COMPONENT: "/docs/configuration/customization",
+  BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,
+  BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES,
+  BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES
+}));
+var resolveDocsUrl = (code) => {
+  const path = DOCS_PATHS.get(code);
+  return path ? `${DOCS_BASE}${path}` : undefined;
+};
+var enrichDiagnostic = (diagnostic) => diagnostic.docsUrl ? diagnostic : { ...diagnostic, docsUrl: resolveDocsUrl(diagnostic.code) };
+var REGEXP_SPECIAL = /[$()*+.?[\\\]^{|}]/gu;
+var escapeRegExp = (value) => value.replaceAll(REGEXP_SPECIAL, String.raw`\$&`);
+var isKeySegment = (segment) => typeof segment === "string";
+var stepSegment = (source, segment, cursor) => {
+  if (!isKeySegment(segment)) {
+    return { index: -1, next: cursor, stop: false };
+  }
+  const matcher = new RegExp(`(?<![\\w$])${escapeRegExp(segment)}\\s*[:=]`, "gu");
+  matcher.lastIndex = cursor;
+  const match = matcher.exec(source);
+  if (!match) {
+    return { index: -1, next: cursor, stop: true };
+  }
+  return { index: match.index, next: matcher.lastIndex, stop: false };
+};
+var locatePath = (source, path) => {
+  let cursor = 0;
+  let found = -1;
+  for (const segment of path) {
+    const step = stepSegment(source, segment, cursor);
+    if (step.stop) {
+      break;
+    }
+    cursor = step.next;
+    if (step.index >= 0) {
+      found = step.index;
+    }
+  }
+  if (found < 0) {
+    return;
+  }
+  const before = source.slice(0, found);
+  const lastNewline = before.lastIndexOf(`
+`);
+  return { column: found - lastNewline, line: before.split(`
+`).length };
+};
+var FRONTMATTER = /^---\r?\n(?<body>[\s\S]*?)\r?\n---/u;
+var locateFrontmatterKey = (source, path) => {
+  const block = FRONTMATTER.exec(source);
+  if (!block) {
+    return;
+  }
+  const position = locatePath(block.groups?.body ?? "", path);
+  return position && { column: position.column, line: position.line + 1 };
+};
+var diagnosticsFromIssues = (issues, options) => issues.map((issue) => {
+  const schemaPath = issue.path.join(".");
+  const position = options.source ? locatePath(options.source, issue.path) : undefined;
+  return {
+    code: options.code,
+    column: position?.column,
+    file: options.file,
+    line: position?.line,
+    message: schemaPath ? `${schemaPath}: ${issue.message}` : issue.message,
+    schemaPath: schemaPath || undefined,
+    severity: "error"
+  };
+});
+var diagnosticsFromZod = (error, options) => diagnosticsFromIssues(error.issues.map((issue) => ({
+  message: issue.message,
+  path: issue.path.filter((segment) => typeof segment !== "symbol")
+})), options);
+var severityColor = (severity) => {
+  if (severity === "error") {
+    return colors2.red;
+  }
+  if (severity === "warning") {
+    return colors2.yellow;
+  }
+  return colors2.blue;
+};
+var formatDiagnostic = (diagnostic, root) => {
+  const color = severityColor(diagnostic.severity);
+  const lines = [
+    `${color(colors2.bold(diagnostic.code))} ${diagnostic.message}`
+  ];
+  if (diagnostic.url) {
+    lines.push(`  ${colors2.dim(`at ${diagnostic.url}`)}`);
+  }
+  if (diagnostic.file) {
+    const location = root ? relative(root, diagnostic.file) : diagnostic.file;
+    const column = diagnostic.column === undefined ? "" : `:${diagnostic.column}`;
+    const position = diagnostic.line === undefined ? "" : `:${diagnostic.line}${column}`;
+    const label = diagnostic.url ? "in" : "at";
+    lines.push(`  ${colors2.dim(`${label} ${location}${position}`)}`);
+  }
+  if (diagnostic.suggestion) {
+    lines.push(`  ${colors2.cyan(`fix: ${diagnostic.suggestion}`)}`);
+  }
+  if (diagnostic.docsUrl) {
+    lines.push(`  ${colors2.dim(`docs: ${diagnostic.docsUrl}`)}`);
+  }
+  return lines.join(`
+`);
+};
+var hasErrors = (diagnostics) => diagnostics.some((d) => d.severity === "error");
+var countBySeverity = (diagnostics) => {
+  const counts = { error: 0, info: 0, warning: 0 };
+  for (const diagnostic of diagnostics) {
+    counts[diagnostic.severity] += 1;
+  }
+  return counts;
+};
+
+// src/cli/log.ts
+var logger = consola.withTag("blume");
+var flushStdout = () => new Promise((resolve) => {
+  process.stdout.write("", () => resolve());
+});
+var reportDiagnosticsJson = (diagnostics, root) => {
+  const enriched = diagnostics.map((diagnostic) => {
+    const withDocs = enrichDiagnostic(diagnostic);
+    return withDocs.file && root ? { ...withDocs, file: relative2(root, withDocs.file) } : withDocs;
+  });
+  process.stdout.write(`${JSON.stringify({ diagnostics: enriched, summary: countBySeverity(diagnostics) }, null, 2)}
+`);
+  return hasErrors(diagnostics);
+};
+var reportDiagnostics = (diagnostics, root) => {
+  if (diagnostics.length === 0) {
+    return false;
+  }
+  for (const diagnostic of diagnostics) {
+    process.stderr.write(`${formatDiagnostic(enrichDiagnostic(diagnostic), root)}
+`);
+  }
+  const counts = countBySeverity(diagnostics);
+  const summary = [
+    counts.error ? `${counts.error} error(s)` : null,
+    counts.warning ? `${counts.warning} warning(s)` : null
+  ].filter(Boolean).join(", ");
+  if (summary) {
+    process.stderr.write(`
+${summary}
+`);
+  }
+  return hasErrors(diagnostics);
+};
+
 // src/cli/index.ts
 var main = defineCommand({
   meta: {
@@ -56,21 +400,21 @@ var main = defineCommand({
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-4trphnvy.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-cfw6x4rm.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-v2ymm99c.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-18tjv4f7.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-9qs6acpw.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-tnskyrej.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-jxkxjsc1.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-y3g15rvv.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-drke6t0h.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-jtb45atp.js"), "mcpStdioCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-zr3ygrq3.js"), "previewCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-kwx90v78.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-qq9nm3qd.js"), "translateCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-jk1zwka1.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-ckh3a410.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-3w7b2vcx.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-8cd8tj54.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-fmceyezb.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-xhtpx3ff.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-12dxjqk7.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-30e87n55.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-mqb2ka8m.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-t3tj0dgr.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-mt76t7dj.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-n9sra6sy.js"), "mcpStdioCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-hs3gbh8p.js"), "previewCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-eevwt1sc.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-9he6crym.js"), "translateCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-aztttvb3.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-cvky9gb2.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());
@@ -83,6 +427,25 @@ process.on("unhandledRejection", (error) => {
   process.exit(1);
 });
 runMain(main, { rawArgs: normalizeHostArgs(process.argv.slice(2)) });
+export {
+  packageRoot,
+  getBlumeVersion,
+  commandMeta,
+  loadEnvFiles,
+  normalizeHost,
+  reportInternalError,
+  BlumeError,
+  enrichDiagnostic,
+  locateFrontmatterKey,
+  diagnosticsFromIssues,
+  diagnosticsFromZod,
+  hasErrors,
+  countBySeverity,
+  logger,
+  flushStdout,
+  reportDiagnosticsJson,
+  reportDiagnostics
+};
 
-//# debugId=1D180DF0EF7A648564756E2164756E21
+//# debugId=3D851F7CCD64619664756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1,11 +1,19 @@
 {
   "version": 3,
-  "sources": ["../src/cli/index.ts", "../src/cli/lazy-command.ts"],
+  "sources": ["../src/cli/index.ts", "../src/core/version.ts", "../src/core/package-root.ts", "../src/cli/command-meta.ts", "../src/cli/env.ts", "../src/cli/host-args.ts", "../src/cli/internal-error.ts", "../src/cli/lazy-command.ts", "../src/cli/log.ts", "../src/core/diagnostics.ts"],
   "sourcesContent": [
     "import { defineCommand, runMain } from \"citty\";\n\nimport { getBlumeVersion } from \"../core/version.ts\";\nimport { commandMeta } from \"./command-meta.ts\";\nimport { loadEnvFiles } from \"./env.ts\";\nimport { normalizeHostArgs } from \"./host-args.ts\";\nimport { reportInternalError } from \"./internal-error.ts\";\nimport { lazyCommand } from \"./lazy-command.ts\";\n// consola reads CONSOLA_LEVEL / NODE_ENV / TEST / CI / DEBUG when its module\n// evaluates. Import the logger here, ahead of `loadEnvFiles`, so those values\n// come from the real environment — never from a project `.env`, which would\n// otherwise silence or restyle every command's output. The commands are loaded\n// lazily below, so without this line consola would first evaluate after `.env`\n// had been applied.\nimport \"./log.ts\";\n\nconst main = defineCommand({\n  meta: {\n    description: \"Markdown-first documentation powered by Astro and Vite.\",\n    name: \"blume\",\n    version: getBlumeVersion(),\n  },\n  subCommands: {\n    add: lazyCommand(\n      commandMeta.add,\n      () => import(\"./commands/add.ts\"),\n      \"addCommand\"\n    ),\n    audit: lazyCommand(\n      commandMeta.audit,\n      () => import(\"./commands/audit.ts\"),\n      \"auditCommand\"\n    ),\n    build: lazyCommand(\n      commandMeta.build,\n      () => import(\"./commands/build.ts\"),\n      \"buildCommand\"\n    ),\n    check: lazyCommand(\n      commandMeta.check,\n      () => import(\"./commands/check.ts\"),\n      \"checkCommand\"\n    ),\n    dev: lazyCommand(\n      commandMeta.dev,\n      () => import(\"./commands/dev.ts\"),\n      \"devCommand\"\n    ),\n    doctor: lazyCommand(\n      commandMeta.doctor,\n      () => import(\"./commands/doctor.ts\"),\n      \"doctorCommand\"\n    ),\n    eject: lazyCommand(\n      commandMeta.eject,\n      () => import(\"./commands/eject.ts\"),\n      \"ejectCommand\"\n    ),\n    eval: lazyCommand(\n      commandMeta.eval,\n      () => import(\"./commands/eval.ts\"),\n      \"evalCommand\"\n    ),\n    init: lazyCommand(\n      commandMeta.init,\n      () => import(\"./commands/init.ts\"),\n      \"initCommand\"\n    ),\n    \"mcp-stdio\": lazyCommand(\n      commandMeta[\"mcp-stdio\"],\n      () => import(\"./commands/mcp-stdio.ts\"),\n      \"mcpStdioCommand\"\n    ),\n    preview: lazyCommand(\n      commandMeta.preview,\n      () => import(\"./commands/preview.ts\"),\n      \"previewCommand\"\n    ),\n    sync: lazyCommand(\n      commandMeta.sync,\n      () => import(\"./commands/sync.ts\"),\n      \"syncCommand\"\n    ),\n    translate: lazyCommand(\n      commandMeta.translate,\n      () => import(\"./commands/translate.ts\"),\n      \"translateCommand\"\n    ),\n    validate: lazyCommand(\n      commandMeta.validate,\n      () => import(\"./commands/validate.ts\"),\n      \"validateCommand\"\n    ),\n    version: lazyCommand(\n      commandMeta.version,\n      () => import(\"./commands/version.ts\"),\n      \"versionCommand\"\n    ),\n  },\n});\n\nloadEnvFiles(process.cwd());\n\nprocess.on(\"uncaughtException\", (error) => {\n  reportInternalError(error);\n  process.exit(1);\n});\nprocess.on(\"unhandledRejection\", (error) => {\n  reportInternalError(error);\n  process.exit(1);\n});\n\nrunMain(main, { rawArgs: normalizeHostArgs(process.argv.slice(2)) });\n",
-    "import type { ArgsDef, CommandDef, CommandMeta } from \"citty\";\n\n/**\n * Wrap a command so its module is imported only when citty needs its `args`\n * or runs it. `meta` stays static (from `command-meta.ts`), so rendering root\n * usage, matching an unknown name, and `blume <cmd> --help` for *another*\n * command never touch this one's dependency graph.\n *\n * `load` imports the command's module and `key` names its export, so the call\n * site stays a plain `() => import(\"./commands/x.ts\")`.\n *\n * Only `args`, `setup`, `run`, and `cleanup` are forwarded: no Blume command\n * declares `default`, `plugins`, or nested `subCommands`.\n */\nexport const lazyCommand = <Args extends ArgsDef, Key extends string>(\n  meta: CommandMeta,\n  load: () => Promise<Record<Key, CommandDef<Args>>>,\n  key: Key\n): CommandDef<Args> => {\n  const command = async () => {\n    const module = await load();\n    return module[key];\n  };\n  return {\n    args: async () => {\n      const { args } = await command();\n      // SAFETY: every Blume command passes `args` to `defineCommand` as a plain\n      // object literal (the \"command registry\" test checks it); citty's\n      // `Resolvable` widening is the only reason the type also admits a thunk\n      // or a promise here.\n      return args as Args;\n    },\n    cleanup: async (context) => {\n      const loaded = await command();\n      await loaded.cleanup?.(context);\n    },\n    meta,\n    run: async (context) => {\n      const loaded = await command();\n      await loaded.run?.(context);\n    },\n    setup: async (context) => {\n      const loaded = await command();\n      await loaded.setup?.(context);\n    },\n  };\n};\n"
+    "import { readFileSync } from \"node:fs\";\n\nimport { join } from \"pathe\";\n\nimport { packageRoot } from \"./package-root.ts\";\n\nlet cached: string | undefined;\n\n/**\n * The installed Blume package version, read lazily from its `package.json`.\n *\n * Computed on demand (not at module load) so importing the `blume` barrel has no\n * filesystem side effect, and anchored at the package root so it resolves the\n * same whether running from source or the bundled CLI.\n */\nexport const getBlumeVersion = (): string => {\n  if (cached === undefined) {\n    const pkgPath = join(packageRoot(), \"package.json\");\n    // SAFETY: this reads blume's own package.json, which always declares a\n    // `version` (publishing requires it).\n    cached = (JSON.parse(readFileSync(pkgPath, \"utf-8\")) as { version: string })\n      .version;\n  }\n  return cached;\n};\n",
+    "import { existsSync } from \"node:fs\";\n\nimport { dirname, join } from \"pathe\";\n\n/**\n * Walk up from `start` until a directory containing a `package.json` is found.\n *\n * Exported for testing; call sites should use {@link packageRoot}.\n */\nexport const findPackageRoot = (start: string): string => {\n  let dir = start;\n  while (!existsSync(join(dir, \"package.json\"))) {\n    const parent = dirname(dir);\n    if (parent === dir) {\n      throw new Error(\"blume: unable to locate the package root\");\n    }\n    dir = parent;\n  }\n  return dir;\n};\n\nlet cached: string | undefined;\n\n/**\n * Absolute path to the installed Blume package root (the directory holding its\n * `package.json`), found by walking up from this module.\n *\n * Anchoring here — rather than at a fixed offset from `import.meta` — keeps the\n * package's own `src/`, assets, and `node_modules` locatable whether the code\n * runs from source under Bun (`src/...`) or from the published, bundled CLI\n * (`dist/cli/*.js`). The two layouts sit at different depths, so a relative\n * `../..` resolves to different places; locating `package.json` does not.\n */\nexport const packageRoot = (): string => {\n  cached ??= findPackageRoot(import.meta.dirname);\n  return cached;\n};\n",
+    "import type { CommandMeta } from \"citty\";\n\n/**\n * Every command's `meta`, held apart from the command modules themselves.\n *\n * The CLI entry loads each command lazily (see `lazy-command.ts`), but citty\n * still reads every subcommand's `meta` to render `blume --help` and to match\n * an unknown name against aliases. Keeping that table here lets those paths\n * run without importing a single command module — `dev` alone drags in Astro,\n * `mcp-stdio` the MCP SDK. The command modules read their `meta` from this\n * table too, so the entry and the command can't drift.\n */\nexport const commandMeta = {\n  add: {\n    description: \"Install a source component or template from the registry.\",\n    name: \"add\",\n  },\n  audit: {\n    description: \"Audit the built site for SEO and site-health issues.\",\n    name: \"audit\",\n  },\n  build: {\n    description: \"Build the docs site for production.\",\n    name: \"build\",\n  },\n  check: {\n    description: \"Type-check the docs site with astro check.\",\n    name: \"check\",\n  },\n  dev: {\n    description: \"Start the Blume development server.\",\n    name: \"dev\",\n  },\n  doctor: {\n    description: \"Diagnose common configuration and content problems.\",\n    name: \"doctor\",\n  },\n  eject: {\n    description: \"Promote the generated runtime into an owned Astro project.\",\n    name: \"eject\",\n  },\n  eval: {\n    description:\n      \"Test the docs: an agent answers your questions using only the documentation.\",\n    name: \"eval\",\n  },\n  init: {\n    description: \"Scaffold a minimal Blume project.\",\n    name: \"init\",\n  },\n  \"mcp-stdio\": {\n    description:\n      \"Serve an MCP data snapshot over stdio (internal, used by `blume eval`).\",\n    name: \"mcp-stdio\",\n  },\n  preview: {\n    description: \"Preview the last production build.\",\n    name: \"preview\",\n  },\n  sync: {\n    description: \"Re-fetch remote content sources and regenerate the runtime.\",\n    name: \"sync\",\n  },\n  translate: {\n    description:\n      \"Translate docs into the configured locales with a local agent CLI.\",\n    name: \"translate\",\n  },\n  validate: {\n    description: \"Validate internal, anchor, asset, and external links.\",\n    name: \"validate\",\n  },\n  version: {\n    description: \"Freeze the current docs as an archived version.\",\n    name: \"version\",\n  },\n} satisfies Record<string, CommandMeta>;\n",
+    "import { existsSync } from \"node:fs\";\n\nimport { config } from \"dotenv\";\nimport { dirname, join, resolve } from \"pathe\";\n\n// Blume's remote sources (GitHub Releases, mdx-remote, Sanity, Notion…) read\n// their tokens from `process.env` during the content scan — which runs before\n// Astro/Vite boots, so Vite's own `.env` loading is too late. This loader fills\n// that gap: it cascades `.env`/`.env.local` from the working dir up to the repo\n// root, so a monorepo can keep one `.env` at the root and every app picks it up.\n\n/**\n * Load `.env`/`.env.local`, cascading from `startDir` up to the repository root\n * (the first ancestor containing a `.git`) or the filesystem root. The ordered\n * path list is handed to dotenv, whose `config` is first-wins, never clobbers\n * existing `process.env` values, and treats unreadable files as best-effort —\n * so shell/CI overrides are never lost, `.env.local` layers over `.env`, and a\n * bad file never aborts a build. dotenv is also the parser Vite runs over\n * these files at build time, so a value means the same thing to the pre-boot\n * content scan and the built site — including multi-line double-quoted values\n * (PEM keys), which a line-based parser silently truncates.\n */\nexport const loadEnvFiles = (startDir: string): void => {\n  const paths: string[] = [];\n  let dir = resolve(startDir);\n  let done = false;\n  while (!done) {\n    paths.push(join(dir, \".env.local\"), join(dir, \".env\"));\n    const parent = dirname(dir);\n    // Stop at the repo root (nearest `.git`) or the filesystem root.\n    done = existsSync(join(dir, \".git\")) || parent === dir;\n    dir = parent;\n  }\n  config({ path: paths, quiet: true });\n};\n",
+    "/**\n * Rewrite a bare `--host` in the raw argv to `--host=` before citty parses it.\n *\n * `host` is a string arg (citty has no mixed string/boolean type), and citty\n * 0.2 parses with `node:util.parseArgs`, where a string option consumes the\n * next token as its value even when that token is another flag: `blume dev\n * --host --open` would bind the literal hostname \"--open\" and drop `--open`.\n * The `--host=` spelling parses as `\"\"` without touching its neighbor, which\n * `normalizeHost` then maps to Astro's \"bind all interfaces\".\n */\nexport const normalizeHostArgs = (rawArgs: readonly string[]): string[] =>\n  rawArgs.map((arg, index) => {\n    if (arg !== \"--host\") {\n      return arg;\n    }\n    const next = rawArgs[index + 1];\n    return next === undefined || next.startsWith(\"-\") ? \"--host=\" : arg;\n  });\n\n/**\n * Resolve a `--host` flag value into what Astro/Vite's `server.host` expects.\n * citty has no mixed string/boolean arg type, so `host` is declared as a\n * string and a bare `--host` parses as `\"\"` (`normalizeHostArgs` rewrites it\n * to `--host=` first) — Node would bind all interfaces for `\"\"`, but Vite's\n * `resolveHostname` treats it as a literal hostname and prints malformed URLs\n * like `http://:4321/`. Match Astro's own `--host` semantics instead: bare\n * flag → `true` (bind all interfaces), `--host 10.0.0.1` → that address,\n * absent → `false` (localhost only).\n *\n * Lives beside `normalizeHostArgs` rather than in `commands/dev.ts` so\n * `preview` can share it without importing the whole dev command graph.\n */\nexport const normalizeHost = (host?: string): boolean | string =>\n  host === \"\" ? true : (host ?? false);\n",
+    "import { colors } from \"consola/utils\";\n\nimport { getBlumeVersion } from \"../core/version.ts\";\n\nconst ISSUES_URL = \"https://github.com/haydenbleasel/blume/issues\";\n\n// Absolute paths into the hidden generated runtime — POSIX (`…/.blume/…`) or\n// Windows drive-letter (`C:\\…\\.blume\\…`) — including any trailing `:line:col`,\n// stopping at whitespace or a closing paren.\nconst BLUME_FRAME =\n  /(?<abs>(?:\\/[^\\s()]*\\/|[A-Za-z]:\\\\[^\\s()]*\\\\)\\.blume[/\\\\][^\\s()]*)/gu;\n\n// The separator immediately before `.blume/` (or `.blume\\`) in a matched path.\nconst BLUME_MARKER = /[/\\\\]\\.blume[/\\\\]/u;\n\n/**\n * Rewrite `.blume/` frames in a stack so the generated runtime reads clearly:\n * the machine-absolute prefix is dropped to a project-relative `.blume/…` path\n * and tagged `(generated)`, keeping the reader oriented instead of staring at a\n * long path into a hidden directory. Frames in the user's own source (custom\n * pages keep their real location; wrappers import user files by their real path)\n * are untouched, so the actionable frame stays intact.\n */\nexport const remapBlumeStack = (stack: string): string =>\n  stack.replaceAll(BLUME_FRAME, (match) => {\n    const marker = match.search(BLUME_MARKER);\n    return `${match.slice(marker + 1)} (generated)`;\n  });\n\n/**\n * Print an unexpected (non-{@link BlumeError}) failure in a stable, reportable\n * shape instead of a bare stack trace: a fixed `BLUME_INTERNAL` code, the\n * message, a trimmed stack, and an environment dump for bug reports. Callers\n * exit after this — it doesn't exit itself, so it's testable.\n */\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- last-resort handler for whatever a catch clause caught; anything narrower would force casts at every call site\nexport const reportInternalError = (error: unknown): void => {\n  const err = error instanceof Error ? error : new Error(String(error));\n  const lines = [\n    `${colors.red(colors.bold(\"BLUME_INTERNAL\"))} An unexpected error occurred.`,\n    `  ${err.message}`,\n  ];\n\n  // A few frames are enough to locate the fault without burying the report;\n  // `.blume/` frames are relativized so the hidden runtime reads clearly.\n  const stack = remapBlumeStack(err.stack ?? \"\")\n    .split(\"\\n\")\n    .slice(1, 5)\n    .map((line) => line.trim())\n    .filter(Boolean);\n  if (stack.length > 0) {\n    lines.push(\"\", colors.dim(stack.join(\"\\n\")));\n  }\n\n  lines.push(\n    \"\",\n    \"This is likely a bug in Blume. Please report it with the details below:\",\n    colors.dim(\n      [\n        `  Blume:    ${getBlumeVersion()}`,\n        `  Node:     ${process.version}`,\n        `  Platform: ${process.platform} ${process.arch}`,\n      ].join(\"\\n\")\n    ),\n    `  ${ISSUES_URL}`\n  );\n\n  process.stderr.write(`${lines.join(\"\\n\")}\\n`);\n};\n",
+    "import type { ArgsDef, CommandDef, CommandMeta } from \"citty\";\n\n/**\n * Wrap a command so its module is imported only when citty needs its `args`\n * or runs it. `meta` stays static (from `command-meta.ts`), so rendering root\n * usage, matching an unknown name, and `blume <cmd> --help` for *another*\n * command never touch this one's dependency graph.\n *\n * `load` imports the command's module and `key` names its export, so the call\n * site stays a plain `() => import(\"./commands/x.ts\")`.\n *\n * Only `args`, `setup`, `run`, and `cleanup` are forwarded: no Blume command\n * declares `default`, `plugins`, or nested `subCommands`.\n */\nexport const lazyCommand = <Args extends ArgsDef, Key extends string>(\n  meta: CommandMeta,\n  load: () => Promise<Record<Key, CommandDef<Args>>>,\n  key: Key\n): CommandDef<Args> => {\n  const command = async () => {\n    const module = await load();\n    return module[key];\n  };\n  return {\n    args: async () => {\n      const { args } = await command();\n      // SAFETY: every Blume command passes `args` to `defineCommand` as a plain\n      // object literal (the \"command registry\" test checks it); citty's\n      // `Resolvable` widening is the only reason the type also admits a thunk\n      // or a promise here.\n      return args as Args;\n    },\n    cleanup: async (context) => {\n      const loaded = await command();\n      await loaded.cleanup?.(context);\n    },\n    meta,\n    run: async (context) => {\n      const loaded = await command();\n      await loaded.run?.(context);\n    },\n    setup: async (context) => {\n      const loaded = await command();\n      await loaded.setup?.(context);\n    },\n  };\n};\n",
+    "import { consola } from \"consola\";\nimport { relative } from \"pathe\";\n\nimport {\n  countBySeverity,\n  enrichDiagnostic,\n  formatDiagnostic,\n  hasErrors,\n} from \"../core/diagnostics.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\nexport const logger = consola.withTag(\"blume\");\n\n/**\n * Resolve once stdout has drained. `process.exit` doesn't flush a piped stdout,\n * so await this before exiting non-zero after writing machine-readable output\n * (e.g. `--json`), otherwise the payload can be truncated in CI.\n */\nexport const flushStdout = (): Promise<void> =>\n  // oxlint-disable-next-line promise/avoid-new -- adapt stdout's write callback\n  new Promise((resolve) => {\n    process.stdout.write(\"\", () => resolve());\n  });\n\n/**\n * Print diagnostics as a JSON document on stdout for CI and editors: each is\n * enriched with its `docsUrl` and its `file` made root-relative. Returns whether\n * any were errors, matching {@link reportDiagnostics}.\n */\nexport const reportDiagnosticsJson = (\n  diagnostics: Diagnostic[],\n  root?: string\n): boolean => {\n  const enriched = diagnostics.map((diagnostic) => {\n    const withDocs = enrichDiagnostic(diagnostic);\n    return withDocs.file && root\n      ? { ...withDocs, file: relative(root, withDocs.file) }\n      : withDocs;\n  });\n  process.stdout.write(\n    `${JSON.stringify(\n      { diagnostics: enriched, summary: countBySeverity(diagnostics) },\n      null,\n      2\n    )}\\n`\n  );\n  return hasErrors(diagnostics);\n};\n\n/** Print a batch of diagnostics and return whether any were errors. */\nexport const reportDiagnostics = (\n  diagnostics: Diagnostic[],\n  root?: string\n): boolean => {\n  if (diagnostics.length === 0) {\n    return false;\n  }\n\n  for (const diagnostic of diagnostics) {\n    process.stderr.write(\n      `${formatDiagnostic(enrichDiagnostic(diagnostic), root)}\\n`\n    );\n  }\n\n  const counts = countBySeverity(diagnostics);\n  const summary = [\n    counts.error ? `${counts.error} error(s)` : null,\n    counts.warning ? `${counts.warning} warning(s)` : null,\n  ]\n    .filter(Boolean)\n    .join(\", \");\n  if (summary) {\n    process.stderr.write(`\\n${summary}\\n`);\n  }\n\n  return hasErrors(diagnostics);\n};\n",
+    "import { colors } from \"consola/utils\";\nimport { relative } from \"pathe\";\nimport type { ZodError } from \"zod\";\n\nimport type { Diagnostic } from \"./types.ts\";\n\n/** A recoverable error carrying a structured diagnostic. */\nexport class BlumeError extends Error {\n  readonly diagnostic: Diagnostic;\n\n  constructor(diagnostic: Diagnostic) {\n    super(diagnostic.message);\n    this.name = \"BlumeError\";\n    this.diagnostic = diagnostic;\n  }\n}\n\nexport const createDiagnostic = (diagnostic: Diagnostic): Diagnostic =>\n  diagnostic;\n\n/** Docs site base; diagnostic help links resolve against it. */\nconst DOCS_BASE = \"https://useblume.dev\";\n\nconst DOCS_DEPLOYMENT = \"/docs/deployment\";\nconst DOCS_REFERENCE_CLI = \"/docs/reference/cli\";\nconst DOCS_CONTENT_SOURCES = \"/docs/content/sources\";\nconst DOCS_CONTENT_NAVIGATION = \"/docs/content/navigation\";\nconst DOCS_CONTENT_INCLUDES = \"/docs/content/includes\";\n\n/** Diagnostic code → the docs page that explains it. */\nconst DOCS_PATHS = new Map(\n  Object.entries({\n    BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,\n    BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,\n    BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,\n    BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,\n    BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,\n    BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,\n    BLUME_CONFIG_INVALID: \"/docs/configuration\",\n    BLUME_CONFIG_LOAD_FAILED: \"/docs/configuration\",\n    BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,\n    BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,\n    BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,\n    BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,\n    BLUME_FRONTMATTER_INVALID: \"/docs/reference/frontmatter\",\n    BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,\n    BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,\n    BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,\n    BLUME_MDX_CURLY_ANCHOR: \"/docs/content/syntax\",\n\n    BLUME_META_INVALID: \"/docs/content/meta\",\n    BLUME_META_LOAD_FAILED: \"/docs/content/meta\",\n    BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,\n    BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_INDEX_TITLE_MISMATCH: DOCS_CONTENT_NAVIGATION,\n    BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,\n    BLUME_NODE_VERSION: \"/docs/quickstart\",\n    BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,\n    BLUME_SIDEBAR_DISPLAY_IGNORED: DOCS_CONTENT_NAVIGATION,\n    BLUME_SOURCE_FETCH_FAILED: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_MISCONFIGURED: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,\n    BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,\n    BLUME_UNKNOWN_COMPONENT: \"/docs/configuration/customization\",\n    BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,\n    BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES,\n    BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES,\n  })\n);\n\n/** The docs URL that explains a diagnostic code, if one is mapped. */\nexport const resolveDocsUrl = (code: string): string | undefined => {\n  const path = DOCS_PATHS.get(code);\n  return path ? `${DOCS_BASE}${path}` : undefined;\n};\n\n/** Fill in `docsUrl` from the code map where a diagnostic doesn't set its own. */\nexport const enrichDiagnostic = (diagnostic: Diagnostic): Diagnostic =>\n  diagnostic.docsUrl\n    ? diagnostic\n    : { ...diagnostic, docsUrl: resolveDocsUrl(diagnostic.code) };\n\nconst REGEXP_SPECIAL = /[$()*+.?[\\\\\\]^{|}]/gu;\nconst escapeRegExp = (value: string): string =>\n  value.replaceAll(REGEXP_SPECIAL, String.raw`\\$&`);\n\n/** A key segment scans the source text; an array index has no key to find. */\nconst isKeySegment = (segment: string | number): segment is string =>\n  typeof segment === \"string\";\n\n/**\n * Best-effort source position for a Zod issue path (e.g. `[\"seo\", \"title\"]`) in\n * the raw config / frontmatter text. Narrows key-by-key — finding each string\n * segment as a `key:`/`key =` at or after the previous match — so a nested key\n * lands under its parent. Array indices are skipped. Returns 1-based line/column,\n * or undefined when nothing matches.\n */\nconst stepSegment = (\n  source: string,\n  segment: string | number,\n  cursor: number\n) => {\n  // A non-string path segment (array index) is skipped without moving on.\n  if (!isKeySegment(segment)) {\n    return { index: -1, next: cursor, stop: false };\n  }\n  // The negative lookbehind keeps a segment like `title` from matching the\n  // tail of an unrelated key such as `subtitle:`.\n  const matcher = new RegExp(\n    `(?<![\\\\w$])${escapeRegExp(segment)}\\\\s*[:=]`,\n    \"gu\"\n  );\n  matcher.lastIndex = cursor;\n  const match = matcher.exec(source);\n  if (!match) {\n    return { index: -1, next: cursor, stop: true };\n  }\n  return { index: match.index, next: matcher.lastIndex, stop: false };\n};\n\nconst locatePath = (\n  source: string,\n  path: readonly (string | number)[]\n): { column: number; line: number } | undefined => {\n  let cursor = 0;\n  let found = -1;\n  for (const segment of path) {\n    const step = stepSegment(source, segment, cursor);\n    if (step.stop) {\n      break;\n    }\n    cursor = step.next;\n    if (step.index >= 0) {\n      found = step.index;\n    }\n  }\n  if (found < 0) {\n    return;\n  }\n  const before = source.slice(0, found);\n  const lastNewline = before.lastIndexOf(\"\\n\");\n  return { column: found - lastNewline, line: before.split(\"\\n\").length };\n};\n\n/** The YAML front matter block of a `.md`/`.mdx` source, if it has one. */\nconst FRONTMATTER = /^---\\r?\\n(?<body>[\\s\\S]*?)\\r?\\n---/u;\n\n/**\n * Locate a front matter key in a content file, e.g. `[\"seo\", \"description\"]` in\n * `docs/api.mdx`. Scoped to the front matter block so a `title:` written in the\n * page body can't be mistaken for the front matter key of the same name; returns\n * undefined when the file has no front matter or the key isn't set (a missing\n * key has no line to point at — callers anchor to the file instead).\n */\nexport const locateFrontmatterKey = (\n  source: string,\n  path: readonly (string | number)[]\n): { column: number; line: number } | undefined => {\n  const block = FRONTMATTER.exec(source);\n  if (!block) {\n    return;\n  }\n  // `locatePath` reports lines 1-based within the text it was given, and the\n  // front matter body starts one line below the opening `---`.\n  const position = locatePath(block.groups?.body ?? \"\", path);\n  return position && { column: position.column, line: position.line + 1 };\n};\n\n/**\n * Convert generic validation issues (message + path, the shape shared by Zod\n * and Standard Schema issues) into Blume diagnostics, anchored to a file.\n */\nexport const diagnosticsFromIssues = (\n  issues: readonly {\n    message: string;\n    path: readonly (string | number)[];\n  }[],\n  options: { code: string; file?: string; source?: string }\n): Diagnostic[] =>\n  issues.map((issue) => {\n    const schemaPath = issue.path.join(\".\");\n    const position = options.source\n      ? locatePath(options.source, issue.path)\n      : undefined;\n    return {\n      code: options.code,\n      column: position?.column,\n      file: options.file,\n      line: position?.line,\n      message: schemaPath ? `${schemaPath}: ${issue.message}` : issue.message,\n      schemaPath: schemaPath || undefined,\n      severity: \"error\",\n    } satisfies Diagnostic;\n  });\n\n/** Convert a ZodError into Blume diagnostics, anchored to a file. */\nexport const diagnosticsFromZod = (\n  error: ZodError,\n  options: { code: string; file?: string; source?: string }\n): Diagnostic[] =>\n  diagnosticsFromIssues(\n    error.issues.map((issue) => ({\n      message: issue.message,\n      // Zod 4 paths are PropertyKey[]; a symbol segment has no place in a\n      // dotted schema path or a source-position scan.\n      path: issue.path.filter(\n        (segment): segment is string | number => typeof segment !== \"symbol\"\n      ),\n    })),\n    options\n  );\n\nconst severityColor = (severity: Diagnostic[\"severity\"]) => {\n  if (severity === \"error\") {\n    return colors.red;\n  }\n  if (severity === \"warning\") {\n    return colors.yellow;\n  }\n  return colors.blue;\n};\n\n/** Format a single diagnostic for terminal output. */\nexport const formatDiagnostic = (\n  diagnostic: Diagnostic,\n  root?: string\n): string => {\n  const color = severityColor(diagnostic.severity);\n  const lines: string[] = [\n    `${color(colors.bold(diagnostic.code))} ${diagnostic.message}`,\n  ];\n\n  // An audit finding is about a built URL, and names the source file that fixes\n  // it as a second line (\"at /docs/api\" / \"in docs/api.mdx:3:2\"). Everything\n  // else is about a file alone, and keeps the original single `at file` line.\n  if (diagnostic.url) {\n    lines.push(`  ${colors.dim(`at ${diagnostic.url}`)}`);\n  }\n  if (diagnostic.file) {\n    const location = root ? relative(root, diagnostic.file) : diagnostic.file;\n    const column =\n      diagnostic.column === undefined ? \"\" : `:${diagnostic.column}`;\n    const position =\n      diagnostic.line === undefined ? \"\" : `:${diagnostic.line}${column}`;\n    const label = diagnostic.url ? \"in\" : \"at\";\n    lines.push(`  ${colors.dim(`${label} ${location}${position}`)}`);\n  }\n\n  if (diagnostic.suggestion) {\n    lines.push(`  ${colors.cyan(`fix: ${diagnostic.suggestion}`)}`);\n  }\n\n  if (diagnostic.docsUrl) {\n    lines.push(`  ${colors.dim(`docs: ${diagnostic.docsUrl}`)}`);\n  }\n\n  return lines.join(\"\\n\");\n};\n\nexport const hasErrors = (diagnostics: Diagnostic[]): boolean =>\n  diagnostics.some((d) => d.severity === \"error\");\n\nexport const countBySeverity = (diagnostics: Diagnostic[]) => {\n  const counts = { error: 0, info: 0, warning: 0 } satisfies Record<\n    Diagnostic[\"severity\"],\n    number\n  >;\n  for (const diagnostic of diagnostics) {\n    counts[diagnostic.severity] += 1;\n  }\n  return counts;\n};\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;;;ACcO,IAAM,cAAc,CACzB,MACA,MACA,QACqB;AAAA,EACrB,MAAM,UAAU,YAAY;AAAA,IAC1B,MAAM,SAAS,MAAM,KAAK;AAAA,IAC1B,OAAO,OAAO;AAAA;AAAA,EAEhB,OAAO;AAAA,IACL,MAAM,YAAY;AAAA,MAChB,QAAQ,SAAS,MAAM,QAAQ;AAAA,MAK/B,OAAO;AAAA;AAAA,IAET,SAAS,OAAO,YAAY;AAAA,MAC1B,MAAM,SAAS,MAAM,QAAQ;AAAA,MAC7B,MAAM,OAAO,UAAU,OAAO;AAAA;AAAA,IAEhC;AAAA,IACA,KAAK,OAAO,YAAY;AAAA,MACtB,MAAM,SAAS,MAAM,QAAQ;AAAA,MAC7B,MAAM,OAAO,MAAM,OAAO;AAAA;AAAA,IAE5B,OAAO,OAAO,YAAY;AAAA,MACxB,MAAM,SAAS,MAAM,QAAQ;AAAA,MAC7B,MAAM,OAAO,QAAQ,OAAO;AAAA;AAAA,EAEhC;AAAA;;;AD7BF,IAAM,OAAO,cAAc;AAAA,EACzB,MAAM;AAAA,IACJ,aAAa;AAAA,IACb,MAAM;AAAA,IACN,SAAS,gBAAgB;AAAA,EAC3B;AAAA,EACA,aAAa;AAAA,IACX,KAAK,YACH,YAAY,KACZ,MAAa,+BACb,YACF;AAAA,IACA,OAAO,YACL,YAAY,OACZ,MAAa,+BACb,cACF;AAAA,IACA,OAAO,YACL,YAAY,OACZ,MAAa,+BACb,cACF;AAAA,IACA,OAAO,YACL,YAAY,OACZ,MAAa,+BACb,cACF;AAAA,IACA,KAAK,YACH,YAAY,KACZ,MAAa,+BACb,YACF;AAAA,IACA,QAAQ,YACN,YAAY,QACZ,MAAa,+BACb,eACF;AAAA,IACA,OAAO,YACL,YAAY,OACZ,MAAa,+BACb,cACF;AAAA,IACA,MAAM,YACJ,YAAY,MACZ,MAAa,+BACb,aACF;AAAA,IACA,MAAM,YACJ,YAAY,MACZ,MAAa,+BACb,aACF;AAAA,IACA,aAAa,YACX,YAAY,cACZ,MAAa,+BACb,iBACF;AAAA,IACA,SAAS,YACP,YAAY,SACZ,MAAa,+BACb,gBACF;AAAA,IACA,MAAM,YACJ,YAAY,MACZ,MAAa,+BACb,aACF;AAAA,IACA,WAAW,YACT,YAAY,WACZ,MAAa,+BACb,kBACF;AAAA,IACA,UAAU,YACR,YAAY,UACZ,MAAa,+BACb,iBACF;AAAA,IACA,SAAS,YACP,YAAY,SACZ,MAAa,+BACb,gBACF;AAAA,EACF;AACF,CAAC;AAED,aAAa,QAAQ,IAAI,CAAC;AAE1B,QAAQ,GAAG,qBAAqB,CAAC,UAAU;AAAA,EACzC,oBAAoB,KAAK;AAAA,EACzB,QAAQ,KAAK,CAAC;AAAA,CACf;AACD,QAAQ,GAAG,sBAAsB,CAAC,UAAU;AAAA,EAC1C,oBAAoB,KAAK;AAAA,EACzB,QAAQ,KAAK,CAAC;AAAA,CACf;AAED,QAAQ,MAAM,EAAE,SAAS,kBAAkB,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC;",
-  "debugId": "1D180DF0EF7A648564756E2164756E21",
+  "mappings": "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",
+  "debugId": "3D851F7CCD64619664756E2164756E21",
   "names": []
 }

package/dist/types/components/layout/nav-utils.d.ts

@@ -78,15 +78,28 @@ export interface NavVariant {
     locale: string;
     navigation: Navigation;
 }
+/**
+ * The locale whose code must not appear as a fragment URL segment: the
+ * default locale while its URL prefix is hidden. Astro's i18n routing 404s any
+ * page URL carrying that locale's code as a segment (it expects the default
+ * locale to be unprefixed), so its trees are keyed `default` instead, the same
+ * way its page routes drop the prefix. `null` when every locale is prefixed
+ * or the site is single-locale.
+ */
+export declare const hiddenDefaultLocale: (i18n: {
+    defaultLocale: string;
+    hideDefaultLocalePrefix: boolean;
+} | null) => string | null;
 /**
  * Every navigation tree the runtime data holds — the default, each locale's,
  * and each archived version's per locale — keyed the way the deferred
  * sidebar fragments' URLs are (`/blume-nav/<version>/<locale>/…`). An
  * unlocalized version tree is keyed by `""` in the data; it maps to
- * `default` here.
+ * `default` here, as does the hidden-prefix default locale's (see
+ * `hiddenDefaultLocale`), whose current tree is `data.navigation` already.
  */
 export declare const navVariants: (data: {
     navigation: Navigation;
     navigationByLocale: Record<string, Navigation>;
     navigationByVersion: Record<string, Record<string, Navigation>>;
-}) => NavVariant[];
+}, hiddenDefault?: string | null) => NavVariant[];