rspress-plugin-api-extractor 0.1.1 → 0.2.0

package/runtime/components/EnumMembersTable/index.css

@@ -0,0 +1,99 @@
+.WkJdOG_table {
+  border: 1px solid var(--api-color-border);
+  border-radius: 0 0 var(--api-border-radius) var(--api-border-radius);
+  border-top: none;
+  margin: 0;
+  position: relative;
+  overflow: hidden;
+}
+
+html.WkJdOG_rp-dark .WkJdOG_table {
+  border-color: var(--api-color-border);
+}
+
+.WkJdOG_scroll {
+  -webkit-overflow-scrolling: touch;
+  overflow-x: auto;
+}
+
+.WkJdOG_table table {
+  border-collapse: collapse;
+  width: 100%;
+  font-size: var(--api-font-size-base);
+  border-top-left-radius: 0;
+  border-top-right-radius: 0;
+  margin: 0;
+}
+
+.WkJdOG_table thead {
+  background-color: var(--api-color-bg);
+  border-bottom: 1px solid var(--api-color-border);
+}
+
+.WkJdOG_table th {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  text-align: left;
+  color: var(--api-color-text);
+  white-space: nowrap;
+  font-weight: 600;
+}
+
+.WkJdOG_table th:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.WkJdOG_table th:nth-child(2) {
+  width: 25%;
+  min-width: 120px;
+}
+
+.WkJdOG_table th:last-child {
+  width: 55%;
+}
+
+.WkJdOG_table td {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  border-top: 1px solid var(--api-color-border);
+  vertical-align: top;
+}
+
+.WkJdOG_table td:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.WkJdOG_table td:nth-child(2) {
+  width: 25%;
+  min-width: 120px;
+}
+
+.WkJdOG_table td:last-child {
+  width: 55%;
+}
+
+.WkJdOG_table td code, .WkJdOG_table th code {
+  font-size: var(--api-font-size-sm);
+  background-color: var(--api-color-code-bg);
+  border-radius: var(--api-border-radius-sm);
+  padding: .125rem .375rem;
+}
+
+.WkJdOG_table td:last-child p:first-child {
+  margin-top: 0;
+}
+
+.WkJdOG_table td:last-child p:last-child, .WkJdOG_table td:last-child ul:last-child, .WkJdOG_table td:last-child ol:last-child {
+  margin-bottom: 0;
+}
+
+@media (width <= 768px) {
+  .WkJdOG_table td, .WkJdOG_table th {
+    padding: var(--api-spacing-sm) var(--api-spacing-md);
+    font-size: var(--api-font-size-sm);
+  }
+
+  .WkJdOG_table td:first-child, .WkJdOG_table th:first-child, .WkJdOG_table td:nth-child(2), .WkJdOG_table th:nth-child(2) {
+    min-width: 100px;
+  }
+}

package/runtime/components/EnumMembersTable/index.js

@@ -0,0 +1,38 @@
+import { MarkdownContent } from "../MarkdownContent/index.js";
+import index_module_default from "./index.module.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/runtime/components/EnumMembersTable/index.tsx
+const EnumMembersTable = ({ members }) => {
+	if (!members || members.length === 0) return null;
+	if (import.meta.env.SSG_MD) {
+		let markdown = "#### Members\n\n";
+		markdown += "| Member | Value | Description |\n";
+		markdown += "|--------|-------|-------------|\n";
+		for (const member of members) {
+			const name = `\`${member.name}\``;
+			const value = member.value ? `\`${member.value}\`` : "";
+			const description = member.description.replace(/<[^>]*>/g, "").trim();
+			markdown += `| ${name} | ${value} | ${description} |\n`;
+		}
+		return /* @__PURE__ */ jsx(Fragment, { children: markdown });
+	}
+	return /* @__PURE__ */ jsx("div", {
+		className: index_module_default.table,
+		children: /* @__PURE__ */ jsx("div", {
+			className: index_module_default.scroll,
+			children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+				/* @__PURE__ */ jsx("th", { children: "Member" }),
+				/* @__PURE__ */ jsx("th", { children: "Value" }),
+				/* @__PURE__ */ jsx("th", { children: "Description" })
+			] }) }), /* @__PURE__ */ jsx("tbody", { children: members.map((member) => /* @__PURE__ */ jsxs("tr", { children: [
+				/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx("code", { children: member.name }) }),
+				/* @__PURE__ */ jsx("td", { children: member.value && /* @__PURE__ */ jsx("code", { children: member.value }) }),
+				/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx(MarkdownContent, { children: member.description }) })
+			] }, member.name)) })] })
+		})
+	});
+};
+
+//#endregion
+export { EnumMembersTable, EnumMembersTable as default };

