@vx-oss/docs-react 1.0.3

package/dist/layouts/shared/page-actions.js

@@ -0,0 +1,199 @@
+"use client";
+import { cn } from "../../utils/cn.js";
+import { buttonVariants } from "../../components/ui/button.js";
+import { useCopyButton } from "../../utils/use-copy-button.js";
+import { Popover, PopoverContent, PopoverTrigger } from "../../components/ui/popover.js";
+import { usePathname } from "@vx-oss/docs-core/framework";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Check, ChevronDown, Copy, ExternalLinkIcon, TextIcon } from "lucide-react";
+import { useMemo, useState } from "react";
+import { useTranslations } from "@fuma-translate/react";
+//#region src/layouts/shared/page-actions.tsx
+const cache = /* @__PURE__ */ new Map();
+/**
+* see https://fumadocs.dev/docs/integrations/llms#page-actions to customize.
+*/
+function MarkdownCopyButton({ markdownUrl, ...props }) {
+	const t = useTranslations({ note: "page actions" });
+	const [isLoading, setLoading] = useState(false);
+	const [checked, onClick] = useCopyButton(async () => {
+		const cached = cache.get(markdownUrl);
+		if (cached) return navigator.clipboard.writeText(await cached);
+		setLoading(true);
+		try {
+			const promise = fetch(withBasePath(markdownUrl)).then((res) => res.text());
+			cache.set(markdownUrl, promise);
+			await navigator.clipboard.write([new ClipboardItem({ "text/plain": promise })]);
+		} finally {
+			setLoading(false);
+		}
+	});
+	return /* @__PURE__ */ jsxs("button", {
+		disabled: isLoading,
+		onClick,
+		...props,
+		className: cn(buttonVariants({
+			color: "secondary",
+			size: "sm",
+			className: "gap-2 [&_svg]:size-3.5 [&_svg]:text-fd-muted-foreground"
+		}), props.className),
+		children: [checked ? /* @__PURE__ */ jsx(Check, {}) : /* @__PURE__ */ jsx(Copy, {}), props.children ?? t("Copy Markdown")]
+	});
+}
+/**
+* see https://fumadocs.dev/docs/integrations/llms#page-actions to customize.
+*/
+function ViewOptionsPopover({ markdownUrl, githubUrl, ...props }) {
+	const pathname = usePathname();
+	const t = useTranslations({ note: "page actions" });
+	const items = useMemo(() => {
+		const pageUrl = typeof window === "undefined" ? pathname : new URL(pathname, window.location.origin);
+		const q = t("Read {url}, I want to ask questions about it.", { variables: { url: String(pageUrl) } });
+		return [
+			githubUrl && {
+				title: t("Open in GitHub"),
+				href: githubUrl,
+				icon: /* @__PURE__ */ jsxs("svg", {
+					fill: "currentColor",
+					role: "img",
+					viewBox: "0 0 24 24",
+					children: [/* @__PURE__ */ jsx("title", { children: "GitHub" }), /* @__PURE__ */ jsx("path", { d: "M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" })]
+				})
+			},
+			markdownUrl && {
+				title: t("View as Markdown"),
+				href: withBasePath(markdownUrl),
+				icon: /* @__PURE__ */ jsx(TextIcon, {})
+			},
+			{
+				title: t("Open in Scira AI"),
+				href: `https://scira.ai/?${new URLSearchParams({ q })}`,
+				icon: /* @__PURE__ */ jsxs("svg", {
+					width: "910",
+					height: "934",
+					viewBox: "0 0 910 934",
+					fill: "none",
+					xmlns: "http://www.w3.org/2000/svg",
+					children: [
+						/* @__PURE__ */ jsx("title", { children: "Scira AI" }),
+						/* @__PURE__ */ jsx("path", {
+							d: "M647.664 197.775C569.13 189.049 525.5 145.419 516.774 66.8849C508.048 145.419 464.418 189.049 385.884 197.775C464.418 206.501 508.048 250.131 516.774 328.665C525.5 250.131 569.13 206.501 647.664 197.775Z",
+							fill: "currentColor",
+							stroke: "currentColor",
+							strokeWidth: "8",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M516.774 304.217C510.299 275.491 498.208 252.087 480.335 234.214C462.462 216.341 439.058 204.251 410.333 197.775C439.059 191.3 462.462 179.209 480.335 161.336C498.208 143.463 510.299 120.06 516.774 91.334C523.25 120.059 535.34 143.463 553.213 161.336C571.086 179.209 594.49 191.3 623.216 197.775C594.49 204.251 571.086 216.341 553.213 234.214C535.34 252.087 523.25 275.491 516.774 304.217Z",
+							fill: "currentColor",
+							stroke: "currentColor",
+							strokeWidth: "8",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M857.5 508.116C763.259 497.644 710.903 445.288 700.432 351.047C689.961 445.288 637.605 497.644 543.364 508.116C637.605 518.587 689.961 570.943 700.432 665.184C710.903 570.943 763.259 518.587 857.5 508.116Z",
+							stroke: "currentColor",
+							strokeWidth: "20",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M700.432 615.957C691.848 589.05 678.575 566.357 660.383 548.165C642.191 529.973 619.499 516.7 592.593 508.116C619.499 499.533 642.191 486.258 660.383 468.066C678.575 449.874 691.848 427.181 700.432 400.274C709.015 427.181 722.289 449.874 740.481 468.066C758.673 486.258 781.365 499.533 808.271 508.116C781.365 516.7 758.673 529.973 740.481 548.165C722.289 566.357 709.015 589.05 700.432 615.957Z",
+							stroke: "currentColor",
+							strokeWidth: "20",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M889.949 121.237C831.049 114.692 798.326 81.9698 791.782 23.0692C785.237 81.9698 752.515 114.692 693.614 121.237C752.515 127.781 785.237 160.504 791.782 219.404C798.326 160.504 831.049 127.781 889.949 121.237Z",
+							fill: "currentColor",
+							stroke: "currentColor",
+							strokeWidth: "8",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M791.782 196.795C786.697 176.937 777.869 160.567 765.16 147.858C752.452 135.15 736.082 126.322 716.226 121.237C736.082 116.152 752.452 107.324 765.16 94.6152C777.869 81.9065 786.697 65.5368 791.782 45.6797C796.867 65.5367 805.695 81.9066 818.403 94.6152C831.112 107.324 847.481 116.152 867.338 121.237C847.481 126.322 831.112 135.15 818.403 147.858C805.694 160.567 796.867 176.937 791.782 196.795Z",
+							fill: "currentColor",
+							stroke: "currentColor",
+							strokeWidth: "8",
+							strokeLinejoin: "round"
+						}),
+						/* @__PURE__ */ jsx("path", {
+							d: "M760.632 764.337C720.719 814.616 669.835 855.1 611.872 882.692C553.91 910.285 490.404 924.255 426.213 923.533C362.022 922.812 298.846 907.419 241.518 878.531C184.19 849.643 134.228 808.026 95.4548 756.863C56.6815 705.7 30.1238 646.346 17.8129 583.343C5.50207 520.339 7.76433 455.354 24.4266 393.359C41.089 331.364 71.7099 274.001 113.947 225.658C156.184 177.315 208.919 139.273 268.117 114.442",
+							stroke: "currentColor",
+							strokeWidth: "30",
+							strokeLinecap: "round",
+							strokeLinejoin: "round"
+						})
+					]
+				})
+			},
+			{
+				title: t("Open in ChatGPT"),
+				href: `https://chatgpt.com/?${new URLSearchParams({
+					prompt: q,
+					hints: "search"
+				})}`,
+				icon: /* @__PURE__ */ jsxs("svg", {
+					role: "img",
+					viewBox: "0 0 24 24",
+					fill: "currentColor",
+					xmlns: "http://www.w3.org/2000/svg",
+					children: [/* @__PURE__ */ jsx("title", { children: "OpenAI" }), /* @__PURE__ */ jsx("path", { d: "M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z" })]
+				})
+			},
+			{
+				title: t("Open in Claude"),
+				href: `https://claude.ai/new?${new URLSearchParams({ q })}`,
+				icon: /* @__PURE__ */ jsxs("svg", {
+					fill: "currentColor",
+					role: "img",
+					viewBox: "0 0 24 24",
+					xmlns: "http://www.w3.org/2000/svg",
+					children: [/* @__PURE__ */ jsx("title", { children: "Anthropic" }), /* @__PURE__ */ jsx("path", { d: "M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z" })]
+				})
+			},
+			{
+				title: t("Open in Cursor"),
+				icon: /* @__PURE__ */ jsxs("svg", {
+					fill: "currentColor",
+					role: "img",
+					viewBox: "0 0 24 24",
+					xmlns: "http://www.w3.org/2000/svg",
+					children: [/* @__PURE__ */ jsx("title", { children: "Cursor" }), /* @__PURE__ */ jsx("path", { d: "M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23" })]
+				}),
+				href: `https://cursor.com/link/prompt?${new URLSearchParams({ text: q })}`
+			}
+		].filter((v) => !!v);
+	}, [
+		githubUrl,
+		markdownUrl,
+		pathname,
+		t
+	]);
+	return /* @__PURE__ */ jsxs(Popover, { children: [/* @__PURE__ */ jsxs(PopoverTrigger, {
+		...props,
+		className: cn(buttonVariants({
+			color: "secondary",
+			size: "sm"
+		}), "gap-2 data-[state=open]:bg-fd-accent data-[state=open]:text-fd-accent-foreground", props.className),
+		children: [props.children ?? t("Open"), /* @__PURE__ */ jsx(ChevronDown, { className: "size-3.5 text-fd-muted-foreground" })]
+	}), /* @__PURE__ */ jsx(PopoverContent, {
+		className: "flex flex-col",
+		children: items.map((item) => /* @__PURE__ */ jsxs("a", {
+			href: item.href,
+			rel: "noreferrer noopener",
+			target: "_blank",
+			className: "text-sm p-2 rounded-lg inline-flex items-center gap-2 hover:text-fd-accent-foreground hover:bg-fd-accent [&_svg]:size-4",
+			children: [
+				item.icon,
+				item.title,
+				/* @__PURE__ */ jsx(ExternalLinkIcon, { className: "text-fd-muted-foreground size-3.5 ms-auto" })
+			]
+		}, item.href))
+	})] });
+}
+function withBasePath(href) {
+	if (href.match(/^\w+:/) || href.startsWith("//")) return href;
+	return (typeof import.meta.env !== "undefined" && typeof import.meta.env.BASE_URL === "string" ? import.meta.env.BASE_URL.replace(/\/$/, "") : "") + href;
+}
+//#endregion
+export { MarkdownCopyButton, ViewOptionsPopover };

