rspress-plugin-api-extractor 0.1.0 → 0.1.2

package/runtime/components/MarkdownContent/index.js

@@ -0,0 +1,23 @@
+import { jsx } from "react/jsx-runtime";
+import react_markdown from "react-markdown";
+function Link({ children, href, title, target, rel }) {
+    return /*#__PURE__*/ jsx("a", {
+        className: "rp-link",
+        href: href,
+        title: title,
+        target: target,
+        rel: rel,
+        children: children
+    });
+}
+function MarkdownContent({ children }) {
+    return /*#__PURE__*/ jsx(react_markdown, {
+        components: {
+            a: Link
+        },
+        children: children
+    });
+}
+const components_MarkdownContent = MarkdownContent;
+export default components_MarkdownContent;
+export { MarkdownContent };

package/runtime/components/MarkdownText/index.js

@@ -0,0 +1,27 @@
+import { Fragment, jsx } from "react/jsx-runtime";
+function MarkdownText({ children }) {
+    const parts = parseMarkdownLinks(children);
+    return /*#__PURE__*/ jsx(Fragment, {
+        children: parts
+    });
+}
+function parseMarkdownLinks(text) {
+    const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+    const parts = [];
+    let lastIndex = 0;
+    let key = 0;
+    for (const match of text.matchAll(linkRegex)){
+        if (void 0 !== match.index && 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;
+}
+const components_MarkdownText = MarkdownText;
+export default components_MarkdownText;
+export { MarkdownText };

package/runtime/components/MemberSignature/index.js

@@ -0,0 +1,54 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+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 from "./index.module.js";
+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.block, hasParameters && index_module.hasParameters),
+        children: [
+            /*#__PURE__*/ jsx(SignatureToolbar, {
+                heading: {
+                    text: memberName,
+                    ...null != id ? {
+                        id
+                    } : {},
+                    level: "h3"
+                },
+                ...null != summary ? {
+                    summary
+                } : {},
+                buttons: /*#__PURE__*/ jsx(WrapSignatureButton, {
+                    wrapped: wrapped,
+                    onToggle: toggleWrap
+                })
+            }),
+            /*#__PURE__*/ jsx(SignatureCode, {
+                hast: hast,
+                wrapped: wrapped
+            })
+        ]
+    });
+}
+function extractTextFromHast(node) {
+    if ("value" in node && "string" == typeof node.value) return node.value;
+    if ("children" in node && Array.isArray(node.children)) return node.children.map(extractTextFromHast).join("");
+    return "";
+}
+const components_MemberSignature = MemberSignature;
+export default components_MemberSignature;
+export { MemberSignature };

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

@@ -0,0 +1,7 @@
+import "./index_module.css";
+const index_module = {
+    block: "block-Qq5hxM",
+    rpDark: "rp-dark-TylSkU",
+    hasParameters: "hasParameters-u13UWy"
+};
+export default index_module;

package/runtime/components/MemberSignature/index_module.css

@@ -0,0 +1,27 @@
+.block-Qq5hxM {
+  margin: var(--api-spacing-xl) 0;
+  border-radius: var(--api-border-radius);
+  border: 1px solid var(--api-color-border);
+  position: relative;
+  overflow: visible;
+}
+
+html.rp-dark-TylSkU .block-Qq5hxM {
+  border-color: var(--api-color-border);
+}
+
+.hasParameters-u13UWy {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+  margin-bottom: 0;
+}
+
+.hasParameters-u13UWy .api-signature-code {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+}
+
+.hasParameters-u13UWy .api-signature-code pre {
+  border-radius: 0;
+}
+

package/runtime/components/ParametersTable/index.js

@@ -0,0 +1,69 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { MarkdownContent } from "../MarkdownContent/index.js";
+import index_module from "./index.module.js";
+const ParametersTable = ({ parameters })=>{
+    if (!parameters || 0 === parameters.length) 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.table,
+        children: /*#__PURE__*/ jsx("div", {
+            className: index_module.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))
+                    })
+                ]
+            })
+        })
+    });
+};
+const components_ParametersTable = ParametersTable;
+export default components_ParametersTable;
+export { ParametersTable };

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

@@ -0,0 +1,7 @@
+import "./index_module.css";
+const index_module = {
+    table: "table-wOupSX",
+    rpDark: "rp-dark-MFxhEo",
+    scroll: "scroll-prKOBp"
+};
+export default index_module;

package/runtime/components/ParametersTable/index_module.css

