blume 1.1.0 → 1.1.2

package/dist/cli/index.js

@@ -308,12 +308,14 @@ var DOCS_PATHS = {
   BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
   BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,
   BLUME_DUPLICATE_ROUTE: DOCS_CONTENT_NAVIGATION,
+  BLUME_DUPLICATE_SIDEBAR_ORDER: DOCS_CONTENT_NAVIGATION,
   BLUME_FRONTMATTER_INVALID: "/docs/reference/frontmatter",
   BLUME_META_INVALID: "/docs/content/meta",
   BLUME_META_LOAD_FAILED: "/docs/content/meta",
   BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,
   BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,
   BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_INDEX_TITLE_MISMATCH: DOCS_CONTENT_NAVIGATION,
   BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,
   BLUME_NODE_VERSION: "/docs/quickstart",
   BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,
@@ -2301,7 +2303,7 @@ var llmsChecks = {
         continue;
       }
       listed.add(path);
-      if (!context.byUrl.has(path)) {
+      if (!context.byUrl.has(path) && !context.files.has(path)) {
         found.push(finding("BLUME_AUDIT_LLMS_TXT_STALE_ENTRY", { file: llms.file, line: entry.line, url: entry.url }, `llms.txt lists ${path}, which the build does not serve.`));
       }
     }
@@ -3531,9 +3533,7 @@ var astroConfigTemplate = (options) => {
   ];
   const blumeImport = `import { ${blumeImports.join(", ")} } from "blume/astro";
 `;
-  const twoslashImport = `import { transformerTwoslash } from "@shikijs/twoslash";
-`;
-  const twoslashTransformer = "transformerTwoslash({ explicitTrigger: true }), ";
+  const twoslashTransformer = "blumeTwoslashTransformer(), ";
   const deployBase = normalizeBasePath(deployment.base);
   const integrations = [
     `mdx({ processor: blumeMdxProcessor(${JSON.stringify({
@@ -3557,8 +3557,8 @@ var astroConfigTemplate = (options) => {
 ${defineConfigImport}
 import mdx from "@astrojs/mdx";
 import tailwindcss from "@tailwindcss/vite";
-import { blumeMarkdownProcessor, blumeMdxProcessor, blumeShikiTransformers } from "blume/markdown";
-${twoslashImport}${reactImport}${vueImport}${svelteImport}${blumeImport}${adapterImport}
+import { blumeMarkdownProcessor, blumeMdxProcessor, blumeShikiTransformers, blumeTwoslashTransformer } from "blume/markdown";
+${reactImport}${vueImport}${svelteImport}${blumeImport}${adapterImport}
 export default defineConfig({
   root: ${JSON.stringify(context.outDir)},
   srcDir: ${JSON.stringify(`${context.outDir}/src`)},
@@ -3986,7 +3986,9 @@ import data from "blume:data";
 export const prerender = true;
 
 // Custom (non-content) pages opted into a generated card, baked in at build.
-const customRoutes = ${JSON.stringify(customRoutes)};
+// The annotation keeps the empty-array case from being an implicit any[]
+// (ts(7034)) under a strict tsconfig.
+const customRoutes: { slug: string; title: string }[] = ${JSON.stringify(customRoutes)};
 
 export function getStaticPaths() {
   const seen = new Set<string>();
@@ -4651,9 +4653,16 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 </PageLayout>
 `;
 var islandDirective = (spec) => spec.client === "only" ? `client:only="${spec.framework}"` : `client:${spec.client}`;
+var wrapperPropsType = (name) => `type Props = typeof ${name} extends (
+  props: infer P extends object,
+  ...rest: never[]
+) => unknown
+  ? P
+  : Record<string, unknown>;`;
 var islandWrapperTemplate = (spec) => `---
 // Generated by Blume. Do not edit.
 import Island from ${JSON.stringify(spec.file)};
+${wrapperPropsType("Island")}
 ---
 <Island ${islandDirective(spec)} {...Astro.props}><slot /></Island>
 `;
@@ -4684,6 +4693,7 @@ var exampleSlug = (path) => path.replaceAll(/[^a-zA-Z0-9]/gu, (char) => `_${(cha
 var exampleWrapperTemplate = (spec) => `---
 // Generated by Blume. Do not edit.
 import Example from ${JSON.stringify(spec.file)};
+${wrapperPropsType("Example")}
 ---
 <Example ${exampleDirective(spec)}{...Astro.props}><slot /></Example>
 `;
@@ -4760,7 +4770,42 @@ const Example = entry.Component;
   <!-- Flex + margin:auto centers the example and, unlike place-items, keeps
        the top edge reachable when the example outgrows the frame. -->
   <body style="display:flex;min-height:100svh;padding:1.5rem">
-    <div style="margin:auto"><Example /></div>
+    <div data-blume-example style="margin:auto"><Example /></div>
+    <script is:inline>
+      (() => {
+        // Report the example's rendered height so the embedding docs page can
+        // size the preview pane to the content. The wrapper is observed rather
+        // than the body: the body stretches to the frame's own height, so it
+        // would only echo the pane back. Direct opens have no distinct parent
+        // and skip out; the frame is same-origin with the docs page (see the
+        // theme sync above), so the origin is pinned on both ends.
+        if (window.parent === window) {
+          return;
+        }
+        const wrapper = document.querySelector("[data-blume-example]");
+        if (!wrapper) {
+          return;
+        }
+        // The body's padding frames the example; fold it into the report so
+        // the parent can apply the number as-is. Read from the live value —
+        // the user's examples.css is injected after Blume's defaults precisely
+        // so their tokens win, so a root font-size override must be honored
+        // rather than assuming 1.5rem is 48px.
+        const bodyStyle = getComputedStyle(document.body);
+        const paddingPx =
+          parseFloat(bodyStyle.paddingTop) + parseFloat(bodyStyle.paddingBottom);
+        new ResizeObserver(() => {
+          window.parent.postMessage(
+            {
+              height:
+                Math.ceil(wrapper.getBoundingClientRect().height) + paddingPx,
+              type: "blume:example-height",
+            },
+            window.location.origin
+          );
+        }).observe(wrapper);
+      })();
+    </script>
   </body>
 </html>
 `;
@@ -7879,7 +7924,8 @@ var ogConfigSchema = z2.strictObject({
   enabled: z2.boolean().optional(),
   fonts: z2.array(ogFontSchema).optional(),
   logo: z2.string().optional(),
-  palette: ogPaletteSchema.optional()
+  palette: ogPaletteSchema.optional(),
+  titles: z2.record(z2.string(), z2.string()).optional()
 });
 var rssConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(true),
@@ -7916,9 +7962,23 @@ var githubConfigSchema = z2.strictObject({
   owner: z2.string(),
   repo: z2.string()
 });
+var codeThemeSchema = z2.custom((value) => {
+  if (typeof value === "string") {
+    return true;
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const theme = value;
+  const settingsValid = theme.settings === undefined || Array.isArray(theme.settings);
+  const tokenColorsValid = theme.tokenColors === undefined || Array.isArray(theme.tokenColors);
+  const colorsValid = theme.colors === undefined || typeof theme.colors === "object" && theme.colors !== null && !Array.isArray(theme.colors);
+  const hasContent = theme.settings !== undefined || theme.tokenColors !== undefined || theme.colors !== undefined;
+  return settingsValid && tokenColorsValid && colorsValid && hasContent;
+}, "Expected a Shiki theme name or custom theme object");
 var codeBlockThemeSchema = z2.strictObject({
-  dark: z2.string().default("github-dark"),
-  light: z2.string().default("github-light")
+  dark: codeThemeSchema.default("github-dark"),
+  light: codeThemeSchema.default("github-light")
 });
 var codeBlocksConfigSchema = z2.strictObject({
   theme: codeBlockThemeSchema.default({})
@@ -8383,19 +8443,23 @@ var ensureGroup = (parent, rawSegment) => {
 };
 var pageOrder = (page, filename) => {
   if (page.meta.sidebar.order !== undefined) {
-    return page.meta.sidebar.order;
+    return { order: page.meta.sidebar.order, orderIsAuthored: true };
   }
   if (isIndexStem(filename.replace(extname(filename), ""))) {
-    return Number.NEGATIVE_INFINITY;
+    return { order: Number.NEGATIVE_INFINITY, orderIsAuthored: false };
   }
   if (page.contentType === "changelog") {
     const iso = page.meta.date ?? page.meta.changelog?.date;
     const time = iso ? Date.parse(iso) : Number.NaN;
     if (!Number.isNaN(time)) {
-      return -time;
+      return { order: -time, orderIsAuthored: false };
     }
   }
-  return numericOrder(filename);
+  const order = numericOrder(filename);
+  return {
+    order,
+    orderIsAuthored: page.contentType !== "changelog" && Number.isFinite(order)
+  };
 };
 var metaKey = (path, metaPrefix) => {
   if (!metaPrefix) {
@@ -8416,6 +8480,9 @@ var applyFolderMeta = (group, folderMeta, sharedMeta, metaPrefix) => {
         const position = rank.get(child.key);
         if (position !== undefined) {
           child.order = position;
+          if (child.kind === "page") {
+            child.orderIsAuthored = true;
+          }
         }
       }
     }
@@ -8426,7 +8493,56 @@ var applyFolderMeta = (group, folderMeta, sharedMeta, metaPrefix) => {
     }
   }
 };
-var sortNodes = (nodes) => {
+var indexTitleMismatchDiagnostic = (page, folderPath, folderMeta, sharedMeta, metaPrefix) => {
+  if (!page.meta.title || page.fallback || folderPath === "") {
+    return;
+  }
+  const meta = folderMeta.get(metaKey(folderPath, metaPrefix)) ?? sharedMeta.get(folderPath);
+  if (!meta?.title || meta.title === page.title) {
+    return;
+  }
+  return {
+    code: "BLUME_NAV_INDEX_TITLE_MISMATCH",
+    file: page.sourcePath ?? page.id,
+    message: `Index page "${page.navPath}" has title "${page.title}", but its folder's meta.title is "${meta.title}" — the sidebar shows the folder title while the page's own <title>/heading still say "${page.title}".`,
+    severity: "warning",
+    suggestion: `Update the page's frontmatter title to match ("${meta.title}"), or leave it if the divergence is intentional.`
+  };
+};
+var isAuthoredOrder = (node) => node.kind === "group" || node.orderIsAuthored;
+var duplicateOrderDiagnostics = (nodes) => {
+  const byOrder = new Map;
+  for (const node of nodes) {
+    if (!Number.isFinite(node.order) || !isAuthoredOrder(node)) {
+      continue;
+    }
+    const tied = byOrder.get(node.order);
+    if (tied) {
+      tied.push(node);
+    } else {
+      byOrder.set(node.order, [node]);
+    }
+  }
+  const diagnostics = [];
+  for (const [order, tied] of byOrder) {
+    if (tied.length > 1) {
+      const names = tied.map((node) => `"${node.label}"`);
+      const list2 = names.length > 2 ? `${names.slice(0, -1).join(", ")}, and ${names.at(-1)}` : names.join(" and ");
+      const verb = tied.length > 2 ? "all have" : "both have";
+      const file = tied.find((node) => node.kind === "page")?.file;
+      diagnostics.push({
+        code: "BLUME_DUPLICATE_SIDEBAR_ORDER",
+        file,
+        message: `${list2} ${verb} sidebar order ${order}; falling back to alphabetical order.`,
+        severity: "warning",
+        suggestion: "Give each item a distinct sidebar.order (or folder meta order)."
+      });
+    }
+  }
+  return diagnostics;
+};
+var sortNodes = (nodes, diagnostics) => {
+  diagnostics.push(...duplicateOrderDiagnostics(nodes));
   nodes.sort((a, b) => {
     if (a.order !== b.order) {
       return a.order - b.order;
@@ -8435,7 +8551,7 @@ var sortNodes = (nodes) => {
   });
   for (const node of nodes) {
     if (node.kind === "group") {
-      sortNodes(node.children);
+      sortNodes(node.children, diagnostics);
     }
   }
 };
@@ -8483,16 +8599,22 @@ var toNavNode = (node, display) => {
     path: node.routePath
   };
 };
-var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix, display, tabPaths) => {
+var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix, display, tabPaths, diagnostics = []) => {
   const root = createGroup("", "", "", 0);
   for (const page of pages) {
-    if (page.meta.sidebar.hidden) {
-      continue;
-    }
     const parts = page.navPath.split("/");
     const filename = parts.at(-1) ?? page.navPath;
     const stem = filename.replace(extname(filename), "");
     const dirs = parts.slice(0, -1);
+    if (isIndexStem(stem)) {
+      const diagnostic = indexTitleMismatchDiagnostic(page, dirs.join("/"), folderMeta, sharedMeta, metaPrefix);
+      if (diagnostic) {
+        diagnostics.push(diagnostic);
+      }
+    }
+    if (page.meta.sidebar.hidden) {
+      continue;
+    }
     const routeSegments = page.route.split("/").filter(Boolean);
     const folderParts = isIndexStem(stem) ? routeSegments : routeSegments.slice(0, -1);
     const routeDirCount = dirs.filter((dir) => !GROUP_FOLDER.test(dir)).length;
@@ -8506,21 +8628,24 @@ var buildFileSystemSidebar = (pages, folderMeta, sharedMeta, metaPrefix, display
       }
       parent.routePath ??= `/${folderParts.slice(0, consumed).join("/")}`;
     }
+    const { order, orderIsAuthored } = pageOrder(page, filename);
     parent.children.push({
       badge: page.meta.sidebar.badge,
       deprecated: page.meta.deprecated || undefined,
       description: page.description,
+      file: page.sourcePath,
       icon: page.meta.sidebar.icon,
       key: segmentKey(stem),
       kind: "page",
       label: page.meta.sidebar.label ?? page.title,
-      order: pageOrder(page, filename),
+      order,
+      orderIsAuthored,
       pageId: page.id,
       route: page.route
     });
   }
   applyFolderMeta(root, folderMeta, sharedMeta, metaPrefix);
-  sortNodes(root.children);
+  sortNodes(root.children, diagnostics);
   hoistPages(root.children, display === "flat");
   hoistTabSections(root.children, tabPaths, display === "flat");
   return root.children.map((child) => toNavNode(child, display));
@@ -8662,19 +8787,21 @@ var buildNavigation = (pages, options) => {
       }
     }
   }
+  const rootTabPath = withBasePath(basePath, options.localizedRoot ?? "/");
   if (options.sidebar) {
     const sidebar2 = buildConfigSidebar(options.sidebar, byRoute, display, basePath);
     return {
       featured,
+      root: rootTabPath,
       selectors,
       sidebar: sidebar2,
       tabs: withTabHrefs(tabs, sidebar2)
     };
   }
-  const rootTabPath = withBasePath(basePath, options.localizedRoot ?? "/");
-  const sidebar = buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs.flatMap((tab) => tab.path === rootTabPath ? [] : [tab.path])));
+  const sidebar = buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs.flatMap((tab) => tab.path === rootTabPath ? [] : [tab.path])), options.diagnostics);
   return {
     featured,
+    root: rootTabPath,
     selectors,
     sidebar,
     tabs: withTabHrefs(tabs, sidebar)
@@ -8711,6 +8838,7 @@ var localePagesFor = (code, real, fallback, fallbackByKey, i18n, basePath) => {
     if (!present.has(key)) {
       filled.push({
         ...source,
+        fallback: true,
         locale: code,
         route: withBasePath(basePath, localizeRoute(key, code, i18n))
       });
@@ -8718,7 +8846,7 @@ var localePagesFor = (code, real, fallback, fallbackByKey, i18n, basePath) => {
   }
   return [...real, ...filled];
 };
-var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n) => {
+var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n, diagnostics) => {
   const localizePath = (path) => path.startsWith("/") ? localizeRoute(path, code, i18n) : path;
   const tabs = options.navigation.tabs?.map((tab) => ({
     ...tab,
@@ -8732,6 +8860,7 @@ var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n
   const localePages = localePagesFor(code, real, fallback, fallbackByKey, i18n, options.basePath ?? "");
   return buildNavigation(localePages, {
     basePath: options.basePath ?? "",
+    diagnostics,
     display: options.navigation.sidebar.display,
     featured: options.navigation.featured,
     folderMeta: options.folderMeta,
@@ -8744,7 +8873,7 @@ var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n
     tabs
   });
 };
-var buildI18nNavigation = (pages, options, i18n) => {
+var buildI18nNavigation = (pages, options, i18n, diagnostics) => {
   const fallback = resolveFallbackLocale(i18n);
   const fallbackByKey = new Map;
   if (fallback) {
@@ -8755,8 +8884,19 @@ var buildI18nNavigation = (pages, options, i18n) => {
     }
   }
   const navigationByLocale = {};
+  const seen = new Set;
   for (const { code } of i18n.locales) {
-    navigationByLocale[code] = buildLocaleNavigation(code, pages, fallback, fallbackByKey, options, i18n);
+    const localeDiagnostics = [];
+    navigationByLocale[code] = buildLocaleNavigation(code, pages, fallback, fallbackByKey, options, i18n, localeDiagnostics);
+    for (const diagnostic of localeDiagnostics) {
+      const key = `${diagnostic.code}
+${diagnostic.file ?? ""}
+${diagnostic.message}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        diagnostics.push(diagnostic);
+      }
+    }
   }
   const navigation = navigationByLocale[i18n.defaultLocale] ?? {
     featured: [],
@@ -8769,9 +8909,10 @@ var buildI18nNavigation = (pages, options, i18n) => {
 var buildContentGraph = (pages, options) => {
   const { diagnostics, routes } = collectRoutes(pages);
   const { i18n } = options;
-  const { navigation, navigationByLocale } = i18n ? buildI18nNavigation(pages, options, i18n) : {
+  const { navigation, navigationByLocale } = i18n ? buildI18nNavigation(pages, options, i18n, diagnostics) : {
     navigation: buildNavigation(pages, {
       basePath: options.basePath ?? "",
+      diagnostics,
       display: options.navigation.sidebar.display,
       featured: options.navigation.featured,
       folderMeta: options.folderMeta,
@@ -9939,6 +10080,34 @@ var PER_PAGE = 100;
 var LEADING_V = /^v/iu;
 var NON_SLUG3 = /[^a-z0-9]+/gu;
 var EDGE_DASHES = /^-+|-+$/gu;
+var DESCRIPTION_MAX = 160;
+var DESCRIPTION_MIN = 110;
+var CODE_FENCE2 = /```[\s\S]*?```/gu;
+var HEADING_LINE = /^#{1,6}\s.*$/gmu;
+var LIST_MARK = /^\s*(?:[-*+]|\d+[.)])\s+/u;
+var CHANGESET_HASH = /^[0-9a-f]{7,40}:\s+/u;
+var IMAGE = /!\[[^\]]*\]\([^)]*\)/gu;
+var LINK = /\[(?<text>[^\]]*)\]\([^)]*\)/gu;
+var INLINE_CODE2 = /`(?<code>[^`]+)`/gu;
+var HTML_OR_JSX = /<\/?[a-zA-Z][^\n<>]*>|<\/?>/gu;
+var MARKDOWN_PUNCT = /[*_~>]+/gu;
+var WHITESPACE2 = /\s+/gu;
+var TRAILING_FRAGMENT = /[\s,;:.—–-]+$/u;
+var releaseDescription = (body) => {
+  const text = body.replaceAll(CODE_FENCE2, " ").replaceAll(HEADING_LINE, "").split(`
+`).map((line) => line.replace(LIST_MARK, "").replace(CHANGESET_HASH, "")).join(`
+`).replaceAll(IMAGE, " ").replaceAll(LINK, "$<text>").replaceAll(INLINE_CODE2, "$<code>").replaceAll(HTML_OR_JSX, " ").replaceAll(MARKDOWN_PUNCT, " ").replaceAll(WHITESPACE2, " ").trim();
+  if (!text) {
+    return;
+  }
+  if (text.length <= DESCRIPTION_MAX) {
+    return text;
+  }
+  const slice = text.slice(0, DESCRIPTION_MAX - 1);
+  const boundary = slice.lastIndexOf(" ");
+  const head = (boundary >= DESCRIPTION_MIN ? slice.slice(0, boundary) : slice).replace(TRAILING_FRAGMENT, "");
+  return `${head}…`;
+};
 var slugifyTag = (tag) => tag.toLowerCase().replaceAll(NON_SLUG3, "-").replaceAll(EDGE_DASHES, "");
 var githubHeaders = () => {
   const headers = new Headers({ Accept: "application/vnd.github+json" });
@@ -9956,9 +10125,11 @@ var releaseToEntry = (release) => {
   const body = (release.body ?? "").replaceAll(`\r
 `, `
 `).trim();
+  const description = releaseDescription(body);
   const data = {
     changelog: { category, version },
     date,
+    ...description ? { seo: { description } } : {},
     title,
     type: "changelog"
   };
@@ -10940,6 +11111,34 @@ var entryIdDiagnostics = (pages, collectionBase) => {
   }
   return diagnostics;
 };
+var normalizeLoadedEntries = (loaded, config) => {
+  const frontmatterExtend = Object.keys(config.frontmatter.extend).length > 0 ? config.frontmatter.extend : undefined;
+  const pages = [];
+  const allDiagnostics = [];
+  let droppedPages = 0;
+  for (const { source, entries, diagnostics } of loaded) {
+    allDiagnostics.push(...diagnostics);
+    for (const entry of entries) {
+      const normalized = normalizeEntry(entry, {
+        basePath: config.basePath,
+        defaultType: config.content.defaultType,
+        frontmatterExtend,
+        i18n: config.i18n,
+        source: {
+          name: source.name,
+          prefix: source.prefix,
+          staged: source.staged
+        }
+      });
+      if (normalized.pages.length === 0 && normalized.diagnostics.length > 0) {
+        droppedPages += 1;
+      }
+      pages.push(...normalized.pages);
+      allDiagnostics.push(...normalized.diagnostics);
+    }
+  }
+  return { diagnostics: allDiagnostics, droppedPages, pages };
+};
 var scanProject = async (root, options = {}) => {
   const mode = options.mode ?? "dev";
   const preview = options.preview ?? false;
@@ -10964,27 +11163,11 @@ var scanProject = async (root, options = {}) => {
     Promise.all(sources.map(async (source) => ({ source, ...await source.load() }))),
     discoverFolderMeta(metaSources, { localeDirs })
   ]);
-  const frontmatterExtend = Object.keys(config.frontmatter.extend).length > 0 ? config.frontmatter.extend : undefined;
-  const allPages = [];
-  const contentDiagnostics = [];
-  for (const { source, entries, diagnostics } of loaded) {
-    contentDiagnostics.push(...diagnostics);
-    for (const entry of entries) {
-      const normalized = normalizeEntry(entry, {
-        basePath: config.basePath,
-        defaultType: config.content.defaultType,
-        frontmatterExtend,
-        i18n: config.i18n,
-        source: {
-          name: source.name,
-          prefix: source.prefix,
-          staged: source.staged
-        }
-      });
-      allPages.push(...normalized.pages);
-      contentDiagnostics.push(...normalized.diagnostics);
-    }
-  }
+  const {
+    diagnostics: contentDiagnostics,
+    droppedPages,
+    pages: allPages
+  } = normalizeLoadedEntries(loaded, config);
   const pages = mode === "build" && !preview ? allPages.filter((page) => !page.meta.draft) : allPages;
   const lastModified = resolveLastModifiedConfig(config.lastModified);
   if (lastModified.enabled && lastModified.source === "git") {
@@ -11016,6 +11199,7 @@ var scanProject = async (root, options = {}) => {
       ...graph.diagnostics,
       ...i18nWarnings
     ],
+    droppedPages,
     graph,
     manifest,
     mode,
@@ -11390,15 +11574,15 @@ var parseYouTubeId = (input) => {
 };
 
 // src/ai/component-markdown.ts
-var evaluateExpression = (raw) => {
+var evaluateExpression = (raw, frontmatter) => {
   try {
-    const value = new Function(`"use strict"; return (${raw});`)();
+    const value = new Function("frontmatter", `"use strict"; return (${raw});`)(frontmatter);
     return { ok: true, value };
   } catch {
     return { ok: false, value: undefined };
   }
 };
-var readProps = (node) => {
+var readProps = (node, frontmatter) => {
   const props = {};
   let lossy = false;
   for (const attribute of node.attributes ?? []) {
@@ -11411,7 +11595,7 @@ var readProps = (node) => {
     } else if (typeof attribute.value === "string") {
       props[attribute.name] = attribute.value;
     } else {
-      const result = evaluateExpression(attribute.value.value);
+      const result = evaluateExpression(attribute.value.value, frontmatter);
       if (result.ok) {
         props[attribute.name] = result.value;
       } else {
@@ -11578,12 +11762,13 @@ var renderChildren2 = (walk, node) => {
   return dedent(spliced).trim();
 };
 var serializeElement = (serializer, walk, node) => serializer({
-  ...readProps(node),
+  ...readProps(node, walk.frontmatter),
   childComponents: (name) => (node.children ?? []).filter((child) => isJsxElement(child) && child.name === name).map((child) => ({
-    ...readProps(child),
+    ...readProps(child, walk.frontmatter),
     children: renderChildren2(walk, child)
   })),
-  children: renderChildren2(walk, node)
+  children: renderChildren2(walk, node),
+  frontmatter: walk.frontmatter ?? {}
 });
 var collectSplices = (walk, nodes, out) => {
   for (const node of nodes) {
@@ -11602,7 +11787,7 @@ var collectSplices = (walk, nodes, out) => {
     collectSplices(walk, node.children ?? [], out);
   }
 };
-var downlevelComponents = (source, components) => {
+var downlevelComponents = (source, components, frontmatter) => {
   const custom = components && Object.keys(components).length > 0;
   const registry2 = custom ? { ...SERIALIZERS, ...components } : SERIALIZERS;
   const hint = custom ? componentHint(registry2) : BUILT_IN_HINT;
@@ -11616,7 +11801,7 @@ var downlevelComponents = (source, components) => {
     return source;
   }
   const splices = [];
-  collectSplices({ registry: registry2, source }, tree.children ?? [], splices);
+  collectSplices({ frontmatter, registry: registry2, source }, tree.children ?? [], splices);
   return splices.length > 0 ? applySplices(source, splices) : source;
 };
 
@@ -11746,7 +11931,8 @@ var buildFull = async (project) => {
   const pages = eligiblePages(project).toSorted((a, b) => a.route.localeCompare(b.route));
   const sections = await Promise.all(pages.map(async (page) => {
     const raw = await readEntryText(project, page);
-    const body = downlevelComponents(applyAgentVisibility(frontmatter_default(raw).content), config.ai.markdownComponents).trim();
+    const parsed = frontmatter_default(raw);
+    const body = downlevelComponents(applyAgentVisibility(parsed.content), config.ai.markdownComponents, parsed.data).trim();
     const url = pageUrl(page.route, config.deployment.site, normalizeBasePath(config.deployment.base));
     return [`# ${page.title}`, `Source: ${url}`, "", body].join(`
 `);
@@ -11920,7 +12106,11 @@ var hasGeneratedChangelog = (project, userPages) => {
   return (hasChangelog || hasChangelogSource) && !routeIsTaken(userPages, project.graph.pages, "/changelog");
 };
 var humanizeSegment = (segment) => segment.split(/[-_]/u).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-var customOgRoutes = (pages, siteTitle) => {
+var customOgRoutes = (pages, siteTitle, titles = {}) => {
+  const overrides = new Map(Object.entries(titles).map(([route, title]) => [
+    `/${route.split("/").filter(Boolean).join("/")}`,
+    title
+  ]));
   const seen = new Set;
   const routes = [];
   const collectRoute = (pattern) => {
@@ -11934,7 +12124,10 @@ var customOgRoutes = (pages, siteTitle) => {
     }
     seen.add(slug);
     const last = segments.at(-1);
-    routes.push({ slug, title: last ? humanizeSegment(last) : siteTitle });
+    routes.push({
+      slug,
+      title: overrides.get(`/${segments.join("/")}`) ?? (last ? humanizeSegment(last) : siteTitle)
+    });
   };
   for (const { pattern } of pages) {
     collectRoute(pattern);
@@ -12006,25 +12199,25 @@ var buildSearchIndex = async (outDir) => {
 };
 
 // src/search/documents.ts
-var CODE_FENCE2 = /```[\s\S]*?```/gu;
-var INLINE_CODE2 = /`(?<code>[^`]+)`/gu;
-var HTML_OR_JSX = /<\/?[a-zA-Z][^\n<>]*>|<\/?>/gu;
-var IMAGE = /!\[[^\]]*\]\([^)]*\)/gu;
-var LINK = /\[(?<text>[^\]]*)\]\([^)]*\)/gu;
+var CODE_FENCE3 = /```[\s\S]*?```/gu;
+var INLINE_CODE3 = /`(?<code>[^`]+)`/gu;
+var HTML_OR_JSX2 = /<\/?[a-zA-Z][^\n<>]*>|<\/?>/gu;
+var IMAGE2 = /!\[[^\]]*\]\([^)]*\)/gu;
+var LINK2 = /\[(?<text>[^\]]*)\]\([^)]*\)/gu;
 var HEADING_MARK = /^#{1,6}\s+/gmu;
-var MARKDOWN_PUNCT = /[*_~>]+/gu;
-var WHITESPACE2 = /\s+/gu;
+var MARKDOWN_PUNCT2 = /[*_~>]+/gu;
+var WHITESPACE3 = /\s+/gu;
 var toPlainText = (markdown) => {
-  const withoutBlocks = markdown.replaceAll(CODE_FENCE2, " ").replaceAll(IMAGE, " ").replaceAll(LINK, "$<text>");
+  const withoutBlocks = markdown.replaceAll(CODE_FENCE3, " ").replaceAll(IMAGE2, " ").replaceAll(LINK2, "$<text>");
   const pieces = [];
   let cursor = 0;
-  for (const match of withoutBlocks.matchAll(INLINE_CODE2)) {
+  for (const match of withoutBlocks.matchAll(INLINE_CODE3)) {
     const start = match.index ?? 0;
-    pieces.push(withoutBlocks.slice(cursor, start).replaceAll(HTML_OR_JSX, " "), match.groups?.code ?? "");
+    pieces.push(withoutBlocks.slice(cursor, start).replaceAll(HTML_OR_JSX2, " "), match.groups?.code ?? "");
     cursor = start + match[0].length;
   }
-  pieces.push(withoutBlocks.slice(cursor).replaceAll(HTML_OR_JSX, " "));
-  return pieces.join("").replaceAll(HEADING_MARK, "").replaceAll(MARKDOWN_PUNCT, " ").replaceAll(WHITESPACE2, " ").trim();
+  pieces.push(withoutBlocks.slice(cursor).replaceAll(HTML_OR_JSX2, " "));
+  return pieces.join("").replaceAll(HEADING_MARK, "").replaceAll(MARKDOWN_PUNCT2, " ").replaceAll(WHITESPACE3, " ").trim();
 };
 var buildCrumbIndex = (sidebar) => {
   const index = new Map;
@@ -12346,6 +12539,7 @@ import {
   lstat,
   mkdir as mkdir6,
   readFile as readFile14,
+  realpath,
   rename,
   rm as rm2,
   symlink,
@@ -12389,7 +12583,7 @@ var buildRawMarkdown = async (project) => {
   };
   const entries = await Promise.all(project.manifest.routes.map(async (route) => {
     const source = applyAgentVisibility(await readRoute(route));
-    const md = downlevelComponents(source, project.config.ai.markdownComponents);
+    const md = downlevelComponents(source, project.config.ai.markdownComponents, frontmatter_default(source).data);
     const entry = md === source ? { mdx: source } : { md, mdx: source };
     return [route.path, entry];
   }));
@@ -14261,10 +14455,11 @@ var resolvedAstroPath = (fromDir) => {
     dir = parent;
   }
 };
-var blumeDepsDir = (pkgDir = packageRoot()) => {
-  const candidates = [join26(pkgDir, "node_modules"), dirname9(pkgDir)];
-  return candidates.find((dir) => existsSync14(join26(dir, "astro"))) ?? null;
-};
+var depsCandidates = (pkgDir) => [
+  join26(pkgDir, "node_modules"),
+  dirname9(pkgDir)
+];
+var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync14(join26(dir, ...segments))) ?? null;
 var linkDepsJunction = async (link, depsDir) => {
   let existing;
   try {
@@ -14298,18 +14493,43 @@ var astroConflictWarning = (blumeAstroPkg, shadowAstroPkg) => {
   const pin = blume ?? "<Blume's astro version>";
   return `Astro version conflict: another dependency hoisted ${versions} to the project root, so @astrojs/mdx binds to the wrong copy and the build fails on a missing export (e.g. "chunkToString"). A single symlink can't reconcile a split install — pin Blume's Astro by adding a package.json "overrides" (npm/bun/pnpm) or "resolutions" (yarn) entry { "astro": "${pin}" }, then reinstall. Run \`npm ls astro\` to find the dependency pulling the older copy.`;
 };
+var dropStaleDepsLink = async (link, pkgDir) => {
+  let existing;
+  try {
+    existing = await lstat(link);
+  } catch {
+    return;
+  }
+  if (!existing.isSymbolicLink()) {
+    return;
+  }
+  let linkedBlume;
+  let runningBlume;
+  try {
+    linkedBlume = await realpath(join26(link, "blume"));
+    runningBlume = await realpath(pkgDir);
+  } catch {
+    return;
+  }
+  if (linkedBlume !== runningBlume) {
+    await rm2(link, { force: true });
+  }
+};
 var ensureDepsLink = async (outDir, pkgDir = packageRoot()) => {
-  const depsDir = blumeDepsDir(pkgDir);
-  if (!depsDir) {
+  const astroDir = candidateHolding(pkgDir, "astro");
+  if (!astroDir) {
     return null;
   }
-  const blumeAstro = resolveAstroPackageJson(depsDir);
+  const mdxDir = candidateHolding(pkgDir, "@astrojs", "mdx");
+  const blumeAstro = resolveAstroPackageJson(astroDir);
+  await dropStaleDepsLink(join26(outDir, "node_modules"), pkgDir);
   const outDirAstro = resolvedAstroPath(outDir);
-  if (blumeAstro && outDirAstro === blumeAstro) {
+  const astroCorrect = blumeAstro !== null && outDirAstro === blumeAstro;
+  if (astroCorrect && mdxDir === astroDir) {
     return null;
   }
-  if (existsSync14(join26(depsDir, "@astrojs", "mdx"))) {
-    await linkDepsJunction(join26(outDir, "node_modules"), depsDir);
+  if (mdxDir && (mdxDir === astroDir || astroCorrect)) {
+    await linkDepsJunction(join26(outDir, "node_modules"), mdxDir);
     return null;
   }
   return astroConflictWarning(blumeAstro, outDirAstro);
@@ -14807,7 +15027,7 @@ var generateRuntime = async (project) => {
   const needsVue = frameworks.has("vue");
   const needsSvelte = frameworks.has("svelte");
   const reactCompilerPath = resolveReactCompiler(config, needsReact);
-  const ogRoutes = customOgRoutes(pages, config.title);
+  const ogRoutes = customOgRoutes(pages, config.title, config.seo.og.titles);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
   const hasStaged = staged.size > 0;
@@ -15104,12 +15324,13 @@ var prepareProject = async (options) => {
     }
   }
   const hadErrors = reportDiagnostics(project.diagnostics, options.root);
+  const dropped = project.droppedPages > 0 ? `${project.droppedPages} page(s) failed frontmatter validation and were dropped from the site. ` : "";
   if (hadErrors && options.strict) {
-    logger.error("Aborting due to errors (strict mode).");
+    logger.error(`Aborting due to errors. ${dropped}Fix the diagnostics above, or pass --no-strict to continue despite them.`);
     process.exit(1);
   }
   if (hasErrors(project.diagnostics) && !options.strict) {
-    logger.warn("Continuing despite errors. Use --strict to fail the build.");
+    logger.warn(`Continuing despite errors. ${dropped}Use --strict to fail instead.`);
   }
   const { warnings } = await generateRuntime(project);
   for (const warning of warnings) {
@@ -15307,6 +15528,9 @@ var publishBuildArtifacts = async (project, distDir, args) => {
   ].join(`
 `));
   await runClientAssetChecks(distDir, args);
+  if (project.droppedPages > 0) {
+    logger.warn(`${project.droppedPages} page(s) failed frontmatter validation and are missing from this build.`);
+  }
   logger.success(`Built to ${distDir}`);
 };
 var buildCommand = defineCommand3({
@@ -15343,7 +15567,11 @@ var buildCommand = defineCommand3({
       description: "Include drafts and unpublished CMS content.",
       type: "boolean"
     },
-    strict: { description: "Fail on diagnostics.", type: "boolean" }
+    strict: {
+      default: true,
+      description: "Fail on error diagnostics (default; pass --no-strict to build anyway, dropping pages that fail validation).",
+      type: "boolean"
+    }
   },
   meta: {
     description: "Build the docs site for production.",
@@ -16032,7 +16260,7 @@ var eject = async (root) => {
   }
   if (config.seo.og.enabled) {
     files.push({
-      content: ogEndpointTemplate(customOgRoutes(pages, config.title)),
+      content: ogEndpointTemplate(customOgRoutes(pages, config.title, config.seo.og.titles)),
       path: join31(srcDir, "pages", "og", "[...slug].png.ts")
     });
   }
@@ -17071,5 +17299,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=2D51E90E387F80A664756E2164756E21
+//# debugId=7D02660AA9B8797064756E2164756E21
 //# sourceMappingURL=index.js.map