ardo 3.1.0 → 3.2.0

package/dist/DocPage-BVibJR9O.js

@@ -0,0 +1,997 @@
+import { d as useArdoSiteConfig, f as useArdoTOC, l as useArdoPageData, n as getPrevNextLinks, r as ArdoContext, u as useArdoSidebar } from "./sidebar-utils-1Skqle1Q.js";
+import { Children, createContext, isValidElement, use, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Link, Links, Meta, Scripts, ScrollRestoration, useLocation } from "react-router";
+import { Check as CheckIcon, ChevronDown as ChevronDownIcon, CircleX as XCircleIcon, Copy as CopyIcon, FileText as FileTextIcon, Github as GithubIcon, Info as InfoIcon, Lightbulb as LightbulbIcon, Linkedin as LinkedinIcon, MessageCircle as MessageCircleIcon, Monitor as MonitorIcon, Moon as MoonIcon, Package as PackageIcon, Search as SearchIcon, Sun as SunIcon, TriangleAlert as AlertTriangleIcon, Twitter as TwitterIcon, X as XIcon, Youtube as YoutubeIcon } from "lucide-react";
+import "./assets/src/ui/Footer.css.ts.vanilla-BSzPIPt4.css";
+import "./assets/src/ui/Layout.css.ts.vanilla-Bpx_-gJt.css";
+import "./assets/src/ui/components/CodeBlock.css.ts.vanilla-lNKqskjQ.css";
+import "./assets/src/ui/components/CopyButton.css.ts.vanilla-DZZ5jgTM.css";
+import "./assets/src/ui/components/Container.css.ts.vanilla-CUhRUA9t.css";
+import { createRuntimeFn } from "@vanilla-extract/recipes/createRuntimeFn";
+import "./assets/src/ui/components/Steps.css.ts.vanilla-CisaxeNj.css";
+import "./assets/src/ui/components/Tabs.css.ts.vanilla-C4-vJSnf.css";
+import "./assets/src/ui/Breadcrumb.css.ts.vanilla-Dpgq-C_p.css";
+import "./assets/src/ui/content.css.ts.vanilla-O_RaSPXm.css";
+import "./assets/src/ui/DocPage.css.ts.vanilla-CXKuz4U-.css";
+import "./assets/src/ui/TOC.css.ts.vanilla-435FKDcl.css";
+//#region src/ui/Footer.css.ts
+var contentMeta = "_169q00b9";
+var footer = "_169q00b0";
+var footerBuildTime = "_169q00b7";
+var footerContainer = "_169q00b1";
+var footerCopyright = "_169q00b6";
+var footerLink = "_169q00b4";
+var footerMessage = "_169q00b5";
+var footerPrimary = "_169q00b2";
+var footerSeparator = "_169q00b3";
+var nextLink = "_169q00be _169q00bc";
+var prevLink = "_169q00bc";
+var prevNext = "_169q00bb";
+var prevNextLabel = "_169q00bf";
+var prevNextTitle = "_169q00bg";
+//#endregion
+//#region src/ui/Layout.css.ts
+var home = "_8autjm3";
+var homeMain = "_8autjm4";
+var layout = "_8autjm0";
+var layoutContainer = "_8autjm1";
+var main = "_8autjm2";
+var skipLink = "_8autjm5";
+//#endregion
+//#region src/ui/Layout.tsx
+const ARDO_FAVICON = "data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20style%3D%22stroke-linecap%3Around%3Bstroke-linejoin%3Around%22%20viewBox%3D%220%200%20600%20600%22%3E%3Cdefs%3E%3Csymbol%20id%3D%22a%22%20overflow%3D%22visible%22%3E%3Cpath%20d%3D%22M300%20300%20151%20128l2%20178-41%2094h93c-35%2032-55%2068-63%20107m63-106%2095%2081m-32-96%2028%2088%22%2F%3E%3Cellipse%20cx%3D%22222%22%20cy%3D%22327%22%20fill%3D%22%2300655a%22%20rx%3D%2220%22%20ry%3D%2233%22%2F%3E%3Ccircle%20cx%3D%22227%22%20cy%3D%22324%22%20r%3D%2271%22%2F%3E%3C%2Fsymbol%3E%3C%2Fdefs%3E%3Cg%20fill%3D%22none%22%20stroke%3D%22%2300655a%22%20stroke-width%3D%2216%22%3E%3Cpath%20d%3D%22M155%20318c2-70%2066-126%20145-126s143%2056%20145%20126%22%2F%3E%3Ccircle%20cx%3D%22300%22%20cy%3D%22290%22%20r%3D%22270%22%2F%3E%3Cuse%20href%3D%22%23a%22%2F%3E%3Cuse%20href%3D%22%23a%22%20transform%3D%22matrix%28-1%200%200%201%20600%200%29%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E";
+/**
+* Default HTML shell for Ardo sites. Replaces the boilerplate `Layout` export
+* that every root.tsx must define for React Router.
+*
+* @example Basic usage
+* ```tsx
+* // app/root.tsx
+* export { RootLayout as Layout } from "ardo/ui"
+* ```
+*
+* @example With favicon
+* ```tsx
+* import logo from "./assets/logo.svg"
+* export const Layout = (props) => <RootLayout favicon={logo} {...props} />
+* ```
+*/
+function ArdoRootLayout({ children, favicon, lang }) {
+	const context = use(ArdoContext);
+	return /* @__PURE__ */ jsxs("html", {
+		lang: lang ?? context?.config.lang ?? "en",
+		suppressHydrationWarning: true,
+		children: [/* @__PURE__ */ jsxs("head", { children: [
+			/* @__PURE__ */ jsx("meta", { charSet: "utf-8" }),
+			/* @__PURE__ */ jsx("meta", {
+				name: "viewport",
+				content: "width=device-width, initial-scale=1"
+			}),
+			/* @__PURE__ */ jsx("link", {
+				rel: "icon",
+				type: "image/svg+xml",
+				href: favicon ?? ARDO_FAVICON
+			}),
+			/* @__PURE__ */ jsx(Meta, {}),
+			/* @__PURE__ */ jsx(Links, {})
+		] }), /* @__PURE__ */ jsxs("body", {
+			suppressHydrationWarning: true,
+			children: [
+				children,
+				/* @__PURE__ */ jsx(ScrollRestoration, {}),
+				/* @__PURE__ */ jsx(Scripts, {})
+			]
+		})]
+	});
+}
+/**
+* Layout component with explicit slot props.
+*
+* @example
+* ```tsx
+* <Layout
+*   header={<Header logo="/logo.svg" title="Ardo" nav={...} />}
+*   sidebar={<Sidebar>...</Sidebar>}
+*   footer={<Footer message="MIT License" />}
+* >
+*   <Outlet />
+* </Layout>
+* ```
+*/
+function ArdoLayout({ header, sidebar, footer, children, className }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: className ?? "_8autjm0",
+		children: [
+			/* @__PURE__ */ jsx("a", {
+				href: "#main-content",
+				className: skipLink,
+				children: "Skip to content"
+			}),
+			header,
+			/* @__PURE__ */ jsxs("div", {
+				className: layoutContainer,
+				children: [sidebar, /* @__PURE__ */ jsxs("main", {
+					id: "main-content",
+					className: main,
+					children: [children, footer]
+				})]
+			})
+		]
+	});
+}
+//#endregion
+//#region src/ui/BareContent.tsx
+const BareContentContext = createContext(false);
+/**
+* Wraps imported MDX content to render without the full Content wrapper
+* (article, header, footer, navigation). Only the content body is rendered.
+*
+* ```tsx
+* import MySnippet from "./snippet.mdx"
+*
+* <BareContent>
+*   <MySnippet />
+* </BareContent>
+* ```
+*/
+function ArdoBareContent({ children }) {
+	return /* @__PURE__ */ jsx(BareContentContext, {
+		value: true,
+		children
+	});
+}
+function useBareContent() {
+	return use(BareContentContext);
+}
+//#endregion
+//#region src/ui/components/CodeBlock.css.ts
+var codeBlock = "_1l68ra30";
+var codeGroup = "_1l68ra35";
+var codeGroupPanel = "_1l68ra39";
+var codeGroupPanels = "_1l68ra38";
+var codeGroupTab = "_1l68ra37";
+var codeGroupTabs = "_1l68ra36";
+var codeLine = "_1l68ra33";
+var codeTitle = "_1l68ra31";
+var codeWrapper = "_1l68ra32";
+//#endregion
+//#region src/ui/components/CopyButton.css.ts
+var copyButton = "_1flm2ul1";
+var copyText = "_1flm2ul0";
+//#endregion
+//#region src/ui/components/CopyButton.tsx
+function ArdoCopyButton({ code }) {
+	const [copied, setCopied] = useState(false);
+	const handleCopy = async () => {
+		try {
+			await navigator.clipboard.writeText(code);
+			setCopied(true);
+			setTimeout(() => {
+				setCopied(false);
+			}, 2e3);
+		} catch (error) {
+			console.error("Failed to copy:", error);
+		}
+	};
+	return /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		className: copyButton,
+		onClick: () => {
+			handleCopy();
+		},
+		"aria-label": copied ? "Copied!" : "Copy code",
+		children: [copied ? /* @__PURE__ */ jsx(CheckIcon, { size: 16 }) : /* @__PURE__ */ jsx(CopyIcon, { size: 16 }), /* @__PURE__ */ jsx("span", {
+			className: copyText,
+			children: copied ? "Copied!" : "Copy"
+		})]
+	});
+}
+//#endregion
+//#region src/ui/components/CodeBlock.tsx
+const EMPTY_HIGHLIGHT_LINES = [];
+/**
+* Strips leading/trailing blank lines and removes common leading whitespace
+* so that template literals in indented JSX render cleanly.
+*/
+function outdent(text) {
+	let start = 0;
+	while (start < text.length && text[start] === "\n") start++;
+	let end = text.length;
+	while (end > start && (text[end - 1] === "\n" || text[end - 1] === "\r" || text[end - 1] === "	" || text[end - 1] === " ")) end--;
+	const trimmed = text.slice(start, end);
+	const lines = trimmed.split("\n");
+	const indent = lines.reduce((min, line) => {
+		if (line.trim().length === 0) return min;
+		const match = /^(\s*)/.exec(line);
+		return match ? Math.min(min, match[1].length) : min;
+	}, Infinity);
+	if (indent === 0 || indent === Infinity) return trimmed;
+	return lines.map((line) => line.slice(indent)).join("\n");
+}
+function CodeBlockContent({ html, hasHtml, hasCustomChildren, language, lines, highlightLines, lineNumbers, children }) {
+	if (hasHtml) return /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: html ?? "" } });
+	if (hasCustomChildren) return /* @__PURE__ */ jsx(Fragment, { children });
+	return /* @__PURE__ */ jsx("pre", {
+		className: `language-${language}`,
+		children: /* @__PURE__ */ jsx("code", { children: lines.map((line, index) => {
+			const lineNum = index + 1;
+			return /* @__PURE__ */ jsxs("span", {
+				className: highlightLines.includes(lineNum) ? `${codeLine} highlighted` : codeLine,
+				children: [
+					lineNumbers && /* @__PURE__ */ jsx("span", {
+						className: "_1l68ra34",
+						children: lineNum
+					}),
+					/* @__PURE__ */ jsx("span", { children: line }),
+					index < lines.length - 1 && "\n"
+				]
+			}, `${lineNum}-${line}`);
+		}) })
+	});
+}
+/**
+* Syntax-highlighted code block with copy button.
+*
+* Code can be provided via the `code` prop or as children:
+* ```tsx
+* <CodeBlock language="typescript">{`
+*   const x = 42
+* `}</CodeBlock>
+* ```tsx
+* When children is a string, leading/trailing blank lines and common
+* indentation are stripped automatically.
+*/
+function ArdoCodeBlock({ code: codeProp, language = "text", title, lineNumbers = false, highlightLines = EMPTY_HIGHLIGHT_LINES, children, __html }) {
+	const code = codeProp ?? (typeof children === "string" ? outdent(children) : "");
+	const hasCustomChildren = children != null && typeof children !== "string";
+	const hasHtml = (__html ?? "") !== "";
+	const hasTitle = (title ?? "") !== "";
+	const lines = code.split("\n");
+	return /* @__PURE__ */ jsxs("div", {
+		className: codeBlock,
+		"data-lang": language,
+		children: [hasTitle && /* @__PURE__ */ jsx("div", {
+			className: "_1l68ra31",
+			children: title
+		}), /* @__PURE__ */ jsxs("div", {
+			className: codeWrapper,
+			children: [/* @__PURE__ */ jsx(CodeBlockContent, {
+				html: __html,
+				hasHtml,
+				hasCustomChildren,
+				language,
+				lines,
+				highlightLines,
+				lineNumbers,
+				children
+			}), /* @__PURE__ */ jsx(ArdoCopyButton, { code })]
+		})]
+	});
+}
+/**
+* Tabbed group of code blocks.
+* Labels come from the `labels` prop (set at remark level) or fall back to
+* data-label / title / language props on children.
+*/
+function ArdoCodeGroup({ children, labels: labelsStr }) {
+	const [activeTab, setActiveTab] = useState(0);
+	const hasLabels = (labelsStr ?? "") !== "";
+	const childArray = Children.toArray(children).filter((child) => isValidElement(child));
+	const labelArray = hasLabels ? (labelsStr ?? "").split(",") : [];
+	const tabs = childArray.map((child, index) => {
+		if (labelArray[index]) return labelArray[index];
+		const props = child.props;
+		return props["data-label"] || props.title || props.language || `Tab ${index + 1}`;
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: codeGroup,
+		children: [/* @__PURE__ */ jsx("div", {
+			className: codeGroupTabs,
+			children: tabs.map((tab, index) => /* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: [codeGroupTab, index === activeTab && "active"].filter(Boolean).join(" "),
+				onClick: () => {
+					setActiveTab(index);
+				},
+				children: tab
+			}, tab))
+		}), /* @__PURE__ */ jsx("div", {
+			className: codeGroupPanels,
+			children: childArray.map((child, index) => /* @__PURE__ */ jsx("div", {
+				className: [codeGroupPanel, index === activeTab && "active"].filter(Boolean).join(" "),
+				style: { display: index === activeTab ? "block" : "none" },
+				children: child
+			}, tabAt(tabs, index)))
+		})]
+	});
+}
+function tabAt(tabs, index) {
+	return tabs[index];
+}
+//#endregion
+//#region src/ui/components/Container.css.ts
+var container = createRuntimeFn({
+	defaultClassName: "_1l7ew7r0",
+	variantClassNames: { type: {
+		tip: "_1l7ew7r1",
+		warning: "_1l7ew7r2",
+		danger: "_1l7ew7r3",
+		info: "_1l7ew7r4",
+		note: "_1l7ew7r5"
+	} },
+	defaultVariants: {},
+	compoundVariants: []
+});
+var containerBody = "_1l7ew7rc";
+var containerContent = "_1l7ew7rj";
+var containerIcon = createRuntimeFn({
+	defaultClassName: "_1l7ew7r6",
+	variantClassNames: { type: {
+		tip: "_1l7ew7r7",
+		warning: "_1l7ew7r8",
+		danger: "_1l7ew7r9",
+		info: "_1l7ew7ra",
+		note: "_1l7ew7rb"
+	} },
+	defaultVariants: {},
+	compoundVariants: []
+});
+var containerTitle = createRuntimeFn({
+	defaultClassName: "_1l7ew7rd",
+	variantClassNames: { type: {
+		tip: "_1l7ew7re",
+		warning: "_1l7ew7rf",
+		danger: "_1l7ew7rg",
+		info: "_1l7ew7rh",
+		note: "_1l7ew7ri"
+	} },
+	defaultVariants: {},
+	compoundVariants: []
+});
+//#endregion
+//#region src/ui/components/Container.tsx
+const defaultTitles = {
+	tip: "TIP",
+	warning: "WARNING",
+	danger: "DANGER",
+	info: "INFO",
+	note: "NOTE"
+};
+const icons = {
+	tip: /* @__PURE__ */ jsx(LightbulbIcon, { size: 18 }),
+	warning: /* @__PURE__ */ jsx(AlertTriangleIcon, { size: 18 }),
+	danger: /* @__PURE__ */ jsx(XCircleIcon, { size: 18 }),
+	info: /* @__PURE__ */ jsx(InfoIcon, { size: 18 }),
+	note: /* @__PURE__ */ jsx(FileTextIcon, { size: 18 })
+};
+/**
+* A styled container for callouts, tips, warnings, etc.
+*/
+function ArdoContainer({ type, title, children }) {
+	const hasCustomTitle = title != null && title !== "" && title !== defaultTitles[type];
+	return /* @__PURE__ */ jsxs("div", {
+		className: container({ type }),
+		children: [/* @__PURE__ */ jsx("span", {
+			className: containerIcon({ type }),
+			children: icons[type]
+		}), /* @__PURE__ */ jsxs("div", {
+			className: containerBody,
+			children: [hasCustomTitle && /* @__PURE__ */ jsx("p", {
+				className: containerTitle({ type }),
+				children: title
+			}), /* @__PURE__ */ jsx("div", {
+				className: containerContent,
+				children
+			})]
+		})]
+	});
+}
+/**
+* A tip container for helpful information.
+*/
+function ArdoTip({ title, children }) {
+	return /* @__PURE__ */ jsx(ArdoContainer, {
+		type: "tip",
+		title,
+		children
+	});
+}
+/**
+* A warning container for cautionary information.
+*/
+function ArdoWarning({ title, children }) {
+	return /* @__PURE__ */ jsx(ArdoContainer, {
+		type: "warning",
+		title,
+		children
+	});
+}
+/**
+* A danger container for critical warnings.
+*/
+function ArdoDanger({ title, children }) {
+	return /* @__PURE__ */ jsx(ArdoContainer, {
+		type: "danger",
+		title,
+		children
+	});
+}
+/**
+* An info container for informational content.
+*/
+function ArdoInfo({ title, children }) {
+	return /* @__PURE__ */ jsx(ArdoContainer, {
+		type: "info",
+		title,
+		children
+	});
+}
+/**
+* A note container for additional information.
+*/
+function ArdoNote({ title, children }) {
+	return /* @__PURE__ */ jsx(ArdoContainer, {
+		type: "note",
+		title,
+		children
+	});
+}
+//#endregion
+//#region src/ui/components/Icon.tsx
+const iconRegistry = /* @__PURE__ */ new Map();
+/**
+* Register icons for use with the Icon component.
+* Only registered icons are included in your bundle.
+*
+* @example
+* ```tsx
+* // In your app's entry point or layout:
+* import { registerIcons } from "ardo/ui"
+* import { Zap, Rocket, Code } from "lucide-react"
+*
+* registerIcons({ Zap, Rocket, Code })
+* ```
+*/
+function registerIcons(icons) {
+	for (const [name, icon] of Object.entries(icons)) iconRegistry.set(name, icon);
+}
+/**
+* Get all registered icon names (useful for documentation).
+*/
+function getRegisteredIconNames() {
+	return [...iconRegistry.keys()];
+}
+/**
+* Renders a registered icon by name.
+* Icons must be registered first using `registerIcons()`.
+*
+* @example
+* ```tsx
+* // First register icons in your app:
+* import { registerIcons } from "ardo/ui"
+* import { Zap, Rocket } from "lucide-react"
+* registerIcons({ Zap, Rocket })
+*
+* // Then use in MDX:
+* <Icon name="Zap" size={24} />
+* <Icon name="Rocket" className="text-brand" />
+* ```
+*
+* @see https://lucide.dev/icons for available icon names
+*/
+function ArdoIcon({ name, ...props }) {
+	const IconComp = iconRegistry.get(name);
+	if (!IconComp) {
+		console.warn(`[Ardo] Icon "${name}" not found. Did you register it with registerIcons()?`);
+		return null;
+	}
+	return /* @__PURE__ */ jsx(IconComp, { ...props });
+}
+//#endregion
+//#region src/ui/components/Steps.css.ts
+var steps = "go9pz30";
+//#endregion
+//#region src/ui/components/Steps.tsx
+/**
+* A wrapper for step-by-step instructions rendered as an ordered list.
+*
+* @example
+* ```tsx
+* <ArdoSteps>
+*   <ol>
+*     <li>Install the package</li>
+*     <li>Configure your site</li>
+*     <li>Start writing</li>
+*   </ol>
+* </ArdoSteps>
+* ```
+*/
+function ArdoSteps({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: steps,
+		children
+	});
+}
+//#endregion
+//#region src/ui/components/Tabs.css.ts
+var tab = "_1jypr342";
+var tabList = "_1jypr341";
+var tabPanel = "_1jypr343";
+var tabPanels = "_1jypr344";
+var tabs = "_1jypr340";
+//#endregion
+//#region src/ui/components/Tabs.tsx
+const TabsContext = createContext(null);
+const AUTO_TAB_PREFIX = "__ardo-tab-";
+function useTabsContext() {
+	const context = use(TabsContext);
+	if (!context) throw new Error("Tab components must be used within an ArdoTabs component");
+	return context;
+}
+/**
+* Tabs container component for organizing content into tabbed panels.
+*/
+function ArdoTabs({ defaultValue, children }) {
+	const [activeTab, setActiveTab] = useState(() => defaultValue ?? findFirstTabValue(children));
+	const tabIndexRef = useRef(0);
+	const panelIndexRef = useRef(0);
+	tabIndexRef.current = 0;
+	panelIndexRef.current = 0;
+	const getTabValue = (value) => {
+		const index = tabIndexRef.current++;
+		return value ?? `${AUTO_TAB_PREFIX}${index}`;
+	};
+	const getPanelValue = (value) => {
+		const index = panelIndexRef.current++;
+		return value ?? `${AUTO_TAB_PREFIX}${index}`;
+	};
+	const effectiveTab = defaultValue ?? activeTab;
+	return /* @__PURE__ */ jsx(TabsContext, {
+		value: useMemo(() => ({
+			activeTab: effectiveTab,
+			setActiveTab,
+			getTabValue,
+			getPanelValue
+		}), [effectiveTab]),
+		children: /* @__PURE__ */ jsx("div", {
+			className: tabs,
+			children
+		})
+	});
+}
+/**
+* Container for ArdoTab buttons.
+*/
+function ArdoTabList({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: tabList,
+		role: "tablist",
+		children
+	});
+}
+/**
+* Individual tab button.
+*/
+function ArdoTab({ value, children }) {
+	const { activeTab, setActiveTab, getTabValue } = useTabsContext();
+	const resolvedValue = getTabValue(value);
+	const isActive = activeTab === resolvedValue;
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		role: "tab",
+		"aria-selected": isActive,
+		className: [tab, isActive && "active"].filter(Boolean).join(" "),
+		onClick: () => {
+			setActiveTab(resolvedValue);
+		},
+		children
+	});
+}
+/**
+* Content panel for a tab.
+*/
+function ArdoTabPanel({ value, children }) {
+	const { activeTab, getPanelValue } = useTabsContext();
+	if (!(activeTab === getPanelValue(value))) return null;
+	return /* @__PURE__ */ jsx("div", {
+		role: "tabpanel",
+		className: tabPanel,
+		children
+	});
+}
+/**
+* Container for ArdoTabPanel components.
+*/
+function ArdoTabPanels({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: tabPanels,
+		children
+	});
+}
+function findFirstTabValue(children) {
+	for (const child of Children.toArray(children)) {
+		if (!isValidElement(child)) continue;
+		if (child.type === ArdoTab) return child.props.value ?? `${AUTO_TAB_PREFIX}0`;
+		const nestedChildren = child.props.children;
+		if (nestedChildren != null) {
+			const nestedValue = findFirstTabValue(nestedChildren);
+			if (nestedValue) return nestedValue;
+		}
+	}
+	return "";
+}
+//#endregion
+//#region src/ui/Breadcrumb.css.ts
+var breadcrumb = "_19g8fxh0";
+var breadcrumbCurrent = "_19g8fxh2";
+//#endregion
+//#region src/ui/Breadcrumb.tsx
+function matchInChildren(groupText, items, path) {
+	for (const item of items) {
+		if (item.link === path) return {
+			section: groupText,
+			page: item.text
+		};
+		if (item.items != null) {
+			const sub = item.items.find((s) => s.link === path);
+			if (sub != null) return {
+				section: groupText,
+				page: sub.text
+			};
+		}
+	}
+}
+function findBreadcrumb(sidebar, currentPath) {
+	for (const group of sidebar) {
+		if (group.link === currentPath) return { page: group.text };
+		if (group.items != null) {
+			const found = matchInChildren(group.text, group.items, currentPath);
+			if (found != null) return found;
+		}
+	}
+	return {};
+}
+function ArdoBreadcrumb() {
+	const { section, page } = findBreadcrumb(useArdoSidebar(), useLocation().pathname);
+	if (page == null || page === "") return null;
+	return /* @__PURE__ */ jsxs("nav", {
+		className: breadcrumb,
+		"aria-label": "Breadcrumb",
+		children: [section != null && section !== "" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", { children: section }), /* @__PURE__ */ jsx("span", {
+			className: "_19g8fxh1",
+			"aria-hidden": true,
+			children: "›"
+		})] }), /* @__PURE__ */ jsx("span", {
+			className: breadcrumbCurrent,
+			children: page
+		})]
+	});
+}
+//#endregion
+//#region src/ui/content.css.ts
+var ardoContent = "jmxrtm0";
+//#endregion
+//#region src/ui/DocPage.css.ts
+var contentBody = "_1f1m4jr5";
+var contentContainer = "_1f1m4jr1";
+var contentHeader = "_1f1m4jr2";
+var contentTitle = "_1f1m4jr3";
+var docPage = "_1f1m4jr0";
+//#endregion
+//#region src/ui/Content.tsx
+function resolveEditLink(input) {
+	const resolved = input.editLink ?? input.siteConfig.editLink;
+	const pattern = resolved?.pattern ?? "";
+	const relativePath = input.pageData?.relativePath ?? "";
+	const show = input.pageData?.frontmatter.editLink !== false && pattern !== "" && input.pageData !== void 0;
+	return {
+		href: show ? pattern.replace(":path", relativePath) : void 0,
+		text: resolved?.text ?? "Edit this page",
+		show
+	};
+}
+function resolveLastUpdated(input) {
+	const resolved = input.lastUpdated ?? input.siteConfig.lastUpdated;
+	const value = input.pageData?.lastUpdated;
+	const show = input.pageData?.frontmatter.lastUpdated !== false && resolved?.enabled === true && typeof value === "number";
+	const formatOptions = resolved?.formatOptions ?? {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	};
+	return {
+		label: resolved?.text ?? "Last updated",
+		text: show ? new Date(value).toLocaleDateString(void 0, formatOptions) : void 0,
+		show
+	};
+}
+function ArdoContent({ children, editLink, lastUpdated }) {
+	const isBare = useBareContent();
+	const pageData = useArdoPageData();
+	const siteConfig = useArdoSiteConfig();
+	const sidebar = useArdoSidebar();
+	const location = useLocation();
+	if (isBare) return /* @__PURE__ */ jsx("div", {
+		className: `${contentBody} ${ardoContent}`,
+		children
+	});
+	const input = {
+		pageData,
+		editLink,
+		lastUpdated,
+		siteConfig
+	};
+	const edit = resolveEditLink(input);
+	const updated = resolveLastUpdated(input);
+	const { prev, next } = getPrevNextLinks(sidebar, location.pathname);
+	return /* @__PURE__ */ jsxs("article", {
+		className: contentContainer,
+		children: [
+			/* @__PURE__ */ jsx(ArdoBreadcrumb, {}),
+			/* @__PURE__ */ jsx(ContentHeader, {
+				title: pageData?.frontmatter.title ?? "",
+				description: pageData?.frontmatter.description ?? ""
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: `${contentBody} ${ardoContent}`,
+				children
+			}),
+			/* @__PURE__ */ jsx(ContentMeta, {
+				edit,
+				updated
+			}),
+			/* @__PURE__ */ jsx(ContentPrevNext, {
+				prev,
+				next
+			})
+		]
+	});
+}
+function ContentHeader({ title, description }) {
+	if (title === "") return null;
+	return /* @__PURE__ */ jsxs("header", {
+		className: contentHeader,
+		children: [/* @__PURE__ */ jsx("h1", {
+			className: contentTitle,
+			children: title
+		}), description !== "" && /* @__PURE__ */ jsx("p", {
+			className: "_1f1m4jr4",
+			children: description
+		})]
+	});
+}
+function ContentMeta({ edit, updated }) {
+	if (!edit.show && !updated.show) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: contentMeta,
+		children: [edit.show && /* @__PURE__ */ jsx("a", {
+			href: edit.href,
+			target: "_blank",
+			rel: "noopener noreferrer",
+			className: "_169q00ba",
+			children: edit.text
+		}), updated.show && /* @__PURE__ */ jsxs("span", { children: [
+			updated.label,
+			": ",
+			updated.text
+		] })]
+	});
+}
+function ContentPrevNext({ prev, next }) {
+	const prevLink$1 = prev?.link ?? "";
+	const nextLink$1 = next?.link ?? "";
+	const hasPrev = prevLink$1 !== "";
+	const hasNext = nextLink$1 !== "";
+	if (!hasPrev && !hasNext) return null;
+	return /* @__PURE__ */ jsxs("nav", {
+		className: prevNext,
+		"aria-label": "Page navigation",
+		children: [hasPrev ? /* @__PURE__ */ jsxs(Link, {
+			to: prevLink$1,
+			className: prevLink,
+			children: [/* @__PURE__ */ jsx("span", {
+				className: prevNextLabel,
+				children: "Previous"
+			}), /* @__PURE__ */ jsx("span", {
+				className: prevNextTitle,
+				children: prev?.text
+			})]
+		}) : /* @__PURE__ */ jsx("div", {}), hasNext ? /* @__PURE__ */ jsxs(Link, {
+			to: nextLink$1,
+			className: nextLink,
+			children: [/* @__PURE__ */ jsx("span", {
+				className: prevNextLabel,
+				children: "Next"
+			}), /* @__PURE__ */ jsx("span", {
+				className: prevNextTitle,
+				children: next?.text
+			})]
+		}) : /* @__PURE__ */ jsx("div", {})]
+	});
+}
+//#endregion
+//#region src/ui/TOC.css.ts
+var toc = "_1trko900";
+var tocLink = "_1trko903";
+var tocList = "_1trko902";
+var tocTitle = "_1trko901";
+//#endregion
+//#region src/ui/TOC.tsx
+function ArdoTOC({ label: labelProp } = {}) {
+	const toc$1 = useArdoTOC();
+	const siteConfig = useArdoSiteConfig();
+	const [activeId, setActiveId] = useState("");
+	const scrollContainerRef = useRef(null);
+	const isClickScrolling = useRef(false);
+	const label = labelProp ?? siteConfig.tocLabel ?? "On this page";
+	useEffect(() => {
+		scrollContainerRef.current = document.getElementById("main-content");
+	}, []);
+	useEffect(() => {
+		if (toc$1.length === 0) return;
+		const scrollContainer = scrollContainerRef.current;
+		if (!scrollContainer) return;
+		const headingElements = toc$1.map((item) => document.getElementById(item.id)).filter(Boolean);
+		if (headingElements.length === 0) return;
+		const observer = new IntersectionObserver((entries) => {
+			if (isClickScrolling.current) return;
+			for (const entry of entries) if (entry.isIntersecting) {
+				setActiveId(entry.target.id);
+				break;
+			}
+		}, {
+			root: scrollContainer,
+			rootMargin: "-20px 0px -85% 0px",
+			threshold: 0
+		});
+		for (const element of headingElements) if (element !== null) observer.observe(element);
+		return () => {
+			for (const element of headingElements) if (element !== null) observer.unobserve(element);
+		};
+	}, [toc$1]);
+	const handleClickItem = (id) => {
+		setActiveId(id);
+		isClickScrolling.current = true;
+		const element = document.getElementById(id);
+		const container = scrollContainerRef.current;
+		if (element) {
+			element.scrollIntoView({
+				behavior: "smooth",
+				block: "start"
+			});
+			globalThis.history.pushState(null, "", `#${id}`);
+		}
+		if (container) {
+			const onScrollEnd = () => {
+				isClickScrolling.current = false;
+				container.removeEventListener("scrollend", onScrollEnd);
+			};
+			container.addEventListener("scrollend", onScrollEnd, { once: true });
+			setTimeout(() => {
+				isClickScrolling.current = false;
+			}, 1e3);
+		} else isClickScrolling.current = false;
+	};
+	if (toc$1.length === 0) return null;
+	return /* @__PURE__ */ jsx("aside", {
+		className: toc,
+		children: /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", {
+			className: tocTitle,
+			children: label
+		}), /* @__PURE__ */ jsx("nav", {
+			"aria-label": "Table of contents",
+			children: /* @__PURE__ */ jsx(TOCItems, {
+				items: toc$1,
+				activeId,
+				onClickItem: handleClickItem
+			})
+		})] })
+	});
+}
+function TOCItems({ items, activeId, onClickItem }) {
+	return /* @__PURE__ */ jsx("ul", {
+		className: tocList,
+		children: items.map((item) => /* @__PURE__ */ jsx(TOCItemComponent, {
+			item,
+			activeId,
+			onClickItem
+		}, item.id))
+	});
+}
+function TOCItemComponent({ item, activeId, onClickItem }) {
+	const isActive = item.id === activeId;
+	const hasActiveChild = hasActiveDescendant(item, activeId);
+	return /* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("a", {
+		href: `#${item.id}`,
+		className: [
+			tocLink,
+			item.level === 3 && "_1trko904",
+			item.level === 4 && "_1trko905",
+			isActive && "active",
+			hasActiveChild && "child-active"
+		].filter(Boolean).join(" "),
+		onClick: (e) => {
+			e.preventDefault();
+			onClickItem(item.id);
+		},
+		children: item.text
+	}), item.children && item.children.length > 0 && /* @__PURE__ */ jsx(TOCItems, {
+		items: item.children,
+		activeId,
+		onClickItem
+	})] });
+}
+function hasActiveDescendant(item, activeId) {
+	if (!item.children) return false;
+	for (const child of item.children) {
+		if (child.id === activeId) return true;
+		if (hasActiveDescendant(child, activeId)) return true;
+	}
+	return false;
+}
+//#endregion
+//#region src/ui/DocPage.tsx
+/**
+* Full documentation page with Layout wrapper.
+* Use this when you don't have a _layout.tsx file.
+*
+* @example
+* ```tsx
+* <DocPage>
+*   <Content />
+* </DocPage>
+* ```
+*/
+function ArdoDocPage({ children, editLink, lastUpdated, tocLabel }) {
+	const hideToc = useArdoPageData()?.frontmatter.outline === false;
+	return /* @__PURE__ */ jsx(ArdoLayout, { children: /* @__PURE__ */ jsxs("div", {
+		className: docPage,
+		children: [/* @__PURE__ */ jsx(ArdoContent, {
+			editLink,
+			lastUpdated,
+			children
+		}), !hideToc && /* @__PURE__ */ jsx(ArdoTOC, { label: tocLabel })]
+	}) });
+}
+/**
+* Documentation content without Layout wrapper.
+* Use this when you have a _layout.tsx that provides the Layout.
+*
+* @example
+* ```tsx
+* // In _layout.tsx:
+* <Layout>
+*   <Header ... />
+*   <Sidebar ... />
+*   <Outlet />
+*   <Footer ... />
+* </Layout>
+*
+* // In page routes:
+* <DocContent>
+*   <MarkdownContent />
+* </DocContent>
+* ```
+*/
+function ArdoDocContent({ children, editLink, lastUpdated, tocLabel }) {
+	const hideToc = useArdoPageData()?.frontmatter.outline === false;
+	return /* @__PURE__ */ jsxs("div", {
+		className: docPage,
+		children: [/* @__PURE__ */ jsx(ArdoContent, {
+			editLink,
+			lastUpdated,
+			children
+		}), !hideToc && /* @__PURE__ */ jsx(ArdoTOC, { label: tocLabel })]
+	});
+}
+/**
+* @deprecated Use DocPage or DocContent instead
+*/
+function ArdoDocLayout({ content }) {
+	return /* @__PURE__ */ jsx(ArdoDocPage, { children: content });
+}
+//#endregion
+export { home as A, footerSeparator as B, ArdoCopyButton as C, ArdoBareContent as D, codeWrapper as E, footerContainer as F, MonitorIcon as G, GithubIcon as H, footerCopyright as I, SearchIcon as J, MoonIcon as K, footerLink as L, layout as M, footer as N, ArdoLayout as O, footerBuildTime as P, YoutubeIcon as Q, footerMessage as R, ArdoCodeGroup as S, codeTitle as T, LinkedinIcon as U, ChevronDownIcon as V, MessageCircleIcon as W, TwitterIcon as X, SunIcon as Y, XIcon as Z, ArdoInfo as _, ArdoContent as a, ArdoWarning as b, ArdoTabPanel as c, ArdoSteps as d, ArdoIcon as f, ArdoDanger as g, ArdoContainer as h, ArdoTOC as i, homeMain as j, ArdoRootLayout as k, ArdoTabPanels as l, registerIcons as m, ArdoDocLayout as n, ArdoTab as o, getRegisteredIconNames as p, PackageIcon as q, ArdoDocPage as r, ArdoTabList as s, ArdoDocContent as t, ArdoTabs as u, ArdoNote as v, codeBlock as w, ArdoCodeBlock as x, ArdoTip as y, footerPrimary as z };
+
+//# sourceMappingURL=DocPage-BVibJR9O.js.map