blume 0.6.7 → 0.7.0

package/dist/cli/index.js

@@ -293,34 +293,38 @@ class BlumeError extends Error {
   }
 }
 var DOCS_BASE = "https://useblume.dev";
+var DOCS_DEPLOYMENT = "/docs/deployment";
+var DOCS_REFERENCE_CLI = "/docs/reference/cli";
+var DOCS_CONTENT_SOURCES = "/docs/content/sources";
+var DOCS_CONTENT_NAVIGATION = "/docs/content/navigation";
 var DOCS_PATHS = {
-  BLUME_ADAPTER_REQUIRED: "/docs/deployment",
-  BLUME_ASSETS_UNCHECKED: "/docs/reference/cli",
-  BLUME_ASSET_FETCH_FAILED: "/docs/content/sources",
-  BLUME_BROKEN_ANCHOR: "/docs/reference/cli",
-  BLUME_BROKEN_ASSET: "/docs/reference/cli",
-  BLUME_BROKEN_LINK: "/docs/reference/cli",
+  BLUME_ADAPTER_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_ASSETS_UNCHECKED: DOCS_REFERENCE_CLI,
+  BLUME_ASSET_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_BROKEN_ANCHOR: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_ASSET: DOCS_REFERENCE_CLI,
+  BLUME_BROKEN_LINK: DOCS_REFERENCE_CLI,
   BLUME_CONFIG_INVALID: "/docs/configuration",
   BLUME_CONFIG_LOAD_FAILED: "/docs/configuration",
-  BLUME_CONTENT_ROOT_MISSING: "/docs/content/sources",
-  BLUME_DEAD_LINK: "/docs/reference/cli",
-  BLUME_DUPLICATE_ROUTE: "/docs/content/navigation",
+  BLUME_CONTENT_ROOT_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_DEAD_LINK: DOCS_REFERENCE_CLI,
+  BLUME_DUPLICATE_ROUTE: 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_MISSING_PAGE: "/docs/content/navigation",
+  BLUME_MISSING_SECRET: DOCS_DEPLOYMENT,
+  BLUME_NAV_DUPLICATE_LABEL: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_HIDDEN_IN_SIDEBAR: DOCS_CONTENT_NAVIGATION,
+  BLUME_NAV_MISSING_PAGE: DOCS_CONTENT_NAVIGATION,
   BLUME_NODE_VERSION: "/docs/quickstart",
-  BLUME_SERVER_FEATURE_REQUIRED: "/docs/deployment",
-  BLUME_SOURCE_FETCH_FAILED: "/docs/content/sources",
-  BLUME_SOURCE_MISCONFIGURED: "/docs/content/sources",
-  BLUME_SOURCE_OFFLINE: "/docs/content/sources",
-  BLUME_SOURCE_SDK_MISSING: "/docs/content/sources",
-  BLUME_SOURCE_UNAVAILABLE: "/docs/content/sources",
+  BLUME_SERVER_FEATURE_REQUIRED: DOCS_DEPLOYMENT,
+  BLUME_SOURCE_FETCH_FAILED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_MISCONFIGURED: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_OFFLINE: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_SDK_MISSING: DOCS_CONTENT_SOURCES,
+  BLUME_SOURCE_UNAVAILABLE: DOCS_CONTENT_SOURCES,
   BLUME_UNKNOWN_COMPONENT: "/docs/configuration/customization",
-  BLUME_UNKNOWN_ICON: "/docs/content/navigation"
+  BLUME_UNKNOWN_ICON: DOCS_CONTENT_NAVIGATION
 };
 var resolveDocsUrl = (code) => {
   const path = DOCS_PATHS[code];
@@ -329,21 +333,30 @@ var resolveDocsUrl = (code) => {
 var enrichDiagnostic = (diagnostic) => diagnostic.docsUrl ? diagnostic : { ...diagnostic, docsUrl: resolveDocsUrl(diagnostic.code) };
 var REGEXP_SPECIAL = /[$()*+.?[\\\]^{|}]/gu;
 var escapeRegExp = (value) => value.replaceAll(REGEXP_SPECIAL, String.raw`\$&`);
+var stepSegment = (source, segment, cursor) => {
+  if (typeof segment !== "string") {
+    return { index: -1, next: cursor, stop: false };
+  }
+  const matcher = new RegExp(`(?<![\\w$])${escapeRegExp(segment)}\\s*[:=]`, "gu");
+  matcher.lastIndex = cursor;
+  const match = matcher.exec(source);
+  if (!match) {
+    return { index: -1, next: cursor, stop: true };
+  }
+  return { index: match.index, next: matcher.lastIndex, stop: false };
+};
 var locatePath = (source, path) => {
   let cursor = 0;
   let found = -1;
   for (const segment of path) {
-    if (typeof segment !== "string") {
-      continue;
-    }
-    const matcher = new RegExp(`(?<![\\w$])${escapeRegExp(segment)}\\s*[:=]`, "gu");
-    matcher.lastIndex = cursor;
-    const match = matcher.exec(source);
-    if (!match) {
+    const step = stepSegment(source, segment, cursor);
+    if (step.stop) {
       break;
     }
-    found = match.index;
-    cursor = matcher.lastIndex;
+    cursor = step.next;
+    if (step.index >= 0) {
+      found = step.index;
+    }
   }
   if (found < 0) {
     return;
@@ -519,6 +532,34 @@ import { build } from "astro";
 import { defineCommand as defineCommand2 } from "citty";
 import { join as join24 } from "pathe";
 
+// src/core/base-path.ts
+var normalizeBasePath = (input) => {
+  if (!input) {
+    return "";
+  }
+  const trimmed = input.trim().replaceAll(/^\/+|\/+$/gu, "").replaceAll(/\/{2,}/gu, "/");
+  return trimmed === "" ? "" : `/${trimmed}`;
+};
+var isInternalPath = (target) => target.startsWith("/") && !target.startsWith("//");
+var withBasePath = (basePath, route) => {
+  if (!basePath || !isInternalPath(route)) {
+    return route;
+  }
+  if (route === basePath || route.startsWith(`${basePath}/`)) {
+    return route;
+  }
+  return route === "/" ? basePath : `${basePath}${route}`;
+};
+var stripBasePath = (basePath, route) => {
+  if (!basePath) {
+    return route;
+  }
+  if (route === basePath) {
+    return "/";
+  }
+  return route.startsWith(`${basePath}/`) ? route.slice(basePath.length) : route;
+};
+
 // src/deploy/xml.ts
 var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
 
@@ -540,6 +581,8 @@ var buildRssFeeds = (project) => {
     return [];
   }
   const base = site.replace(/\/$/u, "");
+  const deployBase = normalizeBasePath(config.deployment.base);
+  const rootLink = `${base}${deployBase}`;
   const feeds = [];
   for (const type of rss.types) {
     const pages = project.graph.pages.filter((page) => page.contentType === type && !(page.meta.draft || page.meta.sidebar.hidden));
@@ -549,13 +592,13 @@ var buildRssFeeds = (project) => {
     const items = pages.map((page) => ({
       date: pageDate(page),
       description: page.description,
-      link: encodeURI(`${base}${page.route}`),
+      link: encodeURI(`${base}${withBasePath(deployBase, page.route)}`),
       title: page.title
     })).toSorted((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0)).slice(0, rss.limit);
     feeds.push({
       description: config.description,
       items,
-      link: base,
+      link: rootLink,
       path: `/${type}/rss.xml`,
       title: `${config.title} — ${capitalize(type)}`,
       type
@@ -581,11 +624,12 @@ ${parts.join(`
   </item>`;
 };
 var renderRssFeed = (feed) => {
+  const feedSelfHref = `${feed.link}${feed.path}`;
   const channel = [
     `  <title>${escapeXml(feed.title)}</title>`,
     `  <link>${escapeXml(feed.link)}</link>`,
     `  <description>${escapeXml(feed.description ?? feed.title)}</description>`,
-    `  <atom:link href="${escapeXml(`${feed.link}${feed.path}`)}" rel="self" type="application/rss+xml" />`
+    `  <atom:link href="${escapeXml(feedSelfHref)}" rel="self" type="application/rss+xml" />`
   ];
   const items = feed.items.map(renderItem).join(`
 `);
@@ -618,7 +662,8 @@ var buildAgentReadability = (project) => {
     return null;
   }
   const site = config.deployment.site ?? null;
-  const abs = (path) => site ? `${site.replace(/\/+$/u, "")}${path}` : path;
+  const deployBase = normalizeBasePath(config.deployment.base);
+  const abs = (path) => site ? `${site.replace(/\/+$/u, "")}${withBasePath(deployBase, path)}` : path;
   const artifacts = {
     markdown: {
       contentNegotiation: "text/markdown",
@@ -700,11 +745,11 @@ var readEntryText = async (ctx, page) => {
 };
 
 // src/ai/llms.ts
-var pageUrl = (route, site) => {
+var pageUrl = (route, site, base = "") => {
   if (!site) {
     return route;
   }
-  return `${site.replace(/\/$/u, "")}${route}`;
+  return `${site.replace(/\/$/u, "")}${withBasePath(base, route)}`;
 };
 var orderedPages = (project) => [...project.graph.pages].filter((page) => !page.meta.draft).sort((a, b) => a.route.localeCompare(b.route));
 var buildIndex = (project) => {
@@ -716,7 +761,7 @@ var buildIndex = (project) => {
   }
   lines.push("", "## Docs", "");
   for (const page of orderedPages(project)) {
-    const url = pageUrl(page.route, site);
+    const url = pageUrl(page.route, site, normalizeBasePath(config.deployment.base));
     const summary = page.description ? `: ${page.description}` : "";
     lines.push(`- [${page.title}](${url})${summary}`);
   }
@@ -730,7 +775,7 @@ var buildFull = async (project) => {
   const sections = await Promise.all(pages.map(async (page) => {
     const raw = await readEntryText(project, page);
     const body = frontmatter_default(raw).content.trim();
-    const url = pageUrl(page.route, config.deployment.site);
+    const url = pageUrl(page.route, config.deployment.site, normalizeBasePath(config.deployment.base));
     return [`# ${page.title}`, `Source: ${url}`, "", body].join(`
 `);
   }));
@@ -761,7 +806,10 @@ var ensureGitignore = async (root, entries) => {
   const path = join5(root, ".gitignore");
   const existing = existsSync3(path) ? await readFile3(path, "utf-8") : "";
   const present = new Set(existing.split(`
-`).map(gitignoreKey).filter(Boolean));
+`).flatMap((line) => {
+    const key = gitignoreKey(line);
+    return key ? [key] : [];
+  }));
   const added = entries.filter((entry) => !present.has(gitignoreKey(entry)));
   if (added.length === 0) {
     return [];
@@ -881,6 +929,11 @@ var surfaceAdapterOutput = async (config, context) => {
 };
 
 // src/deploy/redirects.ts
+var applyBaseToRedirects = (redirects, basePath) => basePath ? redirects.map((redirect) => ({
+  ...redirect,
+  from: withBasePath(basePath, redirect.from),
+  to: withBasePath(basePath, redirect.to)
+})) : redirects;
 var buildNetlifyRedirects = (redirects) => `${redirects.map((redirect) => `${redirect.from} ${redirect.to} ${redirect.status}`).join(`
 `)}
 `;
@@ -925,7 +978,8 @@ var buildRobots = (project) => {
   lines.push("Allow: /");
   const { site } = config.deployment;
   if (site && config.seo.sitemap) {
-    lines.push("", `Sitemap: ${site.replace(/\/$/u, "")}/sitemap.xml`);
+    const sitemapPath = withBasePath(normalizeBasePath(config.deployment.base), "/sitemap.xml");
+    lines.push("", `Sitemap: ${site.replace(/\/$/u, "")}${sitemapPath}`);
   }
   return `${lines.join(`
 `)}
@@ -946,7 +1000,16 @@ var buildSitemap = (project) => {
     return null;
   }
   const base = site.replace(/\/$/u, "");
-  const urls = project.graph.pages.filter((page) => !(page.meta.draft || page.meta.sidebar.hidden || page.meta.seo.noindex)).map((page) => `  <url><loc>${escapeXml(encodeURI(`${base}${page.route}`))}</loc>${lastmodTag(page.lastModified)}</url>`).toSorted();
+  const deployBase = normalizeBasePath(project.config.deployment.base);
+  const urls = [];
+  for (const page of project.graph.pages) {
+    if (page.meta.draft || page.meta.sidebar.hidden || page.meta.seo.noindex) {
+      continue;
+    }
+    const loc = escapeXml(encodeURI(`${base}${withBasePath(deployBase, page.route)}`));
+    urls.push(`  <url><loc>${loc}</loc>${lastmodTag(page.lastModified)}</url>`);
+  }
+  urls.sort();
   return `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 ${urls.join(`
@@ -2736,6 +2799,44 @@ var i18nDiagnostics = (pages, i18n) => {
 // src/core/manifest.ts
 var MANIFEST_VERSION = 1;
 var contentIndexable = (page, config) => !page.meta.search.exclude && (!page.meta.sidebar.hidden || config.search.indexing.includeHiddenPages);
+var buildFallbackRoutes = (graph, i18n, alternatesByKey, basePath) => {
+  const fallback = resolveFallbackLocale(i18n);
+  if (!fallback) {
+    return [];
+  }
+  const fallbackPages = new Map(graph.pages.flatMap((page) => page.locale === fallback ? [[page.translationKey, page]] : []));
+  const routes = [];
+  for (const { code } of i18n.locales) {
+    if (code === fallback) {
+      continue;
+    }
+    const present = new Set(graph.pages.flatMap((page) => page.locale === code ? [page.translationKey] : []));
+    for (const [key, source] of fallbackPages) {
+      if (present.has(key)) {
+        continue;
+      }
+      routes.push({
+        alternates: alternatesByKey.get(key) ?? [],
+        collection: source.collection ?? "docs",
+        contentType: source.contentType,
+        draft: source.meta.draft,
+        editUrl: source.editUrl,
+        entryId: source.entryId ?? source.source.ref,
+        fallback: true,
+        hidden: source.meta.sidebar.hidden,
+        id: source.id,
+        indexable: false,
+        lastModified: source.lastModified,
+        locale: code,
+        path: withBasePath(basePath, localizeRoute(key, code, i18n)),
+        source: source.source,
+        sourcePath: source.sourcePath,
+        title: source.title
+      });
+    }
+  }
+  return routes;
+};
 var buildManifest = (options) => {
   const { context, config, graph } = options;
   const searchEnabled = config.search.provider !== "none";
@@ -2766,39 +2867,7 @@ var buildManifest = (options) => {
     title: page.title
   }));
   if (i18n) {
-    const fallback = resolveFallbackLocale(i18n);
-    if (fallback) {
-      const fallbackPages = new Map(graph.pages.filter((page) => page.locale === fallback).map((page) => [page.translationKey, page]));
-      for (const { code } of i18n.locales) {
-        if (code === fallback) {
-          continue;
-        }
-        const present = new Set(graph.pages.filter((page) => page.locale === code).map((page) => page.translationKey));
-        for (const [key, source] of fallbackPages) {
-          if (present.has(key)) {
-            continue;
-          }
-          routes.push({
-            alternates: alternatesByKey.get(key) ?? [],
-            collection: source.collection ?? "docs",
-            contentType: source.contentType,
-            draft: source.meta.draft,
-            editUrl: source.editUrl,
-            entryId: source.entryId ?? source.source.ref,
-            fallback: true,
-            hidden: source.meta.sidebar.hidden,
-            id: source.id,
-            indexable: false,
-            lastModified: source.lastModified,
-            locale: code,
-            path: localizeRoute(key, code, i18n),
-            source: source.source,
-            sourcePath: source.sourcePath,
-            title: source.title
-          });
-        }
-      }
-    }
+    routes.push(...buildFallbackRoutes(graph, i18n, alternatesByKey, config.basePath));
   }
   routes.sort((a, b) => a.path.localeCompare(b.path));
   return {
@@ -2826,8 +2895,7 @@ var toPlainText = (markdown) => {
   let cursor = 0;
   for (const match of withoutBlocks.matchAll(INLINE_CODE)) {
     const start = match.index ?? 0;
-    pieces.push(withoutBlocks.slice(cursor, start).replaceAll(HTML_OR_JSX, " "));
-    pieces.push(match.groups?.code ?? "");
+    pieces.push(withoutBlocks.slice(cursor, start).replaceAll(HTML_OR_JSX, " "), match.groups?.code ?? "");
     cursor = start + match[0].length;
   }
   pieces.push(withoutBlocks.slice(cursor).replaceAll(HTML_OR_JSX, " "));
@@ -2961,7 +3029,12 @@ var syncTypesense = async (records, config) => {
     ]
   });
   const collection = client.collections(config.collection);
-  const exists = await collection.retrieve().then(() => true).catch(() => false);
+  let exists = true;
+  try {
+    await collection.retrieve();
+  } catch {
+    exists = false;
+  }
   if (exists) {
     await collection.delete();
   }
@@ -3124,23 +3197,25 @@ var ownsLock = (outDir) => {
     return false;
   }
 };
-var acquireDevLock = (outDir, port) => {
-  mkdirSync(outDir, { recursive: true });
-  for (;; ) {
-    try {
-      writeFileSync(lockPath(outDir), lockPayload(port), { flag: "wx" });
-      break;
-    } catch (error) {
-      if (error.code !== "EEXIST") {
-        throw error;
-      }
-      const existing = readDevLock(outDir);
-      if (existing && existing.pid !== process.pid) {
-        throw new DevLockHeldError(existing);
-      }
-      rmSync(lockPath(outDir), { force: true });
+var tryClaimLock = (outDir, port) => {
+  try {
+    writeFileSync(lockPath(outDir), lockPayload(port), { flag: "wx" });
+    return true;
+  } catch (error) {
+    if (error.code !== "EEXIST") {
+      throw error;
+    }
+    const existing = readDevLock(outDir);
+    if (existing && existing.pid !== process.pid) {
+      throw new DevLockHeldError(existing);
     }
+    rmSync(lockPath(outDir), { force: true });
+    return false;
   }
+};
+var acquireDevLock = (outDir, port) => {
+  mkdirSync(outDir, { recursive: true });
+  while (!tryClaimLock(outDir, port)) {}
   let released = false;
   return () => {
     if (released) {
@@ -3180,7 +3255,7 @@ import {
   writeFile as writeFile6
 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
-import { pathToFileURL as pathToFileURL2 } from "node:url";
+import { pathToFileURL as pathToFileURL3 } from "node:url";
 import { basename as basename2, dirname as dirname8, join as join22, normalize as normalize3, relative as relative8 } from "pathe";
 import { glob as glob5 } from "tinyglobby";
 
@@ -3203,20 +3278,22 @@ var buildAskData = async (project) => {
 };
 
 // src/ai/ask.ts
+var OPENAI_COMPATIBLE = "openai-compatible";
+var OPENAI_COMPATIBLE_DEP = "@ai-sdk/openai-compatible";
 var ASK_PRESETS = {
   inkeep: {
     apiKeyEnv: "INKEEP_API_KEY",
     baseUrl: "https://api.inkeep.com/v1",
-    kind: "openai-compatible",
+    kind: OPENAI_COMPATIBLE,
     name: "inkeep",
-    runtimeDep: "@ai-sdk/openai-compatible"
+    runtimeDep: OPENAI_COMPATIBLE_DEP
   },
   llmgateway: {
     apiKeyEnv: "LLMGATEWAY_API_KEY",
     baseUrl: "https://api.llmgateway.io/v1",
-    kind: "openai-compatible",
+    kind: OPENAI_COMPATIBLE,
     name: "llmgateway",
-    runtimeDep: "@ai-sdk/openai-compatible"
+    runtimeDep: OPENAI_COMPATIBLE_DEP
   },
   openrouter: {
     apiKeyEnv: "OPENROUTER_API_KEY",
@@ -3240,9 +3317,9 @@ var resolveAskBackend = (ask) => {
   return {
     apiKeyEnv,
     baseUrl: ask?.baseUrl ?? preset?.baseUrl ?? "",
-    kind: "openai-compatible",
+    kind: OPENAI_COMPATIBLE,
     model,
-    name: preset?.name ?? "openai-compatible"
+    name: preset?.name ?? OPENAI_COMPATIBLE
   };
 };
 var askBackendRuntimeDep = (ask) => {
@@ -3250,7 +3327,7 @@ var askBackendRuntimeDep = (ask) => {
   if (provider === "gateway") {
     return;
   }
-  return ASK_PRESETS[provider]?.runtimeDep ?? "@ai-sdk/openai-compatible";
+  return ASK_PRESETS[provider]?.runtimeDep ?? OPENAI_COMPATIBLE_DEP;
 };
 
 // src/ai/markdown.ts
@@ -3276,14 +3353,20 @@ var buildMcpData = async (project) => {
     buildRawMarkdown(project)
   ]);
   const descriptionById = new Map(graph.pages.map((page) => [page.id, page.description]));
-  const routes = manifest.routes.filter((route) => !route.hidden).map((route) => ({
-    contentType: route.contentType,
-    description: descriptionById.get(route.id),
-    indexable: route.indexable,
-    lastModified: route.lastModified ?? null,
-    route: route.path,
-    title: route.title
-  }));
+  const routes = [];
+  for (const route of manifest.routes) {
+    if (route.hidden) {
+      continue;
+    }
+    routes.push({
+      contentType: route.contentType,
+      description: descriptionById.get(route.id),
+      indexable: route.indexable,
+      lastModified: route.lastModified ?? null,
+      route: route.path,
+      title: route.title
+    });
+  }
   return {
     documents: documents.map((doc) => ({
       content: doc.content,
@@ -3424,6 +3507,7 @@ import { existsSync as existsSync7 } from "node:fs";
 import { dirname as dirname5, extname, isAbsolute as isAbsolute2, resolve as resolve3 } from "pathe";
 import ts from "typescript";
 var GROUPS = ["mdx", "layout", "islands"];
+var GROUP_SET = new Set(GROUPS);
 var FRAMEWORK_BY_EXT = {
   jsx: "react",
   svelte: "svelte",
@@ -3459,29 +3543,32 @@ var emptyAnalysis = () => ({
   warnings: []
 });
 var propName = (name) => ts.isIdentifier(name) || ts.isStringLiteral(name) ? name.text : undefined;
+var addImportBindings = (map, statement) => {
+  if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
+    return;
+  }
+  const specifier = statement.moduleSpecifier.text;
+  const clause = statement.importClause;
+  if (!clause) {
+    return;
+  }
+  if (clause.name) {
+    map.set(clause.name.text, { imported: "default", specifier });
+  }
+  const named = clause.namedBindings;
+  if (named && ts.isNamedImports(named)) {
+    for (const element of named.elements) {
+      map.set(element.name.text, {
+        imported: (element.propertyName ?? element.name).text,
+        specifier
+      });
+    }
+  }
+};
 var collectImports = (sourceFile) => {
   const map = new Map;
   for (const statement of sourceFile.statements) {
-    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {
-      continue;
-    }
-    const specifier = statement.moduleSpecifier.text;
-    const clause = statement.importClause;
-    if (!clause) {
-      continue;
-    }
-    if (clause.name) {
-      map.set(clause.name.text, { imported: "default", specifier });
-    }
-    const named = clause.namedBindings;
-    if (named && ts.isNamedImports(named)) {
-      for (const element of named.elements) {
-        map.set(element.name.text, {
-          imported: (element.propertyName ?? element.name).text,
-          specifier
-        });
-      }
-    }
+    addImportBindings(map, statement);
   }
   return map;
 };
@@ -3539,33 +3626,36 @@ var resolveIdentifier = (name, imports, dir) => {
   const binding = imports.get(name);
   return binding ? toImport(binding.specifier, binding.imported, dir) : null;
 };
+var applyDescriptorProperty = (descriptor, property, imports, dir) => {
+  if (ts.isShorthandPropertyAssignment(property)) {
+    if (property.name.text === "component") {
+      descriptor.hadComponent = true;
+      descriptor.source = resolveIdentifier(property.name.text, imports, dir);
+    }
+    return;
+  }
+  if (!ts.isPropertyAssignment(property)) {
+    return;
+  }
+  const name = propName(property.name);
+  const init = property.initializer;
+  if (name === "component") {
+    descriptor.hadComponent = true;
+    if (ts.isStringLiteral(init)) {
+      descriptor.source = toImport(init.text, "default", dir);
+    } else if (ts.isIdentifier(init)) {
+      descriptor.source = resolveIdentifier(init.text, imports, dir);
+    }
+  } else if (name === "client" && ts.isStringLiteral(init) && HYDRATION_MODES.has(init.text)) {
+    descriptor.client = init.text;
+  } else if (name === "media" && ts.isStringLiteral(init)) {
+    descriptor.media = init.text;
+  }
+};
 var readDescriptor = (object, imports, dir) => {
   const descriptor = { hadComponent: false, source: null };
   for (const property of object.properties) {
-    if (ts.isShorthandPropertyAssignment(property)) {
-      if (property.name.text === "component") {
-        descriptor.hadComponent = true;
-        descriptor.source = resolveIdentifier(property.name.text, imports, dir);
-      }
-      continue;
-    }
-    if (!ts.isPropertyAssignment(property)) {
-      continue;
-    }
-    const name = propName(property.name);
-    const init = property.initializer;
-    if (name === "component") {
-      descriptor.hadComponent = true;
-      if (ts.isStringLiteral(init)) {
-        descriptor.source = toImport(init.text, "default", dir);
-      } else if (ts.isIdentifier(init)) {
-        descriptor.source = resolveIdentifier(init.text, imports, dir);
-      }
-    } else if (name === "client" && ts.isStringLiteral(init) && HYDRATION_MODES.has(init.text)) {
-      descriptor.client = init.text;
-    } else if (name === "media" && ts.isStringLiteral(init)) {
-      descriptor.media = init.text;
-    }
+    applyDescriptorProperty(descriptor, property, imports, dir);
   }
   return descriptor;
 };
@@ -3648,6 +3738,22 @@ var normalizeEntry = (entry, group, imports, dir, warnings) => {
   }
   return { identifier: false, key, source: null };
 };
+var collectGroupOverrides = (property, imports, dir, result) => {
+  if (!ts.isPropertyAssignment(property)) {
+    return;
+  }
+  const name = propName(property.name);
+  if (!(name && GROUP_SET.has(name)) || !ts.isObjectLiteralExpression(property.initializer)) {
+    return;
+  }
+  const group = name;
+  for (const entry of property.initializer.properties) {
+    const normalized = normalizeEntry(entry, group, imports, dir, result.warnings);
+    if (normalized) {
+      result[group].push(normalized);
+    }
+  }
+};
 var analyzeComponentOverrides = (source, filePath) => {
   const result = emptyAnalysis();
   const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true, filePath.endsWith("tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
@@ -3658,20 +3764,7 @@ var analyzeComponentOverrides = (source, filePath) => {
   const imports = collectImports(sourceFile);
   const dir = dirname5(filePath);
   for (const property of object.properties) {
-    if (!ts.isPropertyAssignment(property)) {
-      continue;
-    }
-    const name = propName(property.name);
-    if (!(name && GROUPS.includes(name)) || !ts.isObjectLiteralExpression(property.initializer)) {
-      continue;
-    }
-    const group = name;
-    for (const entry of property.initializer.properties) {
-      const normalized = normalizeEntry(entry, group, imports, dir, result.warnings);
-      if (normalized) {
-        result[group].push(normalized);
-      }
-    }
+    collectGroupOverrides(property, imports, dir, result);
   }
   return result;
 };
@@ -3739,7 +3832,8 @@ var uiStringsObject = z.object({
   }).default({})
 });
 var uiStringsSchema = uiStringsObject.default({});
-var EN_UI = uiStringsObject.parse({});
+var EN_UI_INPUT = Object.fromEntries(Object.keys(uiStringsObject.shape).map((group) => [group, {}]));
+var EN_UI = uiStringsObject.parse(EN_UI_INPUT);
 var uiStringsOverrideSchema = z.record(z.string(), z.record(z.string(), z.string()));
 var uiLocaleOverridesSchema = z.record(z.string(), uiStringsOverrideSchema);
 var mergeUI = (base, override) => {
@@ -3916,7 +4010,7 @@ var duplicateLabelDiagnostics = (navigation) => {
   return diagnostics;
 };
 var hiddenInSidebarDiagnostics = (navigation, pages) => {
-  const hidden = new Set(pages.filter((page) => page.meta.sidebar.hidden).map((page) => page.id));
+  const hidden = new Set(pages.flatMap((page) => page.meta.sidebar.hidden ? [page.id] : []));
   if (hidden.size === 0) {
     return [];
   }
@@ -4005,26 +4099,34 @@ var resolveReferences = (config) => [
 ];
 var referenceTabs = (config) => resolveReferences(config).map((ref) => ({
   label: ref.label,
-  path: ref.route
+  path: ref.renderer === "blume" ? withBasePath(config.basePath, ref.route) : ref.route
 }));
+var blumeReferenceOf = (ref, seen, usedSlugs) => {
+  if (ref.kind !== "openapi" || ref.renderer !== "blume") {
+    return null;
+  }
+  if (seen.has(ref.route)) {
+    return null;
+  }
+  seen.add(ref.route);
+  let { slug } = ref;
+  let n = 2;
+  while (usedSlugs.has(slug)) {
+    slug = `${ref.slug}-${n}`;
+    n += 1;
+  }
+  usedSlugs.add(slug);
+  return slug === ref.slug ? ref : { ...ref, slug };
+};
 var blumeReferences = (config) => {
   const seen = new Set;
   const usedSlugs = new Set;
   const result = [];
   for (const ref of resolveReferences(config)) {
-    if (ref.kind !== "openapi" || ref.renderer !== "blume") {
-      continue;
-    }
-    if (seen.has(ref.route)) {
-      continue;
-    }
-    seen.add(ref.route);
-    let { slug } = ref;
-    for (let n = 2;usedSlugs.has(slug); n += 1) {
-      slug = `${ref.slug}-${n}`;
+    const accepted = blumeReferenceOf(ref, seen, usedSlugs);
+    if (accepted) {
+      result.push(accepted);
     }
-    usedSlugs.add(slug);
-    result.push(slug === ref.slug ? ref : { ...ref, slug });
   }
   return result;
 };
@@ -4138,6 +4240,7 @@ var isOperation = (value) => typeof value === "object" && value !== null;
 var extractOperations = (document, baseRoute) => {
   const operations = [];
   const tagOrder = [];
+  const tagsSeen = new Set;
   const tagMeta = new Map((document.tags ?? []).map((tag) => [tag.name, tag.description ?? ""]));
   const seen = new Set;
   for (const [path, rawItem] of Object.entries(document.paths ?? {})) {
@@ -4152,7 +4255,8 @@ var extractOperations = (document, baseRoute) => {
       }
       const tag = operation.tags?.[0] ?? UNTAGGED;
       const tagSlug = slugify2(tag) || "operations";
-      if (!tagOrder.includes(tag)) {
+      if (!tagsSeen.has(tag)) {
+        tagsSeen.add(tag);
         tagOrder.push(tag);
       }
       let key = operationKey(method, path, operation.operationId);
@@ -4376,13 +4480,20 @@ var overviewMdx = (spec) => {
       });
     }
   }
-  const tagSections = sections.filter((tag) => operations.some((operation) => operation.tagSlug === tag.slug)).map((tag) => [
-    `## ${mdxSafe(tag.name)}`,
-    ...tag.description.trim() ? [mdxSafe(tag.description.trim())] : [],
-    `<ApiTagOperations source="${spec.slug}" tag="${tag.slug}" />`
-  ].join(`
+  const tagSections = [];
+  for (const tag of sections) {
+    if (!operations.some((operation) => operation.tagSlug === tag.slug)) {
+      continue;
+    }
+    const description = tag.description.trim() ? [mdxSafe(tag.description.trim())] : [];
+    tagSections.push([
+      `## ${mdxSafe(tag.name)}`,
+      ...description,
+      `<ApiTagOperations source="${spec.slug}" tag="${tag.slug}" />`
+    ].join(`
 
 `));
+  }
   return {
     body: [
       withDescription(spec.description, `<ApiOverview source="${spec.slug}" />`),
@@ -4603,7 +4714,8 @@ var releaseToEntry = (release) => {
   };
   const raw = frontmatter_default.stringify(`${body}
 `, data);
-  const ref = `${slugifyTag(release.tag_name) || `release-${release.id}`}.md`;
+  const fallbackRef = `release-${release.id}`;
+  const ref = `${slugifyTag(release.tag_name) || fallbackRef}.md`;
   return {
     body: { format: "md", text: body },
     data,
@@ -4686,42 +4798,36 @@ var githubReleasesSource = (options, ctx) => {
 // src/core/sources/mdx-remote.ts
 var REGEX_SPECIAL = /[.*+?^${}()|[\]\\]/u;
 var escapeChar = (char) => REGEX_SPECIAL.test(char) ? `\\${char}` : char;
+var globToken = (pattern, i) => {
+  const char = pattern[i] ?? "";
+  if (char === "*") {
+    if (pattern[i + 1] === "*") {
+      if (pattern[i + 2] === "/") {
+        return { next: i + 3, source: "(?:.*/)?" };
+      }
+      return { next: i + 2, source: ".*" };
+    }
+    return { next: i + 1, source: "[^/]*" };
+  }
+  if (char === "?") {
+    return { next: i + 1, source: "[^/]" };
+  }
+  if (char === "{") {
+    const end = pattern.indexOf("}", i);
+    if (end !== -1) {
+      const options = pattern.slice(i + 1, end).split(",").map((part) => [...part].map(escapeChar).join("")).join("|");
+      return { next: end + 1, source: `(?:${options})` };
+    }
+  }
+  return { next: i + 1, source: escapeChar(char) };
+};
 var globToRegExp = (pattern) => {
   let source = "";
   let i = 0;
   while (i < pattern.length) {
-    const char = pattern[i] ?? "";
-    if (char === "*") {
-      if (pattern[i + 1] === "*") {
-        i += 2;
-        if (pattern[i] === "/") {
-          i += 1;
-          source += "(?:.*/)?";
-        } else {
-          source += ".*";
-        }
-        continue;
-      }
-      source += "[^/]*";
-      i += 1;
-      continue;
-    }
-    if (char === "?") {
-      source += "[^/]";
-      i += 1;
-      continue;
-    }
-    if (char === "{") {
-      const end = pattern.indexOf("}", i);
-      if (end !== -1) {
-        const options = pattern.slice(i + 1, end).split(",").map((part) => [...part].map(escapeChar).join("")).join("|");
-        source += `(?:${options})`;
-        i = end + 1;
-        continue;
-      }
-    }
-    source += escapeChar(char);
-    i += 1;
+    const token = globToken(pattern, i);
+    source += token.source;
+    i = token.next;
   }
   return new RegExp(`^${source}$`, "u");
 };
@@ -4750,11 +4856,22 @@ var enumerateGithub = async (github, include, doFetch) => {
   }
   const body = await res.json();
   const prefix = base ? `${base}/` : "";
-  const refs = (body.tree ?? []).filter((node) => node.type === "blob" && node.path.startsWith(prefix)).map((node) => node.path.slice(prefix.length)).filter((rel) => matchesInclude(rel, include)).map((rel) => ({
-    editUrl: `https://github.com/${owner}/${repo}/edit/${ref}/${prefix}${rel}`,
-    fetchUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${prefix}${rel}`,
-    ref: rel
-  }));
+  const refs = (body.tree ?? []).flatMap((node) => {
+    if (!(node.type === "blob" && node.path.startsWith(prefix))) {
+      return [];
+    }
+    const rel = node.path.slice(prefix.length);
+    if (!matchesInclude(rel, include)) {
+      return [];
+    }
+    return [
+      {
+        editUrl: `https://github.com/${owner}/${repo}/edit/${ref}/${prefix}${rel}`,
+        fetchUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${prefix}${rel}`,
+        ref: rel
+      }
+    ];
+  });
   return { refs, truncated: body.truncated === true };
 };
 var mdxRemoteSource = (options, ctx) => {
@@ -4767,11 +4884,7 @@ var mdxRemoteSource = (options, ctx) => {
     }
     if (options.files && options.url) {
       const base = options.url.replace(/\/$/u, "");
-      const refs = options.files.filter((ref) => matchesInclude(ref, options.include)).map((ref) => ({
-        editUrl: `${base}/${ref}`,
-        fetchUrl: `${base}/${ref}`,
-        ref
-      }));
+      const refs = options.files.flatMap((ref) => matchesInclude(ref, options.include) ? [{ editUrl: `${base}/${ref}`, fetchUrl: `${base}/${ref}`, ref }] : []);
       return { refs, truncated: false };
     }
     throw new BlumeError({
@@ -5068,32 +5181,33 @@ var configuredCssVars = (fonts) => buildFontEntries(fonts).map((entry) => entry.
 
 // src/core/schema.ts
 var iconName = z2.string().min(1);
+var DEFAULT_CONTENT_GLOB = "**/*.{md,mdx}";
 var hydrationMode = z2.enum(["load", "idle", "visible", "media", "only"]);
 var dateSchema = z2.union([z2.string(), z2.date()]).transform((value) => value instanceof Date ? value.toISOString() : value);
-var sidebarMetaSchema = z2.object({
+var sidebarMetaSchema = z2.strictObject({
   badge: z2.string().optional(),
   hidden: z2.boolean().default(false),
   icon: iconName.optional(),
   label: z2.string().optional(),
   order: z2.number().optional()
-}).strict();
-var seoMetaSchema = z2.object({
+});
+var seoMetaSchema = z2.strictObject({
   canonical: z2.string().url().optional(),
   description: z2.string().optional(),
   image: z2.string().optional(),
   noindex: z2.boolean().default(false),
   title: z2.string().optional()
-}).strict();
-var searchMetaSchema = z2.object({
+});
+var searchMetaSchema = z2.strictObject({
   boost: z2.number().optional(),
   exclude: z2.boolean().default(false),
   tags: z2.array(z2.string()).optional()
-}).strict();
-var changelogMetaSchema = z2.object({
+});
+var changelogMetaSchema = z2.strictObject({
   category: z2.string().optional(),
   date: dateSchema.optional(),
   version: z2.string().optional()
-}).strict();
+});
 var authorSchema = z2.union([
   z2.string(),
   z2.object({
@@ -5101,9 +5215,9 @@ var authorSchema = z2.union([
     image: z2.string().optional(),
     name: z2.string(),
     url: z2.string().optional()
-  }).passthrough()
+  }).catchall(z2.unknown())
 ]);
-var pageMetaBaseSchema = z2.object({
+var pageMetaBaseSchema = z2.strictObject({
   authors: z2.union([authorSchema, z2.array(authorSchema)]).optional(),
   changelog: changelogMetaSchema.optional(),
   date: dateSchema.optional(),
@@ -5120,72 +5234,72 @@ var pageMetaBaseSchema = z2.object({
   slug: z2.string().optional(),
   title: z2.string().optional(),
   type: z2.string().optional()
-}).strict();
+});
 var pageMetaSchema = pageMetaBaseSchema;
 var sidebarDisplaySchema = z2.enum(["flat", "group", "page"]);
-var folderMetaSchema = z2.object({
+var folderMetaSchema = z2.strictObject({
   collapsed: z2.boolean().optional(),
   icon: iconName.optional(),
   order: z2.number().optional(),
   pages: z2.array(z2.string()).optional(),
   title: z2.string().optional()
-}).strict();
+});
 var logoImageSchema = z2.union([
   z2.string(),
-  z2.object({
+  z2.strictObject({
     alt: z2.string().optional(),
     dark: z2.string().optional(),
     light: z2.string().optional()
-  }).strict()
+  })
 ]);
 var logoConfigSchema = z2.union([
   z2.string(),
-  z2.object({
+  z2.strictObject({
     href: z2.string().optional(),
     image: logoImageSchema.optional(),
     text: z2.string().optional()
-  }).strict()
+  })
 ]);
 var bannerConfigSchema = z2.union([
   z2.string(),
-  z2.object({
+  z2.strictObject({
     content: z2.string(),
     dismissible: z2.boolean().default(false),
     id: z2.string().optional(),
-    link: z2.object({ href: z2.string(), text: z2.string() }).strict().optional()
-  }).strict()
+    link: z2.strictObject({ href: z2.string(), text: z2.string() }).optional()
+  })
 ]);
-var filesystemSourceSchema = z2.object({
+var filesystemSourceSchema = z2.strictObject({
   exclude: z2.array(z2.string()).default(["**/_*", "**/.*"]),
-  include: z2.array(z2.string()).default(["**/*.{md,mdx}"]),
+  include: z2.array(z2.string()).default([DEFAULT_CONTENT_GLOB]),
   prefix: z2.string().optional(),
   root: z2.string().default("docs"),
   type: z2.literal("filesystem")
-}).strict();
-var mdxRemoteSourceSchema = z2.object({
+});
+var mdxRemoteSourceSchema = z2.strictObject({
   files: z2.array(z2.string()).optional(),
-  github: z2.object({
+  github: z2.strictObject({
     owner: z2.string(),
     path: z2.string().default(""),
     ref: z2.string().default("main"),
     repo: z2.string()
-  }).strict().optional(),
-  include: z2.array(z2.string()).default(["**/*.{md,mdx}"]),
+  }).optional(),
+  include: z2.array(z2.string()).default([DEFAULT_CONTENT_GLOB]),
   pollInterval: z2.number().positive().optional(),
   prefix: z2.string().optional(),
   type: z2.literal("mdx-remote"),
   url: z2.string().optional()
-}).strict();
+});
 var sanitySourceSchema = z2.object({
   apiVersion: z2.string().optional(),
   dataset: z2.string(),
-  fields: z2.object({
+  fields: z2.strictObject({
     body: z2.string().optional(),
     description: z2.string().optional(),
     lastModified: z2.string().optional(),
     slug: z2.string().optional(),
     title: z2.string().optional()
-  }).strict().optional(),
+  }).optional(),
   pollInterval: z2.number().positive().optional(),
   prefix: z2.string().optional(),
   projectId: z2.string(),
@@ -5196,17 +5310,17 @@ var notionSourceSchema = z2.object({
   database: z2.string(),
   pollInterval: z2.number().positive().optional(),
   prefix: z2.string().optional(),
-  properties: z2.object({
+  properties: z2.strictObject({
     description: z2.string().optional(),
     order: z2.string().optional(),
     slug: z2.string().optional(),
     status: z2.string().optional(),
     title: z2.string().optional()
-  }).strict().optional(),
+  }).optional(),
   publishedValue: z2.string().optional(),
   type: z2.literal("notion")
 });
-var githubReleasesSourceSchema = z2.object({
+var githubReleasesSourceSchema = z2.strictObject({
   drafts: z2.boolean().optional(),
   limit: z2.number().positive().optional(),
   owner: z2.string(),
@@ -5215,7 +5329,7 @@ var githubReleasesSourceSchema = z2.object({
   prereleases: z2.boolean().optional(),
   repo: z2.string(),
   type: z2.literal("github-releases")
-}).strict();
+});
 var customSourceSchema = z2.object({
   source: z2.custom((val) => typeof val === "object" && val !== null && typeof val.load === "function" && typeof val.name === "string", { message: "custom source must be a ContentSource (with name + load)" }),
   type: z2.literal("custom")
@@ -5228,42 +5342,42 @@ var contentSourceSchema = z2.discriminatedUnion("type", [
   notionSourceSchema,
   customSourceSchema
 ]);
-var contentConfigSchema = z2.object({
+var contentConfigSchema = z2.strictObject({
   defaultType: z2.string().default("doc"),
   exclude: z2.array(z2.string()).default(["**/_*", "**/.*"]),
-  include: z2.array(z2.string()).default(["**/*.{md,mdx}"]),
+  include: z2.array(z2.string()).default([DEFAULT_CONTENT_GLOB]),
   pages: z2.string().default("pages"),
   root: z2.string().default("docs"),
   sources: z2.array(contentSourceSchema).optional()
-}).strict();
-var navTabSchema = z2.object({
+});
+var navTabSchema = z2.strictObject({
   icon: iconName.optional(),
-  items: z2.array(z2.object({
+  items: z2.array(z2.strictObject({
     description: z2.string().optional(),
     icon: iconName.optional(),
     label: z2.string(),
     path: z2.string(),
     tag: z2.string().optional()
-  }).strict()).optional(),
+  })).optional(),
   label: z2.string(),
   path: z2.string()
-}).strict();
-var navSelectorItemSchema = z2.object({
+});
+var navSelectorItemSchema = z2.strictObject({
   description: z2.string().optional(),
   icon: iconName.optional(),
   label: z2.string(),
   path: z2.string(),
   tag: z2.string().optional()
-}).strict();
-var navSelectorSchema = z2.object({
+});
+var navSelectorSchema = z2.strictObject({
   items: z2.array(navSelectorItemSchema).default([]),
   kind: z2.enum(["dropdown", "language", "product", "version"]),
   label: z2.string()
-}).strict();
+});
 var directoryModeSchema = z2.enum(["accordion", "card", "none"]);
 var sidebarItemSchema = z2.lazy(() => z2.union([
   z2.string(),
-  z2.object({
+  z2.strictObject({
     badge: z2.string().optional(),
     collapsed: z2.boolean().optional(),
     directory: directoryModeSchema.optional(),
@@ -5273,52 +5387,60 @@ var sidebarItemSchema = z2.lazy(() => z2.union([
     items: z2.array(sidebarItemSchema).optional(),
     label: z2.string(),
     root: z2.string().optional()
-  }).strict()
+  })
 ]));
-var fontSlug = z2.string().refine(isFontSlug, (value) => ({
-  message: `Unknown font "${value}". Supported fonts: ${FONT_SLUGS.join(", ")}.`
-}));
+var fontSlug = z2.string().superRefine((value, ctx) => {
+  if (!isFontSlug(value)) {
+    ctx.addIssue({
+      code: z2.ZodIssueCode.custom,
+      message: `Unknown font "${value}". Supported fonts: ${FONT_SLUGS.join(", ")}.`
+    });
+  }
+});
 var perModeValueSchema = z2.union([
   z2.string(),
-  z2.object({ dark: z2.string().optional(), light: z2.string().optional() }).strict()
+  z2.strictObject({
+    dark: z2.string().optional(),
+    light: z2.string().optional()
+  })
 ]).optional().transform((value) => typeof value === "string" ? { dark: value, light: value } : value);
-var themeConfigSchema = z2.object({
+var themeConfigSchema = z2.strictObject({
   accent: z2.union([
     z2.string(),
-    z2.object({ dark: z2.string(), light: z2.string() }).strict()
+    z2.strictObject({ dark: z2.string(), light: z2.string() })
   ]).default("blue").transform((value) => typeof value === "string" ? { dark: value, light: value } : value),
   action: z2.string().optional(),
   background: perModeValueSchema,
   backgroundImage: perModeValueSchema,
-  fonts: z2.object({
+  fonts: z2.strictObject({
     body: fontSlug.default("inter"),
     display: fontSlug.default("inter-tight"),
     mono: fontSlug.default("ibm-plex-mono")
-  }).strict().default({}),
+  }).default({}),
   layout: z2.enum(["sidebar"]).default("sidebar"),
   mode: z2.enum(["system", "light", "dark"]).default("system"),
   radius: z2.enum(["none", "sm", "md", "lg"]).default("md")
-}).strict();
-var algoliaSearchSchema = z2.object({
+});
+var algoliaSearchSchema = z2.strictObject({
   appId: z2.string(),
   indexName: z2.string(),
   searchApiKey: z2.string()
-}).strict();
-var oramaCloudSearchSchema = z2.object({
+});
+var oramaCloudSearchSchema = z2.strictObject({
   apiKey: z2.string(),
   endpoint: z2.string(),
   indexId: z2.string().optional()
-}).strict();
-var typesenseSearchSchema = z2.object({
+});
+var typesenseSearchSchema = z2.strictObject({
   collection: z2.string(),
   host: z2.string(),
   port: z2.number().int().positive().optional(),
   protocol: z2.enum(["http", "https"]).optional(),
   searchApiKey: z2.string()
-}).strict();
-var mixedbreadSearchSchema = z2.object({
+});
+var mixedbreadSearchSchema = z2.strictObject({
   storeId: z2.string()
-}).strict();
+});
 var searchProviders = [
   "orama",
   "pagefind",
@@ -5335,16 +5457,16 @@ var PROVIDER_CONFIG_KEY = {
   "orama-cloud": "oramaCloud",
   typesense: "typesense"
 };
-var searchConfigSchema = z2.object({
+var searchConfigSchema = z2.strictObject({
   algolia: algoliaSearchSchema.optional(),
-  indexing: z2.object({
+  indexing: z2.strictObject({
     includeHiddenPages: z2.boolean().default(false)
-  }).strict().default({}),
+  }).default({}),
   mixedbread: mixedbreadSearchSchema.optional(),
   oramaCloud: oramaCloudSearchSchema.optional(),
   provider: z2.enum(searchProviders).default("orama"),
   typesense: typesenseSearchSchema.optional()
-}).strict().superRefine((value, ctx) => {
+}).superRefine((value, ctx) => {
   const field = PROVIDER_CONFIG_KEY[value.provider];
   if (field && !value[field]) {
     ctx.addIssue({
@@ -5361,18 +5483,18 @@ var askAiProviders = [
   "inkeep",
   "openai-compatible"
 ];
-var aiConfigSchema = z2.object({
-  ask: z2.object({
+var aiConfigSchema = z2.strictObject({
+  ask: z2.strictObject({
     apiKeyEnv: z2.string().optional(),
     baseUrl: z2.string().url().optional(),
     enabled: z2.boolean().default(false),
     model: z2.string().default("openai/gpt-5.5"),
     provider: z2.enum(askAiProviders).default("gateway"),
-    suggestions: z2.array(z2.object({
+    suggestions: z2.array(z2.strictObject({
       icon: iconName.optional(),
       label: z2.string().min(1)
-    }).strict()).default([])
-  }).strict().superRefine((value, ctx) => {
+    })).default([])
+  }).superRefine((value, ctx) => {
     if (value.provider === "openai-compatible" && !value.baseUrl) {
       ctx.addIssue({
         code: z2.ZodIssueCode.custom,
@@ -5382,51 +5504,51 @@ var aiConfigSchema = z2.object({
     }
   }).optional(),
   llmsTxt: z2.boolean().default(true)
-}).strict();
-var featuredLinkSchema = z2.object({
+});
+var featuredLinkSchema = z2.strictObject({
   href: z2.string(),
   icon: iconName.optional(),
   label: z2.string()
-}).strict();
-var navigationConfigSchema = z2.object({
+});
+var navigationConfigSchema = z2.strictObject({
   featured: z2.array(featuredLinkSchema).default([]),
   repo: z2.boolean().default(true),
   selectors: z2.array(navSelectorSchema).default([]),
   sidebar: z2.union([
     z2.array(sidebarItemSchema),
-    z2.object({
+    z2.strictObject({
       display: sidebarDisplaySchema.default("flat"),
       items: z2.array(sidebarItemSchema).optional()
-    }).strict()
+    })
   ]).default({}).transform((value) => Array.isArray(value) ? { display: "flat", items: value } : value),
   tabs: z2.array(navTabSchema).optional()
-}).strict();
+});
 var exportConfigSchema = z2.union([
   z2.boolean(),
-  z2.object({
+  z2.strictObject({
     epub: z2.boolean().default(false),
     pdf: z2.boolean().default(false)
-  }).strict()
+  })
 ]).transform((value) => typeof value === "boolean" ? { epub: value, pdf: value } : value);
-var mcpConfigSchema = z2.object({
+var mcpConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(false),
   instructions: z2.string().optional(),
   name: z2.string().optional(),
   route: z2.string().default("/mcp")
-}).strict();
-var localeSchema = z2.object({
+});
+var localeSchema = z2.strictObject({
   code: z2.string().min(1),
   dir: z2.enum(["ltr", "rtl"]).default("ltr"),
   label: z2.string()
-}).strict();
-var i18nConfigSchema = z2.object({
+});
+var i18nConfigSchema = z2.strictObject({
   defaultLocale: z2.string().default("en"),
   fallbackLocale: z2.string().nullable().optional(),
   hideDefaultLocalePrefix: z2.boolean().default(true),
   locales: z2.array(localeSchema).min(1),
   parser: z2.enum(["dir", "dot"]).default("dir"),
   ui: uiLocaleOverridesSchema.optional()
-}).strict().superRefine((value, ctx) => {
+}).superRefine((value, ctx) => {
   const codes = new Set(value.locales.map((locale) => locale.code));
   if (!codes.has(value.defaultLocale)) {
     ctx.addIssue({
@@ -5443,46 +5565,46 @@ var i18nConfigSchema = z2.object({
     });
   }
 });
-var analyticsScriptSchema = z2.object({
+var analyticsScriptSchema = z2.strictObject({
   attributes: z2.record(z2.string(), z2.string()).optional(),
   content: z2.string().optional(),
   src: z2.string().optional(),
   strategy: z2.enum(["async", "defer"]).optional()
-}).strict().refine((value) => Boolean(value.src) !== Boolean(value.content), {
+}).refine((value) => Boolean(value.src) !== Boolean(value.content), {
   message: "An analytics script must set exactly one of `src` or `content`."
 });
-var analyticsConfigSchema = z2.object({
-  posthog: z2.object({
+var analyticsConfigSchema = z2.strictObject({
+  posthog: z2.strictObject({
     host: z2.string().optional(),
     key: z2.string()
-  }).strict().optional(),
+  }).optional(),
   scripts: z2.array(analyticsScriptSchema).optional(),
   vercel: z2.boolean().optional()
-}).strict();
-var deploymentConfigSchema = z2.object({
+});
+var deploymentConfigSchema = z2.strictObject({
   adapter: z2.enum(["vercel", "node", "netlify", "cloudflare"]).nullable().default(null),
   base: z2.string().optional(),
   output: z2.enum(["static", "server"]).default("static"),
   site: z2.string().url().optional()
-}).strict();
-var redirectSchema = z2.object({
+});
+var redirectSchema = z2.strictObject({
   from: z2.string(),
   status: z2.union([z2.literal(301), z2.literal(302), z2.literal(307), z2.literal(308)]).default(301),
   to: z2.string()
-}).strict();
-var ogConfigSchema = z2.object({
+});
+var ogConfigSchema = z2.strictObject({
   enabled: z2.boolean().optional()
-}).strict();
-var rssConfigSchema = z2.object({
+});
+var rssConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(true),
   limit: z2.number().int().positive().default(50),
   types: z2.array(z2.string()).default(["blog", "changelog"])
-}).strict();
-var contentSignalsObjectSchema = z2.object({
+});
+var contentSignalsObjectSchema = z2.strictObject({
   aiInput: z2.boolean().default(true),
   aiTrain: z2.boolean().default(true),
   search: z2.boolean().default(true)
-}).strict();
+});
 var contentSignalsSchema = z2.union([z2.boolean(), contentSignalsObjectSchema]).transform((value) => {
   if (value === true) {
     return contentSignalsObjectSchema.parse({});
@@ -5492,7 +5614,7 @@ var contentSignalsSchema = z2.union([z2.boolean(), contentSignalsObjectSchema]).
   }
   return value;
 });
-var seoConfigSchema = z2.object({
+var seoConfigSchema = z2.strictObject({
   agentReadability: z2.boolean().default(true),
   contentSignals: contentSignalsSchema.default(true),
   og: ogConfigSchema.default({}),
@@ -5500,40 +5622,50 @@ var seoConfigSchema = z2.object({
   rss: rssConfigSchema.default({}),
   sitemap: z2.boolean().default(true),
   structuredData: z2.boolean().default(true)
-}).strict();
-var githubConfigSchema = z2.object({
+});
+var githubConfigSchema = z2.strictObject({
   branch: z2.string().default("main"),
   dir: z2.string().optional(),
   owner: z2.string(),
   repo: z2.string()
-}).strict();
-var codeBlockThemeSchema = z2.object({
+});
+var codeBlockThemeSchema = z2.strictObject({
   dark: z2.string().default("github-dark"),
   light: z2.string().default("github-light")
-}).strict();
-var codeBlocksConfigSchema = z2.object({
+});
+var codeBlocksConfigSchema = z2.strictObject({
   theme: codeBlockThemeSchema.default({})
-}).strict();
+});
+var examplesConfigSchema = z2.union([
+  z2.string(),
+  z2.strictObject({
+    css: z2.string().optional(),
+    source: z2.string().default("examples")
+  })
+]).transform((value) => typeof value === "string" ? { source: value } : value);
 var lastModifiedConfigSchema = z2.union([
   z2.boolean(),
-  z2.object({ type: z2.enum(["git", "frontmatter"]).default("git") }).strict()
+  z2.strictObject({ type: z2.enum(["git", "frontmatter"]).default("git") })
 ]);
-var codeConfigSchema = z2.object({
+var codeConfigSchema = z2.strictObject({
   icons: z2.boolean().default(true),
   wrap: z2.boolean().default(false)
-}).strict();
-var markdownConfigSchema = z2.object({
+});
+var markdownConfigSchema = z2.strictObject({
   code: codeConfigSchema.default({}),
   codeBlocks: codeBlocksConfigSchema.default({}),
   headingAnchors: z2.boolean().default(true),
   imageZoom: z2.boolean().default(true)
-}).strict();
-var openapiSourceSchema = z2.object({
+});
+var reactConfigSchema = z2.strictObject({
+  compiler: z2.boolean().default(true)
+});
+var openapiSourceSchema = z2.strictObject({
   label: z2.string().optional(),
   route: z2.string().optional(),
   spec: z2.string()
-}).strict();
-var openapiConfigSchema = z2.object({
+});
+var openapiConfigSchema = z2.strictObject({
   codeSamples: z2.array(z2.string()).default(["curl", "js", "python"]),
   enabled: z2.boolean().default(false),
   expandSchemas: z2.boolean().default(false),
@@ -5542,20 +5674,20 @@ var openapiConfigSchema = z2.object({
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
-}).strict();
-var asyncapiConfigSchema = z2.object({
+});
+var asyncapiConfigSchema = z2.strictObject({
   enabled: z2.boolean().default(false),
   route: z2.string().default("/events"),
   sources: z2.array(openapiSourceSchema).default([]),
   spec: z2.string().optional(),
   theme: z2.string().optional()
-}).strict();
+});
 var tocConfigSchema = z2.union([
   z2.boolean(),
-  z2.object({
+  z2.strictObject({
     maxHeadingLevel: z2.number().int().min(1).max(6).optional(),
     minHeadingLevel: z2.number().int().min(1).max(6).optional()
-  }).strict()
+  })
 ]).default(true).transform((value) => {
   if (typeof value === "boolean") {
     return { enabled: value, maxLevel: 3, minLevel: 2 };
@@ -5566,15 +5698,16 @@ var tocConfigSchema = z2.union([
     minLevel: value.minHeadingLevel ?? 2
   };
 });
-var blumeConfigSchema = z2.object({
+var blumeConfigSchema = z2.strictObject({
   ai: aiConfigSchema.default({}),
   analytics: analyticsConfigSchema.optional(),
   asyncapi: asyncapiConfigSchema.default({}),
   banner: bannerConfigSchema.optional(),
+  basePath: z2.string().optional().transform((value) => normalizeBasePath(value)),
   content: contentConfigSchema.default({}),
   deployment: deploymentConfigSchema.default({}),
   description: z2.string().optional(),
-  examples: z2.string().default("examples"),
+  examples: examplesConfigSchema.default("examples"),
   export: exportConfigSchema.default(false),
   feedback: z2.boolean().default(true),
   github: githubConfigSchema.optional(),
@@ -5585,13 +5718,14 @@ var blumeConfigSchema = z2.object({
   mcp: mcpConfigSchema.default({}),
   navigation: navigationConfigSchema.default({}),
   openapi: openapiConfigSchema.default({}),
+  react: reactConfigSchema.default({}),
   redirects: z2.array(redirectSchema).default([]),
   search: searchConfigSchema.default({}),
   seo: seoConfigSchema.default({}),
   theme: themeConfigSchema.default({}),
   title: z2.string().default("Documentation"),
   toc: tocConfigSchema
-}).strict();
+});
 
 // src/core/sources/normalize.ts
 var NUMERIC_PREFIX = /^\d+[-_.]/u;
@@ -5601,55 +5735,83 @@ var stripNumericPrefix = (segment) => segment.replace(NUMERIC_PREFIX, "");
 var groupLabel = (segment) => segment.match(GROUP_FOLDER)?.groups?.label ?? null;
 var slugify3 = (text) => text.toLowerCase().trim().replaceAll(/[^\w\s-]/gu, "").replaceAll(/[\s_]+/gu, "-").replaceAll(/-+/gu, "-").replaceAll(/^-|-$/gu, "");
 var titleCase = (value) => value.split(WORD_SPLIT).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+var addRouteSegment = (part, segments, groups) => {
+  if (part === "") {
+    return;
+  }
+  const group = groupLabel(part);
+  if (group !== null) {
+    groups.push(group);
+    return;
+  }
+  const clean = stripNumericPrefix(part);
+  if (clean === "index") {
+    return;
+  }
+  segments.push(clean);
+};
 var mapRoute = (relativePath) => {
   const withoutExt = relativePath.slice(0, relativePath.length - extname4(relativePath).length);
   const rawParts = withoutExt.split("/");
   const segments = [];
   const groups = [];
   for (const part of rawParts) {
-    if (part === "") {
-      continue;
-    }
-    const group = groupLabel(part);
-    if (group !== null) {
-      groups.push(group);
-      continue;
-    }
-    const clean = stripNumericPrefix(part);
-    if (clean === "index") {
-      continue;
-    }
-    segments.push(clean);
+    addRouteSegment(part, segments, groups);
   }
   const route = segments.length === 0 ? "/" : `/${segments.join("/")}`;
   return { groups, route, segments };
 };
 var CODE_FENCE2 = /^```/u;
 var ATX_HEADING = /^(?<hashes>#{1,6})\s+(?<text>.+?)(?:\s+#+)?\s*$/u;
+var scanHeadingLine = (line, inFence, slugger, headings) => {
+  if (CODE_FENCE2.test(line.trimStart())) {
+    return !inFence;
+  }
+  if (inFence) {
+    return inFence;
+  }
+  const match = line.match(ATX_HEADING);
+  if (match?.groups) {
+    const depth = match.groups.hashes?.length ?? 1;
+    const text = (match.groups.text ?? "").trim();
+    headings.push({ depth, slug: slugger.slug(text), text });
+  }
+  return inFence;
+};
 var extractHeadings = (body) => {
   const headings = [];
   const slugger = new GithubSlugger;
   let inFence = false;
   for (const line of body.split(`
 `)) {
-    if (CODE_FENCE2.test(line.trimStart())) {
-      inFence = !inFence;
-      continue;
-    }
-    if (inFence) {
-      continue;
-    }
-    const match = line.match(ATX_HEADING);
-    if (match?.groups) {
-      const depth = match.groups.hashes?.length ?? 1;
-      const text = (match.groups.text ?? "").trim();
-      headings.push({ depth, slug: slugger.slug(text), text });
-    }
+    inFence = scanHeadingLine(line, inFence, slugger, headings);
   }
   return headings;
 };
 var MD_LINK = /\[[^\]]*\]\((?<target>[^)\s]+)(?:\s+"[^"]*")?\)/gu;
 var INLINE_CODE2 = /`[^`]*`/gu;
+var scanLinkLine = (line, lineNumber, inFence, links) => {
+  if (CODE_FENCE2.test(line.trimStart())) {
+    return !inFence;
+  }
+  if (inFence) {
+    return inFence;
+  }
+  const masked = line.replaceAll(INLINE_CODE2, (span) => " ".repeat(span.length));
+  for (const match of masked.matchAll(MD_LINK)) {
+    const target = match.groups?.target;
+    if (target === undefined || match.index === undefined) {
+      continue;
+    }
+    const targetOffset = match.index + match[0].indexOf("](") + "](".length;
+    links.push({
+      column: targetOffset + 1,
+      line: lineNumber,
+      target
+    });
+  }
+  return inFence;
+};
 var extractLinks = (body) => {
   const links = [];
   let inFence = false;
@@ -5657,50 +5819,34 @@ var extractLinks = (body) => {
   for (const line of body.split(`
 `)) {
     lineNumber += 1;
-    if (CODE_FENCE2.test(line.trimStart())) {
-      inFence = !inFence;
-      continue;
-    }
-    if (inFence) {
-      continue;
-    }
-    const masked = line.replaceAll(INLINE_CODE2, (span) => " ".repeat(span.length));
-    for (const match of masked.matchAll(MD_LINK)) {
-      const target = match.groups?.target;
-      if (target === undefined || match.index === undefined) {
-        continue;
-      }
-      const targetOffset = match.index + match[0].indexOf("](") + "](".length;
-      links.push({
-        column: targetOffset + 1,
-        line: lineNumber,
-        target
-      });
-    }
+    inFence = scanLinkLine(line, lineNumber, inFence, links);
   }
   return links;
 };
 var DOUBLE_QUOTED = /"[^"]*"/gu;
 var JSX_OPEN = /<(?<tag>[A-Z][A-Za-z0-9]*)/gu;
+var scanTagLine = (line, inFence, tags) => {
+  if (CODE_FENCE2.test(line.trimStart())) {
+    return !inFence;
+  }
+  if (inFence) {
+    return inFence;
+  }
+  const clean = line.replaceAll(INLINE_CODE2, "").replaceAll(DOUBLE_QUOTED, "");
+  for (const match of clean.matchAll(JSX_OPEN)) {
+    const tag = match.groups?.tag;
+    if (tag) {
+      tags.add(tag);
+    }
+  }
+  return inFence;
+};
 var extractComponentTags = (body) => {
   const tags = new Set;
   let inFence = false;
   for (const line of body.split(`
 `)) {
-    if (CODE_FENCE2.test(line.trimStart())) {
-      inFence = !inFence;
-      continue;
-    }
-    if (inFence) {
-      continue;
-    }
-    const clean = line.replaceAll(INLINE_CODE2, "").replaceAll(DOUBLE_QUOTED, "");
-    for (const match of clean.matchAll(JSX_OPEN)) {
-      const tag = match.groups?.tag;
-      if (tag) {
-        tags.add(tag);
-      }
-    }
+    inFence = scanTagLine(line, inFence, tags);
   }
   return [...tags];
 };
@@ -5776,7 +5922,7 @@ var normalizeEntry2 = (entry, ctx) => {
   const pages = locales.map((locale) => ({
     ...base,
     locale,
-    route: i18n ? localizeRoute(logicalRoute, locale, i18n) : logicalRoute
+    route: withBasePath(ctx.basePath ?? "", i18n ? localizeRoute(logicalRoute, locale, i18n) : logicalRoute)
   }));
   return { diagnostics: [], pages };
 };
@@ -5961,7 +6107,10 @@ ${indented}`;
 
 ${nested}`;
     }));
-    const pairs = blocks.map((block, i) => ({ block, text: parts[i] ?? "" })).filter((pair) => pair.text);
+    const pairs = blocks.flatMap((block, i) => {
+      const text = parts[i] ?? "";
+      return text ? [{ block, text }] : [];
+    });
     return pairs.map((pair, i) => {
       if (i === 0) {
         return pair.text;
@@ -6033,14 +6182,15 @@ ${nested}`;
       }
     };
   };
+  const queryDatabase = (client, cursor) => withNotionRetry(() => client.databases.query({
+    database_id: options.database,
+    start_cursor: cursor
+  }));
   const load2 = async (refresh = ctx?.refresh ?? true) => {
     const assetDiagnostics = [];
     const result = await loadWithCache(options.name, cache, async () => {
       const client = await resolveClient();
-      const pages = await collectAll((cursor) => withNotionRetry(() => client.databases.query({
-        database_id: options.database,
-        start_cursor: cursor
-      })));
+      const pages = await collectAll((cursor) => queryDatabase(client, cursor));
       const built = await Promise.all(pages.map((page) => toEntry2(client, page)));
       for (const item of built) {
         assetDiagnostics.push(...item.diagnostics);
@@ -6404,38 +6554,53 @@ import { existsSync as existsSync10, readFileSync as readFileSync4, statSync } f
 import { createRequire as createRequire3 } from "node:module";
 import { pathToFileURL } from "node:url";
 import { dirname as dirname6, isAbsolute as isAbsolute6, join as join17, resolve as resolve6 } from "pathe";
+var scanJsonChar = (text, index, inString) => {
+  const char = text[index];
+  if (inString) {
+    if (char === "\\") {
+      return {
+        append: char + (text[index + 1] ?? ""),
+        inString: true,
+        next: index + 2
+      };
+    }
+    return { append: char ?? "", inString: char !== '"', next: index + 1 };
+  }
+  if (char === '"') {
+    return { append: char, inString: true, next: index + 1 };
+  }
+  if (char === "/" && text[index + 1] === "/") {
+    const newline = text.indexOf(`
+`, index + 2);
+    return {
+      append: "",
+      inString: false,
+      next: newline === -1 ? text.length : newline
+    };
+  }
+  if (char === "/" && text[index + 1] === "*") {
+    const end = text.indexOf("*/", index + 2);
+    return {
+      append: "",
+      inString: false,
+      next: end === -1 ? text.length : end + 2
+    };
+  }
+  return { append: char ?? "", inString: false, next: index + 1 };
+};
 var stripJsonComments = (text) => {
   let out = "";
   let inString = false;
-  for (let index = 0;index < text.length; index += 1) {
-    const char = text[index];
-    if (inString) {
-      out += char;
-      if (char === "\\") {
-        out += text[index + 1] ?? "";
-        index += 1;
-      } else if (char === '"') {
-        inString = false;
-      }
-      continue;
-    }
-    if (char === '"') {
-      inString = true;
-      out += char;
-      continue;
-    }
-    if (char === "/" && text[index + 1] === "/") {
-      const newline = text.indexOf(`
-`, index + 2);
-      index = newline === -1 ? text.length : newline - 1;
-      continue;
-    }
-    if (char === "/" && text[index + 1] === "*") {
-      const end = text.indexOf("*/", index + 2);
-      index = end === -1 ? text.length : end + 1;
-      continue;
-    }
-    out += char;
+  let index = 0;
+  while (index < text.length) {
+    const {
+      append,
+      inString: nextInString,
+      next
+    } = scanJsonChar(text, index, inString);
+    out += append;
+    inString = nextInString;
+    index = next;
   }
   return out;
 };
@@ -6466,10 +6631,10 @@ var resolveExtends = (spec, fromDir) => {
     return candidates.find(isFile) ?? null;
   }
   try {
-    const require_ = createRequire3(pathToFileURL(join17(fromDir, "_.js")).href);
+    const requireFromDir = createRequire3(pathToFileURL(join17(fromDir, "_.js")).href);
     for (const sub of [`${spec}/tsconfig.json`, spec]) {
       try {
-        return require_.resolve(sub);
+        return requireFromDir.resolve(sub);
       } catch {}
     }
   } catch {}
@@ -6542,6 +6707,7 @@ import { isAbsolute as isAbsolute8, join as join19 } from "pathe";
 
 // src/astro/templates.ts
 import { existsSync as existsSync11, readFileSync as readFileSync5 } from "node:fs";
+import { pathToFileURL as pathToFileURL2 } from "node:url";
 import { dirname as dirname7, isAbsolute as isAbsolute7, join as join18, relative as relative5 } from "pathe";
 var WORKSPACE_MARKERS = [
   ".git",
@@ -6632,11 +6798,13 @@ var RENDER_EXTERNAL_DEPS = [
 var renderUserAliases = (aliases) => Object.entries(aliases ?? {}).toSorted(([a], [b]) => b.length - a.length).map(([find, replacement]) => `
         ${JSON.stringify(find)}: ${JSON.stringify(replacement)},`).join("");
 var astroOutDir = (context) => context.distDir ?? `${context.root}/dist`;
+var reactIntegration = (compilerPath) => compilerPath ? `react({ babel: { plugins: [[${JSON.stringify(compilerPath)}, { target: "19" }]] } })` : "react()";
 var astroConfigTemplate = (options) => {
   const { context, config, needsReact, pages, dataPath, themePath } = options;
   const {
     contentRoutes,
     examplesPath,
+    examplesThemePath,
     needsSvelte,
     needsVue,
     openapiPath,
@@ -6663,8 +6831,9 @@ var astroConfigTemplate = (options) => {
       prefixDefaultLocale: !config.i18n.hideDefaultLocalePrefix
     }
   })},` : "";
-  const redirectsOption = config.redirects.length > 0 ? `
-  redirects: ${JSON.stringify(Object.fromEntries(config.redirects.map((redirect) => [
+  const basedRedirects = applyBaseToRedirects(config.redirects, config.basePath);
+  const redirectsOption = basedRedirects.length > 0 ? `
+  redirects: ${JSON.stringify(Object.fromEntries(basedRedirects.map((redirect) => [
     redirect.from,
     { destination: redirect.to, status: redirect.status }
   ])))},` : "";
@@ -6678,18 +6847,21 @@ var astroConfigTemplate = (options) => {
 ` : "";
   const svelteImport = needsSvelte ? `import svelte from "@astrojs/svelte";
 ` : "";
-  const blumeImport = `import { blumeIntegration, prerenderDepsPlugin } from "blume/astro";
+  const blumeImport = `import { blumeIntegration, prerenderDepsPlugin, serverAppResolvePlugin } from "blume/astro";
 `;
   const twoslashImport = `import { transformerTwoslash } from "@shikijs/twoslash";
 `;
   const twoslashTransformer = "transformerTwoslash({ explicitTrigger: true }), ";
+  const contentLinkBase = normalizeBasePath(deployment.base) + config.basePath;
   const integrations = [
     `mdx({ processor: blumeMdxProcessor(${JSON.stringify({
+      basePath: contentLinkBase,
+      codeThemes: config.markdown.codeBlocks.theme,
       headingAnchors: config.markdown.headingAnchors
     })}) })`
   ];
   if (needsReact) {
-    integrations.push("react()");
+    integrations.push(reactIntegration(options.reactCompilerPath));
   }
   if (needsVue) {
     integrations.push("vue()");
@@ -6713,12 +6885,14 @@ export default defineConfig({
   integrations: [${integrations.join(", ")}],
   markdown: {
     processor: blumeMarkdownProcessor(${JSON.stringify({
+    basePath: contentLinkBase,
+    codeThemes: config.markdown.codeBlocks.theme,
     headingAnchors: config.markdown.headingAnchors
   })}),
     shikiConfig: {
       themes: {
-        light: "github-light",
-        dark: "github-dark",
+        light: ${JSON.stringify(config.markdown.codeBlocks.theme.light)},
+        dark: ${JSON.stringify(config.markdown.codeBlocks.theme.dark)},
       },
       defaultColor: false,
       transformers: [${twoslashTransformer}...blumeShikiTransformers(${JSON.stringify({ icons: config.markdown.code.icons })})],
@@ -6726,7 +6900,7 @@ export default defineConfig({
   },
   devToolbar: { enabled: false },
   vite: {
-    plugins: [tailwindcss(), prerenderDepsPlugin()],
+    plugins: [tailwindcss(), prerenderDepsPlugin(), serverAppResolvePlugin()],
     // Blume's render-time deps are forced external on both build environments so
     // native bindings resolve at runtime and isolated linkers don't bundle
     // symlinked store copies (which would surface their children as unresolvable
@@ -6747,6 +6921,7 @@ export default defineConfig({
       alias: {
         "blume:data": ${JSON.stringify(dataPath)},
         "blume:examples": ${JSON.stringify(examplesPath)},
+        "blume:examples-theme": ${JSON.stringify(examplesThemePath)},
         "blume:openapi": ${JSON.stringify(openapiPath)},
         "blume:search-client": ${JSON.stringify(searchClientPath)},
         "blume:theme": ${JSON.stringify(themePath)},${userAliasLines}
@@ -6771,6 +6946,7 @@ export default defineConfig({
 `;
 };
 var stagedContentDir = (outDir) => join18(outDir, "content");
+var astroGlobBase = (base) => isAbsolute7(base) ? pathToFileURL2(base).href : base;
 var contentConfigTemplate = (options) => {
   const { context, config } = options;
   const stagedBase = options.stagedBase ?? stagedContentDir(context.outDir);
@@ -6783,14 +6959,14 @@ var contentConfigTemplate = (options) => {
   const docsPattern = filesystem ? [
     ...includeGlobs,
     ...(excludeGlobs ?? []).map((pattern) => `!${pattern}`),
-    ...BLUME_IGNORE_DIRS.filter((dir) => dir !== ".blume").map((dir) => `!**/${dir}/**`),
+    ...BLUME_IGNORE_DIRS.flatMap((dir) => dir === ".blume" ? [] : [`!**/${dir}/**`]),
     ...outDirIgnore
   ] : [];
   const stagedBlock = options.staged ? `
 const staged = defineCollection({
   loader: glob({
     pattern: ["**/*.{md,mdx}"],
-    base: ${JSON.stringify(stagedBase)},
+    base: ${JSON.stringify(astroGlobBase(stagedBase))},
     generateId: ({ entry }) => entry,
   }),
 });
@@ -6802,7 +6978,7 @@ import { glob } from "astro/loaders";
 const docs = defineCollection({
   loader: glob({
     pattern: ${JSON.stringify(docsPattern)},
-    base: ${JSON.stringify(collectionBase)},
+    base: ${JSON.stringify(astroGlobBase(collectionBase))},
     generateId: ({ entry }) => entry,
   }),
 });
@@ -7178,6 +7354,7 @@ var catchAllPageTemplate = (options) => {
 // Generated by Blume. Do not edit.
 import { getEntry, render } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
+import { withBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 ${askImport}
 import Accordion from "blume/components/content/Accordion.astro";
@@ -7303,13 +7480,16 @@ const ogPath = data.config.og.enabled
   ? \`/og/\${route === "/" ? "index" : route.slice(1)}.png\`
   : null;
 const ogRel = seo.image ?? ogPath;
-// Only absolutize root-relative paths: \`seo.image\` may be an external URL,
-// which must pass through verbatim (mirrors PageLayout's absolutizeOgImage).
+// Absolute URLs also carry the deployment base (the page is served under it):
+// \`site + base + path\`. Only absolutize root-relative paths: \`seo.image\` may be
+// an external URL, which passes through verbatim (mirrors PageLayout).
 const ogImage =
-  ogRel && base && ogRel.startsWith("/") ? \`\${base}\${ogRel}\` : ogRel;
+  ogRel && base && ogRel.startsWith("/") ? \`\${base}\${withBase(ogRel)}\` : ogRel;
 
+const basedRoute = withBase(route);
 const canonical =
-  seo.canonical ?? (base ? \`\${base}\${route === "/" ? "" : route}\` : null);
+  seo.canonical ??
+  (base ? \`\${base}\${basedRoute === "/" ? "" : basedRoute}\` : null);
 
 // Locale resolution. With i18n on, pick the active locale's nav + dictionary,
 // build hreflang alternates, and derive the language-switcher targets.
@@ -7342,7 +7522,10 @@ const contentLocale =
 const contentDir = i18n
   ? (i18n.locales.find((l) => l.code === contentLocale)?.dir ?? "ltr")
   : "ltr";
-const absolute = (path) => base + (path === "/" ? "" : path);
+const absolute = (path) => {
+  const p = withBase(path);
+  return base + (p === "/" ? "" : p);
+};
 
 const localeAlternates =
   i18n && base
@@ -7697,9 +7880,12 @@ import Example from ${JSON.stringify(spec.file)};
 ---
 <Example ${exampleDirective(spec)}{...Astro.props}><slot /></Example>
 `;
-var exampleMapTemplate = (specs) => {
+var examplesRouteBase = (basePath) => `${basePath}/blume-examples`;
+var exampleMapTemplate = (specs, basePath) => {
+  const base = `export const examplesBase = ${JSON.stringify(examplesRouteBase(basePath))};`;
   if (specs.length === 0) {
     return `// Generated by Blume. Do not edit.
+${base}
 export const examples = {};
 `;
   }
@@ -7709,11 +7895,65 @@ export const examples = {};
 `);
   return `// Generated by Blume. Do not edit.
 ${imports}
+${base}
 export const examples = {
 ${entries}
 };
 `;
 };
+var examplesPageTemplate = () => `---
+// Generated by Blume. Do not edit.
+import { examples } from "blume:examples";
+import "blume:examples-theme";
+
+// Prerendered even in server output, like docs content.
+export const prerender = true;
+
+export const getStaticPaths = () =>
+  Object.keys(examples).map((path) => ({ params: { path } }));
+
+const { path } = Astro.params;
+const entry = examples[path];
+const Example = entry.Component;
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="robots" content="noindex" />
+    <title>{path}</title>
+    <script is:inline>
+      (() => {
+        const root = document.documentElement;
+        const apply = (theme) => {
+          root.dataset.theme = theme;
+          root.classList.toggle("dark", theme === "dark");
+        };
+        const stored = () =>
+          localStorage.getItem("blume-theme") ??
+          (matchMedia("(prefers-color-scheme: dark)").matches
+            ? "dark"
+            : "light");
+        try {
+          const host = window.parent.document.documentElement;
+          apply(host.dataset.theme ?? stored());
+          new MutationObserver(() => {
+            apply(host.dataset.theme ?? stored());
+          }).observe(host, { attributeFilter: ["data-theme"] });
+        } catch {
+          apply(stored());
+        }
+      })();
+    </script>
+  </head>
+  <!-- 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>
+  </body>
+</html>
+`;
 var envTemplate = () => `/// <reference path="../.astro/types.d.ts" />
 /// <reference types="astro/client" />
 
@@ -7862,25 +8102,31 @@ var specConfiguration = async (spec, root) => {
     };
   }
 };
+var acceptScalarReference = (ref, seen, contentRoutes, warnings) => {
+  if (ref.renderer !== "scalar") {
+    return null;
+  }
+  if (seen.has(ref.route)) {
+    warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
+    return null;
+  }
+  if (contentRoutes.has(ref.route)) {
+    warnings.push(`API reference route ${ref.route} collides with a content page; skipping the reference there.`);
+    return null;
+  }
+  seen.add(ref.route);
+  return ref;
+};
 var buildReferenceFiles = async (options) => {
   const { config, root, contentRoutes } = options;
   const warnings = [];
   const seen = new Set;
   const accepted = [];
   for (const ref of resolveReferences(config)) {
-    if (ref.renderer !== "scalar") {
-      continue;
-    }
-    if (seen.has(ref.route)) {
-      warnings.push(`Two API reference sources resolve to ${ref.route}; keeping the first.`);
-      continue;
+    const next = acceptScalarReference(ref, seen, contentRoutes, warnings);
+    if (next) {
+      accepted.push(next);
     }
-    if (contentRoutes.has(ref.route)) {
-      warnings.push(`API reference route ${ref.route} collides with a content page; skipping the reference there.`);
-      continue;
-    }
-    seen.add(ref.route);
-    accepted.push(ref);
   }
   const built = await Promise.all(accepted.map(async (ref) => ({
     ref,
@@ -7910,18 +8156,9 @@ var buildReferenceFiles = async (options) => {
 };
 
 // src/theme/entry.ts
-var tailwindEntryTemplate = (options) => `/* Generated by Blume. Do not edit. */
-@import "tailwindcss";
-@plugin "@tailwindcss/typography";
-
-/* Scan Blume's components and the user's project for utility classes. */
-${options.sources.map((source) => `@source "${source}";`).join(`
-`)}
-
-/* Dark mode is driven by data-theme on the <html> element. */
-@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));
-
-:root {
+var DARK_VARIANT = `/* Dark mode is driven by data-theme on the <html> element. */
+@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));`;
+var TOKEN_DEFAULTS = `:root {
   --blume-background: oklch(1 0 0);
   --blume-background-image: none;
   --blume-background-image-repeat: no-repeat;
@@ -7999,9 +8236,8 @@ ${options.sources.map((source) => `@source "${source}";`).join(`
   --blume-code-remove-border: oklch(0.7 0.2 22 / 0.7);
   --blume-code-word: oklch(0.7 0.14 255 / 0.22);
   --blume-code-word-border: oklch(0.7 0.14 255 / 0.55);
-}
-
-@theme inline {
+}`;
+var THEME_MAPPING = `@theme inline {
   --color-background: var(--blume-background);
   --color-foreground: var(--blume-foreground);
   --color-muted: var(--blume-muted);
@@ -8016,7 +8252,20 @@ ${options.sources.map((source) => `@source "${source}";`).join(`
   --font-sans: var(--blume-font-body);
   --font-mono: var(--blume-font-mono);
   --font-display: var(--blume-font-display);
-}
+}`;
+var tailwindEntryTemplate = (options) => `/* Generated by Blume. Do not edit. */
+@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+
+/* Scan Blume's components and the user's project for utility classes. */
+${options.sources.map((source) => `@source "${source}";`).join(`
+`)}
+
+${DARK_VARIANT}
+
+${TOKEN_DEFAULTS}
+
+${THEME_MAPPING}
 
 @layer base {
   /* Nothing refuses to shrink below its intrinsic content width. This global
@@ -8561,6 +8810,33 @@ ${options.twoslashCss ?? ""}
 ${options.configTokens}
 ${options.userTheme}
 `;
+var examplesEntryTemplate = (options) => `/* Generated by Blume. Do not edit. */
+@import "tailwindcss";
+
+/* Scan the example files and the project sources they import. */
+${options.sources.map((source) => `@source "${source}";`).join(`
+`)}
+
+${DARK_VARIANT}
+
+${TOKEN_DEFAULTS}
+
+${THEME_MAPPING}
+
+/* Frame defaults: readable text in both modes, transparent so the docs pane's
+   surface shows through. Base layer, so any user/example CSS wins. */
+@layer base {
+  body {
+    background: transparent;
+    color: var(--blume-foreground);
+  }
+}
+
+/* Token overrides: config first, then the configured examples css (highest
+   priority) — the place for shadcn variables and other component tokens. */
+${options.configTokens}
+${options.userCss}
+`;
 
 // src/theme/twoslash.ts
 import { readFileSync as readFileSync6 } from "node:fs";
@@ -8640,6 +8916,7 @@ export const mdxComponents = {};
 export const layoutOverrides = {};
 `;
 var attributeValue = (value) => value.replaceAll(/["\n\r]/gu, " ").trim();
+var CLIENT_LOAD = "client:load";
 var directiveFor = (override) => {
   const framework = override.source?.framework;
   switch (override.client) {
@@ -8650,13 +8927,13 @@ var directiveFor = (override) => {
       return "client:visible";
     }
     case "media": {
-      return override.media ? `client:media="${attributeValue(override.media)}"` : "client:load";
+      return override.media ? `client:media="${attributeValue(override.media)}"` : CLIENT_LOAD;
     }
     case "only": {
-      return framework ? `client:only="${attributeValue(framework)}"` : "client:load";
+      return framework ? `client:only="${attributeValue(framework)}"` : CLIENT_LOAD;
     }
     default: {
-      return "client:load";
+      return CLIENT_LOAD;
     }
   }
 };
@@ -8779,30 +9056,33 @@ var discoverIslands = async (root) => {
   const islands = [];
   const warnings = [];
   const seen = new Map;
-  for (const [index, file] of files.entries()) {
+  const collectIsland = (file, source) => {
     const base = basename(file);
     const ext = base.match(ISLAND_FILE)?.groups?.ext;
     const framework = ext ? FRAMEWORK_BY_EXT2[ext] : undefined;
     if (!framework) {
-      continue;
+      return;
     }
     const name = base.replace(ISLAND_FILE, "");
     if (!/^[A-Z][A-Za-z0-9_]*$/u.test(name)) {
       warnings.push(`Island "${file}" must have a PascalCase identifier filename to be used in MDX (letters, digits, and underscores only, e.g. Counter.tsx → <Counter />); skipping it.`);
-      continue;
+      return;
     }
     const existing = seen.get(name);
     if (existing) {
       warnings.push(`Two islands both resolve to <${name}> ("${existing}" and "${file}"); ignoring the second. Give them distinct filenames.`);
-      continue;
+      return;
     }
     seen.set(name, file);
     islands.push({
-      client: readClientMode(sources[index] ?? "", file, warnings),
+      client: readClientMode(source, file, warnings),
       file,
       framework,
       name
     });
+  };
+  for (const [index, file] of files.entries()) {
+    collectIsland(file, sources[index] ?? "");
   }
   return { islands, warnings };
 };
@@ -8821,9 +9101,6 @@ var GLOB_MAGIC = /[!*?[\]{}]/u;
 var splitGlobBase = (pattern) => {
   const segments = pattern.split("/");
   const firstMagic = segments.findIndex((segment) => GLOB_MAGIC.test(segment));
-  if (firstMagic === -1) {
-    return { base: pattern, rest: "" };
-  }
   return {
     base: segments.slice(0, firstMagic).join("/"),
     rest: segments.slice(firstMagic).join("/")
@@ -8842,20 +9119,19 @@ var discoverExamples = async (root, pattern = "examples") => {
   const examples = [];
   const warnings = [];
   const seen = new Map;
-  for (const [index, file] of files.entries()) {
+  const collectExample = (file, source) => {
     const ext = file.match(EXAMPLE_FILE)?.groups?.ext;
     const framework = ext ? FRAMEWORK_BY_EXT3[ext] : undefined;
     if (!(ext && framework)) {
-      continue;
+      return;
     }
     const path = relative6(dir, file).slice(0, -(ext.length + 1));
     const existing = seen.get(path);
     if (existing) {
       warnings.push(`Two examples both resolve to "${path}" ("${existing}" and "${file}"); ignoring the second. Give them distinct paths.`);
-      continue;
+      return;
     }
     seen.set(path, file);
-    const source = sources[index] ?? "";
     examples.push({
       client: framework === "astro" ? undefined : readClientMode(source, file, warnings),
       file,
@@ -8864,6 +9140,9 @@ var discoverExamples = async (root, pattern = "examples") => {
       path,
       source
     });
+  };
+  for (const [index, file] of files.entries()) {
+    collectExample(file, sources[index] ?? "");
   }
   return { examples, warnings };
 };
@@ -8895,18 +9174,21 @@ var humanizeSegment = (segment) => segment.split(/[-_]/u).filter(Boolean).map((w
 var customOgRoutes = (pages, siteTitle) => {
   const seen = new Set;
   const routes = [];
-  for (const { pattern } of pages) {
+  const collectRoute = (pattern) => {
     const segments = pattern.split("/").filter(Boolean);
     if (segments.some((part) => PRIVATE_SEGMENT.test(part) || part.includes("["))) {
-      continue;
+      return;
     }
     const slug = segments.length === 0 ? "index" : segments.join("/");
     if (seen.has(slug)) {
-      continue;
+      return;
     }
     seen.add(slug);
     const last = segments.at(-1);
     routes.push({ slug, title: last ? humanizeSegment(last) : siteTitle });
+  };
+  for (const { pattern } of pages) {
+    collectRoute(pattern);
   }
   return routes;
 };
@@ -8915,15 +9197,28 @@ var customOgRoutes = (pages, siteTitle) => {
 var BLUME_SRC = join22(packageRoot(), "src");
 var canResolveFrom = (fromDir, spec) => {
   try {
-    createRequire5(pathToFileURL2(join22(fromDir, "_.js")).href).resolve(spec);
+    createRequire5(pathToFileURL3(join22(fromDir, "_.js")).href).resolve(spec);
     return true;
   } catch {
     return false;
   }
 };
+var resolveReactCompiler = (config, needsReact) => {
+  if (!(needsReact && config.react.compiler)) {
+    return null;
+  }
+  try {
+    return createRequire5(pathToFileURL3(join22(packageRoot(), "_.js")).href).resolve("babel-plugin-react-compiler");
+  } catch {
+    return null;
+  }
+};
+var reactCompilerWarnings = (config, needsReact, compilerPath) => needsReact && config.react.compiler && !compilerPath ? [
+  "React Compiler is enabled but `babel-plugin-react-compiler` could not be resolved; falling back to an uncompiled build. Reinstall Blume, or set `react: { compiler: false }` to silence this."
+] : [];
 var resolvedAstroPath = (fromDir) => {
   try {
-    const pkg = createRequire5(pathToFileURL2(join22(fromDir, "_.js")).href).resolve("astro/package.json");
+    const pkg = createRequire5(pathToFileURL3(join22(fromDir, "_.js")).href).resolve("astro/package.json");
     return realpathSync(pkg);
   } catch {
     return null;
@@ -8934,7 +9229,12 @@ var blumeDepsDir = (pkgDir = packageRoot()) => {
   return candidates.find((dir) => existsSync12(join22(dir, "astro"))) ?? null;
 };
 var linkDepsJunction = async (link, depsDir) => {
-  const existing = await lstat(link).catch(() => null);
+  let existing;
+  try {
+    existing = await lstat(link);
+  } catch {
+    existing = null;
+  }
   if (existing) {
     if (!existing.isSymbolicLink()) {
       return;
@@ -8991,6 +9291,17 @@ var islandFrameworkWarnings = (frameworks, root) => {
   }
   return warnings;
 };
+var examplesCssFile = (root, config) => config.examples.css ? join22(root, config.examples.css) : null;
+var writeExamplesPreview = async (options) => {
+  const { config, hasExamples, root, srcDir, write } = options;
+  if (hasExamples) {
+    await write(join22(srcDir, "pages", ...config.basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro"), examplesPageTemplate());
+  }
+  const cssFile = examplesCssFile(root, config);
+  return cssFile && !existsSync12(cssFile) ? [
+    `examples.css points at "${config.examples.css}", which doesn't exist; previews render without it.`
+  ] : [];
+};
 var readOptional = async (path) => {
   if (!path) {
     return "";
@@ -9045,7 +9356,14 @@ var pruneOrphans = async (srcDir, written) => {
     cwd: srcDir,
     onlyFiles: true
   });
-  await Promise.all(existing.map((path) => normalize3(path)).filter((path) => !written.has(path)).map((path) => rm2(path, { force: true })));
+  const removals = [];
+  for (const path of existing) {
+    const normalized = normalize3(path);
+    if (!written.has(normalized)) {
+      removals.push(rm2(normalized, { force: true }));
+    }
+  }
+  await Promise.all(removals);
 };
 var collectStaged = (project) => {
   const staged = new Map;
@@ -9165,7 +9483,8 @@ var buildRuntimeData = (project) => {
       return null;
     }
     const rel = relative8(context.root, sourcePath).split("\\").join("/");
-    return `${editBase}/${github?.dir ? `${github.dir}/${rel}` : rel}`;
+    const editPath = github?.dir ? `${github.dir}/${rel}` : rel;
+    return `${editBase}/${editPath}`;
   };
   const { i18n } = config;
   const withReferenceTabs = (nav) => ({
@@ -9199,6 +9518,7 @@ var buildRuntimeData = (project) => {
       appleIcon: resolveAppleIcon(project),
       ask: config.ai.ask?.enabled ? { suggestions: config.ai.ask.suggestions } : null,
       banner: resolveBanner(config),
+      codeThemes: config.markdown.codeBlocks.theme,
       codeWrap: config.markdown.code.wrap,
       description: config.description,
       favicon: resolveFavicon(project),
@@ -9352,6 +9672,7 @@ var generateRuntime = async (project) => {
   const themePath = join22(srcDir, "generated", "app.css");
   const searchClientPath = join22(srcDir, "generated", "search-client.ts");
   const examplesPath = join22(srcDir, "generated", "examples.ts");
+  const examplesThemePath = join22(srcDir, "generated", "examples.css");
   const openapiPath = join22(srcDir, "generated", "openapi.json");
   const written = new Set;
   const write = (path, content) => {
@@ -9367,21 +9688,25 @@ var generateRuntime = async (project) => {
     detectedReact,
     usesMath,
     userTheme,
+    userExamplesCss,
     islandDiscovery,
-    exampleDiscovery
+    exampleDiscovery,
+    componentSlots
   ] = await Promise.all([
     context.pagesRoot ? discoverPages(context.pagesRoot) : Promise.resolve([]),
     detectNeedsReact(context.root),
     detectUsesMath(context.root),
     readOptional(context.themeFile),
+    readOptional(examplesCssFile(context.root, config)),
     discoverIslands(context.root),
-    discoverExamples(context.root, config.examples)
+    discoverExamples(context.root, config.examples.source),
+    buildComponentSlots(context.componentsFile)
   ]);
   const {
     plan: slotPlan,
     tags: overrideTags,
     warnings: overrideWarnings
-  } = await buildComponentSlots(context.componentsFile);
+  } = componentSlots;
   const frameworks = new Set([
     ...islandDiscovery.islands.map((island) => island.framework),
     ...exampleDiscovery.examples.map((example) => example.framework),
@@ -9390,63 +9715,73 @@ var generateRuntime = async (project) => {
   const needsReact = detectedReact || askEnabled || frameworks.has("react");
   const needsVue = frameworks.has("vue");
   const needsSvelte = frameworks.has("svelte");
+  const reactCompilerPath = resolveReactCompiler(config, needsReact);
   const ogRoutes = customOgRoutes(pages, config.title);
   const mcp = planMcp(project, srcDir, pages);
   pages.push(...mcp.discoveryPages);
   const staged = collectStaged(project);
   const hasStaged = staged.size > 0;
   const hasFilesystemSource = project.sources.some((source) => !source.staged);
-  const structural = await Promise.all([
-    write(join22(out, "astro.config.mjs"), astroConfigTemplate({
-      aliases: resolveTsconfigAliases(context.root),
-      config,
-      contentRoutes: project.manifest.routes.map((route) => route.path),
-      context,
-      dataPath,
-      examplesPath,
-      needsReact,
-      needsSvelte,
-      needsVue,
-      openapiPath,
-      pages,
-      searchClientPath,
-      themePath
-    })),
-    write(join22(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
-    write(join22(out, "tsconfig.json"), runtimeTsconfigTemplate()),
-    write(join22(srcDir, "env.d.ts"), envTemplate()),
-    write(join22(srcDir, "content.config.ts"), contentConfigTemplate({
-      collection: resolveDocsCollection(config, context),
-      config,
-      context,
-      filesystem: hasFilesystemSource,
-      staged: hasStaged
-    })),
-    write(join22(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
-      askEnabled,
-      exportEpub,
-      exportPdf,
-      mathEnabled: usesMath,
-      needsReact
-    })),
-    write(join22(srcDir, "generated", "components.ts"), slotPlan.module),
-    write(join22(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
-    write(join22(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples)),
-    write(themePath, tailwindEntryTemplate({
-      configTokens: `${buildThemeCss(config.theme)}${buildFontsCss(config.theme.fonts)}`,
-      sources: [
-        `${BLUME_SRC}/**/*.{astro,ts,tsx}`,
-        `${context.root}/**/*.{astro,mdx,ts,tsx}`
-      ],
-      twoslashCss: twoslashCss(),
-      userTheme
-    }))
+  const [structural] = await Promise.all([
+    Promise.all([
+      write(join22(out, "astro.config.mjs"), astroConfigTemplate({
+        aliases: resolveTsconfigAliases(context.root),
+        config,
+        contentRoutes: project.manifest.routes.map((route) => route.path),
+        context,
+        dataPath,
+        examplesPath,
+        examplesThemePath,
+        needsReact,
+        needsSvelte,
+        needsVue,
+        openapiPath,
+        pages,
+        reactCompilerPath,
+        searchClientPath,
+        themePath
+      })),
+      write(join22(out, "package.json"), runtimePackageTemplate(runtimeDependencies({ config, needsReact, needsSvelte, needsVue }))),
+      write(join22(out, "tsconfig.json"), runtimeTsconfigTemplate()),
+      write(join22(srcDir, "env.d.ts"), envTemplate()),
+      write(join22(srcDir, "content.config.ts"), contentConfigTemplate({
+        collection: resolveDocsCollection(config, context),
+        config,
+        context,
+        filesystem: hasFilesystemSource,
+        staged: hasStaged
+      })),
+      write(join22(srcDir, "pages", "[...slug].astro"), catchAllPageTemplate({
+        askEnabled,
+        exportEpub,
+        exportPdf,
+        mathEnabled: usesMath,
+        needsReact
+      })),
+      write(join22(srcDir, "generated", "components.ts"), slotPlan.module),
+      write(join22(srcDir, "generated", "islands.ts"), islandMapTemplate(islandDiscovery.islands)),
+      write(join22(srcDir, "generated", "examples.ts"), exampleMapTemplate(exampleDiscovery.examples, config.basePath)),
+      write(examplesThemePath, examplesEntryTemplate({
+        configTokens: buildThemeCss(config.theme),
+        sources: [`${context.root}/**/*.{astro,jsx,svelte,ts,tsx,vue}`],
+        userCss: userExamplesCss
+      })),
+      write(themePath, tailwindEntryTemplate({
+        configTokens: `${buildThemeCss(config.theme)}${buildFontsCss(config.theme.fonts)}`,
+        sources: [
+          `${BLUME_SRC}/**/*.{astro,ts,tsx}`,
+          `${context.root}/**/*.{astro,mdx,ts,tsx}`
+        ],
+        twoslashCss: twoslashCss(),
+        userTheme
+      }))
+    ]),
+    Promise.all(islandDiscovery.islands.map((island) => write(join22(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island)))),
+    Promise.all(slotPlan.wrappers.map((wrapper) => write(join22(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content))),
+    Promise.all(exampleDiscovery.examples.map((example) => write(join22(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example)))),
+    writeAskFiles(project, srcDir, write),
+    writeMcpFiles(project, mcp, write)
   ]);
-  await Promise.all(islandDiscovery.islands.map((island) => write(join22(srcDir, "generated", "islands", `${island.name}.astro`), islandWrapperTemplate(island))));
-  await Promise.all(slotPlan.wrappers.map((wrapper) => write(join22(srcDir, "generated", "component-slots", `${wrapper.name}.astro`), wrapper.content)));
-  await Promise.all(exampleDiscovery.examples.map((example) => write(join22(srcDir, "generated", "examples", `${exampleSlug(example.path)}.astro`), exampleWrapperTemplate(example))));
-  await writeAskFiles(project, srcDir, write);
-  await writeMcpFiles(project, mcp, write);
   if (config.seo.og.enabled) {
     await write(join22(srcDir, "pages", "og", "[...slug].png.ts"), ogEndpointTemplate(ogRoutes));
   }
@@ -9459,8 +9794,17 @@ var generateRuntime = async (project) => {
       staged: hasStaged
     }));
   }
-  await writeNotFoundPage(write, srcDir, pages, project.graph.pages);
-  await write(searchClientPath, searchClientTemplate(config));
+  const [examplesWarnings] = await Promise.all([
+    writeExamplesPreview({
+      config,
+      hasExamples: exampleDiscovery.examples.length > 0,
+      root: context.root,
+      srcDir,
+      write
+    }),
+    writeNotFoundPage(write, srcDir, pages, project.graph.pages),
+    write(searchClientPath, searchClientTemplate(config))
+  ]);
   if (servesStaticIndex(config.search.provider)) {
     const documents = await buildSearchDocuments(project);
     await write(join22(srcDir, "generated", "search.json"), `${JSON.stringify(documents)}
@@ -9488,9 +9832,11 @@ var generateRuntime = async (project) => {
   }
   const warnings = [
     ...depsLinkWarning ? [depsLinkWarning] : [],
+    ...reactCompilerWarnings(config, needsReact, reactCompilerPath),
     ...mcp.warnings,
     ...islandDiscovery.warnings,
     ...exampleDiscovery.warnings,
+    ...examplesWarnings,
     ...overrideWarnings
   ];
   const navTargetRoutes = new Set([
@@ -9522,13 +9868,15 @@ var generateRuntime = async (project) => {
     warnings.push(...references.warnings);
     await Promise.all(references.files.map((file) => write(join22(srcDir, "pages", file.pagePath), file.content)));
   }
-  await write(join22(srcDir, "generated", "data.json"), buildRuntimeData(project));
   const openApiSource2 = project.sources.find(isOpenApiSource);
-  await write(openapiPath, `${JSON.stringify(openApiSource2 ? openApiSource2.openApiData() : {})}
-`);
-  await write(join22(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
-`);
-  await writeStagedContent(out, staged);
+  await Promise.all([
+    write(join22(srcDir, "generated", "data.json"), buildRuntimeData(project)),
+    write(openapiPath, `${JSON.stringify(openApiSource2 ? openApiSource2.openApiData() : {})}
+`),
+    write(join22(out, "blume.manifest.json"), `${JSON.stringify(project.manifest, null, 2)}
+`),
+    writeStagedContent(out, staged)
+  ]);
   await pruneOrphans(srcDir, written);
   return { structuralChange: structural.some(Boolean), warnings };
 };
@@ -9620,12 +9968,13 @@ var loadConfig = async (root, options = {}) => {
       message: "Invalid Blume config.",
       severity: "error"
     };
+    const moreIssues = rest.map((d) => `  - ${d.message}`).join(`
+`);
     throw new BlumeError(rest.length > 0 ? {
       ...primary,
       message: `${primary.message}
 ${rest.length} more config issue(s):
-${rest.map((d) => `  - ${d.message}`).join(`
-`)}`
+${moreIssues}`
     } : primary);
   }
   const config = applyDeploymentEnv(parsed.data);
@@ -9650,7 +9999,7 @@ var WORD_SPLIT2 = /[-_]/u;
 var humanize = (segment) => segment.replace(NUMERIC_PREFIX2, "").split(WORD_SPLIT2).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 var numericOrder = (segment) => {
   const value = segment.match(NUMERIC_PREFIX2)?.groups?.order;
-  return value ? Number.parseInt(value, 10) : Number.POSITIVE_INFINITY;
+  return value ? Math.trunc(Number(value)) : Number.POSITIVE_INFINITY;
 };
 var segmentKey = (raw) => {
   const group = raw.match(GROUP_FOLDER2)?.groups?.label;
@@ -9828,101 +10177,130 @@ var normalizeRef = (ref) => {
   const trimmed = withSlash.endsWith("/index") ? withSlash.slice(0, -"/index".length) : withSlash;
   return trimmed === "" ? "/" : trimmed;
 };
-var routeForRef = (ref, byRoute) => {
+var routeForRef = (ref, byRoute, basePath) => {
   if (!ref) {
     return;
   }
   const normalized = normalizeRef(ref);
-  return byRoute.get(normalized)?.route ?? normalized;
+  return byRoute.get(normalized)?.route ?? withBasePath(basePath, normalized);
 };
-var buildConfigSidebar = (items, byRoute, display) => {
+var configItemToNode = (item, byRoute, basePath) => {
+  if (typeof item === "string") {
+    const page = byRoute.get(normalizeRef(item));
+    if (!page) {
+      return null;
+    }
+    return {
+      badge: page.meta.sidebar.badge,
+      deprecated: page.meta.deprecated || undefined,
+      description: page.description,
+      icon: page.meta.sidebar.icon,
+      kind: "page",
+      label: page.meta.sidebar.label ?? page.title,
+      pageId: page.id,
+      route: page.route
+    };
+  }
+  if (item.root) {
+    const page = byRoute.get(normalizeRef(item.root));
+    return {
+      badge: item.badge,
+      deprecated: page?.meta.deprecated || undefined,
+      icon: item.icon,
+      kind: "page",
+      label: item.label,
+      pageId: page?.id ?? "",
+      route: page?.route ?? withBasePath(basePath, normalizeRef(item.root))
+    };
+  }
+  if (item.href) {
+    return {
+      badge: item.badge,
+      icon: item.icon,
+      kind: "page",
+      label: item.label,
+      pageId: "",
+      route: withBasePath(basePath, item.href)
+    };
+  }
+  return null;
+};
+var buildConfigSidebar = (items, byRoute, display, basePath) => {
   const nodes = [];
   for (const item of items) {
-    if (typeof item === "string") {
-      const page = byRoute.get(normalizeRef(item));
-      if (page) {
-        nodes.push({
-          badge: page.meta.sidebar.badge,
-          deprecated: page.meta.deprecated || undefined,
-          description: page.description,
-          icon: page.meta.sidebar.icon,
-          kind: "page",
-          label: page.meta.sidebar.label ?? page.title,
-          pageId: page.id,
-          route: page.route
-        });
-      }
-      continue;
-    }
-    if (item.items) {
+    if (typeof item !== "string" && item.items) {
       nodes.push({
         badge: item.badge,
-        children: buildConfigSidebar(item.items, byRoute, display),
+        children: buildConfigSidebar(item.items, byRoute, display, basePath),
         collapsed: item.collapsed,
         directory: item.directory,
         display: item.display ?? display,
         icon: item.icon,
         kind: "group",
         label: item.label,
-        route: routeForRef(item.root, byRoute)
+        route: routeForRef(item.root, byRoute, basePath)
       });
       continue;
     }
-    if (item.root) {
-      const page = byRoute.get(normalizeRef(item.root));
-      nodes.push({
-        badge: item.badge,
-        deprecated: page?.meta.deprecated || undefined,
-        icon: item.icon,
-        kind: "page",
-        label: item.label,
-        pageId: page?.id ?? "",
-        route: page?.route ?? normalizeRef(item.root)
-      });
-      continue;
-    }
-    if (item.href) {
-      nodes.push({
-        badge: item.badge,
-        icon: item.icon,
-        kind: "page",
-        label: item.label,
-        pageId: "",
-        route: item.href
-      });
+    const node = configItemToNode(item, byRoute, basePath);
+    if (node) {
+      nodes.push(node);
     }
   }
   return nodes;
 };
 var buildNavigation = (pages, options) => {
-  const featured = options.featured ?? [];
-  const selectors = options.selectors ?? [];
-  const tabs = options.tabs ?? [];
+  const basePath = options.basePath ?? "";
   const display = options.display ?? "flat";
   const metaPrefix = options.metaPrefix ?? "";
   const sharedFolderMeta = options.sharedFolderMeta ?? new Map;
+  const rebasePath = (item) => ({
+    ...item,
+    path: withBasePath(basePath, item.path)
+  });
+  const featured = basePath ? (options.featured ?? []).map((link) => ({
+    ...link,
+    href: withBasePath(basePath, link.href)
+  })) : options.featured ?? [];
+  const selectors = basePath ? (options.selectors ?? []).map((selector) => ({
+    ...selector,
+    items: selector.items.map(rebasePath)
+  })) : options.selectors ?? [];
+  const tabs = basePath ? (options.tabs ?? []).map((tab) => ({
+    ...tab,
+    items: tab.items?.map(rebasePath),
+    path: withBasePath(basePath, tab.path)
+  })) : options.tabs ?? [];
   const byRoute = new Map(pages.map((page) => [
     options.refByLogical ? page.translationKey : page.route,
     page
   ]));
+  if (basePath && !options.refByLogical) {
+    for (const page of pages) {
+      const bare = stripBasePath(basePath, page.route);
+      if (!byRoute.has(bare)) {
+        byRoute.set(bare, page);
+      }
+    }
+  }
   if (options.sidebar) {
     return {
       featured,
       selectors,
-      sidebar: buildConfigSidebar(options.sidebar, byRoute, display),
+      sidebar: buildConfigSidebar(options.sidebar, byRoute, display, basePath),
       tabs
     };
   }
   return {
     featured,
     selectors,
-    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs.map((tab) => tab.path).filter((path) => path !== "/"))),
+    sidebar: buildFileSystemSidebar(pages, options.folderMeta, sharedFolderMeta, metaPrefix, display, new Set(tabs.flatMap((tab) => tab.path === "/" ? [] : [tab.path]))),
     tabs
   };
 };
 
 // src/core/graph.ts
-var buildContentGraph = (pages, options) => {
+var collectRoutes = (pages) => {
   const routes = new Map;
   const diagnostics = [];
   for (const page of pages) {
@@ -9939,60 +10317,73 @@ var buildContentGraph = (pages, options) => {
     }
     routes.set(page.route, page.id);
   }
-  const { i18n } = options;
-  const navigationByLocale = {};
-  let navigation;
-  if (i18n) {
-    const fallback = resolveFallbackLocale(i18n);
-    const fallbackByKey = new Map;
-    if (fallback) {
-      for (const page of pages) {
-        if (page.locale === fallback) {
-          fallbackByKey.set(page.translationKey, page);
-        }
-      }
+  return { diagnostics, routes };
+};
+var localePagesFor = (code, real, fallback, fallbackByKey, i18n, basePath) => {
+  if (!(fallback && code !== fallback)) {
+    return real;
+  }
+  const present = new Set(real.map((page) => page.translationKey));
+  const filled = [];
+  for (const [key, source] of fallbackByKey) {
+    if (!present.has(key)) {
+      filled.push({
+        ...source,
+        locale: code,
+        route: withBasePath(basePath, localizeRoute(key, code, i18n))
+      });
     }
-    for (const { code } of i18n.locales) {
-      const tabs = options.navigation.tabs?.map((tab) => ({
-        ...tab,
-        path: tab.path.startsWith("/") ? localizeRoute(tab.path, code, i18n) : tab.path
-      }));
-      const real = pages.filter((page) => page.locale === code);
-      let localePages = real;
-      if (fallback && code !== fallback) {
-        const present = new Set(real.map((page) => page.translationKey));
-        const filled = [];
-        for (const [key, source] of fallbackByKey) {
-          if (!present.has(key)) {
-            filled.push({
-              ...source,
-              locale: code,
-              route: localizeRoute(key, code, i18n)
-            });
-          }
-        }
-        localePages = [...real, ...filled];
+  }
+  return [...real, ...filled];
+};
+var buildLocaleNavigation = (code, pages, fallback, fallbackByKey, options, i18n) => {
+  const tabs = options.navigation.tabs?.map((tab) => ({
+    ...tab,
+    path: tab.path.startsWith("/") ? localizeRoute(tab.path, code, i18n) : tab.path
+  }));
+  const real = pages.filter((page) => page.locale === code);
+  const localePages = localePagesFor(code, real, fallback, fallbackByKey, i18n, options.basePath ?? "");
+  return buildNavigation(localePages, {
+    basePath: options.basePath ?? "",
+    display: options.navigation.sidebar.display,
+    featured: options.navigation.featured,
+    folderMeta: options.folderMeta,
+    metaPrefix: i18n.parser === "dir" && code !== i18n.defaultLocale ? code : "",
+    refByLogical: true,
+    selectors: options.navigation.selectors,
+    sharedFolderMeta: options.sharedFolderMeta,
+    sidebar: options.navigation.sidebar.items,
+    tabs
+  });
+};
+var buildI18nNavigation = (pages, options, i18n) => {
+  const fallback = resolveFallbackLocale(i18n);
+  const fallbackByKey = new Map;
+  if (fallback) {
+    for (const page of pages) {
+      if (page.locale === fallback) {
+        fallbackByKey.set(page.translationKey, page);
       }
-      navigationByLocale[code] = buildNavigation(localePages, {
-        display: options.navigation.sidebar.display,
-        featured: options.navigation.featured,
-        folderMeta: options.folderMeta,
-        metaPrefix: i18n.parser === "dir" && code !== i18n.defaultLocale ? code : "",
-        refByLogical: true,
-        selectors: options.navigation.selectors,
-        sharedFolderMeta: options.sharedFolderMeta,
-        sidebar: options.navigation.sidebar.items,
-        tabs
-      });
     }
-    navigation = navigationByLocale[i18n.defaultLocale] ?? {
-      featured: [],
-      selectors: [],
-      sidebar: [],
-      tabs: []
-    };
-  } else {
-    navigation = buildNavigation(pages, {
+  }
+  const navigationByLocale = {};
+  for (const { code } of i18n.locales) {
+    navigationByLocale[code] = buildLocaleNavigation(code, pages, fallback, fallbackByKey, options, i18n);
+  }
+  const navigation = navigationByLocale[i18n.defaultLocale] ?? {
+    featured: [],
+    selectors: [],
+    sidebar: [],
+    tabs: []
+  };
+  return { navigation, navigationByLocale };
+};
+var buildContentGraph = (pages, options) => {
+  const { diagnostics, routes } = collectRoutes(pages);
+  const { i18n } = options;
+  const { navigation, navigationByLocale } = i18n ? buildI18nNavigation(pages, options, i18n) : {
+    navigation: buildNavigation(pages, {
+      basePath: options.basePath ?? "",
       display: options.navigation.sidebar.display,
       featured: options.navigation.featured,
       folderMeta: options.folderMeta,
@@ -10000,10 +10391,10 @@ var buildContentGraph = (pages, options) => {
       sharedFolderMeta: options.sharedFolderMeta,
       sidebar: options.navigation.sidebar.items,
       tabs: options.navigation.tabs
-    });
-  }
-  diagnostics.push(...validateNavIcons(navigation));
-  diagnostics.push(...validateNavStructure(navigation, pages));
+    }),
+    navigationByLocale: {}
+  };
+  diagnostics.push(...validateNavIcons(navigation), ...validateNavStructure(navigation, pages));
   return {
     diagnostics,
     navigation,
@@ -10200,11 +10591,8 @@ var scanProject = async (root, options = {}) => {
   for (const source of sources) {
     source.validate?.();
   }
-  const metaSources = sources.filter((source) => !source.staged && source.contentRoot).map((source) => ({
-    prefix: source.prefix,
-    root: source.contentRoot ?? ""
-  }));
-  const localeDirs = config.i18n && config.i18n.parser === "dir" ? config.i18n.locales.map((locale) => locale.code).filter((code) => code !== config.i18n?.defaultLocale) : undefined;
+  const metaSources = sources.flatMap((source) => source.staged || !source.contentRoot ? [] : [{ prefix: source.prefix, root: source.contentRoot }]);
+  const localeDirs = config.i18n && config.i18n.parser === "dir" ? config.i18n.locales.flatMap((locale) => locale.code === config.i18n?.defaultLocale ? [] : [locale.code]) : undefined;
   const [loaded, folderMeta] = await Promise.all([
     Promise.all(sources.map(async (source) => ({ source, ...await source.load() }))),
     discoverFolderMeta(metaSources, { localeDirs })
@@ -10215,6 +10603,7 @@ var scanProject = async (root, options = {}) => {
     contentDiagnostics.push(...diagnostics);
     for (const entry of entries) {
       const normalized = normalizeEntry2(entry, {
+        basePath: config.basePath,
         defaultType: config.content.defaultType,
         i18n: config.i18n,
         source: {
@@ -10239,6 +10628,7 @@ var scanProject = async (root, options = {}) => {
     }
   }
   const graph = buildContentGraph(pages, {
+    basePath: config.basePath,
     folderMeta: folderMeta.meta,
     i18n: config.i18n,
     navigation: config.navigation,
@@ -10358,9 +10748,10 @@ var checkRequiredSecrets = (config) => {
     if (process.env[env]) {
       return;
     }
+    const noteSuffix = note ? ` (${note})` : "";
     diagnostics.push({
       code: "BLUME_MISSING_SECRET",
-      message: `${feature} is enabled but ${env} is not set${note ? ` (${note})` : ""}.`,
+      message: `${feature} is enabled but ${env} is not set${noteSuffix}.`,
       severity: "warning",
       suggestion: `Set ${env} in .env.local for local dev, or in your host's environment for production.`
     });
@@ -10432,17 +10823,20 @@ var prepareProject = async (options) => {
 
 // src/cli/commands/build.ts
 var ADAPTERS = ["vercel", "node", "netlify", "cloudflare"];
+var BUDGET_JS = "budget-js";
+var BUDGET_CSS = "budget-css";
 var validateBudgetFlags = (args) => {
-  for (const flag of ["budget-js", "budget-css"]) {
+  for (const flag of [BUDGET_JS, BUDGET_CSS]) {
     const value = args[flag];
-    if (value !== undefined && !(Number(value) > 0)) {
+    const parsed = Number(value);
+    if (value !== undefined && (Number.isNaN(parsed) || parsed <= 0)) {
       logger.error(`Invalid --${flag} "${value}" (expected a positive number of kB).`);
       process.exit(1);
     }
   }
 };
 var emitRedirectFiles = async (config, distDir) => {
-  const { redirects } = config;
+  const redirects = applyBaseToRedirects(config.redirects, config.basePath);
   if (redirects.length === 0 || config.deployment.output !== "static") {
     return;
   }
@@ -10454,7 +10848,13 @@ var emitRedirectFiles = async (config, distDir) => {
   await Promise.all(platformFiles.map((file) => existsSync15(join24(distDir, file.name)) ? Promise.resolve() : writeFile7(join24(distDir, file.name), file.content, "utf-8")));
   logger.success(`Emitted redirect files for ${redirects.length} redirect(s)`);
 };
-var formatBytes = (bytes) => bytes < 1024 ? `${bytes} B` : `${(bytes / 1024).toFixed(bytes < 1024 * 100 ? 1 : 0)} kB`;
+var formatBytes = (bytes) => {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  const digits = bytes < 1024 * 100 ? 1 : 0;
+  return `${(bytes / 1024).toFixed(digits)} kB`;
+};
 var astroAssets = async (distDir, ext) => {
   const astroDir = join24(distDir, "_astro");
   if (!existsSync15(astroDir)) {
@@ -10486,8 +10886,8 @@ var reportBundleSizes = async (distDir) => {
 };
 var enforceBudget = async (distDir, args) => {
   const checks = [
-    ...args["budget-js"] ? [{ ext: "js", limitKb: Number(args["budget-js"]), name: "JavaScript" }] : [],
-    ...args["budget-css"] ? [{ ext: "css", limitKb: Number(args["budget-css"]), name: "CSS" }] : []
+    ...args[BUDGET_JS] ? [{ ext: "js", limitKb: Number(args[BUDGET_JS]), name: "JavaScript" }] : [],
+    ...args[BUDGET_CSS] ? [{ ext: "css", limitKb: Number(args[BUDGET_CSS]), name: "CSS" }] : []
   ];
   if (checks.length === 0) {
     return "skip";
@@ -10578,11 +10978,11 @@ var buildCommand = defineCommand2({
       description: "Base path the site is served under (e.g. /docs).",
       type: "string"
     },
-    "budget-css": {
+    [BUDGET_CSS]: {
       description: "Fail if total client CSS exceeds this many kB.",
       type: "string"
     },
-    "budget-js": {
+    [BUDGET_JS]: {
       description: "Fail if total client JavaScript exceeds this many kB.",
       type: "string"
     },
@@ -10718,14 +11118,20 @@ import { defineCommand as defineCommand4 } from "citty";
 var overlayServer = null;
 var overlayChannel = () => overlayServer?.ws ?? overlayServer?.hot;
 var showBlumeErrorOverlay = (diagnostics) => {
-  const errors = diagnostics.filter((diagnostic) => diagnostic.severity === "error").map(enrichDiagnostic);
+  const errors = [];
+  for (const diagnostic of diagnostics) {
+    if (diagnostic.severity === "error") {
+      errors.push(enrichDiagnostic(diagnostic));
+    }
+  }
   const channel = overlayChannel();
   if (errors.length === 0 || !channel) {
     return;
   }
   const body = errors.map((diagnostic) => {
+    const lineSuffix = diagnostic.line ? `:${diagnostic.line}` : "";
     const where = diagnostic.file ? `
-  at ${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ""}` : "";
+  at ${diagnostic.file}${lineSuffix}` : "";
     const fix = diagnostic.suggestion ? `
   fix: ${diagnostic.suggestion}` : "";
     const docs = diagnostic.docsUrl ? `
@@ -10785,6 +11191,8 @@ var coalescedRunner = (task) => {
 };
 
 // src/cli/commands/dev.ts
+var routeSignature = (routes) => routes.map((route) => `${route.path} ${route.entryId}`).toSorted().join(`
+`);
 var devCommand = defineCommand4({
   args: {
     "content-dir": {
@@ -10835,21 +11243,19 @@ var devCommand = defineCommand4({
       root,
       strict: args.strict
     });
-    const server = await dev({
+    const createServer = (listenPort, open) => dev({
       logLevel: args.debug ? "debug" : "info",
       root: project.context.outDir,
-      server: {
-        host: args.host ?? false,
-        open: args.open ?? false,
-        port: explicitPort
-      }
+      server: { host: args.host ?? false, open, port: listenPort }
     });
+    let server = await createServer(explicitPort, args.open ?? false);
     const boundPort = server.address.port;
     if (boundPort !== port) {
       updateDevLockPort(outDir, boundPort);
       devServerUrl = `http://localhost:${boundPort}`;
     }
     showBlumeErrorOverlay(project.diagnostics);
+    let lastSignature = routeSignature(project.manifest.routes);
     const runRegenerate = coalescedRunner(async () => {
       try {
         const next = await scanProject(root, {
@@ -10858,7 +11264,16 @@ var devCommand = defineCommand4({
           overrides,
           preview
         });
-        await generateRuntime(next);
+        const nextSignature = routeSignature(next.manifest.routes);
+        const structural = nextSignature !== lastSignature;
+        lastSignature = nextSignature;
+        if (structural) {
+          await server.stop();
+          await generateRuntime(next);
+          server = await createServer(boundPort, false);
+        } else {
+          await generateRuntime(next);
+        }
         showBlumeErrorOverlay(next.diagnostics);
       } catch (error) {
         logger.error(`Regeneration failed: ${error.message}`);
@@ -10916,8 +11331,8 @@ var minSupportedNode = () => {
   }
 };
 var versionBelow = (current, minimum) => {
-  const a = current.split(".").map((part) => Number.parseInt(part, 10));
-  const b = minimum.split(".").map((part) => Number.parseInt(part, 10));
+  const a = current.split(".").map((part) => Math.trunc(Number(part)));
+  const b = minimum.split(".").map((part) => Math.trunc(Number(part)));
   for (let i = 0;i < 3; i += 1) {
     const delta = (a[i] ?? 0) - (b[i] ?? 0);
     if (delta !== 0) {
@@ -11008,7 +11423,7 @@ import { join as join28, relative as relative13 } from "pathe";
 import { existsSync as existsSync17 } from "node:fs";
 import { cp as cp2, mkdir as mkdir7, readFile as readFile12, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
 import { join as join27, relative as relative12 } from "pathe";
-var POSIX = (path) => path.split("\\").join("/");
+var toPosix = (path) => path.split("\\").join("/");
 var ejectOpenApiData = (project) => {
   const source = project.sources.find(isOpenApiSource);
   return source ? source.openApiData() : {};
@@ -11034,6 +11449,13 @@ var askFiles = async (project, srcDir, genDir) => {
   }
   return files;
 };
+var readExamplesCss = (root, css) => css && existsSync17(join27(root, css)) ? readFile12(join27(root, css), "utf-8") : Promise.resolve("");
+var examplesPreviewFiles = (srcDir, basePath, hasExamples) => hasExamples ? [
+  {
+    content: examplesPageTemplate(),
+    path: join27(srcDir, "pages", ...basePath.split("/").filter(Boolean), "blume-examples", "[...path].astro")
+  }
+] : [];
 var eject = async (root) => {
   const project = await scanProject(root, { mode: "build" });
   const { context, config } = project;
@@ -11047,6 +11469,7 @@ var eject = async (root) => {
     needsReactRaw,
     usesMath,
     userTheme,
+    userExamplesCss,
     rawMarkdown,
     islands,
     examples
@@ -11055,9 +11478,10 @@ var eject = async (root) => {
     detectNeedsReact(root),
     detectUsesMath(root),
     context.themeFile ? readFile12(context.themeFile, "utf-8") : Promise.resolve(""),
+    readExamplesCss(root, config.examples.css),
     buildRawMarkdown(project),
     discoverIslands(root),
-    discoverExamples(root, config.examples)
+    discoverExamples(root, config.examples.source)
   ]);
   const frameworks = new Set([
     ...islands.islands.map((island) => island.framework),
@@ -11068,13 +11492,13 @@ var eject = async (root) => {
   const needsSvelte = frameworks.has("svelte");
   const relContext = {
     ...context,
-    contentRoot: POSIX(relative12(root, context.contentRoot)),
+    contentRoot: toPosix(relative12(root, context.contentRoot)),
     outDir: ".",
     root: "."
   };
-  const componentsImport = context.componentsFile ? `../../${POSIX(relative12(root, context.componentsFile))}` : null;
+  const componentsImport = context.componentsFile ? `../../${toPosix(relative12(root, context.componentsFile))}` : null;
   const relPages = pages.map((page) => ({
-    entrypoint: POSIX(relative12(root, page.entrypoint)),
+    entrypoint: toPosix(relative12(root, page.entrypoint)),
     pattern: page.pattern
   }));
   const staged = collectStaged(project);
@@ -11088,6 +11512,7 @@ var eject = async (root) => {
         context: relContext,
         dataPath: "./src/generated/data.json",
         examplesPath: "./src/generated/examples.ts",
+        examplesThemePath: "./src/generated/examples.css",
         needsReact,
         needsSvelte,
         needsVue,
@@ -11132,9 +11557,17 @@ var eject = async (root) => {
       path: join27(genDir, "islands.ts")
     },
     {
-      content: exampleMapTemplate(examples.examples),
+      content: exampleMapTemplate(examples.examples, config.basePath),
       path: join27(genDir, "examples.ts")
     },
+    {
+      content: examplesEntryTemplate({
+        configTokens: buildThemeCss(config.theme),
+        sources: ["../../**/*.{astro,jsx,svelte,ts,tsx,vue}"],
+        userCss: userExamplesCss
+      }),
+      path: join27(genDir, "examples.css")
+    },
     {
       content: tailwindEntryTemplate({
         configTokens: buildThemeCss(config.theme),
@@ -11234,7 +11667,7 @@ var eject = async (root) => {
   })), ...examples.examples.map((example) => ({
     content: exampleWrapperTemplate(example),
     path: join27(genDir, "examples", `${exampleSlug(example.path)}.astro`)
-  })));
+  })), ...examplesPreviewFiles(srcDir, config.basePath, examples.examples.length > 0));
   for (const [entryId, content] of staged) {
     files.push({ content, path: join27(root, stagedDir, entryId) });
   }
@@ -11621,20 +12054,23 @@ var isIndexPage = (page2) => {
   const ref = page2.source?.ref ?? page2.sourcePath ?? "";
   return /^index\.(?:md|mdx)$/iu.test(basename5(ref));
 };
+var applyRelativePart = (segments, part) => {
+  if (part === "" || part === ".") {
+    return;
+  }
+  if (part === "..") {
+    segments.pop();
+    return;
+  }
+  segments.push(part);
+};
 var resolveRelative = (pageRoute, target, isIndex) => {
   const segments = pageRoute.split("/").filter(Boolean);
   if (!isIndex) {
     segments.pop();
   }
   for (const part of target.split("/")) {
-    if (part === "" || part === ".") {
-      continue;
-    }
-    if (part === "..") {
-      segments.pop();
-      continue;
-    }
-    segments.push(part);
+    applyRelativePart(segments, part);
   }
   return `/${segments.join("/")}`;
 };
@@ -11667,15 +12103,16 @@ var checkAnchor = (route, fragment, site, ctx) => {
   };
 };
 var checkPathLink = (resolved, fragment, target, site, ctx) => {
-  const route = toRoute(resolved);
+  const route = toRoute(withBasePath(ctx.basePath, resolved));
   if (ctx.routes.has(route)) {
     return fragment ? checkAnchor(route, fragment, site, ctx) : null;
   }
   if (ctx.redirects.has(route)) {
     return null;
   }
-  if (FILE_EXT.test(resolved) && !DOC_EXT.test(resolved)) {
-    if (assetIsPresent(resolved, ctx)) {
+  const assetPath = stripBasePath(ctx.basePath, resolved);
+  if (FILE_EXT.test(assetPath) && !DOC_EXT.test(assetPath)) {
+    if (assetIsPresent(assetPath, ctx)) {
       return null;
     }
     if (ctx.publicDir === null) {
@@ -11684,9 +12121,9 @@ var checkPathLink = (resolved, fragment, target, site, ctx) => {
     return {
       ...site,
       code: "BLUME_BROKEN_ASSET",
-      message: `Asset ${resolved} was not found in the public directory.`,
+      message: `Asset ${assetPath} was not found in the public directory.`,
       severity: "warning",
-      suggestion: `Add the file at public${resolved} or fix the link.`
+      suggestion: `Add the file at public${assetPath} or fix the link.`
     };
   }
   return {
@@ -11721,7 +12158,8 @@ var request = async (url, method) => {
 };
 var probe = async (url) => {
   const head = await request(url, "HEAD");
-  const retry = head.status === STATUS_METHOD_NOT_ALLOWED || head.status === STATUS_NOT_IMPLEMENTED || !head.ok && head.status === undefined && !head.timedOut;
+  const unreachable = !head.ok && head.status === undefined && !head.timedOut;
+  const retry = head.status === STATUS_METHOD_NOT_ALLOWED || head.status === STATUS_NOT_IMPLEMENTED || unreachable;
   return retry ? await request(url, "GET") : head;
 };
 var gradeExternal = (result) => {
@@ -11802,10 +12240,12 @@ var classifyLink = (page2, link, ctx, onExternal) => {
   return checkPathLink(resolved, fragment, target, site, ctx);
 };
 var validateLinks = async (graph, options) => {
+  const basePath = options.basePath ?? "";
   const ctx = {
     anchors: buildAnchorIndex(graph.pages),
+    basePath,
     publicDir: options.publicDir,
-    redirects: new Set((options.redirects ?? []).map((redirect) => toRoute(redirect.from))),
+    redirects: new Set((options.redirects ?? []).map((redirect) => toRoute(withBasePath(basePath, redirect.from)))),
     routes: new Set(graph.routes.keys())
   };
   const diagnostics = [];
@@ -11862,6 +12302,7 @@ var validateCommand = defineCommand10({
       diagnostics.push(...project.diagnostics);
       const publicDir = join33(root, "public");
       diagnostics.push(...await validateLinks(project.graph, {
+        basePath: project.config.basePath,
         checkExternal: Boolean(args.external),
         publicDir: existsSync21(publicDir) ? publicDir : null,
         redirects: project.config.redirects
@@ -11923,5 +12364,5 @@ process.on("unhandledRejection", (error) => {
 });
 runMain(main);
 
-//# debugId=776A1FC12D044B5664756E2164756E21
+//# debugId=8E29DA45BB5B37C564756E2164756E21
 //# sourceMappingURL=index.js.map