blume 2.1.2 → 2.2.0

package/dist/cli/chunk-wehv26ry.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/static-host.ts", "../src/cli/eject-scripts.ts"],
+  "sourcesContent": [
+    "/**\n * What a static host does with the URLs `blume dev` and `blume preview`\n * would otherwise answer on their own terms. Astro's `trailingSlash: \"never\"`\n * has both 404 a slashed URL (`/guide/`), which every host answers: Vercel\n * redirects it to `/guide`, and the others serve `guide/index.html`. And a\n * folder of HTML shipped in `public/` (`public/demo/index.html`) is served at\n * `/demo/`, `/demo` redirecting there, so the relative links inside it\n * resolve against the folder; the dev server 404s both spellings, and Vite's\n * preview serves only the slashless one.\n */\n\nimport { statSync } from \"node:fs\";\nimport type { IncomingMessage, Server, ServerResponse } from \"node:http\";\n\nimport { join, resolve } from \"pathe\";\n\nimport { stripBasePath } from \"./base-path.ts\";\nimport { trimEnd } from \"./trim.ts\";\n\n/** How to answer a request ahead of the server's own handlers. */\nexport type HostAnswer =\n  | { kind: \"redirect\"; location: string; status: number }\n  | { kind: \"rewrite\"; url: string };\n\n/**\n * The paths Astro keeps out of its trailing-slash handling (`/_astro/`,\n * `/@vite/`, `/.well-known/`, `//`), and the root.\n */\nconst UNHANDLED_PATH = /^\\/(?:[_@./]|$)/u;\n\n/** A request URL's path and its query string, `?` included. */\nconst splitUrl = (url: string): { pathname: string; search: string } => {\n  const queryAt = url.search(/[?#]/u);\n  return queryAt === -1\n    ? { pathname: url, search: \"\" }\n    : { pathname: url.slice(0, queryAt), search: url.slice(queryAt) };\n};\n\n/**\n * Whether `public/<path>/index.html` exists: a folder of HTML the site ships\n * as is. `path` is the decoded request path with `deployment.base` stripped.\n */\nexport const publicFolder = (publicDir: string) => {\n  const root = resolve(publicDir);\n  return (path: string): boolean => {\n    const index = join(root, path, \"index.html\");\n    if (!index.startsWith(`${root}/`)) {\n      return false;\n    }\n    try {\n      return statSync(index).isFile();\n    } catch {\n      return false;\n    }\n  };\n};\n\n/**\n * How a static host answers a URL's trailing slash, or null to leave the\n * request alone. A slashed URL redirects to its slashless page, its query\n * kept, unless it names a public folder, which serves its `index.html`; a\n * slashless public folder redirects to its slashed URL. `base` is the\n * normalized `deployment.base`, which the URL carries and `public/` doesn't.\n * The redirect is a `301`, a `308` for a method a `301` would turn into a\n * `GET`, as Astro answers on a server-rendered route.\n */\nexport const trailingSlashAnswer = (\n  request: Pick<IncomingMessage, \"method\" | \"url\">,\n  base: string,\n  isPublicFolder: (path: string) => boolean\n): HostAnswer | null => {\n  const { pathname, search } = splitUrl(request.url ?? \"/\");\n  if (UNHANDLED_PATH.test(pathname)) {\n    return null;\n  }\n  let path: string;\n  try {\n    path = decodeURIComponent(stripBasePath(base, pathname));\n  } catch {\n    return null;\n  }\n  const status =\n    request.method === \"GET\" || request.method === \"HEAD\" ? 301 : 308;\n  if (!pathname.endsWith(\"/\")) {\n    return isPublicFolder(path)\n      ? { kind: \"redirect\", location: `${pathname}/${search}`, status }\n      : null;\n  }\n  const slashless = trimEnd(pathname, \"/\");\n  return isPublicFolder(trimEnd(path, \"/\"))\n    ? { kind: \"rewrite\", url: `${slashless}/index.html${search}` }\n    : { kind: \"redirect\", location: `${slashless}${search}`, status };\n};\n\n/**\n * Answer every request on `server` with `answer` first: a redirect is sent\n * then and there, and a rewrite changes the URL the server's own handlers\n * (Vite's middleware) then see. They're the request listeners the server\n * already has, so this goes ahead of every middleware, Astro's included.\n */\nexport const answerRequestsFirst = (\n  server: Server,\n  answer: (request: IncomingMessage) => HostAnswer | null,\n  headers: Record<string, string> = {}\n): void => {\n  const handlers = server.listeners(\"request\");\n  server.removeAllListeners(\"request\");\n  server.on(\"request\", (request: IncomingMessage, response: ServerResponse) => {\n    const answered = answer(request);\n    if (answered?.kind === \"redirect\") {\n      response.writeHead(answered.status, {\n        ...headers,\n        Location: answered.location,\n      });\n      response.end();\n      return;\n    }\n    if (answered) {\n      request.url = answered.url;\n    }\n    for (const handler of handlers) {\n      handler.call(server, request, response);\n    }\n  });\n};\n",
+    "import { existsSync, readFileSync } from \"node:fs\";\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nimport { join } from \"pathe\";\n\nimport { EJECTED_CONFIG_HEADER } from \"../astro/templates.ts\";\nimport { packageRoot } from \"../core/package-root.ts\";\nimport { commandsFor, detectProjectPackageManager } from \"./init/scaffold.ts\";\nimport type { PackageManager } from \"./init/scaffold.ts\";\nimport { logger } from \"./log.ts\";\n\n/** A JSON value, as `JSON.parse` of a manifest can return. */\ntype JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [key: string]: JsonValue };\n\n/** The slice of package.json the rewrite touches; the rest rides along. */\ninterface PackageManifest {\n  [key: string]: JsonValue | undefined;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n  scripts?: Record<string, string>;\n}\n\n/** Package name → the semver range to depend on it at. */\nexport interface DependencyRanges {\n  [name: string]: string;\n}\n\n/**\n * The version range Blume itself uses for each package it depends on or\n * accepts as a peer, plus `blume` at the installed version — what an ejected\n * app should pin so it keeps building against the same majors.\n */\nexport const blumeDependencyRanges = (): DependencyRanges => {\n  // SAFETY: blume's own package.json, which declares its version and both\n  // dependency maps; nothing else is read.\n  const manifest = JSON.parse(\n    readFileSync(join(packageRoot(), \"package.json\"), \"utf-8\")\n  ) as {\n    dependencies: Record<string, string>;\n    peerDependencies: Record<string, string>;\n    version: string;\n  };\n  return {\n    ...manifest.peerDependencies,\n    ...manifest.dependencies,\n    blume: `^${manifest.version}`,\n  };\n};\n\n/** Whether the manifest already lists `name` in any dependency field. */\nconst declares = (pkg: PackageManifest, name: string): boolean =>\n  [\n    pkg.dependencies,\n    pkg.devDependencies,\n    pkg.optionalDependencies,\n    pkg.peerDependencies,\n  ].some((field) => field !== undefined && Object.hasOwn(field, name));\n\n/**\n * Point the project's package.json at the ejected app. Its scripts run Astro\n * directly: after an eject the Blume CLI no longer manages the runtime, so\n * scaffolded scripts like `\"dev\": \"blume dev\"` would rebuild the removed\n * `.blume` tree instead of serving the ejected app. And every package the\n * ejected app imports by bare name (`dependencies`, from `eject()`) that the\n * project doesn't list yet becomes a dependency at the range Blume itself\n * uses (`ranges`).\n *\n * Returns the names it added, so the caller can ask for an install. A missing\n * or unreadable package.json is left alone.\n */\nexport const updatePackageScripts = async (\n  root: string,\n  dependencies: string[] = [],\n  ranges: DependencyRanges = blumeDependencyRanges()\n): Promise<string[]> => {\n  const pkgPath = join(root, \"package.json\");\n  let pkg: PackageManifest;\n  try {\n    pkg = JSON.parse(await readFile(pkgPath, \"utf-8\"));\n  } catch {\n    return [];\n  }\n  const scripts = pkg.scripts ?? {};\n  pkg.scripts = {\n    ...scripts,\n    build: \"astro build\",\n    dev: \"astro dev\",\n    preview: \"astro preview\",\n  };\n  const added = dependencies.filter((name) => !declares(pkg, name));\n  if (added.length > 0) {\n    // Sorted, the way package managers write the field.\n    pkg.dependencies = Object.fromEntries(\n      Object.entries({\n        ...pkg.dependencies,\n        ...Object.fromEntries(added.map((name) => [name, ranges[name] ?? \"*\"])),\n      }).toSorted(([a], [b]) => (a < b ? -1 : 1))\n    );\n  }\n  await writeFile(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`, \"utf-8\");\n  return added;\n};\n\n/**\n * The first line Blume 1's `blume eject` wrote into the ejected\n * `astro.config.mjs` — the hidden runtime's own header, carried over. Blume 2's\n * hidden runtime keeps it under `.blume/`, never at the project root, so a root\n * config that opens with it is an app Blume 1 ejected.\n */\nconst BLUME_1_EJECTED_CONFIG_HEADER =\n  \"// Generated by Blume. Do not edit; this file is recreated on each run.\";\n\n/**\n * Whether `root` holds an app `blume eject` already wrote: a root\n * `astro.config.mjs` whose first line is eject's header, or the header Blume 1\n * ejected with. The header is the only signal: a Blume project may keep its own\n * `astro.config.mjs` and a codegen `src/generated/` folder beside its content,\n * and neither makes it an ejected app.\n */\nexport const isEjectedProject = (root: string): boolean => {\n  const config = join(root, \"astro.config.mjs\");\n  if (!existsSync(config)) {\n    return false;\n  }\n  const source = readFileSync(config, \"utf-8\");\n  return (\n    source.startsWith(EJECTED_CONFIG_HEADER) ||\n    source.startsWith(BLUME_1_EJECTED_CONFIG_HEADER)\n  );\n};\n\n/** The Blume commands that run the hidden `.blume/` copy of the site. */\nexport type RuntimeCommand = \"build\" | \"check\" | \"dev\" | \"preview\" | \"sync\";\n\n/**\n * What an ejected app runs in place of each {@link RuntimeCommand}: its own\n * `dev`/`build`/`preview` scripts (eject writes them), or Astro's CLI for the\n * check and the content sync.\n */\nconst ejectedEquivalent = (\n  pm: PackageManager,\n  command: RuntimeCommand\n): string => {\n  const { build, dev, exec } = commandsFor(pm);\n  return {\n    build,\n    check: `${exec} astro check`,\n    dev,\n    // Spelled like `dev`: npm runs a custom script only through `run`.\n    preview: pm === \"npm\" ? \"npm run preview\" : `${pm} preview`,\n    sync: `${exec} astro sync`,\n  }[command];\n};\n\n/**\n * Stop a command that works on the hidden runtime in an ejected app. `dev`,\n * `build`, `check`, and `sync` would regenerate `.blume/` from\n * `blume.config.ts` and run that hidden copy, ignoring every edit made to the\n * app since eject, and `preview` would look for that copy's build; point at\n * the app's own command under the project's package manager instead.\n */\nexport const refuseIfEjected = async (\n  root: string,\n  command: RuntimeCommand\n): Promise<void> => {\n  if (!isEjectedProject(root)) {\n    return;\n  }\n  const pm = await detectProjectPackageManager(root);\n  logger.error(\n    `This project was ejected to a standalone Astro app, so \\`blume ${command}\\` would run a regenerated copy of the site instead of it. Run \\`${ejectedEquivalent(pm, command)}\\` instead.`\n  );\n  process.exit(1);\n};\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAWA;AAGA;AAcA,IAAM,iBAAiB;AAGvB,IAAM,WAAW,CAAC,QAAsD;AAAA,EACtE,MAAM,UAAU,IAAI,OAAO,OAAO;AAAA,EAClC,OAAO,YAAY,KACf,EAAE,UAAU,KAAK,QAAQ,GAAG,IAC5B,EAAE,UAAU,IAAI,MAAM,GAAG,OAAO,GAAG,QAAQ,IAAI,MAAM,OAAO,EAAE;AAAA;AAO7D,IAAM,eAAe,CAAC,cAAsB;AAAA,EACjD,MAAM,OAAO,QAAQ,SAAS;AAAA,EAC9B,OAAO,CAAC,SAA0B;AAAA,IAChC,MAAM,QAAQ,KAAK,MAAM,MAAM,YAAY;AAAA,IAC3C,IAAI,CAAC,MAAM,WAAW,GAAG,OAAO,GAAG;AAAA,MACjC,OAAO;AAAA,IACT;AAAA,IACA,IAAI;AAAA,MACF,OAAO,SAAS,KAAK,EAAE,OAAO;AAAA,MAC9B,MAAM;AAAA,MACN,OAAO;AAAA;AAAA;AAAA;AAcN,IAAM,sBAAsB,CACjC,SACA,MACA,mBACsB;AAAA,EACtB,QAAQ,UAAU,WAAW,SAAS,QAAQ,OAAO,GAAG;AAAA,EACxD,IAAI,eAAe,KAAK,QAAQ,GAAG;AAAA,IACjC,OAAO;AAAA,EACT;AAAA,EACA,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,OAAO,mBAAmB,cAAc,MAAM,QAAQ,CAAC;AAAA,IACvD,MAAM;AAAA,IACN,OAAO;AAAA;AAAA,EAET,MAAM,SACJ,QAAQ,WAAW,SAAS,QAAQ,WAAW,SAAS,MAAM;AAAA,EAChE,IAAI,CAAC,SAAS,SAAS,GAAG,GAAG;AAAA,IAC3B,OAAO,eAAe,IAAI,IACtB,EAAE,MAAM,YAAY,UAAU,GAAG,YAAY,UAAU,OAAO,IAC9D;AAAA,EACN;AAAA,EACA,MAAM,YAAY,QAAQ,UAAU,GAAG;AAAA,EACvC,OAAO,eAAe,QAAQ,MAAM,GAAG,CAAC,IACpC,EAAE,MAAM,WAAW,KAAK,GAAG,uBAAuB,SAAS,IAC3D,EAAE,MAAM,YAAY,UAAU,GAAG,YAAY,UAAU,OAAO;AAAA;AAS7D,IAAM,sBAAsB,CACjC,QACA,QACA,UAAkC,CAAC,MAC1B;AAAA,EACT,MAAM,WAAW,OAAO,UAAU,SAAS;AAAA,EAC3C,OAAO,mBAAmB,SAAS;AAAA,EACnC,OAAO,GAAG,WAAW,CAAC,SAA0B,aAA6B;AAAA,IAC3E,MAAM,WAAW,OAAO,OAAO;AAAA,IAC/B,IAAI,UAAU,SAAS,YAAY;AAAA,MACjC,SAAS,UAAU,SAAS,QAAQ;AAAA,WAC/B;AAAA,QACH,UAAU,SAAS;AAAA,MACrB,CAAC;AAAA,MACD,SAAS,IAAI;AAAA,MACb;AAAA,IACF;AAAA,IACA,IAAI,UAAU;AAAA,MACZ,QAAQ,MAAM,SAAS;AAAA,IACzB;AAAA,IACA,WAAW,WAAW,UAAU;AAAA,MAC9B,QAAQ,KAAK,QAAQ,SAAS,QAAQ;AAAA,IACxC;AAAA,GACD;AAAA;;;AC3HH;AACA;AAEA,iBAAS;AAqCF,IAAM,wBAAwB,MAAwB;AAAA,EAG3D,MAAM,WAAW,KAAK,MACpB,aAAa,MAAK,YAAY,GAAG,cAAc,GAAG,OAAO,CAC3D;AAAA,EAKA,OAAO;AAAA,OACF,SAAS;AAAA,OACT,SAAS;AAAA,IACZ,OAAO,IAAI,SAAS;AAAA,EACtB;AAAA;AAIF,IAAM,WAAW,CAAC,KAAsB,SACtC;AAAA,EACE,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN,EAAE,KAAK,CAAC,UAAU,UAAU,aAAa,OAAO,OAAO,OAAO,IAAI,CAAC;AAc9D,IAAM,uBAAuB,OAClC,MACA,eAAyB,CAAC,GAC1B,SAA2B,sBAAsB,MAC3B;AAAA,EACtB,MAAM,UAAU,MAAK,MAAM,cAAc;AAAA,EACzC,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,MAAM,KAAK,MAAM,MAAM,SAAS,SAAS,OAAO,CAAC;AAAA,IACjD,MAAM;AAAA,IACN,OAAO,CAAC;AAAA;AAAA,EAEV,MAAM,UAAU,IAAI,WAAW,CAAC;AAAA,EAChC,IAAI,UAAU;AAAA,OACT;AAAA,IACH,OAAO;AAAA,IACP,KAAK;AAAA,IACL,SAAS;AAAA,EACX;AAAA,EACA,MAAM,QAAQ,aAAa,OAAO,CAAC,SAAS,CAAC,SAAS,KAAK,IAAI,CAAC;AAAA,EAChE,IAAI,MAAM,SAAS,GAAG;AAAA,IAEpB,IAAI,eAAe,OAAO,YACxB,OAAO,QAAQ;AAAA,SACV,IAAI;AAAA,SACJ,OAAO,YAAY,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,OAAO,SAAS,GAAG,CAAC,CAAC;AAAA,IACxE,CAAC,EAAE,SAAS,EAAE,KAAK,OAAQ,IAAI,IAAI,KAAK,CAAE,CAC5C;AAAA,EACF;AAAA,EACA,MAAM,UAAU,SAAS,GAAG,KAAK,UAAU,KAAK,MAAM,CAAC;AAAA,GAAO,OAAO;AAAA,EACrE,OAAO;AAAA;AAST,IAAM,gCACJ;AASK,IAAM,mBAAmB,CAAC,SAA0B;AAAA,EACzD,MAAM,SAAS,MAAK,MAAM,kBAAkB;AAAA,EAC5C,IAAI,CAAC,WAAW,MAAM,GAAG;AAAA,IACvB,OAAO;AAAA,EACT;AAAA,EACA,MAAM,SAAS,aAAa,QAAQ,OAAO;AAAA,EAC3C,OACE,OAAO,WAAW,qBAAqB,KACvC,OAAO,WAAW,6BAA6B;AAAA;AAYnD,IAAM,oBAAoB,CACxB,IACA,YACW;AAAA,EACX,QAAQ,OAAO,KAAK,SAAS,YAAY,EAAE;AAAA,EAC3C,OAAO;AAAA,IACL;AAAA,IACA,OAAO,GAAG;AAAA,IACV;AAAA,IAEA,SAAS,OAAO,QAAQ,oBAAoB,GAAG;AAAA,IAC/C,MAAM,GAAG;AAAA,EACX,EAAE;AAAA;AAUG,IAAM,kBAAkB,OAC7B,MACA,YACkB;AAAA,EAClB,IAAI,CAAC,iBAAiB,IAAI,GAAG;AAAA,IAC3B;AAAA,EACF;AAAA,EACA,MAAM,KAAK,MAAM,4BAA4B,IAAI;AAAA,EACjD,OAAO,MACL,kEAAkE,2EAA2E,kBAAkB,IAAI,OAAO,cAC5K;AAAA,EACA,QAAQ,KAAK,CAAC;AAAA;",
+  "debugId": "CFEE49169891DC2F64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-y4msrwm9.js → chunk-xgq4eytj.js}

@@ -3,7 +3,7 @@ import {
   resolveRuntimeDir,
   resolveProjectContext,
   loadConfig
-} from "./chunk-124fvmzq.js";
+} from "./chunk-dm4mg9bj.js";
 import"./chunk-zccbjcj0.js";
 import {
   commandMeta,
@@ -11,24 +11,24 @@ import {
 } from "./index.js";
 import {
   readDevLock
-} from "./chunk-tfycddbt.js";
-import"./chunk-dpy8qdjf.js";
+} from "./chunk-bjk964fp.js";
+import"./chunk-as09pafp.js";
 import {
   refuseIfEjected
-} from "./chunk-53jqw8z0.js";
-import"./chunk-nbyvgnnm.js";
-import"./chunk-desvm72z.js";
-import"./chunk-0pmb4tr4.js";
-import"./chunk-ckrcm08h.js";
-import"./chunk-j1x92mx9.js";
+} from "./chunk-wehv26ry.js";
+import"./chunk-1rkxzg3n.js";
+import"./chunk-8f8xw4x2.js";
+import"./chunk-2nr29y95.js";
+import"./chunk-a3ydrqny.js";
+import"./chunk-w6e455pz.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-es8h0v3j.js";
-import"./chunk-dqhg54mr.js";
+import"./chunk-96snx8yy.js";
+import"./chunk-dmx6cezx.js";
 import {
   prepareProject
-} from "./chunk-297ajdcv.js";
-import"./chunk-ms9z66nz.js";
-import"./chunk-s0bdnc7v.js";
+} from "./chunk-c69tw29j.js";
+import"./chunk-4rftmttv.js";
+import"./chunk-79bzzkx4.js";
 
 // src/cli/commands/sync.ts
 import { rm } from "node:fs/promises";
