ardo 3.1.0 → 3.2.0

package/dist/chunk-PGHUPTGL.js

@@ -1,1035 +0,0 @@
-// src/typedoc/generator.ts
-import {
-  Application,
-  TSConfigReader,
-  TypeDocReader,
-  ReflectionKind
-} from "typedoc";
-import path from "path";
-import fs from "fs/promises";
-import { readPackageUp } from "read-package-up";
-var TypeDocGenerator = class {
-  config;
-  app;
-  project;
-  basePath;
-  packageNameCache = /* @__PURE__ */ new Map();
-  constructor(config) {
-    this.config = {
-      out: "api",
-      excludeExternals: true,
-      excludePrivate: true,
-      excludeProtected: false,
-      excludeInternal: true,
-      sort: ["source-order"],
-      sidebar: {
-        title: "API Reference",
-        position: 100,
-        collapsed: false
-      },
-      markdown: {
-        breadcrumbs: true,
-        hierarchy: true,
-        sourceLinks: true,
-        codeBlocks: true
-      },
-      ...config
-    };
-    this.basePath = "/" + this.config.out;
-  }
-  async generate(outputDir) {
-    await Promise.all(this.config.entryPoints.map((ep) => this.resolvePackageName(ep)));
-    const typedocOptions = {
-      entryPoints: this.config.entryPoints,
-      tsconfig: this.config.tsconfig,
-      excludeExternals: this.config.excludeExternals,
-      excludePrivate: this.config.excludePrivate,
-      excludeProtected: this.config.excludeProtected,
-      excludeInternal: this.config.excludeInternal,
-      sort: this.config.sort
-    };
-    if (this.config.exclude) typedocOptions.exclude = this.config.exclude;
-    if (this.config.categoryOrder) typedocOptions.categoryOrder = this.config.categoryOrder;
-    if (this.config.groupOrder) typedocOptions.groupOrder = this.config.groupOrder;
-    if (this.config.plugin) typedocOptions.plugin = this.config.plugin;
-    if (this.config.readme) typedocOptions.readme = this.config.readme;
-    this.app = await Application.bootstrapWithPlugins(typedocOptions, [
-      new TSConfigReader(),
-      new TypeDocReader()
-    ]);
-    this.project = await this.app.convert();
-    if (!this.project) {
-      throw new Error("TypeDoc conversion failed");
-    }
-    const docs = this.generateMarkdownDocs();
-    const apiDir = path.join(outputDir, this.config.out);
-    await fs.mkdir(apiDir, { recursive: true });
-    for (const doc of docs) {
-      const filePath = path.join(apiDir, doc.path);
-      const dir = path.dirname(filePath);
-      await fs.mkdir(dir, { recursive: true });
-      const frontmatterLines = [
-        "---",
-        `title: ${doc.frontmatter.title}`,
-        doc.frontmatter.description ? `description: ${doc.frontmatter.description}` : null,
-        doc.frontmatter.sidebar_position !== void 0 ? `sidebar_position: ${doc.frontmatter.sidebar_position}` : null,
-        doc.frontmatter.sidebar === false ? `sidebar: false` : null,
-        "---"
-      ].filter((line) => line !== null);
-      const frontmatter = frontmatterLines.join("\n") + "\n\n";
-      await fs.writeFile(filePath, frontmatter + doc.content);
-    }
-    return docs;
-  }
-  generateMarkdownDocs() {
-    if (!this.project) return [];
-    const docs = [];
-    docs.push(this.generateIndexPage());
-    const children = this.project.children || [];
-    const functionsByFile = /* @__PURE__ */ new Map();
-    const typesByFile = /* @__PURE__ */ new Map();
-    const componentItems = [];
-    const standaloneItems = [];
-    for (const child of children) {
-      const sourceFile = child.sources?.[0]?.fileName;
-      if (child.kind === ReflectionKind.Function && sourceFile) {
-        if (this.isReactComponent(child.name)) {
-          componentItems.push(child);
-        } else {
-          const existing = functionsByFile.get(sourceFile) || [];
-          existing.push(child);
-          functionsByFile.set(sourceFile, existing);
-        }
-      } else if (child.kind === ReflectionKind.TypeAlias && sourceFile) {
-        const existing = typesByFile.get(sourceFile) || [];
-        existing.push(child);
-        typesByFile.set(sourceFile, existing);
-      } else {
-        standaloneItems.push(child);
-      }
-    }
-    for (const [sourceFile, functions] of functionsByFile) {
-      docs.push(this.generateGroupedFunctionsPage(sourceFile, functions));
-    }
-    for (const [sourceFile, types] of typesByFile) {
-      docs.push(this.generateGroupedTypesPage(sourceFile, types));
-    }
-    const sortedComponents = [...componentItems].sort((a, b) => a.name.localeCompare(b.name));
-    for (let i = 0; i < sortedComponents.length; i++) {
-      const prev = i > 0 ? sortedComponents[i - 1] : null;
-      const next = i < sortedComponents.length - 1 ? sortedComponents[i + 1] : null;
-      docs.push(this.generateComponentPage(sortedComponents[i], prev, next));
-    }
-    const itemsByKind = /* @__PURE__ */ new Map();
-    for (const child of standaloneItems) {
-      const kind = child.kind;
-      const existing = itemsByKind.get(kind) || [];
-      existing.push(child);
-      itemsByKind.set(kind, existing);
-    }
-    for (const [, items] of itemsByKind) {
-      const sortedItems = [...items].sort((a, b) => a.name.localeCompare(b.name));
-      for (let i = 0; i < sortedItems.length; i++) {
-        const prev = i > 0 ? sortedItems[i - 1] : null;
-        const next = i < sortedItems.length - 1 ? sortedItems[i + 1] : null;
-        docs.push(...this.generateReflectionDocs(sortedItems[i], "", prev, next));
-      }
-    }
-    docs.push(
-      ...this.generateCategoryIndexPages(
-        docs,
-        componentItems,
-        functionsByFile,
-        typesByFile,
-        standaloneItems
-      )
-    );
-    return docs;
-  }
-  generateCategoryIndexPages(docs, componentItems, functionsByFile, typesByFile, standaloneItems) {
-    const indexPages = [];
-    if (componentItems.length > 0) {
-      const sorted = [...componentItems].sort((a, b) => a.name.localeCompare(b.name));
-      const content = [
-        `# Components`,
-        "",
-        ...sorted.map((c) => {
-          const desc = c.comment?.summary ? ` - ${this.renderCommentShort(c.comment.summary)}` : "";
-          return `- [${c.name}](${this.buildLink("components", this.getSlug(c.name))})${desc}`;
-        }),
-        ""
-      ];
-      indexPages.push({
-        path: "components/index.md",
-        content: content.join("\n"),
-        frontmatter: { title: "Components", sidebar: false }
-      });
-    }
-    if (functionsByFile.size > 0) {
-      const sortedModules = [...functionsByFile.entries()].sort(
-        (a, b) => this.getModuleNameFromPath(a[0]).localeCompare(this.getModuleNameFromPath(b[0]))
-      );
-      const content = [
-        `# Functions`,
-        "",
-        ...sortedModules.map(([sourceFile, functions]) => {
-          const moduleName = this.getModuleNameFromPath(sourceFile);
-          const slug = this.getSlug(moduleName);
-          const funcNames = functions.map((f) => f.name).sort().join(", ");
-          return `- [${moduleName}](${this.buildLink("functions", slug)}) - ${funcNames}`;
-        }),
-        ""
-      ];
-      indexPages.push({
-        path: "functions/index.md",
-        content: content.join("\n"),
-        frontmatter: { title: "Functions", sidebar: false }
-      });
-    }
-    const interfaces = standaloneItems.filter((c) => c.kind === ReflectionKind.Interface);
-    const classes = standaloneItems.filter((c) => c.kind === ReflectionKind.Class);
-    if (interfaces.length > 0) {
-      const sorted = [...interfaces].sort((a, b) => a.name.localeCompare(b.name));
-      const content = [
-        `# Interfaces`,
-        "",
-        ...sorted.map((item) => {
-          const desc = item.comment?.summary ? ` - ${this.renderCommentShort(item.comment.summary)}` : "";
-          return `- [${item.name}](${this.buildLink("interfaces", this.getSlug(item.name))})${desc}`;
-        }),
-        ""
-      ];
-      indexPages.push({
-        path: "interfaces/index.md",
-        content: content.join("\n"),
-        frontmatter: { title: "Interfaces", sidebar: false }
-      });
-    }
-    if (typesByFile.size > 0) {
-      const sortedModules = [...typesByFile.entries()].sort(
-        (a, b) => this.getModuleNameFromPath(a[0]).localeCompare(this.getModuleNameFromPath(b[0]))
-      );
-      const content = [
-        `# Types`,
-        "",
-        ...sortedModules.map(([sourceFile, types]) => {
-          const moduleName = this.getModuleNameFromPath(sourceFile);
-          const slug = this.getSlug(moduleName);
-          const typeNames = types.map((t) => t.name).sort().join(", ");
-          return `- [${moduleName}](${this.buildLink("types", slug)}) - ${typeNames}`;
-        }),
-        ""
-      ];
-      indexPages.push({
-        path: "types/index.md",
-        content: content.join("\n"),
-        frontmatter: { title: "Types", sidebar: false }
-      });
-    }
-    if (classes.length > 0) {
-      const sorted = [...classes].sort((a, b) => a.name.localeCompare(b.name));
-      const content = [
-        `# Classes`,
-        "",
-        ...sorted.map((item) => {
-          const desc = item.comment?.summary ? ` - ${this.renderCommentShort(item.comment.summary)}` : "";
-          return `- [${item.name}](${this.buildLink("classes", this.getSlug(item.name))})${desc}`;
-        }),
-        ""
-      ];
-      indexPages.push({
-        path: "classes/index.md",
-        content: content.join("\n"),
-        frontmatter: { title: "Classes", sidebar: false }
-      });
-    }
-    return indexPages;
-  }
-  generateGroupedFunctionsPage(sourceFile, functions) {
-    const moduleName = this.getModuleNameFromPath(sourceFile);
-    const slug = this.getSlug(moduleName);
-    const content = [];
-    content.push(`# ${moduleName} Functions`);
-    content.push("");
-    content.push(`Functions exported from \`${sourceFile}\``);
-    content.push("");
-    const sortedFunctions = [...functions].sort((a, b) => a.name.localeCompare(b.name));
-    for (const func of sortedFunctions) {
-      content.push(`## ${func.name}`);
-      content.push("");
-      if (func.comment?.summary) {
-        content.push(this.renderComment(func.comment.summary));
-        content.push("");
-      }
-      if (func.signatures) {
-        for (const sig of func.signatures) {
-          content.push(this.renderSignature(sig));
-          content.push("");
-        }
-      }
-      if (func.comment?.blockTags) {
-        const examples = func.comment.blockTags.filter((t) => t.tag === "@example");
-        if (examples.length > 0) {
-          content.push("### Example");
-          content.push("");
-          for (const example of examples) {
-            content.push(this.renderComment(example.content));
-            content.push("");
-          }
-        }
-      }
-      if (this.config.markdown?.sourceLinks && func.sources?.[0]) {
-        const source = func.sources[0];
-        const sourceUrl = this.getSourceUrl(source.fileName, source.line);
-        if (sourceUrl) {
-          content.push(`[Source](${sourceUrl})`);
-          content.push("");
-        }
-      }
-      content.push("---");
-      content.push("");
-    }
-    return {
-      path: `functions/${slug}.md`,
-      content: content.join("\n"),
-      frontmatter: {
-        title: `${moduleName} Functions`,
-        description: `Functions from ${sourceFile}`
-      }
-    };
-  }
-  generateGroupedTypesPage(sourceFile, types) {
-    const moduleName = this.getModuleNameFromPath(sourceFile);
-    const slug = this.getSlug(moduleName);
-    const content = [];
-    content.push(`# ${moduleName} Types`);
-    content.push("");
-    content.push(`Type definitions from \`${sourceFile}\``);
-    content.push("");
-    const sortedTypes = [...types].sort((a, b) => a.name.localeCompare(b.name));
-    for (const typeAlias of sortedTypes) {
-      content.push(`## ${typeAlias.name}`);
-      content.push("");
-      if (typeAlias.comment?.summary) {
-        content.push(this.renderComment(typeAlias.comment.summary));
-        content.push("");
-      }
-      if (typeAlias.type) {
-        content.push("```typescript");
-        content.push(`type ${typeAlias.name} = ${typeAlias.type.toString()}`);
-        content.push("```");
-        content.push("");
-      }
-      if (this.config.markdown?.sourceLinks && typeAlias.sources?.[0]) {
-        const source = typeAlias.sources[0];
-        const sourceUrl = this.getSourceUrl(source.fileName, source.line);
-        if (sourceUrl) {
-          content.push(`[Source](${sourceUrl})`);
-          content.push("");
-        }
-      }
-      content.push("---");
-      content.push("");
-    }
-    return {
-      path: `types/${slug}.md`,
-      content: content.join("\n"),
-      frontmatter: {
-        title: `${moduleName} Types`,
-        description: `Type definitions from ${sourceFile}`
-      }
-    };
-  }
-  async resolvePackageName(filePath) {
-    const dir = path.dirname(path.resolve(filePath));
-    if (this.packageNameCache.has(dir)) {
-      return this.packageNameCache.get(dir);
-    }
-    const result = await readPackageUp({ cwd: dir });
-    const name = result?.packageJson.name;
-    const resolved = name ? name.replace(/^@[^/]+\//, "") : void 0;
-    this.packageNameCache.set(dir, resolved);
-    return resolved;
-  }
-  getModuleNameFromPath(filePath) {
-    const parts = filePath.split("/");
-    const basename = (parts.pop() || filePath).replace(/\.(ts|tsx|js|jsx)$/, "");
-    const parent = parts.pop();
-    if (parent && parent !== "src") {
-      return `${parent}/${basename}`;
-    }
-    if (basename === "index") {
-      for (const packageName of this.packageNameCache.values()) {
-        if (packageName) return packageName;
-      }
-    }
-    return basename;
-  }
-  generateIndexPage() {
-    const content = [
-      `# ${this.config.sidebar?.title || "API Reference"}`,
-      "",
-      this.project?.comment?.summary ? this.renderComment(this.project.comment.summary) : "Auto-generated API documentation.",
-      ""
-    ];
-    const children = this.project?.children || [];
-    const functionsByFile = /* @__PURE__ */ new Map();
-    const typesByFile = /* @__PURE__ */ new Map();
-    const componentItems = [];
-    const standaloneItems = [];
-    for (const child of children) {
-      const sourceFile = child.sources?.[0]?.fileName;
-      if (child.kind === ReflectionKind.Function && sourceFile) {
-        if (this.isReactComponent(child.name)) {
-          componentItems.push(child);
-        } else {
-          const existing = functionsByFile.get(sourceFile) || [];
-          existing.push(child);
-          functionsByFile.set(sourceFile, existing);
-        }
-      } else if (child.kind === ReflectionKind.TypeAlias && sourceFile) {
-        const existing = typesByFile.get(sourceFile) || [];
-        existing.push(child);
-        typesByFile.set(sourceFile, existing);
-      } else {
-        standaloneItems.push(child);
-      }
-    }
-    if (componentItems.length > 0) {
-      content.push("## Components");
-      content.push("");
-      const sortedComponents = [...componentItems].sort((a, b) => a.name.localeCompare(b.name));
-      for (const component of sortedComponents) {
-        const description = component.comment?.summary ? this.renderCommentShort(component.comment.summary) : "";
-        const descSuffix = description ? ` - ${description}` : "";
-        content.push(
-          `- [${component.name}](${this.buildLink("components", this.getSlug(component.name))})${descSuffix}`
-        );
-      }
-      content.push("");
-    }
-    if (functionsByFile.size > 0) {
-      content.push("## Functions");
-      content.push("");
-      const sortedModules = [...functionsByFile.entries()].sort(
-        (a, b) => this.getModuleNameFromPath(a[0]).localeCompare(this.getModuleNameFromPath(b[0]))
-      );
-      for (const [sourceFile, functions] of sortedModules) {
-        const moduleName = this.getModuleNameFromPath(sourceFile);
-        const slug = this.getSlug(moduleName);
-        const funcNames = functions.map((f) => f.name).sort().join(", ");
-        content.push(`- [${moduleName}](${this.buildLink("functions", slug)}) - ${funcNames}`);
-      }
-      content.push("");
-    }
-    if (typesByFile.size > 0) {
-      content.push("## Type Aliases");
-      content.push("");
-      const sortedModules = [...typesByFile.entries()].sort(
-        (a, b) => this.getModuleNameFromPath(a[0]).localeCompare(this.getModuleNameFromPath(b[0]))
-      );
-      for (const [sourceFile, types] of sortedModules) {
-        const moduleName = this.getModuleNameFromPath(sourceFile);
-        const slug = this.getSlug(moduleName);
-        const typeNames = types.map((t) => t.name).sort().join(", ");
-        content.push(`- [${moduleName}](${this.buildLink("types", slug)}) - ${typeNames}`);
-      }
-      content.push("");
-    }
-    const groups = {};
-    for (const child of standaloneItems) {
-      const kindName = this.getKindGroupName(child.kind, child.name);
-      if (!groups[kindName]) {
-        groups[kindName] = [];
-      }
-      groups[kindName].push(child);
-    }
-    for (const group of Object.values(groups)) {
-      group.sort((a, b) => a.name.localeCompare(b.name));
-    }
-    const groupOrder = ["Interfaces", "Classes", "Variables", "Enums", "Other"];
-    for (const groupName of groupOrder) {
-      const group = groups[groupName];
-      if (!group || group.length === 0) continue;
-      content.push(`## ${groupName}`);
-      content.push("");
-      for (const child of group) {
-        const description = child.comment?.summary ? this.renderCommentShort(child.comment.summary) : "";
-        const descSuffix = description ? ` - ${description}` : "";
-        const groupUrlPrefix = this.getGroupUrlPrefix(child.kind);
-        content.push(
-          `- [${child.name}](${this.buildLink(groupUrlPrefix, this.getSlug(child.name))})${descSuffix}`
-        );
-      }
-      content.push("");
-    }
-    return {
-      path: "index.md",
-      content: content.join("\n"),
-      frontmatter: {
-        title: this.config.sidebar?.title || "API Reference",
-        description: "Auto-generated API documentation",
-        sidebar_position: 0
-      }
-    };
-  }
-  getKindGroupName(kind, name) {
-    if (kind === ReflectionKind.Function) {
-      if (name.startsWith("use")) {
-        return "React Hooks";
-      }
-      if (name[0] === name[0].toUpperCase() && !name.includes("_")) {
-        return "React Components";
-      }
-      return "Functions";
-    }
-    switch (kind) {
-      case ReflectionKind.Interface:
-        return "Interfaces";
-      case ReflectionKind.TypeAlias:
-        return "Types";
-      case ReflectionKind.Class:
-        return "Classes";
-      case ReflectionKind.Variable:
-        return "Variables";
-      case ReflectionKind.Enum:
-        return "Enums";
-      default:
-        return "Other";
-    }
-  }
-  generateReflectionDocs(reflection, parentPath, prev = null, next = null) {
-    const docs = [];
-    const slug = this.getSlug(reflection.name);
-    const groupPrefix = parentPath ? "" : this.getGroupUrlPrefix(reflection.kind);
-    const currentPath = parentPath ? `${parentPath}/${slug}` : groupPrefix ? `${groupPrefix}/${slug}` : slug;
-    docs.push(this.generateReflectionPage(reflection, currentPath, prev, next));
-    const children = reflection.children || [];
-    const hasOwnPage = [
-      ReflectionKind.Class,
-      ReflectionKind.Interface,
-      ReflectionKind.Enum,
-      ReflectionKind.Namespace,
-      ReflectionKind.Module
-    ];
-    for (const child of children) {
-      if (hasOwnPage.includes(child.kind)) {
-        docs.push(...this.generateReflectionDocs(child, currentPath));
-      }
-    }
-    return docs;
-  }
-  generateReflectionPage(reflection, pagePath, prev = null, next = null) {
-    const kind = this.getKindName(reflection.kind);
-    const content = [];
-    if (this.config.markdown?.breadcrumbs) {
-      content.push(this.generateBreadcrumbs(pagePath));
-      content.push("");
-    }
-    content.push(`# ${kind}: ${reflection.name}`);
-    content.push("");
-    if (reflection.comment?.summary) {
-      content.push(this.renderComment(reflection.comment.summary));
-      content.push("");
-    }
-    if (reflection.typeParameters && reflection.typeParameters.length > 0) {
-      content.push("## Type Parameters");
-      content.push("");
-      content.push(this.renderTypeParameters(reflection.typeParameters));
-      content.push("");
-    }
-    if (this.config.markdown?.hierarchy) {
-      const hierarchy = this.renderHierarchy(reflection);
-      if (hierarchy) {
-        content.push("## Hierarchy");
-        content.push("");
-        content.push(hierarchy);
-        content.push("");
-      }
-    }
-    if (reflection.signatures) {
-      content.push("## Signature");
-      content.push("");
-      for (const sig of reflection.signatures) {
-        content.push(this.renderSignature(sig));
-        content.push("");
-      }
-    }
-    const properties = (reflection.children || []).filter((c) => c.kind === ReflectionKind.Property);
-    if (properties.length > 0) {
-      content.push("## Properties");
-      content.push("");
-      for (const prop of properties) {
-        content.push(this.renderProperty(prop));
-        content.push("");
-      }
-    }
-    const methods = (reflection.children || []).filter((c) => c.kind === ReflectionKind.Method);
-    if (methods.length > 0) {
-      content.push("## Methods");
-      content.push("");
-      for (const method of methods) {
-        content.push(this.renderMethod(method));
-        content.push("");
-      }
-    }
-    const enumMembers = (reflection.children || []).filter(
-      (c) => c.kind === ReflectionKind.EnumMember
-    );
-    if (enumMembers.length > 0) {
-      content.push("## Members");
-      content.push("");
-      content.push("| Member | Value | Description |");
-      content.push("|--------|-------|-------------|");
-      for (const member of enumMembers) {
-        const value = member.defaultValue || "";
-        const desc = member.comment?.summary ? this.renderCommentShort(member.comment.summary) : "";
-        content.push(`| \`${member.name}\` | \`${value}\` | ${desc} |`);
-      }
-      content.push("");
-    }
-    if (reflection.kind === ReflectionKind.TypeAlias && reflection.type) {
-      content.push("## Type");
-      content.push("");
-      content.push("```typescript");
-      content.push(`type ${reflection.name} = ${reflection.type.toString()}`);
-      content.push("```");
-      content.push("");
-    }
-    if (this.config.markdown?.sourceLinks && reflection.sources?.[0]) {
-      const source = reflection.sources[0];
-      const sourceUrl = this.getSourceUrl(source.fileName, source.line);
-      content.push("## Source");
-      content.push("");
-      if (sourceUrl) {
-        content.push(`[${source.fileName}:${source.line}](${sourceUrl})`);
-      } else {
-        content.push(`${source.fileName}:${source.line}`);
-      }
-      content.push("");
-    }
-    if (reflection.comment?.blockTags) {
-      const examples = reflection.comment.blockTags.filter((t) => t.tag === "@example");
-      if (examples.length > 0) {
-        content.push("## Examples");
-        content.push("");
-        for (const example of examples) {
-          content.push(this.renderComment(example.content));
-          content.push("");
-        }
-      }
-      const deprecated = reflection.comment.blockTags.find((t) => t.tag === "@deprecated");
-      if (deprecated) {
-        content.push('<Warning title="Deprecated">');
-        content.push(this.renderComment(deprecated.content));
-        content.push("</Warning>");
-        content.push("");
-      }
-      const see = reflection.comment.blockTags.filter((t) => t.tag === "@see");
-      if (see.length > 0) {
-        content.push("## See Also");
-        content.push("");
-        for (const s of see) {
-          content.push(`- ${this.renderComment(s.content)}`);
-        }
-        content.push("");
-      }
-    }
-    if (prev || next) {
-      content.push("---");
-      content.push("");
-      const groupPrefix = this.getGroupUrlPrefix(reflection.kind);
-      const prevLink = prev ? `[\u2190 ${prev.name}](${this.buildLink(groupPrefix, this.getSlug(prev.name))})` : "";
-      const nextLink = next ? `[${next.name} \u2192](${this.buildLink(groupPrefix, this.getSlug(next.name))})` : "";
-      if (prev && next) {
-        content.push(`${prevLink} | ${nextLink}`);
-      } else {
-        content.push(prevLink || nextLink);
-      }
-      content.push("");
-    }
-    return {
-      path: `${pagePath}.md`,
-      content: content.join("\n"),
-      frontmatter: {
-        title: reflection.name,
-        description: reflection.comment?.summary ? this.renderCommentShort(reflection.comment.summary) : `${kind} ${reflection.name}`
-      }
-    };
-  }
-  renderSignature(sig) {
-    const lines = [];
-    if (this.config.markdown?.codeBlocks) {
-      lines.push("```typescript");
-    }
-    const typeParams = sig.typeParameters ? `<${sig.typeParameters.map((tp) => tp.name).join(", ")}>` : "";
-    const params = (sig.parameters || []).map((p) => {
-      const optional = p.flags.isOptional ? "?" : "";
-      const type = p.type ? `: ${p.type.toString()}` : "";
-      return `${p.name}${optional}${type}`;
-    }).join(", ");
-    const returnType = sig.type ? `: ${sig.type.toString()}` : "";
-    lines.push(`function ${sig.name}${typeParams}(${params})${returnType}`);
-    if (this.config.markdown?.codeBlocks) {
-      lines.push("```");
-    }
-    if (sig.parameters && sig.parameters.length > 0) {
-      lines.push("");
-      lines.push("### Parameters");
-      lines.push("");
-      lines.push("| Name | Type | Description |");
-      lines.push("|------|------|-------------|");
-      for (const param of sig.parameters) {
-        const type = param.type ? `\`${param.type.toString()}\`` : "-";
-        const desc = param.comment?.summary ? this.renderCommentShort(param.comment.summary) : "-";
-        const optional = param.flags.isOptional ? " (optional)" : "";
-        lines.push(`| ${param.name}${optional} | ${type} | ${desc} |`);
-      }
-    }
-    if (sig.type && sig.type.toString() !== "void") {
-      lines.push("");
-      lines.push("### Returns");
-      lines.push("");
-      lines.push(`\`${sig.type.toString()}\``);
-      if (sig.comment?.blockTags) {
-        const returns = sig.comment.blockTags.find((t) => t.tag === "@returns");
-        if (returns) {
-          lines.push("");
-          lines.push(this.renderComment(returns.content));
-        }
-      }
-    }
-    return lines.join("\n");
-  }
-  renderProperty(prop) {
-    const lines = [];
-    const flags = [];
-    if (prop.flags.isOptional) flags.push("optional");
-    if (prop.flags.isReadonly) flags.push("readonly");
-    if (prop.flags.isStatic) flags.push("static");
-    lines.push(`### ${prop.name}`);
-    if (flags.length > 0) {
-      lines.push(`*${flags.join(", ")}*`);
-    }
-    lines.push("");
-    if (prop.type) {
-      lines.push("```typescript");
-      lines.push(`${prop.name}: ${prop.type.toString()}`);
-      lines.push("```");
-      lines.push("");
-    }
-    if (prop.comment?.summary) {
-      lines.push(this.renderComment(prop.comment.summary));
-    }
-    if (prop.defaultValue) {
-      lines.push("");
-      lines.push(`**Default:** \`${prop.defaultValue}\``);
-    }
-    return lines.join("\n");
-  }
-  renderMethod(method) {
-    const lines = [];
-    lines.push(`### ${method.name}()`);
-    lines.push("");
-    if (method.signatures) {
-      for (const sig of method.signatures) {
-        if (sig.comment?.summary) {
-          lines.push(this.renderComment(sig.comment.summary));
-          lines.push("");
-        }
-        lines.push(this.renderSignature(sig));
-        lines.push("");
-      }
-    }
-    return lines.join("\n");
-  }
-  renderTypeParameters(typeParams) {
-    const lines = [];
-    lines.push("| Name | Constraint | Default | Description |");
-    lines.push("|------|------------|---------|-------------|");
-    for (const tp of typeParams) {
-      const constraint = tp.type ? `\`${tp.type.toString()}\`` : "-";
-      const defaultVal = tp.default ? `\`${tp.default.toString()}\`` : "-";
-      const desc = tp.comment?.summary ? this.renderCommentShort(tp.comment.summary) : "-";
-      lines.push(`| ${tp.name} | ${constraint} | ${defaultVal} | ${desc} |`);
-    }
-    return lines.join("\n");
-  }
-  renderHierarchy(reflection) {
-    const lines = [];
-    if (reflection.extendedTypes && reflection.extendedTypes.length > 0) {
-      lines.push("**Extends:**");
-      for (const t of reflection.extendedTypes) {
-        lines.push(`- \`${t.toString()}\``);
-      }
-    }
-    if (reflection.implementedTypes && reflection.implementedTypes.length > 0) {
-      lines.push("**Implements:**");
-      for (const t of reflection.implementedTypes) {
-        lines.push(`- \`${t.toString()}\``);
-      }
-    }
-    if (reflection.extendedBy && reflection.extendedBy.length > 0) {
-      lines.push("**Extended by:**");
-      for (const t of reflection.extendedBy) {
-        lines.push(`- \`${t.toString()}\``);
-      }
-    }
-    if (reflection.implementedBy && reflection.implementedBy.length > 0) {
-      lines.push("**Implemented by:**");
-      for (const t of reflection.implementedBy) {
-        lines.push(`- \`${t.toString()}\``);
-      }
-    }
-    return lines.length > 0 ? lines.join("\n") : null;
-  }
-  renderComment(parts) {
-    return parts.map((p) => p.text).join("");
-  }
-  renderCommentShort(parts) {
-    const text = this.renderComment(parts);
-    const firstSentence = text.split(/[.!?]\s/)[0];
-    return firstSentence.length < text.length ? firstSentence + "." : text;
-  }
-  generateBreadcrumbs(pagePath) {
-    const parts = pagePath.split("/");
-    const breadcrumbs = [`[API](${this.basePath})`];
-    let currentPath = "";
-    for (let i = 0; i < parts.length - 1; i++) {
-      currentPath += (currentPath ? "/" : "") + parts[i];
-      breadcrumbs.push(`[${parts[i]}](${this.basePath}/${currentPath})`);
-    }
-    breadcrumbs.push(parts[parts.length - 1]);
-    return breadcrumbs.join(" / ");
-  }
-  getKindName(kind) {
-    const kindNames = {
-      [ReflectionKind.Class]: "Class",
-      [ReflectionKind.Interface]: "Interface",
-      [ReflectionKind.Enum]: "Enum",
-      [ReflectionKind.TypeAlias]: "Type",
-      [ReflectionKind.Function]: "Function",
-      [ReflectionKind.Variable]: "Variable",
-      [ReflectionKind.Namespace]: "Namespace",
-      [ReflectionKind.Module]: "Module",
-      [ReflectionKind.Property]: "Property",
-      [ReflectionKind.Method]: "Method"
-    };
-    return kindNames[kind] || "Unknown";
-  }
-  getGroupUrlPrefix(kind) {
-    const prefixes = {
-      [ReflectionKind.Class]: "classes",
-      [ReflectionKind.Interface]: "interfaces",
-      [ReflectionKind.Enum]: "enums",
-      [ReflectionKind.Variable]: "variables",
-      [ReflectionKind.Namespace]: "namespaces",
-      [ReflectionKind.Module]: "modules"
-    };
-    return prefixes[kind] || "other";
-  }
-  getSlug(name) {
-    return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  }
-  /**
-   * Build a route-compatible link path for a category/slug pair.
-   * React Router maps "category/index.md" to the "/category" route,
-   * so links must not include a trailing "/index".
-   */
-  buildLink(category, slug) {
-    if (slug === "index") {
-      return `${this.basePath}/${category}`;
-    }
-    return `${this.basePath}/${category}/${slug}`;
-  }
-  getSourceUrl(fileName, line) {
-    if (!this.config.markdown?.sourceBaseUrl) return null;
-    const baseUrl = this.config.markdown.sourceBaseUrl.replace(/\/$/, "");
-    return `${baseUrl}/${fileName}#L${line}`;
-  }
-  /**
-   * Check if a function name looks like a React component (PascalCase)
-   */
-  isReactComponent(name) {
-    if (name[0] !== name[0].toUpperCase()) return false;
-    if (name.includes("_")) return false;
-    if (name.startsWith("use")) return false;
-    if (name.endsWith("Props") || name.endsWith("Options") || name.endsWith("Config")) return false;
-    return true;
-  }
-  /**
-   * Generate a page for a React component
-   */
-  generateComponentPage(component, prev, next) {
-    const slug = this.getSlug(component.name);
-    const groupPrefix = "components";
-    const content = [];
-    content.push(`# ${component.name}`);
-    content.push("");
-    if (component.comment?.summary) {
-      content.push(this.renderComment(component.comment.summary));
-      content.push("");
-    }
-    if (component.signatures) {
-      content.push("## Usage");
-      content.push("");
-      for (const sig of component.signatures) {
-        content.push(this.renderComponentSignature(sig, component.name));
-        content.push("");
-      }
-    }
-    if (component.comment?.blockTags) {
-      const examples = component.comment.blockTags.filter((t) => t.tag === "@example");
-      if (examples.length > 0) {
-        content.push("## Example");
-        content.push("");
-        for (const example of examples) {
-          content.push(this.renderComment(example.content));
-          content.push("");
-        }
-      }
-    }
-    if (this.config.markdown?.sourceLinks && component.sources?.[0]) {
-      const source = component.sources[0];
-      const sourceUrl = this.getSourceUrl(source.fileName, source.line);
-      if (sourceUrl) {
-        content.push(`[Source](${sourceUrl})`);
-        content.push("");
-      }
-    }
-    if (prev || next) {
-      content.push("---");
-      content.push("");
-      const prevLink = prev ? `[\u2190 ${prev.name}](${this.buildLink(groupPrefix, this.getSlug(prev.name))})` : "";
-      const nextLink = next ? `[${next.name} \u2192](${this.buildLink(groupPrefix, this.getSlug(next.name))})` : "";
-      if (prev && next) {
-        content.push(`${prevLink} | ${nextLink}`);
-      } else {
-        content.push(prevLink || nextLink);
-      }
-      content.push("");
-    }
-    return {
-      path: `${groupPrefix}/${slug}.md`,
-      content: content.join("\n"),
-      frontmatter: {
-        title: component.name,
-        description: component.comment?.summary ? this.renderCommentShort(component.comment.summary) : `${component.name} component`
-      }
-    };
-  }
-  /**
-   * Get the name of a TypeDoc type (handles reference types, etc.)
-   */
-  getTypeName(paramType) {
-    if (!paramType || typeof paramType !== "object") return null;
-    if ("name" in paramType && typeof paramType.name === "string") {
-      return paramType.name;
-    }
-    if ("type" in paramType && paramType.type === "reference") {
-      const refType = paramType;
-      return refType.name || refType.qualifiedName || null;
-    }
-    return null;
-  }
-  /**
-   * Get props from a component's parameter type
-   */
-  getPropsFromType(paramType) {
-    const props = [];
-    if (paramType && typeof paramType === "object" && "declaration" in paramType) {
-      const declaration = paramType.declaration;
-      const children = declaration.children || [];
-      for (const child of children) {
-        props.push({
-          name: child.name,
-          type: child.type ? child.type.toString() : "unknown",
-          optional: child.flags.isOptional,
-          description: child.comment?.summary ? this.renderCommentShort(child.comment.summary) : ""
-        });
-      }
-    } else {
-      const typeName = this.getTypeName(paramType);
-      if (typeName) {
-        let propsInterface = this.project?.getChildByName(typeName);
-        if (!propsInterface && this.project?.children) {
-          for (const child of this.project.children) {
-            if (child.name === typeName) {
-              propsInterface = child;
-              break;
-            }
-          }
-        }
-        if (propsInterface && "children" in propsInterface) {
-          const children = propsInterface.children || [];
-          for (const child of children) {
-            props.push({
-              name: child.name,
-              type: child.type ? child.type.toString() : "unknown",
-              optional: child.flags.isOptional,
-              description: child.comment?.summary ? this.renderCommentShort(child.comment.summary) : ""
-            });
-          }
-        }
-      }
-    }
-    return props;
-  }
-  /**
-   * Render a component signature in a more readable format
-   */
-  renderComponentSignature(sig, componentName) {
-    const lines = [];
-    const propsParam = sig.parameters?.[0];
-    const props = propsParam ? this.getPropsFromType(propsParam.type) : [];
-    const propsTypeName = propsParam?.type ? this.getTypeName(propsParam.type) : null;
-    const hasChildren = props.some((p) => p.name === "children");
-    const displayProps = props.filter((p) => p.name !== "children");
-    lines.push("```tsx");
-    lines.push(`<${componentName}`);
-    if (displayProps.length > 0) {
-      for (const prop of displayProps) {
-        const optMark = prop.optional ? "?" : "";
-        lines.push(`  ${prop.name}${optMark}={${prop.type}}`);
-      }
-    } else if (!hasChildren) {
-      lines.push(`  {...props}`);
-    }
-    if (hasChildren) {
-      lines.push(`>`);
-      lines.push(`  {children}`);
-      lines.push(`</${componentName}>`);
-    } else {
-      lines.push(`/>`);
-    }
-    lines.push("```");
-    if (props.length > 0) {
-      lines.push("");
-      if (propsTypeName) {
-        lines.push(`## [Props](${this.basePath}/interfaces/${this.getSlug(propsTypeName)})`);
-      } else {
-        lines.push("## Props");
-      }
-      lines.push("");
-      lines.push("| Prop | Type | Required | Description |");
-      lines.push("|------|------|----------|-------------|");
-      for (const prop of props) {
-        const type = `\`${prop.type}\``;
-        const required = prop.optional ? "No" : "Yes";
-        const desc = prop.description || "-";
-        lines.push(`| ${prop.name} | ${type} | ${required} | ${desc} |`);
-      }
-    }
-    return lines.join("\n");
-  }
-};
-async function generateApiDocs(config, outputDir) {
-  const generator = new TypeDocGenerator(config);
-  return generator.generate(outputDir);
-}
-
-export {
-  TypeDocGenerator,
-  generateApiDocs
-};
-//# sourceMappingURL=chunk-PGHUPTGL.js.map