blume 1.5.0 → 1.5.2

package/dist/cli/index.js

@@ -3179,11 +3179,13 @@ var referencesFor = (kind, block, defaultLabel, renderer, display, basePath) =>
 var resolveReferences = (config) => [
   ...referencesFor("openapi", config.openapi, "API Reference", config.openapi.renderer, {
     codeSamples: config.openapi.codeSamples,
-    expandSchemas: config.openapi.expandSchemas
+    expandSchemas: config.openapi.expandSchemas,
+    playground: config.openapi.playground
   }, config.basePath),
   ...referencesFor("asyncapi", config.asyncapi, "Events", config.asyncapi.renderer, {
     codeSamples: config.asyncapi.codeSamples,
-    expandSchemas: config.asyncapi.expandSchemas
+    expandSchemas: config.asyncapi.expandSchemas,
+    playground: config.asyncapi.playground
   }, config.basePath)
 ];
 var referenceRoutes = (config) => resolveReferences(config).map((ref) => ref.renderer === "blume" ? withBasePath(config.basePath, ref.route) : ref.route);
@@ -3607,7 +3609,47 @@ ${lines.join(`
 }
 ` : "";
 };
-var configuredCssVars = (fonts) => buildFontEntries(fonts).map((entry) => entry.cssVariable);
+var PRELOAD_WEIGHTS = {
+  body: [400, 500],
+  display: [500, 600],
+  mono: [400]
+};
+var entryWeights = (entry) => entry.kind === "remote" ? entry.weights : entry.variants.map((variant) => variant.weight);
+var preloadWeightsFor = (slot, entry) => {
+  const preferred = PRELOAD_WEIGHTS[slot];
+  const weights = entryWeights(entry);
+  const numeric = weights.filter((weight) => typeof weight === "number");
+  const hits = preferred.filter((weight) => numeric.includes(weight));
+  if (hits.length > 0) {
+    return hits;
+  }
+  return numeric.length === weights.length ? numeric : preferred;
+};
+var configuredFonts = (fonts) => {
+  if (!fonts) {
+    return [];
+  }
+  const heads = new Map;
+  for (const slot of SLOTS) {
+    const value = fonts[slot];
+    if (value === undefined) {
+      continue;
+    }
+    const entry = resolveFontValue(slot, value);
+    if (!entry) {
+      continue;
+    }
+    const weights = heads.get(entry.cssVariable) ?? new Set;
+    for (const weight of preloadWeightsFor(slot, entry)) {
+      weights.add(weight);
+    }
+    heads.set(entry.cssVariable, weights);
+  }
+  return [...heads].map(([cssVariable, weights]) => ({
+    cssVariable,
+    preloadWeights: [...weights].toSorted((a, b) => a - b)
+  }));
+};
 
 // src/astro/templates.ts
 var WORKSPACE_MARKERS = [
@@ -3936,6 +3978,11 @@ ${userConfigSetup}export default defineConfig({
     },
   },
   devToolbar: { enabled: false },
+  // The layouts render Astro's <ClientRouter />, and its in-place swaps read
+  // from the prefetch cache — fetching every link on hover/viewport hides the
+  // request latency behind the user's intent, so most navigations swap
+  // instantly.
+  prefetch: { prefetchAll: true },
   vite: {
     plugins: [tailwindcss(), prerenderDepsPlugin(), serverAppResolvePlugin()],
     // Everything hydration can reach must be part of the dev dep optimizer's
@@ -4047,7 +4094,8 @@ export const collections = { docs${options.staged ? ", staged" : ""} };
 `;
 };
 var ASK_FALLBACK_PROMPT = "You are a helpful documentation assistant. Answer using the project's documentation.";
-var askEndpointTemplate = (backend, grounded, instructions) => {
+var askEndpointTemplate = (backend, grounded, options) => {
+  const instructions = options?.instructions;
   const fallbackPrompt = instructions ? `${ASK_FALLBACK_PROMPT}
 
 ${instructions}` : ASK_FALLBACK_PROMPT;
@@ -4076,7 +4124,14 @@ const provider = createOpenAICompatible({
   }
   if (grounded) {
     imports.push('import { createAskContext } from "blume/ai/ask-context.ts";', 'import askData from "../../generated/ask-data.json";');
-    const groundOptions = instructions ? `, { instructions: ${JSON.stringify(instructions)} }` : "";
+    const groundFields = [];
+    if (instructions) {
+      groundFields.push(`instructions: ${JSON.stringify(instructions)}`);
+    }
+    if (options?.retrieval) {
+      groundFields.push(`retrieval: ${JSON.stringify(options.retrieval)}`);
+    }
+    const groundOptions = groundFields.length > 0 ? `, { ${groundFields.join(", ")} }` : "";
     setup += `
 const ground = createAskContext(askData${groundOptions});
 `;
@@ -4414,6 +4469,16 @@ const handler = createMcpFetchHandler(data as McpData);
 export const ALL: APIRoute = ({ request }) => handler(request);
 `;
 };
+var playgroundProxyTemplate = (origins) => `// Generated by Blume. Do not edit.
+import type { APIRoute } from "astro";
+import { createPlaygroundProxyHandler } from "blume/openapi/proxy.ts";
+
+export const prerender = false;
+
+const handler = createPlaygroundProxyHandler(${JSON.stringify(origins)});
+
+export const ALL: APIRoute = ({ request }) => handler(request);
+`;
 var staticJsonEndpointTemplate = (payload) => `// Generated by Blume. Do not edit.
 export const prerender = true;
 
@@ -4444,7 +4509,7 @@ export function GET({ props }: { props: { section: string } }) {
   });
 }
 `;
-var ogEndpointTemplate = (customRoutes = [], og = {}) => `// Generated by Blume. Do not edit.
+var ogEndpointTemplate = (customRoutes = [], og = {}, includeChangelog = false) => `// Generated by Blume. Do not edit.
 import { renderOgImage } from "blume/og";
 import type { OgFont, OgFontFamilies } from "blume/og";
 import data from "blume:data";
@@ -4479,7 +4544,10 @@ export function getStaticPaths() {
   }
   for (const route of data.routes) {
     add(route.path === "/" ? "index" : route.path.slice(1), route.title);
-  }
+  }${includeChangelog ? `
+  // The generated changelog index is not a content route, so it needs its own
+  // card. Added last: a custom page or content route owning /changelog wins.
+  add("changelog", data.ui.changelog?.title ?? "Changelog");` : ""}
   return paths;
 }
 
@@ -4753,10 +4821,9 @@ const contentLocale =
 const contentDir = i18n
   ? (i18n.locales.find((l) => l.code === contentLocale)?.dir ?? "ltr")
   : "ltr";
-const absolute = (path: string) => {
-  const p = withBase(path);
-  return base + (p === "/" ? "" : p);
-};
+// The root route keeps its trailing slash (\`https://site/\`) so canonical and
+// hreflang URLs byte-match the sitemap's <loc> for the home page.
+const absolute = (path: string) => base + withBase(path);
 
 // An archived page defaults its canonical to the same page in the latest docs
 // when that page still exists — search engines treat the live page as