package/dist/layouts/shared/slots/language-select.d.ts

@@ -0,0 +1,12 @@
+import { buttonVariants } from "../../../components/ui/button.js";
+import { VariantProps } from "class-variance-authority";
+import { ComponentProps } from "react";
+//#region src/layouts/shared/slots/language-select.d.ts
+interface LanguageSelectProps extends ComponentProps<'button'> {
+  variant?: VariantProps<typeof buttonVariants>['variant'];
+}
+declare function LanguageSelect({ className, variant, children, ...rest }: LanguageSelectProps): React.ReactElement;
+type LanguageSelectTextProps = ComponentProps<'span'>;
+declare function LanguageSelectText(props: LanguageSelectTextProps): import("react").JSX.Element;
+//#endregion
+export { LanguageSelect, LanguageSelectProps, LanguageSelectText, LanguageSelectTextProps };

package/dist/layouts/shared/slots/language-select.js

@@ -0,0 +1,43 @@
+"use client";
+import { cn } from "../../../utils/cn.js";
+import { buttonVariants } from "../../../components/ui/button.js";
+import { useI18n } from "../../../contexts/i18n.js";
+import { Popover, PopoverContent, PopoverTrigger } from "../../../components/ui/popover.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useTranslations } from "@fuma-translate/react";
+//#region src/layouts/shared/slots/language-select.tsx
+function LanguageSelect({ className, variant = "ghost", children, ...rest }) {
+	const context = useI18n();
+	const t = useTranslations({ note: "language switcher" });
+	if (!context.locales) throw new Error("Missing `<I18nProvider />`");
+	const chooseLanguage = t("Choose a language");
+	return /* @__PURE__ */ jsxs(Popover, { children: [/* @__PURE__ */ jsx(PopoverTrigger, {
+		"aria-label": t("Choose a language", { note: "aria-label" }),
+		className: cn(buttonVariants({ variant }), "gap-1.5 p-1.5 data-[state=open]:bg-fd-accent", className),
+		...rest,
+		children
+	}), /* @__PURE__ */ jsxs(PopoverContent, {
+		className: "flex flex-col gap-0.5 p-1",
+		children: [/* @__PURE__ */ jsx("p", {
+			className: "p-2 text-xs font-medium text-fd-muted-foreground",
+			children: chooseLanguage
+		}), context.locales.map((item) => /* @__PURE__ */ jsx("button", {
+			type: "button",
+			className: cn("px-2 py-1.5 text-start text-sm rounded-lg transition-colors", item.locale === context.locale ? "bg-fd-primary/10 text-fd-primary" : "text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground"),
+			onClick: () => {
+				context.onChange?.(item.locale);
+			},
+			children: item.name
+		}, item.locale))]
+	})] });
+}
+function LanguageSelectText(props) {
+	const { locales, locale } = useI18n();
+	const text = locales?.find((item) => item.locale === locale)?.name;
+	return /* @__PURE__ */ jsx("span", {
+		...props,
+		children: text
+	});
+}
+//#endregion
+export { LanguageSelect, LanguageSelectText };

