blume 2.1.0 → 2.1.1

package/src/cli/commands/eval.ts

@@ -104,12 +104,37 @@ const parseFlags = (args: EvalFlags) => {
   return { agent: args.agent, threshold, timeoutS };
 };
 
+/** A shell word for the rerun command, single-quoted only when it has to be. */
+const shellWord = (value: string): string =>
+  /^[\w./:@%+=,-]+$/u.test(value)
+    ? value
+    : `'${value.replaceAll("'", String.raw`'\''`)}'`;
+
+/**
+ * The command a `--fix` agent reruns to verify its edits. It carries the run's
+ * own flags: a bare `blume eval` would fall back to Codex and `evals.yaml`,
+ * grading a different file with a different agent than the run it's fixing.
+ */
+const rerunCommand = (
+  args: EvalFlags,
+  { agent, threshold, timeoutS }: ReturnType<typeof parseFlags>
+): string =>
+  [
+    `blume eval --agent ${agent}`,
+    args.file === DEFAULT_FILE ? "" : `--file ${shellWord(args.file)}`,
+    args.threshold === undefined ? "" : `--threshold ${threshold}`,
+    args.timeout === undefined ? "" : `--timeout ${timeoutS}`,
+  ]
+    .filter((part) => part !== "")
+    .join(" ");
+
 /** `blume eval --fix`: hand the failing report to the interactive agent. */
 const runFixHandoff = async (
   agent: AgentKind,
   result: EvalResult,
   root: string,
-  threshold: number
+  threshold: number,
+  command: string
 ): Promise<void> => {
   const count = result.counts.fail + result.counts.error;
   if (count === 0) {
@@ -120,7 +145,7 @@ const runFixHandoff = async (
   process.stderr.write(
     `  Handing ${count} failed question${count === 1 ? "" : "s"} to ${cli.name}…\n\n`
   );
-  const code = await launchAgentCode(agent, evalFixPrompt(report));
+  const code = await launchAgentCode(agent, evalFixPrompt(report, command));
   if (code !== 0) {
     process.exit(code);
   }
@@ -184,7 +209,8 @@ export const evalCommand = defineCommand({
   meta: commandMeta.eval,
   async run({ args }) {
     const root = process.cwd();
-    const { agent, threshold, timeoutS } = parseFlags(args);
+    const flags = parseFlags(args);
+    const { agent, threshold, timeoutS } = flags;
     if (args.action === "init") {
       await runInit(agent, args.file);
       return;
@@ -259,7 +285,13 @@ export const evalCommand = defineCommand({
     if (args.fix) {
       // The gate is a CI concern; a handoff run succeeds when the agent
       // session does, not when the docs already passed.
-      await runFixHandoff(agent, result, root, threshold);
+      await runFixHandoff(
+        agent,
+        result,
+        root,
+        threshold,
+        rerunCommand(args, flags)
+      );
       return;
     }
 

package/src/cli/commands/init.ts

@@ -272,14 +272,16 @@ export const initCommand = defineCommand({
     // which `init` leaves alone; say what it still needs before installing.
     const note = workspaceNote(root, answers, env);
 
-    // Keep installed dependencies, Blume's generated runtime (`.blume/`), and
-    // build output (`dist/`) out of version control. Idempotent: creates
-    // `.gitignore` when absent and skips entries already present
-    // (trailing-slash agnostic).
+    // Keep installed dependencies, Blume's generated runtime (`.blume/`),
+    // build output (`dist/`), and local secrets (`.env.local`, where every
+    // missing-secret warning says to put them) out of version control.
+    // Idempotent: creates `.gitignore` when absent and skips entries already
+    // present (trailing-slash agnostic).
     const ignored = await ensureGitignore(root, [
       "node_modules/",
       ".blume/",
       "dist/",
+      ".env.local",
     ]);
     if (ignored.length > 0) {
       sink.success(`Added ${ignored.join(", ")} to .gitignore`);

package/src/cli/commands/validate.ts

@@ -13,6 +13,7 @@ import { validateLinks } from "../../core/links.ts";
 import { buildManifest } from "../../core/manifest.ts";
 import { scanProject } from "../../core/project-graph.ts";
 import type { Diagnostic } from "../../core/types.ts";
+import { parseIgnoreFlag } from "../args.ts";
 import { commandMeta } from "../command-meta.ts";
 import { reportInternalError } from "../internal-error.ts";
 import {
@@ -28,6 +29,12 @@ export const validateCommand = defineCommand({
       description: "Check external (HTTP) links over the network.",
       type: "boolean",
     },
+    ignore: {
+      description:
+        'With --external, skip external links whose URL matches this glob (e.g. "https://example.com/**"). Repeat it for more; internal links are always checked.',
+      type: "string",
+      valueHint: "glob",
+    },
     json: {
       description: "Emit diagnostics as JSON on stdout (for CI/editors).",
       type: "boolean",
@@ -38,8 +45,9 @@ export const validateCommand = defineCommand({
     },
   },
   meta: commandMeta.validate,
-  async run({ args }) {
+  async run({ args, rawArgs }) {
     const root = process.cwd();
+    const ignore = parseIgnoreFlag(rawArgs);
     const diagnostics: Diagnostic[] = [];
 
     try {
@@ -83,6 +91,7 @@ export const validateCommand = defineCommand({
           checkExternal: Boolean(args.external),
           extraRoutes,
           i18n: project.config.i18n,
+          ignore,
           publicDir: existsSync(publicDir) ? publicDir : null,
           redirects: project.config.redirects,
         }))

package/src/cli/init/scaffold.ts

@@ -679,7 +679,7 @@ const ESBUILD_APPROVAL = "  allowBuilds:\n    esbuild: true";
  * What the project still needs from a workspace it sits in, when `init` left
  * that workspace's config alone: a place in a pnpm workspace's `packages`
  * (pnpm skips a folder it doesn't list), pnpm's approval for esbuild's build
- * script (pnpm 10 and later fail the install without it), or Yarn Berry's
+ * script (pnpm 11 and later fail the install without it), or Yarn Berry's
  * `node_modules` linker. Undefined when the workspace already has it, or the
  * project doesn't sit in one.
  */
@@ -699,12 +699,12 @@ export const workspaceNote = (
       const entry = `  packages:\n    - ${relative(workspace, root)}`;
       return approved
         ? `This folder sits inside the pnpm workspace at ${file}, which doesn't list it under packages, so pnpm won't install it. Add it there before installing:\n\n${entry}`
-        : `This folder sits inside the pnpm workspace at ${file}, which doesn't list it under packages, so pnpm won't install it. Add it there before installing, and approve esbuild's build script, or pnpm 10 and later stop the install:\n\n${entry}\n${ESBUILD_APPROVAL}`;
+        : `This folder sits inside the pnpm workspace at ${file}, which doesn't list it under packages, so pnpm won't install it. Add it there before installing, and approve esbuild's build script, or pnpm 11 and later stop the install:\n\n${entry}\n${ESBUILD_APPROVAL}`;
     }
     if (approved) {
       return;
     }
-    return `This project joins the pnpm workspace at ${file}. Approve esbuild's build script there before installing, or pnpm 10 and later stop the install:\n\n${ESBUILD_APPROVAL}`;
+    return `This project joins the pnpm workspace at ${file}. Approve esbuild's build script there before installing, or pnpm 11 and later stop the install:\n\n${ESBUILD_APPROVAL}`;
   }
   if (answers.packageManager !== "yarn" || yarnMajor(env.userAgent) === 1) {
     return;

package/src/cli/prepare.ts

@@ -59,6 +59,12 @@ export const prepareProject = async (
   let project: BlumeProject;
   try {
     project = await scanProject(options.root, {
+      // Fail-fast on missing secrets: warn now, not at the first request, and
+      // before the sources fetch, so a source that can't authenticate on a
+      // fresh build still gets its variable named.
+      beforeSources: (config) => {
+        reportDiagnostics(checkRequiredSecrets(config), options.root);
+      },
       devServerUrl: options.devServerUrl,
       mode: options.mode,
       overrides: options.overrides,
@@ -138,8 +144,5 @@ export const prepareProject = async (
     logger.warn(warning);
   }
 
-  // Fail-fast on missing runtime secrets: warn now, not at the first request.
-  reportDiagnostics(checkRequiredSecrets(project.config), options.root);
-
   return project;
 };

package/src/cli/required-secrets.ts

@@ -61,7 +61,7 @@ const adapterSecretOwners = (config: ResolvedConfig): SecretOwner[] => {
  * the failure surfaces at `blume dev`/`build` instead of at the first request in
  * production. These are runtime secrets (the endpoint reads them on the server),
  * so this warns rather than hard-fails — the value may live only in the deploy
- * environment. Build-time secrets (search-index sync) already warn during sync.
+ * environment. Build-time secrets (search-index sync) are checked by the sync.
  */
 export const checkRequiredSecrets = (config: ResolvedConfig): Diagnostic[] => {
   const diagnostics: Diagnostic[] = [];

package/src/components/content/ApiPlayground.astro

@@ -11,7 +11,10 @@ import { operationModel } from "../openapi/operation-model.ts";
 import Playground from "../openapi/Playground.astro";
 import { buildRequest, defaultValues } from "../openapi/request.ts";
 import RequestPanel from "../openapi/RequestPanel.astro";
-import { sampleLanguages } from "../openapi/snippets.ts";
+import {
+  DEFAULT_SAMPLE_LANGUAGES,
+  sampleLanguages,
+} from "../openapi/snippets.ts";
 import {
   endpointBody,
   endpointParameters,
@@ -46,6 +49,7 @@ const tryIt = spec.playground !== "simple" && api.playground.enabled;
       model={model}
       operation={`${spec.method} ${spec.target}`}
       proxy={api.playground.proxy}
+      proxyConfig="api"
       slug="api-pages"
     />
   )
@@ -53,7 +57,7 @@ const tryIt = spec.playground !== "simple" && api.playground.enabled;
 {
   !spec.requestExample && (
     <RequestPanel
-      languages={sampleLanguages([])}
+      languages={sampleLanguages(DEFAULT_SAMPLE_LANGUAGES)}
       responses={{}}
       sample={buildRequest(model, defaultValues(model))}
       schemas={{}}

package/src/components/content/api-field.ts

@@ -43,7 +43,10 @@ export interface ParamFieldProps extends FieldProps {
   /** The name, for a field with no location attribute. */
   name?: string;
   path?: string;
-  /** Placeholder text for the parameter's playground input. */
+  /**
+   * An example value: the one the playground and request samples start
+   * with, not an input's placeholder hint (see `fieldSchema`).
+   */
   placeholder?: string;
   query?: string;
 }

package/src/components/content/api-page.ts

@@ -1,3 +1,4 @@
+import { exampleValue } from "../openapi/helpers.ts";
 import type { ParameterLike, SchemaLike } from "../openapi/helpers.ts";
 import { resolveSecurity } from "../openapi/security.ts";
 import type { OperationSecurity } from "../openapi/security.ts";
@@ -168,19 +169,42 @@ export const endpointParameters = (fields: EndpointField[]): ParameterLike[] =>
         ]
   );
 
-/** The body fields as a JSON request body, or `undefined` when there are none. */
+/** Whether a field, or one nested in it, has a `default` or `placeholder`. */
+const hasValue = (field: EndpointField): boolean =>
+  field.default !== undefined ||
+  Boolean(field.placeholder) ||
+  (field.fields ?? []).some(hasValue);
+
+/**
+ * The fields a request starts with: required ones, and ones with a value to
+ * send. An optional field with neither is left for the reader to fill,
+ * rather than sent as the sampler's `"string"`, `0`, or `true`.
+ */
+const sentFields = (fields: EndpointField[]): EndpointField[] =>
+  fields
+    .filter((field) => field.required === true || hasValue(field))
+    .map((field) => ({ ...field, fields: sentFields(field.fields ?? []) }));
+
+/**
+ * The body fields as a JSON request body, or `undefined` when there are none.
+ * Its example, which the playground and samples start from, holds only the
+ * {@link sentFields}.
+ */
 export const endpointBody = (fields: EndpointField[]) => {
   const body = fields.filter((field) => field.location === "body");
+  const object = (members: EndpointField[]): SchemaLike =>
+    fieldSchema({
+      fields: members,
+      location: "body",
+      name: "",
+      type: "object",
+    });
   return body.length > 0
     ? {
         content: {
           "application/json": {
-            schema: fieldSchema({
-              fields: body,
-              location: "body",
-              name: "",
-              type: "object",
-            }),
+            example: exampleValue(object(sentFields(body)), {}),
+            schema: object(body),
           },
         },
       }

package/src/components/content/mermaid-element.ts

@@ -55,6 +55,9 @@ export class BlumeMermaid extends HTMLElement {
         look: "classic",
         securityLevel: "strict",
         startOnLoad: false,
+        // Without this, a diagram that fails to parse leaves Mermaid's own
+        // "Syntax error in text" graphic appended to <body>, below the page.
+        suppressErrorRendering: true,
         theme: prefersDark() ? "dark" : "default",
       });
       try {
@@ -71,13 +74,24 @@ export class BlumeMermaid extends HTMLElement {
           // oxlint-disable-next-line github/no-inner-html -- Mermaid-generated SVG must be injected as HTML
           output.innerHTML = svg;
         }
-      } catch {
+      } catch (error) {
         // Localized message stamped on <body> by RootLayout's markup (the
         // data-attribute channel); English fallback when the attribute is
         // missing (a stale snapshot or a custom layout).
         output.textContent =
           document.body.dataset.i18nDiagramError ||
           "Could not render this diagram.";
+        // Readers get only the message above; the writer needs Mermaid's
+        // parser error (line and expected token) to fix the source. It goes
+        // to the console, and `blume dev` also shows it under the message.
+        console.error("[blume] Mermaid could not render a diagram:", error);
+        if (import.meta.env.DEV) {
+          const detail = document.createElement("pre");
+          detail.className =
+            "mt-2 overflow-x-auto text-muted-foreground text-xs";
+          detail.textContent = String(error);
+          output.append(detail);
+        }
       }
       output.removeAttribute("aria-busy");
     };

package/src/components/islands/hooks.ts

@@ -1,5 +1,9 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 
+import {
+  ASK_MAX_MESSAGES,
+  ASK_MAX_MESSAGES_CHARS,
+} from "../../ai/ask-limits.ts";
 import { captchaToken } from "../../captcha/client.ts";
 import type { CaptchaSettings } from "../../captcha/schema.ts";
 import type { BlumeClientData } from "../../core/data.ts";
@@ -264,6 +268,28 @@ const refusalNotice = (
 const currentPath = (): string =>
   stripBase(import.meta.env.BASE_URL, window.location.pathname);
 
+/**
+ * The conversation as the route is sent it: all of it while it fits the
+ * route's limits (`ai/ask-limits.ts`), else the latest turns that do, the
+ * oldest dropped first, so a long chat keeps working instead of answering
+ * `400`. The kept turns open with a question, not an answer cut from its
+ * own, and the question being asked always goes, even alone over the limit.
+ */
+const withinAskLimits = (history: AskMessage[]): AskMessage[] => {
+  const last = history.length - 1;
+  let start = Math.max(0, history.length - ASK_MAX_MESSAGES);
+  while (
+    start < last &&
+    JSON.stringify(history.slice(start)).length > ASK_MAX_MESSAGES_CHARS
+  ) {
+    start += 1;
+  }
+  while (start < last && history[start]?.role !== "user") {
+    start += 1;
+  }
+  return history.slice(start);
+};
+
 /**
  * Stream answers from the assistant endpoint. Mirrors the built-in assistant island so
  * a custom chat UI shares the same grounded, page-aware backend.
@@ -366,7 +392,7 @@ export const useAssistant = (
         }
         const payload: AskPayload = {
           captcha: token,
-          messages: history,
+          messages: withinAskLimits(history),
           page: { path },
         };
         const response = await fetch(endpoint, {

package/src/components/layout/PageActions.astro

@@ -89,6 +89,10 @@ const providers = (openInChat ?? openInChatProviders).map((key) => ({
 // keep that separator only while a configured list preserves v0 first.
 const chatSeparator = providers.length > 1 && providers[0]?.key === "v0";
 
+// The block renders once, for the right rail. Below `xl` the script moves it
+// into the mobile "On this page" dropdown, and the global styles below the
+// markup restyle it there from that container.
+
 // Top-level actions match the ToC links: flat, no background/padding, color
 // shift on hover only.
 const rowClass =
@@ -98,6 +102,8 @@ const rowClass =
 // background).
 const menuRowClass =
   "flex w-full items-center gap-2.5 rounded-md px-2 py-1.5 text-start text-muted-foreground text-sm transition-colors hover:bg-muted hover:text-foreground";
+const panelClass =
+  "absolute top-full right-2 z-50 mt-1 w-max min-w-[14rem] max-w-[22rem] rounded-blume border border-border bg-background p-1 shadow-xl";
 ---
 
 <div
@@ -130,24 +136,24 @@ const menuRowClass =
     <span data-blume-copy-label>{a.copyMarkdown}</span>
   </button>
 
+  {/* Each chevron turns with its own <details> only: in the mobile dropdown
+      these nest inside the outline's <details>, and a `group-open` variant
+      would match that open ancestor too. */}
   {
     (exportPdf || exportEpub) && (
-      <details class="group relative" data-blume-dropdown>
+      <details class="relative" data-blume-dropdown>
         <summary
           class={`${rowClass} cursor-pointer list-none [&::-webkit-details-marker]:hidden`}
         >
           <Icon name="download" size={16} />
           {a.export}
           <Icon
-            class="ms-auto transition-transform group-open:rotate-180"
+            class="ms-auto transition-transform [details[open]>summary_&]:rotate-180"
             name="chevron-down"
             size={14}
           />
         </summary>
-        <div
-          class="absolute top-full right-2 z-50 mt-1 w-max min-w-[14rem] max-w-[22rem] rounded-blume border border-border bg-background p-1 shadow-xl"
-          data-blume-menu
-        >
+        <div class={panelClass} data-blume-menu>
           {exportPdf && (
             <button class={menuRowClass} data-blume-export-pdf type="button">
               <Icon name="file" size={16} />
@@ -169,22 +175,19 @@ const menuRowClass =
 
   {
     providers.length > 0 && (
-      <details class="group relative" data-blume-dropdown>
+      <details class="relative" data-blume-dropdown>
         <summary
           class={`${rowClass} cursor-pointer list-none [&::-webkit-details-marker]:hidden`}
         >
           <Icon name="external-link" size={16} />
           {a.openInChat}
           <Icon
-            class="ms-auto transition-transform group-open:rotate-180"
+            class="ms-auto transition-transform [details[open]>summary_&]:rotate-180"
             name="chevron-down"
             size={14}
           />
         </summary>
-        <div
-          class="absolute top-full right-2 z-50 mt-1 w-max min-w-[14rem] max-w-[22rem] rounded-blume border border-border bg-background p-1 shadow-xl"
-          data-blume-menu
-        >
+        <div class={panelClass} data-blume-menu>
           {providers.map((provider, index) => (
             <>
               {index === 1 && chatSeparator && (
@@ -208,22 +211,19 @@ const menuRowClass =
 
   {
     mcpUrl && (
-      <details class="group relative" data-blume-dropdown>
+      <details class="relative" data-blume-dropdown>
         <summary
           class={`${rowClass} cursor-pointer list-none [&::-webkit-details-marker]:hidden`}
         >
           <Icon name="plug" size={16} />
           {a.connectMcp}
           <Icon
-            class="ms-auto transition-transform group-open:rotate-180"
+            class="ms-auto transition-transform [details[open]>summary_&]:rotate-180"
             name="chevron-down"
             size={14}
           />
         </summary>
-        <div
-          class="absolute top-full right-2 z-50 mt-1 w-max min-w-[14rem] max-w-[22rem] rounded-blume border border-border bg-background p-1 shadow-xl"
-          data-blume-menu
-        >
+        <div class={panelClass} data-blume-menu>
           <button class={menuRowClass} data-mcp-copy-url type="button">
             <Icon name="link" size={16} />
             <span class="flex-1" data-mcp-url-label>
@@ -259,6 +259,45 @@ const menuRowClass =
   }
 </div>
 
+<style is:global>
+  /* Below `xl` the script moves the block into the mobile "On this page"
+     dropdown (see `placeActions`), where it reads like the outline above it:
+     under a rule, its rows padded like the outline's links, its groups
+     expanding in place under their row instead of floating, and without
+     Scroll to top, since that dropdown already sits at the top of the page. */
+  [data-blume-page-actions-mount] > [data-blume-page-actions] {
+    margin-top: 0;
+    border-top: 1px solid var(--blume-border);
+    padding: 0.5rem;
+  }
+  [data-blume-page-actions-mount] [data-blume-scroll-top] {
+    display: none;
+  }
+  [data-blume-page-actions-mount]
+    :is([data-blume-page-actions] > :is(a, button), summary) {
+    border-radius: 0.375rem;
+    padding-inline: 0.5rem;
+  }
+  [data-blume-page-actions-mount] [data-blume-menu] {
+    position: static;
+    width: auto;
+    min-width: 0;
+    max-width: none;
+    margin: 0;
+    margin-inline-start: 0.5rem;
+    border-width: 0;
+    border-inline-start-width: 1px;
+    border-radius: 0;
+    background-color: transparent;
+    padding: 0;
+    padding-inline-start: 0.5rem;
+    box-shadow: none;
+  }
+  [data-blume-page-actions-mount] [data-blume-menu] > :hover {
+    background-color: transparent;
+  }
+</style>
+
 <script>
   import { copyDeferredText, copyText, flashLabel } from "../copy-feedback.ts";
   import { installDropdownDismiss } from "../dropdown-dismiss.ts";
@@ -301,13 +340,42 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
   // for the EPUB: drop decorative SVGs and interactive controls (which render as
   // broken boxes in a reader), flatten Shiki's variable-colored code to plain
   // monospace text, and reveal panels the tab scripts would otherwise hide.
-  const buildEpubChapterHtml = (article: Element): string => {
+  // Links point at the site: a site-relative `/docs/page` means nothing inside
+  // the book, so every link but an in-page `#fragment` is made absolute.
+  const buildEpubChapterHtml = async (article: Element): Promise<string> => {
     const clone = article.cloneNode(true) as Element;
     for (const el of clone.querySelectorAll(
       "svg, button, select, script, style, link, noscript, template"
     )) {
       el.remove();
     }
+    for (const link of clone.querySelectorAll<HTMLAnchorElement>("a[href]")) {
+      if (!link.getAttribute("href")?.startsWith("#")) {
+        link.setAttribute("href", link.href);
+      }
+    }
+    // The generator fetches every image into the book, and one it can't fetch
+    // (a cross-origin image served without CORS headers, a 404) fails the
+    // whole export. Try each first, and leave out the ones that fail.
+    await Promise.all(
+      [...clone.querySelectorAll("img")].map(async (img) => {
+        if (!img.getAttribute("src")) {
+          return;
+        }
+        try {
+          const response = await fetch(img.src);
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+          }
+        } catch (error) {
+          console.warn(
+            `[blume] EPUB export left out an image it couldn't fetch: ${img.src}`,
+            error
+          );
+          img.remove();
+        }
+      })
+    );
     for (const pre of clone.querySelectorAll("pre")) {
       const code = document.createElement("code");
       code.textContent = pre.textContent ?? "";
@@ -339,9 +407,11 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
     menu.classList.toggle("mb-1", flipUp);
   };
 
+  // Only the rail's floating dropdowns need placing; a group open in place in
+  // the mobile dropdown is not one (see `placeActions`).
   const openDropdown = () =>
     document.querySelector<HTMLDetailsElement>(
-      "[data-blume-page-actions] details[open]"
+      "[data-blume-page-actions] details[data-blume-dropdown][open]"
     );
 
   // rAF-coalesced so a live resize drag re-reads layout once per frame, not
@@ -362,6 +432,32 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
   // dropdown behavior (also the header language switcher and nav selectors).
   installDropdownDismiss();
 
+  // The page renders its one actions block in the right rail, which only
+  // shows at `xl`. Below that the block moves into the mobile "On this page"
+  // dropdown, into the empty mount the layout passes it as children, and
+  // back at `xl`; a moved node keeps its listeners, so nothing rebinds. In
+  // the dropdown its groups expand in place, so they drop out of the shared
+  // light-dismiss and the placement here (both keyed on
+  // `data-blume-dropdown`) until the block is back in the rail, and the
+  // styles above restyle it from the mount.
+  const railQuery = window.matchMedia("(min-width: 80rem)");
+  const placeActions = () => {
+    const root = document.querySelector("[data-blume-page-actions]");
+    const rail = railQuery.matches;
+    const home = document.querySelector(
+      rail ? "[data-blume-toc]" : "[data-blume-page-actions-mount]"
+    );
+    if (!(root && home) || root.parentElement === home) {
+      return;
+    }
+    // A group left open would reopen as the other kind of menu.
+    for (const details of root.querySelectorAll("details")) {
+      details.open = false;
+      details.toggleAttribute("data-blume-dropdown", rail);
+    }
+    home.append(root);
+  };
+
   // Per-page setup, run on the initial load and again after every
   // client-router swap: the swap rebuilds the actions menu from
   // server-rendered markup, so every handler below binds to fresh elements.
@@ -384,7 +480,9 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
             other.open = false;
           }
         }
-        placeMenu(details);
+        if (details.hasAttribute("data-blume-dropdown")) {
+          placeMenu(details);
+        }
       });
     }
 
@@ -537,10 +635,24 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
         const epubModule = await loadEpub();
         const epub = epubModule.default?.default ?? epubModule.default;
         // The article HTML already opens with the page's <h1>, so don't let the
-        // generator prepend a second chapter-title heading.
+        // generator prepend a second chapter-title heading. The book's
+        // language is the article's (a fallback page's content locale, else
+        // the page's), and the site is its author and publisher; left out,
+        // the generator says English and "anonymous". Its defaults are spread
+        // under these options, so an unknown value is omitted, not undefined.
+        const site = document
+          .querySelector('meta[property="og:site_name"]')
+          ?.getAttribute("content");
+        const lang = article.closest("[lang]")?.getAttribute("lang");
         const result = await epub(
-          { css: EPUB_STYLES, prependChapterTitles: false, title },
-          [{ content: buildEpubChapterHtml(article), title }]
+          {
+            css: EPUB_STYLES,
+            prependChapterTitles: false,
+            title,
+            ...(site && { author: site, publisher: site }),
+            ...(lang && { lang }),
+          },
+          [{ content: await buildEpubChapterHtml(article), title }]
         );
         const blob =
           result instanceof Blob
@@ -572,5 +684,8 @@ hr { border: 0; border-top: 1px solid #ddd; margin: 2em 0; }`;
   };
 
   initPageActions();
+  placeActions();
   document.addEventListener("astro:after-swap", initPageActions);
+  document.addEventListener("astro:after-swap", placeActions);
+  railQuery.addEventListener("change", placeActions);
 </script>