@@ -0,0 +1,104 @@
+.table-wOupSX {
+  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.rp-dark-MFxhEo .table-wOupSX {
+  border-color: var(--api-color-border);
+}
+
+.scroll-prKOBp {
+  -webkit-overflow-scrolling: touch;
+  overflow-x: auto;
+}
+
+.table-wOupSX 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;
+}
+
+.table-wOupSX thead {
+  background-color: var(--api-color-bg);
+  border-bottom: 1px solid var(--api-color-border);
+}
+
+.table-wOupSX th {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  text-align: left;
+  color: var(--api-color-text);
+  white-space: nowrap;
+  font-weight: 600;
+}
+
+.table-wOupSX th:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.table-wOupSX th:nth-child(2) {
+  width: 30%;
+  min-width: 150px;
+}
+
+.table-wOupSX th:last-child {
+  width: 50%;
+}
+
+.table-wOupSX td {
+  padding: var(--api-spacing-md) var(--api-spacing-lg);
+  border-top: 1px solid var(--api-color-border);
+  vertical-align: top;
+}
+
+.table-wOupSX td:first-child {
+  width: 20%;
+  min-width: 120px;
+}
+
+.table-wOupSX td:nth-child(2) {
+  width: 30%;
+  min-width: 150px;
+}
+
+.table-wOupSX td:last-child {
+  width: 50%;
+}
+
+.table-wOupSX td code, .table-wOupSX 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;
+}
+
+.table-wOupSX td:last-child p:first-child {
+  margin-top: 0;
+}
+
+.table-wOupSX td:last-child p:last-child, .table-wOupSX td:last-child ul:last-child, .table-wOupSX td:last-child ol:last-child {
+  margin-bottom: 0;
+}
+
+@media (width <= 768px) {
+  .table-wOupSX td, .table-wOupSX th {
+    padding: var(--api-spacing-sm) var(--api-spacing-md);
+    font-size: var(--api-font-size-sm);
+  }
+
+  .table-wOupSX td:first-child, .table-wOupSX th:first-child {
+    min-width: 100px;
+  }
+
+  .table-wOupSX td:nth-child(2), .table-wOupSX th:nth-child(2) {
+    min-width: 120px;
+  }
+}
+

package/runtime/components/SignatureBlock/index.js

@@ -0,0 +1,35 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+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 from "./index.module.js";
+function SignatureBlock({ hast, heading = "Signature", id = "signature", hasParameters = false }) {
+    const { wrapped, toggleWrap } = useWrapToggle();
+    return /*#__PURE__*/ jsxs("div", {
+        className: clsx(index_module.block, hasParameters && index_module.hasParameters),
+        children: [
+            /*#__PURE__*/ jsx(SignatureToolbar, {
+                ...heading && id ? {
+                    heading: {
+                        text: heading,
+                        id,
+                        level: "h2"
+                    }
+                } : {},
+                buttons: /*#__PURE__*/ jsx(WrapSignatureButton, {
+                    wrapped: wrapped,
+                    onToggle: toggleWrap
+                })
+            }),
+            /*#__PURE__*/ jsx(SignatureCode, {
+                hast: hast,
+                wrapped: wrapped
+            })
+        ]
+    });
+}
+const components_SignatureBlock = SignatureBlock;
+export default components_SignatureBlock;
+export { SignatureBlock };

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

@@ -0,0 +1,7 @@
+import "./index_module.css";
+const index_module = {
+    block: "block-fru9Q7",
+    rpDark: "rp-dark-Bh4pwS",
+    hasParameters: "hasParameters-UU0nI6"
+};
+export default index_module;

package/runtime/components/SignatureBlock/index_module.css

@@ -0,0 +1,27 @@
+.block-fru9Q7 {
+  margin: var(--api-spacing-xl) 0;
+  border-radius: var(--api-border-radius);
+  border: 1px solid var(--api-color-border);
+  position: relative;
+  overflow: visible;
+}
+
+html.rp-dark-Bh4pwS .block-fru9Q7 {
+  border-color: var(--api-color-border);
+}
+
+.hasParameters-UU0nI6 {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+  margin-bottom: 0;
+}
+
+.hasParameters-UU0nI6 .api-signature-code {
+  border-bottom-right-radius: 0;
+  border-bottom-left-radius: 0;
+}
+
+.hasParameters-UU0nI6 .api-signature-code pre {
+  border-radius: 0;
+}
+

package/runtime/components/SignatureCode/index.js