package/dist/layouts/shared/slots/search-trigger.d.ts

@@ -0,0 +1,13 @@
+import { ButtonProps } from "../../../components/ui/button.js";
+import { ComponentProps } from "react";
+//#region src/layouts/shared/slots/search-trigger.d.ts
+interface SearchTriggerProps extends Omit<ComponentProps<'button'>, 'color'>, ButtonProps {
+  hideIfDisabled?: boolean;
+}
+declare function SearchTrigger({ hideIfDisabled, size, color, ...props }: SearchTriggerProps): import("react").JSX.Element | null;
+interface FullSearchTriggerProps extends ComponentProps<'button'> {
+  hideIfDisabled?: boolean;
+}
+declare function FullSearchTrigger({ hideIfDisabled, ...props }: FullSearchTriggerProps): import("react").JSX.Element | null;
+//#endregion
+export { FullSearchTrigger, FullSearchTriggerProps, SearchTrigger, SearchTriggerProps };

package/dist/layouts/shared/slots/search-trigger.js

@@ -0,0 +1,53 @@
+"use client";
+import { cn } from "../../../utils/cn.js";
+import { buttonVariants } from "../../../components/ui/button.js";
+import { useSearchContext } from "../../../contexts/search.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Search } from "lucide-react";
+import { useTranslations } from "@fuma-translate/react";
+//#region src/layouts/shared/slots/search-trigger.tsx
+function SearchTrigger({ hideIfDisabled, size = "icon-sm", color = "ghost", ...props }) {
+	const { setOpenSearch, enabled } = useSearchContext();
+	const t = useTranslations({ note: "search trigger" });
+	if (hideIfDisabled && !enabled) return null;
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		className: cn(buttonVariants({
+			size,
+			color
+		}), props.className),
+		"data-search": "",
+		"aria-label": t("Open Search", { note: "aria-label" }),
+		onClick: () => {
+			setOpenSearch(true);
+		},
+		children: /* @__PURE__ */ jsx(Search, {})
+	});
+}
+function FullSearchTrigger({ hideIfDisabled, ...props }) {
+	const { enabled, hotKey, setOpenSearch } = useSearchContext();
+	const t = useTranslations({ note: "search trigger" });
+	if (hideIfDisabled && !enabled) return null;
+	return /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		"data-search-full": "",
+		...props,
+		className: cn("inline-flex items-center gap-2 rounded-lg border bg-fd-secondary/50 p-1.5 ps-2 text-sm text-fd-muted-foreground transition-colors hover:bg-fd-accent hover:text-fd-accent-foreground", props.className),
+		onClick: () => {
+			setOpenSearch(true);
+		},
+		children: [
+			/* @__PURE__ */ jsx(Search, { className: "size-4" }),
+			t("Search"),
+			/* @__PURE__ */ jsx("div", {
+				className: "ms-auto inline-flex gap-0.5",
+				children: hotKey.map((k, i) => /* @__PURE__ */ jsx("kbd", {
+					className: "rounded-md border bg-fd-background px-1.5",
+					children: k.display
+				}, i))
+			})
+		]
+	});
+}
+//#endregion
+export { FullSearchTrigger, SearchTrigger };

