blume 2.1.3 → 2.2.0

package/dist/cli/{chunk-ckrcm08h.js.map → chunk-a3ydrqny.js.map}

@@ -1,14 +1,13 @@
 {
   "version": 3,
-  "sources": ["../src/core/component-diagnostics.ts", "../src/core/builtin-tags.ts", "../src/astro/islands.ts", "../src/astro/examples.ts", "../src/astro/runtime-deps.ts"],
+  "sources": ["../src/core/component-diagnostics.ts", "../src/astro/islands.ts", "../src/astro/examples.ts", "../src/astro/runtime-deps.ts"],
   "sourcesContent": [
-    "import { relative } from \"pathe\";\n\nimport { BUILTIN_MDX_TAGS } from \"./builtin-tags.ts\";\nimport type { Diagnostic, PageRecord } from \"./types.ts\";\n\n/** `CardGroup` → `card-group`, matching registry item names. */\nconst toKebab = (tag: string): string =>\n  tag\n    .replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, \"$<lower>-$<upper>\")\n    .toLowerCase();\n\n/**\n * Warn when an `.mdx` page uses a `<Component>` tag that resolves to nothing —\n * a built-in, an island, or a `components.ts` override — so a typo surfaces as a\n * friendly diagnostic (with a `blume add` hint where one exists) instead of a raw\n * MDX \"X is not defined\" build error. `extraTags` are the project's own known\n * components (islands + overrides); `registryNames` gates the install hint.\n */\nexport const validateUsedComponents = (\n  pages: PageRecord[],\n  extraTags: Set<string>,\n  registryNames: Set<string>\n): Diagnostic[] => {\n  const diagnostics: Diagnostic[] = [];\n  const seen = new Set<string>();\n  for (const page of pages) {\n    for (const tag of page.componentsUsed ?? []) {\n      if (BUILTIN_MDX_TAGS.has(tag) || extraTags.has(tag) || seen.has(tag)) {\n        continue;\n      }\n      seen.add(tag);\n      const name = toKebab(tag);\n      const suggestion = registryNames.has(name)\n        ? `Run \\`blume add ${name}\\` to install it, or register <${tag}> in components.ts (mdx).`\n        : `Register <${tag}> in components.ts (mdx), or add an islands/${tag}.tsx component.`;\n      diagnostics.push({\n        code: \"BLUME_UNKNOWN_COMPONENT\",\n        file: page.sourcePath ?? page.id,\n        message: `<${tag}> is used in ${page.route} but isn't a known component.`,\n        severity: \"warning\",\n        suggestion,\n      });\n    }\n  }\n  return diagnostics;\n};\n\n/** What example discovery found: where it looked, and each example's key. */\nexport interface ExampleKeys {\n  /** Absolute directory the examples were discovered under. */\n  dir: string;\n  examples: readonly { path: string }[];\n}\n\n/**\n * Warn about each `<Component path>` in an `.mdx` page that names no\n * discovered example. The page still renders, with a \"No example found\" box\n * where the preview should be, so without this a typo or a moved example\n * ships silently. Reported at the `path` value, in the partial that holds it\n * when an `<include>` brought it in; a file shared by several locales is\n * reported once. `extraTags` are the project's own components (islands +\n * overrides), as for {@link validateUsedComponents}: one named `Component`\n * replaces the built-in and resolves `path` its own way, so none is checked.\n */\nexport const missingExampleDiagnostics = (\n  pages: readonly PageRecord[],\n  discovery: ExampleKeys,\n  root: string,\n  extraTags: ReadonlySet<string>\n): Diagnostic[] => {\n  if (extraTags.has(\"Component\")) {\n    return [];\n  }\n  const known = new Set(discovery.examples.map((example) => example.path));\n  const dir = relative(root, discovery.dir) || \".\";\n  const diagnostics: Diagnostic[] = [];\n  const seen = new Set<string>();\n  for (const page of pages) {\n    for (const use of page.examplesUsed ?? []) {\n      const file = use.file ?? page.sourcePath ?? page.id;\n      const key = `${file}:${use.line}:${use.column}`;\n      if (!(known.has(use.path) || seen.has(key))) {\n        seen.add(key);\n        diagnostics.push({\n          code: \"BLUME_EXAMPLE_NOT_FOUND\",\n          column: use.column,\n          file,\n          line: use.line,\n          message: `<Component path=\"${use.path}\"> in ${page.route} names no example, so the page shows \"No example found\" in its place.`,\n          severity: \"warning\",\n          suggestion: `Fix the path, or add the example under ${dir}/: \\`path\\` is its location there, without the extension.`,\n        });\n      }\n    }\n  }\n  return diagnostics;\n};\n",
-    "/**\n * The MDX component tags Blume ships (the keys of the catch-all's component map,\n * plus composed sub-parts like `Color.Item`/`Tree.File`). Used by the\n * missing-component diagnostic to tell an unknown `<Tag>` from a built-in. Keep\n * in sync with the component map in `astro/templates.ts`.\n */\nexport const BUILTIN_MDX_TAGS = new Set<string>([\n  \"Accordion\",\n  \"AccordionItem\",\n  \"ApiOverview\",\n  \"ApiTagOperations\",\n  \"AutoTypeTable\",\n  \"Badge\",\n  \"Callout\",\n  \"Card\",\n  \"CardGroup\",\n  \"CodeBlock\",\n  \"CodeGroup\",\n  \"Color\",\n  \"Column\",\n  \"Columns\",\n  \"Component\",\n  \"Diff\",\n  \"Expandable\",\n  \"FileTree\",\n  \"Frame\",\n  \"GithubInfo\",\n  \"Icon\",\n  // Conditionally imported by the catch-all, but `detectUsesMath` matches any\n  // authored `<Math`, so it is always wired wherever it can appear.\n  \"Math\",\n  \"Operation\",\n  \"Panel\",\n  \"ParamField\",\n  \"Prompt\",\n  \"RequestExample\",\n  \"ResponseExample\",\n  \"ResponseField\",\n  \"Step\",\n  \"Steps\",\n  \"Tab\",\n  \"Tabs\",\n  \"Tile\",\n  \"Tooltip\",\n  \"Tree\",\n  \"TypeTable\",\n  \"View\",\n  \"Visibility\",\n  \"YouTube\",\n]);\n",
+    "import { relative } from \"pathe\";\n\nimport { BUILTIN_CHILD_PROPS, BUILTIN_MDX_TAGS } from \"./builtin-tags.ts\";\nimport type { Diagnostic, PageRecord } from \"./types.ts\";\n\n/** `CardGroup` → `card-group`, matching registry item names. */\nconst toKebab = (tag: string): string =>\n  tag\n    .replaceAll(/(?<lower>[a-z0-9])(?<upper>[A-Z])/gu, \"$<lower>-$<upper>\")\n    .toLowerCase();\n\nconst LIST = new Intl.ListFormat(\"en\", { type: \"conjunction\" });\n\n/**\n * Warn when an `.mdx` page uses a `<Component>` tag that resolves to nothing —\n * a built-in, an island, or a `components.ts` override — so a typo surfaces as a\n * friendly diagnostic (with a `blume add` hint where one exists) instead of a raw\n * MDX \"X is not defined\" build error. `extraTags` are the project's own known\n * components (islands + overrides); `registryNames` gates the install hint.\n * One warning per tag names every page that uses it, anchored to the first.\n */\nexport const validateUsedComponents = (\n  pages: PageRecord[],\n  extraTags: Set<string>,\n  registryNames: Set<string>\n): Diagnostic[] => {\n  const users = new Map<string, PageRecord[]>();\n  for (const page of pages) {\n    for (const tag of page.componentsUsed ?? []) {\n      if (!(BUILTIN_MDX_TAGS.has(tag) || extraTags.has(tag))) {\n        users.set(tag, [...(users.get(tag) ?? []), page]);\n      }\n    }\n  }\n  return [...users].map(([tag, using]) => {\n    const name = toKebab(tag);\n    const suggestion = registryNames.has(name)\n      ? `Run \\`blume add ${name}\\` to install it, or register <${tag}> in components.ts (mdx).`\n      : `Register <${tag}> in components.ts (mdx), or add an islands/${tag}.tsx component.`;\n    const routes = using.map((page) => page.route);\n    const [first] = using;\n    return {\n      code: \"BLUME_UNKNOWN_COMPONENT\",\n      file: first?.sourcePath ?? first?.id,\n      message:\n        routes.length === 1\n          ? `<${tag}> is used in ${LIST.format(routes)} but isn't a known component.`\n          : `<${tag}> is used on ${routes.length} pages but isn't a known component: ${LIST.format(routes)}.`,\n      severity: \"warning\",\n      suggestion,\n    };\n  });\n};\n\nconst EITHER = new Intl.ListFormat(\"en\", { type: \"disjunction\" });\nconst quoted = (names: readonly string[]): string[] =>\n  names.map((name) => `\\`${name}\\``);\n\n/**\n * Warn about each childless built-in in an `.mdx` page given props it doesn't\n * take (`<Badge type=\"tip\" text=\"beta\" />`, VitePress's Badge). Blume's\n * components ignore unknown props, so the element renders without the\n * content those props carried. `extraTags` are the project's own components\n * (islands + overrides): one that replaces a built-in takes its own props,\n * so its uses aren't checked. A file shared by several locales is reported\n * once.\n */\nexport const unknownPropDiagnostics = (\n  pages: readonly PageRecord[],\n  extraTags: ReadonlySet<string>\n): Diagnostic[] => {\n  const diagnostics: Diagnostic[] = [];\n  const seen = new Set<string>();\n  for (const page of pages) {\n    for (const use of page.unknownProps ?? []) {\n      const file = use.file ?? page.sourcePath ?? page.id;\n      const key = `${file}:${use.line}:${use.column}`;\n      if (extraTags.has(use.tag) || seen.has(key)) {\n        continue;\n      }\n      seen.add(key);\n      const accepted = BUILTIN_CHILD_PROPS.get(use.tag) ?? [];\n      const takes =\n        accepted.length > 0\n          ? `, and use the props ${use.tag} takes: ${LIST.format(quoted(accepted))}`\n          : `; ${use.tag} takes no props`;\n      diagnostics.push({\n        code: \"BLUME_UNKNOWN_PROP\",\n        column: use.column,\n        file,\n        line: use.line,\n        message: `<${use.tag}> in ${page.route} has no children, and ${use.tag} doesn't take ${EITHER.format(quoted(use.props))}, so it renders without what ${use.props.length === 1 ? \"that prop\" : \"those props\"} meant to show.`,\n        severity: \"warning\",\n        suggestion: `Put the content between the tags (<${use.tag}>…</${use.tag}>)${takes}.`,\n      });\n    }\n  }\n  return diagnostics;\n};\n\n/** What example discovery found: where it looked, and each example's key. */\nexport interface ExampleKeys {\n  /** Absolute directory the examples were discovered under. */\n  dir: string;\n  examples: readonly { path: string }[];\n}\n\n/**\n * Warn about each `<Component path>` in an `.mdx` page that names no\n * discovered example. The page still renders, with a \"No example found\" box\n * where the preview should be, so without this a typo or a moved example\n * ships silently. Reported at the `path` value, in the partial that holds it\n * when an `<include>` brought it in; a file shared by several locales is\n * reported once. `extraTags` are the project's own components (islands +\n * overrides), as for {@link validateUsedComponents}: one named `Component`\n * replaces the built-in and resolves `path` its own way, so none is checked.\n */\nexport const missingExampleDiagnostics = (\n  pages: readonly PageRecord[],\n  discovery: ExampleKeys,\n  root: string,\n  extraTags: ReadonlySet<string>\n): Diagnostic[] => {\n  if (extraTags.has(\"Component\")) {\n    return [];\n  }\n  const known = new Set(discovery.examples.map((example) => example.path));\n  const dir = relative(root, discovery.dir) || \".\";\n  const diagnostics: Diagnostic[] = [];\n  const seen = new Set<string>();\n  for (const page of pages) {\n    for (const use of page.examplesUsed ?? []) {\n      const file = use.file ?? page.sourcePath ?? page.id;\n      const key = `${file}:${use.line}:${use.column}`;\n      if (!(known.has(use.path) || seen.has(key))) {\n        seen.add(key);\n        diagnostics.push({\n          code: \"BLUME_EXAMPLE_NOT_FOUND\",\n          column: use.column,\n          file,\n          line: use.line,\n          message: `<Component path=\"${use.path}\"> in ${page.route} names no example, so the page shows \"No example found\" in its place.`,\n          severity: \"warning\",\n          suggestion: `Fix the path, or add the example under ${dir}/: \\`path\\` is its location there, without the extension.`,\n        });\n      }\n    }\n  }\n  return diagnostics;\n};\n",
     "import { readFile } from \"node:fs/promises\";\n\nimport pMap from \"p-map\";\nimport { basename, join } from \"pathe\";\nimport { glob } from \"tinyglobby\";\n\n/** Astro hydration directives Blume applies to a convention island. */\nexport type IslandClientMode = \"idle\" | \"load\" | \"only\" | \"visible\";\n\n/** Client framework an island is authored in, inferred from its extension. */\nexport type IslandFramework = \"react\" | \"svelte\" | \"vue\";\n\n/** A discovered `islands/` component, ready to wrap and expose to MDX. */\nexport interface IslandSpec {\n  /** Hydration directive, from `export const client` or the default. */\n  client: IslandClientMode;\n  /** Absolute path to the island source file. */\n  file: string;\n  /** Astro client framework, used to enable the renderer and for `client:only`. */\n  framework: IslandFramework;\n  /** Component name used in MDX — the file's basename without extension. */\n  name: string;\n}\n\nexport interface IslandDiscovery {\n  islands: IslandSpec[];\n  warnings: string[];\n}\n\n/** Hydration mode used when an island doesn't declare one. */\nconst DEFAULT_CLIENT: IslandClientMode = \"visible\";\n\n/** Ceiling on concurrent island-file reads; unbounded fan-out risks EMFILE. */\nconst READ_CONCURRENCY = 16;\n\nconst VALID_MODES = new Set<IslandClientMode>([\n  \"idle\",\n  \"load\",\n  \"only\",\n  \"visible\",\n]);\n\n/** Whether a declared client mode is one Astro's directives support. */\nconst isClientMode = (mode: string): mode is IslandClientMode =>\n  // SAFETY: `Set.has` only compares identity at runtime; the assertion widens\n  // the lookup key so the narrower-typed set accepts it, and the `has` result\n  // is exactly the predicate being claimed.\n  VALID_MODES.has(mode as IslandClientMode);\n\n/** Island extensions mapped to the Astro renderer that handles them. */\nconst FRAMEWORK_BY_EXT = new Map<string, IslandFramework>([\n  [\"jsx\", \"react\"],\n  [\"svelte\", \"svelte\"],\n  [\"tsx\", \"react\"],\n  [\"vue\", \"vue\"],\n]);\n\n// Captures the extension so we can both strip it from the name and pick the\n// framework. Kept in sync with the glob below.\nconst ISLAND_FILE = /\\.(?<ext>jsx|svelte|tsx|vue)$/u;\n\n// Matches `export const client = \"load\"` (with optional type annotation and\n// either quote style). Read statically so we never execute island code in Node.\nconst CLIENT_EXPORT =\n  /export\\s+const\\s+client\\s*(?::[^=]+)?=\\s*[\"'](?<mode>\\w+)[\"']/u;\n\nexport const readClientMode = (\n  source: string,\n  file: string,\n  warnings: string[]\n): IslandClientMode => {\n  const mode = source.match(CLIENT_EXPORT)?.groups?.mode;\n  if (!mode) {\n    return DEFAULT_CLIENT;\n  }\n  if (!isClientMode(mode)) {\n    warnings.push(\n      `Island \"${file}\" declares an unknown client mode \"${mode}\"; defaulting to \"${DEFAULT_CLIENT}\". Use \"load\", \"idle\", \"visible\", or \"only\".`\n    );\n    return DEFAULT_CLIENT;\n  }\n  return mode;\n};\n\n/**\n * Discover convention islands under `<root>/islands`. Every `.tsx`/`.jsx`/\n * `.vue`/`.svelte` file becomes a globally-available, hydrated MDX component\n * named after the file (which must be PascalCase to be usable as a JSX tag).\n * Hydration defaults to `client:visible`; a file opts out with `export const\n * client = \"load\" | \"idle\" | \"only\"`. Discovery is path-based (a glob), so no\n * user code is executed.\n */\nexport const discoverIslands = async (\n  root: string\n): Promise<IslandDiscovery> => {\n  const dir = join(root, \"islands\");\n  // Enumerate everything and let ISLAND_FILE do the filtering below, so\n  // unknown extensions take the skip guard instead of relying on a glob\n  // pattern staying in sync with the regex and framework map.\n  const matches = await glob([\"**/*\"], {\n    absolute: true,\n    cwd: dir,\n    onlyFiles: true,\n  });\n  const files = matches.toSorted();\n  const sources = await pMap(files, (file) => readFile(file, \"utf-8\"), {\n    concurrency: READ_CONCURRENCY,\n  });\n\n  const islands: IslandSpec[] = [];\n  const warnings: string[] = [];\n  const seen = new Map<string, string>();\n\n  // Extracted so the skip paths become early `return`s (one `continue` budget\n  // per loop under the lint rule) instead of `continue` statements.\n  const collectIsland = (file: string, source: string): void => {\n    const base = basename(file);\n    const ext = base.match(ISLAND_FILE)?.groups?.ext;\n    const framework = ext ? FRAMEWORK_BY_EXT.get(ext) : undefined;\n    if (!framework) {\n      return;\n    }\n    const name = base.replace(ISLAND_FILE, \"\");\n    // The name is used verbatim as both an MDX tag and an unquoted object key\n    // in the generated island map, so it must be a plain PascalCase identifier\n    // — a `-`, `.`, or space (e.g. `Time-Picker.tsx`) would otherwise emit a\n    // syntax-error module and fail the whole build with no pointer to the file.\n    if (!/^[A-Z][A-Za-z0-9_]*$/u.test(name)) {\n      warnings.push(\n        `Island \"${file}\" must have a PascalCase identifier filename to be used in MDX (letters, digits, and underscores only, e.g. Counter.tsx → <Counter />); skipping it.`\n      );\n      return;\n    }\n    const existing = seen.get(name);\n    if (existing) {\n      warnings.push(\n        `Two islands both resolve to <${name}> (\"${existing}\" and \"${file}\"); ignoring the second. Give them distinct filenames.`\n      );\n      return;\n    }\n    seen.set(name, file);\n    islands.push({\n      client: readClientMode(source, file, warnings),\n      file,\n      framework,\n      name,\n    });\n  };\n\n  for (const [index, file] of files.entries()) {\n    collectIsland(file, sources[index] ?? \"\");\n  }\n\n  return { islands, warnings };\n};\n",
     "import { readFile } from \"node:fs/promises\";\n\nimport pMap from \"p-map\";\nimport { isAbsolute, join, relative } from \"pathe\";\nimport { glob } from \"tinyglobby\";\n\nimport type { ExampleLookup } from \"../core/types.ts\";\nimport type { IslandClientMode } from \"./islands.ts\";\nimport { readClientMode } from \"./islands.ts\";\n\n/** Framework an example is authored in, inferred from its extension. */\nexport type ExampleFramework = \"astro\" | \"react\" | \"svelte\" | \"vue\";\n\n/** A discovered `examples/` file, ready to wrap (live) and show (source). */\nexport interface ExampleSpec {\n  /** Hydration directive for a framework example; `undefined` for `.astro`. */\n  client?: IslandClientMode;\n  /** Absolute path to the example source file. */\n  file: string;\n  /** Framework, or `astro` for a server-rendered (static) example. */\n  framework: ExampleFramework;\n  /** Shiki language for the source pane — the file extension. */\n  lang: string;\n  /** MDX-facing key: the path under `examples/`, sans extension, `/`-joined. */\n  path: string;\n  /** Raw source text shown in the code tab. */\n  source: string;\n}\n\nexport interface ExampleDiscovery {\n  /**\n   * Absolute directory the examples were discovered under: the configured\n   * `examples.source` (or a glob's static prefix) resolved against the root.\n   */\n  dir: string;\n  examples: ExampleSpec[];\n  warnings: string[];\n}\n\n/** Example extensions mapped to the framework that renders them. */\ninterface FrameworkByExtension {\n  [extension: string]: ExampleFramework;\n}\n\nconst FRAMEWORK_BY_EXT: FrameworkByExtension = {\n  astro: \"astro\",\n  jsx: \"react\",\n  svelte: \"svelte\",\n  tsx: \"react\",\n  vue: \"vue\",\n};\n\n// Captures the extension so we can strip it from the path key and pick the\n// framework. Kept in sync with the glob below — non-matching files a user glob\n// happens to sweep in (e.g. a registry's `.ts` sources) are dropped here.\nconst EXAMPLE_FILE = /\\.(?<ext>astro|jsx|svelte|tsx|vue)$/u;\n\n// Renderable example files when `examples` names a plain directory.\nconst DEFAULT_EXAMPLE_GLOB = \"**/*.{astro,jsx,svelte,tsx,vue}\";\n\n/** Ceiling on concurrent example-file reads; unbounded fan-out risks EMFILE. */\nconst READ_CONCURRENCY = 16;\n\n/**\n * Files the preview-frame Tailwind entry scans for utility classes, appended\n * to each directory from `exampleScanRoots`.\n */\nexport const EXAMPLE_SCAN_GLOB = \"**/*.{astro,jsx,svelte,ts,tsx,vue}\";\n\n/**\n * Directories the `<Component />` preview sheet scans for utility classes:\n * the project root, plus the examples directory when it lives outside the\n * root (a sibling workspace package, say). Tailwind's `@source` is a file\n * glob, not an import graph, so an out-of-root examples directory would\n * otherwise contribute no utilities and previews would render half-styled.\n */\nexport const exampleScanRoots = (\n  root: string,\n  examplesDir: string\n): string[] => {\n  const path = relative(root, examplesDir);\n  const outside = path.startsWith(\"..\") || isAbsolute(path);\n  return outside ? [root, examplesDir] : [root];\n};\n\n// Glob magic that turns `examples` from a plain directory into a pattern. `()`,\n// `@`, and `+` are excluded so literal path segments (npm scopes, parens) keep\n// resolving as directories; the extglob leads `*?!` still trigger here.\nconst GLOB_MAGIC = /[!*?[\\]{}]/u;\n\n/**\n * Split a glob into its static directory prefix and the remaining pattern, so\n * discovered files can be keyed relative to that prefix (e.g.\n * `registry/x/**\\/examples/*` → `{ base: \"registry/x\", rest: \"**\\/examples/*\" }`).\n */\nconst splitGlobBase = (pattern: string) => {\n  const segments = pattern.split(\"/\");\n  // Only called when the pattern contains glob magic (see the caller), and `/`\n  // is never magic, so the magic char always lands in a segment — `findIndex`\n  // is never -1 here.\n  const firstMagic = segments.findIndex((segment) => GLOB_MAGIC.test(segment));\n  return {\n    base: segments.slice(0, firstMagic).join(\"/\"),\n    rest: segments.slice(firstMagic).join(\"/\"),\n  };\n};\n\n/**\n * Discover preview examples for the `examples` config (default `examples`).\n * Every `.astro`/`.tsx`/`.jsx`/`.vue`/`.svelte` file becomes addressable by\n * `<Component path=\"...\">`, where the path is the file's location without its\n * extension (e.g. `forms/login.tsx` → `forms/login`).\n *\n * `pattern` is a directory by default, but may be a glob (anything with\n * `*`/`?`/`[]`/`{}`/`!`) — then only matching files are discovered and each\n * `<Component path>` key is relative to the glob's static prefix. This lets a\n * registry layout that colocates component sources with their examples be\n * targeted directly (e.g. `registry/<pkg>/**\\/examples/*`) without the sources —\n * which have no default export and so can't be wrapped — being swept in.\n *\n * Discovery is path-based (a glob), so no example code is executed. Framework\n * examples carry a hydration mode (default `client:visible`, overridable via\n * `export const client`); `.astro` examples render statically with no client\n * directive.\n */\nexport const discoverExamples = async (\n  root: string,\n  pattern = \"examples\"\n): Promise<ExampleDiscovery> => {\n  const { base, rest } = GLOB_MAGIC.test(pattern)\n    ? splitGlobBase(pattern)\n    : { base: pattern, rest: DEFAULT_EXAMPLE_GLOB };\n  const dir = join(root, base);\n  const matches = await glob([rest], {\n    absolute: true,\n    cwd: dir,\n    onlyFiles: true,\n  });\n  const files = matches.toSorted();\n  const sources = await pMap(files, (file) => readFile(file, \"utf-8\"), {\n    concurrency: READ_CONCURRENCY,\n  });\n\n  const examples: ExampleSpec[] = [];\n  const warnings: string[] = [];\n  const seen = new Map<string, string>();\n\n  // Extracted so the two skip paths become early `return`s (one `continue`\n  // budget per loop under the lint rule) instead of `continue` statements.\n  const collectExample = (file: string, source: string): void => {\n    const ext = file.match(EXAMPLE_FILE)?.groups?.ext;\n    const framework = ext ? FRAMEWORK_BY_EXT[ext] : undefined;\n    if (!(ext && framework)) {\n      return;\n    }\n    // Strip the trailing `.<ext>` to form the `<Component path>` key.\n    const path = relative(dir, file).slice(0, -(ext.length + 1));\n    const existing = seen.get(path);\n    if (existing) {\n      warnings.push(\n        `Two examples both resolve to \"${path}\" (\"${existing}\" and \"${file}\"); ignoring the second. Give them distinct paths.`\n      );\n      return;\n    }\n    seen.set(path, file);\n    examples.push({\n      client:\n        framework === \"astro\"\n          ? undefined\n          : readClientMode(source, file, warnings),\n      file,\n      framework,\n      lang: ext,\n      path,\n      source,\n    });\n  };\n\n  for (const [index, file] of files.entries()) {\n    collectExample(file, sources[index] ?? \"\");\n  }\n\n  return { dir, examples, warnings };\n};\n\n/**\n * Reduce discovered examples to the `<Component path>` → source lookup the\n * agent-facing Markdown downleveler needs (see {@link BlumeProject.examples}).\n */\nexport const exampleMarkdownLookup = (examples: ExampleSpec[]): ExampleLookup =>\n  Object.fromEntries(\n    examples.map((example) => [\n      example.path,\n      { lang: example.lang, source: example.source },\n    ])\n  );\n",
     "import { createRequire } from \"node:module\";\nimport { pathToFileURL } from \"node:url\";\n\nimport { join } from \"pathe\";\n\nimport {\n  commandsFor,\n  detectProjectPackageManager,\n} from \"../cli/init/scaffold.ts\";\nimport { packageRoot } from \"../core/package-root.ts\";\nimport type { ResolvedConfig } from \"../core/schema.ts\";\nimport type { Diagnostic } from \"../core/types.ts\";\n\n/** Whether a module specifier resolves from a directory via node resolution. */\nexport const canResolveFrom = (fromDir: string, spec: string): boolean => {\n  try {\n    createRequire(pathToFileURL(join(fromDir, \"_.js\")).href).resolve(spec);\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/** A package a configured feature imports that the project can't resolve. */\nexport interface MissingDependency {\n  /** The package whose absence was detected. */\n  dep: string;\n  /** Every package to install for the feature (a framework and its integration). */\n  install: string[];\n  /** What needs it, as the message names it: `Search adapter \"algolia\"`. */\n  owner: string;\n}\n\n/**\n * The declared `deps` of one feature that resolve neither from the project\n * root nor from the Blume package itself. A dep is available when the project\n * installed it OR Blume ships it (the same set the `.blume` deps link exposes\n * to the build). Resolving from the project root alone falsely flagged a\n * shipped SDK like Orama (the default provider) as missing whenever it wasn't\n * hoisted into the project, e.g. under isolated linkers. Each package is\n * resolved from its real location rather than through the `.blume` junction,\n * which can't be traversed reliably for store-symlinked deps.\n */\nconst unresolved = (\n  owner: string,\n  deps: readonly string[],\n  root: string,\n  pkgDir: string\n): MissingDependency[] =>\n  deps\n    .filter(\n      (dep) => !(canResolveFrom(root, dep) || canResolveFrom(pkgDir, dep))\n    )\n    .map((dep) => ({ dep, install: [dep], owner }));\n\n/**\n * The search adapter's SDK, when missing. Provider SDKs are optional peers,\n * so a hosted adapter's client import fails in Vite without one.\n */\nexport const searchProviderDependencies = (\n  provider: ResolvedConfig[\"search\"][\"provider\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  unresolved(\n    `Search adapter \"${provider.kind}\"`,\n    provider.runtimeDeps,\n    root,\n    pkgDir\n  );\n\n/** Content source SDKs (`@notionhq/client`, `@sanity/client`), when missing. */\nexport const sourceAdapterDependencies = (\n  sources: ResolvedConfig[\"content\"][\"sources\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  sources.flatMap((source) =>\n    unresolved(\n      `Content source \"${source.kind}\"`,\n      source.runtimeDeps,\n      root,\n      pkgDir\n    )\n  );\n\n/**\n * The assistant adapter's provider SDK, when missing — only `gateway` needs\n * nothing beyond the core `ai` package Blume ships. An external `endpoint`\n * means no generated route, so no SDK is imported.\n */\nexport const assistantProviderDependencies = (\n  ask: ResolvedConfig[\"ai\"][\"assistant\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  ask?.enabled && !ask.endpoint\n    ? unresolved(\n        `Assistant provider \"${ask.provider.kind}\"`,\n        ask.provider.runtimeDeps,\n        root,\n        pkgDir\n      )\n    : [];\n\n/**\n * The narration provider's SDK, when missing: `openai()` speaks through\n * `@ai-sdk/openai`, which the build loads to generate the clips, while\n * `gateway()` needs nothing beyond the core `ai` package Blume ships.\n */\nexport const narrationProviderDependencies = (\n  narration: ResolvedConfig[\"narration\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  narration.enabled && narration.provider\n    ? unresolved(\n        `Narration provider \"${narration.provider.kind}\"`,\n        narration.provider.runtimeDeps,\n        root,\n        pkgDir\n      )\n    : [];\n\n/**\n * The deployment adapter's package, when missing. Node and Vercel ship with\n * Blume, so theirs always resolve; Netlify and Cloudflare are optional peers.\n * The generated astro.config.mjs imports the package directly, so without it\n * the build dies with an opaque ERR_MODULE_NOT_FOUND from the hidden config.\n */\nexport const deploymentAdapterDependencies = (\n  deployment: ResolvedConfig[\"deployment\"],\n  root: string,\n  pkgDir: string = packageRoot()\n): MissingDependency[] =>\n  unresolved(\n    `Deployment adapter \"${deployment.kind}\"`,\n    deployment.runtimeDeps,\n    root,\n    pkgDir\n  );\n\n/** Astro integration package each non-React island framework needs installed. */\nconst ISLAND_FRAMEWORK_DEPS = new Map([\n  [\"svelte\", \"@astrojs/svelte\"],\n  [\"vue\", \"@astrojs/vue\"],\n]);\n\n/**\n * A Vue/Svelte island's Astro integration, when missing — the generated config\n * imports it. React ships with Blume, so it never needs this. The framework\n * itself is installed alongside its integration.\n */\nexport const islandFrameworkDependencies = (\n  frameworks: Iterable<string>,\n  root: string\n): MissingDependency[] =>\n  [...frameworks].flatMap((framework) => {\n    const dep = ISLAND_FRAMEWORK_DEPS.get(framework);\n    return dep && !canResolveFrom(root, dep)\n      ? [\n          {\n            dep,\n            install: [dep, framework],\n            owner: `Island framework \"${framework}\"`,\n          },\n        ]\n      : [];\n  });\n\n/**\n * Every package the resolved config's adapters (and the given island\n * frameworks) import that isn't installed: the search SDK, content source\n * SDKs, the assistant and narration provider SDKs, the deployment adapter,\n * and island integrations. The adapters' `runtimeDeps` are the one place that\n * knows.\n */\nexport const missingRuntimeDependencies = (\n  config: ResolvedConfig,\n  root: string,\n  frameworks: Iterable<string> = [],\n  pkgDir: string = packageRoot()\n): MissingDependency[] => [\n  ...searchProviderDependencies(config.search.provider, root, pkgDir),\n  ...sourceAdapterDependencies(config.content.sources, root, pkgDir),\n  ...assistantProviderDependencies(config.ai.assistant, root, pkgDir),\n  ...narrationProviderDependencies(config.narration, root, pkgDir),\n  ...deploymentAdapterDependencies(config.deployment, root, pkgDir),\n  ...islandFrameworkDependencies(frameworks, root),\n];\n\n/**\n * One diagnostic for every package the config imports that isn't installed,\n * with the command that installs them all through the project's package\n * manager (`npm install`, `pnpm add`, …), or undefined when nothing is\n * missing. `blume build` raises it as an error and `blume dev` as a warning;\n * `blume doctor` reports it before a build ever runs.\n */\nexport const missingDependencyDiagnostic = async (\n  config: ResolvedConfig,\n  root: string,\n  severity: Diagnostic[\"severity\"],\n  frameworks: Iterable<string> = [],\n  pkgDir: string = packageRoot()\n): Promise<Diagnostic | undefined> => {\n  const missing = missingRuntimeDependencies(config, root, frameworks, pkgDir);\n  if (missing.length === 0) {\n    return undefined;\n  }\n  const { add } = commandsFor(await detectProjectPackageManager(root));\n  const needs = missing.map(({ dep, owner }) => `${owner} needs \"${dep}\"`);\n  const packages = [...new Set(missing.flatMap(({ install }) => install))];\n  return {\n    code: \"BLUME_DEPENDENCY_MISSING\",\n    message:\n      missing.length === 1\n        ? `${needs[0]}, which isn't installed.`\n        : `These packages aren't installed: ${needs.join(\"; \")}.`,\n    severity,\n    suggestion: `Install ${packages.length === 1 ? \"it\" : \"them\"}: \\`${add} ${packages.join(\" \")}\\`.`,\n  };\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "88F80DB4180F01D164756E2164756E21",
+  "mappings": "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",
+  "debugId": "01581CA3D72AB06264756E2164756E21",
   "names": []
 }

package/dist/cli/{chunk-bxwhtvw8.js → chunk-ahc5gc9h.js}

@@ -9,7 +9,7 @@ import {
 } from "./index.js";
 import {
   AGENTS
-} from "./chunk-dv2z0rzf.js";
+} from "./chunk-8b489v1b.js";
 import {
   i18nEnabled,
   localeCodes,
@@ -18,7 +18,7 @@ import {
   folderMetaSchema,
   scanBody,
   createModuleLoader
-} from "./chunk-124fvmzq.js";
+} from "./chunk-dm4mg9bj.js";
 import {
   seconds,
   money,
@@ -34,11 +34,11 @@ import {
 import {
   findFolderMetaFiles,
   scanProject
-} from "./chunk-0pmb4tr4.js";
+} from "./chunk-8f8xw4x2.js";
 import"./chunk-zccbjcj0.js";
 import {
   parseTimeoutSeconds
-} from "./chunk-74wfhv79.js";
+} from "./chunk-05f21r8h.js";
 
 // src/cli/commands/translate.ts
 import { defineCommand } from "citty";
