blume 2.1.3 → 2.2.1

package/dist/cli/{chunk-twy7psdz.js → chunk-hn3g2b89.js}

@@ -4,11 +4,11 @@ import {
   discoverIslands,
   discoverExamples,
   missingDependencyDiagnostic
-} from "./chunk-ckrcm08h.js";
+} from "./chunk-rtvgmg2j.js";
 import {
   discoverPages,
   navTargetRoutes
-} from "./chunk-124fvmzq.js";
+} from "./chunk-r5nm9w0c.js";
 import {
   packageRoot,
   commandMeta,
@@ -23,20 +23,24 @@ import {
 import {
   ComponentOverridesError,
   analyzeComponentOverrides
-} from "./chunk-j1x92mx9.js";
+} from "./chunk-j4nfgn2j.js";
 import {
   validateNavTargets,
   scanProject
-} from "./chunk-0pmb4tr4.js";
+} from "./chunk-zxd5jrgx.js";
 import"./chunk-zccbjcj0.js";
 import"./chunk-jq5n4avg.js";
 import {
   unregisteredSnapshotDiagnostics
-} from "./chunk-5cmts6dv.js";
+} from "./chunk-kmswjxj9.js";
+import {
+  servedFiles
+} from "./chunk-487b95qy.js";
 import {
   serverFeatures,
   checkRequiredSecrets
-} from "./chunk-ms9z66nz.js";
+} from "./chunk-gwy55cx3.js";
+import"./chunk-q1wwrxzw.js";
 
 // src/cli/commands/doctor.ts
 import { readFileSync } from "node:fs";
@@ -44,7 +48,7 @@ import { readFile } from "node:fs/promises";
 import { defineCommand } from "citty";
 import { join } from "pathe";
 import { satisfies } from "semver";