package/dist/layouts/shared/slots/theme-switch.d.ts

@@ -0,0 +1,8 @@
+import { ComponentProps } from "react";
+//#region src/layouts/shared/slots/theme-switch.d.ts
+interface ThemeSwitchProps extends ComponentProps<'div'> {
+  mode?: 'light-dark' | 'light-dark-system';
+}
+declare function ThemeSwitch({ className, mode, ...props }: ThemeSwitchProps): import("react").JSX.Element;
+//#endregion
+export { ThemeSwitch, ThemeSwitchProps };

package/dist/layouts/shared/slots/theme-switch.js

@@ -0,0 +1,70 @@
+"use client";
+import { cn } from "../../../utils/cn.js";
+import { jsx } from "react/jsx-runtime";
+import { Airplay, Moon, Sun } from "lucide-react";
+import { cva } from "class-variance-authority";
+import { useEffect, useState } from "react";
+import { useTranslations } from "@fuma-translate/react";
+import { useTheme } from "next-themes";
+import { flushSync } from "react-dom";
+//#region src/layouts/shared/slots/theme-switch.tsx
+const itemVariants = cva("size-6.5 p-1.5 text-fd-muted-foreground", { variants: { active: {
+	true: "bg-fd-accent text-fd-accent-foreground",
+	false: "text-fd-muted-foreground"
+} } });
+const full = [
+	["light", Sun],
+	["dark", Moon],
+	["system", Airplay]
+];
+function ThemeSwitch({ className, mode = "light-dark", ...props }) {
+	const { setTheme, theme, resolvedTheme } = useTheme();
+	const [mounted, setMounted] = useState(false);
+	const t = useTranslations({ note: "theme switcher" });
+	const themeAriaLabels = {
+		light: t("Light", { note: "aria-label" }),
+		dark: t("Dark", { note: "aria-label" }),
+		system: t("System", { note: "aria-label" })
+	};
+	const handleThemeChange = (newTheme) => {
+		if (document?.startViewTransition) document.startViewTransition(() => flushSync(() => setTheme(newTheme)));
+		else setTheme(newTheme);
+	};
+	useEffect(() => {
+		setMounted(true);
+	}, []);
+	const container = cn("inline-flex items-center rounded-full border p-1 overflow-hidden *:rounded-full", className);
+	if (mode === "light-dark") {
+		const value = mounted ? resolvedTheme : null;
+		return /* @__PURE__ */ jsx("button", {
+			className: container,
+			"aria-label": t("Toggle Theme", { note: "aria-label" }),
+			onClick: () => handleThemeChange(value === "light" ? "dark" : "light"),
+			"data-theme-toggle": "",
+			children: full.map(([key, Icon]) => {
+				if (key === "system") return;
+				return /* @__PURE__ */ jsx(Icon, {
+					fill: "currentColor",
+					className: cn(itemVariants({ active: value === key }))
+				}, key);
+			})
+		});
+	}
+	const value = mounted ? theme : null;
+	return /* @__PURE__ */ jsx("div", {
+		className: container,
+		"data-theme-toggle": "",
+		...props,
+		children: full.map(([key, Icon]) => /* @__PURE__ */ jsx("button", {
+			"aria-label": themeAriaLabels[key],
+			className: cn(itemVariants({ active: value === key })),
+			onClick: () => handleThemeChange(key),
+			children: /* @__PURE__ */ jsx(Icon, {
+				className: "size-full",
+				fill: "currentColor"
+			})
+		}, key))
+	});
+}
+//#endregion
+export { ThemeSwitch };