@@ -1212,4 +1212,4 @@ export {
 };
 
 //# debugId=7CBDF68DDB18B6AB64756E2164756E21
-//# sourceMappingURL=chunk-bxwhtvw8.js.map
+//# sourceMappingURL=chunk-ahc5gc9h.js.map

package/dist/cli/{chunk-dpy8qdjf.js → chunk-as09pafp.js}

@@ -3,6 +3,7 @@ import {
   buildHomeLinkHeader,
   resolveDocsCollection,
   TOC_HIDDEN_KEY,
+  TOC_TEXT_KEY,
   deployPassthrough,
   RATE_LIMIT_BINDING,
   fontLocaleCodes,
@@ -12,15 +13,19 @@ import {
   hasVariables,
   SVG_ASSET_HEADERS,
   applyBaseToAstroRedirects,
+  isPageIndexFile,
   withMirrorRedirects,
   distDir,
   adapterRoot,
   deployPlatform
-} from "./chunk-124fvmzq.js";
+} from "./chunk-dm4mg9bj.js";
 import {
   trimChar,
   normalizeBasePath
 } from "./chunk-zccbjcj0.js";
+import {
+  getBlumeVersion
+} from "./index.js";
 import {
   BLUME_IGNORE_DIRS
 } from "./chunk-kwrg63tm.js";
