Configuration Object

function defineConfig(config: Config): Config;
function defineConfig(config: Promise<Config>): Promise<Config>;
function defineConfig(config: () => Config | Promise<Config>): Config | Promise<Config>;

interface Config {
  /** Array of generation rules */
  generator: GeneratorConfig[];
}

interface GeneratorConfig {
  /** OpenAPI document URL (or local path); string[] is tried in order */
  input?: string | string[];

  /** Request options used when fetching the OpenAPI document */
  fetchOptions?: FetchOptions;

  /** List of type identifiers to exclude from generation; matched types are referenced instead of generated */
  externalTypes?: string[];

  /** Output directory */
  output?: string;

  /** Whether to generate doc comments, default true */
  docComment?: boolean;

  /** Response MediaType; an array is tried in order */
  responseMediaType?: string | string[];

  /** Request body MediaType; an array is tried in order */
  bodyMediaType?: string | string[];

  /** Custom service name when multiple documents are used */
  serverName?: string;

  /** Generated code flavor: 'auto' | 'ts' | 'typescript' | 'module' | 'commonjs', default 'auto' */
  type?: 'auto' | 'ts' | 'typescript' | 'module' | 'commonjs';

  /** When no require is present, default to require; only applies to nullable fields */
  defaultRequire?: boolean;

  /** Plugin array */
  plugins?: ApiPlugin[];

  /** Performance config */
  performance?: PerformanceConfig;

  /** Filter or transform the generated API; returns the modified apiDescriptor */
  handleApi?: (apiDescriptor: ApiDescriptor) => ApiDescriptor | void | null | undefined;
}

interface FetchOptions {
  headers?: Record<string, string>;
  /** Timeout in milliseconds */
  timeout?: number;
  method?: MethodType;
  data?: RequestBody;
  params?: Record<string, any>;
  /** When true, non-2xx responses don't throw and still return text */
  insecure?: boolean;
}

interface PerformanceConfig {
  /** schema→TS worker pool strategy: 'auto' | number | false, default 'auto' */
  workerPool?: 'auto' | number | false;
  /** transform stage concurrency cap, default auto */
  transformConcurrency?: number;
  /** Write concurrency, default 32 */
  writeConcurrency?: number;
  /** Whether to sort the collected component types deterministically, default true */
  deterministicSort?: boolean;
}

interface GenerateApiOptions {
  /** Project root directory */
  projectPath?: string;
  /** Per-generator lifecycle progress callback */
  onProgress?: (event: GeneratorProgressEvent) => void;
}