@@ -0,0 +1,36 @@
+import { jsx } from "react/jsx-runtime";
+import clsx from "clsx";
+import { useEffect, useRef } from "react";
+import { hastToReact } from "../../utils/hast-renderer.js";
+import index_module from "./index.module.js";
+function SignatureCode({ hast, wrapped }) {
+    const containerRef = useRef(null);
+    useEffect(()=>{
+        const container = containerRef.current;
+        if (!container) return;
+        const handleMouseOver = (e)=>{
+            const target = e.target;
+            const hover = target.closest?.(".twoslash-hover");
+            if (!hover) return;
+            const popup = hover.querySelector(".twoslash-popup-container");
+            if (!popup) return;
+            const hoverRect = hover.getBoundingClientRect();
+            const containerWidth = container.getBoundingClientRect().width;
+            popup.style.setProperty("--popup-top", `${hoverRect.bottom + 4}px`);
+            popup.style.setProperty("--popup-left", `${hoverRect.left}px`);
+            popup.style.setProperty("--popup-max-width", `${0.75 * containerWidth}px`);
+        };
+        container.addEventListener("mouseover", handleMouseOver);
+        return ()=>container.removeEventListener("mouseover", handleMouseOver);
+    }, []);
+    if (!hast) return /*#__PURE__*/ jsx("div", {
+        ref: containerRef,
+        className: clsx(index_module.code, wrapped && index_module.wrapped)
+    });
+    return /*#__PURE__*/ jsx("div", {
+        ref: containerRef,
+        className: clsx("api-doc-code", index_module.code, wrapped && index_module.wrapped),
+        children: hastToReact(hast)
+    });
+}
+export { SignatureCode };

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

@@ -0,0 +1,7 @@
+import "./index_module.css";
+const index_module = {
+    code: "code-C94Xw8",
+    rpDark: "rp-dark-uV29jl",
+    wrapped: "wrapped-CCFVeG"
+};
+export default index_module;

package/runtime/components/SignatureCode/index_module.css

@@ -0,0 +1,53 @@
+.code-C94Xw8 {
+  border-bottom-left-radius: var(--api-border-radius);
+  border-bottom-right-radius: var(--api-border-radius);
+  position: relative;
+  container-type: inline-size;
+}
+
+.code-C94Xw8 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.rp-dark-uV29jl .code-C94Xw8 pre {
+  background-color: var(--shiki-dark-bg);
+}
+
+.code-C94Xw8 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;
+}
+
+.code-C94Xw8 code span {
+  color: var(--shiki-light);
+}
+
+html.rp-dark-uV29jl .code-C94Xw8 code span {
+  color: var(--shiki-dark);
+}
+
+.code-C94Xw8 .line {
+  background: none;
+  min-height: 1lh;
+}
+
+.wrapped-CCFVeG pre {
+  white-space: pre-wrap;
+  overflow-wrap: break-word;
+}
+
+.wrapped-CCFVeG code {
+  white-space: pre-wrap;
+  overflow-wrap: break-word;
+}
+

package/runtime/components/SignatureToolbar/index.js

