blume 2.0.1 → 2.0.3

package/dist/cli/{chunk-2hn4b8z7.js → chunk-5m5nmvyq.js}

@@ -1,8 +1,4 @@
 #!/usr/bin/env node
-import {
-  trimChar,
-  normalizeBasePath
-} from "./chunk-jts8mvcz.js";
 import {
   buildHomeLinkHeader,
   resolveDocsCollection,
@@ -10,18 +6,61 @@ import {
   deployPassthrough,
   fontLocaleCodes,
   buildFontEntries,
+  SVG_ASSET_HEADERS,
   applyBaseToAstroRedirects,
   distDir,
   adapterRoot,
-  SVG_ASSET_POLICY,
-  deployPlatform
-} from "./chunk-qkqwkpte.js";
-import {
+  deployPlatform,
   BLUME_IGNORE_DIRS
-} from "./chunk-abh8yjkn.js";
+} from "./chunk-pv29h0wf.js";
+import {
+  trimChar,
+  normalizeBasePath
+} from "./chunk-3em5wd2y.js";
+
+// src/deploy/adapter-output.ts
+import { existsSync } from "node:fs";
+import { cp, mkdir, rm } from "node:fs/promises";
+import { dirname, join } from "pathe";
+var deployOutputDir = (config, context) => {
+  const { deployment } = config;
+  return deployment.options.output === "server" ? deployPlatform(deployment).serverOutputDir(context) : distDir(context);
+};
+var deployStaticDir = (config, context) => {
+  const { deployment } = config;
+  return deployment.options.output === "server" ? deployPlatform(deployment).serverStaticDir(context) : distDir(context);
+};
+var surfaceAdapterOutput = async (config, context) => {
+  const { deployment } = config;
+  if (deployment.options.output !== "server") {
+    return { moved: false };
+  }
+  const rel = deployPlatform(deployment).hiddenRuntime.surfacePath;
+  if (!rel) {
+    return { moved: false };
+  }
+  const from = join(context.outDir, rel);
+  const to = join(context.root, rel);
+  if (!existsSync(from)) {
+    return { moved: false };
+  }
+  await mkdir(dirname(to), { recursive: true });
+  await rm(to, { force: true, recursive: true });
+  try {
+    await cp(from, to, { recursive: true, verbatimSymlinks: true });
+  } catch (error) {
+    if (error.code !== "EPERM") {
+      throw error;
+    }
+    await rm(to, { force: true, recursive: true });
+    await cp(from, to, { dereference: true, recursive: true });
+  }
+  await rm(from, { force: true, recursive: true });
+  return { from, moved: true, to };
+};
 
 // src/astro/component-slots.ts
