@umami/shiso 1.11.0 → 1.13.0

package/dist/chunks/App.js

@@ -1,18 +1,18 @@
-import { $ as POPUP_COLLISION_AVOIDANCE, $n as isHTMLElement, $t as itemPress, A as popupStoreSelectors, An as ARROW_UP, B as useSyncedFloatingRootContext, Bn as EMPTY_ARRAY, C as pressableTriggerOpenStateMapping, Cn as isTypeableCombobox, Ct as COMPOSITE_KEYS, D as useFocus, Dn as ARROW_DOWN, E as useHoverFloatingInteraction, En as getTarget, F as setPopupOpenState, Fn as useId$1, G as FloatingNode, Gn as ownerDocument, Gt as useValueAsRef, H as useDismiss, Hn as useMergedRefs, Ht as getIcon, I as useImplicitActiveTrigger, In as useTimeout, J as useFloatingParentNodeId, Jn as useIsoLayoutEffect, Jt as createChangeEventDetails, K as FloatingTree, Kn as useCompositeRootContext, Kt as useCompositeListItem, L as useOpenStateTransitions, Ln as Button, M as FOCUSABLE_POPUP_PROPS, Mn as webkit, N as PopupHandleAttachment, Nn as mac, O as usePopupHandleStore, On as ARROW_LEFT, P as attachPreventUnmountOnClose, Pn as useBaseUiId, Q as DROPDOWN_COLLISION_AVOIDANCE, Qn as getWindow, Qt as imperativeAction, R as usePopupInteractionProps, Rn as cn, Rt as Badge, S as popupTransitionStateMapping, Sn as getFloatingFocusElement, T as useHoverReferenceInteraction, Tn as contains, Tt as useCompositeItem, U as useClick, Un as useButton, Ut as useOpenChangeComplete, V as ReactStore, Vn as EMPTY_OBJECT, Vt as resolveIcon, W as FloatingFocusManager, Wn as dispatchClickWithModifiers, Wt as useAnimationsFinished, X as FloatingTreeStore, Xn as useRefWithInit, Xt as escapeKey, Y as useFloatingTree, Yn as useStableCallback, Yt as cancelOpen, Z as FloatingPortal, Zn as getParentNode, Zt as focusOut, _n as isIndexOutOfListBounds, _t as Collapsible, a as DialogTitle, an as triggerPress, b as getDisabledMountTransitionStyles, bn as isVirtualPointerEvent, c as useOpenInteractionType, cn as useDirection, cr as Route, d as useScrollLock, dn as getTabbableBeforeElement, dr as useLocation, en as listNavigation, er as isLastTraversableNode, et as enqueueFocus, f as DialogPortal$1, fn as isOutsideEvent, fr as useNavigate, g as DialogBackdrop, gn as isElementVisible, h as DialogClose, hn as getMinListIndex, ht as renderInlineMarkdown, i as DialogContent$1, in as triggerHover, ir as createLucideIcon, j as PopupTriggerMap, jn as jsdom, k as createInitialPopupStoreState, kn as ARROW_RIGHT, l as DialogTitle$1, ln as getNextTabbable, m as DialogPopup, mn as getMaxListIndex, n as ZoomableImage, nn as siblingOpen, nr as ChevronRight, nt as fastComponent, o as DialogTrigger, on as CompositeList, or as Link, p as InternalBackdrop, pn as findNonDisabledListIndex, q as useFloatingNodeId, qn as mergeProps$1, qt as useAnimationFrame, r as Dialog$1, rn as triggerFocus, rr as Check, rt as fastComponentRef, s as DialogTrigger$1, sn as addEventListener, sr as Navigate, t as docs_exports, tn as outsidePress, tr as X$1, tt as FocusGuard, u as DialogRoot, un as getTabbableAfterElement, ur as Routes, v as TooltipProvider, vn as isListIndexDisabled, vt as CollapsibleContent, w as safePolygon, wn as activeElement, wt as inertValue, x as useAnchorPositioning, xn as stopEvent, y as usePositioner, yn as isVirtualClick, yt as CollapsibleTrigger, z as useTriggerDataForwarding, zn as useRenderElement } from "./docs.js";
+import { $ as useFloatingNodeId, $n as useTimeout, A as safePolygon, An as findNonDisabledListIndex, At as CollapsibleContent, B as attachPreventUnmountOnClose, Bn as isTypeableCombobox, Cn as styles, Cr as Link, D as useAnchorPositioning, Dn as getTabbableAfterElement, Dr as Routes, Dt as renderInlineMarkdown, E as getDisabledMountTransitionStyles, En as getNextTabbable, F as createInitialPopupStoreState, Fn as isListIndexDisabled, Ft as COMPOSITE_KEYS, G as useTriggerDataForwarding, Gn as ARROW_LEFT, H as useImplicitActiveTrigger, Hn as contains, I as popupStoreSelectors, In as isVirtualClick, It as inertValue, J as useDismiss, Jn as jsdom, K as useSyncedFloatingRootContext, Kn as ARROW_RIGHT, L as PopupTriggerMap, Ln as isVirtualPointerEvent, Lt as useCompositeItem, M as useHoverFloatingInteraction, Mn as getMinListIndex, N as useFocus, Nn as isElementVisible, O as popupTransitionStateMapping, On as getTabbableBeforeElement, Or as useLocation, Ot as Expandable, P as usePopupHandleStore, Pn as isIndexOutOfListBounds, Pt as CodeGroup, Q as FloatingTree, Qn as useId$2, Qt as Badge$1, R as FOCUSABLE_POPUP_PROPS, Rn as stopEvent, St as usePanelContent, T as usePositioner, Tn as useDirection, Tr as Route, U as useOpenStateTransitions, Un as getTarget, V as setPopupOpenState, Vn as activeElement, W as usePopupInteractionProps, Wn as ARROW_DOWN, X as FloatingFocusManager, Xn as mac, Y as useClick, Yn as webkit, Z as FloatingNode, Zn as useBaseUiId, Zt as Badge, _n as triggerFocus, _r as isLastTraversableNode, a as DialogTitle, an as useValueAsRef, ar as useMergedRefs, at as POPUP_COLLISION_AVOIDANCE, bn as CompositeList, br as Check, c as useOpenInteractionType, cn as createChangeEventDetails, cr as ownerDocument, ct as fastComponent, d as useScrollLock, dn as focusOut, dr as useIsoLayoutEffect, er as Button, et as useFloatingParentNodeId, f as DialogPortal$1, fn as imperativeAction, fr as useStableCallback, g as DialogBackdrop, gn as siblingOpen, gr as isHTMLElement, gt as ResponseField, h as DialogClose, hn as outsidePress, hr as getWindow, i as DialogContent$1, in as useAnimationsFinished, ir as EMPTY_OBJECT, it as DROPDOWN_COLLISION_AVOIDANCE, j as useHoverReferenceInteraction, jn as getMaxListIndex, jt as CollapsibleTrigger, k as pressableTriggerOpenStateMapping, kn as isOutsideEvent, kr as useNavigate, kt as Collapsible, l as DialogTitle$1, ln as cancelOpen, lr as useCompositeRootContext, lt as fastComponentRef, m as DialogPopup, mn as listNavigation, mr as getParentNode, n as ZoomableImage, nn as getIcon, nr as useRenderElement, nt as FloatingTreeStore, o as DialogTrigger, on as useCompositeListItem, or as useButton, ot as enqueueFocus, p as InternalBackdrop, pn as itemPress, pr as useRefWithInit, q as ReactStore, qn as ARROW_UP, r as Dialog$1, rn as useOpenChangeComplete, rr as EMPTY_ARRAY, rt as FloatingPortal, s as DialogTrigger$1, sn as useAnimationFrame, sr as dispatchClickWithModifiers, st as FocusGuard, t as docs_exports, tn as resolveIcon, tr as cn, tt as useFloatingTree, u as DialogRoot, un as escapeKey, ur as mergeProps$1, vn as triggerHover, vr as X$1, w as TooltipProvider, wn as addEventListener, wr as Navigate, xn as Mermaid, xr as createLucideIcon, xt as PanelProvider, yn as triggerPress, yr as ChevronRight, yt as ParamField, z as PopupHandleAttachment, zn as getFloatingFocusElement } from "./docs.js";
 import { n as highlightTerms } from "./search.js";
 import { resolveSearchProvider } from "../search.js";
 import * as React from "react";
 import { useCallback, useEffect, useRef, useState } from "react";
 import "@fontsource-variable/inter/index.css";
 import "@fontsource/jetbrains-mono/400.css";