@@ -4767,7 +4834,7 @@ const canonical =
   (archived && archived.canonical === "latest" && latestVersionAlt && base
     ? absolute(latestVersionAlt.path)
     : base
-      ? \`\${base}\${basedRoute === "/" ? "" : encodeURI(basedRoute)}\`
+      ? \`\${base}\${basedRoute === "/" ? "/" : encodeURI(basedRoute)}\`
       : null);
 const effectiveNoindex = Boolean(seo.noindex) || (archived?.noindex ?? false);
 
@@ -4902,6 +4969,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   feedback={data.config.feedback}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
+  openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
   siteUrl={data.config.site}
@@ -5061,6 +5129,12 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const basedRoute = withBase("/changelog");
 const canonical = base ? base + basedRoute : null;
 
+// The generated OG card for this route (the /og endpoint emits it alongside
+// the content-route cards), absolutized like the catch-all's so crawlers get
+// a full URL when the site is known.
+const ogPath = data.config.og.enabled ? withBase("/og/changelog.png") : null;
+const ogImage = ogPath && base ? base + ogPath : ogPath;
+
 // The page chrome (h1, title, description) comes from the same translatable
 // \`changelog\` group as the reveal button; optional chaining tolerates a
 // not-yet-regenerated data snapshot from before these keys existed.
@@ -5068,7 +5142,10 @@ const changelogTitle = data.ui.changelog?.title ?? "Changelog";
 const changelogDescription =
   data.ui.changelog?.description ??
   "Product updates, new features, and fixes from every release.";
-const pageTitle = data.config.title + " " + changelogTitle;
+// 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").
+const pageTitle = changelogTitle;
 
 const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
 ---
@@ -5100,11 +5177,13 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   fontCssVars={data.fontCssVars}
   searchEnabled={data.config.search.enabled}
   indexable={true}
-  ogImage={null}
+  ogImage={ogImage}
+  ogGenerated={Boolean(ogImage)}
   x={data.config.x}
   canonical={canonical}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}
+  openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
   siteUrl={data.config.site}
@@ -9566,6 +9645,16 @@ var resolveUIStrings = (locale, options) => {
   return dict;
 };
 
+// src/core/open-in-chat.ts
+var openInChatProviders = [
+  "v0",
+  "chatgpt",
+  "claude",
+  "t3",
+  "scira",
+  "cursor"
+];
+
 // src/core/standard-schema.ts
 var isStandardSchema = (value) => typeof value === "object" && value !== null && typeof value["~standard"]?.validate === "function";
 
@@ -9861,7 +9950,7 @@ var themeConfigSchema = z2.strictObject({
   backgroundImage: perModeValueSchema,
   fonts: z2.strictObject({
     body: fontValueSchema.default("inter"),
-    display: fontValueSchema.default("inter-tight"),
+    display: fontValueSchema.default("inter"),
     mono: fontValueSchema.default("ibm-plex-mono")
   }).prefault({}),
   layout: z2.enum(["sidebar"]).default("sidebar"),
@@ -9980,6 +10069,11 @@ var aiConfigSchema = z2.strictObject({
     instructions: z2.string().trim().min(1).optional(),
     model: z2.string().default("openai/gpt-5.5"),
     provider: z2.enum(askAiProviders).default("gateway"),
+    retrieval: z2.strictObject({
+      contextBudget: z2.number().int().positive().optional(),
+      excerptChars: z2.number().int().positive().optional(),
+      maxResults: z2.number().int().positive().optional()
+    }).optional(),
     suggestions: z2.array(z2.strictObject({
       icon: iconName.optional(),
       label: z2.string().min(1)
@@ -10004,6 +10098,17 @@ var aiConfigSchema = z2.strictObject({
     message: "Expected a serializer function."
   })).default({}),
   mcp: mcpConfigSchema.prefault({}),
+  openInChat: z2.union([
+    z2.boolean(),
+    z2.array(z2.enum(openInChatProviders)).refine((value) => new Set(value).size === value.length, {
+      message: "ai.openInChat must not repeat a provider."
+    })
+  ]).default(true).transform((value) => {
+    if (isBoolean(value)) {
+      return value ? [...openInChatProviders] : [];
+    }
+    return value;
+  }),
   skills: z2.string().min(1).optional(),
   webBotAuth: z2.strictObject({
     keys: z2.array(publicJwkSchema).default([])
@@ -10279,6 +10384,13 @@ var referenceConfigSchema = (defaults) => z2.strictObject({
   codeSamples: z2.array(z2.string()).default(defaults.codeSamples),
   enabled: z2.boolean().default(false),
   expandSchemas: z2.boolean().default(false),
+  playground: z2.union([
+    z2.boolean(),
+    z2.strictObject({
+      enabled: z2.boolean().default(true),
+      proxy: z2.union([z2.boolean(), z2.string()]).default(false)
+    })
+  ]).default(true).transform((value) => isBoolean(value) ? { enabled: value, proxy: false } : value),
   renderer: z2.enum(["blume", "scalar"]).default("blume"),
   route: z2.string().default(defaults.route),
   scalar: scalarConfigSchema,
@@ -10718,6 +10830,8 @@ import { extname } from "pathe";
 var NUMERIC_PREFIX = /^(?<order>\d+)[-_.]/u;
 var GROUP_FOLDER = /^\((?<label>.+)\)$/u;
 var WORD_SPLIT = /[-_]/u;
+var isUnderPath = (route, base) => base === "/" || route === base || route.startsWith(`${base}/`);
+var isRootTab = (tab, root) => isUnderPath(root, tab.path);
 var humanize = (segment) => segment.replace(NUMERIC_PREFIX, "").split(WORD_SPLIT).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 var numericOrder = (segment) => {
   const value = segment.match(NUMERIC_PREFIX)?.groups?.order;
@@ -11174,7 +11288,7 @@ var buildNavigation = (pages, options) => {
       tabs: withTabHrefs(tabs, sidebar2)
     };
   }
-  const sidebar = buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, sharedMetaPrefix, display, new Set(tabs.flatMap((tab) => tab.path === rootTabPath ? [] : [tab.path])), diagnostics);
+  const sidebar = buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, sharedMetaPrefix, display, new Set(tabs.flatMap((tab) => isRootTab(tab, rootTabPath) ? [] : [tab.path])), diagnostics);
   return {
     featured,
     root: rootTabPath,
@@ -11406,6 +11520,15 @@ var buildContentGraph = (pages, options) => {
 // src/core/last-modified.ts
 import { execFileSync } from "node:child_process";
 import { relative as relative7 } from "pathe";
+var GIT_LOCATION_VARS = new Set([
+  "GIT_COMMON_DIR",
+  "GIT_DIR",
+  "GIT_INDEX_FILE",
+  "GIT_OBJECT_DIRECTORY",
+  "GIT_PREFIX",
+  "GIT_WORK_TREE"
+]);
+var gitEnv = () => Object.fromEntries(Object.entries(process.env).filter(([key]) => !GIT_LOCATION_VARS.has(key)));
 var resolveLastModifiedConfig = (value) => {
   if (value === false) {
     return { enabled: false, source: "git" };
@@ -11433,7 +11556,7 @@ var gitLastModifiedTimes = (root, contentRoots, sourcePaths) => {
     return new Map;
   }
   try {
-    const gitRoot = execFileSync("git", ["-C", root, "rev-parse", "--show-toplevel"], { encoding: "utf-8" }).trim();
+    const gitRoot = execFileSync("git", ["-C", root, "rev-parse", "--show-toplevel"], { encoding: "utf-8", env: gitEnv() }).trim();
     const output = execFileSync("git", [
       "-C",
       root,
@@ -11444,7 +11567,7 @@ var gitLastModifiedTimes = (root, contentRoots, sourcePaths) => {
       "--name-only",
       "--",
       ...contentRoots
-    ], { encoding: "utf-8", maxBuffer: 256 * 1024 * 1024 });
+    ], { encoding: "utf-8", env: gitEnv(), maxBuffer: 256 * 1024 * 1024 });
     const byRepoPath = parseGitLog(output);
     const result = new Map;
     for (const sourcePath of sourcePaths) {
@@ -11458,6 +11581,30 @@ var gitLastModifiedTimes = (root, contentRoots, sourcePaths) => {
     return new Map;
   }
 };
+var isShallowGitRepository = (root) => {
+  try {
+    return execFileSync("git", ["-C", root, "rev-parse", "--is-shallow-repository"], {
+      encoding: "utf-8",
+      env: gitEnv(),
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim() === "true";
+  } catch {
+    return false;
+  }
+};
+var lastModifiedShallowWarning = (root, undatedCount) => {
+  if (undatedCount === 0 || !isShallowGitRepository(root)) {
+    return [];
+  }
+  return [
+    {
+      code: "BLUME_SHALLOW_GIT_HISTORY",
+      message: `lastModified is on, but this build runs in a shallow git clone, so ${undatedCount} page(s) have no git-derived date — their sitemap <lastmod> and "Last updated" stamps are omitted.`,
+      severity: "warning",
+      suggestion: "Fetch full history in CI: set the VERCEL_DEEP_CLONE=true environment variable on Vercel, or fetch-depth: 0 for actions/checkout."
+    }
+  ];
+};
 
 // src/core/manifest.ts
 var versionAlternateKey = (versionKey, locale) => `${versionKey}\x00${locale}`;
@@ -11829,11 +11976,15 @@ var scanLinkLine = (line, lineNumber, fence, links) => {
       continue;
     }
     const targetOffset = targetOffsetIn(match[0], target, match.groups?.title);
-    links.push({
+    const entry = {
       column: match.index + targetOffset + 1,
       line: lineNumber,
       target
-    });
+    };
+    if (masked[match.index - 1] === "!") {
+      entry.image = true;
+    }
+    links.push(entry);
     const label = match[0].slice(0, targetOffset - "](".length);
     for (const image of label.matchAll(MD_IMAGE)) {
       const imageTarget = image.groups?.target;
@@ -11842,6 +11993,7 @@ var scanLinkLine = (line, lineNumber, fence, links) => {
       }
       links.push({
         column: match.index + image.index + targetOffsetIn(image[0], imageTarget, image.groups?.title) + 1,
+        image: true,
         line: lineNumber,
         target: imageTarget
       });
@@ -12790,6 +12942,13 @@ var openApiSource = (references, ctx) => {
     try {
       const { document, warnings, operations, tags, extractWarnings } = await parseReference(reference, ctx);
       const info = document.info ?? { title: reference.label, version: "" };
+      const { proxy: configuredProxy } = reference.display.playground;
+      let proxy = false;
+      if (configuredProxy === true) {
+        proxy = withBasePath(reference.basePath, "/_api-proxy");
+      } else if (configuredProxy !== false && configuredProxy !== "") {
+        proxy = configuredProxy;
+      }
       const spec = {
         codeSamples: reference.display.codeSamples,
         description: info.description ?? "",
@@ -12804,6 +12963,7 @@ var openApiSource = (references, ctx) => {
             route: withBasePath(reference.basePath, operation.route)
           }
         ])),
+        playground: { enabled: reference.display.playground.enabled, proxy },
         route: reference.route,
         slug: reference.slug,
         tags,
@@ -14029,6 +14189,7 @@ var scanProject = async (root, options = {}) => {
   } = normalizeLoadedEntries(loaded, config);
   const pages = mode === "build" && !preview ? allPages.filter((page) => !page.meta.draft) : allPages;
   const lastModified = resolveLastModifiedConfig(config.lastModified);
+  const lastModifiedWarnings = [];
   if (lastModified.enabled && lastModified.source === "git") {
     const fsPaths = pages.map((page) => page.sourcePath).filter((path) => path !== undefined);
     const contentRoots = sources.flatMap((source) => source.staged || !source.contentRoot ? [] : [source.contentRoot]);
@@ -14038,6 +14199,8 @@ var scanProject = async (root, options = {}) => {
         page.lastModified = gitTimes.get(page.sourcePath);
       }
     }
+    const undated = pages.filter((page) => page.sourcePath && !page.lastModified).length;
+    lastModifiedWarnings.push(...lastModifiedShallowWarning(context.root, undated));
   }
   const graph = buildContentGraph(pages, {
     basePath: config.basePath,
@@ -14059,7 +14222,8 @@ var scanProject = async (root, options = {}) => {
       ...entryIdDiagnostics(pages, resolveDocsCollection(config, context).base),
       ...graph.diagnostics,
       ...i18nWarnings,
-      ...versionWarnings
+      ...versionWarnings,
+      ...lastModifiedWarnings
     ],
     droppedPages,
     graph,
@@ -14250,7 +14414,7 @@ var auditCommand = defineCommand2({
 });
 
 // src/cli/commands/build.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 import { mkdir as mkdir8, readdir as readdir2, readFile as readFile17, stat as stat3, writeFile as writeFile7 } from "node:fs/promises";
 import { build } from "astro";
 import { defineCommand as defineCommand3 } from "citty";
@@ -14423,9 +14587,16 @@ var buildAgentReadability = (project) => {
 };
 
 // src/core/content-assets.ts
-import { existsSync as existsSync9 } from "node:fs";
+import { readdirSync, statSync } from "node:fs";
 import { readFile as readFile8 } from "node:fs/promises";
-import { dirname as dirname7, extname as extname5, relative as relative11, resolve as resolve5 } from "pathe";
+import {
+  basename as basename2,
+  dirname as dirname7,
+  extname as extname5,
+  normalize as normalize3,
+  relative as relative11,
+  resolve as resolve5
+} from "pathe";
 var CONTENT_ASSETS_PREFIX = "/blume-assets/content";
 var IMAGE_EXTENSIONS = new Set([
   ".apng",
@@ -14448,19 +14619,40 @@ var contentAssetParam = (projectRoot, absPath) => {
   }
   return rel;
 };
-var resolveRelativeImage = (sourceDir, target) => {
-  if (!isRelativeTarget(target)) {
-    return null;
-  }
-  let decoded = target;
+var decodeTarget = (target) => {
   try {
-    decoded = decodeURI(target);
-  } catch {}
-  if (!IMAGE_EXTENSIONS.has(extname5(decoded).toLowerCase())) {
+    return decodeURI(target);
+  } catch {
+    return target;
+  }
+};
+var isRelativeImageTarget = (target) => isRelativeTarget(target) && IMAGE_EXTENSIONS.has(extname5(decodeTarget(target)).toLowerCase());
+var existsAsWritten = (abs, segments) => {
+  let current = abs;
+  for (let i = 0;i < segments; i += 1) {
+    const parent = dirname7(current);
+    let entries;
+    try {
+      entries = readdirSync(parent);
+    } catch {
+      return false;
+    }
+    if (!entries.includes(basename2(current))) {
+      return false;
+    }
+    current = parent;
+  }
+  const stat2 = statSync(abs, { throwIfNoEntry: false });
+  return stat2 !== undefined && stat2.isFile();
+};
+var resolveRelativeImage = (sourceDir, target) => {
+  if (!isRelativeImageTarget(target)) {
     return null;
   }
+  const decoded = decodeTarget(target);
+  const segments = normalize3(decoded).split("/").filter((part) => part !== "" && part !== "..").length;
   const abs = resolve5(sourceDir, decoded);
-  return existsSync9(abs) ? abs : null;
+  return existsAsWritten(abs, segments) ? abs : null;
 };
 var encodedParam = (param) => param.split("/").map(encodeURIComponent).join("/");
 var rewriteLine = (line, toUrl2) => {
@@ -15178,13 +15370,13 @@ var buildSignaturesDirectory = (config) => {
 };
 
 // src/core/gitignore.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { readFile as readFile12, writeFile as writeFile6 } from "node:fs/promises";
 import { join as join19 } from "pathe";
 var gitignoreKey = (line) => line.trim().replace(/\/+$/u, "");
 var ensureGitignore = async (root, entries) => {
   const path = join19(root, ".gitignore");
-  const existing = existsSync10(path) ? await readFile12(path, "utf-8") : "";
+  const existing = existsSync9(path) ? await readFile12(path, "utf-8") : "";
   const present = new Set(existing.split(`
 `).flatMap((line) => {
     const key = gitignoreKey(line);
@@ -15212,6 +15404,9 @@ var serverFeatures = (config) => {
   if (config.ai.mcp.enabled) {
     features.push("MCP server");
   }
+  if (config.openapi.enabled && config.openapi.renderer === "blume" && config.openapi.playground.enabled && config.openapi.playground.proxy === true) {
+    features.push("API playground proxy");
+  }
   if (searchProviderMeta(config.search.provider).requiresServer) {
     features.push(`Search (${config.search.provider})`);
   }
@@ -15818,12 +16013,14 @@ var buildNegotiationRoutes = (routePaths, homeTokens) => {
   return { headerRoutes, rewriteRoutes };
 };
 var HOME_SRC = "^/$";
-var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3;
+var TRAILING_SLASH_REDIRECT = {
+  headers: { Location: "/$1" },
+  src: "^/(.+)/$",
+  status: 308
+};
+var isNegotiationRoute = (route) => route.has?.some((condition) => condition.value === ACCEPT_MARKDOWN_HEADER_VALUE) === true || route.continue === true && route.headers?.vary === "Accept" && isString6(route.src) && Object.keys(route).length === 3 || route.continue === true && isString6(route.headers?.link) && route.src === HOME_SRC && Object.keys(route).length === 3 || route.status === TRAILING_SLASH_REDIRECT.status && route.src === TRAILING_SLASH_REDIRECT.src;
 var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTypeOverrides, homeTokens) => {
   const overrideEntries = Object.entries(contentTypeOverrides ?? {});
-  if (routePaths.length === 0 && !homeLinkHeader && overrideEntries.length === 0) {
-    return null;
-  }
   let config;
   try {
     config = JSON.parse(configText);
@@ -15849,7 +16046,7 @@ var injectNegotiationRoutes = (configText, routePaths, homeLinkHeader, contentTy
       src: HOME_SRC
     });
   }
-  routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes);
+  routes.splice(filesystemIndex, 0, ...headerRoutes, ...rewriteRoutes, TRAILING_SLASH_REDIRECT);
   config.routes = routes;
   return `${JSON.stringify(config, null, "\t")}
 `;
@@ -16158,7 +16355,7 @@ var syncSearchProvider = async (project, reporter) => {
 
 // src/cli/dev-lock.ts
 import {
-  existsSync as existsSync11,
+  existsSync as existsSync10,
   mkdirSync,
   readFileSync as readFileSync5,
   rmSync,
@@ -16197,7 +16394,7 @@ var isProcessAlive = (pid) => {
 };
 var readDevLock = (outDir) => {
   const path = lockPath(outDir);
-  if (!existsSync11(path)) {
+  if (!existsSync10(path)) {
     return null;
   }
   const lock = parseLock(readFileSync5(path, "utf-8"));
@@ -16224,7 +16421,7 @@ class DevLockHeldError extends Error {
 }
 var ownsLock = (outDir) => {
   const path = lockPath(outDir);
-  if (!existsSync11(path)) {
+  if (!existsSync10(path)) {
     return false;
   }
   try {
@@ -16282,7 +16479,7 @@ var refuseIfDevRunning = (root, action, options = {}) => {
 
 // src/astro/generate.ts
 import { createHash as createHash4 } from "node:crypto";
-import { existsSync as existsSync16, readFileSync as readFileSync8, realpathSync } from "node:fs";
+import { existsSync as existsSync15, readFileSync as readFileSync8, realpathSync } from "node:fs";
 import {
   lstat,
   mkdir as mkdir7,
@@ -16296,7 +16493,7 @@ import { createRequire as createRequire4 } from "node:module";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 import { imageSize as imageSize2 } from "image-size";
 import pMap6 from "p-map";
-import { basename as basename3, dirname as dirname11, join as join28, normalize as normalize3, relative as relative14, resolve as resolve8 } from "pathe";
+import { basename as basename4, dirname as dirname11, join as join28, normalize as normalize4, relative as relative14, resolve as resolve8 } from "pathe";
 import { glob as glob7 } from "tinyglobby";
 
 // src/ai/ask-data.ts
@@ -16545,7 +16742,7 @@ var validateUsedComponents = (pages, extraTags, registryNames) => {
 };
 
 // src/core/component-overrides.ts
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { dirname as dirname8, extname as extname7, isAbsolute as isAbsolute6, resolve as resolve6 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
@@ -16640,7 +16837,7 @@ var findDefaultExportObject = (sourceFile) => {
 var probeExtension = (base) => {
   for (const extension of COMPONENT_EXTS) {
     const candidate = `${base}.${extension}`;
-    if (existsSync12(candidate)) {
+    if (existsSync11(candidate)) {
       return candidate;
     }
   }
@@ -16819,7 +17016,7 @@ var writeTextAtomic = async (path, text) => {
 };
 
 // src/core/tsconfig-aliases.ts
-import { existsSync as existsSync13 } from "node:fs";
+import { existsSync as existsSync12 } from "node:fs";
 import { parseTsconfig } from "get-tsconfig";
 import { dirname as dirname10, join as join22, resolve as resolve7 } from "pathe";
 var CONFIG_DIR_TEMPLATE = "${configDir}";
@@ -16841,7 +17038,7 @@ var toAlias = (key, value, baseDir, configDir) => {
   };
 };
 var resolveTsconfigAliases = (root) => {
-  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join22(root, name)).find((file) => existsSync13(file));
+  const entry = ["tsconfig.json", "jsconfig.json"].map((name) => join22(root, name)).find((file) => existsSync12(file));
   if (!entry) {
     return {};
   }
@@ -16868,7 +17065,7 @@ var resolveTsconfigAliases = (root) => {
 };
 
 // src/og/derive.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync13 } from "node:fs";
 import { isAbsolute as isAbsolute7, join as join23 } from "pathe";
 var CARD_WEIGHTS = [400, 600];
 var absoluteSrc = (root, src) => isAbsolute7(src) ? src : join23(root, src);
@@ -16972,11 +17169,11 @@ var missingFontFiles = (options, root) => {
       sources.push(absoluteSrc(root, font.src));
     }
   }
-  return [...new Set(sources)].filter((path) => !existsSync14(path));
+  return [...new Set(sources)].filter((path) => !existsSync13(path));
 };
 
 // src/og/logo.ts
-import { existsSync as existsSync15, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync6 } from "node:fs";
 import { join as join24 } from "pathe";
 var resolveOgLogo = (project, source) => {
   if (!source?.toLowerCase().endsWith(".svg")) {
@@ -16986,7 +17183,7 @@ var resolveOgLogo = (project, source) => {
   const file = [
     join24(project.context.root, "public", relative13),
     join24(project.context.root, relative13)
-  ].find((path) => existsSync15(path));
+  ].find((path) => existsSync14(path));
   return file ? readFileSync6(file, "utf-8") : undefined;
 };
 
@@ -17319,7 +17516,11 @@ ${THEME_MAPPING}
     scroll-padding-top: 4.5rem;
     text-rendering: optimizeLegibility;
   }
-  /* Headings use the display font (defaults to the body font when unset). */
+  /* Headings use the display font (defaults to the body font when unset).
+     The tightened tracking is part of the theme, not the font: display-tuned
+     families bake it into their metrics, but a text family promoted to
+     headings (including the Inter default) reads loose without it. -0.05em
+     was matched visually against Inter Tight, the previous display default. */
   h1,
   h2,
   h3,
@@ -17327,6 +17528,7 @@ ${THEME_MAPPING}
   h5,
   h6 {
     font-family: var(--font-display);
+    letter-spacing: -0.05em;
   }
   :focus-visible {
     outline: 2px solid var(--blume-accent);
@@ -17347,6 +17549,13 @@ ${THEME_MAPPING}
   }
 }
 
+/* Same-origin navigations ride Astro's client router (the layouts render
+   ClientRouter), which owns the page-transition styling — including its own
+   prefers-reduced-motion guard — so the theme declares nothing about it. The
+   cross-document view-transition opt-in that briefly lived here is
+   deliberately gone: mixing it with the client router double-animates the
+   full-load navigations the router hands back to the browser. */
+
 /* Code reads left-to-right regardless of page direction; only the surrounding
    chrome mirrors for RTL. Inline code is isolated so LTR identifiers don't
    disturb the bidi flow of right-to-left prose. */
@@ -17382,9 +17591,10 @@ ${THEME_MAPPING}
   line-height: 1.7;
 }
 
+/* No letter-spacing here: prose headings inherit the base h1-h6 rule's
+   display tracking, same as headings outside the prose column. */
 .prose :where(h1, h2, h3, h4) {
   font-weight: 500;
-  letter-spacing: 0;
 }
 
 /* A heading can carry one long unbreakable token — an OpenAPI operation's title
@@ -18125,7 +18335,7 @@ import { glob as glob6 } from "tinyglobby";
 // src/astro/islands.ts
 import { readFile as readFile14 } from "node:fs/promises";
 import pMap4 from "p-map";
-import { basename as basename2, join as join26 } from "pathe";
+import { basename as basename3, join as join26 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 var DEFAULT_CLIENT = "visible";
 var READ_CONCURRENCY2 = 16;
@@ -18170,7 +18380,7 @@ var discoverIslands = async (root) => {
   const warnings = [];
   const seen = new Map;
   const collectIsland = (file, source) => {
-    const base = basename2(file);
+    const base = basename3(file);
     const ext = base.match(ISLAND_FILE)?.groups?.ext;
     const framework = ext ? FRAMEWORK_BY_EXT2.get(ext) : undefined;
     if (!framework) {
@@ -18298,7 +18508,7 @@ var resolveAstroPackageJson = (modulesDir) => {
   }
 };
 var resolvedAstroHit = (fromDir) => {
-  let dir = normalize3(fromDir);
+  let dir = normalize4(fromDir);
   while (true) {
     const modulesDir = join28(dir, "node_modules");
     const pkg = resolveAstroPackageJson(modulesDir);
@@ -18323,7 +18533,7 @@ var depsCandidates = (pkgDir) => [
   join28(pkgDir, "node_modules"),
   dirname11(pkgDir)
 ];
-var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync16(join28(dir, ...segments))) ?? null;
+var candidateHolding = (pkgDir, ...segments) => depsCandidates(pkgDir).find((dir) => existsSync15(join28(dir, ...segments))) ?? null;
 var linkDepsJunction = async (link, depsDir) => {
   let existing;
   try {
@@ -18459,7 +18669,7 @@ var writeExamplesPreview = async (options) => {
     await write(join28(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
   }
   const cssFile = examplesCssFile(root, config);
-  return cssFile && !existsSync16(cssFile) ? [
+  return cssFile && !existsSync15(cssFile) ? [
     `examples.css points at "${config.examples.css}", which doesn't exist; previews render without it.`
   ] : [];
 };