package/runtime/components/EnumMembersTable/index.module.js

@@ -0,0 +1,10 @@
+import './index.css';
+//#region src/runtime/components/EnumMembersTable/index.module.css
+var index_module_default = {
+	"rpDark": "WkJdOG_rp-dark",
+	"scroll": "WkJdOG_scroll",
+	"table": "WkJdOG_table"
+};
+
+//#endregion
+export { index_module_default as default };

package/runtime/components/ExampleBlock/index.css

@@ -0,0 +1,11 @@
+.PkJPlW_block {
+  margin: var(--api-spacing-xl) 0;
+  border-radius: var(--api-border-radius);
+  border: 1px solid var(--api-color-border);
+  position: relative;
+  overflow: visible;
+}
+
+html.PkJPlW_rp-dark .PkJPlW_block {
+  border-color: var(--api-color-border);
+}

package/runtime/components/ExampleBlock/index.js

@@ -0,0 +1,31 @@
+import { useWrapToggle } from "../../hooks/useWrapToggle.js";
+import { ButtonGroup } from "../buttons/ButtonGroup.js";
+import { CopyCodeButton } from "../buttons/CopyCodeButton.js";
+import { WrapSignatureButton } from "../buttons/WrapSignatureButton.js";
+import { SignatureCode } from "../SignatureCode/index.js";
+import { SignatureToolbar } from "../SignatureToolbar/index.js";
+import index_module_default from "./index.module.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/runtime/components/ExampleBlock/index.tsx
+/**
+* Code block for examples - displays syntax-highlighted code without a heading
+* Similar to SignatureBlock but without the "Signature" header
+* Includes both copy and wrap buttons in the toolbar
+*/
+function ExampleBlock({ hast, code }) {
+	const { wrapped, toggleWrap } = useWrapToggle();
+	return /* @__PURE__ */ jsxs("div", {
+		className: index_module_default.block,
+		children: [/* @__PURE__ */ jsx(SignatureToolbar, { buttons: /* @__PURE__ */ jsxs(ButtonGroup, { children: [code && /* @__PURE__ */ jsx(CopyCodeButton, { code }), /* @__PURE__ */ jsx(WrapSignatureButton, {
+			wrapped,
+			onToggle: toggleWrap
+		})] }) }), /* @__PURE__ */ jsx(SignatureCode, {
+			hast,
+			wrapped
+		})]
+	});
+}
+
+//#endregion
+export { ExampleBlock, ExampleBlock as default };

package/runtime/components/ExampleBlock/index.module.js

@@ -0,0 +1,9 @@
+import './index.css';
+//#region src/runtime/components/ExampleBlock/index.module.css
+var index_module_default = {
+	"block": "PkJPlW_block",
+	"rpDark": "PkJPlW_rp-dark"
+};
+
+//#endregion
+export { index_module_default as default };

package/runtime/components/MarkdownContent/index.js

@@ -0,0 +1,31 @@
+import { jsx } from "react/jsx-runtime";
+import Markdown from "react-markdown";
+
+//#region src/runtime/components/MarkdownContent/index.tsx
+/**
+* Custom link component that adds the rp-link class for RSPress styling
+* Filters out extra props passed by react-markdown (like `node`)
+*/
+function Link({ children, href, title, target, rel }) {
+	return /* @__PURE__ */ jsx("a", {
+		className: "rp-link",
+		href,
+		title,
+		target,
+		rel,
+		children
+	});
+}
+/**
+* Renders markdown content with RSPress-compatible link styling.
+* Wraps react-markdown and adds the `rp-link` class to all anchor tags.
+*/
+function MarkdownContent({ children }) {
+	return /* @__PURE__ */ jsx(Markdown, {
+		components: { a: Link },
+		children
+	});
+}
+
+//#endregion
+export { MarkdownContent, MarkdownContent as default };

package/runtime/components/MarkdownText/index.js

