@lupinum/ginko-docs 0.3.0-rc.3 → 0.3.0-rc.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Matthias Amon
+Copyright (c) 2024-present Lupinum OG and contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,169 +1,78 @@
-# Ginko Docs
+<p align="center">
+  <img src="https://raw.githubusercontent.com/lupinum-dev/ginko-docs/main/docs/public/web-app-manifest-512x512.png" width="128" alt="Ginko Docs icon">
+</p>
 
-Ginko Docs is a Nuxt layer for focused documentation sites. It combines Ginko Content collections with a documentation shell, navigation, search, localization, SEO, social images, optional blog routes, and agent-readable Markdown surfaces.
+<h1 align="center">@lupinum/ginko-docs</h1>
 
-## Requirements
+<p align="center">Add a complete documentation experience to a Nuxt application through one reusable layer.</p>
 
-- Node.js `^22.18.0 || ^24.11.0 || >=26.0.0`
-- Nuxt `>=4.4.7 <5`
-- Vue `^3.5.35`
-- Vue Router `^5.1.0`
-- Ginko Content `>=0.4.0-rc.1 <0.5.0`
+<p align="center">
+  <a href="https://www.npmjs.com/package/@lupinum/ginko-docs"><img src="https://img.shields.io/npm/v/@lupinum/ginko-docs?color=00DC82" alt="npm version"></a>
+  <a href="https://github.com/lupinum-dev/ginko-docs/actions/workflows/ci.yml"><img src="https://github.com/lupinum-dev/ginko-docs/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
+  <a href="https://github.com/lupinum-dev/ginko-docs/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license"></a>
+</p>
 
-## Install
+> [!WARNING]
+> This package is pre-1.0. Install `0.3.0-rc.5` from the npm `next` channel for evaluation.
 
-Install the layer and its Ginko Content peer:
+## Purpose
 
-```bash
-pnpm add -D @lupinum/ginko-docs@0.3.0-rc.3 @lupinum/ginko-content@0.4.0-rc.1
-```
+Use this package when a Nuxt application needs documentation routes, navigation, search, localization, metadata, social images, feedback, and agent-readable content. The layer provides the interface while the consuming application keeps ownership of its content and identity.
 
-Keep the public identity in one shared value:
+## Requirements
 
-```json [site.json]
-{
-  "name": "Example Docs",
-  "description": "Documentation for Example.",
-  "url": "https://docs.example.com"
-}
-```
+- Node.js 22.18, 24.11, or 26 and later maintenance releases
+- Nuxt 4.5.1 or later in the Nuxt 4 line
+- Vue 3.5.35 or later
+- Ginko Content 0.4 prerelease or later in the 0.4 line
 
-Extend the layer and configure the canonical origin:
+## Installation
 
-```ts [nuxt.config.ts]
-import site from "./site.json" with { type: "json" };
+```bash
+pnpm add -D @lupinum/ginko-docs@0.3.0-rc.5 @lupinum/ginko-content@0.4.0-rc.2
+```
 
+```ts
 export default defineNuxtConfig({
   extends: ["@lupinum/ginko-docs"],
-  site: { url: site.url },
-  i18n: { baseUrl: site.url },
+  site: { url: "https://docs.example.com" },
+  i18n: { baseUrl: "https://docs.example.com" },
 });
 ```
 
-Define the content collections in `content.config.ts`:
+## Quick start
 
-```ts [content.config.ts]
+```ts
 import { defineGinkoDocsConfig } from "@lupinum/ginko-docs/content";
-import site from "./site.json" with { type: "json" };
 
 export default defineGinkoDocsConfig({
-  site,
+  site: {
+    name: "Example Docs",
+    description: "Documentation for Example.",
+    url: "https://docs.example.com",
+  },
   locales: ["en"],
   blog: false,
 });
 ```
 
