fork-version 1.8.0 → 2.0.2

package/dist/index.d.ts

@@ -1,330 +1,294 @@
 import { z } from 'zod';
 import { ReleaseType } from 'semver';
 
-declare const ForkConfigSchema: z.ZodObject<{
+interface ParserOptions {
     /**
-     * If set, Fork-Version will print the current version and exit.
-     * @default false
+     * Pattern to match commit subjects
+     * - Expected capture groups: `type` `title`
+     * - Optional capture groups: `scope`, `breakingChange`
      */
-    inspectVersion: z.ZodBoolean;
+    subjectPattern: RegExp | undefined;
     /**
-     * List of the files to be updated.
-     * @default
-     * ```js
-     * ["bower.json", "deno.json", "deno.jsonc", "jsr.json", "jsr.jsonc", "manifest.json", "npm-shrinkwrap.json", "package-lock.json", "package.json"]
-     * ```
+     * Pattern to match merge commits
+     * - Expected capture groups: `id`, `source`
      */
-    files: z.ZodArray<z.ZodString, "many">;
+    mergePattern: RegExp | undefined;
     /**
-     * Glob pattern to match files to be updated.
-     *
-     * Internally we're using [glob](https://github.com/isaacs/node-glob) to match files.
-     *
-     * Read more about the pattern syntax [here](https://github.com/isaacs/node-glob/tree/v10.3.12?tab=readme-ov-file#glob-primer).
-     *
-     * @default undefined
-     * @example "*.json"
+     * Pattern to match revert commits
+     * - Expected capture groups: `subject`, `hash`
      */
-    glob: z.ZodOptional<z.ZodString>;
+    revertPattern: RegExp | undefined;
     /**
-     * The path Fork-Version will run from.
-     * @default
-     * ```js
-     * process.cwd()
-     * ```
+     * Pattern to match commented out lines which will be trimmed
      */
-    path: z.ZodString;
+    commentPattern: RegExp | undefined;
     /**
-     * Name of the changelog file.
-     * @default "CHANGELOG.md"
+     * Pattern to match mentions
+     * - Expected capture groups: `username`
      */
-    changelog: z.ZodString;
+    mentionPattern: RegExp | undefined;
     /**
-     * The header text for the changelog.
+     * List of action labels to match reference sections
      * @default
-     * ```markdown
-     * # Changelog
-     *
-     * All notable changes to this project will be documented in this file. See [fork-version](https://github.com/eglavin/fork-version) for commit guidelines.
-     * ```
+     * ["close", "closes", "closed", "fix", "fixes", "fixed", "resolve", "resolves", "resolved"]
      */
-    header: z.ZodString;
+    referenceActions?: string[];
     /**
-     * Specify a prefix for the created tag.
-     *
-     * For instance if your version tag is prefixed by "version/" instead of "v" you have to specify
-     * `tagPrefix: "version/"`.
-     *
-     * `tagPrefix` can also be used for a monorepo environment where you might want to deploy
-     * multiple package from the same repository. In this case you can specify a prefix for
-     * each package:
-     *
-     * | Example Value            | Tag Created                   |
-     * |:-------------------------|:------------------------------|
-     * | ""                       | `1.2.3`                       |
-     * | "version/"               | `version/1.2.3`               |
-     * | "@eglavin/fork-version-" | `@eglavin/fork-version-1.2.3` |
-     *
-     * @example "", "version/", "@eglavin/fork-version-"
-     * @default "v"
+     * Pattern to match reference sections
+     * - Expected capture groups: `action`, `reference`
      */
-    tagPrefix: z.ZodString;
+    referenceActionPattern: RegExp | undefined;
     /**
-     * Make a pre-release with optional label if given value is a string.
-     *
-     * | Example Value | Produced Version |
-     * |:--------------|:-----------------|
-     * | true          | `1.2.3-0`        |
-     * | "alpha"       | `1.2.3-alpha-0`  |
-     * | "beta"        | `1.2.3-beta-0`   |
-     *
-     * @example true, "alpha", "beta", "rc"
-     * @default undefined
-     */
-    preRelease: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-    /**
-     * If set, Fork-Version will use this version instead of trying to determine one.
-     * @example "1.0.0"
-     * @default undefined
+     * List of issue prefixes to match issue ids
+     * @default
+     * ["#"]
      */
-    currentVersion: z.ZodOptional<z.ZodString>;
+    issuePrefixes?: string[];
     /**
-     * If set, Fork-Version will attempt to update to this version, instead of incrementing using "conventional-commit".
-     * @example "2.0.0"
-     * @default undefined
+     * Pattern to match issue references
+     * - Expected capture groups: `repository`, `prefix`, `issue`
      */
-    nextVersion: z.ZodOptional<z.ZodString>;
+    issuePattern: RegExp | undefined;
     /**
-     * Release as increments the version by the specified level. Overrides the default behaviour of "conventional-commit".
-     * @example "major", "minor", "patch"
-     * @default undefined
+     * List of keywords to match note titles
+     * @default
+     * ["BREAKING CHANGE", "BREAKING-CHANGE"]
      */
-    releaseAs: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"major">, z.ZodLiteral<"minor">, z.ZodLiteral<"patch">]>>;
+    noteKeywords?: string[];
     /**
-     * Don't throw an error if multiple versions are found in the given files.
-     * @default true
+     * Pattern to match note sections
+     * - Expected capture groups: `title`
+     * - Optional capture groups: `text`
      */
+    notePattern: RegExp | undefined;
+}
+declare function createParserOptions(userOptions?: Partial<ParserOptions>): ParserOptions;
+
+declare const ForkConfigSchema: z.ZodObject<{
+    inspectVersion: z.ZodBoolean;
+    files: z.ZodArray<z.ZodString>;
+    glob: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    changelog: z.ZodString;
+    header: z.ZodString;
+    tagPrefix: z.ZodString;
+    preRelease: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    currentVersion: z.ZodOptional<z.ZodString>;
+    nextVersion: z.ZodOptional<z.ZodString>;
+    releaseAs: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"major">, z.ZodLiteral<"minor">, z.ZodLiteral<"patch">]>>;
     allowMultipleVersions: z.ZodBoolean;