@@ -0,0 +1,33 @@
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/runtime/components/MarkdownText/index.tsx
+/**
+* Renders plain text with markdown links as React elements.
+* Only supports basic markdown links: [text](url)
+*/
+function MarkdownText({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: parseMarkdownLinks(children) });
+}
+/**
+* Parse markdown links and return array of React nodes
+*/
+function parseMarkdownLinks(text) {
+	const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+	const parts = [];
+	let lastIndex = 0;
+	let key = 0;
+	for (const match of text.matchAll(linkRegex)) {
+		if (match.index !== void 0 && match.index > lastIndex) parts.push(text.slice(lastIndex, match.index));
+		const [fullMatch, linkText, url] = match;
+		parts.push(/* @__PURE__ */ jsx("a", {
+			href: url,
+			children: linkText
+		}, key++));
+		lastIndex = (match.index ?? 0) + fullMatch.length;
+	}
+	if (lastIndex < text.length) parts.push(text.slice(lastIndex));
+	return parts;
+}
+
+//#endregion
+export { MarkdownText, MarkdownText as default };

package/runtime/components/MemberSignature/index.css

@@ -0,0 +1,26 @@
+.gRiZQa_block {
+  margin: var(--api-spacing-xl) 0;
+  border-radius: var(--api-border-radius);
+  border: 1px solid var(--api-color-border);
+  position: relative;
+  overflow: visible;
+}
+
+html.gRiZQa_rp-dark .gRiZQa_block {
+  border-color: var(--api-color-border);
+}
+
+.gRiZQa_hasParameters {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+  margin-bottom: 0;
+}
+
+.gRiZQa_hasParameters .api-signature-code {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+}
+
+.gRiZQa_hasParameters .api-signature-code pre {
+  border-radius: 0;
+}

package/runtime/components/MemberSignature/index.js

@@ -0,0 +1,54 @@
+import { useWrapToggle } from "../../hooks/useWrapToggle.js";
+import { WrapSignatureButton } from "../buttons/WrapSignatureButton.js";
+import { SignatureCode } from "../SignatureCode/index.js";
+import { SignatureToolbar } from "../SignatureToolbar/index.js";
+import index_module_default from "./index.module.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+
+//#region src/runtime/components/MemberSignature/index.tsx
+/**
+* Interactive member signature block with h3 header and wrap button
+* Displays syntax-highlighted TypeScript member signatures with hover tooltips
+*/
+function MemberSignature({ hast, memberName, id, summary, hasParameters = false }) {
+	const { wrapped, toggleWrap } = useWrapToggle();
+	if (import.meta.env.SSG_MD) {
+		let signature = "";
+		if (hast) signature = extractTextFromHast(hast);
+		const lines = signature.split("\n").filter((line) => line.trim());
+		if (lines.length >= 2) signature = lines[1].trim();
+		let markdown = `### ${memberName}\n\n**Signature:** \`${signature}\``;
+		if (summary) markdown += `\n\n${summary}`;
+		return /* @__PURE__ */ jsx(Fragment, { children: markdown });
+	}
+	return /* @__PURE__ */ jsxs("div", {
+		className: clsx(index_module_default.block, hasParameters && index_module_default.hasParameters),
+		children: [/* @__PURE__ */ jsx(SignatureToolbar, {
+			heading: {
+				text: memberName,
+				...id != null ? { id } : {},
+				level: "h3"
+			},
+			...summary != null ? { summary } : {},
+			buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
+				wrapped,
+				onToggle: toggleWrap
+			})
+		}), /* @__PURE__ */ jsx(SignatureCode, {
+			hast,
+			wrapped
+		})]
+	});
+}
+/**
+* Extract plain text from a HAST tree
+*/
+function extractTextFromHast(node) {
+	if ("value" in node && typeof node.value === "string") return node.value;
+	if ("children" in node && Array.isArray(node.children)) return node.children.map(extractTextFromHast).join("");
+	return "";
+}
+
+//#endregion
+export { MemberSignature, MemberSignature as default };

package/runtime/components/MemberSignature/index.module.js

@@ -0,0 +1,10 @@
+import './index.css';
+//#region src/runtime/components/MemberSignature/index.module.css
+var index_module_default = {
+	"block": "gRiZQa_block",
+	"hasParameters": "gRiZQa_hasParameters",
+	"rpDark": "gRiZQa_rp-dark"
+};
+
+//#endregion
+export { index_module_default as default };

package/runtime/components/ParametersTable/index.css