@@ -74,4 +74,4 @@ export {
 };
 
 //# debugId=67B7B6A961A6206764756E2164756E21
-//# sourceMappingURL=chunk-y4msrwm9.js.map
+//# sourceMappingURL=chunk-xgq4eytj.js.map

package/dist/cli/{chunk-36bxs9c7.js → chunk-xt0qvz1t.js}

@@ -7,50 +7,51 @@ import {
 } from "./index.js";
 import {
   deployPlatform
-} from "./chunk-124fvmzq.js";
+} from "./chunk-dm4mg9bj.js";
+import"./chunk-8f8xw4x2.js";
 import"./chunk-zccbjcj0.js";
-import"./chunk-0pmb4tr4.js";
+import {
+  refuseIfEjected
+} from "./chunk-wehv26ry.js";
 import {
   publishBuildProject,
   ogCacheDir,
   pruneCardCache,
   cardCacheTally
-} from "./chunk-nbyvgnnm.js";
-import"./chunk-desvm72z.js";
+} from "./chunk-1rkxzg3n.js";
+import"./chunk-2nr29y95.js";
 import {
   deployOutputDir,
   deployStaticDir,
   surfaceAdapterOutput
-} from "./chunk-dpy8qdjf.js";
+} from "./chunk-as09pafp.js";
+import"./chunk-96snx8yy.js";
 import {
   ensureGitignore
 } from "./chunk-yzhm0j9q.js";
