@umami/shiso 1.11.0 → 1.12.0

package/bin/shiso.mjs

@@ -5,6 +5,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
+import { checkContent } from '../scripts/check-content.mjs';
 import { loadShisoConfig } from '../scripts/load-shiso-config.mjs';
 import { validateProject } from '../scripts/validate-config.mjs';
 
@@ -23,7 +24,7 @@ Commands:
   dev       Start the development server
   build     Validate and build the static site
   preview   Preview the production build
-  check     Validate docs.json and shiso.config
+  check     Validate configuration, pages, links, anchors, and local assets
 
 Options after dev, build, or preview are passed to Vite.
 `;
@@ -63,6 +64,24 @@ async function check(projectRoot) {
   if (shiso.sourcePath) {
     console.log(`${path.basename(shiso.sourcePath)} loaded.`);
   }
+
+  const content = await checkContent({ root: projectRoot, shiso: shiso.config });
+
+  for (const warning of content.warnings) {
+    console.warn(`  warning: ${warning}`);
+  }
+
+  if (!content.valid) {
+    console.error('\nContent validation failed:\n');
+    for (const error of content.errors) {
+      console.error(`  ${error}`);
+    }
+    process.exit(1);
+  }
+
+  console.log(
+    `Content is valid${content.warnings.length ? ` (${content.warnings.length} warnings)` : ''}.`,
+  );
 }
 
 async function main() {

package/dist/chunks/App.js

@@ -1,11 +1,10 @@
-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 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, Lt as Badge, 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$1, S as popupTransitionStateMapping, Sn as getFloatingFocusElement, St as CodeGroup, 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, ct as ResponseField, d as useScrollLock, dn as getTabbableBeforeElement, dr as useLocation, dt as ParamField, 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, gt as Expandable, 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 { 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";
@@ -13,6 +12,7 @@ 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,27 @@ function ScrollBar({ className, orientation = "vertical", ...props }) {
 
 //#endregion
 //#region src/components/CodeBlock.tsx
-function CodeBlock({ children, className }) {
+/**
+* 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, ...preProps } = rest;
 	const textInput = useRef(null);
 	const [copied, setCopied] = useState(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 +1209,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" })
-		})]
+		]
 	});
 }
 
@@ -3422,6 +3452,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 +3520,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 +3729,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 +3766,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 +4148,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 +4303,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: {
@@ -7953,6 +8068,195 @@ 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, { 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 }) {
+	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: /* @__PURE__ */ jsx(FieldChildren, { node })
+	});
+}
+/** 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, { 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"
+				}),
+				operation.security.length > 0 && /* @__PURE__ */ jsxs(ParamField, {
+					header: "Authorization",
+					type: "string",
+					required: true,
+					children: [
+						"Authentication credentials, e.g. ",
+						/* @__PURE__ */ jsx("code", { children: "Bearer <token>" }),
+						" (",
+						operation.security.join(", "),
+						")."
+					]
+				}),
+				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(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 +8297,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 +8327,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 +8356,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 +8681,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,
@@ -8366,7 +8693,12 @@ function NavNodes({ nodes, pathname, depth, drilldown, expandLabel, collapseLabe
 				children: [
 					resolveIcon(icon),
 					label,
-					tag ? /* @__PURE__ */ jsx(Badge, {
+					method ? /* @__PURE__ */ jsx(Badge, {
+						color: methodColor(method),
+						size: "xs",
+						className: "ml-auto font-mono",
+						children: method === "DELETE" ? "DEL" : 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
@@ -8506,6 +8838,8 @@ function Docs({ page, doc, site }) {
 			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__ */ jsxs("div", {
 		className: "flex min-h-full flex-col gap-6 lg:gap-0",
 		children: [/* @__PURE__ */ jsxs(Sheet, {
@@ -8573,7 +8907,7 @@ function Docs({ page, doc, 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,
+							items: toc,
 							title: site.labels.tableOfContents,
 							navigationLabel: site.labels.tableOfContentsNavigation
 						})
@@ -8685,4 +9019,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 };

package/dist/chunks/docs.js

@@ -11300,13 +11300,13 @@ function CodeGroup({ children }) {
 	const selected = blocks.some((block) => block.id === selectedKey) ? selectedKey : blocks[0]?.id;
 	if (!blocks.length) return null;
 	if (blocks.length === 1) return /* @__PURE__ */ jsx("div", {
-		className: styles.tabs,
+		className: `${styles.tabs} [&_[data-slot=code-block-header]]:hidden`,
 		children: blocks[0].content
 	});
 	return /* @__PURE__ */ jsxs(Tabs$1, {
 		value: selected,
 		onValueChange: setSelectedKey,
-		className: "my-4 gap-0 overflow-hidden rounded-lg bg-card [&_[data-slot=code-block]]:my-0 [&_[data-slot=code-block]]:rounded-none [&_[data-slot=code-block]]:border-0 [&_[data-slot=code-block]]:bg-transparent",
+		className: "my-4 gap-0 overflow-hidden rounded-lg bg-card [&_[data-slot=code-block]]:my-0 [&_[data-slot=code-block]]:rounded-none [&_[data-slot=code-block]]:border-0 [&_[data-slot=code-block]]:bg-transparent [&_[data-slot=code-block-header]]:hidden",
 		children: [/* @__PURE__ */ jsx(TabsList, {
 			variant: "line",
 			className: "h-9 w-full justify-start gap-5 overflow-x-auto overflow-y-hidden rounded-none px-3 py-0 shadow-[inset_0_-1px_0_var(--border)] [scrollbar-width:none] [&::-webkit-scrollbar]:hidden",

package/dist/entry-client.js

@@ -1,5 +1,5 @@
 import { ar as BrowserRouter } from "./chunks/docs.js";
-import { m as BASE_URL, t as App } from "./chunks/App.js";
+import { h as BASE_URL, t as App } from "./chunks/App.js";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/entry-client.tsx

package/dist/entry-server.js

@@ -1,5 +1,5 @@
 import { hr as ABSOLUTE_URL_REGEX, lr as Router, mr as parsePath, pr as createPath } from "./chunks/docs.js";
-import { a as docsSite, c as getSeo, d as getDocModule, f as getLastModified, h as toAbsoluteUrl, i as docsHomeUrl, l as siteName, m as BASE_URL, n as buildHead, o as getLocaleByPathname, p as getScopeForPage, r as renderHeadToString, s as getRedirects, t as App, u as standalonePages } from "./chunks/App.js";
+import { a as docsSite, c as getSeo, d as standalonePages, f as getDocModule, g as toAbsoluteUrl, h as BASE_URL, i as docsHomeUrl, l as siteConfig, m as getScopeForPage, n as buildHead, o as getLocaleByPathname, p as getLastModified, r as renderHeadToString, s as getRedirects, t as App, u as siteName } from "./chunks/App.js";
 import * as React$1 from "react";
 import { jsx } from "react/jsx-runtime";
 import { renderToString } from "react-dom/server";
@@ -107,6 +107,33 @@ function getMarkdownPages() {
 		filePath: page.filePath
 	}))];
 }
+/** Navigable Markdown pages used to generate llms.txt and llms-full.txt. */
+function getLlmsPages() {
+	const { indexing } = getSeo();
+	const pages = [];
+	for (const page of docsSite.pages) {
+		const doc = getDocModule(page.filePath);
+		if (doc?.frontmatter?.noindex === true || (page.hidden || getScopeForPage(docsSite, page).hidden) && indexing !== "all") continue;
+		pages.push({
+			route: page.url,
+			filePath: page.filePath,
+			title: doc?.frontmatter?.title || page.label,
+			description: doc?.frontmatter?.description
+		});
+	}
+	for (const page of standalonePages) {
+		if (page.filePath.endsWith(".tsx")) continue;
+		const doc = getDocModule(page.filePath);
+		if (doc?.frontmatter?.noindex === true) continue;
+		pages.push({
+			route: page.path,
+			filePath: page.filePath,
+			title: doc?.frontmatter?.title || page.title || page.path,
+			description: doc?.frontmatter?.description
+		});
+	}
+	return pages;
+}
 /**
 * Absolute URLs for the sitemap, honoring `seo.indexing` and per-page
 * noindex. Empty when the shiso.config `siteUrl` is not configured, since a sitemap
@@ -145,6 +172,7 @@ function render(url) {
 		htmlAttrs: getLocaleByPathname(url)
 	};
 }
+const siteDescription = siteConfig.description;
 
 //#endregion
-export { docsHomeUrl, getMarkdownPages, getRedirects, getRoutes, getSitemapEntries, render, siteName };
+export { docsHomeUrl, getLlmsPages, getMarkdownPages, getRedirects, getRoutes, getSitemapEntries, render, siteDescription, siteName };