blume 2.1.3 → 2.2.1

package/dist/cli/chunk-487b95qy.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+import {
+  normalizeBasePath,
+  normalizePath,
+  mountBasePath,
+  siteRoot,
+  absoluteUrl2
+} from "./chunk-zccbjcj0.js";
+import {
+  OPENAPI_PATH,
+  API_PAGES_PATH,
+  API_NAVIGATION_PATH,
+  API_SEARCH_PATH,
+  API_CATALOG_PATH,
+  hasApiCatalog,
+  buildApiCatalog,
+  AGENT_SKILLS_INDEX_PATH,
+  servesSkillsIndex,
+  AI_CATALOG_PATH,
+  ARD_MANIFEST_PATH,
+  hasAiCatalog,
+  buildAiCatalog,
+  discoverPagesSync,
+  customStaticRoutes,
+  hasGeneratedChangelog,
+  repoUrl,
+  isHiddenPage,
+  buildRssFeeds,
+  staticFileResolver,
+  SIGNATURES_DIRECTORY_PATH,
+  buildSignaturesDirectory,
+  deployPlatform
+} from "./chunk-r5nm9w0c.js";
+import {
+  SKILL_MD_PATH
+} from "./chunk-q1wwrxzw.js";
+
+// src/deploy/generated-files.ts
+import { join } from "pathe";
+
+// src/ai/agent-readability.ts
+var USAGE_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var usagePolicy = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  return Object.fromEntries(USAGE_TOKENS.map(([key, token]) => [token, signals[key]]));
+};
+var askApiUrl = (endpoint, site, abs) => {
+  if (!endpoint) {
+    return abs("/api/ask");
+  }
+  return site && endpoint.startsWith("/") ? absoluteUrl2(site, endpoint) : endpoint;
+};
+var markdownArtifact = (config, abs) => {
+  const negotiates = config.deployment.options.output === "server" && deployPlatform(config.deployment).negotiatesMarkdown;
+  return negotiates ? { contentNegotiation: "text/markdown", pattern: abs("/{route}.md") } : { pattern: abs("/{route}.md") };
+};
+var apiArtifact = (config, abs) => {
+  if (!config.agents.api) {
+    return null;
+  }
+  const api = {
+    openapi: abs(OPENAPI_PATH),
+    pages: abs(API_PAGES_PATH)
+  };
+  if (config.deployment.options.output === "server") {
+    api.search = abs(API_SEARCH_PATH);
+  }
+  return api;
+};
+var wellKnownArtifacts = (config, abs) => {
+  const artifacts = {};
+  if (config.agents.webBotAuth.keys.length > 0) {
+    artifacts.httpMessageSignaturesDirectory = abs("/.well-known/http-message-signatures-directory");
+  }
+  if (hasAiCatalog(config)) {
+    artifacts.aiCatalog = abs(AI_CATALOG_PATH);
+  }
+  if (hasApiCatalog(config)) {
+    artifacts.apiCatalog = abs("/.well-known/api-catalog");
+  }
+  if (servesSkillsIndex(config)) {
+    artifacts.agentSkills = abs("/.well-known/agent-skills/index.json");
+  }
+  return artifacts;
+};
+var buildAgentReadability = (project) => {
+  const { config } = project;
+  if (!config.agents.agentReadability) {
+    return null;
+  }
+  const site = config.deployment.options.site ?? null;
+  const deployBase = normalizeBasePath(config.deployment.options.base);
+  const abs = (path) => {
+    const based = mountBasePath(deployBase, path);
+    return site ? absoluteUrl2(site, based) : based;
+  };
+  const artifacts = {
+    markdown: markdownArtifact(config, abs)
+  };
+  const api = apiArtifact(config, abs);
+  if (api) {
+    artifacts.api = api;
+  }
+  if (config.agents.llmsTxt.enabled) {
+    artifacts.llmsFullTxt = abs("/llms-full.txt");
+    artifacts.llmsTxt = abs("/llms.txt");
+  }
+  if (config.agents.mcp.enabled) {
+    artifacts.mcp = {
+      discovery: abs("/.well-known/mcp.json"),
+      url: abs(config.agents.mcp.route)
+    };
+  }
+  if (config.ai.assistant?.enabled) {
+    artifacts.askApi = askApiUrl(config.ai.assistant.endpoint, site, abs);
+  }
+  Object.assign(artifacts, wellKnownArtifacts(config, abs));
+  if (site && config.seo.sitemap) {
+    artifacts.sitemap = abs("/sitemap.xml");
+  }
+  const feeds = site && config.seo.rss.enabled ? buildRssFeeds(project).map((feed) => abs(feed.path)) : [];
+  if (feeds.length > 0) {
+    artifacts.feeds = feeds;
+  }
+  const version = project.manifest?.blumeVersion;
+  const manifest = {
+    artifacts,
+    description: config.description,
+    generator: version ? `blume@${version}` : undefined,
+    name: config.agents.mcp.name ?? config.title,
+    site
+  };
+  const usage = usagePolicy(config.agents.contentSignals);
+  if (usage) {
+    manifest.contentUsage = usage;
+  }
+  if (config.github) {
+    manifest.repository = repoUrl(config.github);
+  }
+  return manifest;
+};
+
+// src/deploy/robots.ts
+var SIGNAL_TOKENS = [
+  ["search", "search"],
+  ["aiInput", "ai-input"],
+  ["aiTrain", "ai-train"]
+];
+var contentSignalLine = (signals) => {
+  if (!signals) {
+    return null;
+  }
+  const tokens = SIGNAL_TOKENS.map(([key, token]) => `${token}=${signals[key] ? "yes" : "no"}`);
+  return `Content-Signal: ${tokens.join(", ")}`;
+};
+var buildRobots = (project) => {
+  const { config } = project;
+  if (!config.seo.robots) {
+    return null;
+  }
+  const lines = ["User-agent: *"];
+  const signal = contentSignalLine(config.agents.contentSignals);
+  if (signal) {
+    lines.push(signal);
+  }
+  lines.push("Allow: /");
+  const { site } = config.deployment.options;
+  if (site && config.seo.sitemap) {
+    const sitemapPath = mountBasePath(normalizeBasePath(config.deployment.options.base), "/sitemap.xml");
+    lines.push("", `Sitemap: ${absoluteUrl2(site, sitemapPath)}`);
+  }
+  return `${lines.join(`
+`)}
+`;
+};
+
+// src/deploy/sitemap.ts
+import { escape as escapeXml } from "html-escaper";
+var ERROR_ROUTES = new Set(["/404", "/500"]);
+var lastmodTag = (value) => {
+  if (!value) {
+    return "";
+  }
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? "" : `<lastmod>${date.toISOString().slice(0, 10)}</lastmod>`;
+};
+var canonicalElsewhere = (canonical, served) => {
+  if (!canonical) {
+    return false;
+  }
+  const { pathname } = new URL(canonical);
+  let path = pathname;
+  try {
+    path = decodeURI(pathname);
+  } catch {}
+  return normalizePath(path) !== normalizePath(served);
+};
+var URLS_PER_FILE = 50000;
+var renderUrlset = (urls) => `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls.join(`
+`)}
+</urlset>
+`;
+var buildSitemapFiles = (project) => {
+  const { site } = project.config.deployment.options;
+  if (!(site && project.config.seo.sitemap)) {
+    return null;
+  }
+  const base = siteRoot(site);
+  const deployBase = normalizeBasePath(project.config.deployment.options.base);
+  const { versions } = project.config;
+  const archivedById = new Map((versions?.archived ?? []).map((version) => [version.id, version]));
+  const currentKeys = versions ? new Set(project.graph.pages.flatMap((page) => page.version === "" ? [`${page.versionKey}\x00${page.locale}`] : [])) : null;
+  const archivedExcluded = (page) => {
+    if (!page.version) {
+      return false;
+    }
+    const archived = archivedById.get(page.version);
+    return Boolean(archived?.noindex || archived?.canonical === "latest" && !page.meta.seo.canonical && currentKeys?.has(`${page.versionKey}\x00${page.locale}`));
+  };
+  const seen = new Set;
+  const urls = [];
+  const pushUrl = (route, lastModified) => {
+    const loc = escapeXml(encodeURI(`${base}${route}`));
+    if (seen.has(loc)) {
+      return;
+    }
+    seen.add(loc);
+    urls.push(`  <url><loc>${loc}</loc>${lastmodTag(lastModified)}</url>`);
+  };
+  for (const page of project.graph.pages) {
+    const served = mountBasePath(deployBase, page.route);
+    if (page.meta.draft || isHiddenPage(page, project.graph) || page.meta.seo.noindex || ERROR_ROUTES.has(page.route) || archivedExcluded(page) || canonicalElsewhere(page.meta.seo.canonical, served)) {
+      continue;
+    }
+    pushUrl(served, page.lastModified);
+  }
+  const userPages = project.context.pagesRoot ? discoverPagesSync(project.context.pagesRoot) : [];
+  const extraRoutes = customStaticRoutes(userPages).filter((route) => !ERROR_ROUTES.has(route));
+  if (hasGeneratedChangelog(project, userPages)) {
+    extraRoutes.push("/changelog");
+  }
+  for (const route of extraRoutes) {
+    pushUrl(mountBasePath(deployBase, route));
+  }
+  urls.sort();
+  if (urls.length <= URLS_PER_FILE) {
+    return [{ name: "sitemap.xml", xml: renderUrlset(urls) }];
+  }
+  const chunks = [];
+  const references = [];
+  for (let start = 0;start < urls.length; start += URLS_PER_FILE) {
+    const name = `sitemap-${chunks.length + 1}.xml`;
+    chunks.push({
+      name,
+      xml: renderUrlset(urls.slice(start, start + URLS_PER_FILE))
+    });
+    const loc = escapeXml(encodeURI(`${base}${mountBasePath(deployBase, `/${name}`)}`));
+    references.push(`  <sitemap><loc>${loc}</loc></sitemap>`);
+  }
+  const index = `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${references.join(`
+`)}
+</sitemapindex>
+`;
+  return [{ name: "sitemap.xml", xml: index }, ...chunks];
+};
+
+// src/deploy/generated-files.ts
+var wellKnownFiles = (config, skills) => {
+  const aiCatalog = buildAiCatalog(config, skills);
+  return [
+    {
+      content: buildSignaturesDirectory(config),
+      label: "Web Bot Auth",
+      path: SIGNATURES_DIRECTORY_PATH
+    },
+    {
+      content: buildApiCatalog(config),
+      label: "RFC 9727",
+      path: API_CATALOG_PATH
+    },
+    { content: aiCatalog, label: "AI Catalog", path: AI_CATALOG_PATH },
+    { content: aiCatalog, label: "ARD manifest", path: ARD_MANIFEST_PATH }
+  ];
+};
+var generatedFilePaths = (project) => {
+  const { config } = project;
+  const paths = [];
+  if (config.agents.llmsTxt.enabled) {
+    paths.push("/llms.txt", "/llms-full.txt");
+  }
+  paths.push(...(buildSitemapFiles(project) ?? []).map((file) => `/${file.name}`));
+  if (buildRobots(project)) {
+    paths.push("/robots.txt");
+  }
+  if (buildAgentReadability(project)) {
+    paths.push("/agent-readability.json");
+  }
+  paths.push(...wellKnownFiles(config, []).flatMap((file) => file.content ? [file.path] : []));
+  if (servesSkillsIndex(config)) {
+    paths.push(AGENT_SKILLS_INDEX_PATH);
+    if (config.agents.skillMd) {
+      paths.push(SKILL_MD_PATH);
+    }
+  }
+  paths.push(...buildRssFeeds(project).map((feed) => feed.path));
+  if (config.agents.api) {
+    paths.push(OPENAPI_PATH, API_PAGES_PATH, API_NAVIGATION_PATH);
+  }
+  if (config.agents.mcp.enabled) {
+    paths.push("/.well-known/mcp.json", "/.well-known/mcp/server-card.json");
+  }
+  return paths;
+};
+var servedFiles = (project) => staticFileResolver(join(project.context.root, "public"), generatedFilePaths(project));
+
+export { generatedFilePaths, servedFiles };
+
+//# debugId=AFE0F5252B96AD6064756E2164756E21
+//# sourceMappingURL=chunk-487b95qy.js.map

