import { ConfigurationFiles, LocalizationDictionary, OptionConfigToType, UnknownOptionConfig } from "@cli-forge/parser";

//#region src/lib/documentation.d.ts
type Documentation = {
  name: string;
  description?: string;
  epilogue?: string;
  usage: string;
  examples: string[];
  options: Readonly<Record<string, NormalizedOptionConfig>>;
  positionals: readonly Readonly<NormalizedOptionConfig>[];
  groupedOptions: Array<{
    label: string;
    keys: Array<NormalizedOptionConfig>;
  }>;
  subcommands: Documentation[];
  /**
   * Describes how configuration is loaded for this command.
   * Each section is produced by a provider's `describeConfig` method.
   */
  configurationSources?: ConfigurationFiles.ConfigurationDocSection[];
  /**
   * Localized keys for options and commands. Maps from default key to full localization entry.
   * Only present if localization is configured.
   */
  localizedKeys?: LocalizationDictionary;
};
declare function normalizeOptionConfigForDocumentation<T extends UnknownOptionConfig>(option: T, key: string, envInfo?: {
  prefix?: string;
  enabled: boolean;
}): Omit<T, "default"> & {
  key: string;
  default?: OptionConfigToType<T> | string | undefined;
  resolvedEnvKey?: string;
  alias?: string[];
};
type NormalizedOptionConfig<T extends UnknownOptionConfig = UnknownOptionConfig> = ReturnType<typeof normalizeOptionConfigForDocumentation<T>>;
declare function generateDocumentation(cli: InternalCLI, commandChain?: string[]): Documentation;
//#endregion
export { Documentation, generateDocumentation };
//# sourceMappingURL=documentation.d.mts.map