@ckeditor/ckeditor5-dev-changelog 50.1.0

package/dist/tasks/generatechangelogformonorepository.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ConfigBase, GenerateChangelogEntryPoint, MonoRepoConfigBase } from '../types.js';
+type MonoRepositoryConfig = ConfigBase & MonoRepoConfigBase & {
+    packagesDirectory: ConfigBase['packagesDirectory'];
+    transformScope: MonoRepoConfigBase['transformScope'];
+};
+export declare const generateChangelogForMonoRepository: GenerateChangelogEntryPoint<MonoRepositoryConfig>;
+export {};

package/dist/tasks/generatechangelogforsinglerepository.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ConfigBase, GenerateChangelogEntryPoint } from '../types.js';
+type SingleRepositoryConfig = Omit<ConfigBase, 'packagesDirectory'>;
+export declare const generateChangelogForSingleRepository: GenerateChangelogEntryPoint<SingleRepositoryConfig>;
+export {};

package/dist/template.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Options for the `generateTemplate` function.
+ */
+interface GenerateTemplateOptions {
+    directory: string;
+}
+/**
+ * Returns a filename for the template file based on the current date and git branch name.
+ * The filename is formatted as `YYYYMMDDHHMMSS_{GIT_BRANCH_NAME}.md`.
+ */
+export declare function getFileName(): Promise<string>;
+/**
+ * Generates a template file for the changelog in the specified directory.
+ */
+export declare function generateTemplate(args?: Partial<GenerateTemplateOptions>, retries?: number): Promise<void>;
+export {};

package/dist/template.js