-import "highlight.js/styles/github.css";
 import "@umami/shiso/styles.css";
 import { MDXProvider } from "@mdx-js/react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import * as ReactDOM from "react-dom";
 import shiso from "virtual:shiso-config";
 import rawConfig from "virtual:shiso-docs-config";
 import { LAST_MODIFIED } from "@/generated/last-modified";
+import { OPENAPI_OPERATIONS } from "@/lib/openapi.generated";
 
 //#region ../../node_modules/.pnpm/lucide-react@1.28.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/arrow-left.mjs
 /**
@@ -1181,12 +1181,43 @@ function ScrollBar({ className, orientation = "vertical", ...props }) {
 
 //#endregion
 //#region src/components/CodeBlock.tsx
-function CodeBlock({ children, className }) {
+function reactChildrenToText(node) {
+	if (typeof node === "string" || typeof node === "number") return String(node);
+	if (Array.isArray(node)) return node.map(reactChildrenToText).join("");
+	if (node && typeof node === "object" && "props" in node) {
+		const props = node.props;
+		if (typeof props?.value === "string") return props.value;
+		return reactChildrenToText(props?.children);
+	}
+	return "";
+}
+/**
+* Joins the text of each rendered line. Lines marked as removed by
+* `// [!code --]` are skipped so the clipboard holds the "after" state; in a
+* `diff` block the +/- lines are content and are copied verbatim.
+*/
+function copyText(pre, language) {
+	if (!pre) return "";
+	const lines = [...pre.querySelectorAll(".line")];
+	if (!lines.length) return pre.textContent || "";
+	return lines.filter((line) => language === "diff" || line.dataset.diff !== "remove").map((line) => line.textContent || "").join("\n");
+}
+function CodeBlock({ children, className, style, ...rest }) {
+	const { "data-title": title, "data-language": language, "data-line-start": lineStart, "data-line-count": lineCount, "data-placement": placement, "data-actions": actions, ...preProps } = rest;
 	const textInput = useRef(null);
 	const [copied, setCopied] = useState(false);
+	if (language === "mermaid") return /* @__PURE__ */ jsx(Mermaid, {
+		chart: reactChildrenToText(children).replace(/\n$/, ""),
+		title,
+		placement,
+		actions: actions === void 0 ? void 0 : actions !== "false"
+	});
+	const start = Number(lineStart) || 1;
+	const lastLine = start + Math.max(Number(lineCount) || 1, 1) - 1;
+	const gutter = `${String(lastLine).length}ch`;
 	const handleCopy = () => {
 		setCopied(true);
-		navigator?.clipboard?.writeText(textInput.current?.textContent || "");
+		navigator?.clipboard?.writeText(copyText(textInput.current, language));
 		setTimeout(() => {
 			setCopied(false);
 		}, 1e3);
@@ -1194,23 +1225,38 @@ function CodeBlock({ children, className }) {
 	return /* @__PURE__ */ jsxs("div", {
 		"data-slot": "code-block",
 		className: "relative my-5 overflow-hidden rounded-lg bg-card",
-		children: [/* @__PURE__ */ jsx(ScrollArea, {
-			scrollbars: "horizontal",
-			className: "w-full",
-			children: /* @__PURE__ */ jsx("pre", {
-				ref: textInput,
-				className: `code-block p-3 pr-12 text-sm text-foreground leading-[1.6] font-mono ${className || ""}`,
-				children
+		children: [
+			title ? /* @__PURE__ */ jsx("div", {
+				"data-slot": "code-block-header",
+				className: "flex h-9 items-center border-border border-b px-3 pr-12 font-mono text-muted-foreground text-xs",
+				children: title
+			}) : null,
+			/* @__PURE__ */ jsx(ScrollArea, {
+				scrollbars: "horizontal",
+				className: "w-full",
+				children: /* @__PURE__ */ jsx("pre", {
+					ref: textInput,
+					...preProps,
+					"data-language": language,
+					style: {
+						...style,
+						counterReset: `line ${start - 1}`,
+						"--code-gutter": gutter
+					},
+					className: cn("code-block w-max min-w-full py-3 font-mono text-foreground text-sm leading-[1.6]", className),
+					children
+				})
+			}),
+			/* @__PURE__ */ jsx(Button, {
+				type: "button",
+				variant: "ghost",
+				size: "icon-sm",
+				className: cn("absolute right-3 inline-flex size-7 items-center justify-center rounded-sm text-muted-foreground hover:bg-accent hover:text-accent-foreground", title ? "top-1" : "top-2.5"),
+				onClick: handleCopy,
+				"aria-label": "Copy code",
+				children: copied ? /* @__PURE__ */ jsx(Check, { className: "size-3.5 text-primary" }) : /* @__PURE__ */ jsx(Copy, { className: "size-3.5" })
 			})
-		}), /* @__PURE__ */ jsx(Button, {
-			type: "button",
-			variant: "ghost",
-			size: "icon-sm",
-			className: "absolute top-2.5 right-3 inline-flex size-7 items-center justify-center rounded-sm text-muted-foreground hover:bg-accent hover:text-accent-foreground",
-			onClick: handleCopy,
-			"aria-label": "Copy code",
-			children: copied ? /* @__PURE__ */ jsx(Check, { className: "size-3.5 text-primary" }) : /* @__PURE__ */ jsx(Copy, { className: "size-3.5" })
-		})]
+		]
 	});
 }
 
@@ -2725,8 +2771,8 @@ const MenuRoot = fastComponent(function MenuRoot(props) {
 	store.useControlledProp("openProp", openProp);
 	store.useControlledProp("triggerIdProp", triggerIdProp);
 	store.useContextCallback("onOpenChangeComplete", onOpenChangeComplete);
-	const rootId = useId$1();
-	const floatingId = useId$1();
+	const rootId = useId$2();
+	const floatingId = useId$2();
 	const floatingTreeRoot = store.useState("floatingTreeRoot");
 	const floatingNodeIdFromContext = useFloatingNodeId(floatingTreeRoot);
 	const floatingParentNodeIdFromContext = useFloatingParentNodeId();
@@ -3422,6 +3468,52 @@ const regex = /[\0-\x1F!-,\.\/:-@\[-\^`\{-\xA9\xAB-\xB4\xB6-\xB9\xBB-\xBF\xD7\xF
 //#region ../../node_modules/.pnpm/github-slugger@2.0.0/node_modules/github-slugger/index.js
 const own = Object.hasOwnProperty;
 /**
+* Slugger.
+*/
+var BananaSlug = class {
+	/**
+	* Create a new slug class.
+	*/
+	constructor() {
+		/** @type {Record<string, number>} */
+		this.occurrences;
+		this.reset();
+	}
+	/**
+	* Generate a unique slug.
+	*
+	* Tracks previously generated slugs: repeated calls with the same value
+	* will result in different slugs.
+	* Use the `slug` function to get same slugs.
+	*
+	* @param  {string} value
+	*   String of text to slugify
+	* @param  {boolean} [maintainCase=false]
+	*   Keep the current case, otherwise make all lowercase
+	* @return {string}
+	*   A unique slug string
+	*/
+	slug(value, maintainCase) {
+		const self = this;
+		let result = slug(value, maintainCase === true);
+		const originalSlug = result;
+		while (own.call(self.occurrences, result)) {
+			self.occurrences[originalSlug]++;
+			result = originalSlug + "-" + self.occurrences[originalSlug];
+		}
+		self.occurrences[result] = 0;
+		return result;
+	}
+	/**
+	* Reset - Forget all previous slugs
+	*
+	* @return void
+	*/
+	reset() {
+		this.occurrences = Object.create(null);
+	}
+};
+/**
 * Generate a slug.
 *
 * Does not track previously generated slugs: repeated calls with the same value
@@ -3444,6 +3536,22 @@ function slug(value, maintainCase) {
 //#endregion
 //#region src/lib/slug.ts
 /**
+* The single slug algorithm in the repo.
+*
+* Heading anchors are produced in two independent places — `remarkToc` (which
+* builds the on-page table of contents) and `rehype-slug` (which sets the `id`
+* on the rendered heading). Both must agree or every TOC link breaks, so both
+* go through github-slugger here rather than reimplementing it.
+*/
+/**
+* Creates a stateful slugger. Call `.slug(text)` once per heading in document
+* order; repeated headings get `-1`, `-2`, ... suffixes exactly as rehype-slug
+* does, because it is the same implementation.
+*/
+function createSlugger() {
+	return new BananaSlug();
+}
+/**
 * Stateless slugify for one-off ids that do not need de-duplication.
 *
 * github-slugger does not trim, so padded input would otherwise produce leading
@@ -3637,7 +3745,8 @@ function addPage(pageRef, context, state, extra = {}) {
 		order,
 		hidden: extra.hidden || context.hidden || void 0,
 		icon: extra.icon,
-		tag: extra.tag
+		tag: extra.tag,
+		method: extra.method
 	});
 	return order;
 }
@@ -3673,6 +3782,7 @@ function collectPages(items, context, state) {
 					label,
 					icon: typeof item.icon === "string" ? item.icon : void 0,
 					tag: typeof item.tag === "string" ? item.tag : void 0,
+					method: typeof item.method === "string" ? item.method : void 0,
 					hidden: item.hidden === true
 				})
 			});
@@ -4054,6 +4164,24 @@ function getTextDirection(locale) {
 	return RTL_LANGUAGES.has(primary) ? "rtl" : "ltr";
 }
 
+//#endregion
+//#region src/lib/code-blocks.ts
+const DEFAULT_CODE_THEME = {
+	light: "github-light",
+	dark: "github-dark"
+};
+/** Applies defaults to `styling.codeBlocks` from docs.json. */
+function resolveCodeBlockConfig(styling) {
+	const codeBlocks = styling?.codeBlocks;
+	return {
+		lineNumbers: codeBlocks?.lineNumbers === true,
+		theme: {
+			light: codeBlocks?.theme?.light || DEFAULT_CODE_THEME.light,
+			dark: codeBlocks?.theme?.dark || DEFAULT_CODE_THEME.dark
+		}
+	};
+}
+
 //#endregion
 //#region src/lib/search/config.ts
 const DEFAULT_SEARCH_PROMPT = "Search...";
@@ -4191,7 +4319,10 @@ function resolveSiteModel(config, docs, shiso) {
 			default: appearance.default === "light" || appearance.default === "dark" ? appearance.default : "system",
 			strict: appearance.strict === true
 		},
-		styling: { eyebrows: config.styling?.eyebrows === "breadcrumbs" ? "breadcrumbs" : "section" },
+		styling: {
+			eyebrows: config.styling?.eyebrows === "breadcrumbs" ? "breadcrumbs" : "section",
+			codeBlocks: resolveCodeBlockConfig(config.styling)
+		},
 		search: resolveSearchConfig(config.search),
 		contextualOptions: config.contextual?.options || [],
 		error404: {
@@ -4667,14 +4798,14 @@ var __name$11 = (target, value) => __defProp$11(target, "name", {
 });
 var useReactId = React[" useId ".trim().toString()] || (() => void 0);
 var count$1 = 0;
-function useId(deterministicId) {
+function useId$1(deterministicId) {
 	const [id, setId] = React.useState(useReactId());
 	useLayoutEffect2(() => {
 		if (!deterministicId) setId((reactId) => reactId ?? String(count$1++));
 	}, [deterministicId]);
 	return deterministicId || (id ? `radix-${id}` : "");
 }
-__name$11(useId, "useId");
+__name$11(useId$1, "useId");
 
 //#endregion
 //#region ../../node_modules/.pnpm/@radix-ui+react-use-effect-_e8d5e8242c04825bf34212c7f6280f14/node_modules/@radix-ui/react-use-effect-event/dist/index.mjs
@@ -6542,9 +6673,9 @@ var Dialog = /* @__PURE__ */ __name((props) => {
 		scope: __scopeDialog,
 		triggerRef,
 		contentRef,
-		contentId: useId(),
-		titleId: useId(),
-		descriptionId: useId(),
+		contentId: useId$1(),
+		titleId: useId$1(),
+		descriptionId: useId$1(),
 		titlePresent: titleCount > 0,
 		descriptionPresent: descriptionCount > 0,
 		setTitleCount,
@@ -6683,7 +6814,7 @@ var DialogContentImpl = /* @__PURE__ */ React.forwardRef(/* @__PURE__ */ __name(
 	const { __scopeDialog, trapFocus, onOpenAutoFocus, onCloseAutoFocus, ...contentProps } = props;
 	const context = useDialogContext(CONTENT_NAME, __scopeDialog);
 	useFocusGuards();
-	return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(FocusScope, {
+	return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsx(FocusScope, {
 		asChild: true,
 		loop: true,
 		trapped: trapFocus,
@@ -6735,7 +6866,7 @@ var me = React.forwardRef((r, o) => {
 				groups: /* @__PURE__ */ new Set()
 			}
 		};
-	}), u = L(() => /* @__PURE__ */ new Set()), c = L(() => /* @__PURE__ */ new Map()), d = L(() => /* @__PURE__ */ new Map()), f = L(() => /* @__PURE__ */ new Set()), p = pe(r), { label: b, children: m, value: R, onValueChange: x, filter: C, shouldFilter: S, loop: A, disablePointerSelection: ge = !1, vimBindings: j = !0, ...O } = r, $ = useId(), q = useId(), _ = useId(), I = React.useRef(null), v = ke();
+	}), u = L(() => /* @__PURE__ */ new Set()), c = L(() => /* @__PURE__ */ new Map()), d = L(() => /* @__PURE__ */ new Map()), f = L(() => /* @__PURE__ */ new Set()), p = pe(r), { label: b, children: m, value: R, onValueChange: x, filter: C, shouldFilter: S, loop: A, disablePointerSelection: ge = !1, vimBindings: j = !0, ...O } = r, $ = useId$1(), q = useId$1(), _ = useId$1(), I = React.useRef(null), v = ke();
 	k(() => {
 		if (R !== void 0) {
 			let e = R.trim();
@@ -6933,7 +7064,7 @@ var me = React.forwardRef((r, o) => {
 });
 var he = React.forwardRef((r, o) => {
 	var _, I;
-	let n = useId(), u = React.useRef(null), c = React.useContext(fe), d = K(), f = pe(r), p = (I = (_ = f.current) == null ? void 0 : _.forceMount) != null ? I : c == null ? void 0 : c.forceMount;
+	let n = useId$1(), u = React.useRef(null), c = React.useContext(fe), d = K(), f = pe(r), p = (I = (_ = f.current) == null ? void 0 : _.forceMount) != null ? I : c == null ? void 0 : c.forceMount;
 	k(() => {
 		if (!p) return d.item(n, c == null ? void 0 : c.id);
 	}, [p]);
@@ -6974,7 +7105,7 @@ var he = React.forwardRef((r, o) => {
 	}, r.children);
 });
 var Ee = React.forwardRef((r, o) => {
-	let { heading: n, children: u, forceMount: c, ...d } = r, f = useId(), p = React.useRef(null), b = React.useRef(null), m = useId(), R = K(), x = P((S) => c || R.filter() === !1 ? !0 : S.search ? S.filtered.groups.has(f) : !0);
+	let { heading: n, children: u, forceMount: c, ...d } = r, f = useId$1(), p = React.useRef(null), b = React.useRef(null), m = useId$1(), R = K(), x = P((S) => c || R.filter() === !1 ? !0 : S.search ? S.filtered.groups.has(f) : !0);
 	k(() => R.group(f), []), ve(f, p, [
 		r.value,
 		r.heading,
@@ -7386,7 +7517,7 @@ function Search({ config, labels, className }) {
 							onSelect: () => select(result),
 							children: [/* @__PURE__ */ jsxs("div", {
 								className: "text-[0.9rem] font-semibold text-foreground",
-								children: [renderWithQueryHighlight(result.page, query), result.heading ? /* @__PURE__ */ jsxs(Fragment, { children: [" › ", renderWithQueryHighlight(result.heading, query)] }) : null]
+								children: [renderWithQueryHighlight(result.page, query), result.heading ? /* @__PURE__ */ jsxs(Fragment$1, { children: [" › ", renderWithQueryHighlight(result.heading, query)] }) : null]
 							}), result.snippet && /* @__PURE__ */ jsx("div", {
 								className: "mt-[0.15rem] line-clamp-2 text-[0.8rem] text-muted-foreground",
 								children: renderSnippet(result.snippet)
@@ -7575,7 +7706,7 @@ function NavbarLinkItem({ link, primary = false }) {
 	const iconOnly = !link.label;
 	const accessibleLabel = link.ariaLabel || link.icon || link.href;
 	const className = primary ? `ml-1 inline-flex items-center justify-center rounded-full bg-primary text-sm font-semibold text-primary-foreground hover:opacity-90 ${iconOnly ? "size-8" : "gap-1.5 px-3.5 py-1.5"}` : `inline-flex items-center rounded-md text-sm font-medium text-foreground hover:bg-accent hover:text-foreground ${iconOnly ? "size-8 justify-center" : "gap-1.5 px-2.5 py-1.5"}`;
-	const content = /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(ConfiguredIcon, { icon: link.icon }), link.label] });
+	const content = /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(ConfiguredIcon, { icon: link.icon }), link.label] });
 	if (isRoutedHref(link.href, link.target)) return /* @__PURE__ */ jsx(Link, {
 		to: link.href,
 		className,
@@ -7598,11 +7729,11 @@ function Header({ site }) {
 	const brandHref = logo?.href || (hasRootStandalonePage ? "/" : docsHomeUrl);
 	const hasBrand = !!name || !!logo?.light || !!logo?.dark;
 	const brandClassName = "inline-flex items-center gap-2 text-xl font-bold text-foreground tracking-[-0.03em]";
-	const brandContent = /* @__PURE__ */ jsxs(Fragment, { children: [logo?.invert && logo.light ? /* @__PURE__ */ jsx("img", {
+	const brandContent = /* @__PURE__ */ jsxs(Fragment$1, { children: [logo?.invert && logo.light ? /* @__PURE__ */ jsx("img", {
 		src: logo.light,
 		alt: "",
 		className: "h-6 w-auto dark:brightness-0 dark:invert"
-	}) : /* @__PURE__ */ jsxs(Fragment, { children: [logo?.light ? /* @__PURE__ */ jsx("img", {
+	}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [logo?.light ? /* @__PURE__ */ jsx("img", {
 		src: logo.light,
 		alt: "",
 		className: "h-6 w-auto dark:hidden"
@@ -7953,6 +8084,196 @@ function ContextualMenu({ options, labels }) {
 	});
 }
 
+//#endregion
+//#region src/lib/openapi.ts
+const METHOD_COLORS = {
+	GET: "green",
+	POST: "blue",
+	PUT: "orange",
+	PATCH: "purple",
+	DELETE: "red"
+};
+function methodColor(method) {
+	return method && METHOD_COLORS[method.toUpperCase()] || "gray";
+}
+function statusColor(status) {
+	if (status.startsWith("2")) return "green";
+	if (status.startsWith("3")) return "blue";
+	if (status.startsWith("4") || status.startsWith("5")) return "red";
+	return "gray";
+}
+/** Looks up the operation bound by an `openapi:` frontmatter value. */
+function getOperation(key) {
+	if (typeof key !== "string" || !key.trim()) return;
+	const [method, ...rest] = key.trim().split(/\s+/);
+	return OPENAPI_OPERATIONS[`${method.toUpperCase()} ${rest.join(" ")}`];
+}
+function hasParameters(operation) {
+	const { query, path, header, cookie } = operation.parameters;
+	return query.length + path.length + header.length + cookie.length > 0 || operation.security.length > 0;
+}
+/**
+* Section headings for an operation, in render order. The single source of
+* truth for section ids: the component, the table of contents, the content
+* checker, and the search indexer all derive their anchors from these labels.
+*/
+function operationSections(operation) {
+	const slugger = createSlugger();
+	return [
+		hasParameters(operation) ? "Parameters" : void 0,
+		operation.requestBody ? "Request body" : void 0,
+		operation.responses.length ? "Responses" : void 0,
+		operation.samples.length ? "Code samples" : void 0
+	].filter((name) => Boolean(name)).map((name) => ({
+		name,
+		id: slugger.slug(name),
+		size: 2
+	}));
+}
+
+//#endregion
+//#region src/components/OpenApiOperation.tsx
+const PARAM_LOCATIONS = [
+	"path",
+	"query",
+	"header",
+	"cookie"
+];
+function FieldChildren({ node }) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		node.description,
+		node.enum && node.enum.length > 0 && /* @__PURE__ */ jsxs("div", {
+			className: "mt-1",
+			children: [
+				"Options:",
+				" ",
+				node.enum.map((value, index) => /* @__PURE__ */ jsxs("span", { children: [index > 0 && ", ", /* @__PURE__ */ jsx("code", { children: value })] }, value))
+			]
+		}),
+		node.children && node.children.length > 0 && /* @__PURE__ */ jsx(Expandable, {
+			title: "properties",
+			children: node.children.map((child) => /* @__PURE__ */ jsx(SchemaField, { node: child }, child.name || child.type))
+		})
+	] });
+}
+function SchemaField({ node }) {
+	const hasDetails = Boolean(node.description || node.enum?.length || node.children?.length);
+	return /* @__PURE__ */ jsx(ResponseField, {
+		name: node.name || node.type,
+		type: node.name ? node.type : void 0,
+		required: node.required,
+		deprecated: node.deprecated,
+		default: node.default,
+		children: hasDetails ? /* @__PURE__ */ jsx(FieldChildren, { node }) : null
+	});
+}
+/** Renders a schema tree: a root object's properties, or the node itself. */
+function SchemaFields({ node }) {
+	if (!node.name && node.children?.length) return /* @__PURE__ */ jsx(Fragment$1, { children: node.children.map((child) => /* @__PURE__ */ jsx(SchemaField, { node: child }, child.name || child.type)) });
+	return /* @__PURE__ */ jsx(SchemaField, { node });
+}
+function HighlightedCode({ language, title, html, source, lineCount }) {
+	return /* @__PURE__ */ jsx(CodeBlock, {
+		"data-language": language,
+		"data-title": title,
+		"data-line-count": lineCount ? String(lineCount) : void 0,
+		children: html ? /* @__PURE__ */ jsx("code", {
+			className: `language-${language}`,
+			dangerouslySetInnerHTML: { __html: html }
+		}) : /* @__PURE__ */ jsx("code", {
+			className: `language-${language}`,
+			children: source
+		})
+	});
+}
+/** The generated reference for one API operation, rendered under the page body. */
+function OpenApiOperation({ operation }) {
+	const sections = new Map(operationSections(operation).map((entry) => [entry.name, entry.id]));
+	const showParameters = sections.has("Parameters");
+	return /* @__PURE__ */ jsxs("div", {
+		className: "docs-markdown",
+		children: [
+			showParameters && /* @__PURE__ */ jsxs("section", { children: [/* @__PURE__ */ jsx("h2", {
+				id: sections.get("Parameters"),
+				children: "Parameters"
+			}), /* @__PURE__ */ jsxs("div", {
+				className: styles.fieldGroup,
+				children: [operation.security.length > 0 && /* @__PURE__ */ jsxs(ParamField, {
+					header: "Authorization",
+					type: "string",
+					required: true,
+					children: [
+						"Authentication credentials, e.g. ",
+						/* @__PURE__ */ jsx("code", { children: "Bearer <token>" }),
+						"."
+					]
+				}), PARAM_LOCATIONS.map((location) => operation.parameters[location].map((parameter) => /* @__PURE__ */ jsxs(ParamField, {
+					[location]: parameter.name,
+					type: parameter.type,
+					required: parameter.required,
+					children: [/* @__PURE__ */ jsx(FieldChildren, { node: {
+						...parameter,
+						name: void 0,
+						description: void 0
+					} }), parameter.description]
+				}, `${location}-${parameter.name}`)))]
+			})] }),
+			operation.requestBody && /* @__PURE__ */ jsxs("section", { children: [
+				/* @__PURE__ */ jsx("h2", {
+					id: sections.get("Request body"),
+					children: "Request body"
+				}),
+				/* @__PURE__ */ jsx(SchemaFields, { node: operation.requestBody.schema }),
+				operation.requestBody.example && /* @__PURE__ */ jsx(HighlightedCode, {
+					language: "json",
+					title: "Example request",
+					html: operation.requestBody.exampleHtml,
+					source: operation.requestBody.example
+				})
+			] }),
+			operation.responses.length > 0 && /* @__PURE__ */ jsxs("section", { children: [/* @__PURE__ */ jsx("h2", {
+				id: sections.get("Responses"),
+				children: "Responses"
+			}), operation.responses.map((response) => /* @__PURE__ */ jsxs("div", {
+				className: "mt-6 first:mt-0",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-2",
+						children: [/* @__PURE__ */ jsx(Badge, {
+							color: statusColor(response.status),
+							size: "sm",
+							children: response.status
+						}), response.description && /* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground text-sm",
+							children: response.description
+						})]
+					}),
+					response.schema && /* @__PURE__ */ jsx("div", {
+						className: styles.fieldGroup,
+						children: /* @__PURE__ */ jsx(SchemaFields, { node: response.schema })
+					}),
+					response.example && /* @__PURE__ */ jsx(HighlightedCode, {
+						language: "json",
+						title: `${response.status} example`,
+						html: response.exampleHtml,
+						source: response.example
+					})
+				]
+			}, response.status))] }),
+			operation.samples.length > 0 && /* @__PURE__ */ jsxs("section", { children: [/* @__PURE__ */ jsx("h2", {
+				id: sections.get("Code samples"),
+				children: "Code samples"
+			}), /* @__PURE__ */ jsx(CodeGroup, { children: operation.samples.map((sample) => /* @__PURE__ */ jsx(HighlightedCode, {
+				language: sample.language,
+				title: sample.label,
+				html: sample.html,
+				source: sample.source,
+				lineCount: sample.lineCount
+			}, sample.language)) })] })
+		]
+	});
+}
+
 //#endregion
 //#region src/components/DocContent.tsx
 /**
@@ -7993,6 +8314,7 @@ function DocContent({ page, doc, site }) {
 	const eyebrow = site.styling.eyebrows === "breadcrumbs" ? [.../* @__PURE__ */ new Set([page.tabLabel, page.section])].filter(Boolean).join(" / ") : page.section;
 	const contextualOptions = resolveContextualOptions(site.contextualOptions, page, site.labels);
 	const related = resolveRelated(doc.frontmatter?.related);
+	const operation = getOperation(doc.frontmatter?.openapi);
 	const dateFormat = new Intl.DateTimeFormat(resolveLocale(page.language, site.locale), {
 		dateStyle: "medium",
 		timeZone: "UTC"
@@ -8022,6 +8344,27 @@ function DocContent({ page, doc, site }) {
 					labels: site.labels
 				})]
 			}),
+			operation && /* @__PURE__ */ jsxs("div", {
+				className: "mt-3 flex flex-wrap items-center gap-2",
+				children: [
+					/* @__PURE__ */ jsx(Badge, {
+						color: methodColor(operation.method),
+						size: "sm",
+						className: "font-mono",
+						children: operation.method
+					}),
+					/* @__PURE__ */ jsx("code", {
+						className: "font-mono text-muted-foreground text-sm",
+						children: operation.path
+					}),
+					operation.deprecated && /* @__PURE__ */ jsx(Badge, {
+						color: "red",
+						size: "sm",
+						stroke: true,
+						children: "deprecated"
+					})
+				]
+			}),
 			description && /* @__PURE__ */ jsx("p", {
 				className: "mt-3 mb-8 text-lg text-muted-foreground leading-relaxed",
 				children: description
@@ -8030,6 +8373,7 @@ function DocContent({ page, doc, site }) {
 				className: "docs-markdown",
 				children: /* @__PURE__ */ jsx(Content, {})
 			}),
+			operation && /* @__PURE__ */ jsx(OpenApiOperation, { operation }),
 			lastModified && /* @__PURE__ */ jsxs("div", {
 				className: "mt-8 text-sm text-muted-foreground",
 				children: [
@@ -8354,7 +8698,7 @@ function NavNodes({ nodes, pathname, depth, drilldown, expandLabel, collapseLabe
 			return;
 		}
 		if (node.kind === "page") {
-			const { url, label, icon, tag } = node.page;
+			const { url, label, icon, tag, method } = node.page;
 			const isSelected = url === pathname;
 			rendered.push(/* @__PURE__ */ jsxs(Link, {
 				to: url,
@@ -8365,8 +8709,14 @@ function NavNodes({ nodes, pathname, depth, drilldown, expandLabel, collapseLabe
 				}),
 				children: [
 					resolveIcon(icon),
+					method ? /* @__PURE__ */ jsx(Badge, {
+						color: methodColor(method),
+						size: "xs",
+						className: "w-10 shrink-0 justify-center whitespace-nowrap font-mono",
+						children: method === "DELETE" ? "DEL" : method
+					}) : null,
 					label,
-					tag ? /* @__PURE__ */ jsx(Badge, {
+					!method && tag ? /* @__PURE__ */ jsx(Badge$1, {
 						variant: "secondary",
 						className: "ml-auto h-auto rounded-sm px-[0.35rem] py-[0.05rem] text-[0.7rem] text-muted-foreground uppercase",
 						children: tag
@@ -8384,7 +8734,7 @@ function NavNodes({ nodes, pathname, depth, drilldown, expandLabel, collapseLabe
 			collapseLabel
 		}, `group-${node.label}`));
 	});
-	return /* @__PURE__ */ jsx(Fragment, { children: rendered });
+	return /* @__PURE__ */ jsx(Fragment$1, { children: rendered });
 }
 function SideNav({ tabs, navigation, anchors, activeTabId, isSticky, drilldown, navigationLabel, expandLabel, collapseLabel }) {
 	const { pathname } = useLocation();
@@ -8488,10 +8838,28 @@ function NotFound({ site }) {
 	});
 }
 function Docs({ page, doc, site }) {
+	if (!page || !doc) return /* @__PURE__ */ jsxs("div", {
+		className: "flex min-h-full flex-col",
+		children: [/* @__PURE__ */ jsx("div", {
+			className: "grow",
+			children: /* @__PURE__ */ jsx(NotFound, { site })
+		}), /* @__PURE__ */ jsx(Footer, { footer: site.footer })]
+	});
+	const operation = getOperation(doc.frontmatter?.openapi);
+	const toc = operation ? [...doc.toc || [], ...operationSections(operation)] : doc.toc;
+	return /* @__PURE__ */ jsx(PanelProvider, { children: /* @__PURE__ */ jsx(DocsBody, {
+		page,
+		doc,
+		site,
+		toc
+	}) });
+}
+function DocsBody({ page, doc, site, toc }) {
 	const { pathname } = useLocation();
 	const [menuOpen, setMenuOpen] = useState(false);
 	const scopeDocs = getScopeByPathname(pathname).docs;
 	const { tabs, navigation } = scopeDocs;
+	const panel = usePanelContent();
 	useEffect(() => {
 		setMenuOpen(false);
 		if (!window.location.hash) window.scrollTo({
@@ -8499,13 +8867,6 @@ function Docs({ page, doc, site }) {
 			left: 0
 		});
 	}, [pathname]);
-	if (!page || !doc) return /* @__PURE__ */ jsxs("div", {
-		className: "flex min-h-full flex-col",
-		children: [/* @__PURE__ */ jsx("div", {
-			className: "grow",
-			children: /* @__PURE__ */ jsx(NotFound, { site })
-		}), /* @__PURE__ */ jsx(Footer, { footer: site.footer })]
-	});
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex min-h-full flex-col gap-6 lg:gap-0",
 		children: [/* @__PURE__ */ jsxs(Sheet, {
@@ -8572,8 +8933,8 @@ function Docs({ page, doc, site }) {
 						site
 					}), /* @__PURE__ */ jsx("div", {
 						className: "hidden min-w-0 max-w-60 basis-60 self-start lg:sticky lg:top-[calc(var(--header-height)+1.5rem)] lg:block lg:shrink-0",
-						children: /* @__PURE__ */ jsx(PageLinks, {
-							items: doc.toc,
+						children: panel ?? /* @__PURE__ */ jsx(PageLinks, {
+							items: toc,
 							title: site.labels.tableOfContents,
 							navigationLabel: site.labels.tableOfContentsNavigation
 						})
@@ -8685,4 +9046,4 @@ function App() {
 }
 
 //#endregion
-export { docsSite as a, getSeo as c, getDocModule as d, getLastModified as f, toAbsoluteUrl as h, docsHomeUrl as i, siteName as l, BASE_URL as m, buildHead as n, getLocaleByPathname as o, getScopeForPage as p, renderHeadToString as r, getRedirects as s, App as t, standalonePages as u };
+export { docsSite as a, getSeo as c, standalonePages as d, getDocModule as f, toAbsoluteUrl as g, BASE_URL as h, docsHomeUrl as i, siteConfig as l, getScopeForPage as m, buildHead as n, getLocaleByPathname as o, getLastModified as p, renderHeadToString as r, getRedirects as s, App as t, siteName as u };