package/dist/legacy/layout.d.ts

@@ -0,0 +1,29 @@
+import { ReactNode } from "react";
+//#region src/legacy/layout.d.ts
+interface PageStyles {
+  tocNav?: string;
+  toc?: string;
+  page?: string;
+  article?: string;
+}
+declare function usePageStyles(): PageStyles;
+declare function StylesProvider({ children, ...value }: PageStyles & {
+  children: ReactNode;
+}): import("react").JSX.Element;
+interface NavProviderProps {
+  /**
+   * Use transparent background
+   *
+   * @defaultValue none
+   */
+  transparentMode?: 'always' | 'top' | 'none';
+}
+interface NavContextType {
+  isTransparent: boolean;
+}
+declare function NavProvider({ transparentMode, children }: NavProviderProps & {
+  children: ReactNode;
+}): import("react").JSX.Element;
+declare function useNav(): NavContextType;
+//#endregion
+export { NavProvider, NavProviderProps, PageStyles, StylesProvider, useNav, usePageStyles };

package/dist/legacy/layout.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { createContext, use, useEffect, useMemo, useState } from "react";
+//#region src/legacy/layout.tsx
+/**
+* applied styles to different layout components in `Page` from layouts
+*/
+const StylesContext = createContext({
+	tocNav: "xl:hidden",
+	toc: "max-xl:hidden"
+});
+function usePageStyles() {
+	return use(StylesContext);
+}
+function StylesProvider({ children, ...value }) {
+	return /* @__PURE__ */ jsx(StylesContext.Provider, {
+		value,
+		children
+	});
+}
+const NavContext = createContext({ isTransparent: false });
+function NavProvider({ transparentMode = "none", children }) {
+	const [transparent, setTransparent] = useState(transparentMode !== "none");
+	useEffect(() => {
+		if (transparentMode !== "top") return;
+		const listener = () => {
+			setTransparent(window.scrollY < 10);
+		};
+		listener();
+		window.addEventListener("scroll", listener);
+		return () => {
+			window.removeEventListener("scroll", listener);
+		};
+	}, [transparentMode]);
+	return /* @__PURE__ */ jsx(NavContext, {
+		value: useMemo(() => ({ isTransparent: transparent }), [transparent]),
+		children
+	});
+}
+function useNav() {
+	return use(NavContext);
+}
+//#endregion
+export { NavProvider, StylesProvider, useNav, usePageStyles };