@@ -0,0 +1,108 @@
+import { mkdir, copyFile, constants } from 'fs/promises';
+import { styleText, parseArgs, promisify } from 'util';
+import { exec } from 'child_process';
+import path from 'upath';
+import { format } from 'date-fns';
+
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+const CHANGESET_DIRECTORY = '.changelog';
+const TEMPLATE_FILE = path.join(import.meta.dirname, '../template/template.md');
+
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Default options for the `generateTemplate` function.
+ */
+const DEFAULT_OPTIONS = {
+    directory: CHANGESET_DIRECTORY
+};
+/**
+ * Reads CLI arguments and turn the keys into camelcase.
+ */
+function getCliArguments() {
+    const { values } = parseArgs({
+        options: {
+            directory: { type: 'string' }
+        },
+        // Skip `node ckeditor5-dev-changelog`.
+        args: process.argv.slice(2),
+        // Fail when unknown argument is used.
+        strict: true
+    });
+    return values;
+}
+/**
+ * Returns normalized options object for the `generateTemplate` function.
+ */
+function normalizeOptions(options) {
+    const normalized = Object.assign({}, DEFAULT_OPTIONS, options);
+    // Ensure that paths are absolute and resolve to the current working directory.
+    normalized.directory = path.resolve(process.cwd(), normalized.directory);
+    return normalized;
+}
+/**
+ * Returns the current git branch name formatted to be used in a filename.
+ */
+async function getFormattedGitBranchName() {
+    try {
+        const asyncExec = promisify(exec);
+        const { stdout } = await asyncExec('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8' });
+        return stdout
+            .trim()
+            .replace(/[^a-zA-Z0-9]/g, '_');
+    }
+    catch {
+        console.error(styleText(['red', 'bold'], 'Error: Git is not installed or the current folder is not in git repository.'));
+        process.exit(1);
+    }
+}
+/**
+ * Returns a filename for the template file based on the current date and git branch name.
+ * The filename is formatted as `YYYYMMDDHHMMSS_{GIT_BRANCH_NAME}.md`.
+ */
+async function getFileName() {
+    const date = format(new Date(), 'yyyyMMddHHmmss');
+    const gitBranchName = await getFormattedGitBranchName();
+    return `${date}_${gitBranchName}.md`;
+}
+/**
+ * Generates a template file for the changelog in the specified directory.
+ */
+async function generateTemplate(args = getCliArguments(), retries = 5) {
+    const options = normalizeOptions(args);
+    const filename = await getFileName();
+    const outputPath = path.resolve(options.directory, filename);
+    await mkdir(options.directory, { recursive: true });
+    try {
+        await copyFile(TEMPLATE_FILE, outputPath, constants.COPYFILE_EXCL);
+        const indent = ' '.repeat(3);
+        const relativePath = path.relative(process.cwd(), outputPath);
+        console.log(styleText('green', '✅ The changelog file has been successfully created.'));
+        console.log('');
+        console.log('✍️ Please fill it with relevant information about your changes.');
+        console.log(indent + styleText('cyan', `file://${outputPath}`));
+        console.log('');
+        console.log('📥 Once done, commit the changelog file:');
+        console.log(indent + styleText('gray', `$ git add ${relativePath}`));
+        console.log(indent + styleText('gray', '$ git commit -m "..."'));
+    }
+    catch (error) {
+        if (retries <= 0) {
+            console.error(styleText(['red', 'bold'], 'Error: Generating changelog file failed with the following error:'));
+            throw error;
+        }
+        console.error(styleText('gray', 'You are going to fast 🥵 Waiting 1 second to ensure unique changelog name.'));
+        return new Promise(resolve => {
+            setTimeout(() => {
+                resolve(generateTemplate(options, retries - 1));
+            }, 1000);
+        });
+    }
+}
+
+export { generateTemplate, getFileName };

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { SECTIONS } from './utils/constants.js';
+export type ConfigBase = RepositoryConfig & {
+    /**
+     * The next version number to use. If not provided, will be calculated based on changes.
+     * Can be a semver string or 'internal' for internal changes only.
+     */
+    nextVersion?: string | 'internal';
+    /**
+     * Array of external repository configurations to include in the changelog.
+     */
+    externalRepositories?: Array<RepositoryConfig>;
+    /**
+     * The date to use for the changelog entry. Defaults to current date in YYYY-MM-DD format.
+     */
+    date?: string;
+};
+export type MonoRepoConfigBase = {
+    /**
+     * Function to transform package scopes in the changelog entries.
+     */
+    transformScope?: TransformScope;
+    /**
+     * Whether to include the root package name in the bumped packages versions section in the changelog.
+     */
+    shouldIgnoreRootPackage?: unknown;
+    /**
+     * The package that will be used when determining if the next version is available on npm.
+     */
+    npmPackageToCheck?: unknown;
+} & NpmPackageRequiredWhenSkipRootPackage;
+export type RepositoryConfig = {
+    /**
+     * The current working directory of the repository.
+     */
+    cwd: string;
+    /**
+     * The directory containing the packages. Defaults to 'packages'.
+     */
+    packagesDirectory: null | string;
+    /**
+     * Whether to skip links in the changelog entries. Defaults to false.
+     */
+    shouldSkipLinks?: boolean;
+};
+export type GenerateChangelogEntryPoint<K extends object> = <T extends boolean | undefined = undefined>(config: K & {
+    /**
+     * Controls whether changeset files will be deleted after generating changelog.
+     */
+    disableFilesystemOperations?: T;
+}) => Promise<T extends true ? string : void>;
+export type SectionName = keyof typeof SECTIONS;
+export type Entry = {
+    message: string;
+    data: {
+        type: string;
+        scope: Array<string>;
+        mainContent: string | undefined;
+        restContent: Array<string>;
+        communityCredits: Array<string>;
+        validations: Array<string>;
+        see: Array<LinkObject>;
+        closes: Array<LinkObject>;
+    };
+    changesetPath: string;
+};
+export type ParsedFile<T = FileMetadata> = {
+    content: string;
+    data: T;
+    changesetPath: string;
+    createdAt: Date;
+    gitHubUrl: string;
+    shouldSkipLinks: boolean;
+};
+export type Section = {
+    entries: Array<Entry>;
+    title: string;
+    titleInLogs?: string;
+    excludeInChangelog?: boolean;
+};
+export type SectionsWithEntries = Record<SectionName, Section>;
+export type ReleaseInfo = {
+    title: string;
+    version: string;
+    packages: Array<string>;
+};
+export type TransformScope = (name: string) => {
+    displayName: string;
+    npmUrl: string;
+};
+export type ChangesetPathsWithGithubUrl = {
+    filePaths: Array<string>;
+    gitHubUrl: string;
+    shouldSkipLinks: boolean;
+    cwd: string;
+    isRoot: boolean;
+};
+type NpmPackageRequiredWhenSkipRootPackage = {
+    shouldIgnoreRootPackage?: true;
+    npmPackageToCheck: string;
+} | {
+    shouldIgnoreRootPackage?: false;
+    npmPackageToCheck?: never;
+};
+export type LinkObject = {
+    displayName: string;
+    link: string;
+};
+export type FileMetadata = {
+    type: string;
+    scope: Array<string>;
+    closes: Array<string>;
+    see: Array<string>;
+    communityCredits: Array<string>;
+    validations: Array<string>;
+};
+export {};