-import"./chunk-j1x92mx9.js";
+import"./chunk-w6e455pz.js";
 import {
   removedBuildFlags,
   flagList,
   removedBuildFlagsAdvice
-} from "./chunk-9qzgg6mj.js";
+} from "./chunk-1cm0h819.js";
 import {
-  astroBuildDiagnostics
-} from "./chunk-150jk7km.js";
+  astroBuildDiagnostics,
+  buildFailureLocator
+} from "./chunk-kkrteb15.js";
 import {
   refuseIfDevRunning
-} from "./chunk-tfycddbt.js";
-import {
-  refuseIfEjected
-} from "./chunk-53jqw8z0.js";
-import"./chunk-ckrcm08h.js";
+} from "./chunk-bjk964fp.js";
+import"./chunk-a3ydrqny.js";
 import"./chunk-jq5n4avg.js";
-import"./chunk-es8h0v3j.js";
-import"./chunk-dqhg54mr.js";
+import"./chunk-dmx6cezx.js";
 import {
   prepareProject
-} from "./chunk-297ajdcv.js";
+} from "./chunk-c69tw29j.js";
 import {
   serverFeatures
-} from "./chunk-ms9z66nz.js";
-import"./chunk-s0bdnc7v.js";
+} from "./chunk-4rftmttv.js";
+import"./chunk-79bzzkx4.js";
 
 // src/cli/commands/build.ts
 import { existsSync } from "node:fs";
