rspress-plugin-api-extractor 0.1.1 → 0.2.0

package/runtime/components/ApiLlmsPackageActions/index.js

@@ -0,0 +1,277 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { usePage, useSite } from "@rspress/core/runtime";
+import { createPortal } from "react-dom";
+
+//#region src/runtime/components/ApiLlmsPackageActions/index.tsx
+function resolveUrl(urlPath) {
+	if (typeof window === "undefined") return urlPath;
+	if (urlPath.startsWith("http://") || urlPath.startsWith("https://")) return urlPath;
+	return `${window.location.origin}${urlPath}`;
+}
+function findMatchingScope(pathname, scopes) {
+	const sorted = [...scopes].sort((a, b) => b.packageRoute.length - a.packageRoute.length);
+	for (const scope of sorted) {
+		const base = scope.packageRoute.endsWith("/") ? scope.packageRoute : `${scope.packageRoute}/`;
+		if (pathname === scope.packageRoute || pathname.startsWith(base)) return scope;
+	}
+	return null;
+}
+async function copyToClipboard(text) {
+	await navigator.clipboard.writeText(text);
+}
+/**
+* Package-scoped LLM actions injected via React portals into RSPress's
+* existing LLMs UI containers. Adds package-level copy/open actions
+* alongside the default page-level options.
+*
+* For outline mode: injects rows into .rp-outline__bottom
+* For title mode: injects a dropdown into .rp-llms-container
+*/
+function ApiLlmsPackageActions() {
+	const { site } = useSite();
+	const { page } = usePage();
+	const [outlineTarget, setOutlineTarget] = useState(null);
+	const scopes = useMemo(() => {
+		if (import.meta.env.SSG_MD) return [];
+		return (site?.themeConfig)?.apiExtractorScopes ?? [];
+	}, [site]);
+	const activeScope = useMemo(() => findMatchingScope(page.routePath, scopes), [page.routePath, scopes]);
+	const placement = useMemo(() => {
+		const llmsUI = site?.themeConfig?.llmsUI;
+		return typeof llmsUI === "object" ? llmsUI?.placement ?? "title" : "title";
+	}, [site]);
+	useEffect(() => {
+		if (import.meta.env.SSG_MD || !activeScope) {
+			setOutlineTarget(null);
+			return;
+		}
+		if (placement !== "outline") return;
+		const timer = setTimeout(() => {
+			setOutlineTarget(document.querySelector(".rp-outline__bottom"));
+		}, 100);
+		return () => clearTimeout(timer);
+	}, [
+		activeScope,
+		placement,
+		page.routePath
+	]);
+	if (import.meta.env.SSG_MD || !activeScope) return null;
+	if (placement === "outline" && outlineTarget) return createPortal(/* @__PURE__ */ jsx(OutlinePackageActions, { scope: activeScope }), outlineTarget);
+	return null;
+}
+function OutlinePackageActions({ scope }) {
+	const [copyFeedback, setCopyFeedback] = useState(null);
+	const [isOpenMenuOpen, setIsOpenMenuOpen] = useState(false);
+	const wrapperRef = useRef(null);
+	useEffect(() => {
+		if (!isOpenMenuOpen) return;
+		const handleClick = (e) => {
+			if (wrapperRef.current && !wrapperRef.current.contains(e.target)) setIsOpenMenuOpen(false);
+		};
+		document.addEventListener("mousedown", handleClick);
+		return () => document.removeEventListener("mousedown", handleClick);
+	}, [isOpenMenuOpen]);
+	const handleCopyDocs = useCallback(async () => {
+		try {
+			const url = resolveUrl(scope.llmsDocsTxt);
+			await copyToClipboard(await (await fetch(url)).text());
+			setCopyFeedback("Copied!");
+			setTimeout(() => setCopyFeedback(null), 1500);
+		} catch {
+			setCopyFeedback("Failed");
+			setTimeout(() => setCopyFeedback(null), 1500);
+		}
+	}, [scope]);
+	const handleCopyLink = useCallback(async (urlPath) => {
+		try {
+			await copyToClipboard(resolveUrl(urlPath));
+			setCopyFeedback("Copied!");
+			setTimeout(() => setCopyFeedback(null), 1500);
+		} catch {
+			setCopyFeedback("Failed");
+			setTimeout(() => setCopyFeedback(null), 1500);
+		}
+	}, []);
+	const q = `Read ${resolveUrl(scope.llmsTxt)}, I want to ask questions about the ${scope.name} package.`;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsxs("button", {
+			type: "button",
+			className: "rp-outline__action-row",
+			onClick: handleCopyDocs,
+			children: [/* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copyFeedback ?? `Copy ${scope.name} docs` })]
+		}),
+		/* @__PURE__ */ jsxs("button", {
+			type: "button",
+			className: "rp-outline__action-row",
+			onClick: () => handleCopyLink(scope.llmsTxt),
+			children: [/* @__PURE__ */ jsx(LinkIcon, {}), /* @__PURE__ */ jsx("span", { children: "Copy llms.txt link" })]
+		}),
+		/* @__PURE__ */ jsxs("div", {
+			ref: wrapperRef,
+			className: "rp-outline__open-in-wrapper",
+			children: [/* @__PURE__ */ jsxs("button", {
+				type: "button",
+				className: "rp-outline__action-row",
+				onClick: () => setIsOpenMenuOpen(!isOpenMenuOpen),
+				children: [/* @__PURE__ */ jsx(ExternalLinkIcon, {}), /* @__PURE__ */ jsxs("span", { children: [
+					"Open ",
+					scope.name,
+					" in chat"
+				] })]
+			}), isOpenMenuOpen && /* @__PURE__ */ jsxs("div", {
+				className: "rp-llms-view-options__menu",
+				children: [/* @__PURE__ */ jsxs("a", {
+					className: "rp-llms-view-options__menu-item",
+					href: `https://chatgpt.com/?${new URLSearchParams({
+						hints: "search",
+						q
+					})}`,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					onClick: () => setIsOpenMenuOpen(false),
+					children: [
+						/* @__PURE__ */ jsx("span", {
+							className: "rp-llms-view-options__item-icon",
+							children: /* @__PURE__ */ jsx(ChatGPTIcon, {})
+						}),
+						/* @__PURE__ */ jsx("span", { children: "Open in ChatGPT" }),
+						/* @__PURE__ */ jsx("span", {
+							className: "rp-llms-view-options__external-icon",
+							children: /* @__PURE__ */ jsx(ExternalLinkSmallIcon, {})
+						})
+					]
+				}), /* @__PURE__ */ jsxs("a", {
+					className: "rp-llms-view-options__menu-item",
+					href: `https://claude.ai/new?${new URLSearchParams({ q })}`,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					onClick: () => setIsOpenMenuOpen(false),
+					children: [
+						/* @__PURE__ */ jsx("span", {
+							className: "rp-llms-view-options__item-icon",
+							children: /* @__PURE__ */ jsx(ClaudeIcon, {})
+						}),
+						/* @__PURE__ */ jsx("span", { children: "Open in Claude" }),
+						/* @__PURE__ */ jsx("span", {
+							className: "rp-llms-view-options__external-icon",
+							children: /* @__PURE__ */ jsx(ExternalLinkSmallIcon, {})
+						})
+					]
+				})]
+			})]
+		})
+	] });
+}
+function CopyIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "Copy" }),
+			/* @__PURE__ */ jsx("rect", {
+				x: 9,
+				y: 9,
+				width: 13,
+				height: 13,
+				rx: 2,
+				ry: 2
+			}),
+			/* @__PURE__ */ jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })
+		]
+	});
+}
+function LinkIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "Link" }),
+			/* @__PURE__ */ jsx("path", { d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" }),
+			/* @__PURE__ */ jsx("path", { d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" })
+		]
+	});
+}
+function ExternalLinkIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "External link" }),
+			/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+			/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+			/* @__PURE__ */ jsx("line", {
+				x1: 10,
+				y1: 14,
+				x2: 21,
+				y2: 3
+			})
+		]
+	});
+}
+function ExternalLinkSmallIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 12,
+		height: 12,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "External link" }),
+			/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+			/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+			/* @__PURE__ */ jsx("line", {
+				x1: 10,
+				y1: 14,
+				x2: 21,
+				y2: 3
+			})
+		]
+	});
+}
+function ChatGPTIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		role: "img",
+		viewBox: "0 0 24 24",
+		fill: "currentColor",
+		xmlns: "http://www.w3.org/2000/svg",
+		width: 16,
+		height: 16,
+		children: [/* @__PURE__ */ jsx("title", { children: "ChatGPT" }), /* @__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" })]
+	});
+}
+function ClaudeIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		fill: "currentColor",
+		role: "img",
+		viewBox: "0 0 24 24",
+		xmlns: "http://www.w3.org/2000/svg",
+		width: 16,
+		height: 16,
+		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" })]
+	});
+}
+
+//#endregion
+export { ApiLlmsPackageActions, ApiLlmsPackageActions as default };

package/runtime/components/ApiLlmsViewOptions/index.js

@@ -0,0 +1,294 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useI18n, usePage, useSite } from "@rspress/core/runtime";
+import { useMdUrl } from "@rspress/core/theme";
+
+//#region src/runtime/components/ApiLlmsViewOptions/index.tsx
+/**
+* Custom LlmsViewOptions that replaces RSPress's default via resolve.alias.
+*
+* - Outside package scope: reproduces the original RSPress dropdown behavior
+* - Inside package scope: adds package-level copy/open actions to the dropdown
+*
+* Uses RSPress's own CSS classes (rp-llms-*) for visual consistency.
+*/
+function resolveUrl(urlPath) {
+	if (typeof window === "undefined") return urlPath;
+	return urlPath.startsWith("http") ? urlPath : `${window.location.origin}${urlPath}`;
+}
+function findScope(pathname, scopes) {
+	const sorted = [...scopes].sort((a, b) => b.packageRoute.length - a.packageRoute.length);
+	for (const s of sorted) {
+		const base = s.packageRoute.endsWith("/") ? s.packageRoute : `${s.packageRoute}/`;
+		if (pathname === s.packageRoute || pathname.startsWith(base)) return s;
+	}
+	return null;
+}
+async function copyText(text) {
+	await navigator.clipboard.writeText(text);
+}
+function DownArrow({ className }) {
+	return /* @__PURE__ */ jsxs("svg", {
+		className,
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [/* @__PURE__ */ jsx("title", { children: "Toggle menu" }), /* @__PURE__ */ jsx("path", { d: "m6 9 6 6 6-6" })]
+	});
+}
+function LinkIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "Link" }),
+			/* @__PURE__ */ jsx("path", { d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" }),
+			/* @__PURE__ */ jsx("path", { d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" })
+		]
+	});
+}
+function CopyIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 16,
+		height: 16,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "Copy" }),
+			/* @__PURE__ */ jsx("rect", {
+				x: 9,
+				y: 9,
+				width: 13,
+				height: 13,
+				rx: 2,
+				ry: 2
+			}),
+			/* @__PURE__ */ jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })
+		]
+	});
+}
+function ExternalLinkIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: 12,
+		height: 12,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("title", { children: "External link" }),
+			/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+			/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+			/* @__PURE__ */ jsx("line", {
+				x1: 10,
+				y1: 14,
+				x2: 21,
+				y2: 3
+			})
+		]
+	});
+}
+function ChatGPTIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		role: "img",
+		viewBox: "0 0 24 24",
+		fill: "currentColor",
+		xmlns: "http://www.w3.org/2000/svg",
+		width: 16,
+		height: 16,
+		children: [/* @__PURE__ */ jsx("title", { children: "ChatGPT" }), /* @__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" })]
+	});
+}
+function ClaudeIcon() {
+	return /* @__PURE__ */ jsxs("svg", {
+		fill: "currentColor",
+		role: "img",
+		viewBox: "0 0 24 24",
+		xmlns: "http://www.w3.org/2000/svg",
+		width: 16,
+		height: 16,
+		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" })]
+	});
+}
+function LlmsViewOptions(props) {
+	const { site } = useSite();
+	const { page } = usePage();
+	const { pathname } = useMdUrl();
+	const t = useI18n();
+	const [isOpen, setIsOpen] = useState(false);
+	const [feedback, setFeedback] = useState(null);
+	const dropdownRef = useRef(null);
+	const llmsUI = site?.themeConfig?.llmsUI;
+	const configOptions = typeof llmsUI === "object" ? llmsUI?.viewOptions : void 0;
+	const options = props.options ?? configOptions ?? [
+		"markdownLink",
+		"chatgpt",
+		"claude"
+	];
+	const scopes = (site?.themeConfig)?.apiExtractorScopes ?? [];
+	const activeScope = useMemo(() => findScope(page.routePath, scopes), [page.routePath, scopes]);
+	useEffect(() => {
+		if (!isOpen) return;
+		const handler = (e) => {
+			if (dropdownRef.current && !dropdownRef.current.contains(e.target)) setIsOpen(false);
+		};
+		document.addEventListener("mousedown", handler);
+		return () => document.removeEventListener("mousedown", handler);
+	}, [isOpen]);
+	const fullMarkdownUrl = useMemo(() => typeof window !== "undefined" ? new URL(pathname, window.location.origin).toString() : "", [pathname]);
+	const pageQ = `Read ${fullMarkdownUrl}, I want to ask questions about it.`;
+	const pageItems = useMemo(() => {
+		const builtins = {
+			markdownLink: {
+				title: t("copyMarkdownLinkText"),
+				icon: /* @__PURE__ */ jsx(LinkIcon, {}),
+				onClick: () => copyText(fullMarkdownUrl)
+			},
+			chatgpt: {
+				title: t("openInText", { name: "ChatGPT" }),
+				href: `https://chatgpt.com/?${new URLSearchParams({
+					hints: "search",
+					q: pageQ
+				})}`,
+				icon: /* @__PURE__ */ jsx(ChatGPTIcon, {})
+			},
+			claude: {
+				title: t("openInText", { name: "Claude" }),
+				href: `https://claude.ai/new?${new URLSearchParams({ q: pageQ })}`,
+				icon: /* @__PURE__ */ jsx(ClaudeIcon, {})
+			}
+		};
+		return options.map((opt) => {
+			if (typeof opt === "string") return builtins[opt] ?? null;
+			return opt;
+		}).filter(Boolean);
+	}, [
+		options,
+		fullMarkdownUrl,
+		pageQ,
+		t
+	]);
+	const showFeedback = useCallback((msg) => {
+		setFeedback(msg);
+		setTimeout(() => setFeedback(null), 1500);
+	}, []);
+	const handleCopyDocs = useCallback(async () => {
+		if (!activeScope) return;
+		try {
+			await copyText(await (await fetch(resolveUrl(activeScope.llmsDocsTxt))).text());
+			showFeedback("Copied!");
+		} catch {
+			showFeedback("Failed");
+		}
+	}, [activeScope, showFeedback]);
+	const handleCopyLink = useCallback(async (urlPath) => {
+		try {
+			await copyText(resolveUrl(urlPath));
+			showFeedback("Copied!");
+		} catch {
+			showFeedback("Failed");
+		}
+	}, [showFeedback]);
+	if (!pathname) return null;
+	const packageItems = [];
+	if (activeScope) {
+		const pkgQ = `Read ${resolveUrl(activeScope.llmsTxt)}, I want to ask questions about the ${activeScope.name} package.`;
+		packageItems.push({
+			title: feedback ?? `Copy ${activeScope.name} docs`,
+			icon: /* @__PURE__ */ jsx(CopyIcon, {}),
+			onClick: handleCopyDocs
+		}, {
+			title: "Copy llms.txt link",
+			icon: /* @__PURE__ */ jsx(LinkIcon, {}),
+			onClick: () => handleCopyLink(activeScope.llmsTxt)
+		}, {
+			title: "Copy llms-full.txt link",
+			icon: /* @__PURE__ */ jsx(LinkIcon, {}),
+			onClick: () => handleCopyLink(activeScope.llmsFullTxt)
+		}, {
+			title: `Open ${activeScope.name} in ChatGPT`,
+			href: `https://chatgpt.com/?${new URLSearchParams({
+				hints: "search",
+				q: pkgQ
+			})}`,
+			icon: /* @__PURE__ */ jsx(ChatGPTIcon, {})
+		}, {
+			title: `Open ${activeScope.name} in Claude`,
+			href: `https://claude.ai/new?${new URLSearchParams({ q: pkgQ })}`,
+			icon: /* @__PURE__ */ jsx(ClaudeIcon, {})
+		});
+	}
+	return /* @__PURE__ */ jsxs("button", {
+		ref: dropdownRef,
+		type: "button",
+		className: `rp-llms-button rp-llms-view-options__trigger ${isOpen ? "rp-llms-view-options__trigger--active" : ""}`,
+		onClick: () => setIsOpen(!isOpen),
+		children: [/* @__PURE__ */ jsx(DownArrow, { className: `rp-llms-view-options__arrow ${isOpen ? "rp-llms-view-options__arrow--rotated" : ""}` }), isOpen && /* @__PURE__ */ jsxs("div", {
+			className: "rp-llms-view-options__menu",
+			children: [pageItems.map((item) => /* @__PURE__ */ jsx(MenuItem, {
+				item,
+				onClose: () => setIsOpen(false)
+			}, item.title)), packageItems.length > 0 && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("div", { style: {
+				height: 1,
+				margin: "4px 0",
+				background: "var(--rp-c-divider)"
+			} }), packageItems.map((item) => /* @__PURE__ */ jsx(MenuItem, {
+				item,
+				onClose: () => setIsOpen(false)
+			}, item.title))] })]
+		})]
+	});
+}
+function MenuItem({ item, onClose }) {
+	if (item.href) return /* @__PURE__ */ jsxs("a", {
+		className: "rp-llms-view-options__menu-item",
+		href: item.href,
+		target: "_blank",
+		rel: "noopener noreferrer",
+		onClick: onClose,
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				className: "rp-llms-view-options__item-icon",
+				children: item.icon
+			}),
+			/* @__PURE__ */ jsx("span", { children: item.title }),
+			/* @__PURE__ */ jsx("span", {
+				className: "rp-llms-view-options__external-icon",
+				children: /* @__PURE__ */ jsx(ExternalLinkIcon, {})
+			})
+		]
+	});
+	return /* @__PURE__ */ jsxs("button", {
+		type: "button",
+		className: "rp-llms-view-options__menu-item",
+		onClick: (e) => {
+			e.stopPropagation();
+			item.onClick?.();
+			onClose();
+		},
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "rp-llms-view-options__item-icon",
+			children: item.icon
+		}), /* @__PURE__ */ jsx("span", { children: item.title })]
+	});
+}
+
+//#endregion
+export { LlmsViewOptions };