package/dist/legacy/sidebar.d.ts

@@ -0,0 +1,14 @@
+import { Dispatch, ReactNode, RefObject, SetStateAction } from "react";
+//#region src/legacy/sidebar.d.ts
+declare function useSidebar(): {
+  open: boolean;
+  setOpen: Dispatch<SetStateAction<boolean>>;
+  collapsed: boolean;
+  setCollapsed: Dispatch<SetStateAction<boolean>>;
+  closeOnRedirect: RefObject<boolean>;
+};
+declare function SidebarProvider({ children }: {
+  children: ReactNode;
+}): import("react").JSX.Element;
+//#endregion
+export { SidebarProvider, useSidebar };

package/dist/legacy/sidebar.js

@@ -0,0 +1,34 @@
+"use client";
+import { usePathname } from "@vx-oss/docs-core/framework";
+import { jsx } from "react/jsx-runtime";
+import { createContext, use, useMemo, useRef, useState } from "react";
+import { useOnChange } from "@vx-oss/docs-core/utils/use-on-change";
+//#region src/legacy/sidebar.tsx
+const SidebarContext = createContext(null);
+function useSidebar() {
+	const ctx = use(SidebarContext);
+	if (!ctx) throw new Error("the component must be wrapped under <SidebarProvider /> (@vx-oss/docs-react/legacy/sidebar)");
+	return ctx;
+}
+function SidebarProvider({ children }) {
+	const [open, setOpen] = useState(false);
+	const [collapsed, setCollapsed] = useState(false);
+	const closeOnRedirect = useRef(true);
+	const pathname = usePathname();
+	useOnChange(pathname, () => {
+		if (closeOnRedirect.current) setOpen(false);
+		else closeOnRedirect.current = true;
+	});
+	return /* @__PURE__ */ jsx(SidebarContext, {
+		value: useMemo(() => ({
+			closeOnRedirect,
+			collapsed,
+			open,
+			setCollapsed,
+			setOpen
+		}), [open, collapsed]),
+		children
+	});
+}
+//#endregion
+export { SidebarProvider, useSidebar };

package/dist/mdx.d.ts