@@ -169,7 +170,7 @@ var reportBuild = async (project, distDir, args) => {
 `));
   await runClientAssetChecks(distDir, args);
   if (project.droppedPages > 0) {
-    logger.warn(`${project.droppedPages} page(s) failed frontmatter validation and are missing from this build.`);
+    logger.warn(`${project.droppedPages} page(s) failed validation and are missing from this build.`);
   }
   logger.success(`Built to ${distDir}`);
 };
@@ -236,7 +237,10 @@ var buildCommand = defineCommand({
       if (error instanceof BlumeError || !(error instanceof Error)) {
         throw error;
       }
-      reportDiagnostics(astroBuildDiagnostics(error), root);
+      reportDiagnostics(await astroBuildDiagnostics(error, {
+        locate: buildFailureLocator(project),
+        root
+      }), root);
       process.exit(1);
     }
     await reportCardCache(project, !runtimeDir);
@@ -271,5 +275,5 @@ export {
   runClientAssetChecks
 };
 
-//# debugId=5EAF9E033A01BFBE64756E2164756E21
-//# sourceMappingURL=chunk-36bxs9c7.js.map
+//# debugId=43360653920765D464756E2164756E21
+//# sourceMappingURL=chunk-xt0qvz1t.js.map

package/dist/cli/chunk-xt0qvz1t.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/build.ts"],
+  "sourcesContent": [
+    "import { existsSync } from \"node:fs\";\nimport { readdir, stat } from \"node:fs/promises\";\n\nimport { build } from \"astro\";\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\n\nimport { publishBuildProject } from \"../../astro/integration.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { ensureGitignore } from \"../../core/gitignore.ts\";\nimport type { BlumeProject } from \"../../core/project-graph.ts\";\nimport { serverFeatures } from \"../../core/server-features.ts\";\nimport {\n  deployOutputDir,\n  deployStaticDir,\n  surfaceAdapterOutput,\n} from \"../../deploy/adapter-output.ts\";\nimport { deployPlatform } from \"../../deploy/platforms/index.ts\";\nimport { cardCacheTally, ogCacheDir, pruneCardCache } from \"../../og/cache.ts\";\nimport {\n  flagList,\n  removedBuildFlags,\n  removedBuildFlagsAdvice,\n} from \"../../upgrade/upgrade.ts\";\nimport {\n  astroBuildDiagnostics,\n  buildFailureLocator,\n} from \"../build-failure.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { refuseIfDevRunning } from \"../dev-lock.ts\";\nimport { refuseIfEjected } from \"../eject-scripts.ts\";\nimport { logger, reportDiagnostics } from \"../log.ts\";\nimport { prepareProject } from \"../prepare.ts\";\n\nconst BUDGET_JS = \"budget-js\";\nconst BUDGET_CSS = \"budget-css\";\n\ninterface BudgetArgs {\n  \"budget-css\"?: string;\n  \"budget-js\"?: string;\n}\n\n/**\n * Reject a non-numeric performance budget. `Number(\"250kb\")` is `NaN` and\n * `total > NaN` is always false, so a typo'd flag would silently pass the gate;\n * fail up front instead.\n */\nconst validateBudgetFlags = (args: BudgetArgs): void => {\n  for (const flag of [BUDGET_JS, BUDGET_CSS] as const) {\n    const value = args[flag];\n    const parsed = Number(value);\n    // Equivalent to `!(parsed > 0)` but without the inverted check: this must\n    // also reject `NaN` (a typo'd flag like \"250kb\"), which `parsed <= 0` alone\n    // would let through since `NaN <= 0` is false.\n    if (value !== undefined && (Number.isNaN(parsed) || parsed <= 0)) {\n      logger.error(\n        `Invalid --${flag} \"${value}\" (expected a positive number of kB).`\n      );\n      process.exit(1);\n    }\n  }\n};\n\n/**\n * Report how many OG cards the build read back from the on-disk cache against\n * how many it rendered (the endpoint tallies both), so a warm rebuild shows\n * where the time went. With `prune`, also drop the cached cards this build\n * never asked for — renamed pages, edited descriptions, cards from an earlier\n * Blume version — so a persisted cache holds exactly the current site's cards.\n */\nconst reportCardCache = async (\n  project: BlumeProject,\n  prune: boolean\n): Promise<void> => {\n  const cards = cardCacheTally();\n  if (!cards) {\n    return;\n  }\n  logger.info(\n    `OG cards: ${cards.hits} reused from the cache, ${cards.misses} rendered`\n  );\n  if (prune) {\n    await pruneCardCache(ogCacheDir(project.context));\n  }\n};\n\nconst formatBytes = (bytes: number): string => {\n  if (bytes < 1024) {\n    return `${bytes} B`;\n  }\n  const digits = bytes < 1024 * 100 ? 1 : 0;\n  return `${(bytes / 1024).toFixed(digits)} kB`;\n};\n\n/** Sizes of `dist/_astro/*.<ext>`, largest first (empty when none exist). */\nconst astroAssets = async (\n  distDir: string,\n  ext: string\n): Promise<{ name: string; size: number }[]> => {\n  const astroDir = join(distDir, \"_astro\");\n  if (!existsSync(astroDir)) {\n    return [];\n  }\n  const entries = await readdir(astroDir);\n  const files = entries.filter((name) => name.endsWith(`.${ext}`));\n  const sized = await Promise.all(\n    files.map(async (name) => {\n      const info = await stat(join(astroDir, name));\n      return { name, size: info.size };\n    })\n  );\n  return sized.toSorted((a, b) => b.size - a.size);\n};\n\nconst totalSize = (assets: { size: number }[]): number =>\n  assets.reduce((sum, asset) => sum + asset.size, 0);\n\n/**\n * Print the client JavaScript Astro shipped, largest first, plus the total. A\n * dependency-free bundle report — the interactive weight of a docs site is its\n * `_astro/*.js`, so this surfaces regressions without a visualizer.\n */\nconst reportBundleSizes = async (distDir: string): Promise<void> => {\n  const sized = await astroAssets(distDir, \"js\");\n  if (sized.length === 0) {\n    logger.info(\"No client JavaScript emitted — the site ships zero JS.\");\n    return;\n  }\n  const rows = sized\n    .slice(0, 15)\n    .map((file) => `  ${formatBytes(file.size).padStart(8)}  ${file.name}`);\n  logger.box(\n    [\n      `Client JavaScript — ${sized.length} file(s), ${formatBytes(totalSize(sized))} total`,\n      \"\",\n      ...rows,\n      sized.length > 15 ? `  … and ${sized.length - 15} more` : null,\n    ]\n      .filter((line) => line !== null)\n      .join(\"\\n\")\n  );\n};\n\n/**\n * Enforce a performance budget on the built client assets: fail the build when\n * total `_astro/*.js` (or `*.css`) exceeds the given kB cap. Budgets that would\n * otherwise be \"documented, not measured\" become a real CI gate. Returns whether\n * every budget passed.\n */\nconst enforceBudget = async (\n  distDir: string,\n  args: BudgetArgs\n): Promise<\"fail\" | \"pass\" | \"skip\"> => {\n  const checks: { ext: string; limitKb: number; name: string }[] = [\n    ...(args[BUDGET_JS]\n      ? [{ ext: \"js\", limitKb: Number(args[BUDGET_JS]), name: \"JavaScript\" }]\n      : []),\n    ...(args[BUDGET_CSS]\n      ? [{ ext: \"css\", limitKb: Number(args[BUDGET_CSS]), name: \"CSS\" }]\n      : []),\n  ];\n  if (checks.length === 0) {\n    return \"skip\";\n  }\n  let passed = true;\n  for (const check of checks) {\n    // oxlint-disable-next-line no-await-in-loop -- a couple of sequential reads\n    const total = totalSize(await astroAssets(distDir, check.ext));\n    const limit = check.limitKb * 1024;\n    if (total > limit) {\n      passed = false;\n      logger.error(\n        `${check.name} budget exceeded: ${formatBytes(total)} > ${check.limitKb} kB`\n      );\n    } else {\n      logger.success(\n        `${check.name} budget: ${formatBytes(total)} / ${check.limitKb} kB`\n      );\n    }\n  }\n  return passed ? \"pass\" : \"fail\";\n};\n\n/**\n * Run the optional bundle report (`--analyze`) and performance-budget gate\n * against the directory whose `_astro/` client assets the deploy serves.\n * Shared by real and isolated builds — an isolated CI run passing\n * `--budget-js` must still fail on an exceeded budget rather than silently\n * skipping the check. Exits non-zero when a budget is exceeded.\n */\nexport const runClientAssetChecks = async (\n  staticDir: string,\n  args: { analyze?: boolean } & BudgetArgs\n): Promise<void> => {\n  if (args.analyze) {\n    await reportBundleSizes(staticDir);\n  }\n  if ((await enforceBudget(staticDir, args)) === \"fail\") {\n    process.exit(1);\n  }\n};\n\n/**\n * Print the build summary box and run the optional bundle report / budget\n * gate against the served static dir. The deploy artifacts themselves\n * (search index, llms.txt, sitemap, robots, redirect and header files, …)\n * were written by the integration's `astro:build:done` hook during\n * `build()` — see `deploy/artifacts.ts`. Exits non-zero if a budget is\n * exceeded.\n */\nconst reportBuild = async (\n  project: BlumeProject,\n  distDir: string,\n  args: { analyze?: boolean } & BudgetArgs\n): Promise<void> => {\n  const { config } = project;\n  const features = serverFeatures(config);\n  // The sitemap needs both the flag and a `site` (absolute URLs) — only the\n  // latter deserves the remediation hint.\n  const sitemapNote = config.seo.sitemap\n    ? \"no (set deployment.site)\"\n    : \"no (seo.sitemap is false)\";\n  const rows: [label: string, value: string | number][] = [\n    [\"Output\", config.deployment.options.output],\n    [\"Adapter\", config.deployment.kind],\n    [\"Site\", config.deployment.options.site ?? \"not set\"],\n    [\"Search\", config.search.provider.kind],\n    [\"Redirects\", config.redirects.length],\n    [\n      \"Sitemap\",\n      config.deployment.options.site && config.seo.sitemap\n        ? \"yes\"\n        : sitemapNote,\n    ],\n    [\"Robots\", config.seo.robots ? \"yes\" : \"no\"],\n    [\"Agent JSON\", config.agents.agentReadability ? \"yes\" : \"no\"],\n    [\"LLM files\", config.agents.llmsTxt.enabled ? \"yes\" : \"no\"],\n    [\"Server features\", features.length > 0 ? features.join(\", \") : \"none\"],\n  ];\n  // One label column for every row, sized by the longest label.\n  const labelWidth = Math.max(...rows.map(([label]) => label.length)) + 2;\n  logger.box(\n    rows\n      .map(([label, value]) => `${label.padEnd(labelWidth)}${value}`)\n      .join(\"\\n\")\n  );\n\n  await runClientAssetChecks(distDir, args);\n\n  // Only reachable with --no-strict (strict aborts earlier): repeat the missing\n  // count next to the success banner so it can't scroll away unseen.\n  if (project.droppedPages > 0) {\n    logger.warn(\n      `${project.droppedPages} page(s) failed validation and are missing from this build.`\n    );\n  }\n  logger.success(`Built to ${distDir}`);\n};\n\nexport const buildCommand = defineCommand({\n  args: {\n    analyze: {\n      description: \"Report client JavaScript bundle sizes after the build.\",\n      type: \"boolean\",\n    },\n    [BUDGET_CSS]: {\n      description: \"Fail if total client CSS exceeds this many kB.\",\n      type: \"string\",\n    },\n    [BUDGET_JS]: {\n      description: \"Fail if total client JavaScript exceeds this many kB.\",\n      type: \"string\",\n    },\n    isolated: {\n      description:\n        \"Build into an isolated .blume-verify runtime (and its own dist) so a running dev server and the real dist/ are untouched. For verifying changes while `blume dev` runs.\",\n      type: \"boolean\",\n    },\n    preview: {\n      description: \"Include drafts and unpublished CMS content.\",\n      type: \"boolean\",\n    },\n    strict: {\n      default: true,\n      description:\n        \"Fail on error diagnostics (default; pass --no-strict to build anyway, dropping pages that fail validation).\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.build,\n  async run({ args, rawArgs }) {\n    const root = process.cwd();\n\n    // citty accepts unknown flags, so a Blume 1 `--adapter vercel --output\n    // server` would otherwise build a static site without a word.\n    const removed = removedBuildFlags(rawArgs);\n    if (removed.length > 0) {\n      logger.error(\n        `blume build no longer takes ${flagList(removed)}. ${removedBuildFlagsAdvice(removed)}`\n      );\n      process.exit(1);\n    }\n    await refuseIfEjected(root, \"build\");\n\n    // `--isolated` (or BLUME_RUNTIME_DIR) relocates the whole runtime to a\n    // sibling dir so this build never touches a live dev server's `.blume/` or\n    // the user's real `dist/`. A non-default runtime dir has no dev lock, so the\n    // refusal below lets it proceed; a plain build still refuses.\n    const runtimeDir = args.isolated\n      ? \".blume-verify\"\n      : process.env.BLUME_RUNTIME_DIR;\n    refuseIfDevRunning(root, \"building\", { isolatedHint: true, runtimeDir });\n    if (args.isolated) {\n      await ensureGitignore(root, [\".blume-verify/\"]);\n    }\n\n    validateBudgetFlags(args);\n\n    const project = await prepareProject({\n      mode: \"build\",\n      preview: args.preview,\n      root,\n      runtimeDir,\n      strict: args.strict,\n    });\n\n    logger.start(\n      `Building ${project.graph.pages.length} page(s) (${project.config.deployment.options.output} output)`\n    );\n\n    // Hand the scanned project to the integration: its `astro:build:done`\n    // hook writes the deploy artifacts (search index, llms.txt, sitemap, …)\n    // into Astro's client output during the build. An isolated build is a\n    // throwaway verify that only needs to confirm the site compiles and\n    // renders, so it publishes nothing — no network post-steps (a hosted\n    // search sync would push), no deploy artifacts.\n    if (!runtimeDir) {\n      publishBuildProject(project);\n    }\n\n    try {\n      await build({\n        logLevel: \"info\",\n        root: project.context.outDir,\n      });\n    } catch (error) {\n      // Astro rejects when the site fails to compile or render (MDX that\n      // doesn't parse, a component that throws): report that as a build error\n      // at the file it names, not as an internal error blaming Blume. A\n      // BlumeError keeps its own diagnostic.\n      if (error instanceof BlumeError || !(error instanceof Error)) {\n        throw error;\n      }\n      reportDiagnostics(\n        await astroBuildDiagnostics(error, {\n          locate: buildFailureLocator(project),\n          root,\n        }),\n        root\n      );\n      process.exit(1);\n    }\n\n    // A real build also prunes the cache; an isolated verify must not evict\n    // cards a live dev server is still serving.\n    await reportCardCache(project, !runtimeDir);\n\n    // Everything the deploy target does differently after `astro build` comes\n    // off its platform (see `deploy/platforms/*`): a server build's post-build\n    // step (Vercel's function-bundle audit and negotiation routes, Cloudflare's\n    // wrapper Worker), and where its bundle and static assets landed.\n    const { deployment } = project.config;\n    const platform = deployPlatform(deployment);\n    const server = deployment.options.output === \"server\";\n    const finalize = async (isolated: boolean): Promise<void> => {\n      if (\n        server &&\n        platform.finalizeBuild &&\n        !(await platform.finalizeBuild({ isolated, log: logger, project }))\n      ) {\n        process.exit(1);\n      }\n    };\n\n    // The bundle report and budget gate still run for an isolated build —\n    // `blume build --isolated --budget-js 100` exiting 0 without measuring\n    // anything would be a silent false pass in CI. An isolated build never\n    // surfaces the adapter bundle to the project root, so its output dirs\n    // resolve under the relocated runtime.\n    if (runtimeDir) {\n      await finalize(true);\n      await runClientAssetChecks(\n        deployStaticDir(project.config, project.context),\n        args\n      );\n      logger.success(\n        `Isolated build OK — output at ${deployOutputDir(project.config, project.context)} (not published).`\n      );\n      return;\n    }\n\n    // A server adapter's deploy bundle is a build artifact — keep it out of\n    // version control (Vercel's own CLI ignores `.vercel/` for the same reason).\n    // Ignoring it is independent of whether the bundle had to be moved below:\n    // Vercel writes straight to the project root, Netlify does not.\n    const { ignoreDir } = platform.hiddenRuntime;\n    if (server && ignoreDir) {\n      await ensureGitignore(root, [ignoreDir]);\n    }\n\n    // Netlify writes its deploy bundle relative to the Astro root — which Blume\n    // points at the hidden `.blume` runtime — so the bundle lands where the\n    // deploy platform never looks. Surface it up to the project root before\n    // publishing artifacts into the served static dir.\n    const surfaced = await surfaceAdapterOutput(\n      project.config,\n      project.context\n    );\n    if (surfaced.moved) {\n      logger.success(`Surfaced ${deployment.kind} output to ${surfaced.to}`);\n    }\n\n    await finalize(false);\n\n    await reportBuild(\n      project,\n      deployStaticDir(project.config, project.context),\n      args\n    );\n  },\n});\n"
+  ],
+  "mappings": "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",
+  "debugId": "43360653920765D464756E2164756E21",
+  "names": []
+}

