@waveso/docs 0.3.0 → 0.5.0

package/dist/react/callout.d.ts

@@ -16,6 +16,18 @@ interface CalloutProps {
   type?: string | undefined;
   /** Overrides the default label ("Note", "Warning", …). */
   title?: string | undefined;
+  /**
+   * Default headings per type, for a site that is not in English.
+   *
+   * `title` still wins — it is what a single callout in the markdown asked for,
+   * and this is what every callout on the site is called otherwise.
+   *
+   * Here rather than resolved by the caller so that {@link normalizeCalloutType}
+   * stays the one place that decides what an unrecognised type falls back to. A
+   * caller picking the heading itself would need that rule too, and a second
+   * copy of it is a second thing to keep in step.
+   */
+  labels?: Partial<Record<CalloutType, string>> | undefined;
   className?: string | undefined;
   children?: ReactNode;
 }
@@ -32,6 +44,6 @@ interface CalloutProps {
  * All styling lives in `@waveso/docs/styles.css` under `.wave-docs-callout`,
  * so consumers can restyle it without forking the component.
  */
-declare function Callout({ type, title, className, children }: CalloutProps): ReactNode;
+declare function Callout({ type, title, labels, className, children }: CalloutProps): ReactNode;
 //#endregion
 export { CALLOUT_TYPES, Callout, CalloutProps, CalloutType };

package/dist/react/callout.js

@@ -69,9 +69,9 @@ function normalizeCalloutType(value) {
 * All styling lives in `@waveso/docs/styles.css` under `.wave-docs-callout`,
 * so consumers can restyle it without forking the component.
 */
-function Callout({ type, title, className, children }) {
+function Callout({ type, title, labels, className, children }) {
 	const kind = normalizeCalloutType(type);
-	const label = title?.trim() || CALLOUT_LABELS[kind];
+	const label = title?.trim() || labels?.[kind] || CALLOUT_LABELS[kind];
 	return /* @__PURE__ */ jsxs("aside", {
 		role: "note",
 		"aria-label": label,

package/dist/react/code-runtime.d.ts

@@ -1,5 +1,15 @@
 import { ReactNode } from "react";
 //#region src/react/code-runtime.d.ts
+/** The two announcements, for a site that is not in English. */
+interface CodeRuntimeLabels {
+  /** Announced after a successful copy. Default `'Copied to the clipboard.'` */
+  copied?: string | undefined;
+  /**
+   * Announced after a failed one. Default
+   * `'Copy failed. Select the code and press Control or Command + C.'`
+   */
+  copyFailed?: string | undefined;
+}
 /**
  * Mount the copy runtime. Renders nothing.
  *
@@ -9,6 +19,6 @@ import { ReactNode } from "react";
  * re-renders and there is no state to get out of step with a page that was
  * server-rendered.
  */
-declare function DocsCodeRuntime(): ReactNode;
+declare function DocsCodeRuntime({ copied, copyFailed }?: CodeRuntimeLabels): ReactNode;
 //#endregion
-export { DocsCodeRuntime };
+export { CodeRuntimeLabels, DocsCodeRuntime };

package/dist/react/code-runtime.js

@@ -40,6 +40,24 @@ const SKIP_LINE_CLASSES = [];
 const TRIMMED_LINE_CLASSES = [];
 let refCount = 0;
 let detach;
+const DEFAULT_COPIED = "Copied to the clipboard.";
+const DEFAULT_COPY_FAILED = "Copy failed. Select the code and press Control or Command + C.";
+/**
+* Module scope, beside `refCount`, because the listener is a singleton too.
+*
+* The runtime installs once per page however many `DocContent`s mount it, so
+* the messages belong to the installation rather than to a component — and two
+* mounts with different labels would be a page with two languages in it, which
+* is not a case worth code. First one in wins, and `refCount` says which.
+*
+* Spelled out rather than `Required<CodeRuntimeLabels>`: the props are declared
+* `string | undefined` for `exactOptionalPropertyTypes`, and `Required` strips
+* the `?` while leaving the `undefined` in the value type.
+*/
+let messages = {
+	copied: DEFAULT_COPIED,
+	copyFailed: DEFAULT_COPY_FAILED
+};
 /**
 * Mount the copy runtime. Renders nothing.
 *
@@ -49,10 +67,16 @@ let detach;
 * re-renders and there is no state to get out of step with a page that was
 * server-rendered.
 */
-function DocsCodeRuntime() {
+function DocsCodeRuntime({ copied, copyFailed } = {}) {
 	useEffect(() => {
 		refCount += 1;
-		if (refCount === 1) detach = install();
+		if (refCount === 1) {
+			messages = {
+				copied: copied ?? DEFAULT_COPIED,
+				copyFailed: copyFailed ?? DEFAULT_COPY_FAILED
+			};
+			detach = install();
+		}
 		return () => {
 			refCount -= 1;
 			if (refCount === 0) {
@@ -60,7 +84,7 @@ function DocsCodeRuntime() {
 				detach = void 0;
 			}
 		};
-	}, []);
+	}, [copied, copyFailed]);
 	return null;
 }
 function install() {
@@ -110,7 +134,7 @@ function readCode(pre) {
 async function copy(text, button, status) {
 	const copied = await writeClipboard(text) ? "true" : "false";
 	button.dataset.copied = copied;
-	status.textContent = copied === "true" ? "Copied to the clipboard." : "Copy failed. Select the code and press Control or Command + C.";
+	status.textContent = copied === "true" ? messages.copied : messages.copyFailed;
 	const existing = timers.get(button);
 	if (existing !== void 0) window.clearTimeout(existing);
 	timers.set(button, window.setTimeout(() => {

package/dist/react/doc-content.d.ts

@@ -1,4 +1,5 @@
 import { MarkdownComponents } from "./markdown-components.js";
+import { CodeRuntimeLabels } from "./code-runtime.js";
 import { ReactNode } from "react";
 import { Root } from "hast";
 //#region src/react/doc-content.d.ts
@@ -20,6 +21,16 @@ interface DocContentProps {
    * choice rather than as a mistake.
    */
   className?: string | undefined;
+  /**
+   * The two things the copy runtime announces, for a site that is not in
+   * English.
+   *
+   * Here rather than on `docs.Layout` because this is the component that mounts
+   * the runtime, and it is the one no consumer can avoid — the hand-rolled route
+   * in the README renders it directly. Forwarded only when set, so a site that
+   * overrides nothing sends no extra props across the boundary.
+   */
+  labels?: CodeRuntimeLabels | undefined;
 }
 /**
  * Render a hast tree as React elements, inside the prose wrapper.
@@ -61,6 +72,6 @@ interface DocContentProps {
  * you, because `node` is a legal prop on the component and an unknown attribute
  * on the element.
  */
-declare function DocContent({ hast, components, className }: DocContentProps): ReactNode;
+declare function DocContent({ hast, components, className, labels }: DocContentProps): ReactNode;
 //#endregion
 export { DocContent, DocContentProps };

package/dist/react/doc-content.js

@@ -44,10 +44,10 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 * you, because `node` is a legal prop on the component and an unknown attribute
 * on the element.
 */
-function DocContent({ hast, components, className }) {
+function DocContent({ hast, components, className, labels }) {
 	return /* @__PURE__ */ jsxs("div", {
 		className: className === void 0 || className === "" ? "wave-docs-prose" : `wave-docs-prose ${className}`,
-		children: [hasCodeFrame(hast) ? /* @__PURE__ */ jsx(DocsCodeRuntime, {}) : null, toJsxRuntime(hast, {
+		children: [hasCodeFrame(hast) ? /* @__PURE__ */ jsx(DocsCodeRuntime, { ...labels }) : null, toJsxRuntime(hast, {
 			Fragment,
 			jsx,
 			jsxs,

package/dist/react/layout.d.ts

@@ -1,6 +1,7 @@
 import { DocNavNode } from "../types.js";
-import { DocsSearchProps } from "./next-search.js";
+import { SerializableSearchOptions } from "../search-options.js";
 import { DocsLabels } from "./shell-labels.js";
+import { DocsSearchProps } from "./next-search.js";
 import { ReactNode } from "react";
 //#region src/react/layout.d.ts
 /**
@@ -9,8 +10,19 @@ import { ReactNode } from "react";
  * `indexUrl` is derived from `basePath` and is not negotiable here: the whole
  * reason `docs.Layout` exists is that nobody should have to know the index's
  * address, and a hand-passed one is wrong under every non-root `basePath`.
+ *
+ * `miniSearchOptions` is narrower than the one `DocsSearch` itself takes, and
+ * has to be. `docs.Layout` is a Server Component and `DocsSearch` is a Client
+ * Component, so everything here is serialised on its way across — a `tokenize`
+ * or a `processTerm` passed at this seam fails `next build` with *"Functions
+ * cannot be passed directly to Client Components"*. {@link
+ * SerializableSearchOptions} documents the escape hatch: a `'use client'`
+ * wrapper of your own, where the function is a module import on both sides
+ * rather than a prop between them.
  */
-type DocsLayoutSearchProps = Omit<DocsSearchProps, 'indexUrl'>;
+type DocsLayoutSearchProps = Omit<DocsSearchProps, 'indexUrl' | 'miniSearchOptions'> & {
+  miniSearchOptions?: SerializableSearchOptions | undefined;
+};
 interface DocsLayoutShellProps {
   children: ReactNode;
   nav: DocNavNode[];
@@ -20,14 +32,19 @@ interface DocsLayoutShellProps {
   /**
    * `false` to omit the trigger; an object to configure it.
    *
-   * ⚠️ AN OBJECT IS WHAT MAKES `miniSearchOptions` REACHABLE. MiniSearch reads
-   * `tokenize` and `processTerm` both when indexing and when querying, so the
-   * object `createDocsRoute` built the index with has to be the object the
-   * dialog queries it with — and while this was a bare boolean there was no
-   * channel for it at all. Configuring the route and rendering `docs.Layout`
-   * produced an index whose terms no query could spell: zero results, no error,
-   * nothing in the console, and the option's own docstring warning about
-   * exactly that.
+   * ⚠️ AN OBJECT IS WHAT MAKES `miniSearchOptions` REACHABLE, AND ONLY THE
+   * SERIALISABLE PART OF IT. MiniSearch reads `tokenize` and `processTerm` both
+   * when indexing and when querying, so the object `createDocsRoute` built the
+   * index with has to be the object the dialog queries it with — and while this
+   * was a bare boolean there was no channel for it at all. Configuring the
+   * route and rendering `docs.Layout` produced an index whose terms no query
+   * could spell: zero results, no error, nothing in the console.
+   *
+   * Widening it to a boolean-or-object fixed that for data overrides and broke
+   * the function ones, which is the harder half: this prop is serialised on its
+   * way from a Server Component to a Client one, so a function in it is a build
+   * failure rather than a silent miss. `createDocsRoute` refuses to forward one
+   * and says so; {@link DocsLayoutSearchProps} carries the remedy.
    */
   search?: boolean | DocsLayoutSearchProps | undefined;
   /**

package/dist/react/layout.js

@@ -38,8 +38,8 @@ function DocsLayoutShell({ children, nav, searchIndexUrl, title, actions, search
 					}),
 					search === false ? null : /* @__PURE__ */ jsx(DocsSearch, {
 						indexUrl: searchIndexUrl,
-						className: "wave-docs-layout__search",
-						...search === true ? {} : search
+						...search === true ? {} : search,
+						className: ["wave-docs-layout__search", search === true ? void 0 : search?.className].filter(Boolean).join(" ")
 					}),
 					actions === void 0 ? null : /* @__PURE__ */ jsx("div", {
 						className: "wave-docs-layout__actions",
@@ -55,7 +55,10 @@ function DocsLayoutShell({ children, nav, searchIndexUrl, title, actions, search
 				children: /* @__PURE__ */ jsx(DocsNextNav, {
 					nav,
 					label: text.nav,
-					closeLabel: text.closeNav
+					closeLabel: text.closeNav,
+					...labels?.expandGroup === void 0 ? {} : { expandGroup: labels.expandGroup },
+					...labels?.collapseGroup === void 0 ? {} : { collapseGroup: labels.collapseGroup },
+					...labels?.externalLink === void 0 ? {} : { externalLink: labels.externalLink }
 				})
 			}), children]
 		})

package/dist/react/markdown-components.d.ts

@@ -1,4 +1,5 @@
 import { CalloutProps } from "./callout.js";
+import { DocsLabels } from "./shell-labels.js";
 import { YouTubeProps } from "./youtube.js";
 import { ComponentProps, ComponentType, JSX, ReactNode } from "react";
 //#region src/react/markdown-components.d.ts
@@ -53,6 +54,20 @@ interface DocsImageProps {
   className?: string | undefined;
   sizes?: string | undefined;
   loading?: 'eager' | 'lazy' | undefined;
+  /**
+   * Passed through to the image. Defaults to `'async'` on the plain `<img>`.
+   *
+   * ⚠️ DECLARED BECAUSE THE COMMENT BELOW PROMISED IT AND THE CODE DROPPED IT.
+   * `createImage` spreads the tree's own attributes into whichever component it
+   * was given, with a comment saying `decoding` and `fetchPriority` survive into
+   * the optimising branch — and `wrapNextImage` destructures a fixed list, so
+   * they did not. A closed props interface is the right shape for this seam, so
+   * the two the comment named are members of it now rather than a promise it
+   * could not keep.
+   */
+  decoding?: 'async' | 'auto' | 'sync' | undefined;
+  /** Passed through to the image. `'high'` on a hero image is the usual reason. */
+  fetchPriority?: 'high' | 'low' | 'auto' | undefined;
 }
 /** A `next/image`-compatible component. */
 type DocsImageComponent = ComponentType<DocsImageProps>;
@@ -61,7 +76,20 @@ interface MarkdownComponentsOptions {
   Link?: DocsLinkComponent | undefined;
   /** Optimising image component, e.g. `next/image`. Falls back to `<img>`. */
   Image?: DocsImageComponent | undefined;
+  /**
+   * Overrides for the strings this map renders itself.
+   *
+   * Five callout headings, the external-link suffix, a wide table's region
+   * name and the YouTube facade's three — every one of them hardcoded English
+   * until this existed, on a shell whose `labels` prop claimed to be the whole
+   * of a site's translatable chrome.
+   *
+   * All server-rendered, so overriding them costs no client bytes.
+   */
+  labels?: MarkdownLabels | undefined;
 }
+/** The subset of `DocsLabels` this map is responsible for. */
+type MarkdownLabels = Pick<DocsLabels, 'externalLink' | 'table' | 'calloutNote' | 'calloutTip' | 'calloutImportant' | 'calloutWarning' | 'calloutCaution' | 'youtubeTitle' | 'youtubePlay' | 'youtubeHide'>;
 /**
  * Build the default component map, optionally injecting host-specific link and
  * image components.
@@ -81,4 +109,4 @@ declare function createMarkdownComponents(options?: MarkdownComponentsOptions):
 /** The map used when a caller supplies none. Plain `<a>` and `<img>`. */
 declare const defaultMarkdownComponents: MarkdownComponents;
 //#endregion
-export { DocsImageComponent, DocsImageProps, DocsLinkComponent, DocsLinkProps, MarkdownComponents, MarkdownComponentsOptions, createMarkdownComponents, defaultMarkdownComponents };
+export { DocsImageComponent, DocsImageProps, DocsLinkComponent, DocsLinkProps, MarkdownComponents, MarkdownComponentsOptions, MarkdownLabels, createMarkdownComponents, defaultMarkdownComponents };

package/dist/react/markdown-components.js

@@ -1,24 +1,14 @@
+import { isSafeHref, opensInNewTab } from "../safe-href.js";
 import { Callout } from "./callout.js";
 import { YouTube } from "./youtube.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/markdown-components.tsx
-/** Schemes we send to a new tab. `mailto:`/`tel:` are left to the OS. */
-const HTTP_SCHEME = /^https?:\/\//i;
-/** Any URL with a scheme, or protocol-relative. */
+/** Default, and the only string here a reader sees without a screen reader. */
+const DEFAULT_EXTERNAL_LINK = "(opens in a new tab)";
+/** Default name for a wide table's scroll region. */
+const DEFAULT_TABLE = "Table";
+/** Any URL with a scheme, or protocol-relative. Decides router vs plain `<a>`. */
 const ABSOLUTE_URL = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
-/**
-* The schemes a markdown link may carry.
-*
-* GitHub's own allowlist, which is the bar to match: documentation links to
-* `sms:`, `ftp:` and `irc:` are ordinary, and an allowlist of three silently
-* deleted them. The point of the check is to stop `javascript:`, `data:` and
-* `vbscript:` reaching an `href`, not to have an opinion about protocols.
-*
-* A scheme not listed here — `vscode:`, `obsidian:`, `slack:` — is dropped
-* rather than rendered. That is deliberate: an allowlist that grows on request
-* is safe, one that guesses is not. {@link warnDroppedHref} makes it visible.
-*/
-const SAFE_SCHEME = /^(https?|mailto|tel|sms|ftp|ftps|irc|ircs|xmpp|news|nntp|feed|git|matrix):/i;
 /** Hrefs already reported, so a re-render does not repeat the warning. */
 const warnedHrefs = /* @__PURE__ */ new Set();
 /**
@@ -32,35 +22,7 @@ const warnedHrefs = /* @__PURE__ */ new Set();
 function warnDroppedHref(href) {
 	if (process.env.NODE_ENV === "production" || warnedHrefs.has(href)) return;
 	warnedHrefs.add(href);
-	console.warn(`@waveso/docs: dropped a link to '${href}' — its URL scheme is not in the allowlist, so the text was kept and the destination removed. Use http, https, mailto, tel, sms, ftp, irc, xmpp or matrix, or render the link yourself with a custom \`a\` component.`);
-}
-/**
-* A copy of `href` as a browser will parse it.
-*
-* ASCII control characters and spaces are stripped before parsing, so
-* ` javascript:` and `java<TAB>script:` both navigate where the raw string
-* matches no scheme at all — which is how a scheme check gets walked around.
-*/
-function normaliseUrl(href) {
-	return [...href].filter((char) => (char.codePointAt(0) ?? 0) > 32).join("");
-}
-/**
-* Would this href navigate somewhere we are willing to send a reader?
-*
-* Nothing upstream filters it: `remarkDocLinks` skips every href with a scheme
-* (`isRelativeLink` is false for it), so `assertLinks` never sees one either,
-* and `remarkRehype` runs with `allowDangerousHtml` off but passes a link's own
-* url through untouched. Verified against React 19: it neutralises
-* `javascript:` in every obfuscated form, silently — but it lets `vbscript:`
-* and `data:text/html;base64,…` reach the DOM verbatim. So the allowlist is
-* ours to keep.
-*
-* Tested against {@link normaliseUrl}, not the raw string.
-*/
-function isSafeHref(href) {
-	const normalised = normaliseUrl(href);
-	if (!ABSOLUTE_URL.test(normalised)) return true;
-	return normalised.startsWith("//") || SAFE_SCHEME.test(normalised);
+	console.warn(`@waveso/docs: dropped a link to '${href}' — its scheme is not in the allowlist. Use http(s), mailto, tel or another documented scheme.`);
 }
 function joinClassNames(...values) {
 	const joined = values.filter(Boolean).join(" ");
@@ -73,7 +35,7 @@ function toDimension(value) {
 		return Number.isFinite(parsed) ? parsed : void 0;
 	}
 }
-function createAnchor(Link) {
+function createAnchor(Link, externalLink) {
 	return function MarkdownAnchor({ href, children, ...rest }) {
 		if (href === void 0) return /* @__PURE__ */ jsx("a", {
 			...rest,
@@ -83,14 +45,14 @@ function createAnchor(Link) {
 			warnDroppedHref(href);
 			return /* @__PURE__ */ jsx("span", { children });
 		}
-		if (HTTP_SCHEME.test(href) || href.startsWith("//")) return /* @__PURE__ */ jsxs("a", {
+		if (opensInNewTab(href)) return /* @__PURE__ */ jsxs("a", {
 			...rest,
 			href,
 			target: "_blank",
 			rel: "noopener noreferrer",
-			children: [children, /* @__PURE__ */ jsx("span", {
+			children: [children, /* @__PURE__ */ jsxs("span", {
 				className: "wave-docs-sr-only",
-				children: " (opens in a new tab)"
+				children: [" ", externalLink]
 			})]
 		});
 		if (href.startsWith("#") || ABSOLUTE_URL.test(href) || Link === void 0) return /* @__PURE__ */ jsx("a", {
@@ -106,7 +68,7 @@ function createAnchor(Link) {
 	};
 }
 function createImage(Image) {
-	return function MarkdownImage({ src, alt, width, height, title, className, sizes, loading, ...rest }) {
+	return function MarkdownImage({ src, alt, width, height, title, className, sizes, loading, decoding, fetchPriority, ...rest }) {
 		const resolvedWidth = toDimension(width);
 		const resolvedHeight = toDimension(height);
 		const resolvedLoading = loading ?? "lazy";
@@ -120,10 +82,11 @@ function createImage(Image) {
 			title,
 			className: resolvedClassName,
 			sizes,
-			loading: resolvedLoading
+			loading: resolvedLoading,
+			decoding: decoding ?? "async",
+			fetchPriority
 		});
 		return /* @__PURE__ */ jsx("img", {
-			decoding: "async",
 			...rest,
 			src,
 			alt: alt ?? "",
@@ -132,7 +95,9 @@ function createImage(Image) {
 			title,
 			className: resolvedClassName,
 			sizes,
-			loading: resolvedLoading
+			loading: resolvedLoading,
+			decoding: decoding ?? "async",
+			fetchPriority
 		});
 	};
 }
@@ -146,16 +111,18 @@ function createImage(Image) {
 * `<section>` is a `region` landmark, so the tab stop announces itself instead
 * of being a mystery stop in the tab order.
 */
-function MarkdownTable({ className, ...rest }) {
-	return /* @__PURE__ */ jsx("section", {
-		className: "wave-docs-table-scroll",
-		"aria-label": "Table",
-		tabIndex: 0,
-		children: /* @__PURE__ */ jsx("table", {
-			...rest,
-			className: joinClassNames("wave-docs-table", className)
-		})
-	});
+function createTable(label) {
+	return function MarkdownTable({ className, ...rest }) {
+		return /* @__PURE__ */ jsx("section", {
+			className: "wave-docs-table-scroll",
+			"aria-label": label,
+			tabIndex: 0,
+			children: /* @__PURE__ */ jsx("table", {
+				...rest,
+				className: joinClassNames("wave-docs-table", className)
+			})
+		});
+	};
 }
 /**
 * Build the default component map, optionally injecting host-specific link and
@@ -173,12 +140,47 @@ function MarkdownTable({ className, ...rest }) {
 * ```
 */
 function createMarkdownComponents(options = {}) {
+	const labels = options.labels ?? {};
+	const calloutTitles = calloutTitleMap(labels);
 	return {
-		a: createAnchor(options.Link),
+		a: createAnchor(options.Link, labels.externalLink ?? DEFAULT_EXTERNAL_LINK),
 		img: createImage(options.Image),
-		table: MarkdownTable,
-		callout: Callout,
-		youtube: YouTube
+		table: createTable(labels.table ?? DEFAULT_TABLE),
+		callout: (props) => /* @__PURE__ */ jsx(Callout, {
+			...props,
+			...calloutTitles === void 0 ? {} : { labels: calloutTitles }
+		}),
+		youtube: (props) => /* @__PURE__ */ jsx(YouTube, { ...youtubeDefaults(labels, props) })
+	};
+}
+/** The five headings as `Callout` wants them, or `undefined` if none are set. */
+function calloutTitleMap(labels) {
+	const titles = {};
+	let found = false;
+	for (const [type, key] of Object.entries(CALLOUT_LABEL_KEYS)) {
+		const value = labels[key];
+		if (value !== void 0) {
+			titles[type] = value;
+			found = true;
+		}
+	}
+	return found ? titles : void 0;
+}
+/** Which `DocsLabels` key names a given callout type's heading. */
+const CALLOUT_LABEL_KEYS = {
+	note: "calloutNote",
+	tip: "calloutTip",
+	important: "calloutImportant",
+	warning: "calloutWarning",
+	caution: "calloutCaution"
+};
+/** `props`, with the site's YouTube strings filled in. */
+function youtubeDefaults(labels, props) {
+	return {
+		...props,
+		...props.title === void 0 && labels.youtubeTitle !== void 0 ? { title: labels.youtubeTitle } : {},
+		...labels.youtubePlay === void 0 ? {} : { playLabel: labels.youtubePlay },
+		...labels.youtubeHide === void 0 ? {} : { hideLabel: labels.youtubeHide }
 	};
 }
 /** The map used when a caller supplies none. Plain `<a>` and `<img>`. */

package/dist/react/nav.d.ts

@@ -22,7 +22,11 @@ interface DocsNavProps {
   label?: string | undefined;
   /** Accessible name for the close button. */
   closeLabel?: string | undefined;
+  /** 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 }: DocsNavProps): ReactNode;
+declare function DocsNav({ nav, pathname, Link, label, closeLabel, expandGroup, collapseGroup, externalLink }: DocsNavProps): ReactNode;
 //#endregion
 export { DOCS_NAV_ID, DocsNav, DocsNavProps };

package/dist/react/nav.js

@@ -12,7 +12,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 * the button does nothing on the first tap.
 */
 const DOCS_NAV_ID = "wave-docs-nav";
-function DocsNav({ nav, pathname, Link, label = "Documentation", closeLabel = "Close navigation" }) {
+function DocsNav({ nav, pathname, Link, label = "Documentation", closeLabel = "Close navigation", expandGroup, collapseGroup, externalLink }) {
 	const ref = useRef(null);
 	useEffect(() => {
 		ref.current?.close?.();
@@ -62,7 +62,10 @@ function DocsNav({ nav, pathname, Link, label = "Documentation", closeLabel = "C
 			nav,
 			pathname,
 			label,
-			Link
+			Link,
+			...expandGroup === void 0 ? {} : { expandGroup },
+			...collapseGroup === void 0 ? {} : { collapseGroup },
+			...externalLink === void 0 ? {} : { externalLink }
 		})]
 	});
 }

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

@@ -5,7 +5,11 @@ interface DocsNextNavProps {
   nav: DocNavNode[];
   label?: string | undefined;
   closeLabel?: string | undefined;
+  /** Passed through to the tree. See `DocsSidebarProps.expandGroup`. */
+  expandGroup?: string | undefined;
+  collapseGroup?: string | undefined;
+  externalLink?: string | undefined;
 }
-declare function DocsNextNav({ nav, label, closeLabel }: DocsNextNavProps): ReactNode;
+declare function DocsNextNav({ nav, label, closeLabel, expandGroup, collapseGroup, externalLink }: DocsNextNavProps): ReactNode;
 //#endregion
 export { DocsNextNav, DocsNextNavProps };

package/dist/react/next-nav.js

@@ -19,13 +19,16 @@ 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 }) {
+function DocsNextNav({ nav, label, closeLabel, expandGroup, collapseGroup, externalLink }) {
 	return /* @__PURE__ */ jsx(DocsNav, {
 		nav,
 		pathname: usePathname(),
 		Link,
 		...label === void 0 ? {} : { label },
-		...closeLabel === void 0 ? {} : { closeLabel }
+		...closeLabel === void 0 ? {} : { closeLabel },
+		...expandGroup === void 0 ? {} : { expandGroup },
+		...collapseGroup === void 0 ? {} : { collapseGroup },
+		...externalLink === void 0 ? {} : { externalLink }
 	});
 }
 //#endregion