-Single-locale documentation belongs in `content/docs`. Add a first page:
-
-```md [content/docs/1.introduction.md]
----
-title: Introduction
-description: Learn what Example does and how to use it.
----
-
-Example solves ...
-```
-
-The bare `/docs` route redirects to the first navigable document.
-
-## Set the public identity
-
-Presentation settings live in `app/app.config.ts`:
-
-```ts [app/app.config.ts]
-import site from "../site.json";
-
-export default defineAppConfig({
-  ginkoDocs: {
-    site: {
-      name: { en: site.name },
-      description: { en: site.description },
-      url: site.url,
-      logo: { light: "/logo.svg", dark: "/logo-dark.svg" },
-      docsSidebarSwitcher: "tabs",
-      lupinumAttribution: true,
-    },
-    nav: { links: "auto" },
-    banner: { enabled: false, id: "default", showOnLanding: true },
-    feedback: { enabled: false },
-    toc: { depth: 3 },
-  },
-});
-```
-
-Localized values use `{ en, de? }`. Use English as the default locale; supported content layouts are English-only and bilingual English/German.
-
-Set the production URL once in `site.json`, then pass it to the content configuration, app configuration, Nuxt Site configuration, and Nuxt i18n `baseUrl`. JSON keeps the shared identity portable across each configuration loader. The layer uses it for canonical links, structured data, social cards, and agent catalogs.
-
-## Enable the blog
-
-Set `blog: true` in `defineGinkoDocsConfig`. That single option creates the `blog` and `authors` collections and keeps the blog routes in the generated Nuxt application.
-
-Blog posts are flat Markdown files under `content/2.blog` for an English-only site, or the corresponding locale directory for a bilingual site. Each post requires `title`, `description`, `date`, `readingTime`, and an `author` reference. Author records live under `authors` and require `slug`, `name`, `role`, `bio`, and `avatar`.
-
-## Customize presentation
-
-Use Nuxt's normal application directories. A consumer can replace `app/pages/index.vue`, layouts, or a stable shell component by providing the same component name:
-
-- `SiteHeader`, `SiteFooter`, `SiteBanner`, `SiteLogoMark`
-- `SiteLocaleSwitcher`, `SiteInteractionLayer`, `DocsSidebar`
-
-Load consumer theme CSS from an app plugin so it follows the layer styles without replacing Nuxt's merged `css` array.
-
-To add an authored MDC component, extend the exported tag map and declare its static render policy:
-
-```ts [nuxt.config.ts]
-import { ginkoDocsComponentTags } from "@lupinum/ginko-docs/components";
-
-export default defineNuxtConfig({
-  content: {
-    componentPolicy: {
-      components: {
-        "api-playground": {
-          kind: "block",
-          props: {
-            method: { type: "string", required: true },
-            path: { type: "string", required: true },
-          },
-          slots: ["default"],
-          media: null,
-        },
-      },
-    },
-    markdown: {
-      tags: {
-        ...ginkoDocsComponentTags,
-        "api-playground": "MdcApiPlayground",
-      },
-    },
-  },
-});
-```
-
-Register the Vue component globally because Markdown resolves component targets dynamically. Register a serializer through `@lupinum/ginko-content/agent-registry` when copied and raw Markdown needs a representation other than the default XML-style component output.
-
-## Agent and discovery surfaces
+Put Markdown files in `content/docs`. Open `/docs` after the Nuxt server starts.
 
-Every deployment can include the prerendered routes and assets:
+## Exports
 
-- `/raw/**.md`
-- `/llms.txt` and `/llms-full.txt`
-- localized LLM catalogs
-- sitemap, robots, and PNG social images
+- `@lupinum/ginko-docs` is the Nuxt layer entry.
+- `@lupinum/ginko-docs/content` exports `defineGinkoDocsConfig`.
+- `@lupinum/ginko-docs/app-config` exports application configuration types.
+- `@lupinum/ginko-docs/components` exports the public MDC component contract.
 
-A Nitro server also provides request-time `Accept: text/markdown` negotiation, response link headers, and `/mcp`. The MCP server exposes read-only `list-pages` and `get-page` tools. Plain static hosting cannot provide those request-time behaviors.
+## Documentation
 
