fix: align website shell and docs layout

scripts/verify-static-output.ts

@@ -22,6 +22,8 @@ const apiSymbolsByRoute = new Map(
     apiSymbolSets[entrypoint.symbolSet as keyof typeof apiSymbolSets],
   ])
 );
+const docsHome = docsCatalog.find((page) => page.route === '/docs');
+if (!docsHome) throw new Error('Missing /docs catalog entry');
 
 const marketing = [
   { route: '/', ...marketingRouteMetadata['/'] },
@@ -30,19 +32,26 @@ const marketing = [
     title: page.title,
     description: page.description,
   })),
+  {
+    route: '/docs',
+    title: `${docsHome.title} | Askr`,
+    description: docsHome.description,
+  },
   { route: '/404', ...marketingRouteMetadata['/404'] },
 ].map((page) => ({ ...page, layout: 'marketing' }));
 
-const docs = docsCatalog.map((page) => ({
-  route: page.route,
-  title: `${page.title} | Askr`,
-  description: page.description,
-  headings: page.headings.map(({ id }) => ({ id })),
-  apiSymbols: apiSymbolsByRoute
-    .get(page.route)
-    ?.map(({ anchor }) => ({ anchor })),
-  layout: 'docs',
-}));
+const docs = docsCatalog
+  .filter((page) => page.route !== '/docs')
+  .map((page) => ({
+    route: page.route,
+    title: `${page.title} | Askr`,
+    description: page.description,
+    headings: page.headings.map(({ id }) => ({ id })),
+    apiSymbols: apiSymbolsByRoute
+      .get(page.route)
+      ?.map(({ anchor }) => ({ anchor })),
+    layout: 'docs',
+  }));
 
 const expectations = [...marketing, ...docs];
 const expectedRoutes = new Set(expectations.map(({ route }) => route));
@@ -143,7 +152,7 @@ for (const expectation of expectations) {
     for (const marker of [
       'Documentation navigation',
       'Search docs',
-      'Open documentation navigation',
+      'Toggle documentation navigation',
       'On this page',
       'Breadcrumb',
       'docs-pagination',

src/pages/_routes.tsx

@@ -6,6 +6,7 @@ import {
 } from './marketing/_routes';
 import { DocsLayout } from './docs/_layout';
 import { docsCatalog } from './docs/catalog';
+import { MarketingLayout } from './marketing/_layout';
 
 export type { RouteMetadata } from './marketing/_routes';
 
@@ -22,8 +23,15 @@ export const routeMetadata: Readonly<Record<string, RouteMetadata>> = {
 export const routeRegistry = createRouteRegistry(() => {
   registerMarketingRoutes();
 
+  const docsHome = docsCatalog.find((page) => page.route === '/docs');
+  if (!docsHome) throw new Error('Missing /docs catalog entry');
+  group({ layout: MarketingLayout }, () => {
+    route('/docs', lazy(docsHome.loader), { meta: routeMetadata['/docs'] });
+  });
+
   group({ layout: DocsLayout }, () => {
     for (const page of docsCatalog) {
+      if (page.route === '/docs') continue;
       route(page.route, lazy(page.loader), {
         meta: routeMetadata[page.route],
       });
@@ -41,8 +49,20 @@ export async function createStaticRouteRegistry() {
   const registry = createRouteRegistry(() => {
     registerMarketingRoutes();
 
+    const docsHome = docsCatalog.find((page) => page.route === '/docs');
+    if (!docsHome) throw new Error('Missing /docs catalog entry');
+    group({ layout: MarketingLayout }, () => {
+      let component = components.get(docsHome.loader);
+      if (!component) {
+        component = lazy(docsHome.loader);
+        components.set(docsHome.loader, component);
+      }
+      route('/docs', component, { meta: routeMetadata['/docs'] });
+    });
+
     group({ layout: DocsLayout }, () => {
       for (const page of docsCatalog) {
+        if (page.route === '/docs') continue;
         let component = components.get(page.loader);
         if (!component) {
           component = lazy(page.loader);