nodejs · w3lld1 · Jul 11, 2026
@@ -0,0 +1,5 @@
+---
+'@node-core/doc-kit': patch
+---
+
+Hide the web documentation search control unless the Orama database generator is enabled.
@@ -73,7 +73,9 @@ const createGenerator = () => {
           ? createParallelWorker(generatorName, pool, configuration)
           : Promise.resolve(null);
 
-        const result = await generate(dependencyInput, await worker);
+        const result = await generate(dependencyInput, await worker, {
+          target: configuration.target,
+        });
 
         // For streaming generators, "Completed" is logged when the cache
         // finishes collecting, not here when the generator returns

@@ -40,7 +40,8 @@ declare global {
    */
   export type Generate<I, O> = (
     input: I,
-    worker: ParallelWorker
+    worker: ParallelWorker,
+    context: { target: string[] }
   ) => O extends AsyncGenerator ? O : Promise<O>;
 
   /**

@@ -13,6 +13,7 @@ The `web` generator accepts the following configuration options:
 | `project`         | `string`  | `'Node.js'`                                   | Project name used in page titles and the version selector                |
 | `title`           | `string`  | `'{project} v{version} Documentation'`        | Title template for HTML pages (supports `{project}`, `{version}`)        |
 | `useAbsoluteURLs` | `boolean` | `false`                                       | When `true`, all internal links use absolute URLs based on `baseURL`     |
+| `showSearchBar`   | `boolean` | Whether `orama-db` is targeted                | Overrides whether the navigation renders the search control              |
 | `editURL`         | `string`  | `'${GITHUB_EDIT_URL}/doc/api{path}.md'`       | URL template for "edit this page" links                                  |
 | `pageURL`         | `string`  | `'{baseURL}/latest-{version}/api{path}.html'` | URL template for documentation page links                                |
 | `head`            | `object`  | See below                                     | Configurable `<meta>`, `<link>`, and raw markup for the document head    |

@@ -45,6 +45,23 @@ const createEntry = (api, name) => {
 };
 
 describe('web generate', () => {
+  it('only renders search when the Orama database is generated', async () => {
+    await setConfig({ target: ['web'] });
+    const fs = createEntry('fs', 'File system');
+    const input = [toCodeItem(await buildContent([fs], fs))];
+
+    const [withoutOrama] = await generate(input, undefined, {
+      target: ['web'],
+    });
+    assert.doesNotMatch(withoutOrama.html, /Start typing/);
+
+    await setConfig({ target: ['web', 'orama-db'] });
+    const [withOrama] = await generate(input, undefined, {
+      target: ['web', 'orama-db'],
+    });
+    assert.match(withOrama.html, /Start typing/);
+  });
+
   it('omits View As links for synthetic pages only', async () => {
     await setConfig({});
 

@@ -18,7 +18,7 @@ import { writeFile } from '../../utils/file.mjs';
  *
  * @type {import('./types').Generator['generate']}
  */
-export async function generate(input) {
+export async function generate(input, _worker, { target = [] } = {}) {
   const config = getConfig('web');
 
   const template = await readFile(config.templatePath, 'utf-8');
@@ -46,6 +46,7 @@ export async function generate(input) {
     datas,
     sidebarEntries,
     template,
+    searchEnabled: config.showSearchBar ?? target.includes('orama-db'),
   });
 
   if (config.output) {

@@ -38,6 +38,7 @@ export default createLazyGenerator({
     editURL: `${GITHUB_EDIT_URL}/doc/api{path}.md`,
     pageURL: '{baseURL}/latest-{version}/api{path}.html',
     remoteConfigUrl: 'https://nodejs.org/site.json',
+    showSearchBar: undefined,
 
     // Project-specific document `<head>` contents. `meta` and `links` are
     // arrays of attribute bags (boolean `true` renders a valueless attribute,

@@ -31,6 +31,7 @@ export type Configuration = {
   templatePath: string;
   title: string;
   useAbsoluteURLs: boolean;
+  showSearchBar?: boolean;
   head: HeadConfig;
   // Options spread into LightningCSS while bundling CSS. `filename`, `code`,
   // `cssModules`, and `resolver` are managed by the generator and ignored here.

@@ -6,7 +6,7 @@ import GitHubIcon from '@node-core/ui-components/Icons/Social/GitHub';
 import SearchBox from './SearchBox';
 import { useTheme } from '../hooks/useTheme.mjs';
 
-import { repository } from '#theme/config';
+import { repository, searchEnabled } from '#theme/config';
 import Logo from '#theme/Logo';
 
 /**
@@ -21,7 +21,7 @@ export default ({ metadata }) => {
       sidebarItemTogglerAriaLabel="Toggle navigation menu"
       navItems={[]}
     >
-      <SearchBox pathname={metadata.path} />
+      {searchEnabled && <SearchBox pathname={metadata.path} />}
       <ThemeToggle
         onChange={setThemePreference}
         currentTheme={themePreference}

@@ -70,9 +70,10 @@ export function buildLanguageDisplayNameMap() {
  * per-page resolution by components).
  *
  * @param {Array<import('../../jsx-ast/utils/buildContent.mjs').JSXContent>} input - JSX AST entries with .data metadata
+ * @param {boolean} searchEnabled - Whether the search control is enabled
  * @returns {string} JavaScript source code string with named exports
  */
-export default function createConfigSource(input) {
+export default function createConfigSource(input, searchEnabled) {
   const { version: configVersion, ...config } = getConfig('web');
 
   const editURL = populate(config.editURL, {
@@ -97,6 +98,7 @@ export default function createConfigSource(input) {
       ]
     ),
     version: configVersion,
+    searchEnabled,
     versions: buildVersionEntries(config.changelog, pageURL),
     editURL,
     pages: buildPageList(input),

@@ -157,18 +157,20 @@ async function executeServerCode(serverCodeMap, requireFn, virtualImports) {
  * @param {Array<import('../../metadata/types').MetadataEntry>} params.datas - Per-page metadata, in render order.
  * @param {Array<{ data: import('../../metadata/types').MetadataEntry }>} params.sidebarEntries - Entries used to build the sidebar page list (real module pages only).
  * @param {string} params.template - The HTML template string for the output pages.
+ * @param {boolean} params.searchEnabled - Whether to render the search control.
  */
 export async function processBundles({
   serverCodeMap,
   clientCodeMap,
   datas,
   sidebarEntries,
   template,
+  searchEnabled,
 }) {
   const config = getConfig('web');
   const requireFn = createRequire(import.meta.url);
   const virtualImports = {
-    '#theme/config': createConfigSource(sidebarEntries),
+    '#theme/config': createConfigSource(sidebarEntries, searchEnabled),
     ...config.virtualImports,
   };