-    /**
-     * Commit all changes, not just files updated by Fork-Version.
-     * @default false
-     */
     commitAll: z.ZodBoolean;
-    /**
-     * By default the conventional-changelog spec will only add commit types of `feat` and `fix` to the generated changelog.
-     * If this flag is set, all [default commit types](https://github.com/conventional-changelog/conventional-changelog-config-spec/blob/238093090c14bd7d5151eb5316e635623ce633f9/versions/2.2.0/schema.json#L18)
-     * will be added to the changelog.
-     * @default false
-     */
     changelogAll: z.ZodBoolean;
-    /**
-     * Output debug information.
-     * @default false
-     */
     debug: z.ZodBoolean;
-    /**
-     * No output will be written to disk or committed.
-     * @default false
-     */
     dryRun: z.ZodBoolean;
-    /**
-     * Run without logging to the terminal.
-     * @default false
-     */
     silent: z.ZodBoolean;
-    /**
-     * If unable to find a version in the given files, fallback and attempt to use the latest git tag.
-     * @default true
-     */
     gitTagFallback: z.ZodBoolean;
-    /**
-     * If true, git will sign the commit with the systems GPG key.
-     * @see {@link https://git-scm.com/docs/git-commit#Documentation/git-commit.txt--Sltkeyidgt Git - GPG Sign Commits}
-     * @default false
-     */
     sign: z.ZodBoolean;
-    /**
-     * If true, git will run user defined git hooks before committing.
-     * @see {@link https://git-scm.com/docs/githooks Git - Git Hooks}
-     * @default false
-     */
     verify: z.ZodBoolean;
-    /**
-     * Skip the bump step.
-     * @default false
-     */
     skipBump: z.ZodBoolean;
-    /**
-     * Skip the changelog step.
-     * @default false
-     */
     skipChangelog: z.ZodBoolean;
-    /**
-     * Skip the commit step.
-     * @default false
-     */
     skipCommit: z.ZodBoolean;
