blume 2.2.3 → 2.2.4

package/dist/cli/{chunk-g62vnvaw.js → chunk-tf4134kk.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import"./chunk-hwjspffr.js";
+import"./chunk-5bp65pv4.js";
 import {
   packageRoot,
   getBlumeVersion,
@@ -13,13 +13,13 @@ import"./chunk-zccbjcj0.js";
 import {
   AGENTS,
   launchInstalledAgent
-} from "./chunk-x25s4gph.js";
+} from "./chunk-d4h1y312.js";
 import {
   scanProject
-} from "./chunk-gc7knd2s.js";
+} from "./chunk-vxdjss7f.js";
 import {
   siteSkillName
-} from "./chunk-rc2qk3qx.js";
+} from "./chunk-b0vwhmdf.js";
 
 // src/cli/commands/skill.ts
 import { defineCommand } from "citty";
@@ -123,4 +123,4 @@ export {
 };
 
 //# debugId=8BB2AE139A5F70AE64756E2164756E21
-//# sourceMappingURL=chunk-g62vnvaw.js.map
+//# sourceMappingURL=chunk-tf4134kk.js.map

package/dist/cli/{chunk-gc7knd2s.js → chunk-vxdjss7f.js}

@@ -90,7 +90,7 @@ import {
   createModuleLoader,
   resolveProjectContext,
   loadConfig
-} from "./chunk-hwjspffr.js";
+} from "./chunk-5bp65pv4.js";
 import {
   BlumeError,
   locatePath,
@@ -4882,4 +4882,4 @@ var scanProject = async (root, options = {}) => {
 export { directiveSource, normalizeFence, QUOTED_ATTR, metaTokens, RESERVED_META_KEYWORDS, isForeignKeyword, isLineRange, validateSearchPopularIcons, validateMcpClientIcons, validateNavTargets, gitEnv, realPath, gitRepositoryRoot, locateMdxFailure, findFolderMetaFiles, isWithin, scanProject };
 
 //# debugId=C199F41EFA089E4F64756E2164756E21
-//# sourceMappingURL=chunk-gc7knd2s.js.map
+//# sourceMappingURL=chunk-vxdjss7f.js.map

package/dist/cli/{chunk-5f96yq2c.js → chunk-x2pgg22t.js}

@@ -224,4 +224,4 @@ var findItem = (name) => registry.find((item) => item.name === name);
 export { packageSrc, registry, findItem };
 
 //# debugId=C83E2C96A43B459064756E2164756E21
-//# sourceMappingURL=chunk-5f96yq2c.js.map
+//# sourceMappingURL=chunk-x2pgg22t.js.map

package/dist/cli/{chunk-yrmw5n2b.js → chunk-xhrwrzrh.js}

@@ -4,11 +4,11 @@ import {
   discoverIslands,
   discoverExamples,
   missingDependencyDiagnostic
-} from "./chunk-8h2t2vyj.js";
+} from "./chunk-0qx6vwwf.js";
 import {
   discoverPages,
   navTargetRoutes
-} from "./chunk-hwjspffr.js";
+} from "./chunk-5bp65pv4.js";
 import {
   packageRoot,
   commandMeta,
@@ -23,24 +23,24 @@ import {
 import {
   ComponentOverridesError,
   analyzeComponentOverrides
-} from "./chunk-znwhf37a.js";
+} from "./chunk-51wr1wre.js";
 import {
   validateNavTargets,
   scanProject
-} from "./chunk-gc7knd2s.js";
+} from "./chunk-vxdjss7f.js";
 import"./chunk-zccbjcj0.js";
 import"./chunk-jq5n4avg.js";
 import {
   unregisteredSnapshotDiagnostics
-} from "./chunk-b7n58hgj.js";
+} from "./chunk-0b1a8xqz.js";
 import {
   servedFiles
-} from "./chunk-88q28zav.js";
+} from "./chunk-f29q3j13.js";
 import {
   serverFeatures,
   checkRequiredSecrets
-} from "./chunk-426rytg6.js";
-import"./chunk-rc2qk3qx.js";
+} from "./chunk-ajw85dgf.js";
+import"./chunk-b0vwhmdf.js";
 
 // src/cli/commands/doctor.ts
 import { readFileSync } from "node:fs";