@@ -0,0 +1,103 @@
+.NDYkiG_table {
+  border: 1px solid var(--api-color-border);
+  border-radius: 0 0 var(--api-border-radius) var(--api-border-radius);
+  border-top: none;
+  margin: 0;
+  position: relative;
+  overflow: hidden;
+}
+
+html.NDYkiG_rp-dark .NDYkiG_table {
+  border-color: var(--api-color-border);
+}
+
+.NDYkiG_scroll {
+  -webkit-overflow-scrolling: touch;
+  overflow-x: auto;
+}
+
+.NDYkiG_table table {
+  border-collapse: collapse;
+  width: 100%;
+  font-size: var(--api-font-size-base);
+  border-top-left-radius: 0;
+  border-top-right-radius: 0;
+  margin: 0;
+}
+
+.NDYkiG_table thead {
+  background-color: var(--api-color-bg);
+  border-bottom: 1px solid var(--api-color-border);
+}
+
+.NDYkiG_table th {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  text-align: left;
+  color: var(--api-color-text);
+  white-space: nowrap;
+  font-weight: 600;
+}
+
+.NDYkiG_table th:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.NDYkiG_table th:nth-child(2) {
+  width: 30%;
+  min-width: 150px;
+}
+
+.NDYkiG_table th:last-child {
+  width: 50%;
+}
+
+.NDYkiG_table td {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  border-top: 1px solid var(--api-color-border);
+  vertical-align: top;
+}
+
+.NDYkiG_table td:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.NDYkiG_table td:nth-child(2) {
+  width: 30%;
+  min-width: 150px;
+}
+
+.NDYkiG_table td:last-child {
+  width: 50%;
+}
+
+.NDYkiG_table td code, .NDYkiG_table th code {
+  font-size: var(--api-font-size-sm);
+  background-color: var(--api-color-code-bg);
+  border-radius: var(--api-border-radius-sm);
+  padding: .125rem .375rem;
+}
+
+.NDYkiG_table td:last-child p:first-child {
+  margin-top: 0;
+}
+
+.NDYkiG_table td:last-child p:last-child, .NDYkiG_table td:last-child ul:last-child, .NDYkiG_table td:last-child ol:last-child {
+  margin-bottom: 0;
+}
+
+@media (width <= 768px) {
+  .NDYkiG_table td, .NDYkiG_table th {
+    padding: var(--api-spacing-sm) var(--api-spacing-md);
+    font-size: var(--api-font-size-sm);
+  }
+
+  .NDYkiG_table td:first-child, .NDYkiG_table th:first-child {
+    min-width: 100px;
+  }
+
+  .NDYkiG_table td:nth-child(2), .NDYkiG_table th:nth-child(2) {
+    min-width: 120px;
+  }
+}

package/runtime/components/ParametersTable/index.js

@@ -0,0 +1,38 @@
+import { MarkdownContent } from "../MarkdownContent/index.js";
+import index_module_default from "./index.module.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/runtime/components/ParametersTable/index.tsx
+const ParametersTable = ({ parameters }) => {
+	if (!parameters || parameters.length === 0) return null;
+	if (import.meta.env.SSG_MD) {
+		let markdown = "#### Parameters\n\n";
+		markdown += "| Name | Type | Description |\n";
+		markdown += "|------|------|-------------|\n";
+		for (const param of parameters) {
+			const name = `\`${param.name}\``;
+			const type = param.type ? `\`${param.type}\`` : "";
+			const description = param.description.replace(/<[^>]*>/g, "").trim();
+			markdown += `| ${name} | ${type} | ${description} |\n`;
+		}
+		return /* @__PURE__ */ jsx(Fragment, { children: markdown });
+	}
+	return /* @__PURE__ */ jsx("div", {
+		className: index_module_default.table,
+		children: /* @__PURE__ */ jsx("div", {
+			className: index_module_default.scroll,
+			children: /* @__PURE__ */ jsxs("table", { children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+				/* @__PURE__ */ jsx("th", { children: "Parameter" }),
+				/* @__PURE__ */ jsx("th", { children: "Type" }),
+				/* @__PURE__ */ jsx("th", { children: "Description" })
+			] }) }), /* @__PURE__ */ jsx("tbody", { children: parameters.map((param) => /* @__PURE__ */ jsxs("tr", { children: [
+				/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx("code", { children: param.name }) }),
+				/* @__PURE__ */ jsx("td", { children: param.type && /* @__PURE__ */ jsx("code", { children: param.type }) }),
+				/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx(MarkdownContent, { children: param.description }) })
+			] }, param.name)) })] })
+		})
+	});
+};
+
+//#endregion
+export { ParametersTable, ParametersTable as default };

package/runtime/components/ParametersTable/index.module.js