package/dist/cli/index.js

@@ -80,7 +80,7 @@ var commandMeta = {
     name: "mcp-stdio"
   },
   migrate: {
-    description: "Migrate a docs site from Mintlify, Fumadocs, Docusaurus, Starlight, or Nextra with a coding agent.",
+    description: "Migrate a docs site from Mintlify, Docusaurus, GitBook, MkDocs, ReadMe, or another framework with a coding agent.",
     name: "migrate"
   },
   preview: {
@@ -197,36 +197,61 @@ var DOCS_CONTENT_SOURCES = "/docs/content/sources";
 var DOCS_CONTENT_SOURCES_OBSIDIAN = "/docs/content/sources/obsidian";
 var DOCS_CONTENT_NAVIGATION = "/docs/content/navigation";
 var DOCS_CONTENT_INCLUDES = "/docs/content/includes";
+var DOCS_OPENAPI_WARNINGS = "/docs/references/openapi#spec-warnings";
+var DOCS_OTHER_TOOLS_SYNTAX = "/docs/content/syntax#syntax-from-other-tools";
+var DOCS_MARKDOWN_AND_MDX = "/docs/content#markdown-and-mdx";
 var DOCS_PATHS = new Map(Object.entries({
   BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,
-  BLUME_ASSETS_UNCHECKED: DOCS_CLI_VALIDATE,
   BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,
   BLUME_BROKEN_ANCHOR: DOCS_CLI_VALIDATE,
   BLUME_BROKEN_ASSET: DOCS_CLI_VALIDATE,
   BLUME_BROKEN_LINK: DOCS_CLI_VALIDATE,
+  BLUME_BROKEN_REDIRECT: DOCS_CLI_VALIDATE,
+  BLUME_CODE_FENCE_OPTION: "/docs/content/syntax",
   BLUME_COMPONENTS_INVALID: "/docs/configuration/customization",
   BLUME_CONFIG_INVALID: "/docs/configuration",
   BLUME_CONFIG_LOAD_FAILED: "/docs/configuration",
   BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
   BLUME_DEAD_LINK: DOCS_CLI_VALIDATE,
   BLUME_DEPENDENCY_MISSING: "/docs/cli/doctor",
+  BLUME_DIRECTIVE_CLOSING_TEXT: "/docs/content/syntax",
+  BLUME_DIRECTIVE_OPENING_TEXT: "/docs/content/syntax",
+  BLUME_DIRECTIVE_SPACED_NAME: "/docs/content/syntax",
   BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,
   BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,
   BLUME_EXAMPLE_NOT_FOUND: "/docs/content/components#component",
   BLUME_FRONTMATTER_INVALID: "/docs/content/frontmatter",
+  BLUME_GRAPHQL_UNKNOWN_CODE_SAMPLE: "/docs/references/graphql",
   BLUME_INCLUDE_CYCLE: DOCS_CONTENT_INCLUDES,
   BLUME_INCLUDE_MALFORMED: DOCS_CONTENT_INCLUDES,
   BLUME_INCLUDE_NOT_FOUND: DOCS_CONTENT_INCLUDES,
   BLUME_INCLUDE_OUTSIDE_ROOT: DOCS_CONTENT_INCLUDES,
+  BLUME_MDC_SYNTAX: DOCS_OTHER_TOOLS_SYNTAX,
+  BLUME_MDX_ATTRIBUTE_LIST: DOCS_OTHER_TOOLS_SYNTAX,
   BLUME_MDX_CURLY_ANCHOR: "/docs/content/syntax",
+  BLUME_MDX_EVENT_HANDLER: "/docs/content/islands",
+  BLUME_MDX_SYNTAX: DOCS_MARKDOWN_AND_MDX,
+  BLUME_MDX_UNCLOSED_ELEMENT: DOCS_OTHER_TOOLS_SYNTAX,
+  BLUME_MDX_UNDEFINED_NAME: DOCS_MARKDOWN_AND_MDX,
+  BLUME_MD_ATTRIBUTE_LIST: DOCS_OTHER_TOOLS_SYNTAX,
+  BLUME_MD_CURLY_ANCHOR: "/docs/content/syntax",
+  BLUME_MD_DIRECTIVE: "/docs/content/syntax",
+  BLUME_MD_GITHUB_ALERT: "/docs/content/syntax",
   BLUME_META_INVALID: "/docs/content/meta",
   BLUME_META_LOAD_FAILED: "/docs/content/meta",
+  BLUME_META_OUTSIDE_INCLUDE: "/docs/content/meta",
+  BLUME_META_UNKNOWN_PAGE: "/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_OPENAPI_DUPLICATE_OPERATION_ID: DOCS_OPENAPI_WARNINGS,
+  BLUME_OPENAPI_LOCAL_SERVER: DOCS_OPENAPI_WARNINGS,
+  BLUME_OPENAPI_NULLABLE: DOCS_OPENAPI_WARNINGS,
+  BLUME_OPENAPI_UNKNOWN_CODE_SAMPLE: "/docs/references/openapi#code-samples-and-schemas",
+  BLUME_PUBLIC_OPENAPI_JSON: "/docs/discoverability/json-api",
   BLUME_SEARCH_SYNC_FAILED: "/docs/configuration/search",
   BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,
   BLUME_SIDEBAR_DISPLAY_IGNORED: DOCS_CONTENT_NAVIGATION,
@@ -238,15 +263,23 @@ var DOCS_PATHS = new Map(Object.entries({
   BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,
   BLUME_SOURCE_UNRESOLVED_LINK: "/docs/content/sources/contentful",
   BLUME_SOURCE_UNSUPPORTED_NODE: "/docs/content/sources/payload",
+  BLUME_SVG_UNOPTIMIZED: "/docs/content/syntax#links-and-images",
+  BLUME_TEMPLATE_TAG: DOCS_OTHER_TOOLS_SYNTAX,
+  BLUME_THEME_COLOR_INVALID: "/docs/configuration/theming",
   BLUME_TRANSLATE_MISSING: "/docs/cli/translate",
   BLUME_TRANSLATE_STALE: "/docs/cli/translate",
+  BLUME_TSCONFIG_EXTENDS: "/docs/cli#type-checking",
+  BLUME_UNKNOWN_CODE_LANGUAGE: "/docs/content/syntax",
   BLUME_UNKNOWN_COMPONENT: "/docs/configuration/customization",
   BLUME_UNKNOWN_DIRECTIVE: "/docs/content/syntax",
   BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION,
   BLUME_UNKNOWN_OPTION: "/docs/cli",
+  BLUME_UNKNOWN_PROP: "/docs/content/components",
   BLUME_UNLOADABLE_FILE_NAME: "/docs/content",
+  BLUME_UNSUPPORTED_LINK_SCHEME: DOCS_CLI_VALIDATE,
   BLUME_WIKILINK_AMBIGUOUS: DOCS_CONTENT_SOURCES_OBSIDIAN,
   BLUME_WIKILINK_UNRESOLVED: DOCS_CONTENT_SOURCES_OBSIDIAN,
+  BLUME_WIKILINK_UNSUPPORTED: DOCS_OTHER_TOOLS_SYNTAX,
   BLUME_YARN_PNP: "/docs/quickstart"
 }));
 var resolveDocsUrl = (code) => {
@@ -515,6 +548,29 @@ ${summary}
   return hasErrors(diagnostics);
 };
 
+// src/core/closest-match.ts
+var distance = (from, to) => {
+  let previous = Array.from({ length: to.length + 1 }, (_, index) => index);
+  for (const [row, fromChar] of [...from].entries()) {
+    const current = [row + 1];
+    for (const [column, toChar] of [...to].entries()) {
+      current.push(Math.min((previous[column + 1] ?? 0) + 1, (current[column] ?? 0) + 1, (previous[column] ?? 0) + (fromChar === toChar ? 0 : 1)));
+    }
+    previous = current;
+  }
+  return previous[to.length] ?? 0;
+};
+var closestMatch = (name, candidates) => {
+  let best;
+  for (const candidate of candidates) {
+    const edits = distance(name, candidate);
+    if (edits <= 2 && edits * 2 < candidate.length && (best === undefined || edits < best.edits)) {
+      best = { candidate, edits };
+    }
+  }
+  return best?.candidate;
+};
+
 // src/cli/unknown-flags.ts
 var kebabCase = (name) => name.replaceAll(/(?<upper>[A-Z])/gu, (letter) => `-${letter.toLowerCase()}`);
 var camelCase = (name) => name.replaceAll(/-(?<letter>[a-z])/gu, (match) => match.slice(1).toUpperCase());
@@ -550,27 +606,6 @@ var knownFlags = (argsDef) => {
   }
   return flags;
 };
-var distance = (from, to) => {
-  let previous = Array.from({ length: to.length + 1 }, (_, index) => index);
-  for (const [row, fromChar] of [...from].entries()) {
-    const current = [row + 1];
-    for (const [column, toChar] of [...to].entries()) {
-      current.push(Math.min((previous[column + 1] ?? 0) + 1, (current[column] ?? 0) + 1, (previous[column] ?? 0) + (fromChar === toChar ? 0 : 1)));
-    }
-    previous = current;
-  }
-  return previous[to.length] ?? 0;
-};
-var closestMatch = (name, candidates) => {
-  let best;
-  for (const candidate of candidates) {
-    const edits = distance(name, candidate);
-    if (edits <= 2 && edits * 2 < candidate.length && (best === undefined || edits < best.edits)) {
-      best = { candidate, edits };
-    }
-  }
-  return best?.candidate;
-};
 var parseToken = (arg) => {
   const long = arg.startsWith("--");
   const [name = ""] = arg.slice(long ? 2 : 1).split("=");
@@ -690,24 +725,24 @@ var main = defineCommand({
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-1f882900.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-32khwcb6.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-36bxs9c7.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-0w6hs479.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-gxtg6ed2.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-twy7psdz.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-gfc5fqvf.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-bqxaqn5p.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-sc93apfs.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-ave1wcbr.js"), "mcpStdioCommand"),
-    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-kdpzw38a.js"), "migrateCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-ydp3065p.js"), "previewCommand"),
-    skill: lazyCommand(commandMeta.skill, () => import("./chunk-a57yh0h9.js"), "skillCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-y4msrwm9.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-bxwhtvw8.js"), "translateCommand"),
-    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-hvcxng5f.js"), "upgradeCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-60hz265r.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-58bt3hag.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-th0pgaj5.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-49r370mb.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-xt0qvz1t.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-rkqae7kh.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-vzy9rh6y.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-enk76qd5.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-br0n8n3e.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-t5xx74rd.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-frk2wdq1.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-m9bp2hc1.js"), "mcpStdioCommand"),
+    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-gprwej7h.js"), "migrateCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-cn3dy3hz.js"), "previewCommand"),
+    skill: lazyCommand(commandMeta.skill, () => import("./chunk-dyk3r7jw.js"), "skillCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-xgq4eytj.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-ahc5gc9h.js"), "translateCommand"),
+    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-7tekknev.js"), "upgradeCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-dpcahcrb.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-mrvh4c88.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());
@@ -729,6 +764,7 @@ export {
   reportInternalError,
   BlumeError,
   enrichDiagnostic,
+  locatePath,
   locateFrontmatterKey,
   diagnosticsFromIssues,
   diagnosticsFromZod,
@@ -742,5 +778,5 @@ export {
   closestMatch
 };
 
-//# debugId=D285C7A054BEC2C764756E2164756E21
+//# debugId=0853E5F28957397564756E2164756E21
 //# sourceMappingURL=index.js.map