package/runtime/components/ApiMember/index.js

@@ -0,0 +1,53 @@
+import { decodeHast } from "../../utils/decode-hast.js";
+import { MemberSignature } from "../MemberSignature/index.js";
+import { createElement, useMemo } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/runtime/components/ApiMember/index.tsx
+/**
+* Renders an individual class/interface member signature block.
+*
+* Replaces MemberSignatureWrapper with a simpler component that takes plain
+* string props. The `code` prop contains only the member signature (not
+* wrapped in a class skeleton), and `summary` is plain markdown-compatible
+* text (not HTML with anchor tags, not base64-encoded).
+*
+* In SSG-MD mode, renders a heading with member name, summary text,
+* and a plain code block with the member signature.
+*/
+function ApiMember({ code, memberName, summary, id, hast, hasParameters }) {
+	const parsedHast = useMemo(() => decodeHast(hast, "ApiMember"), [hast]);
+	const hasParamsBoolean = typeof hasParameters === "string" ? hasParameters === "true" : !!hasParameters;
+	if (import.meta.env.SSG_MD) return /* @__PURE__ */ jsxs(Fragment, { children: [
+		`### ${memberName}\n\n`,
+		summary && `${summary}\n\n`,
+		`\`\`\`typescript
+${code.trim()}
+\`\`\`
+`
+	] });
+	if (parsedHast) {
+		const memberProps = {
+			hast: parsedHast,
+			memberName,
+			hasParameters: hasParamsBoolean
+		};
+		if (summary != null) memberProps.summary = summary;
+		if (id != null) memberProps.id = id;
+		return createElement(MemberSignature, memberProps);
+	}
+	return /* @__PURE__ */ jsxs("div", { children: [
+		/* @__PURE__ */ jsx("h3", {
+			id,
+			children: memberName
+		}),
+		summary && /* @__PURE__ */ jsx("p", { children: summary }),
+		/* @__PURE__ */ jsx("pre", { children: /* @__PURE__ */ jsx("code", {
+			className: "language-typescript",
+			children: code.trim()
+		}) })
+	] });
+}
+
+//#endregion
+export { ApiMember, ApiMember as default };