@@ -0,0 +1,10 @@
+import './index.css';
+//#region src/runtime/components/ParametersTable/index.module.css
+var index_module_default = {
+	"rpDark": "NDYkiG_rp-dark",
+	"scroll": "NDYkiG_scroll",
+	"table": "NDYkiG_table"
+};
+
+//#endregion
+export { index_module_default as default };

package/runtime/components/SignatureBlock/index.css

@@ -0,0 +1,26 @@
+.L_PAPG_block {
+  margin: var(--api-spacing-xl) 0;
+  border-radius: var(--api-border-radius);
+  border: 1px solid var(--api-color-border);
+  position: relative;
+  overflow: visible;
+}
+
+html.L_PAPG_rp-dark .L_PAPG_block {
+  border-color: var(--api-color-border);
+}
+
+.L_PAPG_hasParameters {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+  margin-bottom: 0;
+}
+
+.L_PAPG_hasParameters .api-signature-code {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+}
+
+.L_PAPG_hasParameters .api-signature-code pre {
+  border-radius: 0;
+}

package/runtime/components/SignatureBlock/index.js

@@ -0,0 +1,36 @@
+import { useWrapToggle } from "../../hooks/useWrapToggle.js";
+import { WrapSignatureButton } from "../buttons/WrapSignatureButton.js";
+import { SignatureCode } from "../SignatureCode/index.js";
+import { SignatureToolbar } from "../SignatureToolbar/index.js";
+import index_module_default from "./index.module.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+
+//#region src/runtime/components/SignatureBlock/index.tsx
+/**
+* Interactive signature block with wrap button
+* Displays syntax-highlighted TypeScript signatures with hover tooltips
+*/
+function SignatureBlock({ hast, heading = "Signature", id = "signature", hasParameters = false }) {
+	const { wrapped, toggleWrap } = useWrapToggle();
+	return /* @__PURE__ */ jsxs("div", {
+		className: clsx(index_module_default.block, hasParameters && index_module_default.hasParameters),
+		children: [/* @__PURE__ */ jsx(SignatureToolbar, {
+			...heading && id ? { heading: {
+				text: heading,
+				id,
+				level: "h2"
+			} } : {},
+			buttons: /* @__PURE__ */ jsx(WrapSignatureButton, {
+				wrapped,
+				onToggle: toggleWrap
+			})
+		}), /* @__PURE__ */ jsx(SignatureCode, {
+			hast,
+			wrapped
+		})]
+	});
+}
+
+//#endregion
+export { SignatureBlock, SignatureBlock as default };

package/runtime/components/SignatureBlock/index.module.js

@@ -0,0 +1,10 @@
+import './index.css';
+//#region src/runtime/components/SignatureBlock/index.module.css
+var index_module_default = {
+	"block": "L_PAPG_block",
+	"hasParameters": "L_PAPG_hasParameters",
+	"rpDark": "L_PAPG_rp-dark"
+};
+
+//#endregion
+export { index_module_default as default };

package/runtime/components/SignatureCode/index.css

@@ -0,0 +1,52 @@
+.Ze8uHG_code {
+  border-bottom-left-radius: var(--api-border-radius);
+  border-bottom-right-radius: var(--api-border-radius);
+  position: relative;
+  container-type: inline-size;
+}
+
+.Ze8uHG_code pre {
+  height: auto;
+  max-height: none;
+  padding: var(--api-spacing-lg);
+  background-color: var(--shiki-light-bg);
+  border-radius: 0 0 var(--api-border-radius) var(--api-border-radius);
+  margin: 0;
+  overflow-x: auto;
+}
+
+html.Ze8uHG_rp-dark .Ze8uHG_code pre {
+  background-color: var(--shiki-dark-bg);
+}
+
+.Ze8uHG_code code {
+  background-color: unset;
+  min-height: var(--api-font-size-md);
+  line-height: var(--api-line-height-base);
+  flex-direction: column;
+  justify-content: center;
+  display: flex;
+}
+
+.Ze8uHG_code code span {
+  color: var(--shiki-light);
+}
+
+html.Ze8uHG_rp-dark .Ze8uHG_code code span {
+  color: var(--shiki-dark);
+}
+
+.Ze8uHG_code .line {
+  background: none;
+  min-height: 1lh;
+}
+
+.Ze8uHG_wrapped pre {
+  white-space: pre-wrap;
+  overflow-wrap: break-word;
+}
+
+.Ze8uHG_wrapped code {
+  white-space: pre-wrap;
+  overflow-wrap: break-word;
+}