package/dist/utils/asyncarray.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * A utility class that wraps a Promise of an array and provides async array-like operations.
+ */
+export declare class AsyncArray<T> {
+    private readonly promise;
+    /**
+     * Creates a new `AsyncArray` instance.
+     */
+    constructor(promise: Promise<Array<T>>);
+    /**
+     * Creates an `AsyncArray` from a given promise.
+     */
+    static from<U>(promise: Promise<Array<U>>): AsyncArray<U>;
+    /**
+     * Asynchronously maps each item in the array using the provided callback.
+     */
+    map<U>(fn: (item: T, index: number, array: Array<T>) => U | Promise<U>): AsyncArray<U>;
+    /**
+     * Flattens one level of nesting in an array of arrays.
+     */
+    flat<U>(this: AsyncArray<Array<U>>): AsyncArray<U>;
+    /**
+     * Maps each item using a callback that returns an array (or promise of an array),
+     * then flattens the result by one level.
+     */
+    flatMap<U>(fn: (item: T, index: number, array: Array<T>) => Array<U> | Promise<Array<U>>): AsyncArray<U>;
+    /**
+     * Allows chaining or awaiting the result of the internal promise.
+     */
+    then<U>(onfulfilled: (value: Array<T>) => U | Promise<U>): Promise<U>;
+}

package/dist/utils/commitchanges.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ChangesetPathsWithGithubUrl } from '../types.js';
+type RepositoryData = Pick<ChangesetPathsWithGithubUrl, 'cwd' | 'isRoot' | 'filePaths'>;
+export declare function commitChanges(version: string, repositories: Array<RepositoryData>): Promise<void>;
+export {};

package/dist/utils/composechangelog.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ReleaseInfo, Section } from '../types.js';
+type ComposeChangelogOptions = {
+    cwd: string;
+    date: string;
+    currentVersion: string;
+    newVersion: string;
+    sections: Array<Section>;
+    releasedPackagesInfo: Array<ReleaseInfo>;
+    isInternal: boolean;
+    isSinglePackage: boolean;
+    packagesMetadata: Map<string, string>;
+};
+/**
+ * Generates a formatted changelog string for a new version release.
+ *
+ * This function constructs the changelog content including
+ * * A version header with a link to the GitHub comparison view (except for an initial version).
+ * * Sections with grouped changelog entries and their messages.
+ * * A collapsible summary of released packages and their version bumps for a mono-repository setup.
+ * * Special handling for internal-only releases and single-package repositories.
+ */
+export declare function composeChangelog(options: ComposeChangelogOptions): Promise<string>;
+export {};

package/dist/utils/composereleasesummary.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ReleaseInfo, SectionsWithEntries } from '../types.js';
+type ComposeReleaseSummaryOptions = {
+    sections: SectionsWithEntries;
+    currentVersion: string;
+    newVersion: string;
+    packagesMetadata: Map<string, string>;
+};
+/**
+ * Generates a categorized summary of packages released in the new version,
+ * including new packages, major, minor, feature, and other releases.
+ *
+ * This function analyzes changelog sections and package metadata to:
+ * * Identify new packages introduced with version '0.0.1'.
+ * * Group packages by release type based on the changelog sections: major, minor, and features.
+ * * Exclude packages already accounted for in higher-priority release categories from lower ones.
+ * * Provide a fallback category for "other releases" that don't fall into the above groups.
+ */
+export declare function composeReleaseSummary(options: ComposeReleaseSummaryOptions): Promise<Array<ReleaseInfo>>;
+export {};