@@ -171,4 +171,4 @@ export {
 };
 
 //# debugId=A4A339755430C21A64756E2164756E21
-//# sourceMappingURL=chunk-yrmw5n2b.js.map
+//# sourceMappingURL=chunk-xhrwrzrh.js.map

package/dist/cli/index.js

@@ -725,24 +725,24 @@ var main = defineCommand({
     version: getBlumeVersion()
   },
   subCommands: {
-    add: lazyCommand(commandMeta.add, () => import("./chunk-zj6bcx0n.js"), "addCommand"),
-    audit: lazyCommand(commandMeta.audit, () => import("./chunk-982qfeny.js"), "auditCommand"),
-    build: lazyCommand(commandMeta.build, () => import("./chunk-xkx216rd.js"), "buildCommand"),
-    check: lazyCommand(commandMeta.check, () => import("./chunk-b664x65a.js"), "checkCommand"),
-    dev: lazyCommand(commandMeta.dev, () => import("./chunk-5xq12jz7.js"), "devCommand"),
-    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-yrmw5n2b.js"), "doctorCommand"),
-    eject: lazyCommand(commandMeta.eject, () => import("./chunk-zjfwzrvd.js"), "ejectCommand"),
-    eval: lazyCommand(commandMeta.eval, () => import("./chunk-akj2p7k1.js"), "evalCommand"),
-    init: lazyCommand(commandMeta.init, () => import("./chunk-xv8nkt56.js"), "initCommand"),
-    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-qax1aekz.js"), "mcpStdioCommand"),
-    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-88zkpg89.js"), "migrateCommand"),
-    preview: lazyCommand(commandMeta.preview, () => import("./chunk-ry2ymbxf.js"), "previewCommand"),
-    skill: lazyCommand(commandMeta.skill, () => import("./chunk-g62vnvaw.js"), "skillCommand"),
-    sync: lazyCommand(commandMeta.sync, () => import("./chunk-0wt5amrk.js"), "syncCommand"),
-    translate: lazyCommand(commandMeta.translate, () => import("./chunk-0ynr0fr7.js"), "translateCommand"),
-    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-x0jqyq1g.js"), "upgradeCommand"),
-    validate: lazyCommand(commandMeta.validate, () => import("./chunk-8fm3b4vm.js"), "validateCommand"),
-    version: lazyCommand(commandMeta.version, () => import("./chunk-6xag1c83.js"), "versionCommand")
+    add: lazyCommand(commandMeta.add, () => import("./chunk-f72388jn.js"), "addCommand"),
+    audit: lazyCommand(commandMeta.audit, () => import("./chunk-n091sgam.js"), "auditCommand"),
+    build: lazyCommand(commandMeta.build, () => import("./chunk-b5gztt4j.js"), "buildCommand"),
+    check: lazyCommand(commandMeta.check, () => import("./chunk-a1xmzxk2.js"), "checkCommand"),
+    dev: lazyCommand(commandMeta.dev, () => import("./chunk-sbt1s5j2.js"), "devCommand"),
+    doctor: lazyCommand(commandMeta.doctor, () => import("./chunk-xhrwrzrh.js"), "doctorCommand"),
+    eject: lazyCommand(commandMeta.eject, () => import("./chunk-p33bf2nb.js"), "ejectCommand"),
+    eval: lazyCommand(commandMeta.eval, () => import("./chunk-531qbwn1.js"), "evalCommand"),
+    init: lazyCommand(commandMeta.init, () => import("./chunk-98me5yas.js"), "initCommand"),
+    "mcp-stdio": lazyCommand(commandMeta["mcp-stdio"], () => import("./chunk-3ps63r91.js"), "mcpStdioCommand"),
+    migrate: lazyCommand(commandMeta.migrate, () => import("./chunk-6nvcjzts.js"), "migrateCommand"),
+    preview: lazyCommand(commandMeta.preview, () => import("./chunk-ansqj08e.js"), "previewCommand"),
+    skill: lazyCommand(commandMeta.skill, () => import("./chunk-tf4134kk.js"), "skillCommand"),
+    sync: lazyCommand(commandMeta.sync, () => import("./chunk-et7zwqkg.js"), "syncCommand"),
+    translate: lazyCommand(commandMeta.translate, () => import("./chunk-8cshtem6.js"), "translateCommand"),
+    upgrade: lazyCommand(commandMeta.upgrade, () => import("./chunk-8h5ceyk0.js"), "upgradeCommand"),
+    validate: lazyCommand(commandMeta.validate, () => import("./chunk-m54bz9ng.js"), "validateCommand"),
+    version: lazyCommand(commandMeta.version, () => import("./chunk-6v5w8vzd.js"), "versionCommand")
   }
 });
 loadEnvFiles(process.cwd());