@@ -0,0 +1,55 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import clsx from "clsx";
+import { MarkdownContent } from "../MarkdownContent/index.js";
+import index_module from "./index.module.js";
+function SignatureToolbar({ heading, summary, buttons }) {
+    const renderHeading = ()=>{
+        if (!heading) return null;
+        const HeadingTag = heading.level;
+        const headingClasses = heading.className || clsx("rp-toc-include", index_module.memberHeading, "h2" === heading.level && index_module.memberHeadingH2);
+        return /*#__PURE__*/ jsxs(HeadingTag, {
+            id: heading.id,
+            className: headingClasses,
+            children: [
+                heading.id && /*#__PURE__*/ jsx("a", {
+                    href: `#${heading.id}`,
+                    className: "rp-header-anchor rp-link",
+                    tabIndex: -1,
+                    "aria-label": "Permalink",
+                    children: "#"
+                }),
+                heading.text
+            ]
+        });
+    };
+    const renderSummary = ()=>{
+        if (!summary) return null;
+        return /*#__PURE__*/ jsx("div", {
+            className: index_module.summary,
+            children: /*#__PURE__*/ jsx(MarkdownContent, {
+                children: summary
+            })
+        });
+    };
+    if (heading) return /*#__PURE__*/ jsxs("div", {
+        className: index_module.toolbar,
+        children: [
+            /*#__PURE__*/ jsxs("div", {
+                className: index_module.toolbarLeft,
+                children: [
+                    renderHeading(),
+                    renderSummary()
+                ]
+            }),
+            /*#__PURE__*/ jsx("div", {
+                className: index_module.buttons,
+                children: buttons
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsx("div", {
+        className: index_module.toolbar,
+        children: buttons
+    });
+}
+export { SignatureToolbar };

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

@@ -0,0 +1,11 @@
+import "./index_module.css";
+const index_module = {
+    toolbar: "toolbar-UkMKNw",
+    rpDark: "rp-dark-nxUy8b",
+    memberHeading: "memberHeading-feA4hu",
+    toolbarLeft: "toolbarLeft-UmB7Yb",
+    memberHeadingH2: "memberHeadingH2-mEqox1",
+    summary: "summary-flYT6K",
+    buttons: "buttons-YWl5hD"
+};
+export default index_module;

package/runtime/components/SignatureToolbar/index_module.css

@@ -0,0 +1,124 @@
+.toolbar-UkMKNw {
+  justify-content: flex-end;
+  align-items: flex-end;
+  gap: var(--api-spacing-sm);
+  padding: var(--api-spacing-sm);
+  background-color: var(--api-color-bg);
+  border-top-left-radius: var(--api-border-radius);
+  border-top-right-radius: var(--api-border-radius);
+  display: flex;
+}
+
+html.rp-dark-nxUy8b .toolbar-UkMKNw {
+  background-color: var(--api-color-bg);
+  border-bottom-color: var(--api-color-border);
+}
+
+.toolbar-UkMKNw:has(.memberHeading-feA4hu) {
+  justify-content: space-between;
+}
+
+:is(.toolbar-UkMKNw h2, .toolbar-UkMKNw h3) {
+  font-size: var(--api-font-size-lg);
+  padding-left: var(--api-spacing-sm);
+  font-family: var(--rp-font-family-mono);
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.toolbarLeft-UmB7Yb {
+  gap: var(--api-spacing-sm);
+  flex-direction: column;
+  flex: 1;
+  display: flex;
+}
+
+.memberHeading-feA4hu {
+  font-size: var(--api-font-size-md);
+  color: var(--api-color-text);
+  height: auto;
+  font-weight: 600;
+  line-height: var(--api-line-height-base);
+  -webkit-user-select: auto;
+  user-select: auto;
+  margin: 0;
+  position: relative;
+  overflow: visible;
+}
+
+html.rp-dark-nxUy8b .memberHeading-feA4hu {
+  color: var(--api-color-text);
+}
+
+.memberHeading-feA4hu .rp-header-anchor {
+  opacity: 0;
+  font-weight: 500;
+  font-size: inherit;
+  color: var(--rp-c-brand);
+  text-decoration: none;
+  transition: color .25s, opacity .25s;
+  position: absolute;
+  left: -1.2rem;
+}
+
+.memberHeading-feA4hu:hover .rp-header-anchor {
+  opacity: .85;
+}
+
+.memberHeading-feA4hu .rp-header-anchor:hover {
+  border-bottom: 1px solid var(--rp-c-brand);
+  opacity: .85;
+}
+
+.memberHeadingH2-mEqox1 {
+  font-size: var(--api-font-size-lg);
+  text-transform: lowercase;
+  border-top: none;
+  margin-top: 0;
+  margin-bottom: 0;
+  padding-top: 0;
+  font-weight: 600;
+  line-height: 2rem;
+}
+
+.memberHeadingH2-mEqox1:before, .memberHeadingH2-mEqox1:after {
+  content: none;
+  margin: 0;
+  padding: 0;
+  display: none;
+}
+
+.memberHeadingH2-mEqox1 .rp-header-anchor {
+  font-size: var(--api-font-size-lg);
+  left: -1.5rem;
+}
+
+.summary-flYT6K {
+  padding: 0;
+  padding-left: var(--api-spacing-sm);
+  font-size: var(--api-font-size-md);
+  line-height: var(--api-line-height-base);
+  color: var(--api-color-text-secondary);
+  background-color: #0000;
+  border: none;
+}
+
+html.rp-dark-nxUy8b .summary-flYT6K {
+  color: var(--api-color-text-secondary);
+  background-color: #0000;
+  border: none;
+}
+
+.summary-flYT6K p:first-child {
+  margin-top: 0;
+}
+
+.summary-flYT6K p:last-child, .summary-flYT6K ul:last-child, .summary-flYT6K ol:last-child {
+  margin-bottom: 0;
+}
+
+.buttons-YWl5hD {
+  gap: var(--api-spacing-sm);
+  display: flex;
+}
+