package/dist/utils/constants.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+export declare const CHANGELOG_FILE = "CHANGELOG.md";
+export declare const CHANGELOG_HEADER = "Changelog\n=========";
+export declare const NPM_URL = "https://www.npmjs.com/package";
+export declare const VERSIONING_POLICY_URL = "https://ckeditor.com/docs/ckeditor5/latest/framework/guides/support/versioning-policy.html";
+export declare const CHANGESET_DIRECTORY = ".changelog";
+export declare const TEMPLATE_FILE: string;
+export declare const SECTIONS: {
+    readonly major: {
+        readonly title: "MAJOR BREAKING CHANGES [ℹ️](https://ckeditor.com/docs/ckeditor5/latest/framework/guides/support/versioning-policy.html#major-and-minor-breaking-changes)";
+        readonly titleInLogs: "MAJOR BREAKING CHANGES";
+    };
+    readonly minor: {
+        readonly title: "MINOR BREAKING CHANGES [ℹ️](https://ckeditor.com/docs/ckeditor5/latest/framework/guides/support/versioning-policy.html#major-and-minor-breaking-changes)";
+        readonly titleInLogs: "MINOR BREAKING CHANGES";
+    };
+    readonly breaking: {
+        readonly title: "BREAKING CHANGES";
+    };
+    readonly feature: {
+        readonly title: "Features";
+    };
+    readonly fix: {
+        readonly title: "Bug fixes";
+    };
+    readonly other: {
+        readonly title: "Other changes";
+    };
+    readonly warning: {
+        readonly title: "Incorrect values";
+        readonly excludeInChangelog: true;
+    };
+    readonly invalid: {
+        readonly title: "Invalid files";
+        readonly excludeInChangelog: true;
+    };
+};
+export declare const ISSUE_SLUG_PATTERN: RegExp;
+export declare const ISSUE_PATTERN: RegExp;
+export declare const ISSUE_URL_PATTERN: RegExp;
+export declare const TYPES: readonly [{
+    readonly name: "Feature";
+}, {
+    readonly name: "Other";
+}, {
+    readonly name: "Fix";
+}, {
+    readonly name: "Major breaking change";
+}, {
+    readonly name: "Minor breaking change";
+}, {
+    readonly name: "Breaking change";
+}];

package/dist/utils/determinenextversion.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { SectionsWithEntries } from '../types.js';
+type NextVersionOutput = {
+    isInternal: boolean;
+    newVersion: string;
+};
+export type DetermineNextVersionOptions = {
+    sections: SectionsWithEntries;
+    currentVersion: string;
+    packageName: string;
+    nextVersion: string | undefined;
+};
+/**
+ * Determines the next version for a single package or a mono-repository setup based on
+ * the change sections, * user input, and semantic versioning rules.
+ *
+ * The function handles:
+ * * Automatic version bump calculation from categorized changelog sections (major, minor, patch).
+ * * Accepting explicit next version overrides, including a special `internal` version bump.
+ * * User prompts for version input when no explicit version is provided.
+ */
+export declare function determineNextVersion(options: DetermineNextVersionOptions): Promise<NextVersionOutput>;
+export {};

package/dist/utils/displaychanges.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { SectionsWithEntries, TransformScope } from '../types.js';
+type DisplayChangesOptions = {
+    sections: SectionsWithEntries;
+    isSinglePackage: boolean;
+    transformScope?: TransformScope;
+};
+/**
+ * Displays a formatted summary of all changelog entries grouped by sections (e.g., Features, Fixes, Breaking changes).
+ *
+ * This function:
+ * * Lists all non-empty changelog sections with appropriate formatting.
+ * * Differentiates between valid and invalid entries using visual indicators (`+` for valid, `x` for invalid).
+ * * Supports both mono-repository and single package repositories through the `isSinglePackage` flag.
+ * * Applies a transformation to scope names using the `transformScope` callback for a mono-repository setup.
+ * * Outputs a helpful legend for interpreting the entry indicators.
+ */
+export declare function displayChanges(options: DisplayChangesOptions): void;
+export {};

package/dist/utils/filtervisiblesections.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { Section, SectionsWithEntries } from '../types.js';
+/**
+ * Filters and returns only those changelog sections that:
+ * * Have at least one entry.
+ * * Are not explicitly marked to be excluded from the final changelog.
+ *
+ * This is used to determine which sections should be displayed or processed for changelog generation.
+ */
+export declare function filterVisibleSections(sectionsWithEntries: SectionsWithEntries): Array<Section>;

package/dist/utils/findchangelogentrypaths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ChangesetPathsWithGithubUrl, RepositoryConfig } from '../types.js';
+type FindChangelogEntryPathsOptions = {
+    cwd: string;
+    externalRepositories: Array<RepositoryConfig>;
+    shouldSkipLinks: boolean;
+};
+/**
+ * Gathers changelog entry file paths (Markdown files) from the main repository and any configured external repositories.
+ */
+export declare function findChangelogEntryPaths(options: FindChangelogEntryPathsOptions): Promise<Array<ChangesetPathsWithGithubUrl>>;
+export {};