-The `markdownActions` app settings change the page menu only; they do not disable agent routes.
+Read the [Ginko Docs documentation](https://ginko-docs.lupinum.com) and the [root README](https://github.com/lupinum-dev/ginko-docs#readme).
 
-## Public exports
+## Support and security
 
-| Export                           | Contents                                                      |
-| -------------------------------- | ------------------------------------------------------------- |
-| `@lupinum/ginko-docs`            | Nuxt layer entry                                              |
-| `@lupinum/ginko-docs/content`    | `defineGinkoDocsConfig`                                       |
-| `@lupinum/ginko-docs/app-config` | App-configuration types                                       |
-| `@lupinum/ginko-docs/components` | Tag map, component names, component policy, and related types |
+Use [GitHub issues](https://github.com/lupinum-dev/ginko-docs/issues) or the [Lupinum OSS Discord](https://discord.gg/RPH6SeA36N) for support. Report vulnerabilities through the [private security process](https://github.com/lupinum-dev/ginko-docs/security/policy).
 
 ## License
 
-[MIT](./LICENSE)
+Released by [Lupinum OG](https://lupinum.com) under the [MIT License](https://github.com/lupinum-dev/ginko-docs/blob/main/LICENSE).

package/app/app.config.ts

@@ -18,6 +18,7 @@ export default {
       logo: { light: "/logo.svg", dark: "/logo-dark.svg" },
       docsSidebarSwitcher: "tabs",
       lupinumAttribution: true,
+      legalLinks: [],
     },
     nav: { links: "auto", socialIcons: false },
     banner: {

package/app/components/site/SiteFooter.vue

@@ -61,17 +61,29 @@ const resources = computed(() => [
           © <NuxtTime :datetime="currentYearDate" year="numeric" /> {{ site.name }}.
           {{ t("site.footer") }}
         </p>
-        <p v-if="site.lupinumAttribution">
-          {{ t("site.openSourceBy") }}
-          <a
-            href="https://lupinum.com"
-            target="_blank"
-            rel="noopener noreferrer"
-            class="font-medium text-foreground underline decoration-border underline-offset-4 transition-colors hover:decoration-foreground"
+        <div class="flex flex-wrap items-center justify-center gap-x-4 gap-y-2 sm:justify-end">
+          <NuxtLink
+            v-for="link in site.legalLinks"
+            :key="link.href"
+            :to="link.href"
+            :target="link.external ? '_blank' : undefined"
+            :rel="link.external ? 'noopener noreferrer' : undefined"
+            class="underline decoration-border underline-offset-4 transition-colors hover:text-foreground hover:decoration-foreground"
           >
-            Lupinum<span class="sr-only"> ({{ t("nav.externalLink") }})</span> </a
-          >.
-        </p>
+            {{ link.label }}
+          </NuxtLink>
+          <p v-if="site.lupinumAttribution">
+            {{ t("site.openSourceBy") }}
+            <a
+              href="https://lupinum.com"
+              target="_blank"
+              rel="noopener noreferrer"
+              class="font-medium text-foreground underline decoration-border underline-offset-4 transition-colors hover:decoration-foreground"
+            >
+              Lupinum<span class="sr-only"> ({{ t("nav.externalLink") }})</span> </a
+            >.
+          </p>
+        </div>
       </div>
     </div>
   </footer>

package/app/composables/useSiteNavigation.ts

@@ -22,6 +22,14 @@ export const useSiteNavigation = () => {
     logo: config.site.logo,
     url: config.site.url,
     lupinumAttribution: config.site.lupinumAttribution,
+    legalLinks: config.site.legalLinks.map((link) => {
+      const href = getLocalizedSiteText(link.to, locale.value);
+      return {
+        label: getLocalizedSiteText(link.label, locale.value),
+        href,
+        external: /^https?:\/\//.test(href),
+      };
+    }),
   }));
 
   const blogPath = computed(() => path("blog"));

package/modules/analytics-boundary.ts

@@ -0,0 +1,23 @@
+import { defineNuxtModule } from "@nuxt/kit";
+
+function componentDirectoryPath(entry: string | { path: string }) {
+  return (typeof entry === "string" ? entry : entry.path).replaceAll("\\", "/");
+}
+
+export function isNuxtScriptsComponentDirectory(entry: string | { path: string }) {
+  const path = componentDirectoryPath(entry);
+  return (
+    (path.includes("/node_modules/@nuxt/scripts/") || path.includes("/@nuxt+scripts@")) &&
+    path.endsWith("/node_modules/@nuxt/scripts/dist/runtime/components")
+  );
+}
+
+export default defineNuxtModule({
+  meta: { name: "ginko-docs-analytics-boundary" },
+  setup(_options, nuxt) {
+    nuxt.hook("components:dirs", (dirs) => {
+      const usedDirectories = dirs.filter((entry) => !isNuxtScriptsComponentDirectory(entry));
+      dirs.splice(0, dirs.length, ...usedDirectories);
+    });
+  },
+});

package/modules/feature-routing.ts

@@ -1,6 +1,6 @@
-import { defineNuxtModule } from "@nuxt/kit";
+import { defineNuxtModule, installModule } from "@nuxt/kit";
 import type {} from "@lupinum/ginko-content";
-import { localeCodes, localizedPath } from "../i18n/locales";
+import { defaultLocale, localeCodes, locales, localizedPath } from "../i18n/locales";
 import { routeSlugs } from "../shared/route-slugs";
 
 interface PageRoute {
@@ -24,7 +24,28 @@ export function removeBlogPages(pages: PageRoute[], blogEnabled: boolean) {
 
 export default defineNuxtModule({
   meta: { name: "ginko-docs-feature-routing" },
-  setup(_options, nuxt) {
+  async setup(_options, nuxt) {
+    const fallback = locales.find((locale) => locale.code === defaultLocale);
+    if (!fallback) throw new Error(`Missing locale definition for ${defaultLocale}.`);
+    const configuredLocales = nuxt.options.i18n?.locales;
+    if (!Array.isArray(configuredLocales) || configuredLocales.length === 0) {
+      nuxt.options.i18n = {
+        ...nuxt.options.i18n,
+        locales: [{ code: fallback.code, language: fallback.language, name: fallback.name }],
+      };
+    } else if (configuredLocales.length > 1) {
+      const fallbackIndex = configuredLocales.findIndex(
+        (locale) =>
+          typeof locale === "object" &&
+          locale !== null &&
+          locale.code === fallback.code &&
+          locale.language === fallback.language &&
+          locale.name === fallback.name,
+      );
+      if (fallbackIndex >= 0) configuredLocales.splice(fallbackIndex, 1);
+    }
+    await installModule("@nuxtjs/i18n");
+
     let blogEnabled = false;
 
     nuxt.hook("content:context", (context) => {

package/nuxt.config.ts

@@ -1,17 +1,29 @@
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
 import tailwindcss from "@tailwindcss/vite";
 import { transformerNotationDiff, transformerNotationHighlight } from "@shikijs/transformers";
 import darkPlus from "shiki/dist/themes/dark-plus.mjs";
 import lightPlus from "shiki/dist/themes/light-plus.mjs";
 import { contentComponentPolicy, contentComponentTags } from "./tags";
 import { i18nPages } from "./i18n/routes";
-import { localeCodes, localizedPath } from "./i18n/locales";
+import { defaultLocale, localeCodes, locales, localizedPath } from "./i18n/locales";
 import { routeSlugs } from "./shared/route-slugs";
 import { layerIconCollections, layerIconNames } from "./icon-bundle";
 
 const root = dirname(fileURLToPath(import.meta.url));
 const app = join(root, "app");
+const publicSansDirectory = join(root, "public/fonts/public-sans");
+const publicSansFamilies = [400, 500, 600, 700].map((weight) => ({
+  name: "Public Sans",
+  global: true,
+  display: "swap" as const,
+  weight,
+  style: "normal",
+  src: `data:font/woff;base64,${readFileSync(
+    join(publicSansDirectory, `public-sans-${weight}-normal-latin.woff`),
+  ).toString("base64")}`,
+}));
 
 export default defineNuxtConfig({
   build: {
@@ -25,10 +37,10 @@ export default defineNuxtConfig({
     join(root, "modules/feature-routing"),
     "@nuxt/icon",
     "@nuxt/fonts",
-    "@nuxtjs/i18n",
     "@lupinum/ginko-content",
     "@nuxt/image",
     "@nuxt/scripts",
+    join(root, "modules/analytics-boundary"),
     "nuxt-og-image",
     "@nuxtjs/sitemap",
     "@nuxtjs/robots",
@@ -43,7 +55,7 @@ export default defineNuxtConfig({
   },
   mcp: {
     name: "Ginko Docs",
-    version: "0.3.0-rc.3",
+    version: "0.3.0-rc.5",
   },
   components: {
     dirs: [
@@ -101,17 +113,24 @@ export default defineNuxtConfig({
     },
   },
   fonts: {
-    defaults: {
-      weights: [400, 500, 600, 700],
-      styles: ["normal"],
-      subsets: ["latin", "latin-ext"],
+    families: publicSansFamilies,
+    providers: {
+      adobe: false,
+      bunny: false,
+      fontshare: false,
+      fontsource: false,
+      google: false,
+      googleicons: false,
+      npm: false,
     },
-    families: [{ name: "Public Sans", provider: "google", global: true }],
   },
   i18n: {
     customRoutes: "config",
     defaultLocale: "en",
     detectBrowserLanguage: false,
+    locales: locales
+      .filter((locale) => locale.code === defaultLocale)
+      .map(({ code, language, name }) => ({ code, language, name })),
     pages: i18nPages,
     strategy: "prefix_except_default",
     vueI18n: join(root, "i18n/i18n.config.ts"),
@@ -189,17 +208,6 @@ export default defineNuxtConfig({
     },
   },
   vite: {
-    optimizeDeps: {
-      include: [
-        "@vueuse/core",
-        "class-variance-authority",
-        "clsx",
-        "motion-v",
-        "reka-ui",
-        "tailwind-merge",
-        "zod",
-      ],
-    },
     resolve: {
       dedupe: ["@lupinum/ginko-content", "vue", "vue-router"],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-docs",
-  "version": "0.3.0-rc.3",
+  "version": "0.3.0-rc.5",
   "description": "A Nuxt documentation layer powered by Ginko Content.",
   "keywords": [
     "content",
@@ -14,6 +14,7 @@
     "url": "https://github.com/lupinum-dev/ginko-docs/issues"
   },
   "license": "MIT",
+  "author": "Lupinum OG <info@lupinum.com> (https://lupinum.com)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lupinum-dev/ginko-docs.git",
@@ -23,6 +24,7 @@
     "app",
     "i18n",
     "modules",
+    "public",
     "runtime",
     "server",
     "shared",
@@ -83,8 +85,8 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@lupinum/ginko-content": ">=0.4.0-rc.1 <0.5.0",
-    "nuxt": ">=4.4.7 <5",
+    "@lupinum/ginko-content": ">=0.4.0-rc.2 <0.5.0",
+    "nuxt": ">=4.5.1 <5",
     "vue": "^3.5.35",
     "vue-router": "^5.1.0"
   },

package/public/fonts/public-sans/LICENSE

@@ -0,0 +1,93 @@
+Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans) PublicSans-Italic[wght].ttf: Copyright 2015 The Public Sans Project Authors (https://github.com/uswds/public-sans)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/public/fonts/public-sans/README.md

@@ -0,0 +1,12 @@
+# Public Sans
+
+These Latin-subset WOFF files are copied from `@fontsource/public-sans@5.3.0`:
+
+- `public-sans-latin-400-normal.woff`
+- `public-sans-latin-500-normal.woff`
+- `public-sans-latin-600-normal.woff`
+- `public-sans-latin-700-normal.woff`
+
+They are renamed to the convention expected by the Nuxt Fonts local provider.
+The upstream package is available at <https://fontsource.org/fonts/public-sans>.
+Public Sans is licensed under the SIL Open Font License 1.1; see `LICENSE`.

package/shared/types/app-config.ts

@@ -71,6 +71,8 @@ export interface GinkoDocsAppConfig {
     logo: { light: string; dark: string };
     docsSidebarSwitcher: "dropdown" | "list" | "tabs";
     lupinumAttribution: boolean;
+    /** Legal and company links rendered in the footer. */
+    legalLinks: GinkoDocsLink[];
   };
   nav: {
     /** "auto" derives Docs (+ Blog when blog routes exist); an array overrides entirely. */