/* auto-generated by NAPI-RS */
/* eslint-disable */
/**
 * napi 边界的配置形状（与文件层 `BumpConfig` 逐键成对，另多 overrides 专用
 * 机制键 `configFilePath`）。字段全 Option——缺失 / null 即「未声明」，
 * 回落内建默认是合并层语义；serde 往返（round-trip 测试钉死两视图一致）
 * 供边界产物转 Map 与测试构造
 */
export interface BumpConfig {
  '$schema'?: string
  all?: boolean
  changelog?: ChangelogSection
  commit?: boolean | string
  confirm?: boolean
  currentVersion?: string
  execute?: string
  files?: Array<string>
  gitlab?: GitlabSection
  ignoreScripts?: boolean
  install?: boolean
  noGitCheck?: boolean
  noVerify?: boolean
  preid?: string
  push?: boolean
  recursive?: boolean
  release?: string
  scripts?: ScriptsSection
  sign?: boolean
  tag?: boolean | string
  /** overrides 专用机制键（指定配置文件路径）；文件层白名单不收 */
  configFilePath?: string
}

/** 上游 `operation.state` 的形状 */
export interface BumpState {
  release?: string
  currentVersion: string
  currentVersionSource: string
  newVersion: string
  commitMessage: string
  tagName: string
  updatedFiles: Array<string>
  skippedFiles: Array<string>
}

/**
 * 完整 bump 编排：统一配置解析 → 交互选版本 → changelog → 文件/脚本/git →
 * 可选平台 Release（`provider` 传 'github' | 'gitlab' | 'gitee' | 'gitcode' 时）。
 * `overrides` 为类型化配置覆盖（ADR-0037：类型不符在边界即运行期报错）
 */
export declare function bumpVersion(overrides?: BumpConfig | undefined | null, provider?: string | undefined | null, cwd?: string | undefined | null): Promise<BumpVersionResult>

/** `bumpVersion` 返回（ADR-0014 收缩后的 `BumpVersion` 形状） */
export interface BumpVersionResult {
  bumpp: BumpState
  changelog?: GenerateChangelogResult
}

/**
 * `changelog` 段（键集对齐文件层 `ChangelogSection` 与消费侧
 * `resolve_changelog_config`）
 */
export interface ChangelogSection {
  output?: string
  /**
   * type 分组表：值形态见 `ChangelogTypeValue`；IndexMap 保声明序
   * （声明序即 markdown 分组序）
   */
  types?: ChangelogTypes
  repo?: string | RepoConfig
  scopeMap?: Record<string, string>
  noAuthors?: boolean
  hideAuthorEmail?: boolean
  excludeAuthors?: Array<string>
  templates?: TemplatesSection
  commitMessage?: string
}

/**
 * `changelog.types` 单组条目：title / excludeScopes 均缺省即 no-op
 * （按键深合并语义在消费侧）
 */
export interface ChangelogTypeEntry {
  title?: string
  excludeScopes?: Array<string>
}

/** `changelog.types` 分组表：IndexMap 保 JS 对象声明序 */
export type ChangelogTypes =
  Record<string, ChangelogTypeValue>

/**
 * `changelog.types` 单值形态：null 跳过、boolean 启用/禁用该组、
 * `{ title?: string, excludeScopes?: string[] }` 覆盖组标题与 scope 级
 * 排除（别名进 d.ts，schema 名对齐文件层 `TypesValue` 的 JSON Schema 名）
 */
export type ChangelogTypeValue =
  boolean | ChangelogTypeEntry | undefined | null

/**
 * CLI：argv 全权交 Rust 解析执行，返回退出码由调用壳回写 `process.exitCode`；
 * `provider` 为平台变体身份（`@vill-v/bumpp-github` 等变体 bin 经位置参数注入）
 */
export declare function cliRun(argv: Array<string>, provider?: string | undefined | null): Promise<number>

/** changelog 生成结果 */
export interface GenerateChangelogResult {
  markdown: string
  changelogMD: string
}

/** `gitlab` 段：自建实例 host（键名严格集由消费侧 pre-pass 把关） */
export interface GitlabSection {
  host?: string
}

/** `changelog.repo` 的对象形态（provider / domain / repo 三可选键） */
export interface RepoConfig {
  provider?: string
  domain?: string
  repo?: string
}

/** `scripts` 段：三个时序槽位各自的 shell 命令串 */
export interface ScriptsSection {
  preversion?: string
  version?: string
  postversion?: string
}

/** `changelog.templates` 段：形状上仅 `tagBody` */
export interface TemplatesSection {
  tagBody?: string
}