chore(docs): upgrade Blume to 2.2.3

apps/docs/blume.config.ts

@@ -1,4 +1,6 @@
 import { defineConfig } from "blume";
+import { vercel } from "blume/analytics";
+import { custom, filesystem } from "blume/sources";
 
 import { githubReleaseChangelogSource } from "./sources/github-releases";
 
@@ -12,24 +14,21 @@ export default defineConfig({
     // label the header would otherwise render beside it (empty string = hidden).
     text: "",
   },
-  analytics: {
-    vercel: true,
-  },
+  analytics: [vercel()],
   github: {
     owner: "thebuilder",
     repo: "react-intersection-observer",
     dir: "apps/docs",
   },
   content: {
     sources: [
-      { type: "filesystem", root: "docs" },
-      {
-        type: "custom",
-        source: githubReleaseChangelogSource({
+      filesystem({ root: "docs" }),
+      custom(
+        githubReleaseChangelogSource({
           owner: "thebuilder",
           repo: "react-intersection-observer",
         }),
-      },
+      ),
     ],
   },
   navigation: {
@@ -61,10 +60,7 @@ export default defineConfig({
       },
     },
   },
-  deployment: {
-    output: "static",
-  },
-  ai: {
+  agents: {
     llmsTxt: true,
   },
 });

apps/docs/package.json

@@ -16,7 +16,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.6",
-    "blume": "^1.2.1",
+    "blume": "^2.2.3",
     "takumi-js": "^2.5.4"
   }
 }

apps/docs/sources/github-releases.ts

@@ -1,7 +1,7 @@
 import { resolve } from "node:path";
 
-import type { ContentSource, SourceEntry } from "blume/core/sources/types.ts";
-import { githubReleasesSource } from "blume/sources/github-releases.ts";
+import { githubReleasesSource } from "blume/core/sources/github-releases.ts";
+import type { ContentSource, SourceEntry } from "blume/sources";
 
 type ReleaseSourceOptions = {
   owner: string;
@@ -20,38 +20,51 @@ const excludeFromSearch = (entry: SourceEntry): SourceEntry => ({
   raw: entry.raw ? excludeSearchFromRaw(entry.raw) : undefined,
 });
 
+/**
+ * Wrap a release source so its pages stay out of the search index.
+ *
+ * `withContext` has to re-wrap rather than pass through: Blume rebuilds a
+ * `custom()` source on the scan's own cache dir and refresh policy by calling
+ * it, so a wrapper that inherited the underlying implementation would hand
+ * back a bare source and silently drop the exclusion.
+ */
+const withSearchExcluded = (source: ContentSource): ContentSource => ({
+  ...source,
+  load: async () => {
+    const result = await source.load();
+
+    return {
+      ...result,
+      entries: result.entries.map(excludeFromSearch),
+    };
+  },
+  read: source.read
+    ? async (ref) => excludeSearchFromRaw(await source.read(ref))
+    : undefined,
+  withContext: (next) =>
+    withSearchExcluded(source.withContext ? source.withContext(next) : source),
+});
+
 export const githubReleaseChangelogSource = ({
   owner,
   repo,
 }: ReleaseSourceOptions): ContentSource => {
   const isDev = process.argv.includes("dev");
-  const source = githubReleasesSource(
-    {
-      name: "changelog",
-      owner,
-      prefix: "changelog",
-      repo,
-    },
-    {
-      cacheDir: resolve(".blume/cache/changelog"),
-      mode: isDev ? "dev" : "build",
-      projectRoot: process.cwd(),
-      refresh: !isDev,
-    },
-  );
 
-  return {
-    ...source,
-    load: async () => {
-      const result = await source.load();
-
-      return {
-        ...result,
-        entries: result.entries.map(excludeFromSearch),
-      };
-    },
-    read: source.read
-      ? async (ref) => excludeSearchFromRaw(await source.read(ref))
-      : undefined,
-  };
+  return withSearchExcluded(
+    githubReleasesSource(
+      {
+        name: "changelog",
+        owner,
+        prefix: "changelog",
+        repo,
+      },
+      {
+        cacheDir: resolve(".blume/cache/changelog"),
+        mode: isDev ? "dev" : "build",
+        projectRoot: process.cwd(),
+        refresh: !isDev,
+      },
+    ),
+  );
 };

apps/docs/theme.css

@@ -1,8 +1,4 @@
 @media (max-width: 29.999rem) {
-  [data-blume-header] > .flex.items-center.gap-2 {
-    display: none;
-  }
-
   [data-docs-logo] {
     flex: none;
   }