package/runtime/components/ApiSignature/index.js

@@ -0,0 +1,36 @@
+import { decodeHast } from "../../utils/decode-hast.js";
+import { SignatureBlock } from "../SignatureBlock/index.js";
+import { createElement, useMemo } from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/runtime/components/ApiSignature/index.tsx
+/**
+* Renders a full API type signature block.
+*
+* Replaces SignatureBlockWrapper with a simpler component that takes plain
+* string props (no base64 encoding for code). Produces clean semantic HTML
+* that RSPress converts to LLM-readable markdown in SSG-MD mode, and renders
+* interactive Shiki-highlighted code in browser mode.
+*
+* In SSG-MD mode, renders a "Signature" heading followed by a plain
+* code block with the type signature.
+*/
+function ApiSignature({ code, heading: _heading = "Signature", id: _id = "signature", hast, hasParameters, hasMembers }) {
+	const parsedHast = useMemo(() => decodeHast(hast, "ApiSignature"), [hast]);
+	const hasTableBelow = (typeof hasParameters === "string" ? hasParameters === "true" : !!hasParameters) || (typeof hasMembers === "string" ? hasMembers === "true" : !!hasMembers);
+	if (import.meta.env.SSG_MD) return /* @__PURE__ */ jsx(Fragment, { children: `\`\`\`typescript
+${code.trim()}
+\`\`\`
+` });
+	if (parsedHast) return createElement(SignatureBlock, {
+		hast: parsedHast,
+		hasParameters: hasTableBelow
+	});
+	return /* @__PURE__ */ jsx("pre", { children: /* @__PURE__ */ jsx("code", {
+		className: "language-typescript",
+		children: code.trim()
+	}) });
+}
+
+//#endregion
+export { ApiSignature, ApiSignature as default };