@@ -18525,7 +18735,7 @@ var pruneOrphans = async (srcDir, written) => {
   });
   const removals = [];
   for (const path of existing) {
-    const normalized = normalize3(path);
+    const normalized = normalize4(path);
     if (!written.has(normalized)) {
       removals.push(rm2(normalized, { force: true }));
     }
@@ -18546,10 +18756,10 @@ var writeStagedContent = async (out, staged) => {
   const written = new Set;
   await Promise.all([...staged].map(async ([entryId, text]) => {
     const path = join28(contentDir, entryId);
-    written.add(normalize3(path));
+    written.add(normalize4(path));
     await writeIfChanged(path, text);
   }));
-  if (existsSync16(contentDir)) {
+  if (existsSync15(contentDir)) {
     await pruneOrphans(contentDir, written);
   }
 };
@@ -18572,7 +18782,7 @@ var readLogoSvg = (project, source) => {
   const file = [
     join28(project.context.root, "public", rel),
     join28(project.context.root, rel)
-  ].find((path) => existsSync16(path));
+  ].find((path) => existsSync15(path));
   return file ? readFileSync8(file, "utf-8") : undefined;
 };
 var isStringShorthand = (value) => typeof value === "string";
@@ -18606,6 +18816,7 @@ var FAVICON_CANDIDATES = [
   "favicon.ico",
   "icon.ico"
 ];
+var darkSibling = (name) => name.replace(/\.(?=[^.]+$)/u, "-dark.");
 var FAVICON_TYPES = new Map([
   ["ico", "image/x-icon"],
   ["jpeg", "image/jpeg"],
@@ -18619,6 +18830,10 @@ var faviconType = (name) => {
 };
 var inlineDataUri = (file, type) => `data:${type};base64,${readFileSync8(file).toString("base64")}`;
 var defaultFavicon = () => ({
+  dark: {
+    href: inlineDataUri(join28(BLUME_SRC, "assets", "icon-dark.png"), "image/png"),
+    type: "image/png"
+  },
   href: inlineDataUri(join28(BLUME_SRC, "assets", "icon.png"), "image/png"),
   type: "image/png"
 });
@@ -18631,20 +18846,43 @@ var APPLE_ICON_CANDIDATES = [
 var resolveIconFile = (project, candidates) => {
   const { root } = project.context;
   for (const name of candidates) {
-    if (existsSync16(join28(root, "public", name))) {
+    if (existsSync15(join28(root, "public", name))) {
       return { href: `/${name}`, type: faviconType(name) };
     }
   }
   for (const name of candidates) {
     const file = join28(root, name);
-    if (existsSync16(file)) {
+    if (existsSync15(file)) {
       const type = faviconType(name);
       return { href: inlineDataUri(file, type ?? "image/x-icon"), type };
     }
   }
   return null;
 };
-var resolveFavicon = (project) => resolveIconFile(project, FAVICON_CANDIDATES) ?? defaultFavicon();
+var resolveFavicon = (project) => {
+  const { root } = project.context;
+  for (const name of FAVICON_CANDIDATES) {
+    if (existsSync15(join28(root, "public", name))) {
+      const type = faviconType(name);
+      const sibling = darkSibling(name);
+      return existsSync15(join28(root, "public", sibling)) ? { dark: { href: `/${sibling}`, type }, href: `/${name}`, type } : { href: `/${name}`, type };
+    }
+  }
+  for (const name of FAVICON_CANDIDATES) {
+    const file = join28(root, name);
+    if (existsSync15(file)) {
+      const type = faviconType(name);
+      const mime = type ?? "image/x-icon";
+      const siblingFile = join28(root, darkSibling(name));
+      return existsSync15(siblingFile) ? {
+        dark: { href: inlineDataUri(siblingFile, mime), type },
+        href: inlineDataUri(file, mime),
+        type
+      } : { href: inlineDataUri(file, mime), type };
+    }
+  }
+  return resolveIconFile(project, FAVICON_CANDIDATES.map(darkSibling)) ?? defaultFavicon();
+};
 var resolveAppleIcon = (project) => resolveIconFile(project, APPLE_ICON_CANDIDATES);
 var resolveBanner = (config) => {
   const { banner } = config;
@@ -18771,6 +19009,7 @@ var buildRuntimeData = (project) => {
         palette: config.seo.og.palette,
         site: resolveOgSite(config)
       },
+      openInChat: config.ai.openInChat,
       repoUrl,
       search: {
         enabled: config.search.provider !== "none",
@@ -18793,7 +19032,7 @@ var buildRuntimeData = (project) => {
       href: feed.path,
       title: feed.title
     })),
-    fontCssVars: configuredCssVars(config.theme.fonts),
+    fontCssVars: configuredFonts(config.theme.fonts),
     navigation: withRepoUrl(graph.navigation),
     navigationByLocale,
     navigationByVersion: Object.fromEntries(Object.entries(graph.navigationByVersion).map(([id2, byLocale]) => [
@@ -18884,6 +19123,30 @@ var writeMcpFiles = async (project, plan, write) => {
     write(join28(plan.dir, "server-card.ts"), staticJsonEndpointTemplate(buildMcpServerCard(discoveryInput)))
   ]);
 };
+var planPlaygroundProxy = (config, srcDir) => ({
+  enabled: config.openapi.enabled && config.openapi.renderer === "blume" && config.openapi.playground.enabled && config.openapi.playground.proxy === true,
+  entrypoint: join28(srcDir, "blume-openapi", "api-proxy.ts"),
+  pattern: "/_api-proxy"
+});
+var specOrigins = (data) => {
+  const origins = new Set;
+  for (const spec of Object.values(data)) {
+    const { servers } = spec.document;
+    for (const server of Array.isArray(servers) ? servers : []) {
+      const url = server.url ?? "";
+      if (url.includes("{")) {
+        continue;
+      }
+      try {
+        origins.add(new URL(url).origin);
+      } catch {}
+    }
+  }
+  return [...origins].toSorted();
+};
+var proxyAllowlistWarnings = (enabled, origins) => enabled && origins.length === 0 ? [
+  "openapi.playground.proxy is enabled, but no spec declares an absolute servers[].url (relative and templated URLs carry no origin), so the proxy's allowlist is empty and it will refuse every request. Add an absolute server URL to the spec, or point playground.proxy at an external proxy URL."
+] : [];
 var writeAskFiles = async (project, srcDir, write) => {
   const { ask } = project.config.ai;
   if (!(ask?.enabled && !ask.endpoint)) {
@@ -18894,7 +19157,10 @@ var writeAskFiles = async (project, srcDir, write) => {
     await write(join28(srcDir, "generated", "ask-data.json"), `${JSON.stringify(await buildAskData(project))}
 `);
   }
-  await write(join28(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, ask.instructions));
+  await write(join28(srcDir, "pages", "api", "ask.ts"), askEndpointTemplate(resolveAskBackend(ask), grounded, {
+    instructions: ask.instructions,
+    retrieval: ask.retrieval
+  }));
 };
 var writeNotFoundPage = async (write, srcDir, pages, contentPages) => {
   if (routeIsTaken(pages, contentPages, "/404")) {
@@ -18942,7 +19208,7 @@ var generateRuntime = async (project) => {
   const openapiPath = join28(srcDir, "generated", "openapi.json");
   const written = new Set;
   const write = (path, content) => {
-    written.add(normalize3(path));
+    written.add(normalize4(path));
     return writeIfChanged(path, content);
   };
   const depsLinkWarning = await ensureDepsLink(out);
@@ -18987,8 +19253,19 @@ var generateRuntime = async (project) => {
   const needsSvelte = frameworks.has("svelte");
   const reactCompilerPath = resolveReactCompiler(config, needsReact);
   const ogRoutes = customOgRoutes(pages, config.title, config.seo.og.titles);
+  const changelogIndex = hasGeneratedChangelog(project, pages);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
+  const openApiSource2 = project.sources.find(isOpenApiSource);
+  const openApiData = openApiSource2 ? openApiSource2.openApiData() : {};
+  const playgroundProxy = planPlaygroundProxy(config, srcDir);
+  if (playgroundProxy.enabled) {
+    pages.push({
+      entrypoint: playgroundProxy.entrypoint,
+      pattern: playgroundProxy.pattern
+    });
+  }
+  const proxyOrigins = specOrigins(openApiData);
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
   const docsCollection = resolveDocsCollection(config, context);
@@ -19053,12 +19330,13 @@ var generateRuntime = async (project) => {
     Promise.all(slotPlan.wrappers.map((wrapper) => write(join28(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
     Promise.all(exampleDiscovery.examples.map((example) => write(join28(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
     writeAskFiles(project, srcDir, write),
-    writeMcpFiles(project, mcp, write)
+    writeMcpFiles(project, mcp, write),
+    playgroundProxy.enabled ? write(playgroundProxy.entrypoint, playgroundProxyTemplate(proxyOrigins)) : Promise.resolve(false)
   ]);
   if (config.seo.og.enabled) {
-    await write(join28(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, projectOgFonts(project)));
+    await write(join28(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes, projectOgFonts(project), changelogIndex));
   }
-  if (hasGeneratedChangelog(project, pages)) {
+  if (changelogIndex) {
     await write(join28(srcDir, "pages", "changelog.astro"), changelogIndexTemplate({
       exportEpub,
       exportPdf,
@@ -19108,6 +19386,7 @@ var generateRuntime = async (project) => {
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
+    ...proxyAllowlistWarnings(playgroundProxy.enabled, proxyOrigins),
     ...reactCompilerWarnings(config, needsReact, reactCompilerPath),
     ...mcp.warnings,
     ...islandDiscovery.warnings,
@@ -19120,7 +19399,7 @@ var generateRuntime = async (project) => {
     ...pages.map((page) => page.pattern),
     ...referenceRoutes(config)
   ]);
-  if (hasGeneratedChangelog(project, pages)) {
+  if (changelogIndex) {
     navTargetRoutes.add("/changelog");
   }
   warnings.push(...[
@@ -19141,10 +19420,9 @@ var generateRuntime = async (project) => {
     warnings.push(...references.warnings);
     await Promise.all(references.files.map((file) => write(join28(srcDir, "pages", file.pagePath), file.content)));
   }
-  const openApiSource2 = project.sources.find(isOpenApiSource);
   await Promise.all([
     write(join28(srcDir, "generated", "data.json"), buildRuntimeData(project)),
-    write(openapiPath, `${JSON.stringify(openApiSource2 ? openApiSource2.openApiData() : {})}
+    write(openapiPath, `${JSON.stringify(openApiData)}
 `),
     write(join28(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
 `),
@@ -19155,7 +19433,7 @@ var generateRuntime = async (project) => {
 };
 
 // src/cli/env.ts
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 import { config } from "dotenv";
 import { dirname as dirname12, join as join29, resolve as resolve9 } from "pathe";
 var loadEnvFiles = (startDir) => {
@@ -19165,7 +19443,7 @@ var loadEnvFiles = (startDir) => {
   while (!done) {
     paths.push(join29(dir, ".env.local"), join29(dir, ".env"));
     const parent = dirname12(dir);
-    done = existsSync17(join29(dir, ".git")) || parent === dir;
+    done = existsSync16(join29(dir, ".git")) || parent === dir;
     dir = parent;
   }
   config({ path: paths, quiet: true });
@@ -19277,17 +19555,17 @@ var emitRedirectFiles = async (config2, distDir) => {
     { content: buildNetlifyRedirects(redirects), name: "_redirects" },
     { content: buildVercelConfig(redirects), name: "vercel.json" }
   ];
-  await Promise.all(platformFiles.map((file) => existsSync18(join30(distDir, file.name)) ? Promise.resolve() : writeFile7(join30(distDir, file.name), file.content, "utf-8")));
+  await Promise.all(platformFiles.map((file) => existsSync17(join30(distDir, file.name)) ? Promise.resolve() : writeFile7(join30(distDir, file.name), file.content, "utf-8")));
   logger.success(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
 var emitHeaderFiles = async (project, distDir) => {
   const { config: config2 } = project;
-  if (!readsHeaderFiles(config2.deployment) || existsSync18(join30(project.context.root, "public", "_headers"))) {
+  if (!readsHeaderFiles(config2.deployment) || existsSync17(join30(project.context.root, "public", "_headers"))) {
     return;
   }
   const ours = buildNetlifyHeaders(config2, buildHomeLinkHeader(config2, markdownRoutePaths(project)));
   const target = join30(distDir, "_headers");
-  const existing = existsSync18(target) ? await readFile17(target, "utf-8") : "";
+  const existing = existsSync17(target) ? await readFile17(target, "utf-8") : "";
   await writeFile7(target, existing ? `${existing.trimEnd()}
 ${ours}` : ours, "utf-8");
   logger.success("Emitted _headers (UTF-8 Content-Type + homepage Link header)");
@@ -19298,12 +19576,12 @@ var emitAgentSkills = async (project, distDir) => {
     return;
   }
   const dir = resolve10(project.context.root, configured);
-  if (!existsSync18(dir)) {
+  if (!existsSync17(dir)) {
     logger.warn(`ai.skills points at "${configured}" (${dir}), which does not exist; no skills published.`);
     return;
   }
   const outDir = join30(distDir, AGENT_SKILLS_DIR.slice(1));
-  if (existsSync18(join30(outDir, "index.json"))) {
+  if (existsSync17(join30(outDir, "index.json"))) {
     return;
   }
   const { skills, warnings } = await collectSkills(dir);
@@ -19337,7 +19615,7 @@ var emitWellKnownFiles = async (config2, distDir) => {
   ];
   for (const file of files) {
     const target = join30(distDir, file.path.slice(1));
-    if (!file.content || existsSync18(target)) {
+    if (!file.content || existsSync17(target)) {
       continue;
     }
     await mkdir8(join30(distDir, ".well-known"), { recursive: true });
@@ -19348,7 +19626,7 @@ var emitWellKnownFiles = async (config2, distDir) => {
 var emitVercelNegotiation = async (project, routePaths, root) => {
   const { config: config2 } = project;
   const configPath = join30(root, ".vercel", "output", "config.json");
-  if (!existsSync18(configPath)) {
+  if (!existsSync17(configPath)) {
     return;
   }
   const overrides = {};
@@ -19373,7 +19651,7 @@ var emitCloudflareNegotiation = async (project, routePaths) => {
   const { config: config2, context } = project;
   const serverDir = join30(context.distDir ?? join30(context.root, "dist"), "server");
   const wranglerPath = join30(serverDir, "wrangler.json");
-  if (!existsSync18(wranglerPath)) {
+  if (!existsSync17(wranglerPath)) {
     warnCloudflareNegotiationSkipped();
     return;
   }
@@ -19404,7 +19682,7 @@ var formatBytes2 = (bytes) => {
 };
 var astroAssets = async (distDir, ext) => {
   const astroDir = join30(distDir, "_astro");
-  if (!existsSync18(astroDir)) {
+  if (!existsSync17(astroDir)) {
     return [];
   }
   const entries = await readdir2(astroDir);
@@ -19481,8 +19759,8 @@ var isolatedStaticDir = (config2, context) => {
 var publishLlmsFiles = async (project, distDir) => {
   const indexPath = join30(distDir, "llms.txt");
   const fullPath = join30(distDir, "llms-full.txt");
-  const writeIndex = !existsSync18(indexPath);
-  const writeFull = !existsSync18(fullPath);
+  const writeIndex = !existsSync17(indexPath);
+  const writeFull = !existsSync17(fullPath);
   if (!(writeIndex || writeFull)) {
     return;
   }
@@ -19515,17 +19793,17 @@ var publishBuildArtifacts = async (project, distDir, args) => {
     await publishLlmsFiles(project, distDir);
   }
   const sitemapFiles = buildSitemapFiles(project);
-  if (sitemapFiles && !existsSync18(join30(distDir, "sitemap.xml"))) {
+  if (sitemapFiles && !existsSync17(join30(distDir, "sitemap.xml"))) {
     await Promise.all(sitemapFiles.map((file) => writeFile7(join30(distDir, file.name), file.xml, "utf-8")));
     logger.success(sitemapFiles.length === 1 ? "Generated sitemap.xml" : `Generated sitemap.xml (index of ${sitemapFiles.length - 1} sitemap files)`);
   }
   const robots = buildRobots(project);
-  if (robots && !existsSync18(join30(distDir, "robots.txt"))) {
+  if (robots && !existsSync17(join30(distDir, "robots.txt"))) {
     await writeFile7(join30(distDir, "robots.txt"), robots, "utf-8");
     logger.success("Generated robots.txt");
   }
   const agentReadability = buildAgentReadability(project);
-  if (agentReadability && !existsSync18(join30(distDir, "agent-readability.json"))) {
+  if (agentReadability && !existsSync17(join30(distDir, "agent-readability.json"))) {
     await writeFile7(join30(distDir, "agent-readability.json"), `${JSON.stringify(agentReadability, null, 2)}
 `, "utf-8");
     logger.success("Generated agent-readability.json");
@@ -19658,7 +19936,7 @@ var buildCommand = defineCommand3({
 });
 
 // src/cli/commands/check.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 import { check } from "@astrojs/check";
 import { sync } from "astro";
 import { defineCommand as defineCommand4 } from "citty";
@@ -19704,7 +19982,7 @@ var checkCommand = defineCommand4({
       minimumFailingSeverity: "error",
       minimumSeverity: "hint",
       root: outDir,
-      tsconfig: existsSync19(tsconfig) ? tsconfig : undefined,
+      tsconfig: existsSync18(tsconfig) ? tsconfig : undefined,
       watch: false
     });
     if (failed) {
@@ -19986,13 +20264,13 @@ import { defineCommand as defineCommand7 } from "citty";
 import { relative as relative17 } from "pathe";
 
 // src/registry/eject.ts
-import { existsSync as existsSync20 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 import { cp as cp2, mkdir as mkdir9, readFile as readFile18, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
 import { join as join33, relative as relative15 } from "pathe";
 var toPosix = (path) => path.split("\\").join("/");
 var LOCAL_BLUME_SOURCE = "../../node_modules/blume/src/**/*.{astro,ts,tsx}";
 var blumeSourceGlob = (root, genDir, resolveBlumeRoot = packageRoot) => {
-  if (existsSync20(join33(root, "node_modules", "blume"))) {
+  if (existsSync19(join33(root, "node_modules", "blume"))) {
     return LOCAL_BLUME_SOURCE;
   }
   try {
@@ -20011,7 +20289,7 @@ var askFiles = async (project, srcDir, genDir) => {
   const { ask } = project.config.ai;
   if (!(ask?.enabled && !ask.endpoint)) {
     const endpointPath = join33(srcDir, "pages", "api", "ask.ts");
-    if (existsSync20(endpointPath)) {
+    if (existsSync19(endpointPath)) {
       const content = await readFile18(endpointPath, "utf-8");
       if (content.startsWith("// Generated by Blume. Do not edit.")) {
         await rm3(endpointPath, { force: true });
@@ -20023,7 +20301,10 @@ var askFiles = async (project, srcDir, genDir) => {
   const grounded = ask.provider !== "inkeep";
   const files = [
     {
-      content: askEndpointTemplate(resolveAskBackend(ask), grounded, ask.instructions),
+      content: askEndpointTemplate(resolveAskBackend(ask), grounded, {
+        instructions: ask.instructions,
+        retrieval: ask.retrieval
+      }),
       path: join33(srcDir, "pages", "api", "ask.ts")
     }
   ];
@@ -20093,7 +20374,7 @@ var changelogFiles = (project, userPages, srcDir, options) => {
     }
   ];
 };
-var readExamplesCss = (root, css) => css && existsSync20(join33(root, css)) ? readFile18(join33(root, css), "utf-8") : Promise.resolve("");
+var readExamplesCss = (root, css) => css && existsSync19(join33(root, css)) ? readFile18(join33(root, css), "utf-8") : Promise.resolve("");
 var examplesPreviewFiles = (srcDir, basePath, hasExamples) => hasExamples ? [
   {
     content: examplesPageTemplate(),
@@ -20332,13 +20613,13 @@ var eject = async (root) => {
   for (const [entryId, content] of staged) {
     files.push({ content, path: join33(root, stagedDir, entryId) });
   }
-  const written = files.filter((file) => !(file.skipIfExists && existsSync20(file.path)));
+  const written = files.filter((file) => !(file.skipIfExists && existsSync19(file.path)));
   await Promise.all(written.map(async (file) => {
     await mkdir9(join33(file.path, ".."), { recursive: true });
     await writeFile8(file.path, file.content, "utf-8");
   }));
   const assetsSrc = join33(context.outDir, "public", "blume-assets");
-  if (existsSync20(assetsSrc)) {
+  if (existsSync19(assetsSrc)) {
     await cp2(assetsSrc, join33(root, "public", "blume-assets"), {
       recursive: true
     });
@@ -20395,10 +20676,10 @@ var updatePackageScripts = async (root) => {
 };
 
 // src/cli/init/scaffold.ts
-import { existsSync as existsSync21 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { mkdir as mkdir10, writeFile as writeFile10 } from "node:fs/promises";
 import { detect } from "package-manager-detector/detect";
-import { basename as basename4, dirname as dirname14, isAbsolute as isAbsolute9, join as join35, relative as relative16 } from "pathe";
+import { basename as basename5, dirname as dirname14, isAbsolute as isAbsolute9, join as join35, relative as relative16 } from "pathe";
 
 // src/core/package-json.ts
 var toPackageName = (raw) => raw.toLowerCase().replaceAll(/[^a-z0-9._-]+/gu, "-").replaceAll(/^[-_.]+|[-_.]+$/gu, "") || "docs";
@@ -20607,7 +20888,7 @@ var extraDepsFor = (sources) => {
 var buildPlan = (root, answers) => {
   const files = [
     {
-      content: blumePackageJson(toPackageName(basename4(root)), extraDepsFor(answers.sources)),
+      content: blumePackageJson(toPackageName(basename5(root)), extraDepsFor(answers.sources)),
       path: join35(root, "package.json")
     },
     { content: buildConfig(answers), path: join35(root, "blume.config.ts") }
@@ -20618,7 +20899,7 @@ var buildPlan = (root, answers) => {
   return files;
 };
 var writeFileSafe = async (file, log) => {
-  if (existsSync21(file.path)) {
+  if (existsSync20(file.path)) {
     log.info(`Skipped existing ${file.path}`);
     return false;
   }
@@ -20629,7 +20910,7 @@ var writeFileSafe = async (file, log) => {
 };
 var applyPlan = async (files, log) => {
   const created = await Promise.all(files.map((file) => writeFileSafe(file, log)));
-  const createdPackage = files.some((file, index) => created[index] && basename4(file.path) === "package.json");
+  const createdPackage = files.some((file, index) => created[index] && basename5(file.path) === "package.json");
   return { createdPackage };
 };
 var envVarsFor = (sources) => [
@@ -20714,7 +20995,7 @@ The blume package remains importable.`);
 });
 
 // src/cli/commands/eval.ts
-import { existsSync as existsSync22 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 import { defineCommand as defineCommand8 } from "citty";
 import { join as join39 } from "pathe";
 
@@ -21438,7 +21719,7 @@ var runFixHandoff = async (agent, result, root, threshold) => {
 };
 var runInit = async (agent, file) => {
   const path = join39(process.cwd(), file);
-  if (existsSync22(path)) {
+  if (existsSync21(path)) {
     logger.error(`${file} already exists — edit it directly, or pass --file to draft elsewhere.`);
     process.exit(1);
   }
@@ -21576,7 +21857,7 @@ import { defineCommand as defineCommand9 } from "citty";
 import { resolve as resolve12 } from "pathe";
 
 // src/cli/init/questions.ts
-import { basename as basename5, resolve as resolve11 } from "pathe";
+import { basename as basename6, resolve as resolve11 } from "pathe";
 var cancelled = (value) => typeof value === "symbol";
 var collectAnswers = async (prompter, flags, defaults) => {
   const directory = flags.directory ?? await prompter.text({
@@ -21589,7 +21870,7 @@ var collectAnswers = async (prompter, flags, defaults) => {
   }
   const root = resolve11(defaults.cwd, directory);
   const title = await prompter.text({
-    initialValue: titleize(basename5(root)),
+    initialValue: titleize(basename6(root)),
     message: "What's your docs site called?",
     validate: (value) => value?.trim() ? undefined : "Give your docs site a name."
   });
@@ -21816,10 +22097,30 @@ var SCHEMA = {
 };
 var toFacetTerms = (facets) => Object.entries(facets).map(([key, value]) => `${key}:${value}`);
 var BOOST = { description: 2, title: 3 };
-var SEGMENTED_LANGUAGES = new Set(["ja", "ko", "th", "zh"]);
-var BIGRAM_LANGUAGES = new Set(["ja", "zh"]);
+var LATIN_SCRIPT = "Latn";
+var parseLocale = (tag) => {
+  const hyphenated = tag.replaceAll("_", "-");
+  try {
+    return new Intl.Locale(hyphenated);
+  } catch {}
+  const [primary = ""] = hyphenated.split("-");
+  try {
+    return new Intl.Locale(primary);
+  } catch {
+    return;
+  }
+};
+var resolveLocale = (tag) => parseLocale(tag)?.maximize();
+var BIGRAM_INDEX_SCRIPTS = new Set(["Hans", "Hant", "Jpan"]);
+var isBigramLanguage = (language) => {
+  const script = resolveLocale(language)?.script;
+  return script !== undefined && BIGRAM_INDEX_SCRIPTS.has(script);
+};
 var BIGRAM_SCRIPTS = /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}々〆〇ーﾞﾟ]+$/u;
 var TERM = /[\p{L}\p{M}\p{N}]+(?:(?:['’](?=\p{L})|(?<=\p{N})[.,](?=\p{N}))[\p{L}\p{M}\p{N}]+)*/gu;
+var LATIN_TERM = /^[\p{Script=Latin}\p{N}'’.,]+$/u;
+var MARKS = /\p{M}+/gu;
+var foldDiacritics = (term) => LATIN_TERM.test(term) ? term.normalize("NFD").replace(MARKS, "") : term;
 var addBigrams = (run, tokens) => {
   const characters = [...run];
   if (characters.length === 1) {
@@ -21836,15 +22137,16 @@ var addBigrams = (run, tokens) => {
 };
 var hasSegmenter = (segmenter) => typeof segmenter === "function";
 var segmentingTokenizer = (locale) => {
-  const language = locale?.toLowerCase().split(/[-_]/u)[0] ?? "";
-  if (!SEGMENTED_LANGUAGES.has(language)) {
+  const resolved = resolveLocale(locale ?? "");
+  if (!resolved?.script || resolved.script === LATIN_SCRIPT) {
     return;
   }
   if (!hasSegmenter(Intl.Segmenter)) {
     return;
   }
+  const { language } = resolved;
   const segmenter = new Intl.Segmenter(language, { granularity: "word" });
-  const bigram = BIGRAM_LANGUAGES.has(language);
+  const bigram = isBigramLanguage(language);
   return {
     language,
     normalizationCache: new Map,
@@ -21863,7 +22165,7 @@ var segmentingTokenizer = (locale) => {
           return;
         }
         flush();
-        tokens.add(term);
+        tokens.add(foldDiacritics(term));
       };
       for (const segment of segmenter.segment(raw.normalize("NFC").toLowerCase())) {
         if (!segment.isWordLike) {
@@ -21916,7 +22218,7 @@ var queryOramaIndex = async (db, term, limit, filters) => {
     term
   };
   const params = Object.keys(where).length > 0 ? { ...unfiltered, where } : unfiltered;
-  const bigrammed = BIGRAM_LANGUAGES.has(db.tokenizer?.language ?? "");
+  const bigrammed = isBigramLanguage(db.tokenizer?.language ?? "");
   const strict = bigrammed ? await search(db, { ...params, threshold: ALL_TOKENS }) : undefined;
   const found = strict && strict.hits.length > 0 ? strict : await search(db, params);
   return found.hits.map((hit) => hit.document);
@@ -22163,7 +22465,7 @@ var mcpStdioCommand = defineCommand10({
 });
 
 // src/cli/commands/preview.ts
-import { existsSync as existsSync23 } from "node:fs";
+import { existsSync as existsSync22 } from "node:fs";
 import { preview } from "astro";
 import { defineCommand as defineCommand11 } from "citty";
 import { join as join40 } from "pathe";
@@ -22180,7 +22482,7 @@ var previewCommand = defineCommand11({
     const root = process.cwd();
     const { config: config2 } = await loadConfig(root);
     const context = resolveProjectContext(root, config2);
-    if (!existsSync23(join40(context.outDir, "astro.config.mjs"))) {
+    if (!existsSync22(join40(context.outDir, "astro.config.mjs"))) {
       logger.error("No build found. Run `blume build` first.");
       process.exit(1);
     }
@@ -22531,7 +22833,7 @@ var createProgressRenderer = (options) => {
 };
 
 // src/translate/run.ts
-import { existsSync as existsSync24 } from "node:fs";
+import { existsSync as existsSync23 } from "node:fs";
 import { mkdtemp as mkdtemp4, readFile as readFile25 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
 import pLimit2 from "p-limit";
@@ -22776,7 +23078,7 @@ var runPageItem = async (item, index, context, ledger) => {
   });
   const sourceText = await readFile25(item.sourcePath, "utf-8");
   const target = context.targets.get(item.locale);
-  const previousTranslation = existsSync24(item.targetPath) ? await readFile25(item.targetPath, "utf-8") : undefined;
+  const previousTranslation = existsSync23(item.targetPath) ? await readFile25(item.targetPath, "utf-8") : undefined;
   const output = await invokeAgent(context, pagePrompt(sourceText, target, context.source, previousTranslation), index);
   if (output.isError) {
     return done("failed", output.detail ?? "agent failed", output.costUsd);
@@ -22897,7 +23199,7 @@ var runTranslate = async (options) => {
 };
 
 // src/translate/work-list.ts
-import { existsSync as existsSync25 } from "node:fs";
+import { existsSync as existsSync24 } from "node:fs";
 import { readFile as readFile26 } from "node:fs/promises";
 import { dirname as dirname16, extname as extname8, join as join45, relative as relative20 } from "pathe";
 var PAGE_EXTENSIONS = new Set([".md", ".mdx"]);
@@ -22979,7 +23281,7 @@ var computeWorkList = async (project, ledger, options = {}) => {
     for (const source of meta.metas) {
       knownSources.add(source.sourceRel);
       const targetDir = dirname16(metaTargetPath(source, locale));
-      const exists = ["meta.ts", "meta.js", "meta.mjs"].some((name) => existsSync25(join45(targetDir, name)));
+      const exists = ["meta.ts", "meta.js", "meta.mjs"].some((name) => existsSync24(join45(targetDir, name)));
       const hash = hashSource(source.raw);
       const stamp = ledger.files[source.sourceRel]?.[locale];
       const entry = (status) => ({
@@ -23211,13 +23513,13 @@ var translateCommand = defineCommand13({
 });
 
 // src/cli/commands/validate.ts
-import { existsSync as existsSync27 } from "node:fs";
+import { existsSync as existsSync26 } from "node:fs";
 import { defineCommand as defineCommand14 } from "citty";
 import { join as join47 } from "pathe";
 
 // src/core/links.ts
-import { existsSync as existsSync26 } from "node:fs";
-import { basename as basename6, join as join46 } from "pathe";
+import { existsSync as existsSync25 } from "node:fs";
+import { basename as basename7, dirname as dirname17, join as join46 } from "pathe";
 var HTTP = /^https?:\/\//iu;
 var PROTOCOL_RELATIVE = /^\/\//u;
 var SCHEME = /^[a-z][a-z0-9+.-]*:/iu;
@@ -23230,9 +23532,9 @@ var decodePercent = (value) => {
 };
 var DOC_EXT = /\.(?:md|mdx)$/iu;
 var FILE_EXT = /\.[a-z0-9]+$/iu;
-var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync26(join46(ctx.publicDir, resolved));
+var assetIsPresent = (resolved, ctx) => ctx.publicDir !== null && existsSync25(join46(ctx.publicDir, resolved));
 var NUMERIC_PREFIX3 = /^\d+[-_.]/u;
-var isIndexPage = (page2) => /^index\.(?:md|mdx)$/iu.test(basename6(page2.navPath).replace(NUMERIC_PREFIX3, ""));
+var isIndexPage = (page2) => /^index\.(?:md|mdx)$/iu.test(basename7(page2.navPath).replace(NUMERIC_PREFIX3, ""));
 var applyRelativePart = (segments, part) => {
   if (part === "" || part === ".") {
     return;
@@ -23281,7 +23583,7 @@ var checkAnchor = (route, fragment, site, ctx) => {
     severity: "warning"
   };
 };
-var checkPathLink = (resolved, fragment, target, site, ctx) => {
+var checkPathLink = (resolved, fragment, page2, link, site, ctx) => {
   const route = toRoute(withBasePath(ctx.basePath, resolved));
   if (ctx.routes.has(route)) {
     return fragment ? checkAnchor(route, fragment, site, ctx) : null;
@@ -23297,6 +23599,18 @@ var checkPathLink = (resolved, fragment, target, site, ctx) => {
     if (assetIsPresent(assetPath, ctx)) {
       return null;
     }
+    if (link.image && page2.sourcePath && isRelativeImageTarget(link.target)) {
+      if (resolveRelativeImage(dirname17(page2.sourcePath), link.target)) {
+        return null;
+      }
+      return {
+        ...site,
+        code: "BLUME_BROKEN_ASSET",
+        message: `Image ${link.target} was not found next to ${basename7(page2.sourcePath)}.`,
+        severity: "warning",
+        suggestion: "Add the file next to the page source or fix the reference."
+      };
+    }
     if (ctx.publicDir === null) {
       return "asset-unchecked";
     }
@@ -23311,7 +23625,7 @@ var checkPathLink = (resolved, fragment, target, site, ctx) => {
   return {
     ...site,
     code: "BLUME_BROKEN_LINK",
-    message: `Broken link to ${target}: no page resolves to ${route}.`,
+    message: `Broken link to ${link.target}: no page resolves to ${route}.`,
     severity: "error",
     suggestion: "Check the path, or create the target page."
   };
@@ -23364,7 +23678,7 @@ var classifyLink = (page2, link, ctx, onExternal) => {
     return fragment ? checkAnchor(page2.route, fragment, site, ctx) : null;
   }
   const resolved = rawPath.startsWith("/") ? rawPath : resolveRelative(page2.route, rawPath, isIndexPage(page2));
-  return checkPathLink(resolved, fragment, target, site, ctx);
+  return checkPathLink(resolved, fragment, page2, link, site, ctx);
 };
 var validateLinks = async (graph, options) => {
   const basePath = options.basePath ?? "";
@@ -23446,7 +23760,7 @@ var validateCommand = defineCommand14({
         basePath: project.config.basePath,
         checkExternal: Boolean(args.external),
         extraRoutes,
-        publicDir: existsSync27(publicDir) ? publicDir : null,
+        publicDir: existsSync26(publicDir) ? publicDir : null,
         redirects: project.config.redirects
       }));
     } catch (error) {
@@ -23480,7 +23794,7 @@ var validateCommand = defineCommand14({
 import { defineCommand as defineCommand15 } from "citty";
 
 // src/core/version-cut.ts
-import { existsSync as existsSync28 } from "node:fs";
+import { existsSync as existsSync27 } from "node:fs";
 import { cp as cp3, readdir as readdir3, readFile as readFile27, rm as rm5 } from "node:fs/promises";
 import { join as join48, relative as relative21 } from "pathe";
 class CutError extends Error {
@@ -23600,7 +23914,7 @@ var cutVersion = async (root, id2, options = {}) => {
     throw new CutError(`Version "${id2}" is already registered in versions.archived.`);
   }
   const dir = join48(contentRoot2, id2);
-  if (existsSync28(dir)) {
+  if (existsSync27(dir)) {
     if (!options.force) {
       throw new CutError(`${dir} already exists — pass --force to overwrite the snapshot.`);
     }
@@ -23753,5 +24067,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=6377B095BFD3F5AE64756E2164756E21
+//# debugId=94497B7DFC770E9664756E2164756E21
 //# sourceMappingURL=index.js.map