rspress-plugin-api-extractor 0.1.0 → 0.1.1

package/runtime/index.js

@@ -0,0 +1,664 @@
+import "./index.css";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createElement, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import clsx from "clsx";
+import { toJsxRuntime } from "hast-util-to-jsx-runtime";
+import react_markdown from "react-markdown";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports, '__esModule', {
+            value: true
+        });
+    };
+})();
+var ExampleBlock_namespaceObject = {};
+__webpack_require__.r(ExampleBlock_namespaceObject);
+__webpack_require__.d(ExampleBlock_namespaceObject, {
+    O: ()=>ExampleBlock_ExampleBlock
+});
+var MemberSignature_namespaceObject = {};
+__webpack_require__.r(MemberSignature_namespaceObject);
+__webpack_require__.d(MemberSignature_namespaceObject, {
+    N: ()=>MemberSignature_MemberSignature
+});
+var SignatureBlock_namespaceObject = {};
+__webpack_require__.r(SignatureBlock_namespaceObject);
+__webpack_require__.d(SignatureBlock_namespaceObject, {
+    G: ()=>SignatureBlock_SignatureBlock
+});
+function decodeHast(hast, componentName) {
+    if (!hast) return null;
+    if ("string" != typeof hast) return hast;
+    try {
+        if (/^[A-Za-z0-9+/=]+$/.test(hast) && hast.length > 20) {
+            const binaryString = atob(hast);
+            const bytes = Uint8Array.from(binaryString, (char)=>char.charCodeAt(0));
+            const json = new TextDecoder("utf-8").decode(bytes);
+            return JSON.parse(json);
+        }
+        return JSON.parse(hast);
+    } catch  {
+        const name = componentName ? `${componentName}: ` : "";
+        console.warn(`${name}Failed to decode HAST`);
+        return null;
+    }
+}
+function useWrapToggle() {
+    const [wrapped, setWrapped] = useState(false);
+    const toggleWrap = ()=>{
+        setWrapped(!wrapped);
+    };
+    return {
+        wrapped,
+        toggleWrap
+    };
+}
+const index_module = {
+    buttonGroup: "buttonGroup-AcnFuI",
+    button: "button-O9z52c"
+};
+function ButtonGroup({ children }) {
+    return /*#__PURE__*/ jsx("div", {
+        className: index_module.buttonGroup,
+        children: children
+    });
+}
+function CheckIcon({ size = 16, ...props }) {
+    return /*#__PURE__*/ jsxs("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        viewBox: "0 0 24 24",
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx("title", {
+                children: "Copied"
+            }),
+            /*#__PURE__*/ jsx("path", {
+                fill: "currentColor",
+                d: "M21 7L9 19l-5.5-5.5l1.41-1.41L9 16.17L19.59 5.59L21 7Z"
+            })
+        ]
+    });
+}
+function CopyIcon({ size = 16, ...props }) {
+    return /*#__PURE__*/ jsxs("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        viewBox: "0 0 24 24",
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx("title", {
+                children: "Copy"
+            }),
+            /*#__PURE__*/ jsx("path", {
+                fill: "currentColor",
+                d: "M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12V1Z"
+            })
+        ]
+    });
+}
+function CopyCodeButton({ code }) {
+    const [copied, setCopied] = useState(false);
+    const handleCopy = useCallback(async ()=>{
+        try {
+            await navigator.clipboard.writeText(code);
+            setCopied(true);
+            setTimeout(()=>setCopied(false), 2000);
+        } catch  {
+            const textarea = document.createElement("textarea");
+            textarea.value = code;
+            textarea.style.position = "fixed";
+            textarea.style.opacity = "0";
+            document.body.appendChild(textarea);
+            textarea.select();
+            document.execCommand("copy");
+            document.body.removeChild(textarea);
+            setCopied(true);
+            setTimeout(()=>setCopied(false), 2000);
+        }
+    }, [
+        code
+    ]);
+    return /*#__PURE__*/ jsx("button", {
+        type: "button",
+        className: clsx(index_module.button, copied && "active"),
+        onClick: handleCopy,
+        "aria-label": copied ? "Copied!" : "Copy code",
+        title: copied ? "Copied!" : "Copy code",
+        children: copied ? /*#__PURE__*/ jsx(CheckIcon, {
+            size: 16
+        }) : /*#__PURE__*/ jsx(CopyIcon, {
+            size: 16
+        })
+    });
+}
+function UnwrapIcon({ size = 16, ...props }) {
+    return /*#__PURE__*/ jsxs("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        viewBox: "0 0 24 24",
+        "aria-label": "Wrapped",
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx("title", {
+                children: "Unwrap"
+            }),
+            /*#__PURE__*/ jsx("path", {
+                fill: "#22a041",
+                d: "M21 5H3v2h18zM3 19h7v-2H3zm0-6h15c1 0 2 .43 2 2s-1 2-2 2h-2v-2l-4 3l4 3v-2h2c2.95 0 4-1.27 4-4c0-2.72-1-4-4-4H3z"
+            })
+        ]
+    });
+}
+function WrapIcon({ size = 16, ...props }) {
+    return /*#__PURE__*/ jsxs("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        width: size,
+        height: size,
+        viewBox: "0 0 24 24",
+        ...props,
+        children: [
+            /*#__PURE__*/ jsx("title", {
+                children: "Wrap"
+            }),
+            /*#__PURE__*/ jsx("path", {
+                fill: "currentColor",
+                d: "M16 7H3V5h13v2M3 19h13v-2H3v2m19-7l-4-3v2H3v2h15v2l4-3Z"
+            })
+        ]
+    });
+}
+function WrapSignatureButton({ wrapped, onToggle }) {
+    return /*#__PURE__*/ jsx("button", {
+        type: "button",
+        className: clsx(index_module.button, wrapped && "active"),
+        onClick: onToggle,
+        "aria-label": wrapped ? "Disable line wrapping" : "Enable line wrapping",
+        title: wrapped ? "Disable wrapping" : "Enable wrapping",
+        children: wrapped ? /*#__PURE__*/ jsx(UnwrapIcon, {
+            size: 16
+        }) : /*#__PURE__*/ jsx(WrapIcon, {
+            size: 16
+        })
+    });
+}
+function hastToReact(hast) {
+    return toJsxRuntime(hast, {
+        Fragment: Fragment,
+        jsx: jsx,
+        jsxs: jsxs
+    });
+}
+const SignatureCode_index_module = {
+    code: "code-C94Xw8",
+    rpDark: "rp-dark-uV29jl",
+    wrapped: "wrapped-CCFVeG"
+};
+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(SignatureCode_index_module.code, wrapped && SignatureCode_index_module.wrapped)
+    });
+    return /*#__PURE__*/ jsx("div", {
+        ref: containerRef,
+        className: clsx("api-doc-code", SignatureCode_index_module.code, wrapped && SignatureCode_index_module.wrapped),
+        children: hastToReact(hast)
+    });
+}
+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 SignatureToolbar_index_module = {
+    toolbar: "toolbar-UkMKNw",
+    rpDark: "rp-dark-nxUy8b",
+    memberHeading: "memberHeading-feA4hu",
+    toolbarLeft: "toolbarLeft-UmB7Yb",
+    memberHeadingH2: "memberHeadingH2-mEqox1",
+    summary: "summary-flYT6K",
+    buttons: "buttons-YWl5hD"
+};
+function SignatureToolbar({ heading, summary, buttons }) {
+    const renderHeading = ()=>{
+        if (!heading) return null;
+        const HeadingTag = heading.level;
+        const headingClasses = heading.className || clsx("rp-toc-include", SignatureToolbar_index_module.memberHeading, "h2" === heading.level && SignatureToolbar_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: SignatureToolbar_index_module.summary,
+            children: /*#__PURE__*/ jsx(MarkdownContent, {
+                children: summary
+            })
+        });
+    };
+    if (heading) return /*#__PURE__*/ jsxs("div", {
+        className: SignatureToolbar_index_module.toolbar,
+        children: [
+            /*#__PURE__*/ jsxs("div", {
+                className: SignatureToolbar_index_module.toolbarLeft,
+                children: [
+                    renderHeading(),
+                    renderSummary()
+                ]
+            }),
+            /*#__PURE__*/ jsx("div", {
+                className: SignatureToolbar_index_module.buttons,
+                children: buttons
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsx("div", {
+        className: SignatureToolbar_index_module.toolbar,
+        children: buttons
+    });
+}
+const ExampleBlock_index_module = {
+    block: "block-g6Xu1V",
+    rpDark: "rp-dark-q3G77C"
+};
+function ExampleBlock_ExampleBlock({ hast, code }) {
+    const { wrapped, toggleWrap } = useWrapToggle();
+    return /*#__PURE__*/ jsxs("div", {
+        className: ExampleBlock_index_module.block,
+        children: [
+            /*#__PURE__*/ jsx(SignatureToolbar, {
+                buttons: /*#__PURE__*/ jsxs(ButtonGroup, {
+                    children: [
+                        code && /*#__PURE__*/ jsx(CopyCodeButton, {
+                            code: code
+                        }),
+                        /*#__PURE__*/ jsx(WrapSignatureButton, {
+                            wrapped: wrapped,
+                            onToggle: toggleWrap
+                        })
+                    ]
+                })
+            }),
+            /*#__PURE__*/ jsx(SignatureCode, {
+                hast: hast,
+                wrapped: wrapped
+            })
+        ]
+    });
+}
+function ApiExample({ code, hast }) {
+    const parsedHast = useMemo(()=>decodeHast(hast, "ApiExample"), [
+        hast
+    ]);
+    if (import.meta.env.SSG_MD) {
+        const header = "```typescript\n";
+        const footer = "\n```\n";
+        return /*#__PURE__*/ jsx(Fragment, {
+            children: `${header}${code.trim()}${footer}`
+        });
+    }
+    if (parsedHast) {
+        const { O: ExampleBlock } = ExampleBlock_namespaceObject;
+        return /*#__PURE__*/ createElement(ExampleBlock, {
+            hast: parsedHast,
+            code: code.trim()
+        });
+    }
+    return /*#__PURE__*/ jsx("pre", {
+        children: /*#__PURE__*/ jsx("code", {
+            className: "language-typescript",
+            children: code.trim()
+        })
+    });
+}
+const MemberSignature_index_module = {
+    block: "block-Qq5hxM",
+    rpDark: "rp-dark-TylSkU",
+    hasParameters: "hasParameters-u13UWy"
+};
+function MemberSignature_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(MemberSignature_index_module.block, hasParameters && MemberSignature_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 "";
+}
+function ApiMember({ code, memberName, summary, id, hast, hasParameters }) {
+    const parsedHast = useMemo(()=>decodeHast(hast, "ApiMember"), [
+        hast
+    ]);
+    const hasParamsBoolean = "string" == typeof hasParameters ? "true" === hasParameters : !!hasParameters;
+    if (import.meta.env.SSG_MD) {
+        const header = "```typescript\n";
+        const footer = "\n```\n";
+        return /*#__PURE__*/ jsxs(Fragment, {
+            children: [
+                `### ${memberName}\n\n`,
+                summary && `${summary}\n\n`,
+                `${header}${code.trim()}${footer}`
+            ]
+        });
+    }
+    if (parsedHast) {
+        const { N: MemberSignature } = MemberSignature_namespaceObject;
+        const memberProps = {
+            hast: parsedHast,
+            memberName,
+            hasParameters: hasParamsBoolean
+        };
+        if (null != summary) memberProps.summary = summary;
+        if (null != id) memberProps.id = id;
+        return /*#__PURE__*/ createElement(MemberSignature, memberProps);
+    }
+    return /*#__PURE__*/ jsxs("div", {
+        children: [
+            /*#__PURE__*/ jsx("h3", {
+                id: id,
+                children: memberName
+            }),
+            summary && /*#__PURE__*/ jsx("p", {
+                children: summary
+            }),
+            /*#__PURE__*/ jsx("pre", {
+                children: /*#__PURE__*/ jsx("code", {
+                    className: "language-typescript",
+                    children: code.trim()
+                })
+            })
+        ]
+    });
+}
+const SignatureBlock_index_module = {
+    block: "block-fru9Q7",
+    rpDark: "rp-dark-Bh4pwS",
+    hasParameters: "hasParameters-UU0nI6"
+};
+function SignatureBlock_SignatureBlock({ hast, heading = "Signature", id = "signature", hasParameters = false }) {
+    const { wrapped, toggleWrap } = useWrapToggle();
+    return /*#__PURE__*/ jsxs("div", {
+        className: clsx(SignatureBlock_index_module.block, hasParameters && SignatureBlock_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
+            })
+        ]
+    });
+}
+function ApiSignature({ code, heading: _heading = "Signature", id: _id = "signature", hast, hasParameters, hasMembers }) {
+    const parsedHast = useMemo(()=>decodeHast(hast, "ApiSignature"), [
+        hast
+    ]);
+    const hasParamsBoolean = "string" == typeof hasParameters ? "true" === hasParameters : !!hasParameters;
+    const hasMembersBoolean = "string" == typeof hasMembers ? "true" === hasMembers : !!hasMembers;
+    const hasTableBelow = hasParamsBoolean || hasMembersBoolean;
+    if (import.meta.env.SSG_MD) {
+        const header = "```typescript\n";
+        const footer = "\n```\n";
+        return /*#__PURE__*/ jsx(Fragment, {
+            children: `${header}${code.trim()}${footer}`
+        });
+    }
+    if (parsedHast) {
+        const { G: SignatureBlock } = SignatureBlock_namespaceObject;
+        return /*#__PURE__*/ createElement(SignatureBlock, {
+            hast: parsedHast,
+            hasParameters: hasTableBelow
+        });
+    }
+    return /*#__PURE__*/ jsx("pre", {
+        children: /*#__PURE__*/ jsx("code", {
+            className: "language-typescript",
+            children: code.trim()
+        })
+    });
+}
+const EnumMembersTable_index_module = {
+    table: "table-vZ4IFZ",
+    rpDark: "rp-dark-Xp3cTC",
+    scroll: "scroll-NvHud6"
+};
+const EnumMembersTable = ({ members })=>{
+    if (!members || 0 === members.length) 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: EnumMembersTable_index_module.table,
+        children: /*#__PURE__*/ jsx("div", {
+            className: EnumMembersTable_index_module.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))
+                    })
+                ]
+            })
+        })
+    });
+};
+const ParametersTable_index_module = {
+    table: "table-wOupSX",
+    rpDark: "rp-dark-MFxhEo",
+    scroll: "scroll-prKOBp"
+};
+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: ParametersTable_index_module.table,
+        children: /*#__PURE__*/ jsx("div", {
+            className: ParametersTable_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))
+                    })
+                ]
+            })
+        })
+    });
+};
+export { ApiExample, ApiMember, ApiSignature, EnumMembersTable, ExampleBlock_ExampleBlock as ExampleBlock, MemberSignature_MemberSignature as MemberSignature, ParametersTable, SignatureBlock_SignatureBlock as SignatureBlock, hastToReact };