package/dist/types/core/config-input.d.ts

@@ -435,6 +435,12 @@ export interface ThemeConfig {
     mode?: "system" | "light" | "dark";
     /** Corner radius scale. Defaults to `md`. */
     radius?: RadiusScale;
+    /**
+     * Show the header's light/dark toggle. Defaults to `true`. `false` hides it
+     * and ignores any choice a reader saved earlier, so every page renders in
+     * `mode` (`system` follows the reader's OS setting).
+     */
+    toggle?: boolean;
 }
 /** A curated link for the search dialog empty state. */
 export interface SearchPopularLink {

package/dist/types/core/schema.d.ts

@@ -4295,6 +4295,7 @@ export declare const blumeConfigSchema: z.ZodObject<{
             md: "md";
             lg: "lg";
         }>>;
+        toggle: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
     title: z.ZodDefault<z.ZodString>;
     toc: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{

package/docs/configuration/theming.mdx

@@ -14,6 +14,7 @@ theme: {
   accent: "teal",   // a named preset or any CSS color
   radius: "md",     // none | sm | md | lg
   mode: "system",   // system | light | dark
+  toggle: true,     // show the light/dark toggle
   fonts: {          // self-hosted Google Fonts
     display: "inter",
     body: "inter",
@@ -51,7 +52,18 @@ Text on an accent or action fill, like a button label or a step number, is white
 - **`system`** (default) — follow the reader's OS preference
 - **`light`** / **`dark`** — default to one scheme
 
-A toggle in the header always lets readers switch, and their choice is remembered across visits. Dark mode is applied with a `data-theme="dark"` attribute on the `<html>` element.
+A toggle in the header lets readers switch, and their choice is remembered across visits. Dark mode is applied with a `data-theme="dark"` attribute on the `<html>` element.
+
+To ship a single scheme, set `toggle: false`. The header drops the toggle, and every page renders in `mode`, even for readers who picked the other scheme before the toggle was removed:
+
+```ts blume.config.ts lineNumbers
+theme: {
+  mode: "dark",
+  toggle: false,
+}
+```
+
+With `mode: "system"`, `toggle: false` follows each reader's OS setting and gives them no way to override it.
 
 ### Fonts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blume",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "The open-source docs framework for humans and agents.",
   "keywords": [
     "agents",
@@ -36,7 +36,8 @@
     "docs",
     "skills",
     "AGENTS.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "type": "module",
   "types": "./dist/types/index.d.ts",
@@ -116,7 +117,7 @@
     "@astrojs/mdx": "^8.0.2",
     "@astrojs/node": "^11.1.6",
     "@astrojs/react": "^7.0.0",
-    "@astrojs/vercel": "^11.0.11",
+    "@astrojs/vercel": "^11.0.14",
     "@clack/prompts": "^1.8.0",
     "@iconify-json/lucide": "^1.2.140",
     "@iconify/types": "^2.0.0",

package/skills/blume-migrate/references/docus.md

@@ -87,7 +87,7 @@ Read `app/app.config.ts` (`app.config.ts` at the project root on Nuxt 3), `nuxt.
 | `toc.bottom.links` | `navigation.featured` (`to` → `href`). Report the move |
 | `navigation.sub` | `navigation.tabs` (see Navigation). `'aside'` anchors have no Blume form; report |
 | `docus.locale` (not `en`) | a one-locale `i18n` block |
-| `docus.colorMode` | `theme.mode`. Blume always shows the toggle; report |
+| `docus.colorMode` | `theme.mode`. A forced mode also takes `theme.toggle: false` |
 | `assistant.faqQuestions` | `ai.assistant.suggestions` (`[{ label }]`; flatten categories) |
 | `ui.colors.primary` | `theme.accent`. Nuxt UI paints shade 500 in light mode and 400 in dark: a Blume preset of the same name, else `{ light, dark }` with those Tailwind values. **Not declared means Docus's emerald:** the site turns Blume's default color unless you offer `theme.accent: "green"`; report it either way |
 | `--ui-radius: 0` in CSS | `theme.radius: "none"` |
@@ -275,7 +275,6 @@ Report each of these, and anything else you drop:
   - Nuxt UI overrides and theme CSS that doesn't map
   - a custom `seo.titleTemplate`, `seo.schema`, and the TOC title
   - logo extras, and socials with no Blume platform
-  - a forced color mode (the toggle stays)
   - `navigation.sub: 'aside'` anchors
   - a header button that showed only on the landing page (now site-wide)
 - **Navigation:** text-order sorting (`10.` before `2.`), and pages that sorted after a folder.

package/skills/blume-migrate/references/docusaurus.md

@@ -20,7 +20,7 @@ Read `themeConfig`, `presets`, and `plugins`:
 | `themeConfig.navbar.items` (doc items) | `navigation.tabs` (for section links) |
 | `themeConfig.navbar.items` (external/utility links — Blog, Discord…) | **`navigation.actions`** (`[{ label, href }]`, plain header links) to keep them in the header, or **`navigation.featured`** (`{ label, href, icon? }`, pinned above the sidebar on every route) if they should survive on phones; the GitHub link → the `github` config instead (it renders in the footer) |
 | `themeConfig.navbar.items` (a `className`-styled button — "Get started", "Sign up") | **`navigation.cta`** (`{ label, href }`, the header's one filled button; a route the docs don't serve must be an absolute URL) |
-| `themeConfig.colorMode.defaultMode` | `theme.mode` (`respectPrefersColorScheme: true` → `"system"`) |
+| `themeConfig.colorMode.defaultMode` | `theme.mode` (`respectPrefersColorScheme: true` → `"system"`); `colorMode.disableSwitch: true` → `theme.toggle: false` |
 | `themeConfig.prism.theme` / `.darkTheme` | `markdown.code.theme: { light, dark }` (map Prism theme names to Shiki themes, e.g. `github`/`github-dark`) |
 | `themeConfig.metadata` / `themeConfig.image` | per-page `seo` frontmatter / `seo.og`; report what doesn't fit |
 | `url` + `baseUrl` | **`url` → `deployment.site`**, unless the target host is Vercel or Netlify, which Blume auto-detects (see SKILL.md — GitHub Pages, a common Docusaurus host, is not one of them); `baseUrl` (when not `/`) → `deployment: { base: "/…" }`, or the `base` option of a host adapter (`vercel({ base })`) when the site also needs one |

package/skills/blume-migrate/references/vitepress.md

@@ -48,7 +48,7 @@ Read the whole module and the helpers it imports (sidebars, nav, per-locale conf
 | `rewrites` | **move each file to the path its rewrite produced**, so the URL stays put (`slug` only where moving is impossible). VitePress relative links are already written against the rewritten paths |
 | `srcDir` / `srcExclude` | `content.root` / `content.exclude`, which adds to the defaults `**/_*` and `**/.*` |
 | `outDir`, `assetsDir`, `cacheDir`, `ignoreDeadLinks`, `metaChunk`, `mpa` | drop |
-| `appearance` | `'dark'`/`'force-dark'` → `theme.mode: "dark"`; `false` → `"light"`; `true`/`'force-auto'` → omit. Blume always shows the toggle: report a forced mode |
+| `appearance` | `'dark'` → `theme.mode: "dark"`; `'force-dark'` → `theme: { mode: "dark", toggle: false }`; `false` → `theme: { mode: "light", toggle: false }`; `'force-auto'` → `theme.toggle: false`; `true` → omit |
 | `lastUpdated: true` | `lastModified: "git"` |
 | `sitemap.hostname` | `deployment.site`, unless the host is Vercel or Netlify (auto-detected). `sitemap.transformItems` → drop |
 | `markdown.theme` | `markdown.code.theme: { light, dark }`; VitePress's default (`github-light`/`github-dark`) is Blume's, so omit it unless changed |
@@ -201,4 +201,4 @@ The old URL list is `<old build>/**/*.html` (or the live `sitemap.xml`). Blume s
 
 ## Dropped — report these
 
-`titleTemplate`, the footer `message` (and any link inside `copyright`), forced `appearance`, per-page `outline`/`aside`, one-sided `prev`/`next`, page-level toggles (`editLink`, `footer`, `navbar`, `pageClass`), `head` entries beyond meta tags and analytics, build hooks, Vite and custom markdown-it plugins, unsupported social links, line-number offsets and the site-wide switch, snippet regions and include ranges (now split files), copied out-of-root snippets, data-driven and unregistered theme components (and any content they hid), `VPTeamMembers`, data loaders and dynamic routes, hero styling, the DocSearch index (with its credentials), old-site anchors that were already broken (and any left unpinned under `--only-linked`), version-dropdown links, and `::: note`/`important`/`caution` text that 1.x showed literally.
+`titleTemplate`, the footer `message` (and any link inside `copyright`), per-page `outline`/`aside`, one-sided `prev`/`next`, page-level toggles (`editLink`, `footer`, `navbar`, `pageClass`), `head` entries beyond meta tags and analytics, build hooks, Vite and custom markdown-it plugins, unsupported social links, line-number offsets and the site-wide switch, snippet regions and include ranges (now split files), copied out-of-root snippets, data-driven and unregistered theme components (and any content they hid), `VPTeamMembers`, data loaders and dynamic routes, hero styling, the DocSearch index (with its credentials), old-site anchors that were already broken (and any left unpinned under `--only-linked`), version-dropdown links, and `::: note`/`important`/`caution` text that 1.x showed literally.

package/skills/blume-migrate/references/vuepress.md

@@ -70,7 +70,7 @@ Read the whole config, including the modules it imports. VuePress sites often ke
 | `nextLinks: false` **and** `prevLinks: false` (v1) | `pagination: false` on every page: there's no site-wide switch. Only one of them → drop (report) |
 | `search: false` | `search: false` |
 | `algolia` (`apiKey`, `indexName`, `appId`), in `themeConfig` or, in v1, any `themeConfig.locales[path]` | omit `search` (Orama) and report the credentials. A v1 `algolia` block is almost always **DocSearch**: Algolia's crawler fills the index (the app is `BH4D9OD16A` when `appId` is missing, and `algoliaOptions.facetFilters` often marks a shared index). Its records aren't Blume's, and Blume's sync, given an admin key, replaces the whole index on every build. Never point `algolia()` at it; a new index of your own is a separate opt-in |
-| **v2** `colorMode: 'dark'` / `'light'` | `theme.mode`. `colorModeSwitch: false` → report: Blume always shows the toggle |
+| **v2** `colorMode: 'dark'` / `'light'` | `theme.mode`. `colorModeSwitch: false` → `theme.toggle: false` |
 | **v2** `hostname` | `deployment.site`, unless the target host is Vercel or Netlify |
 | `locales` | see "i18n" |
 | `smoothScroll`, `searchMaxSuggestions`, `searchPlaceholder`, `repoLabel`, `editLinkText`, **v2** `contributors`, `externalLinkIcon`, `home`, `notFound`, `backToHome`, and the other UI labels | drop. A translated UI string → `i18n.ui` |

package/src/components/layout/Header.astro

@@ -319,16 +319,24 @@ const clickScript = `(()=>{const dr=()=>{const h=document.querySelector("[data-b
         />
       )
     }
-    <button
-      aria-label={n.toggleTheme}
-      class={iconButton}
-      data-blume-theme-toggle
-      data-blume-tooltip={n.toggleTheme}
-      type="button"
-    >
-      <span class="inline-flex dark:hidden"><Icon name="sun" size={18} /></span>
-      <span class="hidden dark:inline-flex"><Icon name="moon" size={18} /></span>
-    </button>
+    {
+      data.config.theme.toggle && (
+        <button
+          aria-label={n.toggleTheme}
+          class={iconButton}
+          data-blume-theme-toggle
+          data-blume-tooltip={n.toggleTheme}
+          type="button"
+        >
+          <span class="inline-flex dark:hidden">
+            <Icon name="sun" size={18} />
+          </span>
+          <span class="hidden dark:inline-flex">
+            <Icon name="moon" size={18} />
+          </span>
+        </button>
+      )
+    }
     {assistantEnabled && <Ask strings={assistantStrings} />}
   </div>
 </header>

package/src/components/layout/PageActions.astro

@@ -75,6 +75,7 @@ const LOGOS: Record<string, string> = {
     '<svg class="size-4 shrink-0" viewBox="0 0 466.73 532.09" xmlns="http://www.w3.org/2000/svg"><path d="M457.43,125.94L244.42,2.96c-6.84-3.95-15.28-3.95-22.12,0L9.3,125.94c-5.75,3.32-9.3,9.46-9.3,16.11v247.99c0,6.65,3.55,12.79,9.3,16.11l213.01,122.98c6.84,3.95,15.28,3.95,22.12,0l213.01-122.98c5.75-3.32,9.3-9.46,9.3-16.11v-247.99c0-6.65-3.55-12.79-9.3-16.11h-.01ZM444.05,151.99l-205.63,356.16c-1.39,2.4-5.06,1.42-5.06-1.36v-233.21c0-4.66-2.49-8.97-6.53-11.31L24.87,145.67c-2.4-1.39-1.42-5.06,1.36-5.06h411.26c5.84,0,9.49,6.33,6.57,11.39h-.01Z" fill="currentColor"/></svg>',
   scira:
     '<svg class="size-4 shrink-0" fill="none" viewBox="0 0 910 934" xmlns="http://www.w3.org/2000/svg"><path d="M647.664 197.775C569.13 189.049 525.5 145.419 516.774 66.8849C508.048 145.419 464.418 189.049 385.884 197.775C464.418 206.501 508.048 250.131 516.774 328.665C525.5 250.131 569.13 206.501 647.664 197.775Z" fill="currentColor" stroke="currentColor" stroke-linejoin="round" stroke-width="8"/><path d="M857.5 508.116C763.259 497.644 710.903 445.288 700.432 351.047C689.961 445.288 637.605 497.644 543.364 508.116C637.605 518.587 689.961 570.943 700.432 665.184C710.903 570.943 763.259 518.587 857.5 508.116Z" stroke="currentColor" stroke-linejoin="round" stroke-width="20"/><path d="M889.949 121.237C831.049 114.692 798.326 81.9698 791.782 23.0692C785.237 81.9698 752.515 114.692 693.614 121.237C752.515 127.781 785.237 160.504 791.782 219.404C798.326 160.504 831.049 127.781 889.949 121.237Z" fill="currentColor" stroke="currentColor" stroke-linejoin="round" stroke-width="8"/><path d="M760.632 764.337C720.719 814.616 669.835 855.1 611.872 882.692C553.91 910.285 490.404 924.255 426.213 923.533C362.022 922.812 298.846 907.419 241.518 878.531C184.19 849.643 134.228 808.026 95.4548 756.863C56.6815 705.7 30.1238 646.346 17.8129 583.343C5.50207 520.339 7.76433 455.354 24.4266 393.359C41.089 331.364 71.7099 274.001 113.947 225.658C156.184 177.315 208.919 139.273 268.117 114.442" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="30"/></svg>',
+  // Lucide's message-circle; Lucide's license is in THIRD-PARTY-NOTICES.md.
   t3: '<svg class="size-4 shrink-0" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M7.9 20A9 9 0 1 0 4 16.1L2 22Z"/></svg>',
   v0: '<svg class="size-4 shrink-0" fill="currentColor" viewBox="0 0 147 70" xmlns="http://www.w3.org/2000/svg"><path d="M56 50.2031V14H70V60.1562C70 65.5928 65.5928 70 60.1562 70C57.5605 70 54.9982 68.9992 53.1562 67.1573L0 14H19.7969L56 50.2031Z"/><path d="M147 56H133V23.9531L100.953 56H133V70H96.6875C85.8144 70 77 61.1856 77 50.3125V14H91V46.1562L123.156 14H91V0H127.312C138.186 0 147 8.81439 147 19.6875V56Z"/></svg>',
 };

package/src/components/layout/PageLayout.astro

@@ -445,7 +445,12 @@ const localeRedirect = localeTargets
         <script data-key={bannerKey} is:inline set:html={BANNER_INIT_SCRIPT} />
       )
     }
-    <script data-mode={themeMode} is:inline set:html={THEME_INIT_SCRIPT} />
+    <script
+      data-fixed={data.config.theme.toggle ? undefined : ""}
+      data-mode={themeMode}
+      is:inline
+      set:html={THEME_INIT_SCRIPT}
+    />
     {consent && <ConsentHead consent={consent} />}
     <Analytics analytics={analytics} />
   </head>

package/src/components/layout/ReferenceLayout.astro

@@ -138,7 +138,12 @@ createIconSprite(Astro.locals);
         <script data-key={bannerKey} is:inline set:html={BANNER_INIT_SCRIPT} />
       )
     }
-    <script data-mode={themeMode} is:inline set:html={THEME_INIT_SCRIPT} />
+    <script
+      data-fixed={data.config.theme.toggle ? undefined : ""}
+      data-mode={themeMode}
+      is:inline
+      set:html={THEME_INIT_SCRIPT}
+    />
     {consent && <ConsentHead consent={consent} />}
     <Analytics analytics={analytics} />
   </head>

package/src/components/layout/RootLayout.astro

@@ -692,7 +692,12 @@ const localeRedirect = localeTargets
         <script data-key={bannerKey} is:inline set:html={BANNER_INIT_SCRIPT} />
       )
     }
-    <script data-mode={themeMode} is:inline set:html={THEME_INIT_SCRIPT} />
+    <script
+      data-fixed={data.config.theme.toggle ? undefined : ""}
+      data-mode={themeMode}
+      is:inline
+      set:html={THEME_INIT_SCRIPT}
+    />
     {consent && <ConsentHead consent={consent} />}
     <Analytics analytics={analytics} />
   </head>

package/src/components/layout/head-scripts.ts

@@ -45,12 +45,16 @@
  * after a swap the theme the `before-swap` stamp carried over stands, so a
  * toggle the reader made still holds for the rest of their visit.
  *
+ * `data-fixed` (present when `theme.toggle` is off) skips the stored
+ * preference, so a choice saved before the toggle was removed can't hold the
+ * page in a mode the site no longer offers.
+ *
  * Paper is white, so a dark page prints light: `beforeprint` switches the root
  * to the light theme (every token, Shiki color, and `dark:` utility follows
  * it) and `afterprint` puts the dark theme back. The listeners sit on
  * `window`, so the one registration outlives client-router swaps.
  */
-export const THEME_INIT_SCRIPT = `(()=>{const m=document.currentScript?.dataset.mode??"system";const apply=()=>{const r=document.documentElement;let s=null;let blocked=false;try{s=localStorage.getItem("blume-theme");}catch{blocked=true;}const sys=matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light";r.dataset.theme=s??(blocked&&r.dataset.theme?r.dataset.theme:m==="system"?sys:m);};apply();document.addEventListener("astro:before-swap",(e)=>{const t=document.documentElement.dataset.theme;if(t){e.newDocument.documentElement.dataset.theme=t;}});document.addEventListener("astro:after-swap",apply);let printed=null;addEventListener("beforeprint",()=>{const r=document.documentElement;if(r.dataset.theme==="dark"){printed="dark";r.dataset.theme="light";}});addEventListener("afterprint",()=>{if(printed){document.documentElement.dataset.theme=printed;printed=null;}});})();`;
+export const THEME_INIT_SCRIPT = `(()=>{const ds=document.currentScript?.dataset;const m=ds?.mode??"system";const fixed=ds?.fixed!==undefined;const apply=()=>{const r=document.documentElement;let s=null;let blocked=false;try{s=fixed?null:localStorage.getItem("blume-theme");}catch{blocked=true;}const sys=matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light";r.dataset.theme=s??(blocked&&r.dataset.theme?r.dataset.theme:m==="system"?sys:m);};apply();document.addEventListener("astro:before-swap",(e)=>{const t=document.documentElement.dataset.theme;if(t){e.newDocument.documentElement.dataset.theme=t;}});document.addEventListener("astro:after-swap",apply);let printed=null;addEventListener("beforeprint",()=>{const r=document.documentElement;if(r.dataset.theme==="dark"){printed="dark";r.dataset.theme="light";}});addEventListener("afterprint",()=>{if(printed){document.documentElement.dataset.theme=printed;printed=null;}});})();`;
 
 /**
  * Keep an embedded Scalar reference on Blume's theme. Scalar picks its own

package/src/core/config-input.ts

@@ -500,6 +500,12 @@ export interface ThemeConfig {
   mode?: "system" | "light" | "dark";
   /** Corner radius scale. Defaults to `md`. */
   radius?: RadiusScale;
+  /**
+   * Show the header's light/dark toggle. Defaults to `true`. `false` hides it
+   * and ignores any choice a reader saved earlier, so every page renders in
+   * `mode` (`system` follows the reader's OS setting).
+   */
+  toggle?: boolean;
 }
 
 // ---------------------------------------------------------------------------

