@openpkg-ts/doc-generator 0.1.0

package/dist/shared/chunk-e5fkh3kh.js

@@ -0,0 +1,679 @@
+"use client";
+import {
+  buildSignatureString,
+  formatSchema
+} from "./chunk-taeg9090.js";
+
+// src/components/headless/CollapsibleMethod.tsx
+import { useEffect, useState } from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+
+function formatReturnType(returns) {
+  if (!returns)
+    return "void";
+  return formatSchema(returns.schema);
+}
+function formatParamPreview(params) {
+  if (!params || params.length === 0)
+    return "";
+  if (params.length === 1)
+    return params[0].name || "arg";
+  return `${params[0].name || "arg"}, ...`;
+}
+function CollapsibleMethod({
+  member,
+  defaultExpanded = false,
+  className,
+  renderHeader,
+  renderContent
+}) {
+  const [expanded, setExpanded] = useState(defaultExpanded);
+  const sig = member.signatures?.[0];
+  const hasParams = sig?.parameters && sig.parameters.length > 0;
+  const visibility = member.visibility ?? "public";
+  const flags = member.flags;
+  const isStatic = flags?.static;
+  const isAsync = flags?.async;
+  const returnType = formatReturnType(sig?.returns);
+  const paramPreview = formatParamPreview(sig?.parameters);
+  const toggle = () => setExpanded(!expanded);
+  useEffect(() => {
+    if (typeof window !== "undefined" && window.location.hash === `#${member.name}`) {
+      setExpanded(true);
+    }
+  }, [member.name]);
+  const badges = [];
+  if (visibility !== "public")
+    badges.push(visibility);
+  if (isStatic)
+    badges.push("static");
+  if (isAsync)
+    badges.push("async");
+  return /* @__PURE__ */ jsxDEV("div", {
+    id: member.name,
+    className,
+    "data-expanded": expanded,
+    children: [
+      renderHeader ? renderHeader(member, expanded, toggle) : /* @__PURE__ */ jsxDEV("button", {
+        type: "button",
+        onClick: toggle,
+        "data-header": true,
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            "data-name": true,
+            children: [
+              member.name,
+              /* @__PURE__ */ jsxDEV("span", {
+                "data-params": true,
+                children: [
+                  "(",
+                  paramPreview,
+                  ")"
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("span", {
+            "data-return": true,
+            children: returnType
+          }, undefined, false, undefined, this),
+          badges.length > 0 && /* @__PURE__ */ jsxDEV("span", {
+            "data-badges": true,
+            children: badges.map((badge) => /* @__PURE__ */ jsxDEV("span", {
+              "data-badge": badge,
+              children: badge
+            }, badge, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      expanded && (renderContent ? renderContent(member) : /* @__PURE__ */ jsxDEV("div", {
+        "data-content": true,
+        children: [
+          member.description && /* @__PURE__ */ jsxDEV("p", {
+            children: member.description
+          }, undefined, false, undefined, this),
+          hasParams && /* @__PURE__ */ jsxDEV("div", {
+            "data-params-section": true,
+            children: [
+              /* @__PURE__ */ jsxDEV("h4", {
+                children: "Parameters"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("ul", {
+                children: sig.parameters.map((param, index) => /* @__PURE__ */ jsxDEV("li", {
+                  children: [
+                    /* @__PURE__ */ jsxDEV("code", {
+                      children: [
+                        param.name,
+                        param.required === false && "?",
+                        ": ",
+                        formatSchema(param.schema)
+                      ]
+                    }, undefined, true, undefined, this),
+                    param.description && /* @__PURE__ */ jsxDEV("span", {
+                      children: param.description
+                    }, undefined, false, undefined, this)
+                  ]
+                }, param.name ?? index, true, undefined, this))
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          sig?.returns && returnType !== "void" && /* @__PURE__ */ jsxDEV("div", {
+            "data-returns-section": true,
+            children: [
+              /* @__PURE__ */ jsxDEV("h4", {
+                children: "Returns"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("code", {
+                children: returnType
+              }, undefined, false, undefined, this),
+              sig.returns.description && /* @__PURE__ */ jsxDEV("p", {
+                children: sig.returns.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this))
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/headless/ExampleBlock.tsx
+import { useState as useState2 } from "react";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+
+function getExampleCode(example) {
+  if (typeof example === "string")
+    return example;
+  return example.code;
+}
+function getExampleTitle(example) {
+  if (typeof example === "string")
+    return;
+  return example.title;
+}
+function getExampleLanguage(example) {
+  if (typeof example === "string")
+    return "typescript";
+  return example.language ?? "typescript";
+}
+function cleanCode(code) {
+  let cleaned = code.trim();
+  if (cleaned.startsWith("```")) {
+    const lines = cleaned.split(`
+`);
+    lines.shift();
+    if (lines[lines.length - 1] === "```") {
+      lines.pop();
+    }
+    cleaned = lines.join(`
+`);
+  }
+  return cleaned;
+}
+function ExampleBlock({
+  examples,
+  className,
+  renderExample
+}) {
+  const [activeIndex, setActiveIndex] = useState2(0);
+  if (!examples?.length)
+    return null;
+  const showTabs = examples.length > 1;
+  const currentExample = examples[activeIndex];
+  const code = cleanCode(getExampleCode(currentExample));
+  if (renderExample) {
+    return /* @__PURE__ */ jsxDEV2("div", {
+      className,
+      children: [
+        showTabs && /* @__PURE__ */ jsxDEV2("div", {
+          "data-tabs": true,
+          children: examples.map((example, index) => /* @__PURE__ */ jsxDEV2("button", {
+            type: "button",
+            onClick: () => setActiveIndex(index),
+            "data-active": activeIndex === index,
+            children: getExampleTitle(example) ?? `Example ${index + 1}`
+          }, index, false, undefined, this))
+        }, undefined, false, undefined, this),
+        renderExample(currentExample, activeIndex)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className,
+    children: [
+      showTabs && /* @__PURE__ */ jsxDEV2("div", {
+        "data-tabs": true,
+        children: examples.map((example, index) => /* @__PURE__ */ jsxDEV2("button", {
+          type: "button",
+          onClick: () => setActiveIndex(index),
+          "data-active": activeIndex === index,
+          children: getExampleTitle(example) ?? `Example ${index + 1}`
+        }, index, false, undefined, this))
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("pre", {
+        children: /* @__PURE__ */ jsxDEV2("code", {
+          "data-language": getExampleLanguage(currentExample),
+          children: code
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/headless/ExpandableProperty.tsx
+import { useState as useState3 } from "react";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+
+function getNestedProperties(schema) {
+  if (!schema || typeof schema !== "object")
+    return null;
+  const s = schema;
+  if (s.type === "object" && s.properties && typeof s.properties === "object") {
+    return s.properties;
+  }
+  return null;
+}
+function getRequiredFields(schema) {
+  if (!schema || typeof schema !== "object")
+    return [];
+  const s = schema;
+  if (Array.isArray(s.required)) {
+    return s.required;
+  }
+  return [];
+}
+function countProperties(schema) {
+  const props = getNestedProperties(schema);
+  return props ? Object.keys(props).length : 0;
+}
+function NestedProperty({
+  name,
+  schema,
+  required = false,
+  depth = 0
+}) {
+  const [expanded, setExpanded] = useState3(false);
+  const type = formatSchema(schema);
+  const nestedProps = getNestedProperties(schema);
+  const nestedCount = countProperties(schema);
+  const hasNested = nestedCount > 0;
+  const schemaObj = schema;
+  const description = schemaObj?.description;
+  return /* @__PURE__ */ jsxDEV3("div", {
+    "data-property": name,
+    "data-depth": depth,
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        "data-row": true,
+        children: [
+          /* @__PURE__ */ jsxDEV3("span", {
+            "data-name": true,
+            children: [
+              name,
+              !required && "?",
+              ":"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3("span", {
+            "data-type": true,
+            children: hasNested ? "object" : type
+          }, undefined, false, undefined, this),
+          description && /* @__PURE__ */ jsxDEV3("span", {
+            "data-description": true,
+            children: description
+          }, undefined, false, undefined, this),
+          hasNested && /* @__PURE__ */ jsxDEV3("button", {
+            type: "button",
+            onClick: () => setExpanded(!expanded),
+            "data-expand": true,
+            children: [
+              nestedCount,
+              " properties"
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      hasNested && expanded && nestedProps && /* @__PURE__ */ jsxDEV3("div", {
+        "data-nested": true,
+        children: Object.entries(nestedProps).map(([propName, propSchema]) => /* @__PURE__ */ jsxDEV3(NestedProperty, {
+          name: propName,
+          schema: propSchema,
+          required: getRequiredFields(schema).includes(propName),
+          depth: depth + 1
+        }, propName, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function ExpandableProperty({
+  param,
+  depth = 0,
+  className
+}) {
+  const [expanded, setExpanded] = useState3(false);
+  const type = formatSchema(param.schema);
+  const isOptional = param.required === false;
+  const nestedProps = getNestedProperties(param.schema);
+  const nestedCount = countProperties(param.schema);
+  const hasNested = nestedCount > 0;
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className,
+    "data-param": param.name,
+    "data-depth": depth,
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        "data-row": true,
+        children: [
+          /* @__PURE__ */ jsxDEV3("span", {
+            "data-name": true,
+            children: [
+              param.name,
+              isOptional && "?",
+              ":"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3("span", {
+            "data-type": true,
+            children: hasNested ? "object" : type
+          }, undefined, false, undefined, this),
+          param.description && /* @__PURE__ */ jsxDEV3("span", {
+            "data-description": true,
+            children: param.description
+          }, undefined, false, undefined, this),
+          hasNested && /* @__PURE__ */ jsxDEV3("button", {
+            type: "button",
+            onClick: () => setExpanded(!expanded),
+            "data-expand": true,
+            children: [
+              nestedCount,
+              " properties"
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      hasNested && expanded && nestedProps && /* @__PURE__ */ jsxDEV3("div", {
+        "data-nested": true,
+        children: Object.entries(nestedProps).map(([propName, propSchema]) => /* @__PURE__ */ jsxDEV3(NestedProperty, {
+          name: propName,
+          schema: propSchema,
+          required: getRequiredFields(param.schema).includes(propName),
+          depth: depth + 1
+        }, propName, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/headless/MembersTable.tsx
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+
+function groupMembersByKind(members) {
+  const groups = {
+    constructors: [],
+    properties: [],
+    methods: [],
+    accessors: [],
+    other: []
+  };
+  for (const member of members) {
+    const kind = member.kind?.toLowerCase() ?? "other";
+    if (kind === "constructor") {
+      groups.constructors.push(member);
+    } else if (kind === "property" || kind === "field") {
+      groups.properties.push(member);
+    } else if (kind === "method" || kind === "function") {
+      groups.methods.push(member);
+    } else if (kind === "getter" || kind === "setter" || kind === "accessor") {
+      groups.accessors.push(member);
+    } else {
+      groups.other.push(member);
+    }
+  }
+  return groups;
+}
+function MemberRow({ member }) {
+  const visibility = member.visibility ?? "public";
+  const flags = member.flags;
+  const isStatic = flags?.static;
+  const isAbstract = flags?.abstract;
+  const isReadonly = flags?.readonly;
+  const type = formatSchema(member.schema);
+  const sig = member.signatures?.[0];
+  let signature = "";
+  if (sig) {
+    const params = sig.parameters?.map((p) => {
+      const optional = p.required === false ? "?" : "";
+      return `${p.name}${optional}: ${formatSchema(p.schema)}`;
+    }) ?? [];
+    const returnType = formatSchema(sig.returns?.schema) ?? "void";
+    signature = `(${params.join(", ")}): ${returnType}`;
+  }
+  const badges = [];
+  if (visibility !== "public")
+    badges.push(visibility);
+  if (isStatic)
+    badges.push("static");
+  if (isAbstract)
+    badges.push("abstract");
+  if (isReadonly)
+    badges.push("readonly");
+  return /* @__PURE__ */ jsxDEV4("div", {
+    "data-member": member.name,
+    children: [
+      /* @__PURE__ */ jsxDEV4("div", {
+        children: [
+          /* @__PURE__ */ jsxDEV4("code", {
+            children: [
+              member.name,
+              signature
+            ]
+          }, undefined, true, undefined, this),
+          badges.length > 0 && /* @__PURE__ */ jsxDEV4("span", {
+            children: badges.map((badge) => /* @__PURE__ */ jsxDEV4("span", {
+              "data-badge": badge,
+              children: badge
+            }, badge, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      !signature && type !== "unknown" && /* @__PURE__ */ jsxDEV4("code", {
+        children: type
+      }, undefined, false, undefined, this),
+      member.description && /* @__PURE__ */ jsxDEV4("p", {
+        children: member.description
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function MembersTable({
+  members,
+  className,
+  groupByKind = false,
+  renderMember
+}) {
+  if (!members?.length)
+    return null;
+  if (!groupByKind) {
+    return /* @__PURE__ */ jsxDEV4("div", {
+      className,
+      children: members.map((member, index) => renderMember ? renderMember(member, index) : /* @__PURE__ */ jsxDEV4(MemberRow, {
+        member
+      }, member.name ?? index, false, undefined, this))
+    }, undefined, false, undefined, this);
+  }
+  const groups = groupMembersByKind(members);
+  return /* @__PURE__ */ jsxDEV4("div", {
+    className,
+    children: [
+      groups.constructors.length > 0 && /* @__PURE__ */ jsxDEV4("section", {
+        "data-group": "constructors",
+        children: [
+          /* @__PURE__ */ jsxDEV4("h4", {
+            children: "Constructor"
+          }, undefined, false, undefined, this),
+          groups.constructors.map((member, index) => renderMember ? renderMember(member, index) : /* @__PURE__ */ jsxDEV4(MemberRow, {
+            member
+          }, member.name ?? index, false, undefined, this))
+        ]
+      }, undefined, true, undefined, this),
+      groups.properties.length > 0 && /* @__PURE__ */ jsxDEV4("section", {
+        "data-group": "properties",
+        children: [
+          /* @__PURE__ */ jsxDEV4("h4", {
+            children: "Properties"
+          }, undefined, false, undefined, this),
+          groups.properties.map((member, index) => renderMember ? renderMember(member, index) : /* @__PURE__ */ jsxDEV4(MemberRow, {
+            member
+          }, member.name ?? index, false, undefined, this))
+        ]
+      }, undefined, true, undefined, this),
+      groups.methods.length > 0 && /* @__PURE__ */ jsxDEV4("section", {
+        "data-group": "methods",
+        children: [
+          /* @__PURE__ */ jsxDEV4("h4", {
+            children: "Methods"
+          }, undefined, false, undefined, this),
+          groups.methods.map((member, index) => renderMember ? renderMember(member, index) : /* @__PURE__ */ jsxDEV4(MemberRow, {
+            member
+          }, member.name ?? index, false, undefined, this))
+        ]
+      }, undefined, true, undefined, this),
+      groups.accessors.length > 0 && /* @__PURE__ */ jsxDEV4("section", {
+        "data-group": "accessors",
+        children: [
+          /* @__PURE__ */ jsxDEV4("h4", {
+            children: "Accessors"
+          }, undefined, false, undefined, this),
+          groups.accessors.map((member, index) => renderMember ? renderMember(member, index) : /* @__PURE__ */ jsxDEV4(MemberRow, {
+            member
+          }, member.name ?? index, false, undefined, this))
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/headless/ParamTable.tsx
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+
+function isParameter(item) {
+  return "required" in item;
+}
+function ParamRow({ item, showRequired = true }) {
+  const name = item.name ?? "arg";
+  const type = formatSchema(item.schema);
+  const description = item.description ?? "";
+  const required = isParameter(item) ? item.required : true;
+  return /* @__PURE__ */ jsxDEV5("tr", {
+    children: [
+      /* @__PURE__ */ jsxDEV5("td", {
+        children: [
+          /* @__PURE__ */ jsxDEV5("code", {
+            children: name
+          }, undefined, false, undefined, this),
+          showRequired && required && /* @__PURE__ */ jsxDEV5("span", {
+            children: "*"
+          }, undefined, false, undefined, this),
+          showRequired && !required && /* @__PURE__ */ jsxDEV5("span", {
+            children: "?"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("td", {
+        children: /* @__PURE__ */ jsxDEV5("code", {
+          children: type
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV5("td", {
+        children: description
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function ParamTable({
+  items,
+  showRequired = true,
+  className,
+  renderRow
+}) {
+  if (!items?.length)
+    return null;
+  return /* @__PURE__ */ jsxDEV5("table", {
+    className,
+    children: [
+      /* @__PURE__ */ jsxDEV5("thead", {
+        children: /* @__PURE__ */ jsxDEV5("tr", {
+          children: [
+            /* @__PURE__ */ jsxDEV5("th", {
+              children: "Name"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV5("th", {
+              children: "Type"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV5("th", {
+              children: "Description"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV5("tbody", {
+        children: items.map((item, index) => renderRow ? renderRow(item, index) : /* @__PURE__ */ jsxDEV5(ParamRow, {
+          item,
+          showRequired
+        }, item.name ?? index, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/headless/Signature.tsx
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+
+function Signature({
+  export: exp,
+  signatureIndex = 0,
+  className,
+  children
+}) {
+  const signature = buildSignatureString(exp, signatureIndex);
+  if (children) {
+    return children(signature);
+  }
+  return /* @__PURE__ */ jsxDEV6("code", {
+    className,
+    children: signature
+  }, undefined, false, undefined, this);
+}
+
+// src/components/headless/TypeTable.tsx
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
+
+function isParameter2(item) {
+  return "required" in item;
+}
+function TypeTable({
+  items,
+  showRequired = true,
+  className,
+  renderRow
+}) {
+  if (!items?.length)
+    return null;
+  return /* @__PURE__ */ jsxDEV7("table", {
+    className,
+    children: [
+      /* @__PURE__ */ jsxDEV7("thead", {
+        children: /* @__PURE__ */ jsxDEV7("tr", {
+          children: [
+            /* @__PURE__ */ jsxDEV7("th", {
+              children: "Name"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV7("th", {
+              children: "Type"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV7("th", {
+              children: "Description"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV7("tbody", {
+        children: items.map((item, index) => {
+          if (renderRow) {
+            return renderRow(item, index);
+          }
+          const name = item.name ?? `arg${index}`;
+          const type = formatSchema(item.schema);
+          const description = item.description ?? "";
+          const required = isParameter2(item) ? item.required : true;
+          return /* @__PURE__ */ jsxDEV7("tr", {
+            children: [
+              /* @__PURE__ */ jsxDEV7("td", {
+                children: [
+                  /* @__PURE__ */ jsxDEV7("code", {
+                    children: name
+                  }, undefined, false, undefined, this),
+                  showRequired && required && /* @__PURE__ */ jsxDEV7("span", {
+                    children: "*"
+                  }, undefined, false, undefined, this),
+                  showRequired && !required && /* @__PURE__ */ jsxDEV7("span", {
+                    children: "?"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV7("td", {
+                children: /* @__PURE__ */ jsxDEV7("code", {
+                  children: type
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV7("td", {
+                children: description
+              }, undefined, false, undefined, this)
+            ]
+          }, name, true, undefined, this);
+        })
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export { CollapsibleMethod, getExampleCode, getExampleTitle, getExampleLanguage, cleanCode, ExampleBlock, NestedProperty, ExpandableProperty, groupMembersByKind, MemberRow, MembersTable, ParamRow, ParamTable, Signature, TypeTable };