@@ -232,6 +237,10 @@ var CONSENT_CLIENT_MODULES = new Map([
 // src/markdown/api-rail.ts
 var API_RAIL_KEY = "blumeApiRail";
 
+// src/markdown/title-heading.ts
+var TITLE_ID_KEY = "blumeTitleId";
+var seen = new WeakSet;
+
 // src/markdown/views.ts
 var VIEWS_KEY = "blumeViews";
 
@@ -496,7 +505,8 @@ var astroConfigTemplate = (options) => {
   })},` : "";
   const redirectPages = new Set(contentRoutes);
   const basedRedirects = withMirrorRedirects(applyBaseToAstroRedirects(config.redirects, config.basePath, deployment.options.base ?? "", redirectPages), redirectPages, { from: "", to: normalizeBasePath(deployment.options.base) });
-  const exactRedirects = basedRedirects.filter((redirect) => !isPatternPath(redirect.from));
+  const staticOutput = deployment.options.output === "static";
+  const exactRedirects = basedRedirects.filter((redirect) => !(isPatternPath(redirect.from) || staticOutput && isPageIndexFile(redirect.from, redirectPages)));
   const redirectsOption = exactRedirects.length > 0 ? `
   redirects: ${JSON.stringify(Object.fromEntries(exactRedirects.map((redirect) => [
     redirect.from,
@@ -533,6 +543,7 @@ var astroConfigTemplate = (options) => {
   const blumeImports = [
     "blumeIntegration",
     "includeHmrPlugin",
+    "mdxSourceErrorsPlugin",
     "prerenderDepsPlugin",
     ...runtimeModuleImports,
     ...adapterOption.includes("withAdapterRoot") ? ["withAdapterRoot"] : [],
@@ -607,10 +618,10 @@ ${userConfigSetup}export default defineConfig({
   devToolbar: { enabled: false },
   // One canonical URL per page: canonicals, the sitemap, and hreflang all use
   // the slashless form, so the slashed spelling is not a second address. Astro
-  // applies this itself — its dev server answers a slashed URL with a 404 that
-  // names the setting, an on-demand route redirects — and the Vercel adapter
-  // turns it into the platform's 308 route, so the Build Output config needs
-  // no hand-spliced redirect (see deploy/vercel-negotiation.ts). Static hosts
+  // applies this itself — an on-demand route redirects, and the integration
+  // has the dev server redirect too, ahead of Astro's own 404 — and the Vercel
+  // adapter turns it into the platform's 308 route, so the Build Output config
+  // needs no hand-spliced redirect (see deploy/vercel-negotiation.ts). Static hosts
   // serve the \`index.html\` directory layout as they always did.
   trailingSlash: "never",
   // The layouts render Astro's <ClientRouter />, and its in-place swaps read
@@ -625,7 +636,7 @@ ${userConfigSetup}export default defineConfig({
   // the overlap only adds memory.
   build: { concurrency: Math.min(8, availableParallelism()) },
   vite: {${viteCacheOption}
-    plugins: [${runtimeModulesPluginEntry}${variablesPluginEntry}tailwindcss(), includeHmrPlugin(${configPath(`${context.outDir}/src/generated/includes.json`, ejected)}), prerenderDepsPlugin()],
+    plugins: [${runtimeModulesPluginEntry}${variablesPluginEntry}tailwindcss(), includeHmrPlugin(${configPath(`${context.outDir}/src/generated/includes.json`, ejected)}), mdxSourceErrorsPlugin(), prerenderDepsPlugin()],
     build: {${features.mermaid ? MERMAID_CHUNK_LIMIT : ""}
       rolldownOptions: {
         ${ROLLDOWN_ON_LOG},
@@ -704,6 +715,8 @@ var runtimeDirWithin = (base, outDir) => {
   return rel && !rel.startsWith("..") && !isAbsolute2(rel) ? rel : null;
 };
 var astroGlobBase = (base) => isAbsolute2(base) ? pathToFileURL(base).href : base;
+var GLOB_SYNTAX = /[!()*+?@[\\\]{|}]/gu;
+var escapeGlob = (path) => path.replaceAll(GLOB_SYNTAX, String.raw`\$&`);
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
   const stagedBase = options.stagedBase ?? stagedContentDir(context.outDir);
@@ -718,7 +731,11 @@ var contentConfigTemplate = (options) => {
     ...includeGlobs,
     ...(excludeGlobs ?? []).map((pattern) => `!${pattern}`),
     ...BLUME_IGNORE_DIRS.flatMap((dir) => dir === ".blume" ? [] : [`!**/${dir}/**`]),
-    ...outDirIgnore
+    ...outDirIgnore,
+    ...(options.unparsable ?? []).flatMap((file) => {
+      const rel = relative2(collectionBase, file);
+      return rel.startsWith("..") || isAbsolute2(rel) ? [] : [`!${escapeGlob(rel)}`];
+    })
   ] : [];
   const stagedBlock = options.staged ? `
 const staged = defineCollection({
@@ -743,6 +760,10 @@ import { pageCollectionSchema } from "blume/core/schema.ts";
 // pageCollectionSchema is the scan's page front-matter schema, so entry.data
 // is typed and normalized the same way; it passes custom keys through and
 // falls back to defaults for a page the scan already dropped as invalid.
+//
+// Astro's content store re-parses an entry only when its file or this config
+// changes, so naming the Blume version (${getBlumeVersion()}) here re-parses
+// every entry after an upgrade: none keeps what an older schema produced.
 const docs = defineCollection({
   loader: withIncludeRefresh(glob({
     pattern: ${JSON.stringify(docsPattern)},
@@ -1214,11 +1235,25 @@ const TYPES: Record<string, string> = {
   ".webp": "image/webp",
 };
 
+// The other files a page's links name beside it, typed so the dev server
+// opens them the way a static host would. Anything else downloads.
+const FILE_TYPES: Record<string, string> = {
+  ".csv": "text/csv; charset=utf-8",
+  ".json": "application/json",
+  ".mp3": "audio/mpeg",
+  ".pdf": "application/pdf",
+  ".txt": "text/plain; charset=utf-8",
+  ".wav": "audio/wav",
+  ".zip": "application/zip",
+};
+
 const extensionOf = (path: string): string =>
   path.slice(path.lastIndexOf(".")).toLowerCase();
 
 const contentType = (path: string): string =>
-  TYPES[extensionOf(path)] ?? "application/octet-stream";
+  TYPES[extensionOf(path)] ??
+  FILE_TYPES[extensionOf(path)] ??
+  "application/octet-stream";
 
 // A source downloads only images and videos; anything else in the staged
 // directory (a page an older build saved under its URL's extension) is never
@@ -1567,6 +1602,7 @@ import Badge from "blume/components/content/Badge.astro";
 import Callout from "blume/components/content/Callout.astro";
 import Card from "blume/components/content/Card.astro";
 import CardGroup from "blume/components/content/CardGroup.astro";
+import Changelog from "blume/components/content/Changelog.astro";
 import CodeBlock from "blume/components/content/CodeBlock.astro";
 import CodeGroup from "blume/components/content/CodeGroup.astro";
 import ColorRoot from "blume/components/content/Color.astro";
@@ -1620,6 +1656,7 @@ ${mathImport}import { mdxComponents as userMdx, layoutOverrides } from "../gener
   Callout,
   Card,
   CardGroup,
+  Changelog,
   CodeBlock,
   CodeGroup,
   Color,
@@ -1723,10 +1760,25 @@ const views = Array.isArray(viewsRaw)
   : [];
 const tocHiddenRaw = remarkPluginFrontmatter?.${TOC_HIDDEN_KEY};
 const tocHidden = new Set(Array.isArray(tocHiddenRaw) ? tocHiddenRaw : []);
-const headings =
+// A heading holding a \`<Badge>\` lists without the badge's text, which the
+// heading plugin reports by slug the same way.
+const tocTextRaw = remarkPluginFrontmatter?.${TOC_TEXT_KEY};
+const tocText = tocTextRaw && typeof tocTextRaw === "object" ? tocTextRaw : {};
+const headings = (
   tocHidden.size > 0
     ? allHeadings.filter((heading) => !tocHidden.has(heading.slug))
-    : allHeadings;
+    : allHeadings
+).map((heading) =>
+  typeof tocText[heading.slug] === "string"
+    ? { ...heading, text: tocText[heading.slug] }
+    : heading
+);
+// An untitled page's opening \`# Heading\` is its title, so the title-heading
+// plugin drops it from the body and reports its id here: the title \`<h1>\`
+// below takes it, so links to the heading's anchor still land (see
+// markdown/title-heading.ts).
+const titleIdRaw = remarkPluginFrontmatter?.${TITLE_ID_KEY};
+const titleId = typeof titleIdRaw === "string" ? titleIdRaw : undefined;
 const frontmatter = entry.data;
 
 const seo = frontmatter.seo;
@@ -2015,7 +2067,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   noindex={effectiveNoindex}
   structuredDataEnabled={data.config.structuredData}
 >
-  {pageChrome && <h1>{title}</h1>}
+  {pageChrome && <h1 id={titleId}>{title}</h1>}
   {pageChrome && frontmatter.description && <p class="text-lg text-muted-foreground">{frontmatter.description}</p>}
   {narration && (
     <NarrationPlayer
@@ -2036,32 +2088,17 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 var changelogIndexTemplate = (options) => {
   const clientData = options.needsReact ? `
   clientData={{ config: data.config, navigation: data.navigation, page: { route: "/changelog", title: pageTitle } }}` : "";
-  const stagedSpread = options.staged ? `
-  ...(await getCollection("staged")),` : "";
   return `---
 // Generated by Blume. Do not edit.
-import { getCollection } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
+import Changelog from "blume/components/content/Changelog.astro";
 import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
-import { resolveDateFormatOptions } from "blume/core/date-format.ts";
 import { layoutOverrides } from "../generated/components.ts";
 import data from "blume:data";
 
 export const prerender = true;
 
-const entryDate = (entry: {
-  data: { date?: string | null; changelog?: { date?: string | null } | null };
-}) => entry.data.date ?? entry.data.changelog?.date ?? null;
-
-const parseDate = (value: string | null | undefined) => {
-  if (!value) {
-    return null;
-  }
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? null : date;
-};
-
 // The changelog is an unlocalized route, so its chrome renders in the default
 // locale's dictionary and direction (\`data.ui\` is the default locale's resolved
 // dictionary), mirroring the catch-all's locale wiring.
@@ -2072,109 +2109,6 @@ const localeMeta = i18n
 const dir = localeMeta?.dir ?? "ltr";
 const htmlLang = i18n ? i18n.defaultLocale : "en";
 
-// Formatted in the same locale as the chrome, and with the configured
-// \`dateFormat\` (UTC by default), to match the per-page "last updated" stamp.
-// The year heads each group, so a row shows the rest of the date: a preset
-// style keeps its month wording, a component format simply drops the year.
-const dateFormatOptions = resolveDateFormatOptions(data.config.dateFormat);
-const { dateStyle, year: _year, ...dateComponents } = dateFormatOptions;
-const rowDateFormat: Intl.DateTimeFormatOptions = dateStyle
-  ? {
-      ...dateComponents,
-      day: "numeric",
-      month: dateStyle === "medium" ? "short" : "long",
-    }
-  : dateComponents;
-const formatRowDate = (date: Date) =>
-  new Intl.DateTimeFormat(htmlLang, rowDateFormat).format(date);
-const formatYear = (date: Date) =>
-  new Intl.DateTimeFormat(htmlLang, {
-    timeZone: dateFormatOptions.timeZone,
-    year: "numeric",
-  }).format(date);
-
-const slugify = (text: string) =>
-  text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") ||
-  "update";
-
-// Map each entry to its own generated page so the row can link to it. The
-// collection entry id matches the route manifest's \`entryId\` — and under
-// i18n every locale serves a page for it (its translations plus fallback
-// copies of an untranslated one), all sharing that id, so a map over every
-// route would keep whichever locale came last: a Portuguese permalink on an
-// unlocalized index. Only the default locale's routes are kept, and an entry
-// is listed only when it has one, so a translated changelog file (a distinct
-// entry that lives under its own locale) does not add a second row for the
-// same release.
-const defaultLocale = i18n ? i18n.defaultLocale : null;
-const routeByEntry = new Map<string, string>();
-for (const route of data.routes) {
-  if (defaultLocale === null || route.locale === defaultLocale) {
-    routeByEntry.set(route.entryId, route.path);
-  }
-}
-
-const changelogEntries = [
-  ...(await getCollection("docs")),${stagedSpread}
-]
-  .filter(
-    (entry) =>
-      entry.data.type === "changelog" &&
-      !entry.data.draft &&
-      !entry.data.sidebar?.hidden &&
-      (defaultLocale === null || routeByEntry.has(entry.id))
-  )
-  .toSorted(
-    (a, b) =>
-      (parseDate(entryDate(b))?.getTime() ?? 0) -
-      (parseDate(entryDate(a))?.getTime() ?? 0)
-  );
-
-const items = changelogEntries.map((entry) => {
-  const label =
-    entry.data.title ??
-    (entry.data.changelog?.version
-      ? "v" + entry.data.changelog.version
-      : "Update");
-  const date = parseDate(entryDate(entry));
-  const route = routeByEntry.get(entry.id);
-  return {
-    date: date ? formatRowDate(date) : null,
-    dateTime: date ? date.toISOString().slice(0, 10) : null,
-    href: route ? withMountedBase(route) : null,
-    id: slugify(label),
-    label,
-    tag: entry.data.changelog?.category ?? null,
-    year: date ? formatYear(date) : null,
-  };
-});
-
-// Repeated labels slug to the same id (e.g. two entries with neither a title
-// nor a version both falling back to "update"); suffix the later ones -2, -3,
-// ... so every row keeps its own hash anchor. The first keeps the plain slug.
-const seenIds = new Set();
-for (const item of items) {
-  let uniqueId = item.id;
-  for (let n = 2; seenIds.has(uniqueId); n += 1) {
-    uniqueId = item.id + "-" + n;
-  }
-  seenIds.add(uniqueId);
-  item.id = uniqueId;
-}
-
-// Consecutive releases from the same year share a group, so the list reads as
-// a year rail beside the rows; undated entries (sorted last) form a final
-// group with no year label.
-const groups: { items: typeof items; year: string | null }[] = [];
-for (const item of items) {
-  const last = groups[groups.length - 1];
-  if (last && last.year === item.year) {
-    last.items.push(item);
-  } else {
-    groups.push({ items: [item], year: item.year });
-  }
-}
-
 const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 // The canonical URL carries the deployment base (the page is served under it),
 // matching how the catch-all canonicalizes via \`withMountedBase(route)\`.
@@ -2187,15 +2121,16 @@ const canonical = base ? base + basedRoute : null;
 const ogPath = data.config.og.enabled ? withMountedBase("/og/changelog.png") : null;
 const ogImage = ogPath && base ? base + ogPath : ogPath;
 
-// The page chrome (h1, title, description, empty state) comes from the
-// translatable \`changelog\` group, which carries the \`changelog\` config's title and
+// The page chrome (h1, title, description) comes from the translatable
+// \`changelog\` group, which carries the \`changelog\` config's title and
 // description when it sets them; optional chaining tolerates a
-// not-yet-regenerated data snapshot from before these keys existed.
+// not-yet-regenerated data snapshot from before these keys existed. The list
+// itself is \`<Changelog />\`, the same component an authored page can place to
+// put prose above it.
 const changelogTitle = data.ui.changelog?.title ?? "Changelog";
 const changelogDescription =
   data.ui.changelog?.description ??
   "Product updates, new features, and fixes from every release.";
-const changelogEmpty = data.ui.changelog?.empty ?? "No changelog entries yet.";
 // The layout suffixes "- {site title}" itself, so the page title is just the
 // changelog's own name — prefixing the site title too would double it
 // ("Acme Changelog - Acme").
@@ -2246,51 +2181,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 >
   <h1>{changelogTitle}</h1>
   <p class="text-lg text-muted-foreground">{changelogDescription}</p>
-  {
-    items.length === 0 ? (
-      <p>{changelogEmpty}</p>
-    ) : (
-      <div class="not-prose mt-10 divide-y divide-border border-border border-y">
-        {groups.map((group) => (
-          <section
-            aria-label={group.year ?? undefined}
-            class="grid md:grid-cols-[6rem_minmax(0,1fr)] md:gap-x-8"
-          >
-            <h2 class="mt-0! pt-3! font-medium! text-muted-foreground text-sm! leading-5! tabular-nums max-md:pb-1">
-              {group.year}
-            </h2>
-            <ul class="m-0! list-none divide-y divide-border p-0!">
-              {group.items.map((item) => (
-                <li class="m-0! p-0!" id={item.id}>
-                  <a
-                    class="group/release flex items-baseline gap-4 py-3 no-underline! hover:no-underline!"
-                    href={item.href ?? "#" + item.id}
-                  >
-                    <span class="min-w-0 flex-1 font-medium text-foreground text-sm transition-colors group-hover/release:text-accent">
-                      {item.label}
-                    </span>
-                    {item.tag && (
-                      <span class="shrink-0 rounded-full bg-muted px-2 py-0.5 font-medium text-[0.65rem] text-muted-foreground">
-                        {item.tag}
-                      </span>
-                    )}
-                    {item.date && (
-                      <time
-                        class="shrink-0 font-mono text-muted-foreground text-xs tabular-nums"
-                        datetime={item.dateTime}
-                      >
-                        {item.date}
-                      </time>
-                    )}
-                  </a>
-                </li>
-              ))}
-            </ul>
-          </section>
-        ))}
-      </div>
-    )
-  }
+  <Changelog />
 </LayoutComponent>
 `;
 };
@@ -2801,5 +2692,5 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 
 export { deployOutputDir, deployStaticDir, surfaceAdapterOutput, planComponentSlots, publishRuntimeModules, runtimeDependencies, EJECTED_CONFIG_HEADER, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, consentClientTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
 
-//# debugId=FCEABB4236B6B32C64756E2164756E21
-//# sourceMappingURL=chunk-dpy8qdjf.js.map
+//# debugId=68D6AC80F8EF84D964756E2164756E21
+//# sourceMappingURL=chunk-as09pafp.js.map