-    /**
-     * Skip the tag step.
-     * @default false
-     */
     skipTag: z.ZodBoolean;
-    /**
-     * Override the default "conventional-changelog-conventionalcommits" preset configuration.
-     */
     changelogPresetConfig: z.ZodObject<{
         types: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            /**
-             * The type of commit message.
-             * @example "feat", "fix", "chore", etc..
-             */
             type: z.ZodString;
-            /**
-             * The scope of the commit message.
-             */
             scope: z.ZodOptional<z.ZodString>;
-            /**
-             * The section of the `CHANGELOG` the commit should show up in.
-             */
             section: z.ZodOptional<z.ZodString>;
-            /**
-             * Should show in the generated changelog message?
-             */
             hidden: z.ZodOptional<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }, {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }>, "many">>;
+        }, z.core.$strip>>>;
         commitUrlFormat: z.ZodOptional<z.ZodString>;
         compareUrlFormat: z.ZodOptional<z.ZodString>;
         issueUrlFormat: z.ZodOptional<z.ZodString>;
         userUrlFormat: z.ZodOptional<z.ZodString>;
         releaseCommitMessageFormat: z.ZodOptional<z.ZodString>;
-        issuePrefixes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        commitUrlFormat?: string | undefined;
-        compareUrlFormat?: string | undefined;
-        issueUrlFormat?: string | undefined;
-        userUrlFormat?: string | undefined;
-        releaseCommitMessageFormat?: string | undefined;
-        types?: {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }[] | undefined;
-        issuePrefixes?: string[] | undefined;
-    }, {
-        commitUrlFormat?: string | undefined;
-        compareUrlFormat?: string | undefined;
-        issueUrlFormat?: string | undefined;
-        userUrlFormat?: string | undefined;
-        releaseCommitMessageFormat?: string | undefined;
-        types?: {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }[] | undefined;
-        issuePrefixes?: string[] | undefined;
-    }>;
-    /**
-     * Add a suffix to the release commit message.
-     * @example "[skip ci]"
-     */
+        issuePrefixes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
     releaseMessageSuffix: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    inspectVersion: boolean;
-    files: string[];
-    path: string;
-    changelog: string;
-    header: string;
-    tagPrefix: string;
-    allowMultipleVersions: boolean;
-    commitAll: boolean;
-    changelogAll: boolean;
-    debug: boolean;
-    dryRun: boolean;
-    silent: boolean;
-    gitTagFallback: boolean;
-    sign: boolean;
-    verify: boolean;
-    skipBump: boolean;
-    skipChangelog: boolean;
-    skipCommit: boolean;
-    skipTag: boolean;
-    changelogPresetConfig: {
-        commitUrlFormat?: string | undefined;
-        compareUrlFormat?: string | undefined;
-        issueUrlFormat?: string | undefined;
-        userUrlFormat?: string | undefined;
-        releaseCommitMessageFormat?: string | undefined;
-        types?: {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }[] | undefined;
-        issuePrefixes?: string[] | undefined;
-    };
-    glob?: string | undefined;
-    preRelease?: string | boolean | undefined;
-    currentVersion?: string | undefined;
-    nextVersion?: string | undefined;
-    releaseAs?: "major" | "minor" | "patch" | undefined;
-    releaseMessageSuffix?: string | undefined;
-}, {
-    inspectVersion: boolean;
-    files: string[];
-    path: string;
-    changelog: string;
-    header: string;
-    tagPrefix: string;
-    allowMultipleVersions: boolean;
-    commitAll: boolean;
-    changelogAll: boolean;
-    debug: boolean;
-    dryRun: boolean;
-    silent: boolean;
-    gitTagFallback: boolean;
-    sign: boolean;
-    verify: boolean;
-    skipBump: boolean;
-    skipChangelog: boolean;
-    skipCommit: boolean;
-    skipTag: boolean;
-    changelogPresetConfig: {
-        commitUrlFormat?: string | undefined;
-        compareUrlFormat?: string | undefined;
-        issueUrlFormat?: string | undefined;
-        userUrlFormat?: string | undefined;
-        releaseCommitMessageFormat?: string | undefined;
-        types?: {
-            type: string;
-            scope?: string | undefined;
-            section?: string | undefined;
-            hidden?: boolean | undefined;
-        }[] | undefined;
-        issuePrefixes?: string[] | undefined;
-    };
-    glob?: string | undefined;
-    preRelease?: string | boolean | undefined;
-    currentVersion?: string | undefined;
-    nextVersion?: string | undefined;
-    releaseAs?: "major" | "minor" | "patch" | undefined;
-    releaseMessageSuffix?: string | undefined;
-}>;
+}, z.core.$strip>;
 
 type ForkConfig = z.infer<typeof ForkConfigSchema>;
 type Config = Partial<ForkConfig>;
 