-import { isAbsolute, join, relative } from "pathe";
+import { isAbsolute, join as join2, relative } from "pathe";
 var attributeValue = (value) => value.replaceAll(/["\n\r]/gu, " ").trim();
 var CLIENT_LOAD = "client:load";
 var directiveFor = (override) => {
@@ -77,7 +116,7 @@ var islandOverride = (island) => ({
 var record = (entries) => entries.length ? `{ ${entries.join(", ")} }` : "{}";
 var planComponentSlots = (islands, analysis, options = {}) => {
   const { relativeTo } = options;
-  const wrapperDir = relativeTo === undefined ? undefined : join(relativeTo, "component-slots");
+  const wrapperDir = relativeTo === undefined ? undefined : join2(relativeTo, "component-slots");
   const frameworks = new Set;
   const wrappers = [];
   const importLines = [];
@@ -156,10 +195,12 @@ var publishRuntimeModules = (modules) => {
     return changed;
   }
   for (const server of servers) {
-    for (const id of changed) {
-      const mod = server.moduleGraph.getModuleById(`${RESOLVED_PREFIX}${id}`);
-      if (mod) {
-        server.moduleGraph.invalidateModule(mod);
+    for (const { moduleGraph } of Object.values(server.environments)) {
+      for (const id of changed) {
+        const mod = moduleGraph.getModuleById(`${RESOLVED_PREFIX}${id}`);
+        if (mod) {
+          moduleGraph.invalidateModule(mod);
+        }
       }
     }
     server.ws.send({ type: "full-reload" });
@@ -168,9 +209,9 @@ var publishRuntimeModules = (modules) => {
 };
 
 // src/astro/templates.ts
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync as existsSync2, readFileSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { dirname, isAbsolute as isAbsolute2, join as join2, relative as relative2 } from "pathe";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join as join3, relative as relative2 } from "pathe";
 var WORKSPACE_MARKERS = [
   ".git",
   "bun.lock",
@@ -181,7 +222,7 @@ var WORKSPACE_MARKERS = [
   "yarn.lock"
 ];
 var hasWorkspacesField = (pkgPath) => {
-  if (!existsSync(pkgPath)) {
+  if (!existsSync2(pkgPath)) {
     return false;
   }
   try {
@@ -191,14 +232,14 @@ var hasWorkspacesField = (pkgPath) => {
     return false;
   }
 };
-var hasWorkspaceMarker = (dir) => hasWorkspacesField(join2(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync(join2(dir, marker)));
+var hasWorkspaceMarker = (dir) => hasWorkspacesField(join3(dir, "package.json")) || WORKSPACE_MARKERS.some((marker) => existsSync2(join3(dir, marker)));
 var findWorkspaceRoot = (start) => {
   let dir = start;
   for (;; ) {
     if (hasWorkspaceMarker(dir)) {
       return dir;
     }
-    const parent = dirname(dir);
+    const parent = dirname2(dir);
     if (parent === dir) {
       return start;
     }
@@ -317,8 +358,16 @@ const blumeConfig = await loadBlumeConfig(resolve(dirname(fileURLToPath(import.m
 var renderImageOption = (config) => config.image.domains.length > 0 || config.image.remotePatterns.length > 0 ? `
   image: ${JSON.stringify(config.image)},` : "";
 var ALL_CLIENT_FEATURES = { epub: true, mermaid: true };
+var SEARCH_CLIENT_DEPS = {
+  algolia: "algoliasearch/lite",
+  flexsearch: "flexsearch",
+  orama: "@orama/orama",
+  "orama-cloud": "@oramacloud/client",
+  typesense: "typesense"
+};
 var resolveOptimizeDeps = (options) => {
   const { context, features } = options;
+  const searchDep = SEARCH_CLIENT_DEPS[options.searchKind];
   const optimizeDepsEntries = [
     ...context.pagesRoot ? [`${context.pagesRoot}/**/*.astro`] : [],
     `${context.root}/islands/**/*.{jsx,svelte,tsx,vue}`,
@@ -327,6 +376,7 @@ var resolveOptimizeDeps = (options) => {
   const optimizeDepsInclude = [
     ...features.mermaid ? ["blume > mermaid"] : [],
     ...features.epub ? ["blume > epub-gen-memory/bundle"] : [],
+    ...searchDep ? [`blume > ${searchDep}`] : [],
     ...options.needsReact && options.reactCompilerPath ? ["react/compiler-runtime"] : []
   ];
   return { optimizeDepsEntries, optimizeDepsInclude };
@@ -357,7 +407,7 @@ var renderRuntimeModuleWiring = (generatedModulesDir) => {
 var blumeIntegrationOptions = (options) => options.ejected ? {
   buildArtifactsRoot: ".",
   contentRoutes: options.contentRoutes,
-  homeLinkHeader: buildHomeLinkHeader(options.config, options.contentRoutes) ?? undefined,
+  homeLinkHeader: buildHomeLinkHeader(options.config, options.contentRoutes, "dev") ?? undefined,
   pages: options.pages
 } : { pages: options.pages };
 var astroConfigTemplate = (options) => {
@@ -389,7 +439,8 @@ var astroConfigTemplate = (options) => {
     context,
     features,
     needsReact,
-    reactCompilerPath: options.reactCompilerPath
+    reactCompilerPath: options.reactCompilerPath,
+    searchKind: config.search.provider.kind
   });
   const {
     configEntries: adapterConfigEntries,
@@ -409,7 +460,7 @@ var astroConfigTemplate = (options) => {
       prefixDefaultLocale: !config.i18n.hideDefaultLocalePrefix
     }
   })},` : "";
-  const basedRedirects = applyBaseToAstroRedirects(config.redirects, config.basePath, deployment.options.base ?? "");
+  const basedRedirects = applyBaseToAstroRedirects(config.redirects, config.basePath, deployment.options.base ?? "", new Set(contentRoutes));
   const redirectsOption = basedRedirects.length > 0 ? `
   redirects: ${JSON.stringify(Object.fromEntries(basedRedirects.map((redirect) => [
     redirect.from,
@@ -428,7 +479,7 @@ var astroConfigTemplate = (options) => {
     return {
       ...face,
       src: [
-        isAbsolute2(variant.src) ? variant.src : join2(context.root, variant.src)
+        isAbsolute2(variant.src) ? variant.src : join3(context.root, variant.src)
       ]
     };
   }))} } }` : `{ provider: fontProviders.${font.provider}(), name: ${JSON.stringify(font.name)}, cssVariable: ${JSON.stringify(font.cssVariable)}, weights: ${astroFontWeights(font.weights)}, subsets: ${JSON.stringify(font.subsets)}, fallbacks: ${JSON.stringify(font.fallbacks)} }`).join(", ")}],` : "";
@@ -562,6 +613,10 @@ ${userConfigSetup}export default defineConfig({
     // \`/bundle\` subpath that is actually imported: optimizing the package
     // root leaves that entry out. Production (Rollup) already handles the
     // interop, so all of this only affects dev.
+    //
+    // The search adapter's client library rides the list for the same reason
+    // as the compiler runtime: the search dialog lazy-imports it on first
+    // open, and discovering it then re-optimizes and reloads the page.
     optimizeDeps: {
       entries: ${JSON.stringify(optimizeDepsEntries)},
       include: ${JSON.stringify(optimizeDepsInclude)},
@@ -601,7 +656,7 @@ ${userConfigSetup}export default defineConfig({
 });
 `;
 };
-var stagedContentDir = (outDir) => join2(outDir, "content");
+var stagedContentDir = (outDir) => join3(outDir, "content");
 var runtimeDirWithin = (base, outDir) => {
   const rel = relative2(base, outDir);
   return rel && !rel.startsWith("..") && !isAbsolute2(rel) ? rel : null;
@@ -753,6 +808,7 @@ const ground = createAskContext(askData${groundOptions});
       ${streamFields.join(`,
       `)},
 ${onError}
+      abortSignal: request.signal,
     });`;
   const stream = grounded ? `    const instructions =
       (await ground(messages, body.page)) ??
@@ -834,9 +890,9 @@ var featuresTemplate = (features) => `// Generated by Blume. Do not edit.
 export const loadMermaid: (() => Promise<unknown>) | null = ${features.mermaid ? '() => import("blume/components/content/mermaid-element.ts")' : "null"};
 
 /** The EPUB generator's browser bundle; null when export.epub is off. */
-export const loadEpub:
+${features.epub ? `export const loadEpub:
   | (() => Promise<typeof import("epub-gen-memory/bundle")>)
-  | null = ${features.epub ? '() => import("epub-gen-memory/bundle")' : "null"};
+  | null = () => import("epub-gen-memory/bundle");` : "export const loadEpub: (() => Promise<unknown>) | null = null;"}
 `;
 var searchClientTemplate = (config) => {
   const { provider } = config.search;
@@ -973,18 +1029,29 @@ const TYPES: Record<string, string> = {
   ".ico": "image/x-icon",
   ".jpeg": "image/jpeg",
   ".jpg": "image/jpeg",
+  ".mov": "video/quicktime",
+  ".mp4": "video/mp4",
+  ".ogv": "video/ogg",
   ".png": "image/png",
   ".svg": "image/svg+xml",
   ".tiff": "image/tiff",
+  ".webm": "video/webm",
   ".webp": "image/webp",
 };
 
+const extensionOf = (path: string): string =>
+  path.slice(path.lastIndexOf(".")).toLowerCase();
+
 const contentType = (path: string): string =>
-  TYPES[path.slice(path.lastIndexOf(".")).toLowerCase()] ??
-  "application/octet-stream";
+  TYPES[extensionOf(path)] ?? "application/octet-stream";
+
+// A source downloads only images and videos; anything else in the staged
+// directory (a page an older build saved under its URL's extension) is never
+// published from the docs origin.
+const isMedia = (path: string): boolean => Object.hasOwn(TYPES, extensionOf(path));
 
 const stagedParams = async (): Promise<string[]> => {
-  if (!existsSync(STAGED_DIR)) {
+  if (STAGED_DIR === null || !existsSync(STAGED_DIR)) {
     return [];
   }
   const entries = await readdir(STAGED_DIR, {
@@ -992,7 +1059,7 @@ const stagedParams = async (): Promise<string[]> => {
     withFileTypes: true,
   });
   return entries
-    .filter((entry) => entry.isFile())
+    .filter((entry) => entry.isFile() && isMedia(entry.name))
     .map((entry) =>
       relative(STAGED_DIR, join(entry.parentPath, entry.name)).replaceAll(
         "\\\\",
@@ -1013,6 +1080,9 @@ const resolveAsset = (asset: string): string | null => {
   if (asset.startsWith("content/")) {
     return files[asset.slice("content/".length)] ?? null;
   }
+  if (STAGED_DIR === null) {
+    return null;
+  }
   const abs = resolve(STAGED_DIR, asset);
   // Traversal guard: the dev server renders on demand, so the param is
   // attacker-controlled there — never step outside the staged directory.
@@ -1022,7 +1092,7 @@ const resolveAsset = (asset: string): string | null => {
   // asset — and a bare prefix also admits a sibling directory that merely
   // shares the name.
   const rel = relative(STAGED_DIR, abs);
-  if (rel === "" || rel.startsWith("..") || isAbsolute(rel)) {
+  if (rel === "" || rel.startsWith("..") || isAbsolute(rel) || !isMedia(rel)) {
     return null;
   }
   return existsSync(abs) ? abs : null;
@@ -1036,11 +1106,12 @@ export const GET: APIRoute = async ({ params }) => {
   const body = await readFile(path);
   const type = contentType(path);
   // An SVG opened directly is a document that can run script; the sandbox
-  // keeps an uploaded one inert on the docs origin. Static hosts get the same
-  // header from the build's header rules.
+  // keeps an uploaded one inert on the docs origin. This endpoint
+  // prerenders, so these headers reach dev only: a build serves the files
+  // with the same headers from its host's rules (see deploy/headers.ts).
   const headers: Record<string, string> =
     type === "image/svg+xml"
-      ? { "Content-Security-Policy": ${JSON.stringify(SVG_ASSET_POLICY)}, "Content-Type": type }
+      ? { ...${JSON.stringify(SVG_ASSET_HEADERS)}, "Content-Type": type }
       : { "Content-Type": type };
   return new Response(new Uint8Array(body), { headers });
 };
@@ -1100,7 +1171,7 @@ export function GET({ props }: { props: { section: string } }) {
 var navFragmentTemplate = () => `---
 // Generated by Blume. Do not edit.
 import NavTree from "blume/components/layout/NavTree.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import {
   hiddenDefaultLocale,
   navGroupIds,
@@ -1139,7 +1210,7 @@ if (!(variant && node && node.kind === "group")) {
 }
 const strings =
   locale === "default" ? data.ui.nav : (data.uiByLocale[locale] ?? data.ui).nav;
-const fragmentBase = withBase(\`/blume-nav/\${version}/\${locale}\`);
+const fragmentBase = withMountedBase(\`/blume-nav/\${version}/\${locale}\`);
 ---
 
 <NavTree
@@ -1155,7 +1226,7 @@ const fragmentBase = withBase(\`/blume-nav/\${version}/\${locale}\`);
 `;
 var ogEndpointTemplate = (customRoutes = [], og = {}, includeChangelog = false) => `// Generated by Blume. Do not edit.
 import { cachedOgImage } from "blume/og";
-import type { OgCache, OgFont, OgFontFamilies } from "blume/og";
+import type { OgCache, OgFont, OgFontFamilies, OgGoogleFont } from "blume/og";
 import data from "blume:data";
 
 export const prerender = true;
@@ -1171,6 +1242,9 @@ const customRoutes: { slug: string; title: string }[] = ${JSON.stringify(customR
 // data that pages serialize into HTML.
 const fonts: OgFont[] = ${JSON.stringify(og.fonts ?? [])};
 const families: OgFontFamilies | undefined = ${og.families ? JSON.stringify(og.families) : "undefined"};
+// Script fallbacks (Noto families, the configured locales' first). A card
+// fetches them only when its text has a glyph Takumi's built-in font lacks.
+const fallbacks: OgGoogleFont[] = ${JSON.stringify(og.fallbacks ?? [])};
 
 // Rendered cards are kept on disk between builds, keyed by everything that
 // decides their pixels, so a rebuild renders only the cards whose title,
@@ -1237,6 +1311,7 @@ export async function GET({ props }: { props: CardProps }) {
     accent: data.config.og.palette?.accent ?? data.config.theme.accent.light,
     brand: data.config.title,
     description: props.description ?? data.config.og.description,
+    fallbacks,
     families,
     fonts,
     logo: data.config.og.logo,
@@ -1389,8 +1464,8 @@ var catchAllPageTemplate = (options) => {
 import { getEntry, render } from "astro:content";
 import type { CollectionKey } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
-import { stripBasePath, withBasePath } from "blume/core/base-path.ts";
+import { withBase, withMountedBase } from "blume/components/islands/base-path.ts";
+import { mountBasePath, stripBasePath } from "blume/core/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 ${componentImports}
 import data from "blume:data";
@@ -1455,12 +1530,16 @@ const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 const ogPath = data.config.og.enabled
   ? encodeURI(\`/og/\${route === "/" ? "index" : route.slice(1)}.png\`)
   : null;
-const ogRel = seo.image ?? ogPath;
 // 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}\${withBase(ogRel)}\` : ogRel;
+// an external URL, which passes through verbatim (mirrors PageLayout). An
+// authored \`seo.image\` keeps a base written by hand; the generated card is
+// always mounted under it.
+const absoluteOg = (path: string, based: (path: string) => string) =>
+  base && path.startsWith("/") ? \`\${base}\${based(path)}\` : path;
+const ogImage = seo.image
+  ? absoluteOg(seo.image, withBase)
+  : ogPath && absoluteOg(ogPath, withMountedBase);
 // Blume's generated card has known dimensions the layout can declare; a user's
 // \`seo.image\` could be any size or format, so it gets none.
 const ogGenerated = !seo.image && Boolean(ogPath);
@@ -1469,7 +1548,7 @@ const ogGenerated = !seo.image && Boolean(ogPath);
 // itself (a guest post crediting its own author) over the configured default.
 const x = { ...data.config.x, ...(seo.x?.creator ? { creator: seo.x.creator } : {}) };
 
-const basedRoute = withBase(route);
+const basedRoute = withMountedBase(route);
 
 // Locale resolution. With i18n on, pick the active locale's nav + dictionary,
 // build hreflang alternates, and derive the language-switcher targets.
@@ -1517,7 +1596,7 @@ const contentDir = i18n
   : "ltr";
 // The root route keeps its trailing slash (\`https://site/\`) so canonical and
 // hreflang URLs byte-match the sitemap's <loc> for the home page.
-const absolute = (path: string) => base + withBase(path);
+const absolute = (path: string) => base + withMountedBase(path);
 
 // A fallback page renders the fallback locale's page at this locale's URL, so
 // its canonical names the page it copies, and search engines never rank the
@@ -1562,7 +1641,7 @@ const xDefault = defaultAlt && base ? absolute(defaultAlt.path) : null;
 // carries sits *after* the base (\`/docs/ja/guide\`), while \`localePrefix\` is
 // base-less (\`/ja\`). Stripping and re-adding a locale therefore happen in
 // base-less space, with the base re-applied at the end — the same
-// \`withBasePath(basePath, localizeRoute(...))\` composition the manifest uses to
+// \`mountBasePath(basePath, localizeRoute(...))\` composition the manifest uses to
 // build every real route. Done in based space, \`stripLocale\` matches nothing
 // and \`localizeRoute\` prepends a second prefix (\`/ja/docs/ja/guide\`). Only a
 // switcher entry for a locale with no real translation reaches this fallback:
@@ -1570,7 +1649,7 @@ const xDefault = defaultAlt && base ? absolute(defaultAlt.path) : null;
 // generated reference (which has no \`alternates\` at all) for every locale
 // but its own.
 const mountLocalized = (logical: string, codeArg: string) =>
-  withBasePath(data.config.basePath, localizeRoute(logical, codeArg));
+  mountBasePath(data.config.basePath, localizeRoute(logical, codeArg));
 const logicalRoute = i18n
   ? stripLocale(stripBasePath(data.config.basePath, route), locale)
   : route;
@@ -1599,7 +1678,7 @@ const versionRootFor = (id: string) => {
   const logical = id ? \`/\${id}\` : "/";
   return i18n
     ? mountLocalized(logical, locale)
-    : withBasePath(data.config.basePath, logical);
+    : mountBasePath(data.config.basePath, logical);
 };
 const samePageSwitch = versionsConfig
   ? versionsConfig.switcher.redirect === "same-page"
@@ -1697,7 +1776,7 @@ const LayoutComponent = resolveSlot(layoutOverrides.Layout, RootLayout);
   feedback={data.config.feedback}
   exportPdf={${options.exportPdf}}
   exportEpub={${options.exportEpub}}${options.navFragments ? `
-  navFragmentBase={withBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}` : ""}
+  navFragmentBase={withMountedBase(\`/blume-nav/\${version || "current"}/\${i18n && localePrefix(locale) ? locale : "default"}\`)}` : ""}
   openInChat={data.config.openInChat}
   feeds={data.feeds}
   discovery={data.config.discovery}
@@ -1725,7 +1804,7 @@ var changelogIndexTemplate = (options) => {
 // Generated by Blume. Do not edit.
 import { getCollection } from "astro:content";
 import RootLayout from "blume/components/layout/RootLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { resolveSlot } from "blume/components/layout/overrides.ts";
 import { resolveDateFormatOptions } from "blume/core/date-format.ts";
 import { layoutOverrides } from "../generated/components.ts";
@@ -1824,7 +1903,7 @@ const items = changelogEntries.map((entry) => {
   return {
     date: date ? formatRowDate(date) : null,
     dateTime: date ? date.toISOString().slice(0, 10) : null,
-    href: route ? withBase(route) : null,
+    href: route ? withMountedBase(route) : null,
     id: slugify(label),
     label,
     tag: entry.data.changelog?.category ?? null,
@@ -1860,14 +1939,14 @@ for (const item of items) {
 
 const base = data.config.site ? data.config.site.replace(/\\/$/, "") : null;
 // The canonical URL carries the deployment base (the page is served under it),
-// matching how the catch-all canonicalizes via \`withBase(route)\`.
-const basedRoute = withBase("/changelog");
+// matching how the catch-all canonicalizes via \`withMountedBase(route)\`.
+const basedRoute = withMountedBase("/changelog");
 const canonical = base ? base + basedRoute : null;
 
 // The generated OG card for this route (the /og endpoint emits it alongside
 // the content-route cards), absolutized like the catch-all's so crawlers get
 // a full URL when the site is known.
-const ogPath = data.config.og.enabled ? withBase("/og/changelog.png") : null;
+const ogPath = data.config.og.enabled ? withMountedBase("/og/changelog.png") : null;
 const ogImage = ogPath && base ? base + ogPath : ogPath;
 
 // The page chrome (h1, title, description) comes from the translatable
@@ -1979,7 +2058,8 @@ var notFoundPageTemplate = () => `---
 // Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
 import Icon from "blume/components/Icon.astro";
 import PageLayout from "blume/components/layout/PageLayout.astro";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
+import { mountBasePath } from "blume/core/base-path.ts";
 import data from "blume:data";
 
 export const prerender = true;
@@ -2003,22 +2083,27 @@ const htmlLang = i18n ? i18n.defaultLocale : "en";
 // their resolved target when the section has no index page of its own.
 const suggestions = [
   ...data.navigation.tabs.map((tab) => ({
-    href: withBase(tab.href ?? tab.path),
+    href: withMountedBase(tab.href ?? tab.path),
     label: tab.label,
   })),
   ...(data.config.discovery.sitemap
-    ? [{ href: withBase("/sitemap.xml"), label: nf.sitemap }]
+    ? [{ href: withMountedBase("/sitemap.xml"), label: nf.sitemap }]
     : []),
   ...(data.config.discovery.llmsTxt
-    ? [{ href: withBase("/llms.txt"), label: nf.llms }]
+    ? [{ href: withMountedBase("/llms.txt"), label: nf.llms }]
     : []),
 ];
 
 // Every host serves this one page for any missing URL, so a reader who
 // mistyped \`/ar/…\` would get the default locale's message. The other locales'
 // copy rides along, and the script below swaps it in when the URL's first
-// segment names one of them — the message, its language and direction, the
-// tab title, and the home link (to that locale's root).
+// segment past the site's base names one of them — the message, its language
+// and direction, the tab title, and the home link (to that locale's root).
+// Localized routes sit under both bases (\`{deployment.base}/{basePath}/ar/…\`),
+// so the script strips the two together, trailing slash included.
+const { basePath } = data.config;
+const siteRoot = withMountedBase(mountBasePath(basePath, "/"));
+const localeBase = siteRoot.endsWith("/") ? siteRoot : siteRoot + "/";
 const localized = Object.fromEntries(
   (i18n?.locales ?? [])
     .filter((l) => l.code !== i18n?.defaultLocale && data.uiByLocale[l.code])
@@ -2030,7 +2115,7 @@ const localized = Object.fromEntries(
           description: strings.description,
           dir: l.dir ?? "ltr",
           home: strings.home,
-          homeHref: withBase("/" + l.code),
+          homeHref: withMountedBase(mountBasePath(basePath, "/" + l.code)),
           suggestions: strings.suggestions,
           title: strings.title,
         },
@@ -2059,7 +2144,7 @@ const localizedJson = JSON.stringify(localized).replaceAll("<", "\\\\u003c");
 >
   <div
     class="mx-auto grid w-full max-w-5xl gap-12 px-6 py-20 sm:py-28 md:grid-cols-[3fr_2fr] md:gap-16 lg:gap-24 lg:py-36"
-    data-base={withBase("/")}
+    data-base={localeBase}
     data-blume-not-found
   >
     <div class="flex flex-col items-start">
@@ -2080,7 +2165,7 @@ const localizedJson = JSON.stringify(localized).replaceAll("<", "\\\\u003c");
       <a
         class="mt-8 inline-flex items-center gap-1.5 rounded-full bg-accent py-2 pe-4 ps-3.5 text-sm font-medium text-accent-foreground transition-opacity hover:opacity-90"
         data-nf-home
-        href={withBase("/")}
+        href={withMountedBase("/")}
       >
         <Icon class="rtl:-scale-x-100" name="arrow-left" size={14} />
         <span data-nf="home">{nf.home}</span>
@@ -2147,7 +2232,7 @@ const localizedJson = JSON.stringify(localized).replaceAll("<", "\\\\u003c");
 </PageLayout>
 `;
 var notFoundMarkdownTemplate = () => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { absoluteUrl } from "blume/core/site-url.ts";
 import data from "blume:data";
 
@@ -2158,7 +2243,7 @@ const nf = data.ui.notFound;
 // Absolute for internal routes when the site is known; an external tab href
 // passes through untouched.
 const href = (path: string): string => {
-  const based = withBase(path);
+  const based = withMountedBase(path);
   return data.config.site && based.startsWith("/") && !based.startsWith("//")
     ? absoluteUrl(data.config.site, based)
     : based;
@@ -2206,7 +2291,7 @@ export function GET() {
 `;
 var notFoundJsonTemplate = () => `// Generated by Blume. Do not edit. Override by adding \`pages/404.astro\`.
 import { problem } from "blume/ai/api/problem.ts";
-import { withBase } from "blume/components/islands/base-path.ts";
+import { withMountedBase } from "blume/components/islands/base-path.ts";
 import { absoluteUrl } from "blume/core/site-url.ts";
 import data from "blume:data";
 
@@ -2217,7 +2302,7 @@ const nf = data.ui.notFound;
 // Absolute for internal routes when the site is known; an external tab href
 // passes through untouched.
 const href = (path: string): string => {
-  const based = withBase(path);
+  const based = withMountedBase(path);
   return data.config.site && based.startsWith("/") && !based.startsWith("//")
     ? absoluteUrl(data.config.site, based)
     : based;
@@ -2379,11 +2464,20 @@ const Example = entry.Component;
           root.dataset.theme = theme;
           root.classList.toggle("dark", theme === "dark");
         };
-        const stored = () =>
-          localStorage.getItem("blume-theme") ??
-          (matchMedia("(prefers-color-scheme: dark)").matches
-            ? "dark"
-            : "light");
+        // Blocked storage (a sandboxed or privacy-locked frame) throws on
+        // access; it falls through to the OS setting like an unset preference.
+        const stored = () => {
+          let theme = null;
+          try {
+            theme = localStorage.getItem("blume-theme");
+          } catch {}
+          return (
+            theme ??
+            (matchMedia("(prefers-color-scheme: dark)").matches
+              ? "dark"
+              : "light")
+          );
+        };
         try {
           const host = window.parent.document.documentElement;
           apply(host.dataset.theme ?? stored());
@@ -2465,7 +2559,7 @@ var runtimeTsconfigTemplate = () => `${JSON.stringify({
 }, null, 2)}
 `;
 
-export { planComponentSlots, publishRuntimeModules, runtimeDependencies, EJECTED_CONFIG_HEADER, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
+export { deployOutputDir, deployStaticDir, surfaceAdapterOutput, planComponentSlots, publishRuntimeModules, runtimeDependencies, EJECTED_CONFIG_HEADER, astroConfigTemplate, stagedContentDir, contentConfigTemplate, askEndpointTemplate, askComponentTemplate, searchEndpointTemplate, featuresTemplate, searchClientTemplate, mixedbreadSearchEndpointTemplate, rawMarkdownEndpointTemplate, contentAssetsEndpointTemplate, mcpPageFile, mcpEndpointTemplate, playgroundProxyTemplate, staticJsonEndpointTemplate, rssEndpointTemplate, navFragmentTemplate, ogEndpointTemplate, scalarReferenceTemplate, catchAllPageTemplate, changelogIndexTemplate, notFoundPageTemplate, notFoundMarkdownTemplate, notFoundJsonTemplate, apiPagesIndexTemplate, apiPageTemplate, apiNavigationTemplate, apiSearchTemplate, apiNotFoundTemplate, exampleSlug, exampleWrapperTemplate, examplesRouteBase, exampleMapTemplate, examplesPageTemplate, runtimePackageTemplate, runtimeTsconfigTemplate };
 
-//# debugId=4C36F12BB67C30E764756E2164756E21
-//# sourceMappingURL=chunk-2hn4b8z7.js.map
+//# debugId=D53DB1B1EA2E6A3764756E2164756E21
+//# sourceMappingURL=chunk-5m5nmvyq.js.map