package/dist/utils/findpackages.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { RepositoryConfig } from '../types.js';
+type FindPackagesOptions = {
+    cwd: string;
+    packagesDirectory: string | null;
+    externalRepositories: Array<RepositoryConfig>;
+    shouldIgnoreRootPackage?: boolean;
+};
+/**
+ * Retrieves the names and versions of packages found in both the main repository and any external repositories.
+ */
+export declare function findPackages(options: FindPackagesOptions): Promise<Map<string, string>>;
+export {};

package/dist/utils/generatechangelog.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ConfigBase, GenerateChangelogEntryPoint, MonoRepoConfigBase } from '../types.js';
+type GenerateChangelogConfig = ConfigBase & MonoRepoConfigBase & {
+    isSinglePackage: boolean;
+};
+/**
+ * Entry point for generating a changelog with error handling.
+ *
+ * This wrapper ensures that:
+ * * Interruptions from the user (e.g., Ctrl+C or intentional aborts) exit silently with code 0.
+ * * Expected and unexpected internal errors are logged to the console and exit with code 1.
+ * * Other unexpected errors are re-thrown for higher-level handling.
+ */
+export declare const generateChangelog: GenerateChangelogEntryPoint<GenerateChangelogConfig>;
+export {};

package/dist/utils/getdateformatted.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Formats a date string `YYYY-MM-DD` into a human-readable format for the changelog.
+ */
+export declare function getDateFormatted(date: string): string;

package/dist/utils/groupentriesbysection.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ParsedFile, SectionsWithEntries, TransformScope } from '../types.js';
+type GroupEntriesBySectionOptions = {
+    files: Array<ParsedFile>;
+    packagesMetadata: Map<string, string>;
+    transformScope?: TransformScope;
+    isSinglePackage: boolean;
+};
+/**
+ * This function categorizes changelog entries based on their types and packages.
+ */
+export declare function groupEntriesBySection(options: GroupEntriesBySectionOptions): SectionsWithEntries;
+export {};

package/dist/utils/internalerror.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Custom error class for handling validation errors in the changelog generation process.
+ */
+export declare class InternalError extends Error {
+    constructor();
+}

package/dist/utils/linktogithubuser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * This function enhances changelog entries by linking contributor usernames to their GitHub profiles.
+ *
+ * It searches for occurrences of GitHub-style mentions (e.g., @username) in the given comment string
+ * and transforms them into Markdown links pointing to the corresponding GitHub user page.
+ */
+export declare function linkToGitHubUser(comment: string): string;

package/dist/utils/loginfo.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * This function provides a consistent logging format for the changelog generation process.
+ *
+ * It logs the given text to the console, optionally indenting it by a specified number of levels.
+ */
+export declare function logInfo(text: string, { indent }?: {
+    indent: number;
+}): void;

package/dist/utils/modifychangelog.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * This function writes the generated changelog content to the repository's changelog file.
+ *
+ * It reads the existing changelog (if any), inserts the new changelog content after the defined header,
+ * writes the updated content back to the changelog file, and truncates the changelog to keep a manageable length.
+ */
+export declare function modifyChangelog(newChangelog: string, cwd: string): Promise<void>;

package/dist/utils/normalizeentry.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { FileMetadata, ParsedFile } from '../types.js';
+export declare function normalizeEntry(entry: ParsedFile<Partial<FileMetadata>>, isSinglePackage: boolean): ParsedFile;

package/dist/utils/parsechangelogentries.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ChangesetPathsWithGithubUrl, ParsedFile } from '../types.js';
+/**
+ * Reads and processes input files to extract changelog entries.
+ */
+export declare function parseChangelogEntries(entryPaths: Array<ChangesetPathsWithGithubUrl>, isSinglePackage: boolean): Promise<Array<ParsedFile>>;

package/dist/utils/providenewversion.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import { type ReleaseType } from 'semver';
+type Options = {
+    packageName: string;
+    version: string;
+    bumpType: ReleaseType;
+    indentLevel?: number;
+    displayValidationWarning: boolean;
+};
+/**
+ * Prompts the user to provide a new version for a package.
+ *
+ * Validates the input (version format, version higher than current, availability).
+ *
+ * Optionally shows warnings for invalid changes and allows user to abort.
+ */
+export declare function provideNewVersion(options: Options): Promise<string>;
+export {};