+declare class Logger {
+    private config;
+    disableLogs: boolean;
+    constructor(config: Pick<ForkConfig, "silent" | "debug" | "inspectVersion">);
+    log(...messages: any[]): void;
+    warn(...messages: any[]): void;
+    error(...messages: any[]): void;
+    debug(...messages: any[]): void;
+}
+
+interface CommitMerge {
+    id: string;
+    source: string;
+}
+interface CommitRevert {
+    hash: string;
+    subject: string;
+}
+interface CommitReference {
+    prefix: string;
+    issue: string;
+    action: string | null;
+    owner: string | null;
+    repository: string | null;
+}
+interface CommitNote {
+    title: string;
+    text: string;
+}
+interface Commit {
+    raw: string;
+    subject: string;
+    body: string;
+    hash: string;
+    /**
+     * Committer date in ISO 8601 format
+     * @example
+     * "2024-12-22T17:36:50Z"
+     */
+    date: string;
+    /**
+     * Committer name (respects .mailmap)
+     */
+    name: string;
+    /**
+     * Committer email (respects .mailmap)
+     */
+    email: string;
+    type: string;
+    scope: string;
+    breakingChange: string;
+    title: string;
+    merge: CommitMerge | null;
+    revert: CommitRevert | null;
+    mentions: string[];
+    references: CommitReference[];
+    notes: CommitNote[];
+}
+
+declare class CommitParser {
+    #private;
+    constructor(userOptions?: Partial<ParserOptions>);
+    setLogger(logger: Logger): this;
+    createCommit(): Commit;
+    /**
+     * Parse the raw commit message into its expected parts
+     * - subject
+     * - body
+     * - hash
+     * - date
+     * - name
+     * - email
+     *
+     * @throws {ParserError}
+     */
+    parseRawCommit(rawCommit: string): Commit;
+    /**
+     * Parse the commit subject into its expected parts
+     * - type
+     * - scope (optional)
+     * - breaking change (optional)
+     * - title
+     *
+     * @throws {ParserError}
+     */
+    parseSubject(commit: Commit): boolean;
+    /**
+     * Parse merge information from the commit subject
+     * @example
+     * ```txt
+     * "Merge pull request #123 from fork-version/feature"
+     * ```
+     */
+    parseMerge(commit: Commit): boolean;
+    /**
+     * Parse revert information from the commit body
+     * @example
+     * ```txt
+     * "Revert "feat: initial commit"
+     *
+     * This reverts commit 4a79e9e546b4020d2882b7810dc549fa71960f4f."
+     * ```
+     */
+    parseRevert(commit: Commit): boolean;
+    /**
+     * Search for mentions from the commit line
+     * @example
+     * ```txt
+     * "@fork-version"
+     * ```
+     */
+    parseMentions(line: string, outMentions: Set<string>): boolean;
+    /**
+     * Search for references from the commit line
+     * @example
+     * ```txt
+     * "#1234"
+     * "owner/repo#1234"
+     * ```
+     */
+    parseReferenceParts(referenceText: string, action: string | null): CommitReference[] | undefined;
+    /**
+     * Search for actions and references from the commit line
+     * @example
+     * ```txt
+     * "Closes #1234"
+     * "fixes owner/repo#1234"
+     * ```
+     */
+    parseReferences(line: string, outReferences: CommitReference[]): boolean;
+    /**
+     * Search for notes from the commit line
+     * @example
+     * ```txt
+     * "BREAKING CHANGE: this is a breaking change"
+     * ```
+     */
+    parseNotes(line: string, outNotes: CommitNote[]): boolean;
+    /**
+     * Parse the raw commit for mentions, references and notes
+     */
+    parseRawLines(commit: Commit): void;
+    /**
+     * Parse a commit log with the following format separated by new line characters:
+     * ```txt
+     * refactor: add test file
+     * Add a test file to the project
+     * 4ef2c86d393a9660aa9f753144256b1f200c16bd
+     * 2024-12-22T17:36:50Z
+     * Fork Version
+     * fork-version@example.com
+     * ```
+     *
+     * @example
+     * ```ts
+     * parse("refactor: add test file\nAdd a test file to the project\n4ef2c86d393a9660aa9f753144256b1f200c16bd\n2024-12-22T17:36:50Z\nFork Version\nfork-version@example.com");
+     * ```
+     *
+     * The expected input value can be generated by running the following command:
+     * ```sh
+     * git log --format="%s%n%b%n%H%n%cI%n%cN%n%cE%n"
+     * ```
+     * @see {@link https://git-scm.com/docs/pretty-formats|Git Pretty Format Documentation}
+     */
+    parse(rawCommit: string): Commit | undefined;
+}
+
+/**
+ * Filter out revert commits and their corresponding reverted commits,
+ * this function expects the input to be sorted by date in descending order
+ * from the most recent to the oldest commit.
+ *
+ * @example
+ * ```ts
+ * const commits: Commit[] = [...];
+ * const filteredCommits = filterRevertedCommits(commits);
+ * ```
+ */
+declare function filterRevertedCommits(parsedCommits: Commit[]): Commit[];
+
 /**
  * [Fork-Version - Config Properties](https://github.com/eglavin/fork-version/blob/main/README.md#config-properties)
  */