package/dist/cli/chunk-487b95qy.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/deploy/generated-files.ts", "../src/ai/agent-readability.ts", "../src/deploy/robots.ts", "../src/deploy/sitemap.ts"],
+  "sourcesContent": [
+    "import { join } from \"pathe\";\n\nimport { buildAgentReadability } from \"../ai/agent-readability.ts\";\nimport {\n  AI_CATALOG_PATH,\n  ARD_MANIFEST_PATH,\n  buildAiCatalog,\n} from \"../ai/ai-catalog.ts\";\nimport { API_CATALOG_PATH, buildApiCatalog } from \"../ai/api-catalog.ts\";\nimport {\n  API_NAVIGATION_PATH,\n  API_PAGES_PATH,\n  OPENAPI_PATH,\n} from \"../ai/api/paths.ts\";\nimport { SKILL_MD_PATH } from \"../ai/site-skill.ts\";\nimport { AGENT_SKILLS_INDEX_PATH, servesSkillsIndex } from \"../ai/skills.ts\";\nimport type { SkillArtifact } from \"../ai/skills.ts\";\nimport {\n  buildSignaturesDirectory,\n  SIGNATURES_DIRECTORY_PATH,\n} from \"../ai/web-bot-auth.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport { staticFileResolver } from \"../core/static-files.ts\";\nimport { buildRobots } from \"./robots.ts\";\nimport { buildRssFeeds } from \"./rss.ts\";\nimport { buildSitemapFiles } from \"./sitemap.ts\";\n\n/** A generated `.well-known` discovery document: `null` content when it's off. */\nexport interface WellKnownFile {\n  content: string | null;\n  label: string;\n  path: string;\n}\n\n/**\n * The generated `.well-known` discovery documents — the Web Bot Auth signature\n * directory, the RFC 9727 API catalog, and the AI catalog under both the\n * ai-catalog spec's well-known URI and the ARD v0.91 one (see\n * `ai/ai-catalog.ts`) — each with `null` content when its feature is off.\n */\nexport const wellKnownFiles = (\n  config: ResolvedConfig,\n  skills: readonly SkillArtifact[]\n): WellKnownFile[] => {\n  const aiCatalog = buildAiCatalog(config, skills);\n  return [\n    {\n      content: buildSignaturesDirectory(config),\n      label: \"Web Bot Auth\",\n      path: SIGNATURES_DIRECTORY_PATH,\n    },\n    {\n      content: buildApiCatalog(config),\n      label: \"RFC 9727\",\n      path: API_CATALOG_PATH,\n    },\n    { content: aiCatalog, label: \"AI Catalog\", path: AI_CATALOG_PATH },\n    { content: aiCatalog, label: \"ARD manifest\", path: ARD_MANIFEST_PATH },\n  ];\n};\n\n/**\n * The files a build serves beside its pages that don't come from `public/`,\n * as base-less root-relative paths: what `publishBuildArtifacts` writes once\n * Astro is done (llms.txt, the sitemap, robots.txt, `agent-readability.json`,\n * the `.well-known` discovery documents, the Agent Skills index, `skill.md`)\n * and the generated endpoints at fixed paths (the RSS feeds, the JSON docs\n * API and its OpenAPI description, the MCP discovery documents). Each is\n * listed under the gate its writer reads, so a feature the config switches\n * off drops its file here too: `blume validate` accepts a link to\n * `/llms.txt` exactly when the build writes one.\n *\n * Read from the config alone, before a build: the skill archives a build\n * publishes beside the index, and the platform files (`_redirects`,\n * `_headers`, `vercel.json`), aren't listed. A page's Markdown copy\n * (`/guide.md`) is its route's, and resolves through the page.\n */\nexport const generatedFilePaths = (project: BlumeProject): string[] => {\n  const { config } = project;\n  const paths: string[] = [];\n  if (config.agents.llmsTxt.enabled) {\n    paths.push(\"/llms.txt\", \"/llms-full.txt\");\n  }\n  paths.push(\n    ...(buildSitemapFiles(project) ?? []).map((file) => `/${file.name}`)\n  );\n  if (buildRobots(project)) {\n    paths.push(\"/robots.txt\");\n  }\n  if (buildAgentReadability(project)) {\n    paths.push(\"/agent-readability.json\");\n  }\n  paths.push(\n    ...wellKnownFiles(config, []).flatMap((file) =>\n      file.content ? [file.path] : []\n    )\n  );\n  if (servesSkillsIndex(config)) {\n    paths.push(AGENT_SKILLS_INDEX_PATH);\n    if (config.agents.skillMd) {\n      paths.push(SKILL_MD_PATH);\n    }\n  }\n  paths.push(...buildRssFeeds(project).map((feed) => feed.path));\n  if (config.agents.api) {\n    paths.push(OPENAPI_PATH, API_PAGES_PATH, API_NAVIGATION_PATH);\n  }\n  if (config.agents.mcp.enabled) {\n    paths.push(\"/.well-known/mcp.json\", \"/.well-known/mcp/server-card.json\");\n  }\n  return paths;\n};\n\n/**\n * Whether a base-less path is a file the project's site serves beside its\n * pages: one in `public/` (`/spec.pdf`, a folder's `index.html`) or one the\n * build generates (`/llms.txt`). What `generateRuntime` and `blume doctor`\n * check navigation entries against, beside the routes, as `blume validate`\n * checks links.\n */\nexport const servedFiles = (\n  project: BlumeProject\n): ((path: string) => boolean) =>\n  staticFileResolver(\n    join(project.context.root, \"public\"),\n    generatedFilePaths(project)\n  );\n",
+    "import { mountBasePath, normalizeBasePath } from \"../core/base-path.ts\";\nimport { repoUrl } from \"../core/github.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ContentSignalPolicy, ContentSignals } from \"../core/schema.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\nimport { deployPlatform } from \"../deploy/platforms/index.ts\";\nimport { buildRssFeeds } from \"../deploy/rss.ts\";\nimport { AI_CATALOG_PATH, hasAiCatalog } from \"./ai-catalog.ts\";\nimport { hasApiCatalog } from \"./api-catalog.ts\";\nimport { API_PAGES_PATH, API_SEARCH_PATH, OPENAPI_PATH } from \"./api/paths.ts\";\nimport { servesSkillsIndex } from \"./skills.ts\";\n\n/** Token map for the machine-readable content-usage echo. */\nconst USAGE_TOKENS: [keyof ContentSignalPolicy, string][] = [\n  [\"search\", \"search\"],\n  [\"aiInput\", \"ai-input\"],\n  [\"aiTrain\", \"ai-train\"],\n];\n\n/**\n * The configured usage preferences as a `{ token: allowed }` object, or null\n * when the declaration is disabled (`contentSignals: false`). Mirrors the\n * robots.txt `Content-Signal` line so an agent that reads the manifest instead\n * of robots.txt sees the same policy.\n */\nconst usagePolicy = (\n  signals: ContentSignals\n): Record<string, boolean> | null => {\n  if (!signals) {\n    return null;\n  }\n  return Object.fromEntries(\n    USAGE_TOKENS.map(([key, token]) => [token, signals[key]] as const)\n  );\n};\n\n/**\n * The advertised assistant URL. An external endpoint is not served under\n * `deployment.base`, so a root-relative one absolutizes against the site\n * origin alone; the built-in route gets site and base via `abs`.\n */\nconst askApiUrl = (\n  endpoint: string | undefined,\n  site: string | null,\n  abs: (path: string) => string\n): string => {\n  if (!endpoint) {\n    return abs(\"/api/ask\");\n  }\n  return site && endpoint.startsWith(\"/\")\n    ? absoluteUrl(site, endpoint)\n    : endpoint;\n};\n\n/** The `.well-known` discovery URLs a site can publish. */\ninterface WellKnownArtifacts {\n  httpMessageSignaturesDirectory?: string;\n  aiCatalog?: string;\n  apiCatalog?: string;\n  agentSkills?: string;\n}\n\n/** The JSON docs API's entry points; `search` exists on server output only. */\ninterface ApiArtifact {\n  openapi: string;\n  pages: string;\n  search?: string;\n}\n\n/** The agent-facing artifact index the manifest publishes. */\ninterface AgentArtifacts extends WellKnownArtifacts {\n  markdown: { contentNegotiation?: string; pattern: string };\n  api?: ApiArtifact;\n  llmsFullTxt?: string;\n  llmsTxt?: string;\n  mcp?: { discovery: string; url: string };\n  askApi?: string;\n  sitemap?: string;\n  feeds?: string[];\n}\n\n/** The published `agent-readability.json` document. */\nexport interface AgentReadabilityManifest {\n  artifacts: AgentArtifacts;\n  description?: string;\n  generator?: string;\n  name: string;\n  site: string | null;\n  contentUsage?: Record<string, boolean>;\n  repository?: string;\n}\n\n/**\n * The raw-Markdown mirror pattern. `Accept: text/markdown` negotiation is\n * advertised only where the deployed site actually honors it — a server build\n * on a platform that declares `negotiatesMarkdown` (Vercel, whose routing\n * config gets the rewrite rules; Cloudflare, whose deploy bundle gets a\n * wrapper Worker — see `deploy/platforms/*`). Static builds and other\n * adapters serve prerendered pages from a static layer with no request-time\n * hook, so agents there should fetch the `.md` pattern directly.\n */\nconst markdownArtifact = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): AgentArtifacts[\"markdown\"] => {\n  const negotiates =\n    config.deployment.options.output === \"server\" &&\n    deployPlatform(config.deployment).negotiatesMarkdown;\n  return negotiates\n    ? { contentNegotiation: \"text/markdown\", pattern: abs(\"/{route}.md\") }\n    : { pattern: abs(\"/{route}.md\") };\n};\n\n/** The JSON docs API's entry points, or null when the API is off. */\nconst apiArtifact = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): ApiArtifact | null => {\n  if (!config.agents.api) {\n    return null;\n  }\n  const api: ApiArtifact = {\n    openapi: abs(OPENAPI_PATH),\n    pages: abs(API_PAGES_PATH),\n  };\n  if (config.deployment.options.output === \"server\") {\n    api.search = abs(API_SEARCH_PATH);\n  }\n  return api;\n};\n\n/** The `.well-known` discovery artifacts the site publishes, if any. */\nconst wellKnownArtifacts = (\n  config: BlumeProject[\"config\"],\n  abs: (path: string) => string\n): WellKnownArtifacts => {\n  const artifacts: WellKnownArtifacts = {};\n  if (config.agents.webBotAuth.keys.length > 0) {\n    artifacts.httpMessageSignaturesDirectory = abs(\n      \"/.well-known/http-message-signatures-directory\"\n    );\n  }\n  if (hasAiCatalog(config)) {\n    artifacts.aiCatalog = abs(AI_CATALOG_PATH);\n  }\n  if (hasApiCatalog(config)) {\n    artifacts.apiCatalog = abs(\"/.well-known/api-catalog\");\n  }\n  if (servesSkillsIndex(config)) {\n    artifacts.agentSkills = abs(\"/.well-known/agent-skills/index.json\");\n  }\n  return artifacts;\n};\n\n/**\n * Build `agent-readability.json`: a root manifest that indexes the project's\n * agent-facing surface — llms.txt, the raw-Markdown mirrors, the JSON docs\n * API and its OpenAPI description, the MCP server, the assistant, sitemap, and feeds\n * — so agents can discover and cite the docs without\n * scraping HTML. URLs are absolute when a `site` is configured and root-relative\n * (still under `deployment.base`) otherwise. Returns null when the manifest is\n * disabled.\n */\nexport const buildAgentReadability = (\n  project: BlumeProject\n): AgentReadabilityManifest | null => {\n  const { config } = project;\n  if (!config.agents.agentReadability) {\n    return null;\n  }\n\n  const site = config.deployment.options.site ?? null;\n  // Every artifact is served under `deployment.base` — with or without a\n  // `site`; concatenate rather than `new URL()` so the subpath is preserved.\n  const deployBase = normalizeBasePath(config.deployment.options.base);\n  const abs = (path: string): string => {\n    const based = mountBasePath(deployBase, path);\n    return site ? absoluteUrl(site, based) : based;\n  };\n\n  const artifacts: AgentArtifacts = {\n    markdown: markdownArtifact(config, abs),\n  };\n  const api = apiArtifact(config, abs);\n  if (api) {\n    artifacts.api = api;\n  }\n  if (config.agents.llmsTxt.enabled) {\n    artifacts.llmsFullTxt = abs(\"/llms-full.txt\");\n    artifacts.llmsTxt = abs(\"/llms.txt\");\n  }\n  if (config.agents.mcp.enabled) {\n    artifacts.mcp = {\n      discovery: abs(\"/.well-known/mcp.json\"),\n      url: abs(config.agents.mcp.route),\n    };\n  }\n  if (config.ai.assistant?.enabled) {\n    artifacts.askApi = askApiUrl(config.ai.assistant.endpoint, site, abs);\n  }\n  Object.assign(artifacts, wellKnownArtifacts(config, abs));\n  if (site && config.seo.sitemap) {\n    artifacts.sitemap = abs(\"/sitemap.xml\");\n  }\n  const feeds =\n    site && config.seo.rss.enabled\n      ? buildRssFeeds(project).map((feed) => abs(feed.path))\n      : [];\n  if (feeds.length > 0) {\n    artifacts.feeds = feeds;\n  }\n\n  const version = project.manifest?.blumeVersion;\n  const manifest: AgentReadabilityManifest = {\n    artifacts,\n    description: config.description,\n    generator: version ? `blume@${version}` : undefined,\n    name: config.agents.mcp.name ?? config.title,\n    site,\n  };\n\n  const usage = usagePolicy(config.agents.contentSignals);\n  if (usage) {\n    manifest.contentUsage = usage;\n  }\n  if (config.github) {\n    manifest.repository = repoUrl(config.github);\n  }\n\n  return manifest;\n};\n",
+    "import { mountBasePath, normalizeBasePath } from \"../core/base-path.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { ContentSignalPolicy, ContentSignals } from \"../core/schema.ts\";\nimport { absoluteUrl } from \"../core/site-url.ts\";\n\n/**\n * Ordered mapping from config field to its `Content-Signal` token. The order\n * fixes the emitted sequence (`search`, then `ai-input`, then `ai-train`).\n */\nconst SIGNAL_TOKENS: [keyof ContentSignalPolicy, string][] = [\n  [\"search\", \"search\"],\n  [\"aiInput\", \"ai-input\"],\n  [\"aiTrain\", \"ai-train\"],\n];\n\n/**\n * The `Content-Signal:` line declaring how crawlers may reuse the site, or null\n * when the declaration is disabled (`contentSignals: false`). Otherwise every\n * signal is emitted with its resolved yes/no value.\n */\nconst contentSignalLine = (signals: ContentSignals): string | null => {\n  if (!signals) {\n    return null;\n  }\n  const tokens = SIGNAL_TOKENS.map(\n    ([key, token]) => `${token}=${signals[key] ? \"yes\" : \"no\"}`\n  );\n  return `Content-Signal: ${tokens.join(\", \")}`;\n};\n\n/**\n * Build a robots.txt that allows all crawlers, declares any configured\n * `Content-Signal` usage preferences, and points to the sitemap when one is\n * available (a `site` is set and the sitemap is enabled). Returns null when\n * robots generation is disabled.\n */\nexport const buildRobots = (project: BlumeProject): string | null => {\n  const { config } = project;\n  if (!config.seo.robots) {\n    return null;\n  }\n\n  const lines = [\"User-agent: *\"];\n  const signal = contentSignalLine(config.agents.contentSignals);\n  if (signal) {\n    lines.push(signal);\n  }\n  lines.push(\"Allow: /\");\n\n  const { site } = config.deployment.options;\n  if (site && config.seo.sitemap) {\n    const sitemapPath = mountBasePath(\n      normalizeBasePath(config.deployment.options.base),\n      \"/sitemap.xml\"\n    );\n    lines.push(\"\", `Sitemap: ${absoluteUrl(site, sitemapPath)}`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n};\n",
+    "// html-escaper's five-entity table is XML-safe (`'` → the numeric `&#39;`).\nimport { escape as escapeXml } from \"html-escaper\";\n\nimport {\n  customStaticRoutes,\n  discoverPagesSync,\n  hasGeneratedChangelog,\n} from \"../astro/pages.ts\";\nimport {\n  mountBasePath,\n  normalizeBasePath,\n  normalizePath,\n} from \"../core/base-path.ts\";\nimport { isHiddenPage } from \"../core/hidden-pages.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport { siteRoot } from \"../core/site-url.ts\";\n\n/**\n * Astro's reserved error routes. A user-authored override (`pages/404.astro`,\n * `pages/500.astro`, or a `404.md` content page — see `writeNotFoundPage` in\n * `astro/generate.ts`) is neither dynamic nor private, so it would otherwise\n * be emitted — but error pages aren't crawlable destinations and must stay out\n * of the sitemap.\n */\nconst ERROR_ROUTES = new Set([\"/404\", \"/500\"]);\n\n/** A `<lastmod>` element (W3C date) when the page has a valid modified date. */\nconst lastmodTag = (value: string | undefined): string => {\n  if (!value) {\n    return \"\";\n  }\n  const date = new Date(value);\n  return Number.isNaN(date.getTime())\n    ? \"\"\n    : `<lastmod>${date.toISOString().slice(0, 10)}</lastmod>`;\n};\n\n/**\n * Whether a page's own `seo.canonical` names another URL. The sitemap lists\n * canonical URLs only, so such a page stays out — `blume audit` reports a\n * listed one as NON_CANONICAL_IN_SITEMAP and expects it unlisted. Compared by\n * decoded path, as the audit does: `served` is the page's path with the\n * deployment base mounted, which the canonical carries too.\n */\nconst canonicalElsewhere = (\n  canonical: string | undefined,\n  served: string\n): boolean => {\n  if (!canonical) {\n    return false;\n  }\n  const { pathname } = new URL(canonical);\n  let path = pathname;\n  try {\n    path = decodeURI(pathname);\n  } catch {\n    // A malformed escape stays as written; it can't match the served path.\n  }\n  return normalizePath(path) !== normalizePath(served);\n};\n\n/** One emitted sitemap artifact: its dist-root filename and XML body. */\nexport interface SitemapFile {\n  name: string;\n  xml: string;\n}\n\n/** The build log line for an emitted sitemap set: one file, or an index. */\nexport const describeSitemapFiles = (files: readonly SitemapFile[]): string =>\n  files.length === 1\n    ? \"Generated sitemap.xml\"\n    : `Generated sitemap.xml (index of ${files.length - 1} sitemap files)`;\n\n/**\n * The sitemaps.org cap on `<url>` entries in a single file. Beyond it,\n * `sitemap.xml` becomes a sitemap index pointing at numbered chunk files —\n * search engines reject an oversized urlset outright.\n */\nconst URLS_PER_FILE = 50_000;\n\nconst renderUrlset = (\n  urls: string[]\n): string => `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${urls.join(\"\\n\")}\n</urlset>\n`;\n\n/**\n * Build the sitemap files from the route manifest plus the routes the manifest\n * can't see: custom `.astro` pages (most importantly a custom landing `/`) and\n * the generated `/changelog` index. Returns null when the sitemap is disabled\n * or no `site` is configured (absolute URLs are required for a valid sitemap).\n * Drafts, hidden, and `noindex` pages are excluded, and so is a page whose\n * `seo.canonical` points elsewhere.\n *\n * Sites within the per-file URL cap get the single classic `sitemap.xml`;\n * larger sites get `sitemap.xml` as a sitemap index over numbered\n * `sitemap-N.xml` chunks, all served from the same directory robots.txt\n * already points at.\n */\nexport const buildSitemapFiles = (\n  project: BlumeProject\n): SitemapFile[] | null => {\n  const { site } = project.config.deployment.options;\n  if (!(site && project.config.seo.sitemap)) {\n    return null;\n  }\n\n  const base = siteRoot(site);\n  // Routes carry `basePath`; a `deployment.base` subdirectory is mounted on\n  // top of every one, even a route whose first segment matches it: under base\n  // `/guides`, `guides/setup.md` is served at `/guides/guides/setup`.\n  const deployBase = normalizeBasePath(project.config.deployment.options.base);\n\n  // Archived-version pages leave the sitemap when the version is noindexed,\n  // or when their canonical points at a still-existing latest equivalent —\n  // listing a URL whose canonical says \"index the other page\" invites the\n  // noindexed-page-in-sitemap incoherence Docusaurus is known for. A page\n  // that exists only in an archived version stays listed (self-canonical),\n  // and a page's own `seo.canonical` wins over the version's default, as it\n  // does in the page head (see `canonicalElsewhere`).\n  const { versions } = project.config;\n  const archivedById = new Map(\n    (versions?.archived ?? []).map((version) => [version.id, version])\n  );\n  const currentKeys = versions\n    ? new Set(\n        project.graph.pages.flatMap((page) =>\n          page.version === \"\" ? [`${page.versionKey}\\u0000${page.locale}`] : []\n        )\n      )\n    : null;\n  const archivedExcluded = (page: (typeof project.graph.pages)[number]) => {\n    if (!page.version) {\n      return false;\n    }\n    // A non-empty version always names a configured archived entry — that is\n    // the only way detection assigns one.\n    const archived = archivedById.get(page.version);\n    return Boolean(\n      archived?.noindex ||\n      (archived?.canonical === \"latest\" &&\n        !page.meta.seo.canonical &&\n        currentKeys?.has(`${page.versionKey}\\u0000${page.locale}`))\n    );\n  };\n\n  const seen = new Set<string>();\n  const urls: string[] = [];\n  const pushUrl = (route: string, lastModified?: string): void => {\n    // `<loc>` must be a well-formed, XML-escaped URL: percent-encode the path,\n    // then escape XML metacharacters (notably `&`) so a route like\n    // `/Tips & Tricks` doesn't produce invalid XML that gets the whole sitemap\n    // rejected.\n    const loc = escapeXml(encodeURI(`${base}${route}`));\n    if (seen.has(loc)) {\n      return;\n    }\n    seen.add(loc);\n    urls.push(`  <url><loc>${loc}</loc>${lastmodTag(lastModified)}</url>`);\n  };\n  for (const page of project.graph.pages) {\n    const served = mountBasePath(deployBase, page.route);\n    if (\n      page.meta.draft ||\n      isHiddenPage(page, project.graph) ||\n      page.meta.seo.noindex ||\n      ERROR_ROUTES.has(page.route) ||\n      archivedExcluded(page) ||\n      canonicalElsewhere(page.meta.seo.canonical, served)\n    ) {\n      continue;\n    }\n    pushUrl(served, page.lastModified);\n  }\n  // Custom `.astro` pages and the generated changelog index mount outside\n  // `basePath` (they're injected at their pattern — see `blumeIntegration`), so\n  // only the deployment base layers onto their URLs.\n  const userPages = project.context.pagesRoot\n    ? discoverPagesSync(project.context.pagesRoot)\n    : [];\n  const extraRoutes = customStaticRoutes(userPages).filter(\n    (route) => !ERROR_ROUTES.has(route)\n  );\n  if (hasGeneratedChangelog(project, userPages)) {\n    extraRoutes.push(\"/changelog\");\n  }\n  for (const route of extraRoutes) {\n    pushUrl(mountBasePath(deployBase, route));\n  }\n  urls.sort();\n\n  if (urls.length <= URLS_PER_FILE) {\n    return [{ name: \"sitemap.xml\", xml: renderUrlset(urls) }];\n  }\n\n  const chunks: SitemapFile[] = [];\n  const references: string[] = [];\n  for (let start = 0; start < urls.length; start += URLS_PER_FILE) {\n    const name = `sitemap-${chunks.length + 1}.xml`;\n    chunks.push({\n      name,\n      xml: renderUrlset(urls.slice(start, start + URLS_PER_FILE)),\n    });\n    // Chunks sit next to sitemap.xml, so their URLs layer the same deployment\n    // base robots.txt uses for the index.\n    const loc = escapeXml(\n      encodeURI(`${base}${mountBasePath(deployBase, `/${name}`)}`)\n    );\n    references.push(`  <sitemap><loc>${loc}</loc></sitemap>`);\n  }\n  const index = `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n${references.join(\"\\n\")}\n</sitemapindex>\n`;\n  return [{ name: \"sitemap.xml\", xml: index }, ...chunks];\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "AFE0F5252B96AD6064756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-4zxh25hc.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import {
+  locateMdxFailure
+} from "./chunk-zxd5jrgx.js";
+
+// src/cli/build-failure.ts
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "pathe";
+import ts from "typescript";
+import { z } from "zod";
+var buildErrorSchema = z.looseObject({
+  errors: z.array(z.instanceof(Error)).optional(),
+  id: z.string().optional(),
+  loc: z.looseObject({
+    column: z.number().optional(),
+    file: z.string().optional(),
+    line: z.number().optional()
+  }).optional()
+});
+var blumeErrorSchema = z.looseObject({
+  diagnostic: z.object({
+    code: z.string(),
+    column: z.number().optional(),
+    docsUrl: z.string().optional(),
+    file: z.string().optional(),
+    line: z.number().optional(),
+    message: z.string(),
+    severity: z.enum(["error", "info", "warning"]),
+    suggestion: z.string().optional()
+  })
+});
+var UNDEFINED_NAME = [
+  /^(?<name>[\w$]+) is not defined$/u,
+  /^Can't find variable: (?<name>[\w$]+)$/u
+];
+var POSITIONED = /^\d+:\d+: /u;
+var undefinedNameDiagnostic = (name, file, site) => {
+  const escape = "show the braces as text: escape each opening brace (`\\{`) or put it in inline code";
+  const variable = site?.expression === `{{${name}}}`;
+  return {
+    code: "BLUME_MDX_UNDEFINED_NAME",
+    column: site?.column,
+    file: site?.file ?? file,
+    line: site?.line,
+    message: site?.expression ? `\`${site.expression}\` reads \`${name}\`, which isn't defined, so the page fails to render. In .mdx, \`{…}\` is a JavaScript expression.` : `\`${name}\` isn't defined, so the page fails to render. In .mdx, \`{…}\` is a JavaScript expression, and one reads it.`,
+    severity: "error",
+    suggestion: variable ? `Define \`${name}\` under \`variables\` in blume.config.ts, or ${escape}.` : `To ${escape}. For a value every page shares, define a variable in blume.config.ts and write \`{{name}}\`.`
+  };
+};
+var TSCONFIG_NOT_FOUND = /Tsconfig not found (?<target>\S+?)\.?$/mu;
+var tsconfigLinksSchema = z.object({
+  extends: z.union([z.string(), z.array(z.string())]).optional(),
+  references: z.array(z.object({ path: z.string() })).optional()
+});
+var linkTo = (path, target) => {
+  const parsed = tsconfigLinksSchema.safeParse(ts.readConfigFile(path, ts.sys.readFile).config);
+  if (!parsed.success) {
+    return;
+  }
+  const names = (written) => {
+    const resolved = resolve(dirname(path), written);
+    return written === target || resolved === target || join(resolved, "tsconfig.json") === target;
+  };
+  const extended = [parsed.data.extends ?? []].flat().find(names);
+  if (extended !== undefined) {
+    return { key: "extends", written: extended };
+  }
+  const referenced = (parsed.data.references ?? []).map((reference) => reference.path).find(names);
+  return referenced === undefined ? undefined : { key: "references", written: referenced };
+};
+var tsconfigFix = ({ key, written }, name) => {
+  if (key === "references") {
+    return `Create \`${written}\` (a framework's generated tsconfig appears once its prepare or build step runs), or remove it from \`references\` in ${name}.`;
+  }
+  if (written.startsWith(".") || isAbsolute(written)) {
+    return `Restore \`${written}\`, or remove it from \`extends\` in ${name}.`;
+  }
+  const packageName = written.split("/").slice(0, written.startsWith("@") ? 2 : 1).join("/");
+  return `Install the package that provides it (\`${packageName}\`), or remove it from \`extends\` in ${name}.`;
+};
+var tsconfigExtendsDiagnostic = (target, root) => {
+  const found = root ? ["tsconfig.json", "jsconfig.json"].map((name) => join(root, name)).filter((path) => existsSync(path)).map((path) => ({ link: linkTo(path, target), path })).find(({ link }) => link !== undefined) : undefined;
+  const file = found?.path;
+  const { key, written } = found?.link ?? { key: "extends", written: target };
+  const line = file ? readFileSync(file, "utf-8").split(`
+`).findIndex((text) => text.includes(JSON.stringify(written))) + 1 : 0;
+  const name = file ? basename(file) : "tsconfig.json";
+  return {
+    code: "BLUME_TSCONFIG_EXTENDS",
+    file,
+    line: line > 0 ? line : undefined,
+    message: `${file ? name : "A tsconfig.json in the project"} ${key} \`${written}\`, which can't be found. The build reads the project's ${name} to resolve imports, so it stops here.`,
+    severity: "error",
+    suggestion: tsconfigFix({ key, written }, name)
+  };
+};
+var missingTsconfig = (error) => (TSCONFIG_NOT_FOUND.exec(error.message) ?? (error.cause instanceof Error ? TSCONFIG_NOT_FOUND.exec(error.cause.message) : null))?.groups?.target;
+var undefinedName = (error) => error.name === "ReferenceError" ? UNDEFINED_NAME.map((pattern) => pattern.exec(error.message)).find(Boolean)?.groups?.name : undefined;
+var locateFailure = async (error, page, name, locate) => {
+  if (!locate) {
+    return null;
+  }
+  if (name) {
+    return await locate(page, { kind: "undefined-name", name });
+  }
+  return error.name === "MDXError" && !POSITIONED.test(error.message) ? await locate(page, { kind: "syntax" }) : null;
+};
+var failureDiagnostic = async (error, context) => {
+  const raised = blumeErrorSchema.safeParse(error);
+  if (raised.success) {
+    return raised.data.diagnostic;
+  }
+  const tsconfig = missingTsconfig(error);
+  if (tsconfig) {
+    return tsconfigExtendsDiagnostic(tsconfig, context.root);
+  }
+  const parsed = buildErrorSchema.safeParse(error);
+  const { id, loc } = parsed.success ? parsed.data : {};
+  const file = loc?.file ?? id;
+  const name = undefinedName(error);
+  const site = file?.endsWith(".mdx") ? await locateFailure(error, file, name, context.locate) : null;
+  if (file?.endsWith(".mdx") && name) {
+    return undefinedNameDiagnostic(name, file, site);
+  }
+  if (site?.diagnostic) {
+    return site.diagnostic;
+  }
+  const label = error.name === "Error" ? "" : `${error.name}: `;
+  return {
+    code: "BLUME_BUILD_FAILED",
+    column: loc?.column,
+    file,
+    line: loc?.line,
+    message: `${label}${error.message}`,
+    severity: "error"
+  };
+};
+var astroBuildDiagnostics = async (rejection, context = {}) => {
+  const parsed = buildErrorSchema.safeParse(rejection);
+  const failures = parsed.success ? parsed.data.errors ?? [] : [];
+  return await Promise.all((failures.length > 0 ? failures : [rejection]).map(async (failure) => await failureDiagnostic(failure, context)));
+};
+var buildFailureLocator = (project) => (file, failure) => {
+  const page = project.graph.pages.find((candidate) => candidate.sourcePath === file);
+  const source = project.sources.find((candidate) => candidate.name === page?.source.name);
+  return locateMdxFailure({
+    contentRoot: source?.staged ? undefined : source?.contentRoot,
+    name: relative(project.context.root, file),
+    sourcePath: file,
+    variables: project.config.variables
+  }, failure);
+};
+
+export { astroBuildDiagnostics, buildFailureLocator };
+
+//# debugId=A5E390AFCF69E70164756E2164756E21
+//# sourceMappingURL=chunk-4zxh25hc.js.map

package/dist/cli/chunk-4zxh25hc.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/build-failure.ts"],
+  "sourcesContent": [
+    "import { existsSync, readFileSync } from \"node:fs\";\n\nimport { basename, dirname, isAbsolute, join, relative, resolve } from \"pathe\";\nimport ts from \"typescript\";\nimport { z } from \"zod\";\n\nimport { locateMdxFailure } from \"../core/mdx-syntax.ts\";\nimport type { MdxFailure, MdxFailureSite } from \"../core/mdx-syntax.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\n/**\n * The fields of an `astro build` rejection the report reads. Rolldown bundles\n * every plugin failure (an MDX compile error, say) into one error whose\n * `errors` holds each; a failure carries `loc` where the compiler pinned it,\n * or only `id`, the module that failed.\n */\nconst buildErrorSchema = z.looseObject({\n  errors: z.array(z.instanceof(Error)).optional(),\n  id: z.string().optional(),\n  loc: z\n    .looseObject({\n      column: z.number().optional(),\n      file: z.string().optional(),\n      line: z.number().optional(),\n    })\n    .optional(),\n});\n\n/**\n * The diagnostic a `BlumeError` thrown inside the build carries, such as a\n * failed hosted search sync in `astro:build:done`. The hook runs Blume's\n * source rather than the CLI bundle, so its error is another copy of the class\n * that the command's `instanceof BlumeError` doesn't recognize.\n */\nconst blumeErrorSchema = z.looseObject({\n  diagnostic: z.object({\n    code: z.string(),\n    column: z.number().optional(),\n    docsUrl: z.string().optional(),\n    file: z.string().optional(),\n    line: z.number().optional(),\n    message: z.string(),\n    severity: z.enum([\"error\", \"info\", \"warning\"]),\n    suggestion: z.string().optional(),\n  }),\n});\n\n/**\n * Finds where in an `.mdx` page's files a failure Astro reported with no line\n * happened (see `locateMdxFailure`).\n */\nexport type MdxFailureLocator = (\n  file: string,\n  failure: MdxFailure\n) => Promise<MdxFailureSite | null>;\n\n/** What the report reads besides the error. */\nexport interface BuildFailureContext {\n  locate?: MdxFailureLocator;\n  /** The project root, where the build reads `tsconfig.json`. */\n  root?: string;\n}\n\n// The message for a name nothing defines, in V8 (Node) and JavaScriptCore (Bun).\nconst UNDEFINED_NAME = [\n  /^(?<name>[\\w$]+) is not defined$/u,\n  /^Can't find variable: (?<name>[\\w$]+)$/u,\n];\n// A compiler message that opens with where it failed.\nconst POSITIONED = /^\\d+:\\d+: /u;\n\n/**\n * A `{…}` expression in an `.mdx` page that reads a name nothing defines: the\n * page compiles, then throws while it renders. Placed at the expression when\n * the page (or a partial it includes) shows where.\n */\nconst undefinedNameDiagnostic = (\n  name: string,\n  file: string,\n  site: MdxFailureSite | null\n): Diagnostic => {\n  const escape =\n    \"show the braces as text: escape each opening brace (`\\\\{`) or put it in inline code\";\n  // `{{name}}` is a Blume variable the site doesn't define.\n  const variable = site?.expression === `{{${name}}}`;\n  return {\n    code: \"BLUME_MDX_UNDEFINED_NAME\",\n    column: site?.column,\n    file: site?.file ?? file,\n    line: site?.line,\n    message: site?.expression\n      ? `\\`${site.expression}\\` reads \\`${name}\\`, which isn't defined, so the page fails to render. In .mdx, \\`{…}\\` is a JavaScript expression.`\n      : `\\`${name}\\` isn't defined, so the page fails to render. In .mdx, \\`{…}\\` is a JavaScript expression, and one reads it.`,\n    severity: \"error\",\n    suggestion: variable\n      ? `Define \\`${name}\\` under \\`variables\\` in blume.config.ts, or ${escape}.`\n      : `To ${escape}. For a value every page shares, define a variable in blume.config.ts and write \\`{{name}}\\`.`,\n  };\n};\n\n// Vite's message for an `extends` or `references` entry it can't resolve. It\n// names an `extends` package as written, and a path resolved.\nconst TSCONFIG_NOT_FOUND = /Tsconfig not found (?<target>\\S+?)\\.?$/mu;\n\nconst tsconfigLinksSchema = z.object({\n  extends: z.union([z.string(), z.array(z.string())]).optional(),\n  references: z.array(z.object({ path: z.string() })).optional(),\n});\n\n/** An entry in a tsconfig's `extends` or `references`, as written. */\ninterface TsconfigLink {\n  key: \"extends\" | \"references\";\n  written: string;\n}\n\n/**\n * The `extends` or `references` entry in the tsconfig at `path` that names\n * `target`: written as is, or resolved from the tsconfig's folder (a\n * reference can name a folder, which means its `tsconfig.json`).\n */\nconst linkTo = (path: string, target: string): TsconfigLink | undefined => {\n  const parsed = tsconfigLinksSchema.safeParse(\n    ts.readConfigFile(path, ts.sys.readFile).config\n  );\n  if (!parsed.success) {\n    return undefined;\n  }\n  const names = (written: string): boolean => {\n    const resolved = resolve(dirname(path), written);\n    return (\n      written === target ||\n      resolved === target ||\n      join(resolved, \"tsconfig.json\") === target\n    );\n  };\n  const extended = [parsed.data.extends ?? []].flat().find(names);\n  if (extended !== undefined) {\n    return { key: \"extends\", written: extended };\n  }\n  const referenced = (parsed.data.references ?? [])\n    .map((reference) => reference.path)\n    .find(names);\n  return referenced === undefined\n    ? undefined\n    : { key: \"references\", written: referenced };\n};\n\n/** How to fix a tsconfig entry that doesn't resolve. */\nconst tsconfigFix = ({ key, written }: TsconfigLink, name: string): string => {\n  if (key === \"references\") {\n    return `Create \\`${written}\\` (a framework's generated tsconfig appears once its prepare or build step runs), or remove it from \\`references\\` in ${name}.`;\n  }\n  if (written.startsWith(\".\") || isAbsolute(written)) {\n    return `Restore \\`${written}\\`, or remove it from \\`extends\\` in ${name}.`;\n  }\n  const packageName = written\n    .split(\"/\")\n    .slice(0, written.startsWith(\"@\") ? 2 : 1)\n    .join(\"/\");\n  return `Install the package that provides it (\\`${packageName}\\`), or remove it from \\`extends\\` in ${name}.`;\n};\n\n/**\n * An `extends` or `references` entry in the project's `tsconfig.json` that\n * doesn't resolve: Vite reads that file while it builds the site, so the\n * build fails in `astro sync` before any page compiles. Placed at the entry's\n * line when the project's own tsconfig names the target.\n */\nconst tsconfigExtendsDiagnostic = (\n  target: string,\n  root: string | undefined\n): Diagnostic => {\n  const found = root\n    ? [\"tsconfig.json\", \"jsconfig.json\"]\n        .map((name) => join(root, name))\n        .filter((path) => existsSync(path))\n        .map((path) => ({ link: linkTo(path, target), path }))\n        .find(({ link }) => link !== undefined)\n    : undefined;\n  const file = found?.path;\n  const { key, written } = found?.link ?? { key: \"extends\", written: target };\n  const line = file\n    ? readFileSync(file, \"utf-8\")\n        .split(\"\\n\")\n        .findIndex((text) => text.includes(JSON.stringify(written))) + 1\n    : 0;\n  const name = file ? basename(file) : \"tsconfig.json\";\n  return {\n    code: \"BLUME_TSCONFIG_EXTENDS\",\n    file,\n    line: line > 0 ? line : undefined,\n    message: `${file ? name : \"A tsconfig.json in the project\"} ${key} \\`${written}\\`, which can't be found. The build reads the project's ${name} to resolve imports, so it stops here.`,\n    severity: \"error\",\n    suggestion: tsconfigFix({ key, written }, name),\n  };\n};\n\n/** The `extends` target an unresolvable tsconfig names, if `error` is that. */\nconst missingTsconfig = (error: Error): string | undefined =>\n  (\n    TSCONFIG_NOT_FOUND.exec(error.message) ??\n    // `astro sync` wraps the resolver's error in its own.\n    (error.cause instanceof Error\n      ? TSCONFIG_NOT_FOUND.exec(error.cause.message)\n      : null)\n  )?.groups?.target;\n\n/** The name a render error says nothing defines, if it says that. */\nconst undefinedName = (error: Error): string | undefined =>\n  error.name === \"ReferenceError\"\n    ? UNDEFINED_NAME.map((pattern) => pattern.exec(error.message)).find(Boolean)\n        ?.groups?.name\n    : undefined;\n\n/**\n * Where in an `.mdx` page's files a failure the compiler didn't place\n * happened: a render error the page threw, or a compile error in a partial it\n * includes, which the compiler pins on the page with no `line:column:` in its\n * message. (Bun stamps a `line` of its own on every error, so `loc` can't\n * tell.)\n */\nconst locateFailure = async (\n  error: Error,\n  page: string,\n  name: string | undefined,\n  locate: MdxFailureLocator | undefined\n): Promise<MdxFailureSite | null> => {\n  if (!locate) {\n    return null;\n  }\n  if (name) {\n    return await locate(page, { kind: \"undefined-name\", name });\n  }\n  return error.name === \"MDXError\" && !POSITIONED.test(error.message)\n    ? await locate(page, { kind: \"syntax\" })\n    : null;\n};\n\n/** One failure as a diagnostic at the file (and position) it names. */\nconst failureDiagnostic = async (\n  error: Error,\n  context: BuildFailureContext\n): Promise<Diagnostic> => {\n  const raised = blumeErrorSchema.safeParse(error);\n  if (raised.success) {\n    return raised.data.diagnostic;\n  }\n  const tsconfig = missingTsconfig(error);\n  if (tsconfig) {\n    return tsconfigExtendsDiagnostic(tsconfig, context.root);\n  }\n  const parsed = buildErrorSchema.safeParse(error);\n  const { id, loc } = parsed.success ? parsed.data : {};\n  const file = loc?.file ?? id;\n  const name = undefinedName(error);\n  const site = file?.endsWith(\".mdx\")\n    ? await locateFailure(error, file, name, context.locate)\n    : null;\n  if (file?.endsWith(\".mdx\") && name) {\n    return undefinedNameDiagnostic(name, file, site);\n  }\n  if (site?.diagnostic) {\n    return site.diagnostic;\n  }\n  // A named error (`MDXError`, `CompilerError`) says which step failed.\n  const label = error.name === \"Error\" ? \"\" : `${error.name}: `;\n  return {\n    code: \"BLUME_BUILD_FAILED\",\n    column: loc?.column,\n    file,\n    line: loc?.line,\n    message: `${label}${error.message}`,\n    severity: \"error\",\n  };\n};\n\n/**\n * What `astro build` rejected with, as build diagnostics: one per failure\n * Rolldown collected, else the error itself. A page Blume's own checks pass\n * can still fail Astro's compile (MDX that doesn't parse) or render, and that\n * is a problem in the site, reported at its file, rather than an internal\n * error blaming Blume.\n */\nexport const astroBuildDiagnostics = async (\n  rejection: Error,\n  context: BuildFailureContext = {}\n): Promise<Diagnostic[]> => {\n  const parsed = buildErrorSchema.safeParse(rejection);\n  const failures = parsed.success ? (parsed.data.errors ?? []) : [];\n  return await Promise.all(\n    (failures.length > 0 ? failures : [rejection]).map(\n      async (failure) => await failureDiagnostic(failure, context)\n    )\n  );\n};\n\n/**\n * The locator a build uses: the failing page's source, read with the includes\n * and variables the scan resolved for it.\n */\nexport const buildFailureLocator =\n  (\n    project: Pick<BlumeProject, \"config\" | \"context\" | \"graph\" | \"sources\">\n  ): MdxFailureLocator =>\n  (file, failure) => {\n    const page = project.graph.pages.find(\n      (candidate) => candidate.sourcePath === file\n    );\n    const source = project.sources.find(\n      (candidate) => candidate.name === page?.source.name\n    );\n    return locateMdxFailure(\n      {\n        contentRoot: source?.staged ? undefined : source?.contentRoot,\n        name: relative(project.context.root, file),\n        sourcePath: file,\n        variables: project.config.variables,\n      },\n      failure\n    );\n  };\n"
+  ],
+  "mappings": "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",
+  "debugId": "A5E390AFCF69E70164756E2164756E21",
+  "names": []
+}