blume 1.7.3 → 2.0.0

package/dist/cli/chunk-a9kptbw5.js

@@ -0,0 +1,361 @@
+#!/usr/bin/env node
+import {
+  frontmatter_default,
+  parseHeadingMarkers,
+  HTML_COMMENT,
+  readExpandedEntryText,
+  MARKDOWN_FEATURES,
+  MDX_FEATURES,
+  componentRegistry,
+  downlevelComponentNode,
+  downlevelComponents,
+  projectComponentSerializers,
+  applyAudienceVisibility,
+  agentMarkdown,
+  buildRawMarkdown
+} from "./chunk-xaz13gwg.js";
+import {
+  normalizeBasePath
+} from "./chunk-jts8mvcz.js";
+import {
+  contentIndexable
+} from "./chunk-zg2gtj10.js";
+
+// src/search/documents.ts
+import { markdownToMdast, mdxToMdast } from "satteri";
+
+// src/markdown/fence-meta.ts
+var QUOTED_ATTR = /[\w-]+=(?:"[^"]*"|'[^']*')/gu;
+var LINE_RANGE = /\{[^}]*\}/u;
+var META_TOKEN = new RegExp(`${QUOTED_ATTR.source}|${LINE_RANGE.source}|\\S+`, "gu");
+var metaTokens = (meta) => meta?.match(META_TOKEN) ?? [];
+var RESERVED_META_KEYWORDS = new Set([
+  "lineNumbers",
+  "ts2js",
+  "twoslash"
+]);
+var isLineRange = (token) => token.startsWith("{");
+
+// src/markdown/code-title.ts
+var TITLE_ATTR = /(?:^|\s)title=(?:"(?<dq>[^"]*)"|'(?<sq>[^']*)')/u;
+var isTitleToken = (token) => token.length > 0 && !isLineRange(token) && !token.includes("=") && !RESERVED_META_KEYWORDS.has(token);
+var parseCodeTitle = (raw) => {
+  if (!raw) {
+    return;
+  }
+  const scrubbed = raw.replace(QUOTED_ATTR, (attr) => attr.startsWith("title=") ? attr : " ");
+  const explicit = scrubbed.match(TITLE_ATTR);
+  const attrTitle = explicit?.groups?.dq ?? explicit?.groups?.sq;
+  if (attrTitle) {
+    return attrTitle;
+  }
+  return metaTokens(raw).find(isTitleToken);
+};
+
+// src/search/facets.ts
+var isFacetValue = (value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+var pageFacets = (page, config) => {
+  const declared = config.content.types[page.contentType]?.facets;
+  if (!declared || declared.length === 0 || !page.custom) {
+    return;
+  }
+  const facets = {};
+  for (const key of declared) {
+    const value = page.custom[key];
+    if (isFacetValue(value)) {
+      facets[key] = String(value);
+    }
+  }
+  return Object.keys(facets).length > 0 ? facets : undefined;
+};
+
+// src/search/documents.ts
+var HTML_OR_JSX = /<\/?[a-zA-Z][^\n<>]*>|<\/?>/gu;
+var WHITESPACE = /\s+/gu;
+var INLINE_PARENTS = new Set([
+  "delete",
+  "emphasis",
+  "footnoteReference",
+  "link",
+  "linkReference",
+  "mdxJsxTextElement",
+  "strong",
+  "subscript",
+  "superscript",
+  "textDirective"
+]);
+var NON_PROSE = new Set([
+  "image",
+  "imageReference",
+  "inlineMath",
+  "math",
+  "mdxFlowExpression",
+  "mdxTextExpression",
+  "mdxjsEsm"
+]);
+var MD_PARSE = { features: { ...MARKDOWN_FEATURES, frontmatter: false } };
+var MDX_PARSE = { features: { ...MDX_FEATURES, frontmatter: false } };
+var parseMdx = (markdown) => {
+  try {
+    return mdxToMdast(markdown, MDX_PARSE);
+  } catch {
+    return;
+  }
+};
+var parseMarkdown = (markdown, format) => format === "mdx" ? parseMdx(markdown) : markdownToMdast(markdown, MD_PARSE);
+var collectCode = (node, out, walk) => {
+  if (!walk.includeCodeBlocks) {
+    return;
+  }
+  const title = parseCodeTitle(node.meta ?? undefined);
+  if (title) {
+    out.push(title, " ");
+  }
+  out.push(node.value, " ");
+};
+var separatesWords = (node) => !INLINE_PARENTS.has(node.type) || node.children.length === 0;
+var collectText = (node, out, walk) => {
+  if (NON_PROSE.has(node.type)) {
+    return;
+  }
+  switch (node.type) {
+    case "code": {
+      collectCode(node, out, walk);
+      return;
+    }
+    case "mdxJsxFlowElement": {
+      const text = downlevelComponentNode(node, walk.downlevel);
+      if (text !== null) {
+        collectText(markdownToMdast(text, MD_PARSE), out, walk);
+        return;
+      }
+      break;
+    }
+    case "inlineCode": {
+      out.push(node.value);
+      return;
+    }
+    case "html": {
+      out.push(node.value.replaceAll(HTML_COMMENT, " ").replaceAll(HTML_OR_JSX, " "), " ");
+      return;
+    }
+    case "break": {
+      out.push(" ");
+      return;
+    }
+    case "heading": {
+      const last = node.children.at(-1);
+      const trailing = last?.type === "text" ? last : undefined;
+      const inner = [];
+      const kept = trailing ? node.children.slice(0, -1) : node.children;
+      for (const child of kept) {
+        collectText(child, inner, walk);
+      }
+      if (trailing) {
+        const stripped = parseHeadingMarkers(trailing.value).text;
+        const literal = stripped === "" && node.children.length === 1;
+        inner.push(literal ? trailing.value : stripped);
+      }
+      out.push(inner.join("").trimEnd(), " ");
+      return;
+    }
+    default: {
+      break;
+    }
+  }
+  if ("value" in node) {
+    out.push(node.value);
+    return;
+  }
+  if ("children" in node) {
+    for (const child of node.children) {
+      collectText(child, out, walk);
+    }
+    if (separatesWords(node)) {
+      out.push(" ");
+    }
+  }
+};
+var toPlainText = (markdown, format, walk) => {
+  const tree = parseMarkdown(markdown, format);
+  if (!tree) {
+    return "";
+  }
+  const out = [];
+  collectText(tree, out, walk);
+  return out.join("").replaceAll(WHITESPACE, " ").trim();
+};
+var buildCrumbIndex = (sidebar) => {
+  const index = new Map;
+  const groupRoutes = new Map;
+  const walk = (nodes, trail) => {
+    for (const node of nodes) {
+      if (node.kind === "group") {
+        if (node.route && !groupRoutes.has(node.route)) {
+          groupRoutes.set(node.route, {
+            breadcrumb: [...trail, node.label],
+            section: node.label
+          });
+        }
+        walk(node.children, [...trail, node.label]);
+      } else if (node.route) {
+        index.set(node.route, {
+          breadcrumb: trail,
+          section: trail.at(-1) ?? ""
+        });
+      }
+    }
+  };
+  walk(sidebar, []);
+  for (const [route, crumbs] of groupRoutes) {
+    if (!index.has(route)) {
+      index.set(route, crumbs);
+    }
+  }
+  return index;
+};
+var pageBody = async (project, page, options, components) => {
+  if (!page) {
+    return "";
+  }
+  const parsed = frontmatter_default(await readExpandedEntryText(project, page));
+  const visible = applyAudienceVisibility(parsed.content, options?.audience ?? "web");
+  if (options?.content === "markdown") {
+    return downlevelComponents(visible.trim(), components, parsed.data);
+  }
+  return toPlainText(visible, page.format, {
+    downlevel: {
+      frontmatter: parsed.data,
+      registry: componentRegistry(components),
+      source: visible
+    },
+    includeCodeBlocks: project.config.search.indexing.includeCodeBlocks
+  });
+};
+var buildSearchDocuments = async (project, options) => {
+  const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));
+  const byLocale = Object.values(project.graph.navigationByLocale ?? {});
+  const byVersion = Object.values(project.graph.navigationByVersion ?? {}).flatMap((locales) => Object.values(locales)).map((nav) => nav.sidebar);
+  const sidebars = [
+    ...byLocale.length > 0 ? byLocale.map((nav) => nav.sidebar) : [project.graph.navigation?.sidebar ?? []],
+    ...byVersion
+  ];
+  const crumbs = new Map;
+  for (const sidebar of sidebars) {
+    for (const [route, crumb] of buildCrumbIndex(sidebar)) {
+      crumbs.set(route, crumb);
+    }
+  }
+  const indexable = project.manifest.routes.filter((route) => {
+    if (!options?.includeWhenDisabled) {
+      return route.indexable;
+    }
+    if (route.fallback) {
+      return false;
+    }
+    const page = pageById.get(route.id);
+    return page ? contentIndexable(page, project.config) : false;
+  });
+  const components = projectComponentSerializers(project);
+  return await Promise.all(indexable.map(async (route) => {
+    const page = pageById.get(route.id);
+    const body = await pageBody(project, page, options, components);
+    const tags = page?.meta?.search?.tags;
+    const crumb = crumbs.get(route.path);
+    const facets = page ? pageFacets(page, project.config) : undefined;
+    const document = {
+      breadcrumb: crumb?.breadcrumb ?? [],
+      content: body,
+      contentType: route.contentType,
+      description: page?.description ?? "",
+      locale: route.locale,
+      route: route.path,
+      section: crumb?.section || "Docs",
+      tags: tags && tags.length > 0 ? tags : undefined,
+      title: route.title,
+      version: route.version
+    };
+    if (facets) {
+      document.facets = facets;
+    }
+    return document;
+  }));
+};
+
+// src/ai/mcp/data.ts
+var buildMcpData = async (project) => {
+  const { config, graph, manifest } = project;
+  const [documents, rawMarkdown] = await Promise.all([
+    buildSearchDocuments(project, {
+      audience: "agents",
+      includeWhenDisabled: true
+    }),
+    buildRawMarkdown(project)
+  ]);
+  const pages = Object.fromEntries(Object.entries(rawMarkdown).map(([route, entry]) => [
+    route,
+    agentMarkdown(entry)
+  ]));
+  const pageById = new Map(graph.pages.map((page) => [page.id, page]));
+  const routes = [];
+  for (const route of manifest.routes) {
+    if (route.hidden || route.fallback) {
+      continue;
+    }
+    const page = pageById.get(route.id);
+    const facets = page ? pageFacets(page, config) : undefined;
+    const entry = {
+      contentType: route.contentType,
+      description: page?.description,
+      indexable: route.indexable,
+      lastModified: route.lastModified ?? null,
+      locale: route.locale,
+      route: route.path,
+      title: route.title,
+      version: route.version
+    };
+    if (facets) {
+      entry.facets = facets;
+    }
+    routes.push(entry);
+  }
+  const data = {
+    base: normalizeBasePath(config.deployment.options.base),
+    defaultLocale: config.i18n?.defaultLocale,
+    documents: documents.map((doc) => {
+      const document = {
+        content: doc.content,
+        contentType: doc.contentType,
+        description: doc.description,
+        locale: doc.locale,
+        route: doc.route,
+        title: doc.title,
+        version: doc.version
+      };
+      if (doc.facets) {
+        document.facets = doc.facets;
+      }
+      return document;
+    }),
+    instructions: config.agents.mcp.instructions,
+    name: config.agents.mcp.name ?? config.title,
+    navigation: graph.navigation,
+    pages,
+    routes,
+    site: config.deployment.options.site ?? null,
+    version: manifest.blumeVersion
+  };
+  if (config.versions) {
+    data.archivedVersions = config.versions.archived.map((version) => version.id);
+    data.navigationByVersion = graph.navigationByVersion;
+  }
+  if (config.i18n) {
+    data.navigationByLocale = graph.navigationByLocale;
+  }
+  return data;
+};
+
+export { buildSearchDocuments, buildMcpData };
+
+//# debugId=341A56DACBB5F6DE64756E2164756E21
+//# sourceMappingURL=chunk-a9kptbw5.js.map

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

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/search/documents.ts", "../src/markdown/fence-meta.ts", "../src/markdown/code-title.ts", "../src/search/facets.ts", "../src/ai/mcp/data.ts"],
+  "sourcesContent": [
+    "import type { Nodes } from \"mdast\";\nimport { markdownToMdast, mdxToMdast } from \"satteri\";\n\nimport {\n  componentRegistry,\n  downlevelComponentNode,\n  downlevelComponents,\n} from \"../ai/component-markdown.ts\";\nimport type {\n  ComponentMarkdown,\n  DownlevelWalk,\n  MdastNode as DownlevelNode,\n} from \"../ai/component-markdown.ts\";\nimport { projectComponentSerializers } from \"../ai/serializers.ts\";\nimport { applyAudienceVisibility } from \"../ai/visibility.ts\";\nimport type { VisibilityAudience } from \"../ai/visibility.ts\";\nimport matter from \"../core/frontmatter.ts\";\nimport { parseHeadingMarkers } from \"../core/heading-markers.ts\";\nimport { contentIndexable } from \"../core/manifest.ts\";\nimport type { BlumeProject } from \"../core/project-graph.ts\";\nimport { HTML_COMMENT } from \"../core/sources/normalize.ts\";\nimport { readExpandedEntryText } from \"../core/sources/read.ts\";\nimport type { NavNode, PageRecord } from \"../core/types.ts\";\nimport { parseCodeTitle } from \"../markdown/code-title.ts\";\nimport { MARKDOWN_FEATURES, MDX_FEATURES } from \"../markdown/features.ts\";\nimport { pageFacets } from \"./facets.ts\";\n\n/** A document indexed by the client-side search providers (Orama, FlexSearch). */\nexport interface SearchDocument {\n  route: string;\n  title: string;\n  description: string;\n  content: string;\n  /** Ancestor section labels for the result breadcrumb, e.g. `[\"Guides\"]`. */\n  breadcrumb: string[];\n  /** Top-level section label, used by the search filter pills. */\n  section: string;\n  /** Locale code, so the dialog can filter results to the active language. */\n  locale: string;\n  /** Resolved page `type` (`doc`, `blog`, a custom `rfc`…), for type filters. */\n  contentType: string;\n  /** Docs version (`\"\"` for the current docs), so results scope to the viewed version. */\n  version: string;\n  /** Frontmatter `search.tags`, surfaced for hosted-provider faceting. */\n  tags?: string[];\n  /**\n   * Declared facet values (`content.types.<type>.facets`), key → value.\n   * Filterable through the MCP tools' `filters` input.\n   */\n  facets?: Record<string, string>;\n}\n\n/**\n * A record uploaded to a hosted search backend (Algolia, Orama Cloud,\n * Typesense, Mixedbread). `_id` is the stable per-page key; each sync adapts it\n * to the backend's own id field (`objectID`, `id`, …).\n */\nexport interface SearchRecord {\n  _id: string;\n  url: string;\n  title: string;\n  description: string;\n  content: string;\n  /** Locale code, carried as a facet for per-language filtering. */\n  locale: string;\n  /**\n   * Docs version, carried as a facet for per-version filtering. The current\n   * docs upload as `\"current\"` — hosted backends treat an empty facet value\n   * unreliably, so the sentinel stands in for the empty version id.\n   */\n  version: string;\n  /** Single faceting tag (the first frontmatter tag, when present). */\n  tag?: string;\n}\n\n// Tag-shaped only: a name (or closing slash/fragment) right after `<`, and no\n// newline inside. Applied *within* html/JSX nodes so their inner prose is\n// kept; the surrounding Markdown is walked as a tree, so a bare `<` in prose\n// (\"costs < 5 credits\") is ordinary text and never at risk.\nconst HTML_OR_JSX = /<\\/?[a-zA-Z][^\\n<>]*>|<\\/?>/gu;\nconst WHITESPACE = /\\s+/gu;\n\n// Parents whose children are inline: no separator is inserted after them, or\n// `re*ally*` would index as `re ally`. Every other parent is block-shaped and\n// ends with a space so adjacent paragraphs/headings/cells don't fuse.\nconst INLINE_PARENTS = new Set([\n  \"delete\",\n  \"emphasis\",\n  \"footnoteReference\",\n  \"link\",\n  \"linkReference\",\n  \"mdxJsxTextElement\",\n  \"strong\",\n  \"subscript\",\n  \"superscript\",\n  \"textDirective\",\n]);\n\n// Nodes that never render as prose: image alt text was never indexed, MDX\n// expressions (`{props.x}`) and ESM (`export const meta`) are code, and math\n// is LaTeX source rendered by KaTeX, not searchable words.\nconst NON_PROSE = new Set<Nodes[\"type\"]>([\n  \"image\",\n  \"imageReference\",\n  \"inlineMath\",\n  \"math\",\n  \"mdxFlowExpression\",\n  \"mdxTextExpression\",\n  \"mdxjsEsm\",\n]);\n\ntype PageFormat = PageRecord[\"format\"];\n\n/** What the plain-text walk carries: the code-block policy and the downlevel context. */\ninterface Walk {\n  includeCodeBlocks: boolean;\n  downlevel: DownlevelWalk;\n}\n\n// Front matter is already off (core/frontmatter.ts) by the time a body gets\n// here, so a body that opens with a `---` divider must read as a thematic\n// break rather than a second front matter block.\nconst MD_PARSE = { features: { ...MARKDOWN_FEATURES, frontmatter: false } };\nconst MDX_PARSE = { features: { ...MDX_FEATURES, frontmatter: false } };\n\nconst parseMdx = (markdown: string): Nodes | undefined => {\n  try {\n    return mdxToMdast(markdown, MDX_PARSE);\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Parse a page body the way the renderer reads it. `.mdx` pages go through\n * the MDX grammar with the renderer's feature set, so components become\n * `mdxJsx*` nodes whose children — prose and fences, however they're indented\n * — walk like top-level content, and `:::` directives and `$$` math parse as\n * such; Markdown would instead fold a tight component into one html node and\n * read its indented children as an indented code block. A page the MDX\n * grammar rejects (an HTML comment, an unclosed tag) fails to render too, so\n * it has no body to index: reading it as Markdown instead would put its ESM,\n * expressions, and raw tags in the index as prose.\n */\nconst parseMarkdown = (\n  markdown: string,\n  format: PageFormat\n): Nodes | undefined =>\n  format === \"mdx\" ? parseMdx(markdown) : markdownToMdast(markdown, MD_PARSE);\n\n// Fenced code is excluded from the plain index by default (ranking noise) —\n// the \"markdown\" extraction keeps it for Ask AI grounding. Code-heavy docs opt\n// in via `search.indexing.includeCodeBlocks`, which indexes the fence body and\n// its rendered title (```ts blume.config.ts) but never the fence markers,\n// language, or other meta keywords.\nconst collectCode = (\n  node: Extract<Nodes, { type: \"code\" }>,\n  out: string[],\n  walk: Walk\n): void => {\n  if (!walk.includeCodeBlocks) {\n    return;\n  }\n  const title = parseCodeTitle(node.meta ?? undefined);\n  if (title) {\n    out.push(title, \" \");\n  }\n  // The trailing space keeps the fence apart from what follows it.\n  out.push(node.value, \" \");\n};\n\n// Block boundaries separate words; so does an empty inline element (`<br />`,\n// a self-closing icon), which otherwise fuses its neighbors.\nconst separatesWords = (node: Extract<Nodes, { children: unknown }>): boolean =>\n  !INLINE_PARENTS.has(node.type) || node.children.length === 0;\n\n/** Fold one mdast node into the plain-text accumulator. */\nconst collectText = (node: Nodes, out: string[], walk: Walk): void => {\n  if (NON_PROSE.has(node.type)) {\n    return;\n  }\n  switch (node.type) {\n    case \"code\": {\n      collectCode(node, out, walk);\n      return;\n    }\n    // A component with a serializer indexes as the text the page shows —\n    // a Card's title and call to action, a TypeTable's descriptions — read\n    // from the Markdown the serializer emits (its contract is Markdown, not\n    // MDX). One without a serializer walks its children like any block.\n    case \"mdxJsxFlowElement\": {\n      // SAFETY: DownlevelNode is a structural subset of Satteri's mdast\n      // output — the walk checks for offsets before reading them.\n      const text = downlevelComponentNode(\n        node as DownlevelNode,\n        walk.downlevel\n      );\n      if (text !== null) {\n        collectText(markdownToMdast(text, MD_PARSE), out, walk);\n        return;\n      }\n      break;\n    }\n    // Inline code is kept verbatim — `Array<T>` is a type parameter, not a\n    // tag, and its tokens must stay searchable.\n    case \"inlineCode\": {\n      out.push(node.value);\n      return;\n    }\n    // A raw-HTML run. In a `.md` page (or an `.mdx` page MDX couldn't parse)\n    // CommonMark folds a block-level `<Callout>` with no blank lines into ONE\n    // html node holding all its inner prose, so the node can't just be\n    // dropped — strip the tag-shaped runs and keep the text.\n    case \"html\": {\n      out.push(\n        node.value.replaceAll(HTML_COMMENT, \" \").replaceAll(HTML_OR_JSX, \" \"),\n        \" \"\n      );\n      return;\n    }\n    case \"break\": {\n      out.push(\" \");\n      return;\n    }\n    // Trailing heading markers (`[#custom-id]`, `{#custom-id}`, `[!toc]`,\n    // `[toc]`) are anchor\n\n    // metadata, not prose — strip them so they never pollute the index. Only\n    // a marker that ends the heading's final plain-text child counts,\n    // mirroring the renderer: a heading ending in inline code or an image\n    // keeps its bracketed text on the page (so it stays searchable), and a\n    // heading that is nothing but markers renders them literally.\n    case \"heading\": {\n      const last = node.children.at(-1);\n      const trailing = last?.type === \"text\" ? last : undefined;\n      const inner: string[] = [];\n      const kept = trailing ? node.children.slice(0, -1) : node.children;\n      for (const child of kept) {\n        collectText(child, inner, walk);\n      }\n      if (trailing) {\n        const stripped = parseHeadingMarkers(trailing.value).text;\n        const literal = stripped === \"\" && node.children.length === 1;\n        inner.push(literal ? trailing.value : stripped);\n      }\n      out.push(inner.join(\"\").trimEnd(), \" \");\n      return;\n    }\n    default: {\n      break;\n    }\n  }\n  if (\"value\" in node) {\n    out.push(node.value);\n    return;\n  }\n  if (\"children\" in node) {\n    for (const child of node.children) {\n      collectText(child, out, walk);\n    }\n    if (separatesWords(node)) {\n      out.push(\" \");\n    }\n  }\n};\n\n/**\n * Reduce Markdown/MDX to plain, searchable text: parse (GFM included) and walk\n * the tree instead of regex-stripping the source, so reference-style links,\n * autolinks, setext headings, tables, and literal `*`/`~`/`>` in prose all\n * reduce correctly. This feeds the client index *and* every hosted-provider\n * record, so anything lost here is a permanent search-quality loss.\n */\nconst toPlainText = (\n  markdown: string,\n  format: PageFormat,\n  walk: Walk\n): string => {\n  const tree = parseMarkdown(markdown, format);\n  if (!tree) {\n    return \"\";\n  }\n  const out: string[] = [];\n  collectText(tree, out, walk);\n  return out.join(\"\").replaceAll(WHITESPACE, \" \").trim();\n};\n\ninterface Crumbs {\n  breadcrumb: string[];\n  section: string;\n}\n\n/**\n * Map each page route to its ancestor section labels by walking the nav sidebar\n * once. The nearest ancestor group — the sidebar section a page appears under —\n * becomes its `section`, the dimension the search filter pills group by, so the\n * pills mirror the visible sidebar (and honor folder-meta renames).\n */\nconst buildCrumbIndex = (sidebar: NavNode[]): Map<string, Crumbs> => {\n  const index = new Map<string, Crumbs>();\n  // A config-sidebar section's landing page (the group's `root`) lives on the\n  // *group* node, not on any page leaf — record it under the group's own label\n  // so the section's landing page carries the same facet as its children. A\n  // real page leaf for the route (filesystem sidebars emit index pages as\n  // leaves) wins, so group routes are merged in only where no leaf claimed one.\n  const groupRoutes = new Map<string, Crumbs>();\n  const walk = (nodes: NavNode[], trail: string[]): void => {\n    for (const node of nodes) {\n      if (node.kind === \"group\") {\n        if (node.route && !groupRoutes.has(node.route)) {\n          groupRoutes.set(node.route, {\n            breadcrumb: [...trail, node.label],\n            section: node.label,\n          });\n        }\n        walk(node.children, [...trail, node.label]);\n      } else if (node.route) {\n        index.set(node.route, {\n          breadcrumb: trail,\n          section: trail.at(-1) ?? \"\",\n        });\n      }\n    }\n  };\n  walk(sidebar, []);\n  for (const [route, crumbs] of groupRoutes) {\n    if (!index.has(route)) {\n      index.set(route, crumbs);\n    }\n  }\n  return index;\n};\n\ninterface BuildOptions {\n  includeWhenDisabled?: boolean;\n  content?: \"markdown\" | \"plain\";\n  audience?: VisibilityAudience;\n}\n\n/**\n * Read a page's body and reduce it per the extraction options. The\n * `\"markdown\"` body is agent-facing, so its components are downleveled in the\n * source with the serializers every agent surface uses (front matter in scope\n * for prop expressions). The plain body is parsed as written and walked, with\n * the same serializers applied per component on the way, so the index reads a\n * `<Card>` or `<TypeTable>` as the text it shows.\n */\nconst pageBody = async (\n  project: BlumeProject,\n  page: PageRecord | undefined,\n  options: Pick<BuildOptions, \"audience\" | \"content\"> | undefined,\n  components: Record<string, ComponentMarkdown>\n): Promise<string> => {\n  if (!page) {\n    return \"\";\n  }\n  const parsed = matter(await readExpandedEntryText(project, page));\n  const visible = applyAudienceVisibility(\n    parsed.content,\n    options?.audience ?? \"web\"\n  );\n  if (options?.content === \"markdown\") {\n    return downlevelComponents(visible.trim(), components, parsed.data);\n  }\n  return toPlainText(visible, page.format, {\n    downlevel: {\n      frontmatter: parsed.data,\n      registry: componentRegistry(components),\n      source: visible,\n    },\n    includeCodeBlocks: project.config.search.indexing.includeCodeBlocks,\n  });\n};\n\n/**\n * Build search documents from the content graph. Only indexable pages are\n * included (per the route manifest), and content comes from the source files,\n * so the index is identical in dev and build.\n *\n * Pass `includeWhenDisabled` to index pages on their content merits even when\n * the search provider is `none` — used by the MCP server, which is a separate\n * feature from on-page search.\n *\n * `content` selects the extraction: `\"plain\"` (default) strips Markdown to bare\n * searchable text; `\"markdown\"` keeps the body's Markdown — code blocks, lists,\n * headings — for Ask AI grounding, where fenced examples are often the answer\n * and stripping them makes the model unable to cite content the docs do contain.\n * The `\"markdown\"` body is agent-facing, so components are downleveled with the\n * same serializers the `.md` mirror, llms-full.txt and MCP `get_page` use: a\n * page whose body is a `<CardGroup>` of `<Card>`s is prose to a reader and bare\n * JSX to anything reading the source, and section landing pages are exactly\n * that shape.\n *\n * `audience` resolves `<Visibility>` blocks before extraction: `\"web\"`\n * (default) keeps web-only content and drops agents-only blocks — the site\n * search and hosted syncs must not surface content the page hides — while\n * `\"agents\"` mirrors llms-full.txt/MCP `get_page` (web removed, agents kept).\n *\n * Whether fenced code joins the plain extraction is site-wide policy, read\n * from `search.indexing.includeCodeBlocks` here rather than threaded by each\n * caller, so the client index, hosted syncs, eject, and the MCP `search_docs`\n * index can't drift apart.\n */\nexport const buildSearchDocuments = async (\n  project: BlumeProject,\n  options?: BuildOptions\n): Promise<SearchDocument[]> => {\n  const pageById = new Map(project.graph.pages.map((page) => [page.id, page]));\n\n  // Build the crumb index from every locale's sidebar (their nodes carry\n  // locale-prefixed routes), so localized pages get the right section/breadcrumb.\n  // Falls back to the single default-locale nav when i18n is off.\n  const byLocale = Object.values(project.graph.navigationByLocale ?? {});\n  // Archived versions' trees contribute too, so snapshot pages get their own\n  // section/breadcrumb instead of falling through to the \"Docs\" default.\n  const byVersion = Object.values(project.graph.navigationByVersion ?? {})\n    .flatMap((locales) => Object.values(locales))\n    .map((nav) => nav.sidebar);\n  const sidebars = [\n    ...(byLocale.length > 0\n      ? byLocale.map((nav) => nav.sidebar)\n      : [project.graph.navigation?.sidebar ?? []]),\n    ...byVersion,\n  ];\n  const crumbs = new Map<string, Crumbs>();\n  for (const sidebar of sidebars) {\n    for (const [route, crumb] of buildCrumbIndex(sidebar)) {\n      crumbs.set(route, crumb);\n    }\n  }\n\n  const indexable = project.manifest.routes.filter((route) => {\n    if (!options?.includeWhenDisabled) {\n      return route.indexable;\n    }\n    // A fallback route renders the fallback locale's page at another locale's\n    // URL, so indexing it would only repeat that page as a second hit — the\n    // reason site search leaves it out too.\n    if (route.fallback) {\n      return false;\n    }\n    const page = pageById.get(route.id);\n    return page ? contentIndexable(page, project.config) : false;\n  });\n\n  // Built once — `downlevelComponents` rebuilds its registry per call\n  // otherwise.\n  const components = projectComponentSerializers(project);\n\n  return await Promise.all(\n    indexable.map(async (route) => {\n      const page = pageById.get(route.id);\n      const body = await pageBody(project, page, options, components);\n      const tags = page?.meta?.search?.tags;\n      const crumb = crumbs.get(route.path);\n      const facets = page ? pageFacets(page, project.config) : undefined;\n      const document: SearchDocument = {\n        breadcrumb: crumb?.breadcrumb ?? [],\n        content: body,\n        contentType: route.contentType,\n        description: page?.description ?? \"\",\n        locale: route.locale,\n        route: route.path,\n        section: crumb?.section || \"Docs\",\n        tags: tags && tags.length > 0 ? tags : undefined,\n        title: route.title,\n        version: route.version,\n      };\n      if (facets) {\n        document.facets = facets;\n      }\n      return document;\n    })\n  );\n};\n\n/**\n * Map per-page search documents to the flat record shape hosted backends\n * ingest. One record per page, keyed by route; the first tag becomes the\n * faceting `tag`.\n */\nexport const toSearchRecords = (documents: SearchDocument[]): SearchRecord[] =>\n  documents.map((doc) => ({\n    _id: doc.route,\n    content: doc.content,\n    description: doc.description,\n    locale: doc.locale,\n    tag: doc.tags?.[0],\n    title: doc.title,\n    url: doc.route,\n    version: doc.version || \"current\",\n  }));\n",
+    "/**\n * The shared fence-meta grammar: how the tokens after a code fence's language\n * (```ts title=\"...\" {1,3-5} lineNumbers) split, and which of them carry\n * reserved meaning. Both the Shiki-side meta reader (`code-title.ts`) and the\n * MDAST plugins that rewrite marked fences (`ts2js.ts`) consume this, so the\n * two layers can't drift on token boundaries or keyword lists.\n */\n\n/**\n * Any quoted `key=\"...\"` attr (spaces allowed inside the quotes). The body\n * excludes only the delimiting quote, so `title=\"foo's file.ts\"` (an\n * apostrophe inside double quotes) still matches. The left boundary stops\n * `subtitle=\"...\"` (or any `*title=` attr) from reading as a title.\n */\nexport const QUOTED_ATTR = /[\\w-]+=(?:\"[^\"]*\"|'[^']*')/gu;\n\n/**\n * A Shiki `{1,3-5}` line-range token, braces included. Shiki tolerates\n * whitespace inside the braces (`{1, 3-5}`), so the range is one token even\n * when it contains spaces — split on whitespace alone, `3-5}` would surface\n * as a bare word and be promoted to the block title.\n */\nconst LINE_RANGE = /\\{[^}]*\\}/u;\n\n/**\n * One fence-meta token: a quoted attribute, a line range, or a bare word, so\n * a keyword inside a quoted value (`title=\"enable ts2js later\"`) never reads\n * as a bare token and a spaced line range never splits.\n */\nconst META_TOKEN = new RegExp(\n  `${QUOTED_ATTR.source}|${LINE_RANGE.source}|\\\\S+`,\n  \"gu\"\n);\n\n/** Split a raw fence meta string into its tokens. */\nexport const metaTokens = (meta: string | null | undefined): string[] =>\n  meta?.match(META_TOKEN) ?? [];\n\n/**\n * Bare keywords with reserved meaning after the language; never promoted to\n * a block title.\n */\nexport const RESERVED_META_KEYWORDS: ReadonlySet<string> = new Set([\n  \"lineNumbers\",\n  \"ts2js\",\n  \"twoslash\",\n]);\n\n/** A Shiki `{1,3-5}` line-range token. */\nexport const isLineRange = (token: string): boolean => token.startsWith(\"{\");\n",
+    "/**\n * Code-fence meta. A Shiki transformer reads the tokens after the language and\n * promotes them to attributes on the rendered `<pre>`:\n *\n * - a title — the first bare token (```ts blume.config.ts) or `title=\"...\"` —\n *   becomes `data-title`; the theme's code header shows it, falling back to the\n *   language label.\n * - the `lineNumbers` keyword (```ts file.ts lineNumbers) becomes\n *   `data-line-numbers`; the theme renders a counter-driven line-number gutter.\n */\n\nimport {\n  isLineRange,\n  metaTokens,\n  QUOTED_ATTR,\n  RESERVED_META_KEYWORDS,\n} from \"./fence-meta.ts\";\n\n/** The slice of Shiki's transformer `this` context Blume reads. */\ninterface CodeMetaContext {\n  options: { meta?: { __raw?: string } };\n}\n\n/** The `<pre>` hast node a Shiki `pre` hook receives. */\ninterface PreNode {\n  properties: Record<string, boolean | number | string | undefined>;\n}\n\n/** A Shiki-compatible transformer, typed structurally to avoid a Shiki dep. */\nexport interface CodeTitleTransformer {\n  name: string;\n  pre: (this: CodeMetaContext, node: PreNode) => void;\n}\n\nconst TITLE_ATTR = /(?:^|\\s)title=(?:\"(?<dq>[^\"]*)\"|'(?<sq>[^']*)')/u;\nconst LINE_NUMBERS = /(?:^|\\s)lineNumbers(?=\\s|$)/u;\n\n// Quoted attrs are blanked before keyword/bare-token scans so a quoted value\n// can't leak tokens (`title=\"enable lineNumbers later\"`).\nconst withoutQuotedAttrs = (raw: string): string =>\n  raw.replace(QUOTED_ATTR, \" \");\n\n// The first bare token is the title (```ts blume.config.ts): a non-empty token\n// that isn't a Shiki line range (`{1,3-5}`), a `key=value` attr, or a reserved\n// keyword.\nconst isTitleToken = (token: string): boolean =>\n  token.length > 0 &&\n  !isLineRange(token) &&\n  !token.includes(\"=\") &&\n  !RESERVED_META_KEYWORDS.has(token);\n\n/** The title a fence's meta string promotes to `data-title`, if any. */\nexport const parseCodeTitle = (raw: string | undefined): string | undefined => {\n  if (!raw) {\n    return undefined;\n  }\n  // Blank every *other* quoted attr first, so a `title=\"…\"` embedded in\n  // another attribute's value (`caption='set title=\"X\" here'`) can't be\n  // promoted to the block title.\n  const scrubbed = raw.replace(QUOTED_ATTR, (attr) =>\n    attr.startsWith(\"title=\") ? attr : \" \"\n  );\n  const explicit = scrubbed.match(TITLE_ATTR);\n  const attrTitle = explicit?.groups?.dq ?? explicit?.groups?.sq;\n  if (attrTitle) {\n    return attrTitle;\n  }\n  // The shared tokenizer keeps a quoted attr (rejected below by its `=`) and\n  // a spaced line range (`{1, 3-5}`) whole, so neither can shed a fragment\n  // that reads as a bare title.\n  return metaTokens(raw).find(isTitleToken);\n};\n\nconst hasLineNumbers = (raw: string | undefined): boolean =>\n  Boolean(raw && LINE_NUMBERS.test(withoutQuotedAttrs(raw)));\n\n/** Build the transformer. Runs after Shiki's built-in `data-language` hook. */\nexport const codeTitleTransformer = (): CodeTitleTransformer => ({\n  name: \"blume:code-meta\",\n  pre(node) {\n    const raw = this.options.meta?.__raw;\n    const title = parseCodeTitle(raw);\n    if (title) {\n      node.properties.dataTitle = title;\n    }\n    if (hasLineNumbers(raw)) {\n      node.properties.dataLineNumbers = true;\n    }\n  },\n});\n",
+    "import type { ResolvedConfig } from \"../core/schema.ts\";\nimport type { PageRecord } from \"../core/types.ts\";\n\n/**\n * Resolve a page's facet values: the subset of its validated custom\n * frontmatter named by its content type's `facets` declaration. Strings facet\n * as-is; numbers and booleans are stringified so an enum-like `priority: 1`\n * or `enforced: true` still filters; any other shape (objects, arrays,\n * transformed dates) is not a facet value and is skipped. Returns `undefined`\n * when nothing facets, so the field stays absent from serialized documents\n * rather than shipping as `{}` on every page.\n */\n/** Whether a custom frontmatter value stringifies into a usable facet value. */\nconst isFacetValue = <T>(value: T): value is T & (string | number | boolean) =>\n  typeof value === \"string\" ||\n  typeof value === \"number\" ||\n  typeof value === \"boolean\";\n\nexport const pageFacets = (\n  page: Pick<PageRecord, \"contentType\" | \"custom\">,\n  config: ResolvedConfig\n): Record<string, string> | undefined => {\n  const declared = config.content.types[page.contentType]?.facets;\n  if (!declared || declared.length === 0 || !page.custom) {\n    return;\n  }\n  const facets: Record<string, string> = {};\n  for (const key of declared) {\n    const value = page.custom[key];\n    if (isFacetValue(value)) {\n      facets[key] = String(value);\n    }\n  }\n  return Object.keys(facets).length > 0 ? facets : undefined;\n};\n",
+    "import { normalizeBasePath } from \"../../core/base-path.ts\";\nimport type { BlumeProject } from \"../../core/project-graph.ts\";\nimport type { Navigation } from \"../../core/types.ts\";\nimport { buildSearchDocuments } from \"../../search/documents.ts\";\nimport { pageFacets } from \"../../search/facets.ts\";\nimport type { OramaDoc } from \"../../search/orama-index.ts\";\nimport { agentMarkdown, buildRawMarkdown } from \"../markdown.ts\";\n\n/** A page entry surfaced by the `list_pages` MCP tool. */\nexport interface McpRoute {\n  contentType: string;\n  description?: string;\n  /** Declared facet values (`content.types.<type>.facets`), key → value. */\n  facets?: Record<string, string>;\n  indexable: boolean;\n  lastModified: string | null;\n  /** Resolved locale code (the default locale when not under i18n). */\n  locale: string;\n  route: string;\n  title: string;\n  /** Docs version (`\"\"` for the current docs). */\n  version: string;\n}\n\n/**\n * The self-contained snapshot the generated MCP endpoint serves. Bundles the\n * search documents, raw page Markdown, route list, and navigation so the server\n * works regardless of the configured search provider and needs no filesystem\n * access at request time. Serialized to `generated/mcp-data.json`.\n */\nexport interface McpData {\n  /**\n   * Normalized `deployment.base` (`\"\"` or `/seg`), layered onto routes when\n   * emitting URLs — the site is base-less and routes are base-less manifest\n   * paths, matching the sitemap/llms.txt convention.\n   */\n  base: string;\n  /**\n   * The site's `i18n.defaultLocale`, when i18n is configured. Selects a\n   * word-segmenting Orama tokenizer for every non-Latin script, so\n   * `search_docs` can match CJK, Cyrillic, Greek, Hebrew, or Devanagari\n   * content.\n   */\n  defaultLocale?: string;\n  /**\n   * Archived docs version ids, in configured order. Present only on a\n   * versioned site; its presence is what makes `search_docs`/`list_pages`\n   * default to the current docs.\n   */\n  archivedVersions?: string[];\n  documents: OramaDoc[];\n  instructions?: string;\n  name: string;\n  navigation: Navigation;\n  /** Per-locale trees for a locale-aware `get_navigation` (i18n sites only). */\n  navigationByLocale?: Record<string, Navigation>;\n  /** Per-archived-version trees, keyed by version id then locale code. */\n  navigationByVersion?: Record<string, Record<string, Navigation>>;\n  pages: Record<string, string>;\n  routes: McpRoute[];\n  site: string | null;\n  version: string;\n}\n\n/** Build the MCP data snapshot from a resolved project. */\nexport const buildMcpData = async (project: BlumeProject): Promise<McpData> => {\n  const { config, graph, manifest } = project;\n  const [documents, rawMarkdown] = await Promise.all([\n    // The MCP server is independent of on-page search, so index docs even when\n    // the search provider is `none`. Documents are agent-facing, so\n    // `<Visibility>` resolves like `get_page`/llms-full.txt (web-only content\n    // removed, agents-only kept).\n    buildSearchDocuments(project, {\n      audience: \"agents\",\n      includeWhenDisabled: true,\n    }),\n    buildRawMarkdown(project),\n  ]);\n\n  // `get_page` serves the agent variant: components downleveled to Markdown.\n  const pages = Object.fromEntries(\n    Object.entries(rawMarkdown).map(([route, entry]) => [\n      route,\n      agentMarkdown(entry),\n    ])\n  );\n\n  const pageById = new Map(graph.pages.map((page) => [page.id, page]));\n\n  const routes: McpRoute[] = [];\n  // Fallback routes render the fallback locale's page at another locale's\n  // URL: listing them would pass that page off as a translation, once per\n  // locale. `get_page` still resolves them through `pages`, as llms.txt and\n  // search leave them out.\n  for (const route of manifest.routes) {\n    if (route.hidden || route.fallback) {\n      continue;\n    }\n    const page = pageById.get(route.id);\n    const facets = page ? pageFacets(page, config) : undefined;\n    const entry: McpRoute = {\n      contentType: route.contentType,\n      description: page?.description,\n      indexable: route.indexable,\n      lastModified: route.lastModified ?? null,\n      locale: route.locale,\n      route: route.path,\n      title: route.title,\n      version: route.version,\n    };\n    if (facets) {\n      entry.facets = facets;\n    }\n    routes.push(entry);\n  }\n\n  const data: McpData = {\n    base: normalizeBasePath(config.deployment.options.base),\n    defaultLocale: config.i18n?.defaultLocale,\n    documents: documents.map((doc) => {\n      const document: OramaDoc = {\n        content: doc.content,\n        contentType: doc.contentType,\n        description: doc.description,\n        locale: doc.locale,\n        route: doc.route,\n        title: doc.title,\n        version: doc.version,\n      };\n      if (doc.facets) {\n        document.facets = doc.facets;\n      }\n      return document;\n    }),\n    instructions: config.agents.mcp.instructions,\n    name: config.agents.mcp.name ?? config.title,\n    navigation: graph.navigation,\n    pages,\n    routes,\n    site: config.deployment.options.site ?? null,\n    version: manifest.blumeVersion,\n  };\n  if (config.versions) {\n    data.archivedVersions = config.versions.archived.map(\n      (version) => version.id\n    );\n    data.navigationByVersion = graph.navigationByVersion;\n  }\n  if (config.i18n) {\n    data.navigationByLocale = graph.navigationByLocale;\n  }\n  return data;\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "341A56DACBB5F6DE64756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-abh8yjkn.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+// src/core/sources/watch.ts
+var BLUME_IGNORE_DIRS = [
+  ".blume",
+  ".blume-verify",
+  ".cache",
+  ".git",
+  ".next",
+  ".turbo",
+  ".vercel",
+  "dist",
+  "node_modules"
+];
+var baselineScanIgnore = () => BLUME_IGNORE_DIRS.map((dir) => `**/${dir}/**`);
+var BLUME_WATCH_IGNORE_DIRS = BLUME_IGNORE_DIRS;
+var excludeDirSegments = (patterns) => patterns.map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir).filter((dir) => dir !== undefined);
+var ignoringWatchListener = (onChange, ignoreDirs = BLUME_WATCH_IGNORE_DIRS, ignoreSegment = () => false) => {
+  const ignore = new Set(ignoreDirs);
+  return (_event, filename) => {
+    if (filename !== null && filename.split(/[/\\]/u).some((segment) => ignore.has(segment) || ignoreSegment(segment))) {
+      return;
+    }
+    onChange();
+  };
+};
+
+export { BLUME_IGNORE_DIRS, baselineScanIgnore, BLUME_WATCH_IGNORE_DIRS, excludeDirSegments, ignoringWatchListener };
+
+//# debugId=E327C8C451E6563064756E2164756E21
+//# sourceMappingURL=chunk-abh8yjkn.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/core/sources/watch.ts"],
+  "sourcesContent": [
+    "import type { WatchListener } from \"node:fs\";\n\n/**\n * Directory segments that are never authored content: VCS, dependency trees,\n * Blume's own generated project and build output, and framework/deploy caches.\n * Both the content scan and the dev watcher skip these unconditionally, on top\n * of the user's `content.exclude`.\n *\n * The scan needs them because a broadly-scoped `content.root` — `\".\"` or an app\n * dir that also holds `node_modules`/`dist`, the common shape when migrating a\n * docs app that lives at the repo or app root — would otherwise glob thousands\n * of stray markdown files out of dependencies and build artifacts. `content.root`\n * defaults to `docs/` where this rarely bites, but any wider root hits it.\n *\n * The watcher needs them because a recursive `fs.watch` rooted at the project\n * also sees Blume's own `.blume/` output, which the dev server rewrites on every\n * render (e.g. `.blume/.astro/data-store.json`). Left unfiltered, each such write\n * re-triggers a rescan + runtime regeneration whose writes land back under\n * `.blume/` and fire the watcher again: a self-sustaining loop that stalls page\n * renders and floods the console. `fs.watch` has no ignore option, so we filter\n * by the changed path in the callback.\n */\nexport const BLUME_IGNORE_DIRS = [\n  \".blume\",\n  // The isolated `blume check --isolated` runtime. A sibling of `.blume`, it is\n  // written while a dev server runs; without this the content-layer watcher (or\n  // a `.`-rooted fs.watch) would treat its generation as a content change and\n  // reload — the very thing `--isolated` promises not to do.\n  \".blume-verify\",\n  \".cache\",\n  \".git\",\n  \".next\",\n  \".turbo\",\n  \".vercel\",\n  \"dist\",\n  \"node_modules\",\n];\n\n/**\n * Baseline scan-ignore globs applied to every filesystem source, unioned with\n * the user's `content.exclude`. Kept in sync with the watcher via the shared\n * {@link BLUME_IGNORE_DIRS} so `load()` and `watch()` never disagree on what is\n * content. `**\\/<dir>/**` matches the directory at the content root or nested.\n */\nexport const baselineScanIgnore = (): string[] =>\n  BLUME_IGNORE_DIRS.map((dir) => `**/${dir}/**`);\n\n/**\n * Alias retained for the dev watcher's call site and its tests; the watcher and\n * the scan share the same never-content directory set.\n */\nexport const BLUME_WATCH_IGNORE_DIRS = BLUME_IGNORE_DIRS;\n\n/** Extract single-segment ignore dirs (`foo`) from `foo/**`-style excludes. */\nexport const excludeDirSegments = (patterns: readonly string[]): string[] =>\n  patterns\n    .map((pattern) => /^(?<dir>[^*/]+)\\/\\*\\*$/u.exec(pattern)?.groups?.dir)\n    .filter((dir): dir is string => dir !== undefined);\n\n/**\n * Build a recursive-watch listener that fires `onChange` for content changes but\n * ignores events whose path crosses an ignored directory segment — one in\n * `ignoreDirs`, or one `ignoreSegment` rejects, for a scan whose skip rule is\n * a shape (every dot-name) rather than a list. A missing `filename` — rare;\n * the platform couldn't name the changed path — falls through to `onChange`\n * rather than silently dropping a real edit. Exported for testing.\n */\nexport const ignoringWatchListener = (\n  onChange: () => void,\n  ignoreDirs: Iterable<string> = BLUME_WATCH_IGNORE_DIRS,\n  ignoreSegment: (segment: string) => boolean = () => false\n): WatchListener<string> => {\n  const ignore = new Set(ignoreDirs);\n  return (_event, filename) => {\n    if (\n      filename !== null &&\n      filename\n        .split(/[/\\\\]/u)\n        .some((segment) => ignore.has(segment) || ignoreSegment(segment))\n    ) {\n      return;\n    }\n    onChange();\n  };\n};\n"
+  ],
+  "mappings": ";;;AAsBO,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EAKA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,IAAM,qBAAqB,MAChC,kBAAkB,IAAI,CAAC,QAAQ,MAAM,QAAQ;AAMxC,IAAM,0BAA0B;AAGhC,IAAM,qBAAqB,CAAC,aACjC,SACG,IAAI,CAAC,YAAY,0BAA0B,KAAK,OAAO,GAAG,QAAQ,GAAG,EACrE,OAAO,CAAC,QAAuB,QAAQ,SAAS;AAU9C,IAAM,wBAAwB,CACnC,UACA,aAA+B,yBAC/B,gBAA8C,MAAM,UAC1B;AAAA,EAC1B,MAAM,SAAS,IAAI,IAAI,UAAU;AAAA,EACjC,OAAO,CAAC,QAAQ,aAAa;AAAA,IAC3B,IACE,aAAa,QACb,SACG,MAAM,QAAQ,EACd,KAAK,CAAC,YAAY,OAAO,IAAI,OAAO,KAAK,cAAc,OAAO,CAAC,GAClE;AAAA,MACA;AAAA,IACF;AAAA,IACA,SAAS;AAAA;AAAA;",
+  "debugId": "E327C8C451E6563064756E2164756E21",
+  "names": []
+}