@@ -366,16 +330,165 @@ declare function getCliArguments(): {
 
 declare function getUserConfig(cliArguments: Partial<ReturnType<typeof getCliArguments>>): Promise<ForkConfig>;
 
-declare class Logger {
+declare class Git {
+    #private;
     private config;
-    disableLogs: boolean;
-    constructor(config: Pick<ForkConfig, "silent" | "debug" | "inspectVersion">);
-    log(...messages: any[]): void;
-    warn(...messages: any[]): void;
-    error(...messages: any[]): void;
-    debug(...messages: any[]): void;
+    constructor(config: Pick<ForkConfig, "path" | "dryRun">);
+    /**
+     * Add file contents to the index
+     *
+     * [git-add Documentation](https://git-scm.com/docs/git-add)
+     *
+     * @example
+     * ```ts
+     * await git.add("CHANGELOG.md");
+     * ```
+     */
+    add(...args: (string | undefined)[]): Promise<string>;
+    /**
+     * Record changes to the repository
+     *
+     * [git-commit Documentation](https://git-scm.com/docs/git-commit)
+     *
+     * @example
+     * ```ts
+     * await git.commit("--message", "chore(release): 1.2.3");
+     * ```
+     */
+    commit(...args: (string | undefined)[]): Promise<string>;
+    /**
+     * Create, list, delete or verify a tag object
+     *
+     * [git-tag Documentation](https://git-scm.com/docs/git-tag)
+     *
+     * @example
+     * ```ts
+     * await git.tag("--annotate", "v1.2.3", "--message", "chore(release): 1.2.3");
+     * ```
+     */
+    tag(...args: (string | undefined)[]): Promise<string>;
+    /**
+     * Show commit logs
+     *
+     * - [git-log Documentation](https://git-scm.com/docs/git-log)
+     * - [pretty-formats Documentation](https://git-scm.com/docs/pretty-formats)
+     *
+     * @example
+     * ```ts
+     * await git.log("--oneline");
+     * ```
+     */
+    log(...args: (string | undefined)[]): Promise<string>;
+    /**
+     * Check if a file is ignored by git
+     *
+     * [git-check-ignore Documentation](https://git-scm.com/docs/git-check-ignore)
+     *
+     * @example
+     * ```ts
+     * await git.isIgnored("src/my-file.txt");
+     * ```
+     */
+    isIgnored(file: string): Promise<boolean>;
+    /**
+     * Get the name of the current branch
+     *
+     * [git-rev-parse Documentation](https://git-scm.com/docs/git-rev-parse)
+     *
+     * @example
+     * ```ts
+     * await git.getBranchName(); // "main"
+     * ```
+     */
+    getBranchName(): Promise<string>;
+    /**
+     * Get the URL of the remote repository
+     *
+     * [git-config Documentation](https://git-scm.com/docs/git-config)
+     *
+     * @example
+     * ```ts
+     * await git.getRemoteUrl(); // "https://github.com/eglavin/fork-version"
+     * ```
+     */
+    getRemoteUrl(): Promise<string>;
+    /**
+     * `getTags` returns valid semver version tags in order of the commit history
+     *
+     * Using `git log` to get the commit history, we then parse the tags from the
+     * commit details which is expected to be in the following format:
+     * ```txt
+     * commit 3841b1d05750d42197fe958e3d8e06df378a842d (HEAD -> main, tag: v1.0.2, tag: v1.0.1, tag: v1.0.0)
+     * Author: Username <username@example.com>
+     * Date:   Sat Nov 9 15:00:00 2024 +0000
+     *
+     *     chore(release): v1.0.0
+     * ```
+     *
+     * - [Functionality extracted from the conventional-changelog - git-semver-tags project](https://github.com/conventional-changelog/conventional-changelog/blob/fac8045242099c016f5f3905e54e02b7d466bd7b/packages/git-semver-tags/index.js)
+     * - [conventional-changelog git-semver-tags MIT Licence](https://github.com/conventional-changelog/conventional-changelog/blob/fac8045242099c016f5f3905e54e02b7d466bd7b/packages/git-semver-tags/LICENSE.md)
+     *
+     * @example
+     * ```ts
+     * await git.getTags("v"); // ["v1.0.2", "v1.0.1", "v1.0.0"]
+     * ```
+     */
+    getTags(tagPrefix: string | undefined): Promise<string[]>;
+    /**
+     * Returns the latest git tag based on commit date
+     *
+     * @example
+     * ```ts
+     * await git.getMostRecentTag("v"); // "1.2.3"
+     * ```
+     */
+    getMostRecentTag(tagPrefix: string | undefined): Promise<string | undefined>;
+    /**
+     * Get cleaned semver tags, with any tag prefix's removed
+     *
+     * @example
+     * ```ts
+     * await git.getCleanedTags("v"); // ["1.2.3", "1.2.2", "1.2.1"]
+     * ```
+     */
+    getCleanedTags(tagPrefix: string | undefined): Promise<string[]>;
+    /**
+     * Get the highest semver version from git tags. This will return the highest
+     * semver version found for the given tag prefix, regardless of the commit date.
+     *
+     * @example
+     * ```ts
+     * await git.getHighestSemverVersionFromTags("v"); // "1.2.3"
+     * ```
+     */
+    getHighestSemverVersionFromTags(tagPrefix: string | undefined): Promise<string | undefined>;
+    /**
+     * Get commit history in a parsable format
+     *
+     * An array of strings with commit details is returned in the following format:
+     * ```txt
+     * subject
+     * body
+     * hash
+     * committer date
+     * committer name
+     * committer email
+     * ```
+     *
+     * @example
+     * ```ts
+     * await git.getCommits("v1.0.0", "HEAD", "src/utils");
+     * ```
+     */
+    getCommits(from?: string, to?: string, ...paths: string[]): Promise<string[]>;
 }
 
+interface CommitsSinceTag {
+    latestTag: string | undefined;
+    commits: Commit[];
+}
+declare function getCommitsSinceTag(config: ForkConfig, logger: Logger, git: Git): Promise<CommitsSinceTag>;
+
 interface FileState {
     name: string;
     path: string;
@@ -424,48 +537,6 @@ declare class FileManager {
     write(fileState: FileState, newVersion: string): void;
 }
 
-declare class Git {
-    private config;
-    constructor(config: Pick<ForkConfig, "path" | "dryRun">);
-    private execGit;
-    /**
-     * - [git-add Documentation](https://git-scm.com/docs/git-add)
-     */
-    add(...args: (string | undefined)[]): Promise<string>;
-    /**
-     * - [git-commit Documentation](https://git-scm.com/docs/git-commit)
-     */
-    commit(...args: (string | undefined)[]): Promise<string>;
-    /**
-     * - [git-tag Documentation](https://git-scm.com/docs/git-tag)
-     */
-    tag(...args: (string | undefined)[]): Promise<string>;
-    /**
-     * - [git-check-ignore Documentation](https://git-scm.com/docs/git-check-ignore)
-     */
-    isIgnored(file: string): Promise<boolean>;
-    getCurrentBranchName(): Promise<string>;
-    /**
-     * `getTags` returns valid semver version tags in order of the commit history.
-     *
-     * Using `git log` to get the commit history, we then parse the tags from the
-     * commit details which is expected to be in the following format:
-     * @example
-     * ```txt
-     * commit 3841b1d05750d42197fe958e3d8e06df378a842d (HEAD -> main, tag: 1.0.2)
-     * Author: Username <username@example.com>
-     * Date:   Sat Nov 9 15:00:00 2024 +0000
-     *
-     *     chore(release): 1.2.3
-     * ```
-     *
-     * - [Functionality extracted from the conventional-changelog - git-semver-tags project](https://github.com/conventional-changelog/conventional-changelog/blob/fac8045242099c016f5f3905e54e02b7d466bd7b/packages/git-semver-tags/index.js)
-     * - [conventional-changelog git-semver-tags MIT Licence](https://github.com/conventional-changelog/conventional-changelog/blob/fac8045242099c016f5f3905e54e02b7d466bd7b/packages/git-semver-tags/LICENSE.md)
-     */
-    getTags(tagPrefix: string | undefined): Promise<string[]>;
-    getLatestTag(tagPrefix: string | undefined): Promise<string>;
-}
-
 interface CurrentVersion {
     version: string;
     files: FileState[];
@@ -473,12 +544,15 @@ interface CurrentVersion {
 declare function getCurrentVersion(config: ForkConfig, logger: Logger, git: Git, fileManager: FileManager, filesToUpdate: string[]): Promise<CurrentVersion>;
 interface NextVersion {
     version: string;
-    level?: number;
-    preMajor?: boolean;
-    reason?: string;
     releaseType?: ReleaseType;
+    preMajor?: boolean;
+    changes?: {
+        major: number;
+        minor: number;
+        patch: number;
+    };
 }
-declare function getNextVersion(config: ForkConfig, logger: Logger, currentVersion: string): Promise<NextVersion>;
+declare function getNextVersion(config: ForkConfig, logger: Logger, commits: Commit[], currentVersion: string): Promise<NextVersion>;
 
 declare function updateChangelog(config: ForkConfig, logger: Logger, nextVersion: string): Promise<void>;
 
@@ -486,4 +560,4 @@ declare function commitChanges(config: ForkConfig, logger: Logger, git: Git, fil
 
 declare function tagChanges(config: ForkConfig, logger: Logger, git: Git, nextVersion: string): Promise<void>;
 
-export { type Config, type CurrentVersion, FileManager, type FileState, type ForkConfig, ForkConfigSchema, Git, type IFileManager, Logger, type NextVersion, commitChanges, defineConfig, getCurrentVersion, getNextVersion, getUserConfig, tagChanges, updateChangelog };
+export { type Commit, type CommitMerge, type CommitNote, CommitParser, type CommitReference, type CommitRevert, type CommitsSinceTag, type Config, type CurrentVersion, FileManager, type FileState, type ForkConfig, ForkConfigSchema, Git, type IFileManager, Logger, type NextVersion, type ParserOptions, commitChanges, createParserOptions, defineConfig, filterRevertedCommits, getCommitsSinceTag, getCurrentVersion, getNextVersion, getUserConfig, tagChanges, updateChangelog };