@yaakdoc/react 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,551 @@
+import { C as useRequest, S as usePage, T as useThemeOptions, _ as useRunInYaak, a as SiteLinks, b as useDocument, c as Html, d as MethodBadge, f as RequestUrl, g as usePageActions, h as useComponents, i as RunInYaak, l as KeyValueTable, m as overridable, n as Footer, o as brandingCss, p as ComponentsProvider, r as Logo, s as AuthInfo, t as BrandingStyles, u as Markdown, v as toAbsoluteUrl, w as useSite, x as useFolder, y as YaakdocProvider } from "./site-DyK7ZcqQ.js";
+import { m as createIsland, o as EnvironmentSwitcher } from "./run-in-yaak-CMMcDS7S.js";
+import { a as CopyButton, c as TabList, d as tabPanelProps, l as tabElementIds, n as OpenInLink, p as visibleTabPanelSelector, t as LLM_PROVIDERS, u as tabGroupIds } from "./llm-Ddn5hWnS.js";
+import { findFolderNode, formFieldValue, grpcMethodPath, methodLabel } from "@yaakdoc/core";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/primitives/environment.tsx
+/**
+* Renders environment-dependent content once per environment variant. With several variants, each
+* is wrapped in `<div data-yd-env="<id>">` (only the default is visible until the reader switches).
+*/
+function EnvironmentVariants({ variants, children }) {
+	if (variants.length <= 1) return /* @__PURE__ */ jsx(Fragment, { children: variants[0] ? children(variants[0], 0) : null });
+	return /* @__PURE__ */ jsx(Fragment, { children: variants.map((variant, index) => /* @__PURE__ */ jsx("div", {
+		"data-yd-env": variant.environmentId ?? "",
+		hidden: index !== 0,
+		children: children(variant, index)
+	}, variant.environmentId ?? "none")) });
+}
+/** Environment switcher for the current document (renders nothing without alternatives). */
+const EnvironmentSelect = overridable("EnvironmentSelect", function EnvironmentSelect({ className }) {
+	const document = useDocument();
+	if (document.environments.length < 2) return null;
+	return /* @__PURE__ */ jsx(EnvironmentSwitcher, {
+		environments: document.environments,
+		defaultId: document.environments[0].id,
+		...className ? { className } : {}
+	});
+});
+//#endregion
+//#region src/primitives/code.tsx
+const CodeBlock = overridable("CodeBlock", function CodeBlock({ html, id, language, title, copy = true, className }) {
+	return /* @__PURE__ */ jsxs("figure", {
+		"data-yd": "code-block",
+		"data-language": language,
+		className,
+		children: [title || copy ? /* @__PURE__ */ jsxs("figcaption", {
+			"data-yd": "code-block-header",
+			children: [title ? /* @__PURE__ */ jsx("span", {
+				"data-yd": "code-block-title",
+				children: title
+			}) : null, copy ? /* @__PURE__ */ jsx(CopyButton, {
+				target: `#${id} pre`,
+				label: "Copy"
+			}) : null]
+		}) : null, /* @__PURE__ */ jsx(Html, {
+			html,
+			id,
+			"data-yd": "code"
+		})]
+	});
+});
+/** Tabbed code examples. Panels are static HTML; only the tab list hydrates. */
+const CodeExamples = overridable("CodeExamples", function CodeExamples({ request, className, title = "Example request" }) {
+	const examples = request.examples;
+	if (examples.length === 0) return null;
+	const group = tabGroupIds.examples(request.anchor);
+	return /* @__PURE__ */ jsxs("section", {
+		"data-yd": "code-examples",
+		"data-yd-tab-group": group,
+		className,
+		"aria-label": title,
+		children: [/* @__PURE__ */ jsxs("div", {
+			"data-yd": "code-examples-header",
+			children: [/* @__PURE__ */ jsx(TabList, {
+				group,
+				tabs: examples.map((example) => ({
+					id: example.id,
+					label: example.label
+				}))
+			}), /* @__PURE__ */ jsx(CopyButton, {
+				target: visibleTabPanelSelector(group),
+				label: "Copy"
+			})]
+		}), /* @__PURE__ */ jsx(EnvironmentVariants, {
+			variants: request.variants,
+			children: (variant, variantIndex) => variant.examples.map((example, index) => /* @__PURE__ */ jsx("div", {
+				...tabPanelProps(group, example.id, {
+					selected: index === 0,
+					variant: variantIndex
+				}),
+				"data-language": example.language,
+				children: /* @__PURE__ */ jsx(Html, {
+					html: example.html,
+					"data-yd": "code"
+				})
+			}, example.id))
+		})]
+	});
+});
+/**
+* Example responses (from ```response / ```response:<status> blocks in the description), tabbed by
+* status. Tabs carry `data-status-class` (`2xx`, `4xx`, ...) for styling.
+*/
+const ResponseExamples = overridable("ResponseExamples", function ResponseExamples({ request, className, title = "Example response" }) {
+	if (request.responses.length === 0) return null;
+	const group = tabGroupIds.responses(request.anchor);
+	return /* @__PURE__ */ jsxs("section", {
+		"data-yd": "response-examples",
+		"data-yd-tab-group": group,
+		className,
+		"aria-label": title,
+		children: [/* @__PURE__ */ jsxs("div", {
+			"data-yd": "response-examples-header",
+			children: [/* @__PURE__ */ jsx(TabList, {
+				group,
+				sync: false,
+				label: title,
+				tabs: request.responses.map((response, index) => ({
+					id: String(index),
+					label: response.label
+				}))
+			}), /* @__PURE__ */ jsx(CopyButton, {
+				target: visibleTabPanelSelector(group),
+				label: "Copy"
+			})]
+		}), request.responses.map((response, index) => /* @__PURE__ */ jsx("div", {
+			...tabPanelProps(group, String(index), { selected: index === 0 }),
+			"data-status": response.status ?? void 0,
+			"data-status-class": statusClass(response.status),
+			children: response.empty ? /* @__PURE__ */ jsx("p", {
+				"data-yd": "empty-response",
+				children: "No response body"
+			}) : /* @__PURE__ */ jsx(Html, {
+				html: response.html,
+				"data-yd": "code"
+			})
+		}, String(index)))]
+	});
+});
+/** `2xx`, `4xx`, ... or `undefined` for responses without a status. */
+const statusClass = (status) => status ? `${String(status)[0]}xx` : void 0;
+//#endregion
+//#region src/primitives/heading.tsx
+/** Clamps any number to a valid heading level (1–6). */
+const clampHeadingLevel = (level) => Math.min(Math.max(level, 1), 6);
+/** `<h1>`–`<h6>` chosen by `level` (clamped), for headings whose depth depends on nesting. */
+function Heading({ level, ...props }) {
+	const Tag = `h${clampHeadingLevel(level)}`;
+	return /* @__PURE__ */ jsx(Tag, { ...props });
+}
+//#endregion
+//#region src/primitives/llm.tsx
+/**
+* "Copy page" actions: copy as Markdown, view as Markdown, open in ChatGPT/Claude. Uses a native
+* `<details>` menu, so it works without JavaScript (except copying).
+*/
+/** Label of a copy action for an item at heading `level`: the page itself (1) or a section. */
+const copyActionLabel = (level) => level <= 1 ? "Copy page" : "Copy section";
+const PageActions = overridable("PageActions", function PageActions({ markdownUrl, label = "Copy page", className }) {
+	const actions = usePageActions(markdownUrl);
+	if (!actions) return null;
+	const absolute = actions.absoluteUrl ?? actions.markdownUrl;
+	return /* @__PURE__ */ jsxs("div", {
+		"data-yd": "page-actions",
+		className,
+		children: [/* @__PURE__ */ jsx(CopyButton, {
+			url: actions.markdownUrl,
+			label,
+			copiedLabel: "Copied!"
+		}), /* @__PURE__ */ jsxs("details", {
+			"data-yd": "page-actions-menu",
+			children: [/* @__PURE__ */ jsx("summary", {
+				"aria-label": "More page actions",
+				children: "⋯"
+			}), /* @__PURE__ */ jsxs("ul", { children: [/* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", {
+				href: actions.markdownUrl,
+				target: "_blank",
+				rel: "noopener",
+				"data-yd": "view-markdown",
+				children: "View as Markdown"
+			}) }), actions.openIn.map((provider) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(OpenInLink, {
+				provider,
+				markdownUrl: absolute,
+				label: `Open in ${LLM_PROVIDERS[provider].label}`
+			}) }, provider))] })]
+		})]
+	});
+});
+//#endregion
+//#region src/primitives/request.tsx
+const RequestBody = overridable("RequestBody", function RequestBody({ request, className }) {
+	if (request.kind !== "http") {
+		if (!request.bodyHtml) return null;
+		return /* @__PURE__ */ jsx(Html, {
+			html: request.bodyHtml,
+			"data-yd": "body",
+			"data-kind": "message",
+			className
+		});
+	}
+	const { body } = request;
+	switch (body.type) {
+		case "none": return null;
+		case "form-urlencoded":
+		case "multipart": return /* @__PURE__ */ jsx("div", {
+			"data-yd": "body",
+			"data-kind": body.type,
+			className,
+			children: /* @__PURE__ */ jsx(KeyValueTable, {
+				items: body.fields.map((field) => ({
+					...field,
+					value: formFieldValue(field)
+				})),
+				columns: ["Field", "Value"]
+			})
+		});
+		case "binary": return /* @__PURE__ */ jsxs("p", {
+			"data-yd": "body",
+			"data-kind": "binary",
+			className,
+			children: ["Binary file", body.filePath ? /* @__PURE__ */ jsxs(Fragment, { children: [
+				" ",
+				"(",
+				/* @__PURE__ */ jsx("code", { children: body.filePath }),
+				")"
+			] }) : null]
+		});
+		default: return request.bodyHtml ? /* @__PURE__ */ jsxs("div", {
+			"data-yd": "body",
+			"data-kind": body.type,
+			className,
+			children: [
+				request.variablesHtml ? /* @__PURE__ */ jsx("span", {
+					"data-yd": "body-label",
+					children: "Query"
+				}) : null,
+				/* @__PURE__ */ jsx(Html, { html: request.bodyHtml }),
+				request.variablesHtml ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
+					"data-yd": "body-label",
+					children: "Variables"
+				}), /* @__PURE__ */ jsx(Html, {
+					html: request.variablesHtml ?? "",
+					"data-yd": "body-variables"
+				})] }) : null
+			]
+		}) : null;
+	}
+});
+const bodyContentType = (request) => request.kind === "http" && request.body.type !== "none" ? request.body.contentType : null;
+/**
+* Complete documentation section for a request: title, method, URL, description, auth, parameters,
+* headers, body and code examples. Each sub-part is overridable on its own.
+*/
+const RequestDoc = overridable("RequestDoc", function RequestDoc({ request, level = 2, className, examples = true }) {
+	const sub = clampHeadingLevel(level + 1);
+	const headers = request.kind === "grpc" ? request.metadata : request.headers;
+	const contentType = bodyContentType(request);
+	return /* @__PURE__ */ jsxs("section", {
+		id: request.anchor,
+		"data-yd": "request",
+		"data-yd-section": true,
+		"data-kind": request.kind,
+		className,
+		children: [
+			/* @__PURE__ */ jsxs("header", {
+				"data-yd": "request-header",
+				children: [/* @__PURE__ */ jsx(Heading, {
+					level,
+					children: /* @__PURE__ */ jsx("a", {
+						href: `#${request.anchor}`,
+						"data-yd": "anchor",
+						children: request.name
+					})
+				}), /* @__PURE__ */ jsx(PageActions, {
+					markdownUrl: request.markdownUrl,
+					label: copyActionLabel(level)
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				"data-yd": "request-line",
+				children: [/* @__PURE__ */ jsx(MethodBadge, { request }), /* @__PURE__ */ jsx(EnvironmentVariants, {
+					variants: request.variants,
+					children: (variant) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(RequestUrl, { url: variant.url }), /* @__PURE__ */ jsx(CopyButton, {
+						text: variant.resolvedUrl,
+						label: "Copy URL"
+					})] })
+				})]
+			}),
+			request.kind === "grpc" && (request.service || request.method) ? /* @__PURE__ */ jsx("p", {
+				"data-yd": "grpc-method",
+				children: /* @__PURE__ */ jsx("code", { children: grpcMethodPath(request) })
+			}) : null,
+			/* @__PURE__ */ jsx(Markdown, { html: request.descriptionHtml }),
+			/* @__PURE__ */ jsx(Heading, {
+				level: sub,
+				children: "Authentication"
+			}),
+			/* @__PURE__ */ jsx(AuthInfo, { auth: request.auth }),
+			request.kind !== "grpc" && request.pathParameters.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Heading, {
+				level: sub,
+				children: "Path parameters"
+			}), /* @__PURE__ */ jsx(KeyValueTable, { items: request.pathParameters })] }) : null,
+			request.kind !== "grpc" && request.queryParameters.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Heading, {
+				level: sub,
+				children: "Query parameters"
+			}), /* @__PURE__ */ jsx(KeyValueTable, { items: request.queryParameters })] }) : null,
+			headers.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Heading, {
+				level: sub,
+				children: request.kind === "grpc" ? "Metadata" : "Headers"
+			}), /* @__PURE__ */ jsx(KeyValueTable, { items: headers })] }) : null,
+			request.bodyHtml || request.kind === "http" && request.body.type !== "none" ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Heading, {
+				level: sub,
+				children: [request.kind === "http" ? "Body" : "Message", contentType ? /* @__PURE__ */ jsxs(Fragment, { children: [" ", /* @__PURE__ */ jsx("code", {
+					"data-yd": "content-type",
+					children: contentType
+				})] }) : null]
+			}), /* @__PURE__ */ jsx(RequestBody, { request })] }) : null,
+			examples ? /* @__PURE__ */ jsx(CodeExamples, { request }) : null,
+			examples ? /* @__PURE__ */ jsx(ResponseExamples, { request }) : null
+		]
+	});
+});
+//#endregion
+//#region src/primitives/content.tsx
+/** A folder section: title, description, inherited auth, then (optionally) its contents. */
+const FolderDoc = overridable("FolderDoc", function FolderDoc({ id, level = 2, nested = true, className }) {
+	const document = useDocument();
+	const folder = document.folders[id];
+	if (!folder) return null;
+	const node = findFolderNode(document.tree, id);
+	return /* @__PURE__ */ jsxs("section", {
+		id: folder.anchor,
+		"data-yd": "folder",
+		"data-yd-section": true,
+		className,
+		children: [
+			/* @__PURE__ */ jsxs("header", {
+				"data-yd": "folder-header",
+				children: [/* @__PURE__ */ jsx(Heading, {
+					level,
+					children: /* @__PURE__ */ jsx("a", {
+						href: `#${folder.anchor}`,
+						"data-yd": "anchor",
+						children: folder.name
+					})
+				}), /* @__PURE__ */ jsx(PageActions, {
+					markdownUrl: folder.markdownUrl,
+					label: copyActionLabel(level)
+				})]
+			}),
+			/* @__PURE__ */ jsx(Markdown, { html: folder.descriptionHtml }),
+			nested && node ? /* @__PURE__ */ jsx(TreeContent, {
+				nodes: node.children,
+				level: level + 1
+			}) : null
+		]
+	});
+});
+/** Renders a list of tree nodes as documentation sections, recursively. */
+const TreeContent = overridable("TreeContent", function TreeContent({ nodes, level = 2 }) {
+	const document = useDocument();
+	return /* @__PURE__ */ jsx(Fragment, { children: nodes.map((node) => node.type === "folder" ? /* @__PURE__ */ jsx(FolderDoc, {
+		id: node.id,
+		level
+	}, node.id) : document.requests[node.id] ? /* @__PURE__ */ jsx(RequestDoc, {
+		request: document.requests[node.id],
+		level: clampHeadingLevel(level)
+	}, node.id) : null) });
+});
+/** Overview of the workspace: description, authentication and variables. */
+const Overview = overridable("Overview", function Overview({ className, level = 1 }) {
+	const document = useDocument();
+	const site = useSite();
+	const page = usePage();
+	return /* @__PURE__ */ jsxs("section", {
+		id: "overview",
+		"data-yd": "overview",
+		className,
+		children: [
+			/* @__PURE__ */ jsxs("header", {
+				"data-yd": "overview-header",
+				children: [
+					/* @__PURE__ */ jsx(Heading, {
+						level,
+						children: site.title
+					}),
+					/* @__PURE__ */ jsx(RunInYaak, {}),
+					/* @__PURE__ */ jsx(PageActions, { markdownUrl: page.kind === "index" ? page.markdownUrl : null })
+				]
+			}),
+			/* @__PURE__ */ jsx(Markdown, { html: document.workspace.descriptionHtml }),
+			document.workspace.auth ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Heading, {
+				level: level + 1,
+				id: "authentication-overview",
+				children: "Authentication"
+			}), /* @__PURE__ */ jsx(AuthInfo, { auth: document.workspace.auth })] }) : null,
+			/* @__PURE__ */ jsx(Variables, { level: level + 1 })
+		]
+	});
+});
+/** Environment variables table (secrets redacted). */
+const Variables = overridable("Variables", function Variables({ level = 2, className }) {
+	const document = useDocument();
+	if (!useSite().showVariables || document.variables.length === 0) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		"data-yd": "variables",
+		className,
+		children: [/* @__PURE__ */ jsxs(Heading, {
+			level,
+			id: "variables",
+			children: ["Variables", document.environments.length > 1 ? /* @__PURE__ */ jsxs(Fragment, { children: [" ", /* @__PURE__ */ jsx(EnvironmentSelect, {})] }) : document.environment ? /* @__PURE__ */ jsxs(Fragment, { children: [" ", /* @__PURE__ */ jsx("span", {
+				"data-yd": "environment",
+				style: document.environment.color ? { color: document.environment.color } : void 0,
+				children: document.environment.name
+			})] }) : null]
+		}), /* @__PURE__ */ jsx(EnvironmentVariants, {
+			variants: document.variableSets,
+			children: (set) => /* @__PURE__ */ jsx(KeyValueTable, { items: set.variables })
+		})]
+	});
+});
+/**
+* The main content for the current page: everything (single-page mode), a folder, a request, or a
+* not-found message. Themes can use this or compose the pieces themselves.
+*/
+const Content = overridable("Content", function Content({ className }) {
+	const document = useDocument();
+	const site = useSite();
+	const page = usePage();
+	let content;
+	if (page.kind === "request" && page.id && document.requests[page.id]) content = /* @__PURE__ */ jsx(RequestDoc, {
+		request: document.requests[page.id],
+		level: 1
+	});
+	else if (page.kind === "folder" && page.id) {
+		content = /* @__PURE__ */ jsx(FolderDoc, {
+			id: page.id,
+			level: 1,
+			nested: false
+		});
+		const node = findFolderNode(document.tree, page.id);
+		content = /* @__PURE__ */ jsxs(Fragment, { children: [content, node ? /* @__PURE__ */ jsx(ChildLinks, { nodes: node.children }) : null] });
+	} else if (page.kind === "not-found") content = /* @__PURE__ */ jsx(NotFound, {});
+	else content = /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Overview, {}), site.pages === "single" ? /* @__PURE__ */ jsx(TreeContent, {
+		nodes: document.tree,
+		level: 2
+	}) : /* @__PURE__ */ jsx(ChildLinks, { nodes: document.tree })] });
+	return /* @__PURE__ */ jsx("main", {
+		id: "content",
+		"data-yd": "content",
+		"data-page": page.kind,
+		className,
+		children: content
+	});
+});
+/** Content of the 404 page. */
+const NotFound = overridable("NotFound", function NotFound({ className }) {
+	const site = useSite();
+	return /* @__PURE__ */ jsxs("section", {
+		"data-yd": "not-found",
+		className,
+		children: [/* @__PURE__ */ jsx("h1", { children: "Page not found" }), /* @__PURE__ */ jsx("p", { children: /* @__PURE__ */ jsx("a", {
+			href: site.base,
+			children: "Back to the documentation"
+		}) })]
+	});
+});
+/** List of links to child folders/requests (per-request pages mode). */
+const ChildLinks = overridable("ChildLinks", function ChildLinks({ nodes, className }) {
+	const document = useDocument();
+	return /* @__PURE__ */ jsx("ul", {
+		"data-yd": "child-links",
+		className,
+		children: nodes.map((node) => {
+			const item = node.type === "folder" ? document.folders[node.id] : document.requests[node.id];
+			if (!item) return null;
+			return /* @__PURE__ */ jsxs("li", {
+				"data-type": node.type,
+				children: [/* @__PURE__ */ jsx("a", {
+					href: item.href,
+					children: item.name
+				}), item.summary ? /* @__PURE__ */ jsx("p", { children: item.summary }) : null]
+			}, node.id);
+		})
+	});
+});
+//#endregion
+//#region src/primitives/nav.tsx
+/**
+* Navigation tree. Folders use native `<details>` (collapsible without JavaScript). Items carry
+* `data-yd-nav-item` / `data-yd-nav-folder` for the `NavFilter` island, and the current page link
+* gets `aria-current="page"`.
+*/
+const NavTree = overridable("NavTree", function NavTree({ nodes, className, openDepth = 1 }) {
+	const document = useDocument();
+	const page = usePage();
+	const activeAncestors = new Set(page.id ? (document.requests[page.id]?.breadcrumbs ?? document.folders[page.id]?.breadcrumbs ?? []).map((b) => b.id) : []);
+	if (page.id) activeAncestors.add(page.id);
+	const renderNodes = (items, depth) => /* @__PURE__ */ jsx("ul", {
+		"data-yd": "nav-list",
+		"data-depth": depth,
+		children: items.map((node) => {
+			if (node.type === "request") {
+				const request = document.requests[node.id];
+				if (!request) return null;
+				return /* @__PURE__ */ jsx("li", {
+					"data-yd-nav-item": true,
+					"data-yd-nav-label": request.name,
+					children: /* @__PURE__ */ jsxs("a", {
+						href: request.href,
+						"data-yd": "nav-link",
+						"aria-current": page.id === node.id ? "page" : void 0,
+						children: [/* @__PURE__ */ jsx(MethodBadge, { request }), /* @__PURE__ */ jsx("span", {
+							"data-yd": "nav-label",
+							children: request.name
+						})]
+					})
+				}, node.id);
+			}
+			const folder = document.folders[node.id];
+			if (!folder) return null;
+			return /* @__PURE__ */ jsx("li", {
+				"data-yd-nav-folder": true,
+				"data-yd-nav-label": folder.name,
+				children: /* @__PURE__ */ jsxs("details", {
+					open: depth < openDepth || activeAncestors.has(node.id) || void 0,
+					children: [/* @__PURE__ */ jsx("summary", {
+						"data-yd": "nav-folder",
+						children: /* @__PURE__ */ jsx("span", {
+							"data-yd": "nav-label",
+							children: folder.name
+						})
+					}), renderNodes(node.children, depth + 1)]
+				})
+			}, node.id);
+		})
+	});
+	return /* @__PURE__ */ jsx("nav", {
+		"data-yd": "nav",
+		"aria-label": "API reference",
+		className,
+		children: renderNodes(nodes ?? document.tree, 0)
+	});
+});
+/** Breadcrumb trail of the current request/folder. */
+const Breadcrumbs = overridable("Breadcrumbs", function Breadcrumbs({ id, className }) {
+	const document = useDocument();
+	const item = document.requests[id] ?? document.folders[id];
+	if (!item || item.breadcrumbs.length === 0) return null;
+	return /* @__PURE__ */ jsx("nav", {
+		"aria-label": "Breadcrumb",
+		"data-yd": "breadcrumbs",
+		className,
+		children: /* @__PURE__ */ jsx("ol", { children: item.breadcrumbs.map((crumb) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", {
+			href: document.folders[crumb.id]?.href,
+			children: crumb.name
+		}) }, crumb.id)) })
+	});
+});
+//#endregion
+export { AuthInfo, BrandingStyles, Breadcrumbs, ChildLinks, CodeBlock, CodeExamples, ComponentsProvider, Content, EnvironmentSelect, EnvironmentVariants, FolderDoc, Footer, Heading, Html, KeyValueTable, Logo, Markdown, MethodBadge, NavTree, NotFound, Overview, PageActions, RequestBody, RequestDoc, RequestUrl, ResponseExamples, RunInYaak, SiteLinks, TabList, TreeContent, Variables, YaakdocProvider, brandingCss, clampHeadingLevel, copyActionLabel, createIsland, methodLabel, overridable, statusClass, tabElementIds, tabGroupIds, tabPanelProps, toAbsoluteUrl, useComponents, useDocument, useFolder, usePage, usePageActions, useRequest, useRunInYaak, useSite, useThemeOptions, visibleTabPanelSelector };

package/dist/island-BWyuL4_6.d.ts

@@ -0,0 +1,29 @@
+import { ComponentType } from "react";
+//#region src/island.d.ts
+type IslandComponent<P extends object> = ComponentType<P> & {
+  /** Unique island name, used to find the component when hydrating. */
+  islandName: string;
+  /** The underlying component (rendered inside the island element). */
+  Component: ComponentType<P>;
+};
+declare module "react" {
+  namespace JSX {
+    interface IntrinsicElements {
+      "yd-island": React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> & {
+        "data-island"?: string;
+        "data-props"?: string;
+        "data-prefix"?: string;
+      };
+    }
+  }
+}
+/**
+ * Turns a component into an island: it is rendered to HTML on the server like any other component,
+ * and hydrated on the client (only this component, not the whole page).
+ *
+ * Islands are hydrated in isolation: their props must be JSON-serializable and they cannot use
+ * yaakdoc context hooks. Register islands on the client with `hydrateIslands()`.
+ */
+declare function createIsland<P extends object>(name: string, Component: ComponentType<P>): IslandComponent<P>;
+//#endregion
+export { createIsland as n, IslandComponent as t };