package/dist/cli/chunk-b5aj94ah.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import {
+  loadConfig
+} from "./chunk-xaz13gwg.js";
+import"./chunk-jts8mvcz.js";
+import {
+  commandMeta,
+  reportInternalError,
+  BlumeError,
+  logger,
+  reportDiagnostics
+} from "./index.js";
+import"./chunk-jq5n4avg.js";
+import"./chunk-zg2gtj10.js";
+import {
+  CutError,
+  cutVersion
+} from "./chunk-sqn5t4q0.js";
+
+// src/cli/commands/version.ts
+import { defineCommand } from "citty";
+var listVersions = async (root) => {
+  const { config } = await loadConfig(root);
+  if (!config.versions) {
+    logger.info("Versioning is not configured. Cut the first version with `blume version <id>` (e.g. `blume version v1.0`).");
+    return;
+  }
+  const { current, archived } = config.versions;
+  process.stdout.write(`  ${current.label} (current)${current.badge ? ` — ${current.badge}` : ""}
+`);
+  for (const version of archived) {
+    process.stdout.write(`  ${version.label ?? version.id} — ${version.id}/
+`);
+  }
+};
+var reportCut = (id, result) => {
+  logger.success(`Snapshot ${result.dir} (${result.copied} file(s) copied)`);
+  const totalRewrites = result.rewritten.reduce((sum, entry) => sum + entry.count, 0);
+  if (totalRewrites > 0) {
+    logger.info(`Rewrote root-absolute links in ${result.rewritten.length} page(s) (${totalRewrites} line(s)).`);
+  }
+  if (result.versionsAdded) {
+    logger.success(`Turned on versioning in blume.config.ts with "${id}" archived; the live docs are labeled "Latest" in the switcher until you rename versions.current.label.`);
+  } else if (result.configUpdated) {
+    logger.success(`Added "${id}" to versions.archived in blume.config.ts`);
+  } else if (result.configSnippet) {
+    logger.warn(`blume.config.ts couldn't be updated automatically, so "${id}" isn't registered yet and its pages build as ordinary content until it is. ${result.configSnippet}`);
+  }
+  logger.info("Archived versions are frozen — future edits belong in the live tree. Restart `blume dev` to pick up the snapshot.");
+};
+var versionCommand = defineCommand({
+  args: {
+    force: {
+      description: "Overwrite an existing snapshot directory.",
+      type: "boolean"
+    },
+    id: {
+      description: 'Version id to cut (e.g. "v1.0").',
+      required: false,
+      type: "positional"
+    }
+  },
+  meta: commandMeta.version,
+  async run({ args }) {
+    const root = process.cwd();
+    try {
+      if (args.id) {
+        reportCut(args.id, await cutVersion(root, args.id, { force: args.force }));
+      } else {
+        await listVersions(root);
+      }
+    } catch (error) {
+      if (error instanceof CutError) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      if (error instanceof BlumeError) {
+        reportDiagnostics([error.diagnostic], root);
+        process.exit(1);
+      }
+      reportInternalError(error);
+      process.exit(1);
+    }
+  }
+});
+export {
+  versionCommand
+};
+
+//# debugId=86F69482E9E3E55264756E2164756E21
+//# sourceMappingURL=chunk-b5aj94ah.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/version.ts"],
+  "sourcesContent": [
+    "import { defineCommand } from \"citty\";\n\nimport { loadConfig } from \"../../core/config.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { CutError, cutVersion } from \"../../core/version-cut.ts\";\nimport type { CutResult } from \"../../core/version-cut.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport { logger, reportDiagnostics } from \"../log.ts\";\n\n/** `blume version` with no id: list the configured versions. */\nconst listVersions = async (root: string): Promise<void> => {\n  const { config } = await loadConfig(root);\n  if (!config.versions) {\n    logger.info(\n      \"Versioning is not configured. Cut the first version with `blume version <id>` (e.g. `blume version v1.0`).\"\n    );\n    return;\n  }\n  const { current, archived } = config.versions;\n  process.stdout.write(\n    `  ${current.label} (current)${current.badge ? ` — ${current.badge}` : \"\"}\\n`\n  );\n  for (const version of archived) {\n    process.stdout.write(`  ${version.label ?? version.id} — ${version.id}/\\n`);\n  }\n};\n\n/** Report what a cut did, including how its id reached the config (or didn't). */\nconst reportCut = (id: string, result: CutResult): void => {\n  logger.success(`Snapshot ${result.dir} (${result.copied} file(s) copied)`);\n  const totalRewrites = result.rewritten.reduce(\n    (sum, entry) => sum + entry.count,\n    0\n  );\n  if (totalRewrites > 0) {\n    logger.info(\n      `Rewrote root-absolute links in ${result.rewritten.length} page(s) (${totalRewrites} line(s)).`\n    );\n  }\n  if (result.versionsAdded) {\n    logger.success(\n      `Turned on versioning in blume.config.ts with \"${id}\" archived; the live docs are labeled \"Latest\" in the switcher until you rename versions.current.label.`\n    );\n  } else if (result.configUpdated) {\n    logger.success(`Added \"${id}\" to versions.archived in blume.config.ts`);\n  } else if (result.configSnippet) {\n    // A warning, not info: until it's pasted, the snapshot builds as ordinary\n    // content — every page twice — and consola drops info lines under CI.\n    logger.warn(\n      `blume.config.ts couldn't be updated automatically, so \"${id}\" isn't registered yet and its pages build as ordinary content until it is. ${result.configSnippet}`\n    );\n  }\n  logger.info(\n    \"Archived versions are frozen — future edits belong in the live tree. Restart `blume dev` to pick up the snapshot.\"\n  );\n};\n\nexport const versionCommand = defineCommand({\n  args: {\n    force: {\n      description: \"Overwrite an existing snapshot directory.\",\n      type: \"boolean\",\n    },\n    id: {\n      description: 'Version id to cut (e.g. \"v1.0\").',\n      required: false,\n      type: \"positional\",\n    },\n  },\n  meta: commandMeta.version,\n  async run({ args }) {\n    const root = process.cwd();\n    try {\n      if (args.id) {\n        reportCut(\n          args.id,\n          await cutVersion(root, args.id, { force: args.force })\n        );\n      } else {\n        await listVersions(root);\n      }\n    } catch (error) {\n      if (error instanceof CutError) {\n        logger.error(error.message);\n        process.exit(1);\n      }\n      if (error instanceof BlumeError) {\n        reportDiagnostics([error.diagnostic], root);\n        process.exit(1);\n      }\n      reportInternalError(error);\n      process.exit(1);\n    }\n  },\n});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAWA,IAAM,eAAe,OAAO,SAAgC;AAAA,EAC1D,QAAQ,WAAW,MAAM,WAAW,IAAI;AAAA,EACxC,IAAI,CAAC,OAAO,UAAU;AAAA,IACpB,OAAO,KACL,4GACF;AAAA,IACA;AAAA,EACF;AAAA,EACA,QAAQ,SAAS,aAAa,OAAO;AAAA,EACrC,QAAQ,OAAO,MACb,KAAK,QAAQ,kBAAkB,QAAQ,QAAQ,MAAM,QAAQ,UAAU;AAAA,CACzE;AAAA,EACA,WAAW,WAAW,UAAU;AAAA,IAC9B,QAAQ,OAAO,MAAM,KAAK,QAAQ,SAAS,QAAQ,QAAQ,QAAQ;AAAA,CAAO;AAAA,EAC5E;AAAA;AAIF,IAAM,YAAY,CAAC,IAAY,WAA4B;AAAA,EACzD,OAAO,QAAQ,YAAY,OAAO,QAAQ,OAAO,wBAAwB;AAAA,EACzE,MAAM,gBAAgB,OAAO,UAAU,OACrC,CAAC,KAAK,UAAU,MAAM,MAAM,OAC5B,CACF;AAAA,EACA,IAAI,gBAAgB,GAAG;AAAA,IACrB,OAAO,KACL,kCAAkC,OAAO,UAAU,mBAAmB,yBACxE;AAAA,EACF;AAAA,EACA,IAAI,OAAO,eAAe;AAAA,IACxB,OAAO,QACL,iDAAiD,2GACnD;AAAA,EACF,EAAO,SAAI,OAAO,eAAe;AAAA,IAC/B,OAAO,QAAQ,UAAU,6CAA6C;AAAA,EACxE,EAAO,SAAI,OAAO,eAAe;AAAA,IAG/B,OAAO,KACL,0DAA0D,iFAAiF,OAAO,eACpJ;AAAA,EACF;AAAA,EACA,OAAO,KACL,mHACF;AAAA;AAGK,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,aAAa;AAAA,MACb,MAAM;AAAA,IACR;AAAA,IACA,IAAI;AAAA,MACF,aAAa;AAAA,MACb,UAAU;AAAA,MACV,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,MAAM,YAAY;AAAA,OACZ,IAAG,GAAG,QAAQ;AAAA,IAClB,MAAM,OAAO,QAAQ,IAAI;AAAA,IACzB,IAAI;AAAA,MACF,IAAI,KAAK,IAAI;AAAA,QACX,UACE,KAAK,IACL,MAAM,WAAW,MAAM,KAAK,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC,CACvD;AAAA,MACF,EAAO;AAAA,QACL,MAAM,aAAa,IAAI;AAAA;AAAA,MAEzB,OAAO,OAAO;AAAA,MACd,IAAI,iBAAiB,UAAU;AAAA,QAC7B,OAAO,MAAM,MAAM,OAAO;AAAA,QAC1B,QAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,MACA,IAAI,iBAAiB,YAAY;AAAA,QAC/B,kBAAkB,CAAC,MAAM,UAAU,GAAG,IAAI;AAAA,QAC1C,QAAQ,KAAK,CAAC;AAAA,MAChB;AAAA,MACA,oBAAoB,KAAK;AAAA,MACzB,QAAQ,KAAK,CAAC;AAAA;AAAA;AAGpB,CAAC;",
+  "debugId": "86F69482E9E3E55264756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-b27xqwn9.js → chunk-bctazmbk.js}

@@ -2,15 +2,19 @@
 import {
   resolveProjectContext,
   loadConfig
-} from "./chunk-7s8hm3b6.js";
+} from "./chunk-xaz13gwg.js";
+import"./chunk-jts8mvcz.js";
 import {
   commandMeta,
   normalizeHost,
   logger
 } from "./index.js";
+import {
+  deployOutputDir
+} from "./chunk-nk3ts2xk.js";
 import {
   parsePort
-} from "./chunk-dwgcp5sm.js";
+} from "./chunk-zxccj738.js";
 
 // src/cli/commands/preview.ts
 import { existsSync } from "node:fs";
@@ -27,7 +31,7 @@ var previewCommand = defineCommand({
     const root = process.cwd();
     const { config } = await loadConfig(root);
     const context = resolveProjectContext(root, config);
-    if (!existsSync(join(context.outDir, "astro.config.mjs"))) {
+    if (!existsSync(join(context.outDir, "astro.config.mjs")) || !existsSync(deployOutputDir(config, context))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
     }
@@ -45,5 +49,5 @@ export {
   previewCommand
 };
 
-//# debugId=F86008553E8CAFA164756E2164756E21
-//# sourceMappingURL=chunk-b27xqwn9.js.map
+//# debugId=7FC21538FC698FBD64756E2164756E21
+//# sourceMappingURL=chunk-bctazmbk.js.map