@writedocs/generator 0.9.4 → 0.10.0

package/astro.config.mjs

@@ -38,6 +38,7 @@ import { writedocsTempDir, writedocsBuildStagingDir } from './src/lib/writedocs-
 import { stylesAssetFallback } from './src/lib/styles-asset-integration.js';
 import { mcpDevServer } from './src/lib/mcp-dev-integration.js';
 import { canonicalPath } from './src/lib/canonical-path.js';
+import { folderAddresses } from './src/lib/folder-redirects.js';
 import { report } from './src/lib/cli-report.js';
 import {
   loadDocsConfig,
@@ -152,12 +153,14 @@ function collectNoindexIds(rootContentDir) {
   // redirect-only route [...slug].astro synthesizes (noindex, pointing at
   // the first page) - which doesn't belong in the sitemap either.
   let rootIsPage = false;
+  const pageIds = [];
 
   for (const relativeId of findAllPages(rootContentDir)) {
     const file = path.join(rootContentDir, relativeId);
     const { data } = matter(fs.readFileSync(file, 'utf-8'));
     const pageId = normalizeEntryId(data?.slug ?? relativeId.replace(/\.mdx?$/i, '').replace(/\/index$/, ''));
     if (pageId === 'index') rootIsPage = true;
+    pageIds.push(pageId);
     // Top-level `noindex` is Mintlify's spelling, and a Mintlify `hidden`
     // page is noindexed too - content.config.ts folds both into
     // `seo.noindex` the same way (an explicit value wins).
@@ -172,9 +175,13 @@ function collectNoindexIds(rootContentDir) {
   for (const file of walkMdFiles(generatedDocsDir)) {
     const { data } = matter(fs.readFileSync(file, 'utf-8'));
     if (data?.slug && normalizeEntryId(data.slug) === 'index') rootIsPage = true;
+    if (data?.slug) pageIds.push(normalizeEntryId(data.slug));
     if ((data?.seo?.noindex ?? data?.noindex ?? data?.hidden === true) && data.slug) ids.add(normalizeEntryId(data.slug));
   }
   if (!rootIsPage) ids.add('index');
+  // Folder addresses with no page of their own redirect to one under them
+  // (lib/folder-redirects.js) - redirects, so not in the sitemap either.
+  for (const folder of folderAddresses(pageIds)) ids.add(folder);
   return ids;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@writedocs/generator",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Static site generator for docs — a writedocs.json + MDX folder in, a static site out.",
   "type": "module",
   "bin": {

package/src/cli/run-pagefind.js

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import fs from 'node:fs';
 import { spawn } from 'node:child_process';
+import { pathToFileURL } from 'node:url';
 
 /**
  * Locates the installed pagefind package by walking up node_modules
@@ -53,7 +54,77 @@ function resolvePagefindBin(packageRoot) {
  * Pagefind's output is captured, not printed: the CLI prints its own step
  * line, and Pagefind's text only when it fails (in the rejected Error).
  */
-export function runPagefind(siteDir, { packageRoot }) {
+export async function runPagefind(siteDir, { packageRoot }) {
+  const groups = searchSpaces(siteDir);
+  if (groups) return indexBySpace(siteDir, packageRoot, groups);
+  return indexWholeSite(siteDir, packageRoot);
+}
+
+// Pages under a hidden navigation item name their search space in their
+// markup ([...slug].astro, lib/hidden-sections.js).
+const SPACE = /data-wd-search-space="([^"]+)"/;
+const SEARCH_PUBLIC = /data-wd-search-public="true"/;
+
+/** The site's pages by search space - `{ public, spaces }` - or null when
+ *  no page is in a hidden space (the whole site is one index, as ever).
+ *  Only pages Pagefind would index: those with a data-pagefind-body. */
+function searchSpaces(siteDir) {
+  const publicPages = [];
+  const spaces = new Map();
+  const walk = (dir) => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!['_astro', 'pagefind', 'pagefind-spaces'].includes(entry.name)) walk(full);
+        continue;
+      }
+      if (!entry.name.endsWith('.html')) continue;
+      const content = fs.readFileSync(full, 'utf8');
+      if (!content.includes('data-pagefind-body')) continue;
+      const page = { rel: path.relative(siteDir, full).split(path.sep).join('/'), content };
+      const space = SPACE.exec(content)?.[1];
+      if (!space) {
+        publicPages.push(page);
+        continue;
+      }
+      const group = spaces.get(space) ?? { searchPublic: false, pages: [] };
+      group.searchPublic ||= SEARCH_PUBLIC.test(content);
+      group.pages.push(page);
+      spaces.set(space, group);
+    }
+  };
+  walk(siteDir);
+  return spaces.size ? { public: publicPages, spaces } : null;
+}
+
+/** One index for the public pages (dist/pagefind/) and one per hidden
+ *  space (dist/pagefind-spaces/<id>/) - so the public search never finds a
+ *  hidden page, and a hidden space's search finds only its own pages, plus
+ *  the public ones when it sets `searchPublic`. src/scripts/search.ts loads
+ *  the index of the page's space. */
+async function indexBySpace(siteDir, packageRoot, groups) {
+  const pagefind = await import(pathToFileURL(path.join(findPagefindDir(packageRoot), 'lib', 'index.js')).href);
+  const check = (result, what) => {
+    if (result.errors?.length) throw new Error(`pagefind (${what}): ${result.errors.join('; ')}`);
+    return result;
+  };
+  const write = async (pages, outputPath, what) => {
+    const { index } = check(await pagefind.createIndex({}), what);
+    for (const page of pages) check(await index.addHTMLFile({ sourcePath: page.rel, content: page.content }), `${what}: ${page.rel}`);
+    check(await index.writeFiles({ outputPath }), what);
+  };
+  try {
+    await write(groups.public, path.join(siteDir, 'pagefind'), 'public pages');
+    for (const [id, space] of groups.spaces) {
+      const pages = space.searchPublic ? [...space.pages, ...groups.public] : space.pages;
+      await write(pages, path.join(siteDir, 'pagefind-spaces', id), `hidden space ${id}`);
+    }
+  } finally {
+    await pagefind.close();
+  }
+}
+
+function indexWholeSite(siteDir, packageRoot) {
   const bin = resolvePagefindBin(packageRoot);
   return new Promise((resolve, reject) => {
     const child = spawn(process.execPath, [bin, '--site', siteDir, '--quiet'], {

package/src/cli/write-redirects-file.js

@@ -63,6 +63,17 @@ export function writeRedirectsFile(distDir, contentDir) {
     if (match) lines.push(`/ ${match[1]} 302`);
   }
 
+  // Folder addresses redirecting to the first page under them
+  // (lib/folder-redirects.js). Read back from the built pages like "/"
+  // above: Astro writes a temporary (302) redirect's page with a 2-second
+  // refresh and a permanent one's with 0 - writedocs.json's own redirects
+  // and `url` pages are permanent, so the 2-second ones are exactly the
+  // automatic folder redirects. (Read before rewrite-redirect-pages.js makes
+  // every redirect page go at once.)
+  for (const { url, target } of temporaryRedirectPages(distDir)) {
+    lines.push(`${url} ${target} 302`, `${url.replace(/\/$/, '')} ${target} 302`);
+  }
+
   if (lines.length === 0) return;
 
   const generated = [
@@ -81,3 +92,25 @@ export function writeRedirectsFile(distDir, contentDir) {
   const existing = fs.existsSync(redirectsPath) ? fs.readFileSync(redirectsPath, 'utf8').replace(/\s*$/, '\n\n') : '';
   fs.writeFileSync(redirectsPath, existing + generated);
 }
+
+/** Astro's pages for temporary redirects below the site's root, as
+ *  `{ url: "/docs/creator/", target }`. */
+function temporaryRedirectPages(distDir) {
+  const found = [];
+  const walk = (dir) => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!['_astro', 'pagefind', 'pagefind-spaces'].includes(entry.name)) walk(full);
+        continue;
+      }
+      if (entry.name !== 'index.html' || dir === distDir) continue;
+      const html = fs.readFileSync(full, 'utf8');
+      if (!html.includes('<title>Redirecting to:')) continue;
+      const match = html.match(/<meta http-equiv="refresh" content="2;\s*url=([^"]+)"/i);
+      if (match) found.push({ url: `/${path.relative(distDir, dir).split(path.sep).join('/')}/`, target: match[1] });
+    }
+  };
+  walk(distDir);
+  return found.sort((a, b) => a.url.localeCompare(b.url));
+}

package/src/layout/components/MobileMenu.astro

@@ -98,9 +98,9 @@ const showMenu = hasMobileMenu({ sidebar: showSidebarCol, selectors, globalDropd
         </button>
       </div>
       <div class="wd-mobile-menu-scroll">
-        {(selectors.length > 0 || globalDropdowns.length > 0) && (
+        {(selectors.some((sel) => !sel.hidden) || globalDropdowns.length > 0) && (
           <div class="wd-mobile-menu-selectors">
-            {selectors.map((sel) => {
+            {selectors.filter((sel) => !sel.hidden).map((sel) => {
               const current = sel.options.find((o) => o.active) ?? sel.options[0];
               return (
                 <details class="wd-mobile-accordion" name="wd-mobile-accordion">

package/src/layout/components/TopBar.astro

@@ -59,7 +59,7 @@ const { config, selectors, globalDropdowns, showSidebarCol, logoLight, logoDark,
 const placements = selectorPlacements(selectors, { sidebar: showSidebarCol });
 const showMenuButton = hasMobileMenu({ sidebar: showSidebarCol, selectors, globalDropdowns });
 const switcherSelectors = selectors.filter((_, i) => placements[i] === 'topbar');
-const tabSelectors = selectors.filter((sel) => sel.kind === 'tab');
+const tabSelectors = selectors.filter((_, i) => placements[i] === 'tabs');
 // One row per level of tabs: a tab holding its own tabs gets a second row
 // underneath, with that tab's tabs. The global dropdowns stay in the first
 // row, which renders on its own when there are only those.

package/src/lib/config-schema.js

@@ -32,7 +32,8 @@ const navLinkSchema = z.object({ label: z.string(), href: z.string() }).strict()
 const navItemSchema = z.lazy(
   () => z.union([navPageSchema, navGroupSchema, navLinkSchema])
 );
-function withChildren(base) {
+function withChildren(ownFields) {
+  const base = { ...ownFields, hidden: z.boolean().optional(), searchPublic: z.boolean().optional() };
   return z.union([
     z.object({ ...base, pages: z.array(navItemSchema) }).strict(),
     z.object({ ...base, tabs: z.array(tabSchema).min(1) }).strict(),
@@ -97,6 +98,14 @@ const navigationSchema = z.union([
         continue;
       }
       items.forEach((item, i) => {
+        const own2 = item;
+        if (own2?.searchPublic === true && own2.hidden !== true) {
+          ctx.addIssue({
+            code: "custom",
+            path: [...path, key, i, "searchPublic"],
+            message: '`searchPublic` only applies to a hidden item - add "hidden": true, or remove `searchPublic`.'
+          });
+        }
         const inner = key === "languages" ? String(item?.language ?? "") : language;
         const tab = item?.tab;
         walk(item, [...path, key, i], inner, key === "tabs" ? [...tabs, String(tab ?? "")] : tabs);

package/src/lib/config-schema.ts

@@ -129,11 +129,17 @@ export type NavChildren =
   | { products: ProductItem[] }
   | { href: string };
 
-export type TabItem = { tab: string; icon?: string } & NavChildren;
-export type VersionItem = { version: string; label?: string; tag?: string; default?: boolean } & NavChildren;
-export type LanguageItem = { language: string; label?: string } & NavChildren;
-export type DropdownItem = { dropdown: string; icon?: string } & NavChildren;
-export type ProductItem = { product: string; icon?: string; description?: string } & NavChildren;
+/** Any navigation item can be hidden: reachable only by its address - no
+ *  switcher, tab or menu lists it, and its pages search only among
+ *  themselves (plus the public ones, with `searchPublic`). See
+ *  lib/hidden-sections.js. */
+export type Hideable = { hidden?: boolean; searchPublic?: boolean };
+
+export type TabItem = { tab: string; icon?: string } & Hideable & NavChildren;
+export type VersionItem = { version: string; label?: string; tag?: string; default?: boolean } & Hideable & NavChildren;
+export type LanguageItem = { language: string; label?: string } & Hideable & NavChildren;
+export type DropdownItem = { dropdown: string; icon?: string } & Hideable & NavChildren;
+export type ProductItem = { product: string; icon?: string; description?: string } & Hideable & NavChildren;
 
 // `.strict()` on every variant is load-bearing, not decoration: Zod
 // objects silently strip unrecognized keys by default, so without it a
@@ -142,7 +148,8 @@ export type ProductItem = { product: string; icon?: string; description?: string
 // rejected - defeating the entire "exactly one child kind per level"
 // rule this schema exists to enforce (mirroring Mintlify's own "a tab
 // cannot contain both anchors and groups at the same level").
-function withChildren<Base extends z.ZodRawShape>(base: Base) {
+function withChildren<Base extends z.ZodRawShape>(ownFields: Base) {
+  const base = { ...ownFields, hidden: z.boolean().optional(), searchPublic: z.boolean().optional() };
   return z.union([
     z.object({ ...base, pages: z.array(navItemSchema) }).strict(),
     z.object({ ...base, tabs: z.array(tabSchema).min(1) }).strict(),
@@ -247,6 +254,14 @@ const navigationSchema = z.union([
         continue;
       }
       items.forEach((item, i) => {
+        const own = item as { hidden?: unknown; searchPublic?: unknown };
+        if (own?.searchPublic === true && own.hidden !== true) {
+          ctx.addIssue({
+            code: 'custom',
+            path: [...path, key, i, 'searchPublic'],
+            message: '`searchPublic` only applies to a hidden item - add "hidden": true, or remove `searchPublic`.',
+          });
+        }
         const inner = key === 'languages' ? String((item as { language?: unknown })?.language ?? '') : language;
         const tab = (item as { tab?: unknown })?.tab;
         walk(item, [...path, key, i], inner, key === 'tabs' ? [...tabs, String(tab ?? '')] : tabs);

package/src/lib/config.ts

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { EXCLUDED_TOP_LEVEL_DIRS, navPageId } from './pages.js';
+import { isHidden } from './hidden-sections.js';
 import matter from 'gray-matter';
 import { writedocsTempDir } from './writedocs-temp-dir.js';
 import { readableTextOn } from './color.js';
@@ -787,6 +788,8 @@ export function resolveGlobalDropdowns(navigation: NavigationConfig): DropdownIt
  *  `{ tab: "Status", href: "..." }`). */
 function firstSlugAmong(items: Container[]): string | null {
   for (const item of items) {
+    // A hidden item is reached only by its address - never by default.
+    if (isHidden(item)) continue;
     const slug = firstSlugOf(item);
     if (slug !== null) return slug;
   }
@@ -944,6 +947,11 @@ export interface SelectorOption {
 export interface Selector {
   kind: PathSegment['kind'];
   options: SelectorOption[];
+  // The page sits inside a hidden item on this level: the level isn't
+  // shown (its switcher would list the other items). Kept in the list,
+  // not dropped, so the levels after it are placed by their real parent
+  // (lib/selector-placement.js).
+  hidden?: boolean;
 }
 
 /** An option's own `dropdowns` menu, if it has one (see SelectorOption.dropdown
@@ -958,12 +966,16 @@ function dropdownMenuOf(
   activeSegment: PathSegment | undefined
 ): SelectorOption[] | undefined {
   if (!('dropdowns' in node)) return undefined;
-  return node.dropdowns.map((d, i) => ({
-    label: d.dropdown,
-    icon: iconOf(d),
-    href: 'href' in d ? d.href : hrefForSlug(firstSlugOf(d) ?? 'index'),
-    active: activeSegment?.kind === 'dropdown' && activeSegment.index === i,
-  }));
+  return node.dropdowns
+    .map((d, i) => ({
+      label: d.dropdown,
+      icon: iconOf(d),
+      href: 'href' in d ? d.href : hrefForSlug(firstSlugOf(d) ?? 'index'),
+      active: activeSegment?.kind === 'dropdown' && activeSegment.index === i,
+      hidden: isHidden(d),
+    }))
+    .filter((d) => !d.hidden)
+    .map(({ hidden: _hidden, ...option }) => option);
 }
 
 /** `activePagePosition` is the reader's current page's own index within
@@ -986,7 +998,10 @@ export function buildSelectors(
     const remainingPath = path.slice(segIndex + 1);
     return {
       kind: segment.kind,
-      options: (segment.items as NamedContainer[]).map((item, i) => {
+      hidden: isHidden(segment.items[segment.index]),
+      options: (segment.items as NamedContainer[]).flatMap((item, i) => {
+        // A hidden item is never offered - not even to its own pages.
+        if (isHidden(item)) return [];
         const isActive = i === segment.index;
         const equivalentSlug = preservesPosition
           ? equivalentPageIn(item as Container, remainingPath, activePagePosition)

package/src/lib/content-check.js

@@ -411,6 +411,20 @@ export async function checkContent(contentDir, configText) {
         )
       );
     }
+    // Every top-level item hidden, and no home page: `/` never redirects into a
+    // hidden item (lib/hidden-sections.js), so the site's address has nothing.
+    const nav = config.navigation;
+    const topKey = nav && !Array.isArray(nav) ? ['tabs', 'versions', 'languages', 'dropdowns', 'products'].find((k) => Array.isArray(nav[k])) : null;
+    if (topKey && nav[topKey].length && nav[topKey].every((item) => item?.hidden === true || 'href' in (item ?? {})) && !ids.has('index')) {
+      warnings.push(
+        issue(
+          'writedocs.json',
+          locate(['navigation', topKey])?.line,
+          `Every item in navigation.${topKey} is hidden and there's no home page - the site's own address (/) shows "not found".`,
+          'Add an index.mdx at the project root for a home page, or leave one item not hidden.'
+        )
+      );
+    }
     // A redirect is one exact path - a Mintlify-style pattern (`/old/:slug`,
     // `/old/*`) becomes a literal page path, and the build fails on it.
     (Array.isArray(config.redirects) ? config.redirects : []).forEach((r, i) => {

package/src/lib/folder-redirects.js

@@ -0,0 +1,47 @@
+// Folder addresses - `/docs/creator/` when pages live at `/docs/creator/...`
+// but none at `/docs/creator/` itself - redirect to the first page under
+// them, as Mintlify does, instead of showing "not found". The same idea as
+// the automatic `/` redirect, one level down.
+//
+// "First" is the reader's order: [...slug].astro passes the pages in
+// navigation order, the public ones before those under a hidden item
+// (lib/hidden-sections.js) and pages outside the navigation last - so a
+// folder with both public and hidden pages under it goes to a public one.
+// A real page or a writedocs.json redirect at the address always wins.
+//
+// Temporary (302), like `/`: a browser doesn't keep it, so a page added at
+// that address later is seen. Also used by `writedocs broken-links` (a link
+// to a folder address leads somewhere) and the sitemap (which leaves them
+// out, like every redirect).
+//
+// Slugs are page addresses without their slashes: "docs/creator/home".
+
+/** First path segments writedocs itself serves - never a folder redirect. */
+export const RESERVED_FOLDERS = new Set(['_astro', 'pagefind', 'pagefind-spaces', 'llms', 'mcp']);
+
+/** Every folder above a page: "a/b/c" -> ["a", "a/b"]. */
+export function foldersOf(slug) {
+  const parts = slug.split('/').filter(Boolean);
+  return parts.slice(0, -1).map((_, i) => parts.slice(0, i + 1).join('/'));
+}
+
+/** The folder redirects for a site: folder -> the page it goes to.
+ *  `targets` - the pages, in the order to prefer them; `taken` - every
+ *  address already served (pages, redirects, `url` pages). */
+export function folderRedirects(targets, taken = new Set()) {
+  const redirects = new Map();
+  for (const slug of targets) {
+    if (slug === 'index') continue;
+    for (const folder of foldersOf(slug)) {
+      if (redirects.has(folder) || taken.has(folder) || RESERVED_FOLDERS.has(folder.split('/')[0])) continue;
+      redirects.set(folder, slug);
+    }
+  }
+  return redirects;
+}
+
+/** Just the folder addresses, for checks that don't need the targets. */
+export function folderAddresses(pageSlugs) {
+  const pages = new Set(pageSlugs);
+  return new Set([...folderRedirects(pageSlugs, pages).keys()]);
+}

package/src/lib/hidden-sections.js

@@ -0,0 +1,58 @@
+// Hidden navigation items (`"hidden": true` on a tab, product, version,
+// language or dropdown): reachable only by their address.
+//
+// - Nothing lists one: its switcher, tab row or menu option is left out
+//   everywhere, and `/` never redirects into it (firstSlugAmong() in
+//   lib/config.ts skips it).
+// - Inside one, the level it sits on isn't shown - that switcher would
+//   list the other items at its level. Everything below it works as
+//   usual. (buildSelectors() marks that level `hidden`; the placement in
+//   lib/selector-placement.js leaves it out.)
+// - Its pages are a search space of their own: they search only among
+//   themselves, and the site's public search never finds them. With
+//   `"searchPublic": true` its search finds the public pages too. The
+//   build writes one index per space (cli/run-pagefind.js); a page names
+//   its space in the markup, and src/scripts/search.ts loads that index.
+//
+// Hidden isn't private: anyone with the address can read the pages. The
+// sitemap, llms.txt and the MCP index still list them unless a page sets
+// `noindex`.
+
+/** Whether a navigation item is hidden. */
+export function isHidden(item) {
+  return Boolean(item && typeof item === 'object' && item.hidden === true);
+}
+
+const NAME_FIELD = { tab: 'tab', version: 'version', language: 'language', dropdown: 'dropdown', product: 'product' };
+
+function slug(text) {
+  return String(text ?? '')
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+/** A path's id, from the names of its levels - "product-admin",
+ *  "tab-api--version-v2". Readable in the index folder's name, and the
+ *  same on every build. */
+export function spaceIdOf(path) {
+  return path
+    .map((segment) => {
+      const item = segment.items[segment.index] ?? {};
+      return `${segment.kind}-${slug(item[NAME_FIELD[segment.kind]]) || segment.index}`;
+    })
+    .join('--');
+}
+
+/** The search space a section belongs to: the innermost hidden item on its
+ *  path - `{ id, searchPublic }` - or null for the public pages. */
+export function spaceOf(path = []) {
+  let space = null;
+  path.forEach((segment, i) => {
+    const item = segment.items[segment.index];
+    if (isHidden(item)) space = { id: spaceIdOf(path.slice(0, i + 1)), searchPublic: item.searchPublic === true };
+  });
+  return space;
+}

package/src/lib/json-schema-descriptions.js

@@ -43,9 +43,15 @@ const CONTAINERS = {
   },
 };
 
+const HIDDEN = {
+  hidden: 'Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn\'t shown. Its pages search only among themselves.',
+  searchPublic: 'For a hidden item: its search also finds the site\'s public pages.',
+};
+
 const containerEntries = Object.entries(CONTAINERS).flatMap(([type, fields]) => [
   ...Object.entries(fields).map(([field, text]) => [`${type}.${field}`, text]),
   ...Object.entries(CHILDREN).map(([field, text]) => [`${type}.${field}`, text]),
+  ...Object.entries(HIDDEN).map(([field, text]) => [`${type}.${field}`, text]),
 ]);
 
 const logo = (where) => ({

package/src/lib/link-check.js

@@ -35,6 +35,7 @@ import { visit } from 'unist-util-visit';
 import { findAllPages } from './pages.js';
 import { createJsonLocator, contextMenuOptions } from './config-schema.js';
 import { writedocsTempDir } from './writedocs-temp-dir.js';
+import { folderAddresses } from './folder-redirects.js';
 
 // The same github-slugger Astro builds page URLs and heading ids with -
 // resolved through Astro itself, so the two can't drift apart.
@@ -295,6 +296,11 @@ export async function checkLinks(contentDir, configText) {
   const special = new Set(['/llms.txt', '/llms-full.txt', '/404.html', '/404/']);
   if (config.domain) ['/sitemap.xml', '/sitemap-index.xml'].forEach((p) => special.add(p));
   const knownUrls = [...pages.keys(), ...generated, ...redirects];
+  // Folder addresses with no page of their own redirect to one under them
+  // (lib/folder-redirects.js), so a link to one isn't broken.
+  const folders = new Set(
+    [...folderAddresses([...pages.keys(), ...generated].map((url) => url.replace(/^\/+|\/+$/g, '')))].map((folder) => `/${folder}/`)
+  );
 
   // Anchors a page can be linked to: its own, plus those of every snippet
   // it imports (they render inside it).
@@ -398,7 +404,7 @@ export async function checkLinks(contentDir, configText) {
         return;
       }
       // "/" always exists: the home page, or a redirect to the first page.
-      if (pageKey === '/' || generated.has(pageKey) || redirects.has(pageKey) || special.has(pageKey.replace(/\/$/, '') || '/')) return;
+      if (pageKey === '/' || generated.has(pageKey) || redirects.has(pageKey) || folders.has(pageKey) || special.has(pageKey.replace(/\/$/, '') || '/')) return;
       if (special.has(pathname)) return;
 
       // Mintlify-style relative link: resolved from the file's folder

package/src/lib/selector-placement.js

@@ -6,6 +6,8 @@
 //   'sidebar'   the top of the sidebar: products inside a tab or a dropdown,
 //               like Mintlify's - they pick what the sidebar shows
 //   'topbar'    a switcher next to the site name (everything else)
+//   'none'      not shown: the page is inside a hidden item on this level
+//               (lib/hidden-sections.js)
 //
 // Without a sidebar on the page (`mode: custom` / `blank`), a 'sidebar'
 // switcher goes to the top bar instead. The mobile menu lists every level
@@ -13,6 +15,7 @@
 
 export function selectorPlacements(selectors, { sidebar = true } = {}) {
   return selectors.map((sel, i) => {
+    if (sel.hidden) return 'none';
     const parent = selectors[i - 1]?.kind;
     if (sel.kind === 'tab') return 'tabs';
     if (sel.kind === 'dropdown' && parent === 'tab') return 'tab-menu';
@@ -26,5 +29,5 @@ export function selectorPlacements(selectors, { sidebar = true } = {}) {
  *  top bar hides the tabs and switchers, so any page with navigation to
  *  reach needs it - with a sidebar or without (`mode: custom`). */
 export function hasMobileMenu({ sidebar, selectors = [], globalDropdowns = [] }) {
-  return sidebar || selectors.length > 0 || globalDropdowns.length > 0;
+  return sidebar || selectors.some((sel) => !sel.hidden) || globalDropdowns.length > 0;
 }

package/src/pages/[...slug].astro

@@ -71,6 +71,8 @@ import ApiPlayground from "../components/ApiPlayground.astro";
 import ApiReferencePanel from "../components/ApiReferencePanel.astro";
 import { searchScope, sectionTrail, ALL_SCOPES } from "../lib/search-scope.js";
 import { selectorPlacements } from "../lib/selector-placement.js";
+import { spaceOf } from "../lib/hidden-sections.js";
+import { folderRedirects } from "../lib/folder-redirects.js";
 
 // A page is hand-written (the `pages` collection, sourced from anywhere
 // in the project - docs/ has no special status, see findAllPages() in
@@ -254,12 +256,34 @@ export async function getStaticPaths() {
       };
     });
 
-  return [...rootRedirect, ...pageRoutes, ...hiddenRoutes];
+  // Folder addresses with pages under them but none of their own
+  // (`/docs/creator/`) redirect to the first page under them
+  // (lib/folder-redirects.js). Preferred in the reader's order: navigation
+  // order, public sections before hidden ones, pages outside the
+  // navigation last.
+  const slugOf = (route: { params: { slug?: string } }) => route.params.slug ?? "index";
+  const inHiddenSection = sections.map((section) => spaceOf(section.path) !== null);
+  const contentRoutes = pageRoutes.filter((route) => !("redirectTo" in route.props));
+  const folderTargets = [
+    ...contentRoutes.filter((route) => !inHiddenSection[(route.props as { sectionIndex: number }).sectionIndex]).map(slugOf),
+    ...contentRoutes.filter((route) => inHiddenSection[(route.props as { sectionIndex: number }).sectionIndex]).map(slugOf),
+    ...hiddenRoutes.map(slugOf),
+  ];
+  const takenAddresses = new Set([
+    ...[...pageRoutes, ...hiddenRoutes].map(slugOf),
+    ...(config.redirects ?? []).map((r) => r.source.replace(/^\/+|\/+$/g, "")),
+  ]);
+  const folderRoutes = [...folderRedirects(folderTargets, takenAddresses)].map(([folder, target]) => ({
+    params: { slug: folder },
+    props: { redirectTo: `/${target}/`, temporary: true },
+  }));
+
+  return [...rootRedirect, ...pageRoutes, ...hiddenRoutes, ...folderRoutes];
 }
 
 interface Props {
   redirectTo?: string;
-  // The automatic "/" redirect: temporary, see below.
+  // The automatic "/" and folder redirects: temporary, see below.
   temporary?: boolean;
   entry?: DocsEntry;
   prev?: { slug: string; group: string | null } | null;
@@ -386,6 +410,9 @@ const selectors = buildSelectors(activeSection.path, hrefForSlug, activePagePosi
 // shows the reader's own first. A hidden page belongs to no section.
 const pageSearchScope = isHidden ? { key: ALL_SCOPES, label: "" } : searchScope(activeSection.path);
 const pageSectionTrail = isHidden ? "" : sectionTrail(activeSection.path, breadcrumbs);
+// A page under a hidden navigation item searches its own index, not the
+// site's (lib/hidden-sections.js, cli/run-pagefind.js).
+const pageSearchSpace = isHidden ? null : spaceOf(activeSection.path);
 const languageSegment = isHidden ? undefined : activeSection.path.find((segment) => segment.kind === "language");
 const pageLang = languageSegment ? (languageSegment.items[languageSegment.index] as { language: string }).language : undefined;
 const globalDropdowns = buildGlobalDropdowns(
@@ -517,7 +544,7 @@ const components = {
         {entry.data.openapi && <ApiPlayground operation={entry.data.openapi} contentDir={contentDir} />}
         {/* After the content: a result's excerpt shows the section only when
             that's what matched. */}
-        <div hidden data-wd-search-scope={pageSearchScope.key} data-wd-search-scope-label={pageSearchScope.label} data-pagefind-filter={`scope:${pageSearchScope.key}`}>
+        <div hidden data-wd-search-scope={pageSearchScope.key} data-wd-search-scope-label={pageSearchScope.label} data-wd-search-space={pageSearchSpace?.id} data-wd-search-public={pageSearchSpace?.searchPublic ? "true" : undefined} data-pagefind-filter={`scope:${pageSearchScope.key}`}>
           {pageSectionTrail && <span data-pagefind-meta="section">{pageSectionTrail}</span>}
         </div>
       </div>
@@ -543,7 +570,7 @@ const components = {
         </div>
         <Content components={components} />
         {entry.data.openapi && <ApiPlayground operation={entry.data.openapi} contentDir={contentDir} />}
-        <div hidden data-wd-search-scope={pageSearchScope.key} data-wd-search-scope-label={pageSearchScope.label} data-pagefind-filter={`scope:${pageSearchScope.key}`}>
+        <div hidden data-wd-search-scope={pageSearchScope.key} data-wd-search-scope-label={pageSearchScope.label} data-wd-search-space={pageSearchSpace?.id} data-wd-search-public={pageSearchSpace?.searchPublic ? "true" : undefined} data-pagefind-filter={`scope:${pageSearchScope.key}`}>
           {pageSectionTrail && <span data-pagefind-meta="section">{pageSectionTrail}</span>}
         </div>
         {!entry.data.hideFooterPagination && (

package/src/scripts/search.ts

@@ -53,7 +53,10 @@ export function initSearch(root: ParentNode) {
   let loadPromise: Promise<any> | null = null;
   function ensurePagefind() {
     if (!loadPromise) {
-      const pagefindUrl = '/pagefind/pagefind.js';
+      // A page under a hidden navigation item searches its own space's index
+      // (cli/run-pagefind.js, lib/hidden-sections.js); every other page, the site's.
+      const space = document.querySelector<HTMLElement>('[data-wd-search-scope]')?.dataset.wdSearchSpace;
+      const pagefindUrl = space ? `/pagefind-spaces/${encodeURIComponent(space)}/pagefind.js` : '/pagefind/pagefind.js';
       loadPromise = import(/* @vite-ignore */ pagefindUrl)
         .then((mod: any) => {
           pagefind = mod;

package/writedocs.schema.json

@@ -1200,6 +1200,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "pages": {
               "type": "array",
               "items": {
@@ -1228,6 +1238,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "tabs": {
               "minItems": 1,
               "type": "array",
@@ -1257,6 +1277,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "versions": {
               "minItems": 1,
               "type": "array",
@@ -1286,6 +1316,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "languages": {
               "minItems": 1,
               "type": "array",
@@ -1315,6 +1355,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "dropdowns": {
               "minItems": 1,
               "type": "array",
@@ -1344,6 +1394,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "products": {
               "minItems": 1,
               "type": "array",
@@ -1373,6 +1433,16 @@
               "description": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name, \"collection:name\", an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "href": {
               "type": "string",
               "description": "Makes this a link to another address instead of a section with pages of its own.",
@@ -1404,6 +1474,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "pages": {
               "type": "array",
               "items": {
@@ -1432,6 +1512,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "tabs": {
               "minItems": 1,
               "type": "array",
@@ -1461,6 +1551,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "versions": {
               "minItems": 1,
               "type": "array",
@@ -1490,6 +1590,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "languages": {
               "minItems": 1,
               "type": "array",
@@ -1519,6 +1629,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "dropdowns": {
               "minItems": 1,
               "type": "array",
@@ -1548,6 +1668,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "products": {
               "minItems": 1,
               "type": "array",
@@ -1577,6 +1707,16 @@
               "description": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path.",
               "markdownDescription": "Icon next to the name: a Lucide name (\"book-open\"), \"collection:name\" (\"mdi:server\"), an emoji, or an image path."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "href": {
               "type": "string",
               "description": "Makes this a link to another address instead of a section with pages of its own.",
@@ -1618,6 +1758,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "pages": {
               "type": "array",
               "items": {
@@ -1656,6 +1806,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "tabs": {
               "minItems": 1,
               "type": "array",
@@ -1695,6 +1855,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "versions": {
               "minItems": 1,
               "type": "array",
@@ -1734,6 +1904,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "languages": {
               "minItems": 1,
               "type": "array",
@@ -1773,6 +1953,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "dropdowns": {
               "minItems": 1,
               "type": "array",
@@ -1812,6 +2002,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "products": {
               "minItems": 1,
               "type": "array",
@@ -1851,6 +2051,16 @@
               "description": "Open this version first. Without it, the first version is the default.",
               "markdownDescription": "Open this version first. Without it, the first version is the default."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "href": {
               "type": "string",
               "description": "Makes this a link to another address instead of a section with pages of its own.",
@@ -1882,6 +2092,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "pages": {
               "type": "array",
               "items": {
@@ -1910,6 +2130,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "tabs": {
               "minItems": 1,
               "type": "array",
@@ -1939,6 +2169,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "versions": {
               "minItems": 1,
               "type": "array",
@@ -1968,6 +2208,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "languages": {
               "minItems": 1,
               "type": "array",
@@ -1997,6 +2247,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "dropdowns": {
               "minItems": 1,
               "type": "array",
@@ -2026,6 +2286,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "products": {
               "minItems": 1,
               "type": "array",
@@ -2055,6 +2325,16 @@
               "description": "Text shown in the language picker instead of `language`, like \"Português\".",
               "markdownDescription": "Text shown in the language picker instead of `language`, like \"Português\"."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "href": {
               "type": "string",
               "description": "Makes this a link to another address instead of a section with pages of its own.",
@@ -2091,6 +2371,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "pages": {
               "type": "array",
               "items": {
@@ -2124,6 +2414,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "tabs": {
               "minItems": 1,
               "type": "array",
@@ -2158,6 +2458,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "versions": {
               "minItems": 1,
               "type": "array",
@@ -2192,6 +2502,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "languages": {
               "minItems": 1,
               "type": "array",
@@ -2226,6 +2546,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "dropdowns": {
               "minItems": 1,
               "type": "array",
@@ -2260,6 +2590,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "products": {
               "minItems": 1,
               "type": "array",
@@ -2294,6 +2634,16 @@
               "description": "One line under the name in the product picker.",
               "markdownDescription": "One line under the name in the product picker."
             },
+            "hidden": {
+              "type": "boolean",
+              "description": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves.",
+              "markdownDescription": "Reachable only by its address: no tab, switcher or menu lists it, and inside it this level isn't shown. Its pages search only among themselves."
+            },
+            "searchPublic": {
+              "type": "boolean",
+              "description": "For a hidden item: its search also finds the site's public pages.",
+              "markdownDescription": "For a hidden item: its search also finds the site's public pages."
+            },
             "href": {
               "type": "string",
               "description": "Makes this a link to another address instead of a section with pages of its own.",