import { type ParsedCommit } from './git.js';
/**
 * Options for changelog generation.
 */
export interface ChangelogOptions {
    /**
     * Base GitHub repository URL (e.g. "https://github.com/owner/repo").
     * When provided, each commit line is suffixed with a short-SHA link
     * to `<repoUrl>/commit/<sha>`.
     */
    repoUrl?: string;
}
/**
 * Generates a changelog entry for a release from parsed commits.
 *
 * @param version - The version being released
 * @param commits - Array of parsed conventional commits
 * @param date - The release date (defaults to today)
 * @param options - Optional formatting options (e.g. repository URL for commit links)
 * @returns Formatted changelog entry string
 */
export declare function generateChangelogEntry(version: string, commits: ParsedCommit[], date?: Date, options?: ChangelogOptions): string;
/**
 * Updates or creates a CHANGELOG.md file with a new release entry.
 *
 * @param directory - The project directory containing CHANGELOG.md
 * @param version - The version being released
 * @param commits - Array of parsed conventional commits
 * @param date - The release date (defaults to today)
 * @param options - Optional formatting options (e.g. repository URL for commit links)
 * @returns Object indicating whether the file was created or updated
 */
export declare function updateChangelog(directory: string, version: string, commits: ParsedCommit[], date?: Date, options?: ChangelogOptions): {
    created: boolean;
    path: string;
};