@waveso/docs 0.5.0 → 0.7.0

package/dist/react/link-adapter.d.ts

@@ -0,0 +1,34 @@
+import { DocsLinkComponent } from "./markdown-components.js";
+import { ComponentProps, ComponentType } from "react";
+//#region src/react/link-adapter.d.ts
+/**
+ * The part of `next/link` this package uses.
+ *
+ * Declared structurally rather than imported: `next` is an optional peer, and
+ * a type-only import of it would still be a hard resolution requirement for
+ * anyone type-checking against our `.d.ts`.
+ */
+type NextLinkComponent = ComponentType<Omit<ComponentProps<'a'>, 'href' | 'ref'> & {
+  href: string;
+  prefetch?: boolean | null;
+}>;
+/**
+ * Adapt `next/link` to {@link DocsLinkProps}.
+ *
+ * `next/link` widens `href` to `string | UrlObject` and `prefetch` to
+ * `boolean | 'auto' | null`; the React layer promises neither, because it must
+ * also run with a plain `<a>`. One wrapper keeps that mismatch in a single
+ * place instead of at every call site.
+ *
+ * `prefetch` is omitted rather than passed as `undefined`, which is not
+ * pedantry: under `exactOptionalPropertyTypes` — which this package compiles
+ * with, and which any consumer may turn on — `undefined` is not assignable to
+ * `boolean | 'auto' | null`, and `<SearchDialog Link={Link} />` written by
+ * hand fails to compile for a reason that reads as our bug.
+ *
+ * Call it once at module scope, never during a render: a fresh component
+ * identity for `a` remounts every link in the document on every render.
+ */
+declare function wrapNextLink(NextLink: NextLinkComponent): DocsLinkComponent;
+//#endregion
+export { NextLinkComponent, wrapNextLink };

package/dist/react/link-adapter.js

@@ -0,0 +1,30 @@
+import { createElement } from "react";
+//#region src/react/link-adapter.ts
+/**
+* Adapt `next/link` to {@link DocsLinkProps}.
+*
+* `next/link` widens `href` to `string | UrlObject` and `prefetch` to
+* `boolean | 'auto' | null`; the React layer promises neither, because it must
+* also run with a plain `<a>`. One wrapper keeps that mismatch in a single
+* place instead of at every call site.
+*
+* `prefetch` is omitted rather than passed as `undefined`, which is not
+* pedantry: under `exactOptionalPropertyTypes` — which this package compiles
+* with, and which any consumer may turn on — `undefined` is not assignable to
+* `boolean | 'auto' | null`, and `<SearchDialog Link={Link} />` written by
+* hand fails to compile for a reason that reads as our bug.
+*
+* Call it once at module scope, never during a render: a fresh component
+* identity for `a` remounts every link in the document on every render.
+*/
+function wrapNextLink(NextLink) {
+	return function DocsNextLink({ href, prefetch, children, ...rest }) {
+		return createElement(NextLink, {
+			...rest,
+			href,
+			...prefetch === void 0 ? {} : { prefetch }
+		}, children);
+	};
+}
+//#endregion
+export { wrapNextLink };

package/dist/react/nav.d.ts

@@ -2,14 +2,7 @@ import { DocNavNode } from "../types.js";
 import { DocsLinkComponent } from "./markdown-components.js";
 import { ReactNode } from "react";
 //#region src/react/nav.d.ts
