blume 2.0.0 → 2.0.2

package/dist/cli/{chunk-mnqj32sj.js → chunk-hr8ne106.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-xaz13gwg.js";
-import {
+  deployPlatform,
   BLUME_IGNORE_DIRS
-} from "./chunk-abh8yjkn.js";
+} from "./chunk-v6ya5kcb.js";
+import {
+  trimChar,
+  normalizeBasePath
+} from "./chunk-gs7r695n.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 = [];
@@ -168,9 +207,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 +220,7 @@ var WORKSPACE_MARKERS = [
   "yarn.lock"
 ];
 var hasWorkspacesField = (pkgPath) => {
-  if (!existsSync(pkgPath)) {
+  if (!existsSync2(pkgPath)) {
     return false;
   }
   try {
@@ -191,14 +230,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;
     }
@@ -255,8 +294,8 @@ var runtimeDependencies = (options) => {
       }
     }
   }
-  if (config.ai.ask?.enabled && !config.ai.ask.endpoint) {
-    deps.push(...config.ai.ask.provider.runtimeDeps);
+  if (config.ai.assistant?.enabled && !config.ai.assistant.endpoint) {
+    deps.push(...config.ai.assistant.provider.runtimeDeps);
   }
   deps.push(...config.deployment.runtimeDeps);
   return deps;
@@ -428,7 +467,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(", ")}],` : "";
@@ -601,7 +640,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;
@@ -740,7 +779,7 @@ const ground = createAskContext(askData${groundOptions});
   }));`;
   const { keyCheck } = backend.template;
   const onError = `      onError({ error }) {
-        console.error("Ask AI provider error:", error);
+        console.error("Assistant provider error:", error);
       },`;
   const streamFields = [
     `model: ${backend.template.model}`,
@@ -779,22 +818,22 @@ ${setup}${cors.setup}
 ${handler}
 `;
 };
-var askComponentTemplate = (askEnabled) => askEnabled ? `---
+var askComponentTemplate = (assistantEnabled) => assistantEnabled ? `---
 // Generated by Blume. Do not edit.
-import AskAI from "blume/components/islands/AskAI.astro";
+import Assistant from "blume/components/islands/Assistant.astro";
 import data from "blume:data";
 
 const { strings } = Astro.props;
 ---
 
-<AskAI
-  endpoint={data.config.ask?.endpoint ?? undefined}
-  strings={strings ?? data.ui.ask}
-  suggestions={data.config.ask?.suggestions ?? []}
+<Assistant
+  endpoint={data.config.assistant?.endpoint ?? undefined}
+  strings={strings ?? data.ui.assistant}
+  suggestions={data.config.assistant?.suggestions ?? []}
 />
 ` : `---
 // Generated by Blume. Do not edit.
-// Ask AI is off (\`ai.ask.enabled\`), so the header's Ask trigger renders nothing.
+// The assistant is off (\`ai.assistant.enabled\`), so the header's Ask trigger renders nothing.
 // Deliberately imports no React island, keeping the JSX renderer out of projects
 // that don't need it.
 ---
@@ -834,9 +873,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 +1012,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 +1042,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 +1063,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 +1075,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 +1089,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 });
 };
@@ -1980,6 +2034,7 @@ var notFoundPageTemplate = () => `---
 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 { withBasePath } from "blume/core/base-path.ts";
 import data from "blume:data";
 
 export const prerender = true;
@@ -2017,8 +2072,13 @@ const suggestions = [
 // 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 = withBase(withBasePath(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 +2090,7 @@ const localized = Object.fromEntries(
           description: strings.description,
           dir: l.dir ?? "ltr",
           home: strings.home,
-          homeHref: withBase("/" + l.code),
+          homeHref: withBase(withBasePath(basePath, "/" + l.code)),
           suggestions: strings.suggestions,
           title: strings.title,
         },
@@ -2059,7 +2119,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">
@@ -2379,11 +2439,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 +2534,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=9E2BF1A2CC0BBFF264756E2164756E21
-//# sourceMappingURL=chunk-mnqj32sj.js.map
+//# debugId=941D4E587200F86C64756E2164756E21
+//# sourceMappingURL=chunk-hr8ne106.js.map