@@ -0,0 +1,44 @@
+import { Callout, CalloutContainer, CalloutDescription, CalloutTitle } from "./components/callout.js";
+import { Card, Cards } from "./components/card.js";
+import { CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger } from "./components/codeblock.js";
+import { createRelativeLink as createRelativeLink$1 } from "./mdx.server.js";
+import React, { AnchorHTMLAttributes, FC, HTMLAttributes, ImgHTMLAttributes, TableHTMLAttributes } from "react";
+//#region src/mdx.d.ts
+/**
+ * global types for MDX.js
+ */
+declare module 'mdx/types.js' {
+  namespace JSX {
+    type Element = React.JSX.Element;
+    type ElementClass = React.JSX.ElementClass;
+    type ElementType = React.JSX.ElementType;
+    type IntrinsicElements = React.JSX.IntrinsicElements;
+  }
+}
+declare function Image(props: ImgHTMLAttributes<HTMLImageElement>): React.JSX.Element;
+declare function Table(props: TableHTMLAttributes<HTMLTableElement>): React.JSX.Element;
+declare const defaultMdxComponents: {
+  CodeBlockTab: typeof CodeBlockTab;
+  CodeBlockTabs: typeof CodeBlockTabs;
+  CodeBlockTabsList: typeof CodeBlockTabsList;
+  CodeBlockTabsTrigger: typeof CodeBlockTabsTrigger;
+  pre: (props: HTMLAttributes<HTMLPreElement>) => React.JSX.Element;
+  Card: typeof Card;
+  Cards: typeof Cards;
+  a: FC<AnchorHTMLAttributes<HTMLAnchorElement>>;
+  img: typeof Image;
+  h1: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  h2: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  h3: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  h4: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  h5: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  h6: (props: HTMLAttributes<HTMLHeadingElement>) => React.JSX.Element;
+  table: typeof Table;
+  Callout: typeof Callout;
+  CalloutContainer: typeof CalloutContainer;
+  CalloutTitle: typeof CalloutTitle;
+  CalloutDescription: typeof CalloutDescription;
+};
+declare const createRelativeLink: typeof createRelativeLink$1;
+//#endregion
+export { createRelativeLink, defaultMdxComponents as default };

package/dist/mdx.js

@@ -0,0 +1,70 @@
+import { cn } from "./utils/cn.js";
+import { Card, Cards } from "./components/card.js";
+import { Callout, CalloutContainer, CalloutDescription, CalloutTitle } from "./components/callout.js";
+import { Heading } from "./components/heading.js";
+import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "./components/codeblock.js";
+import Link from "@vx-oss/docs-core/link";
+import { Image } from "@vx-oss/docs-core/framework";
+import { jsx } from "react/jsx-runtime";
+//#region src/mdx.tsx
+function Image$1(props) {
+	return /* @__PURE__ */ jsx(Image, {
+		sizes: "(max-width: 768px) 100vw, (max-width: 1200px) 70vw, 900px",
+		...props,
+		className: cn("rounded-lg", props.className)
+	});
+}
+function Table(props) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "relative overflow-auto prose-no-margin my-6",
+		children: /* @__PURE__ */ jsx("table", { ...props })
+	});
+}
+const defaultMdxComponents = {
+	CodeBlockTab,
+	CodeBlockTabs,
+	CodeBlockTabsList,
+	CodeBlockTabsTrigger,
+	pre: (props) => /* @__PURE__ */ jsx(CodeBlock, {
+		...props,
+		children: /* @__PURE__ */ jsx(Pre, { children: props.children })
+	}),
+	Card,
+	Cards,
+	a: Link,
+	img: Image$1,
+	h1: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h1",
+		...props
+	}),
+	h2: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h2",
+		...props
+	}),
+	h3: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h3",
+		...props
+	}),
+	h4: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h4",
+		...props
+	}),
+	h5: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h5",
+		...props
+	}),
+	h6: (props) => /* @__PURE__ */ jsx(Heading, {
+		as: "h6",
+		...props
+	}),
+	table: Table,
+	Callout,
+	CalloutContainer,
+	CalloutTitle,
+	CalloutDescription
+};
+const createRelativeLink = () => {
+	throw new Error("`createRelativeLink` is only supported in Node.js environment");
+};
+//#endregion
+export { createRelativeLink, defaultMdxComponents as default };

package/dist/mdx.server.d.ts

@@ -0,0 +1,14 @@
+import defaultMdxComponents from "./mdx.js";
+import { ComponentProps, FC } from "react";
+import { LoaderConfig, LoaderOutput, Page } from "@vx-oss/docs-core/source";
+//#region src/mdx.server.d.ts
+/**
+ * Extend the default Link component to resolve relative file paths in `href`.
+ *
+ * @param page the current page
+ * @param source the source object
+ * @param OverrideLink The component to override from
+ */
+declare function createRelativeLink<C extends LoaderConfig>(source: LoaderOutput<C>, page: Page | C['page'], OverrideLink?: FC<ComponentProps<'a'>>): FC<ComponentProps<'a'>>;
+//#endregion
+export { createRelativeLink, defaultMdxComponents as default };