-/**
- * The drawer's `id`, and the header trigger's `commandfor`.
- *
- * A constant rather than a `useId`, for two reasons that both matter: the
- * trigger is rendered on the server in a different subtree and cannot see a
- * hook's value, and `command`/`commandfor` must agree before React hydrates or
- * the button does nothing on the first tap.
- */
+/** The navigation's `id`, and the trigger's `aria-controls`. */
 declare const DOCS_NAV_ID = "wave-docs-nav";
 interface DocsNavProps {
   /** The tree from `docs.source.nav()`. */
@@ -18,15 +11,22 @@ interface DocsNavProps {
   pathname: string;
   /** Client-side router link, e.g. `next/link`. Falls back to `<a>`. */
   Link?: DocsLinkComponent | undefined;
-  /** Accessible name for the nav landmark and the drawer. */
+  /** Accessible name for the nav landmark. */
   label?: string | undefined;
-  /** Accessible name for the close button. */
+  /** Accessible name for the trigger while the sidebar is open. */
   closeLabel?: string | undefined;
+  /** Accessible name for the trigger while the sidebar is closed. */
+  openLabel?: string | undefined;
+  /**
+   * Rendered above the tree. The search trigger goes here — it belongs to the
+   * navigation, so it moves with it and is never a second thing to place.
+   */
+  children?: ReactNode;
   /** Passed through to the tree. See `DocsSidebarProps.expandGroup`. */
   expandGroup?: string | undefined;
   collapseGroup?: string | undefined;
   externalLink?: string | undefined;
 }
-declare function DocsNav({ nav, pathname, Link, label, closeLabel, expandGroup, collapseGroup, externalLink }: DocsNavProps): ReactNode;
+declare function DocsNav({ nav, pathname, Link, label, children, closeLabel, openLabel, expandGroup, collapseGroup, externalLink }: DocsNavProps): ReactNode;
 //#endregion
 export { DOCS_NAV_ID, DocsNav, DocsNavProps };

package/dist/react/nav.js

@@ -1,73 +1,121 @@
 "use client";
 import { DocsSidebar } from "./sidebar.js";
-import { useEffect, useRef } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/nav.tsx
-/**
-* The drawer's `id`, and the header trigger's `commandfor`.
-*
-* A constant rather than a `useId`, for two reasons that both matter: the
-* trigger is rendered on the server in a different subtree and cannot see a
-* hook's value, and `command`/`commandfor` must agree before React hydrates or
-* the button does nothing on the first tap.
-*/
+/** The navigation's `id`, and the trigger's `aria-controls`. */
 const DOCS_NAV_ID = "wave-docs-nav";
-function DocsNav({ nav, pathname, Link, label = "Documentation", closeLabel = "Close navigation", expandGroup, collapseGroup, externalLink }) {
-	const ref = useRef(null);
+function DocsNav({ nav, pathname, Link, label = "Documentation", children, closeLabel = "Close navigation", openLabel = "Open navigation", expandGroup, collapseGroup, externalLink }) {
+	const shellRef = useRef(null);
+	const navRef = useRef(null);
+	const returnFocusRef = useRef(null);
+	/**
+	* ⚠️ THREE STATES, AND THE THIRD ONE IS WHY THERE IS NO FLASH.
+	*
+	* `null` is "nobody has chosen yet". The server renders it, no `data-state`
+	* reaches the DOM, and the stylesheet decides per mode — closed where the
+	* navigation would cover the article, open where it would sit beside it. So
+	* the first paint is already right at both shapes, with no JavaScript and
+	* nothing to correct afterwards.
+	*
+	* A boolean would have to be picked before the container's width is known,
+	* which is either a flash on a phone or a flash on a desktop.
+	*/
+	const [choice, setChoice] = useState(null);
+	const [mode, setMode] = useState(null);
+	const [ready, setReady] = useState(false);
+	const open = choice ?? mode === "push";
+	const covering = mode === "cover" && open;
 	useEffect(() => {
-		ref.current?.close?.();
+		const shell = shellRef.current;
+		const layout = shell?.parentElement;
+		if (shell == null || layout == null) return;
+		const read = () => {
+			const value = getComputedStyle(shell).getPropertyValue("--wave-docs-sidebar-mode").trim();
+			setMode(value === "push" ? "push" : "cover");
+		};
+		read();
+		const frame = requestAnimationFrame(() => {
+			setReady(true);
+		});
+		const observer = new ResizeObserver(read);
+		observer.observe(layout);
+		return () => {
+			cancelAnimationFrame(frame);
+			observer.disconnect();
+		};
+	}, []);
+	const close = useCallback(() => {
+		setChoice(false);
+	}, []);
+	useEffect(() => {
+		if (covering) setChoice(false);
 	}, [pathname]);
 	useEffect(() => {
-		if ("command" in HTMLButtonElement.prototype) return;
-		const onClick = (event) => {
-			const target = event.target;
-			if (!(target instanceof Element)) return;
-			const button = target.closest("button[commandfor]");
-			if (button === null) return;
-			if (button.getAttribute("commandfor") !== "wave-docs-nav") return;
-			const dialog = ref.current;
-			if (dialog === null) return;
-			if (button.getAttribute("command") === "close") dialog.close();
-			else dialog.showModal();
+		if (!covering) return;
+		const onKeyDown = (event) => {
+			if (event.key !== "Escape") return;
+			event.stopPropagation();
+			close();
 		};
-		document.addEventListener("click", onClick);
+		document.addEventListener("keydown", onKeyDown);
 		return () => {
-			document.removeEventListener("click", onClick);
+			document.removeEventListener("keydown", onKeyDown);
 		};
-	}, []);
-	return /* @__PURE__ */ jsxs("dialog", {
-		ref,
-		id: DOCS_NAV_ID,
-		className: "wave-docs-layout__drawer",
-		closedby: "any",
-		"aria-label": label,
-		children: [/* @__PURE__ */ jsx("button", {
+	}, [covering, close]);
+	useEffect(() => {
+		const shell = shellRef.current;
+		const layout = shell?.parentElement;
+		if (shell == null || layout == null) return;
+		const outside = [...layout.children].filter((child) => child !== shell && !child.classList.contains(SCRIM_CLASS));
+		if (!covering) {
+			for (const element of outside) element.removeAttribute("inert");
+			return;
+		}
+		returnFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+		for (const element of outside) element.setAttribute("inert", "");
+		navRef.current?.focus();
+		return () => {
+			for (const element of outside) element.removeAttribute("inert");
+			returnFocusRef.current?.focus({ preventScroll: true });
+		};
+	}, [covering]);
+	const state = choice === null && mode === null ? void 0 : open;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("div", {
+		ref: shellRef,
+		className: "wave-docs-layout__sidebar",
+		...state === void 0 ? {} : { "data-state": state ? "open" : "closed" },
+		...ready ? { "data-ready": "" } : {},
+		children: [/* @__PURE__ */ jsxs("div", {
+			ref: navRef,
+			id: DOCS_NAV_ID,
+			className: "wave-docs-layout__sidebar-nav",
+			tabIndex: -1,
+			children: [children, /* @__PURE__ */ jsx(DocsSidebar, {
+				nav,
+				pathname,
+				label,
+				Link,
+				...expandGroup === void 0 ? {} : { expandGroup },
+				...collapseGroup === void 0 ? {} : { collapseGroup },
+				...externalLink === void 0 ? {} : { externalLink }
+			})]
+		}), /* @__PURE__ */ jsx("button", {
 			type: "button",
-			className: "wave-docs-layout__drawer-close",
-			"aria-label": closeLabel,
-			command: "close",
-			commandfor: DOCS_NAV_ID,
-			children: /* @__PURE__ */ jsx("svg", {
-				"aria-hidden": "true",
-				viewBox: "0 0 16 16",
-				width: "16",
-				height: "16",
-				fill: "none",
-				stroke: "currentColor",
-				strokeWidth: "1.5",
-				strokeLinecap: "round",
-				children: /* @__PURE__ */ jsx("path", { d: "M4 4l8 8M12 4l-8 8" })
-			})
-		}), /* @__PURE__ */ jsx(DocsSidebar, {
-			nav,
-			pathname,
-			label,
-			Link,
-			...expandGroup === void 0 ? {} : { expandGroup },
-			...collapseGroup === void 0 ? {} : { collapseGroup },
-			...externalLink === void 0 ? {} : { externalLink }
+			className: "wave-docs-layout__sidebar-trigger",
+			"aria-controls": DOCS_NAV_ID,
+			"aria-label": open ? closeLabel : openLabel,
+			...state === void 0 ? {} : { "aria-expanded": state },
+			onClick: () => {
+				setChoice(!open);
+			}
 		})]
-	});
+	}), /* @__PURE__ */ jsx("div", {
+		className: SCRIM_CLASS,
+		"aria-hidden": "true",
+		onClick: close
+	})] });
 }
+const SCRIM_CLASS = "wave-docs-layout__sidebar-scrim";
 //#endregion
 export { DOCS_NAV_ID, DocsNav };

package/dist/react/next-link.d.ts

@@ -1,34 +1,12 @@
 import { DocsLinkComponent } from "./markdown-components.js";
-import { ComponentProps, ComponentType } from "react";
 //#region src/react/next-link.d.ts
 /**
- * The part of `next/link` this package uses.
+ * Module scope, and never inside a render.
  *
- * Declared structurally rather than imported: `next` is an optional peer, and
- * a type-only import of it would still be a hard resolution requirement for
- * anyone type-checking against our `.d.ts`.
+ * A fresh component identity for a link remounts every link in the document on
+ * every render — which is why `next-search.tsx` and `next-nav.tsx` each build
+ * theirs at module scope too, and why this is a constant rather than a factory.
  */
-type NextLinkComponent = ComponentType<Omit<ComponentProps<'a'>, 'href' | 'ref'> & {
-  href: string;
-  prefetch?: boolean | null;
-}>;
-/**
- * Adapt `next/link` to {@link DocsLinkProps}.
- *
- * `next/link` widens `href` to `string | UrlObject` and `prefetch` to
- * `boolean | 'auto' | null`; the React layer promises neither, because it must
- * also run with a plain `<a>`. One wrapper keeps that mismatch in a single
- * place instead of at every call site.
- *
- * `prefetch` is omitted rather than passed as `undefined`, which is not
- * pedantry: under `exactOptionalPropertyTypes` — which this package compiles
- * with, and which any consumer may turn on — `undefined` is not assignable to
- * `boolean | 'auto' | null`, and `<SearchDialog Link={Link} />` written by
- * hand fails to compile for a reason that reads as our bug.
- *
- * Call it once at module scope, never during a render: a fresh component
- * identity for `a` remounts every link in the document on every render.
- */
-declare function wrapNextLink(NextLink: NextLinkComponent): DocsLinkComponent;
+declare const DocsLink: DocsLinkComponent;
 //#endregion
-export { NextLinkComponent, wrapNextLink };
+export { DocsLink };

package/dist/react/next-link.js

@@ -1,30 +1,51 @@
-import { createElement } from "react";
-//#region src/react/next-link.ts
+"use client";
+import { wrapNextLink } from "./link-adapter.js";
+import NextLink from "next/link";
+//#region src/react/next-link.tsx
 /**
-* Adapt `next/link` to {@link DocsLinkProps}.
+* `next/link`, adapted to this package's {@link DocsLinkProps} and ready to pass.
 *
-* `next/link` widens `href` to `string | UrlObject` and `prefetch` to
-* `boolean | 'auto' | null`; the React layer promises neither, because it must
-* also run with a plain `<a>`. One wrapper keeps that mismatch in a single
-* place instead of at every call site.
+* ⚠️ IT EXISTS BECAUSE PASSING `next/link` DIRECTLY DOES NOT TYPE-CHECK. Under
+* `exactOptionalPropertyTypes` — which this package compiles with, and which any
+* consumer may turn on — Next's `LinkProps` re-declares `onClick?`,
+* `onMouseEnter?` and `onTouchStart?` *without* `| undefined` while React's
+* anchor props include it, so `<DocsSidebar Link={Link} />` fails to compile
+* over three handlers `next/link` accepts perfectly well at run time. It is a
+* disagreement between two dependencies' declaration files, true of every
+* `next/link` call site in a project with that flag on, and nothing the shape of
+* `DocsLinkProps` can fix without breaking the plain-`<a>` fallback that makes
+* these components host-agnostic.
 *
-* `prefetch` is omitted rather than passed as `undefined`, which is not
-* pedantry: under `exactOptionalPropertyTypes` — which this package compiles
-* with, and which any consumer may turn on — `undefined` is not assignable to
-* `boolean | 'auto' | null`, and `<SearchDialog Link={Link} />` written by
-* hand fails to compile for a reason that reads as our bug.
+* `docs.Layout` and `DocsSearch` have always absorbed it internally, so it only
+* ever bit someone composing a shell by hand — who was told to write
+* `Link={Link as DocsLinkComponent}` and wait for this module. This is it; the
+* cast is retired.
 *
-* Call it once at module scope, never during a render: a fresh component
-* identity for `a` remounts every link in the document on every render.
+* ```tsx
+* 'use client';
+* import { DocsLink } from '@waveso/docs/react/next-link';
+* import { DocsSidebar } from '@waveso/docs/react/sidebar';
+*
+* <DocsSidebar nav={nav} pathname={pathname} Link={DocsLink} />
+* ```
+*
+* ## Why `'use client'`
+*
+* Not for a hook — there is none. {@link DocsLink} is a *function*, and a
+* function cannot be handed from a Server Component to a Client one: React
+* serialises those props and refuses. Without the directive this module's export
+* would be a server reference, and passing it to `DocsSidebar` — which is itself
+* `'use client'` — would fail `next build` with "Functions cannot be passed
+* directly to Client Components". The directive makes it a client reference,
+* which crosses fine.
+*/
+/**
+* Module scope, and never inside a render.
+*
+* A fresh component identity for a link remounts every link in the document on
+* every render — which is why `next-search.tsx` and `next-nav.tsx` each build
+* theirs at module scope too, and why this is a constant rather than a factory.
 */
-function wrapNextLink(NextLink) {
-	return function DocsNextLink({ href, prefetch, children, ...rest }) {
-		return createElement(NextLink, {
-			...rest,
-			href,
-			...prefetch === void 0 ? {} : { prefetch }
-		}, children);
-	};
-}
+const DocsLink = wrapNextLink(NextLink);
 //#endregion
-export { wrapNextLink };
+export { DocsLink };

package/dist/react/next-nav.d.ts

@@ -5,11 +5,15 @@ interface DocsNextNavProps {
   nav: DocNavNode[];
   label?: string | undefined;
   closeLabel?: string | undefined;
+  /** Accessible name for the trigger while the sidebar is closed. */
+  openLabel?: string | undefined;
+  /** Rendered above the tree. See `DocsNavProps.children`. */
+  children?: ReactNode;
   /** Passed through to the tree. See `DocsSidebarProps.expandGroup`. */
   expandGroup?: string | undefined;
   collapseGroup?: string | undefined;
   externalLink?: string | undefined;
 }
-declare function DocsNextNav({ nav, label, closeLabel, expandGroup, collapseGroup, externalLink }: DocsNextNavProps): ReactNode;
+declare function DocsNextNav({ nav, label, closeLabel, openLabel, children, expandGroup, collapseGroup, externalLink }: DocsNextNavProps): ReactNode;
 //#endregion
 export { DocsNextNav, DocsNextNavProps };

package/dist/react/next-nav.js

@@ -1,5 +1,5 @@
 "use client";
-import { wrapNextLink } from "./next-link.js";
+import { wrapNextLink } from "./link-adapter.js";
 import { DocsNav } from "./nav.js";
 import { jsx } from "react/jsx-runtime";
 import NextLink from "next/link";
@@ -19,16 +19,18 @@ import { usePathname } from "next/navigation";
 */
 /** Module scope: a fresh identity here remounts every nav link on every render. */
 const Link = wrapNextLink(NextLink);
-function DocsNextNav({ nav, label, closeLabel, expandGroup, collapseGroup, externalLink }) {
+function DocsNextNav({ nav, label, closeLabel, openLabel, children, expandGroup, collapseGroup, externalLink }) {
 	return /* @__PURE__ */ jsx(DocsNav, {
 		nav,
 		pathname: usePathname(),
 		Link,
 		...label === void 0 ? {} : { label },
 		...closeLabel === void 0 ? {} : { closeLabel },
+		...openLabel === void 0 ? {} : { openLabel },
 		...expandGroup === void 0 ? {} : { expandGroup },
 		...collapseGroup === void 0 ? {} : { collapseGroup },
-		...externalLink === void 0 ? {} : { externalLink }
+		...externalLink === void 0 ? {} : { externalLink },
+		children
 	});
 }
 //#endregion

package/dist/react/next-search.js

@@ -1,5 +1,5 @@
 "use client";
-import { wrapNextLink } from "./next-link.js";
+import { wrapNextLink } from "./link-adapter.js";
 import { SearchDialog } from "./search-dialog.js";
 import { useCallback } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/react/shell-labels.d.ts

@@ -44,9 +44,15 @@
 interface DocsLabels {
   /** The navigation landmark's accessible name. Default `'Documentation'`. */
   nav?: string | undefined;
-  /** The header button that opens the drawer. Default `'Open navigation'`. */
+  /**
+   * The sidebar's trigger, named for what pressing it does next. One button
+   * carries both strings: `openNav` while the sidebar is closed, `closeNav`
+   * while it is open.
+   *
+   * Default `'Open navigation'`.
+   */
   openNav?: string | undefined;
-  /** The button that closes the drawer. Default `'Close navigation'`. */
+  /** The same button, while the sidebar is open. Default `'Close navigation'`. */
   closeNav?: string | undefined;
   /** The skip link's visible text. Default `'Skip to content'`. */
   skipToContent?: string | undefined;

package/dist/react/toc.d.ts

@@ -8,9 +8,19 @@ interface DocsTocProps {
   label?: string | undefined;
   /**
    * Region of the viewport that counts as "current", as an
-   * `IntersectionObserver` root margin. The default reserves 80px for a sticky
-   * header and ignores the bottom 60% of the screen, so the active entry
-   * tracks what you are reading rather than what has scrolled into view.
+   * `IntersectionObserver` root margin. The default ignores the bottom 60% of
+   * the screen, so the active entry tracks what you are reading rather than
+   * what has scrolled into view.
+   *
+   * ⚠️ IT USED TO RESERVE 80px FOR A STICKY HEADER, AND TWO THINGS WERE WRONG
+   * WITH THAT. There is no header — above 80rem, where this component
+   * is rendered at all, nothing of ours overlays the content. And 80px never
+   * matched the header anyway: the token was `3.5rem`, which is 56px, so the
+   * figure was never derived from the thing it claimed to reserve for.
+   *
+   * This component is exported standalone, so its default cannot assume our
+   * shell. It assumes nothing overlays the content; a host whose own chrome
+   * does sets this prop, which is what the prop is for.
    *
    * Only `px` and `%` are legal here — `IntersectionObserver` throws on any
    * other unit, `rem` included.

package/dist/react/toc.js

@@ -3,7 +3,7 @@ import { DOCS_CONTENT_ID } from "../docs-content-id.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/toc.tsx
-const DEFAULT_ROOT_MARGIN = "-80px 0px -60% 0px";
+const DEFAULT_ROOT_MARGIN = "0px 0px -60% 0px";
 /**
 * How many frames to keep looking for headings that are not in the document
 * yet. ~1s at 60Hz, which covers a `<Suspense>` boundary resolving or a
@@ -86,15 +86,22 @@ function DocsToc({ entries, label = "On this page", rootMargin = DEFAULT_ROOT_MA
 	return /* @__PURE__ */ jsxs("nav", {
 		"aria-label": label,
 		className: ["wave-docs-toc", className].filter(Boolean).join(" "),
-		children: [/* @__PURE__ */ jsx(TocList, {
-			entries,
-			activeId,
-			onSelect: setActiveId
-		}), /* @__PURE__ */ jsx("a", {
-			className: "wave-docs-toc__top",
-			href: `#${DOCS_CONTENT_ID}`,
-			children: topLabel
-		})]
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				className: "wave-docs-toc__title",
+				children: label
+			}),
+			/* @__PURE__ */ jsx(TocList, {
+				entries,
+				activeId,
+				onSelect: setActiveId
+			}),
+			/* @__PURE__ */ jsx("a", {
+				className: "wave-docs-toc__top",
+				href: `#${DOCS_CONTENT_ID}`,
+				children: topLabel
+			})
+		]
 	});
 }
 function TocList({ entries, activeId, onSelect }) {

package/dist/render.d.ts

@@ -12,7 +12,7 @@ import { PluggableList } from "unified";
  * same object to the source walk and to the renderer. Nothing here re-applies
  * defaults, so the two cannot drift.
  */
-type DocsRendererConfig = Pick<ResolvedDocsConfig, 'basePath' | 'assertLinks'>;
+type DocsRendererConfig = Pick<ResolvedDocsConfig, 'basePath' | 'onBrokenLinks' | 'onBrokenAnchors' | 'externalRoutes'>;
 interface DocsRendererOptions {
   config: DocsRendererConfig;
   /**