-var FALLBACK_NODE_RANGE = ">=22.12.0";
+var FALLBACK_NODE_RANGE = ">=22.19.0";
 var componentsDiagnostics = async (componentsFile) => {
   if (!componentsFile) {
     return { issues: [], mdx: [] };
@@ -110,7 +114,7 @@ var doctorCommand = defineCommand({
         mode: "build"
       });
       const userPages = project.context.pagesRoot ? await discoverPages(project.context.pagesRoot) : [];
-      diagnostics.push(...project.diagnostics, ...unregisteredSnapshotDiagnostics(project), ...validateNavTargets(project.graph.navigation, navTargetRoutes(project, userPages)));
+      diagnostics.push(...project.diagnostics, ...unregisteredSnapshotDiagnostics(project), ...validateNavTargets(project.graph.navigation, navTargetRoutes(project, userPages), servedFiles(project)));
       const { config } = project;
       const { islands } = await discoverIslands(root);
       const dependencies = await missingDependencyDiagnostic(config, root, "error", islands.map((island) => island.framework));
@@ -166,5 +170,5 @@ export {
   doctorCommand
 };
 
-//# debugId=A6107CD821E0AA4B64756E2164756E21
-//# sourceMappingURL=chunk-twy7psdz.js.map
+//# debugId=A4A339755430C21A64756E2164756E21
+//# sourceMappingURL=chunk-hn3g2b89.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli/commands/doctor.ts"],
+  "sourcesContent": [
+    "import { readFileSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\n\nimport { defineCommand } from \"citty\";\nimport { join } from \"pathe\";\nimport { satisfies } from \"semver\";\n\nimport { discoverExamples } from \"../../astro/examples.ts\";\nimport { discoverIslands } from \"../../astro/islands.ts\";\nimport { discoverPages, navTargetRoutes } from \"../../astro/pages.ts\";\nimport { missingDependencyDiagnostic } from \"../../astro/runtime-deps.ts\";\nimport { missingExampleDiagnostics } from \"../../core/component-diagnostics.ts\";\nimport {\n  analyzeComponentOverrides,\n  ComponentOverridesError,\n} from \"../../core/component-overrides.ts\";\nimport { BlumeError } from \"../../core/diagnostics.ts\";\nimport { validateNavTargets } from \"../../core/nav-diagnostics.ts\";\nimport { packageRoot } from \"../../core/package-root.ts\";\nimport { scanProject } from \"../../core/project-graph.ts\";\nimport type { ResolvedConfig } from \"../../core/schema.ts\";\nimport { serverFeatures } from \"../../core/server-features.ts\";\nimport type { Diagnostic } from \"../../core/types.ts\";\nimport { unregisteredSnapshotDiagnostics } from \"../../core/version-cut.ts\";\nimport { servedFiles } from \"../../deploy/generated-files.ts\";\nimport { commandMeta } from \"../command-meta.ts\";\nimport { loadEnvFiles } from \"../env.ts\";\nimport { reportInternalError } from \"../internal-error.ts\";\nimport {\n  flushStdout,\n  logger,\n  reportDiagnostics,\n  reportDiagnosticsJson,\n} from \"../log.ts\";\nimport { checkRequiredSecrets } from \"../required-secrets.ts\";\n\nconst FALLBACK_NODE_RANGE = \">=22.19.0\";\n\n/**\n * Plan `components.ts` the way `blume dev`/`build` do, reporting each override\n * that can't be planned — a non-static form, or an import of a file that\n * doesn't exist — with its own line. The scan alone never reads the file, so\n * without this doctor would pass a project whose build fails. Also returns\n * the MDX tags the file overrides.\n */\nconst componentsDiagnostics = async (\n  componentsFile: string | null\n): Promise<{ issues: Diagnostic[]; mdx: string[] }> => {\n  if (!componentsFile) {\n    return { issues: [], mdx: [] };\n  }\n  try {\n    const { mdx } = analyzeComponentOverrides(\n      await readFile(componentsFile, \"utf-8\"),\n      componentsFile\n    );\n    return { issues: [], mdx: mdx.map((entry) => entry.key) };\n  } catch (error) {\n    if (error instanceof ComponentOverridesError) {\n      return { issues: error.issues, mdx: [] };\n    }\n    throw error;\n  }\n};\n\n/** The supported Node range, read from the package's own `engines` field so\n * doctor can never drift from what the package actually declares. */\nconst supportedNodeRange = (): string => {\n  try {\n    // SAFETY: this parses blume's own package.json; the optional fields cover\n    // an `engines` block going missing, and a bad read falls to the catch.\n    const pkg = JSON.parse(\n      readFileSync(join(packageRoot(), \"package.json\"), \"utf-8\")\n    ) as { engines?: { node?: string } };\n    return pkg.engines?.node || FALLBACK_NODE_RANGE;\n  } catch {\n    return FALLBACK_NODE_RANGE;\n  }\n};\n\n/** The adapters a project runs, one line per kind, for the doctor summary. */\nconst integrationSummary = (config: ResolvedConfig): string[] => {\n  const { assistant } = config.ai;\n  let assistantSummary = \"off\";\n  if (assistant?.enabled) {\n    assistantSummary = assistant.endpoint\n      ? \"external endpoint\"\n      : assistant.provider.kind;\n  }\n  return [\n    `References: ${config.reference.map((adapter) => adapter.kind).join(\", \") || \"none\"}`,\n    `Analytics: ${config.analytics.map((adapter) => adapter.kind).join(\", \") || \"none\"}`,\n    `Consent: ${config.consent?.kind ?? \"none\"}`,\n    `Rate limiting: ${config.rateLimit?.kind ?? \"off\"}`,\n    `Sources: ${config.content.sources.map((source) => source.kind).join(\", \")}`,\n    `Assistant: ${assistantSummary}`,\n  ];\n};\n\nexport const doctorCommand = defineCommand({\n  args: {\n    json: {\n      description: \"Emit diagnostics as JSON on stdout (for CI/editors).\",\n      type: \"boolean\",\n    },\n  },\n  meta: commandMeta.doctor,\n  async run({ args }) {\n    const root = process.cwd();\n    const diagnostics: Diagnostic[] = [];\n\n    const nodeRange = supportedNodeRange();\n    if (!satisfies(process.versions.node, nodeRange)) {\n      diagnostics.push({\n        code: \"BLUME_NODE_VERSION\",\n        message: `Node ${process.versions.node} is outside the supported range (${nodeRange}).`,\n        severity: \"warning\",\n      });\n    }\n\n    // Read `.env` files first, as `blume dev`/`build` do: remote sources read\n    // their tokens during the scan, and the secrets check below reads them too.\n    loadEnvFiles(root);\n\n    try {\n      const project = await scanProject(root, {\n        // A missing secret fails at the first request. Checked before the\n        // sources fetch, so it's still reported when one of them fails the\n        // scan for want of it.\n        beforeSources: (config) => {\n          diagnostics.push(...checkRequiredSecrets(config));\n        },\n        mode: \"build\",\n      });\n      // Tabs, selector items, and featured links can point at custom pages\n      // and generated routes too, so they're checked against every route\n      // the site serves, as `blume dev`/`build` check them.\n      const userPages = project.context.pagesRoot\n        ? await discoverPages(project.context.pagesRoot)\n        : [];\n      diagnostics.push(\n        ...project.diagnostics,\n        ...unregisteredSnapshotDiagnostics(project),\n        ...validateNavTargets(\n          project.graph.navigation,\n          navTargetRoutes(project, userPages),\n          servedFiles(project)\n        )\n      );\n\n      const { config } = project;\n      // The packages a build would need: an adapter's missing SDK fails the\n      // build.\n      const { islands } = await discoverIslands(root);\n      const dependencies = await missingDependencyDiagnostic(\n        config,\n        root,\n        \"error\",\n        islands.map((island) => island.framework)\n      );\n      if (dependencies) {\n        diagnostics.push(dependencies);\n      }\n      const overrides = await componentsDiagnostics(\n        project.context.componentsFile\n      );\n      diagnostics.push(\n        ...overrides.issues,\n        // A `<Component path>` naming no example renders a \"No example\n        // found\" box, which dev and build warn about too.\n        ...missingExampleDiagnostics(\n          project.graph.pages,\n          await discoverExamples(root, config.examples.source),\n          root,\n          new Set([...islands.map((island) => island.name), ...overrides.mdx])\n        )\n      );\n      const features = serverFeatures(config);\n      if (\n        features.length > 0 &&\n        config.deployment.options.output === \"static\"\n      ) {\n        // A host adapter already names the target, so only its\n        // `output: \"static\"` stands in the way; otherwise name one.\n        const { kind } = config.deployment;\n        diagnostics.push({\n          code: \"BLUME_SERVER_FEATURE_REQUIRED\",\n          message: `${features.join(\", \")} ${features.length === 1 ? \"requires\" : \"require\"} server output.`,\n          severity: \"error\",\n          suggestion:\n            kind === \"static\"\n              ? 'Set deployment to a host adapter from \"blume/deploy\" (e.g. `deployment: vercel()`).'\n              : `Drop \\`output: \"static\"\\` from \\`deployment: ${kind}()\\` to build for the server.`,\n        });\n      }\n\n      if (!args.json) {\n        logger.info(`Pages: ${project.graph.pages.length}`);\n        logger.info(`Output: ${config.deployment.options.output}`);\n        logger.info(`Adapter: ${config.deployment.kind}`);\n        logger.info(`Search: ${config.search.provider.kind}`);\n        for (const line of integrationSummary(config)) {\n          logger.info(line);\n        }\n      }\n    } catch (error) {\n      if (error instanceof BlumeError) {\n        diagnostics.push(error.diagnostic);\n      } else {\n        reportInternalError(error);\n        process.exit(1);\n      }\n    }\n\n    if (args.json) {\n      // Drain stdout before exiting non-zero: `process.exit` would otherwise\n      // truncate the JSON payload mid-write when stdout is a pipe — exactly how\n      // `--json` is consumed in CI/editors.\n      if (reportDiagnosticsJson(diagnostics, root)) {\n        await flushStdout();\n        process.exit(1);\n      }\n      return;\n    }\n\n    const hadErrors = reportDiagnostics(diagnostics, root);\n    if (diagnostics.length === 0) {\n      logger.success(\"No problems found.\");\n    }\n    if (hadErrors) {\n      // Set the code and return rather than `process.exit`, which doesn't wait\n      // for a piped stderr: a long diagnostic list would be cut off.\n      process.exitCode = 1;\n    }\n  },\n});\n"
+  ],
+  "mappings": "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",
+  "debugId": "A4A339755430C21A64756E2164756E21",
+  "names": []
+}

package/dist/cli/{chunk-j1x92mx9.js → chunk-j4nfgn2j.js}

@@ -390,4 +390,4 @@ var analyzeComponentOverrides = (source, filePath) => {
 export { emptyComponentOverrides, ComponentOverridesError, analyzeComponentOverrides };
 
 //# debugId=59653B23465A56F364756E2164756E21
-//# sourceMappingURL=chunk-j1x92mx9.js.map
+//# sourceMappingURL=chunk-j4nfgn2j.js.map

package/dist/cli/{chunk-dpy8qdjf.js → chunk-k45sq16q.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-r5nm9w0c.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)},
@@ -777,7 +798,7 @@ var rateLimitTemplate = (adapter, scope) => {
     'import { createLimiter, rateLimited } from "blume/ratelimit/runtime.ts";'
   ];
   let runtime = "";
-  if (adapter.kind === "upstash") {
+  if (adapter.requiredSecrets.length > 0) {
     imports.push('import { getSecret } from "astro:env/server";');
     runtime = ", { secret: getSecret }";
   } else if (adapter.kind === "cloudflare") {
@@ -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=89A234A45FD2077E64756E2164756E21
+//# sourceMappingURL=chunk-k45sq16q.js.map