package/src/core/schema.ts

@@ -761,6 +761,7 @@ const themeConfigFields = {
     .prefault({}),
   mode: z.enum(["system", "light", "dark"]).default("system"),
   radius: z.enum(["none", "sm", "md", "lg"]).default("md"),
+  toggle: z.boolean().default(true),
 };
 
 const themeConfigSchema = z.strictObject(

package/src/theme/chrome-icons.ts

@@ -10,7 +10,8 @@
  * time via `resolveIcon` and inline as zero-JS SVG.
  *
  * Values are Lucide inner-SVG markup; the client `svg()` helpers wrap them in an
- * `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" …>`.
+ * `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" …>`. Lucide's
+ * license is in THIRD-PARTY-NOTICES.md.
  */
 /** Inner-SVG markup keyed by the icon name a client script requests. */
 interface ChromeIconSet {

package/src/theme/entry.ts

@@ -9,7 +9,10 @@ import { CODE_PADDING_BLOCK_REM } from "./code-block-padding.ts";
  */
 const CODE_SCROLL_INSET_REM = 0.375;
 
-/** Lucide's arrow-up-right (the featured-link icon) as a `mask` data URI. */
+/**
+ * Lucide's arrow-up-right (the featured-link icon) as a `mask` data URI.
+ * Lucide's license is in THIRD-PARTY-NOTICES.md.
+ */
 const EXTERNAL_LINK_MASK = `url("data:image/svg+xml,${encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#000" stroke-linecap="round" stroke-linejoin="round" stroke-width="2"><path d="M7 7h10v10M7 17L17 7"/></svg>')}")`;
 
 interface TailwindEntryOptions {