Docusaurus Plugin TypeDoc

import docusaurusPluginTypedoc from "docusaurus-plugin-typedoc";
import { PluginOptions } from "docusaurus-plugin-typedoc";

const docusaurusPluginTypedoc = require("docusaurus-plugin-typedoc");

module.exports = {
  plugins: [
    [
      'docusaurus-plugin-typedoc',
      {
        entryPoints: ['./src/index.ts'],
        tsconfig: './tsconfig.json',
        out: './docs/api',
        cleanOutputDir: true,
        disableSources: true,
        hidePageHeader: true,
        hideBreadcrumbs: true,
      }
    ]
  ]
};

module.exports = {
  plugins: [
    [
      'docusaurus-plugin-typedoc', 
      {
        id: 'api-core',
        entryPoints: ['./src/core/index.ts'],
        out: './docs/api-core',
        tsconfig: './tsconfig.json',
      }
    ],
    [
      'docusaurus-plugin-typedoc',
      {
        id: 'api-utils', 
        entryPoints: ['./src/utils/index.ts'],
        out: './docs/api-utils',
        tsconfig: './tsconfig.json',
      }
    ]
  ]
};

/**
 * Main Docusaurus plugin function for TypeDoc integration
 * @param context - Docusaurus load context containing site configuration
 * @param opts - Plugin options merged with TypeDoc options
 * @returns Promise resolving to Docusaurus plugin object
 */
export default function pluginDocusaurus(
  context: LoadContext,
  opts: Partial<PluginOptions & TypeDocOptions>
): Promise<{
  name: string;
  extendCli(cli: Cli): void;
}>;

/**
 * Plugin configuration options interface
 * Extends both typedoc-plugin-markdown and typedoc-docusaurus-theme options
 */
export interface PluginOptions 
  extends TypedocPluginMarkdownOptions, TypedocDocusaurusThemeOptions {}

/** Common options from typedoc-plugin-markdown */
interface TypedocPluginMarkdownOptions {
  /** Output file extension (default: '.md') */
  fileExtension?: string;
  /** Hide page header */
  hidePageHeader?: boolean;
  /** Hide breadcrumb navigation */
  hideBreadcrumbs?: boolean;
  /** Hide page title */
  hidePageTitle?: boolean;
  /** Flatten output files to single directory */
  flattenOutputFiles?: boolean;
  /** Entry file name */
  entryFileName?: string;
  /** Modules file name */
  modulesFileName?: string;
  /** Format for class properties */
  classPropertiesFormat?: 'list' | 'table' | 'htmlTable';
  /** Format for interface properties */
  interfacePropertiesFormat?: 'list' | 'table' | 'htmlTable';
  /** Format for enumeration members */
  enumMembersFormat?: 'list' | 'table' | 'htmlTable';
  /** Format for parameters */
  parametersFormat?: 'list' | 'table' | 'htmlTable';
  /** Format for type aliases */
  typeAliasPropertiesFormat?: 'list' | 'table' | 'htmlTable';
  /** Public path for URLs */
  publicPath?: string;
  /** Exclude scopes in paths */
  excludeScopesInPaths?: boolean;
  /** Use code blocks for signatures */
  useCodeBlocks?: boolean;
  /** Expand parameters in signatures */
  expandParameters?: boolean;
  /** Expand objects in declarations */
  expandObjects?: boolean;
  /** Clean output directory before generation */
  cleanOutputDir?: boolean;
  /** Custom anchor prefix */
  anchorPrefix?: string;
  /** Merge readme with index */
  mergeReadme?: boolean;
  /** Members with own files */
  membersWithOwnFile?: ('Enum' | 'Variable' | 'Function' | 'Class' | 'Interface' | 'TypeAlias')[];
}

/** Options from typedoc-docusaurus-theme */
interface TypedocDocusaurusThemeOptions {
  /** The value of the Docusaurus docs.path config option */  
  docsPath?: string;
  /** The value of the Docusaurus numberPrefixParser option */
  numberPrefixParser?: boolean;
  /** Configures the autogenerated sidebar */
  sidebar?: Sidebar;
}

interface LoadContext {
  /** Root directory of the Docusaurus site */
  siteDir: string;
  /** Site configuration object */
  siteConfig: {
    /** Array of configured plugins */
    plugins?: any[];
    /** Array of configured presets */
    presets?: any[];
  };
}

interface Cli {
  /** Add a new command to the CLI */
  command(name: string): Cli;
  /** Set description for the current command */
  description(desc: string): Cli;
  /** Add an option flag to the current command */
  option(flag: string, desc?: string): Cli;
  /** Set the action function for the current command */
  action(fn: (...args: any[]) => void): void;
}

interface TypeDocOptions {
  /** TypeScript configuration file path */
  tsconfig?: string;
  /** Entry points for TypeDoc analysis */
  entryPoints?: string[];
  /** Output directory for generated documentation */
  out?: string;
  /** TypeDoc plugins to load */
  plugin?: string[];
  /** Whether to watch for file changes */
  watch?: boolean;
  /** Clean output directory before generation */
  cleanOutputDir?: boolean;
  /** Disable source code links */
  disableSources?: boolean;
  /** Hide page headers in generated docs */
  hidePageHeader?: boolean;
  /** Hide breadcrumb navigation */
  hideBreadcrumbs?: boolean;
  /** TypeDoc logging level */
  logLevel?: 'Verbose' | 'Info' | 'Warn' | 'Error';
  /** Readme handling mode */
  readme?: 'none' | string;
}

interface Sidebar {
  /** Enable automatic sidebar configuration */
  autoConfiguration: boolean;
  /** Use pretty formatting in sidebar */
  pretty: boolean;
  /** Include TypeScript-specific configuration */
  typescript: boolean;
  /** CSS class name for deprecated items */
  deprecatedItemClassName: string;
}

npx docusaurus generate-typedoc