@ckeditor/ckeditor5-dev-changelog 50.3.1 → 51.1.0

package/dist/index.js

@@ -18,6 +18,7 @@ const CHANGELOG_HEADER = 'Changelog\n=========';
 const NPM_URL = 'https://www.npmjs.com/package';
 const VERSIONING_POLICY_URL = 'https://ckeditor.com/docs/ckeditor5/latest/framework/guides/support/versioning-policy.html';
 const CHANGESET_DIRECTORY = '.changelog';
+const PRE_RELEASE_DIRECTORY = 'pre-release';
 upath.join(import.meta.dirname, '../template/template.md');
 const SECTIONS = {
     major: {
@@ -187,14 +188,16 @@ function groupEntriesBySection(options) {
     return files.reduce((sections, entry) => {
         const { validatedEntry, isValid } = validateEntry(entry, packageNames, isSinglePackage);
         const validatedData = validatedEntry.data;
+        const closesLinks = filterLinks(validatedData.closes, validatedEntry);
+        const closes = getIssuesLinks(closesLinks, 'Closes');
+        const seeLinks = filterLinks(validatedData.see, validatedEntry);
+        const see = getIssuesLinks(seeLinks, 'See');
         const scope = isSinglePackage ? null : getScopesLinks(validatedData.scope, transformScope);
-        const closes = getIssuesLinks(validatedData.closes, 'Closes', validatedEntry.gitHubUrl);
-        const see = getIssuesLinks(validatedData.see, 'See', validatedEntry.gitHubUrl);
         const section = getSection({ entry: validatedEntry, isSinglePackage, isValid });
         const contentWithCommunityCredits = getContentWithCommunityCredits(validatedEntry.content, validatedData.communityCredits);
         const content = linkToGitHubUser(contentWithCommunityCredits);
         const [mainContent, ...restContent] = formatContent(content);
-        const changeMessage = getChangeMessage({ restContent, scope, mainContent, entry, see, closes });
+        const changeMessage = getChangeMessage({ restContent, scope, mainContent, see, closes });
         const newEntry = {
             message: changeMessage,
             data: {
@@ -202,8 +205,8 @@ function groupEntriesBySection(options) {
                 restContent,
                 type: validatedData.type,
                 scope: validatedData.scope,
-                see: validatedData.see.map(see => getIssueLinkObject(see, validatedEntry.gitHubUrl)),
-                closes: validatedData.closes.map(closes => getIssueLinkObject(closes, validatedEntry.gitHubUrl)),
+                see: seeLinks,
+                closes: closesLinks,
                 validations: validatedData.validations,
                 communityCredits: validatedData.communityCredits
             },
@@ -216,13 +219,18 @@ function groupEntriesBySection(options) {
         return sections;
     }, getInitialSectionsWithEntries());
 }
-function getChangeMessage({ restContent, scope, mainContent, entry, see, closes }) {
+function filterLinks(links, entry) {
+    return links
+        .map(link => getIssueLinkObject(link, entry.gitHubUrl))
+        .filter(({ link }) => entry.linkFilter(link));
+}
+function getChangeMessage({ restContent, scope, mainContent, see, closes }) {
     const messageFirstLine = [
         '*',
         scope ? `**${scope}**:` : null,
         mainContent,
-        !entry.shouldSkipLinks && see.length ? see : null,
-        !entry.shouldSkipLinks && closes.length ? closes : null
+        see.length ? see : null,
+        closes.length ? closes : null
     ].filter(Boolean).join(' ');
     if (!restContent || !restContent.length) {
         return messageFirstLine;
@@ -237,7 +245,8 @@ function getChangeMessage({ restContent, scope, mainContent, entry, see, closes
 function formatContent(content) {
     const lines = content.trim()
         .split('\n')
-        .map(line => line.trimEnd());
+        .map(line => line.trimEnd())
+        .map(line => normalizeListMarker(line));
     const mainIndex = lines.findIndex(line => line.trim() !== '');
     const mainContent = lines.at(mainIndex);
     let restContent = lines.slice(mainIndex + 1);
@@ -282,18 +291,18 @@ function getIssueLinkObject(issue, gitHubUrl) {
     const repoUrlMatch = issue.match(ISSUE_URL_PATTERN);
     if (repoUrlMatch) {
         const { owner, repository, number } = repoUrlMatch.groups;
+        if (issue.startsWith(gitHubUrl)) {
+            return { displayName: `#${number}`, link: issue };
+        }
         return { displayName: `${owner}/${repository}#${number}`, link: issue };
     }
     return { displayName: '', link: '' };
 }
-function getIssuesLinks(issues, prefix, gitHubUrl) {
+function getIssuesLinks(issues, prefix) {
     if (!issues.length) {
         return '';
     }
-    const links = issues.map(String).map(issue => {
-        const { displayName, link } = getIssueLinkObject(issue, gitHubUrl);
-        return `[${displayName}](${link})`;
-    });
+    const links = issues.map(issue => `[${issue.displayName}](${issue.link})`);
     return `${prefix} ${links.join(', ')}.`;
 }
 function getSection(options) {
@@ -325,6 +334,10 @@ function getInitialSectionsWithEntries() {
     }
     return sections;
 }
+function normalizeListMarker(line) {
+    const listMarkerRegexp = /^(\s*)[-+](\s*)/;
+    return line.replace(listMarkerRegexp, '$1*$2');
+}
 
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
@@ -529,6 +542,49 @@ function prepareChangelogContent(existingChangelog, newChangelog) {
 class UserAbortError extends Error {
 }
 
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+async function validateInputVersion(options) {
+    const { newVersion, version, releaseType, packageName, suggestedVersion } = options;
+    const [newChannel] = semver.prerelease(newVersion) || ['latest'];
+    const [currentChannel] = semver.prerelease(version) || ['latest'];
+    // Generic semantic‑version checks.
+    if (!semver.valid(newVersion)) {
+        return 'Please provide a valid version.';
+    }
+    if (!semver.gt(newVersion, version)) {
+        return `Provided version must be higher than "${version}".`;
+    }
+    if (!(await npm.checkVersionAvailability(newVersion, packageName))) {
+        return 'Given version is already taken.';
+    }
+    // Rules that depend on release type.
+    const isPrerelease = releaseType === 'prerelease';
+    const isPrereleasePromote = releaseType === 'prerelease-promote';
+    const isLatest = releaseType === 'latest';
+    // Pre‑release types must always include a channel suffix.
+    if ((isPrerelease || isPrereleasePromote) && newChannel === 'latest') {
+        return 'You chose the "pre-release" release type. Please provide a version with a channel suffix.';
+    }
+    // Promoting a pre‑release: new version ≥ suggested version.
+    if (isPrereleasePromote && !semver.gte(newVersion, suggestedVersion)) {
+        return `Provided version must be higher or equal to "${suggestedVersion}".`;
+    }
+    // Continuing a pre‑release stream: channel cannot change.
+    if (isPrerelease &&
+        currentChannel !== 'latest' &&
+        currentChannel !== newChannel) {
+        return `Provided channel must be the same existing channel ${currentChannel}.`;
+    }
+    // Latest release must not carry a channel suffix.
+    if (isLatest && newChannel !== 'latest') {
+        return 'You chose the "latest" release type. Please provide a version without a channel suffix.';
+    }
+    return true;
+}
+
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
@@ -584,39 +640,69 @@ async function askContinueConfirmation(indentLevel = 0) {
  * Creates a prompt question for version input with validation.
  */
 function createVersionQuestion(options) {
-    const { version, packageName, bumpType, indentLevel = 0 } = options;
-    const suggestedVersion = semver.inc(version, bumpType) || version;
+    const { version, packageName, bumpType, releaseChannel, releaseType, indentLevel = 0 } = options;
+    const suggestedVersion = getSuggestedVersion(bumpType, version, releaseChannel) || version;
     const message = 'Type the new version ' +
-        `(current: "${version}", suggested: "${suggestedVersion}", or "internal" for internal changes):`;
+        `(current: "${version}", suggested: "${suggestedVersion}":`;
     return [{
             type: 'input',
             name: 'version',
             default: suggestedVersion,
             message,
             filter: (newVersion) => newVersion.trim(),
-            async validate(newVersion) {
-                // Allow 'internal' as a special version.
-                if (newVersion === 'internal') {
-                    return true;
-                }
-                // Require a semver valid version, e.g., `1.0.0`, `1.0.0-alpha.0`, etc.
-                if (!semver.valid(newVersion)) {
-                    return 'Please provide a valid version or "internal" for internal changes.';
-                }
-                // The provided version must be higher than the current version.
-                if (!semver.gt(newVersion, version)) {
-                    return `Provided version must be higher than "${version}".`;
-                }
-                const isAvailable = await npm.checkVersionAvailability(newVersion, packageName);
-                // Check against availability in the npm registry.
-                if (!isAvailable) {
-                    return 'Given version is already taken.';
-                }
-                return true;
-            },
+            validate: (newVersion) => validateInputVersion({ newVersion, version, releaseType, packageName, suggestedVersion }),
             prefix: ' '.repeat(indentLevel * CLI_INDENT_SIZE) + chalk.cyan('?')
         }];
 }
+function getSuggestedVersion(bumpType, version, releaseChannel) {
+    if (bumpType === 'prerelease' && releaseChannel !== 'latest') {
+        return semver.inc(version, bumpType, releaseChannel);
+    }
+    else if (bumpType === 'prerelease' && releaseChannel === 'latest') {
+        // Using 'premajor` and `alpha` channel for a case, when introducing a prerelease for the next major.
+        // E.g. 1.0.0 -> 2.0.0-alpha.0.
+        return semver.inc(version, 'premajor', 'alpha');
+    }
+    else {
+        return semver.inc(version, bumpType);
+    }
+}
+
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Detects the release channel from a version string.
+ */
+function detectReleaseChannel(version, promotePrerelease = false) {
+    const prerelease = semver.prerelease(version);
+    if (!prerelease) {
+        return 'latest';
+    }
+    const currentChannel = prerelease[0];
+    if (promotePrerelease) {
+        if (currentChannel === 'alpha') {
+            return 'beta';
+        }
+        if (currentChannel === 'beta') {
+            return 'rc';
+        }
+        logInfo(chalk.yellow(`Warning! Unknown release channel to promote from ${currentChannel}.`));
+        return 'alpha';
+    }
+    return currentChannel;
+}
+
+/**
+ * @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.
+ */
+class InternalError extends Error {
+}
 
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
@@ -624,27 +710,39 @@ function createVersionQuestion(options) {
  */
 /**
  * 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 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.
+ * * Version bump for prerelease channels.
  * * User prompts for version input when no explicit version is provided.
  */
 async function determineNextVersion(options) {
-    const { sections, currentVersion, packageName, nextVersion } = options;
-    if (nextVersion === 'internal') {
-        const internalVersionBump = getInternalVersionBump(currentVersion);
-        logInfo(`○ ${chalk.cyan(`Determined the next version to be ${internalVersionBump.newVersion}.`)}`);
-        return internalVersionBump;
-    }
+    const { sections, currentVersion, packageName, nextVersion, releaseType } = options;
     if (nextVersion) {
         logInfo(`○ ${chalk.cyan(`Determined the next version to be ${nextVersion}.`)}`);
-        return { newVersion: nextVersion, isInternal: false };
+        const isNightlyVersion = nextVersion.startsWith('0.0.0-');
+        if (isNightlyVersion) {
+            return nextVersion;
+        }
+        const validationResult = await validateInputVersion({
+            newVersion: nextVersion,
+            suggestedVersion: nextVersion,
+            version: currentVersion,
+            releaseType,
+            packageName
+        });
+        if (typeof validationResult === 'string') {
+            throw new InternalError(validationResult);
+        }
+        return nextVersion;
     }
     logInfo(`○ ${chalk.cyan('Determining the new version...')}`);
     let bumpType = 'patch';
-    if (sections.major.entries.length || sections.breaking.entries.length) {
+    if (releaseType === 'prerelease' || releaseType === 'prerelease-promote') {
+        bumpType = 'prerelease';
+    }
+    else if (sections.major.entries.length || sections.breaking.entries.length) {
         bumpType = 'major';
     }
     else if (sections.minor.entries.length || sections.feature.entries.length) {
@@ -655,20 +753,12 @@ async function determineNextVersion(options) {
     const userProvidedVersion = await provideNewVersion({
         packageName,
         bumpType,
+        releaseType,
         version: currentVersion,
+        releaseChannel: detectReleaseChannel(currentVersion, releaseType === 'prerelease-promote'),
         displayValidationWarning: areErrorsPresent || areWarningsPresent
     });
-    if (userProvidedVersion === 'internal') {
-        return getInternalVersionBump(currentVersion);
-    }
-    return { newVersion: userProvidedVersion, isInternal: false };
-}
-function getInternalVersionBump(currentVersion) {
-    const version = semver.inc(currentVersion, 'patch');
-    if (!version) {
-        throw new Error('Unable to determine new version based on the version in root package.json.');
-    }
-    return { newVersion: version, isInternal: true };
+    return userProvidedVersion;
 }
 
 /**
@@ -819,37 +909,44 @@ function getPackageName(value) {
  * Gathers changelog entry file paths (Markdown files) from the main repository and any configured external repositories.
  */
 async function findChangelogEntryPaths(options) {
-    const { cwd, externalRepositories, shouldSkipLinks } = options;
+    const { cwd, externalRepositories, includeSubdirectories = true } = options;
+    const globPattern = includeSubdirectories ? '**/*.md' : '*.md';
     return AsyncArray
         .from(Promise.resolve(externalRepositories))
         .map(async (repo) => {
-        const changesetGlob = await glob('**/*.md', {
+        const changesetGlob = await glob(globPattern, {
             cwd: upath.join(repo.cwd, CHANGESET_DIRECTORY),
             absolute: true
         });
         return {
             filePaths: changesetGlob.map(p => upath.normalize(p)),
             gitHubUrl: await workspaces.getRepositoryUrl(repo.cwd, { async: true }),
-            shouldSkipLinks: !!repo.shouldSkipLinks,
+            linkFilter: getLinkFilter(repo),
             cwd: repo.cwd,
             isRoot: false
         };
     })
         .then(async (externalResults) => {
-        const mainChangesetGlob = await glob('**/*.md', {
+        const mainChangesetGlob = await glob(globPattern, {
             cwd: upath.join(cwd, CHANGESET_DIRECTORY),
             absolute: true
         });
         const mainEntry = {
             filePaths: mainChangesetGlob.map(p => upath.normalize(p)),
             gitHubUrl: await workspaces.getRepositoryUrl(cwd, { async: true }),
-            shouldSkipLinks,
+            linkFilter: getLinkFilter(options),
             cwd,
             isRoot: true
         };
         return [mainEntry, ...externalResults];
     });
 }
+function getLinkFilter(options) {
+    if (typeof options.shouldSkipLinks === 'boolean') {
+        return () => !options.shouldSkipLinks;
+    }
+    return options.linkFilter || (() => true);
+}
 
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
@@ -955,19 +1052,19 @@ function toArray(input) {
  * Reads and processes input files to extract changelog entries.
  */
 function parseChangelogEntries(entryPaths, isSinglePackage) {
-    const fileEntries = entryPaths.reduce((acc, { filePaths, gitHubUrl, shouldSkipLinks }) => {
+    const fileEntries = entryPaths.reduce((acc, { filePaths, gitHubUrl, linkFilter }) => {
         for (const changesetPath of filePaths) {
-            acc.push({ changesetPath, gitHubUrl, shouldSkipLinks });
+            acc.push({ changesetPath, gitHubUrl, linkFilter });
         }
         return acc;
     }, []);
     return AsyncArray
         .from(Promise.resolve(fileEntries))
-        .map(async ({ changesetPath, gitHubUrl, shouldSkipLinks }) => ({
+        .map(async ({ changesetPath, gitHubUrl, linkFilter }) => ({
         ...matter(await fs$1.readFile(changesetPath, 'utf-8')),
         gitHubUrl,
         changesetPath,
-        shouldSkipLinks,
+        linkFilter,
         createdAt: extractDateFromFilename(changesetPath)
     }))
         .map(entry => normalizeEntry(entry, isSinglePackage))
@@ -994,25 +1091,6 @@ function extractDateFromFilename(changesetPath) {
     return parsedDate;
 }
 
-/**
- * @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.
- */
-class InternalError extends Error {
-    constructor() {
-        const message = 'No valid entries were found. Please ensure that:\n' +
-            '1) Input files exist in the `.changelog/` directory.\n' +
-            '2) The `cwd` parameter points to the root of your project.\n' +
-            '3) The `packagesDirectory` parameter correctly specifies the packages folder.\n' +
-            'If no errors appear in the console but inputs are present, your project configuration may be incorrect.\n' +
-            'If validation errors are shown, please resolve them according to the details provided.\n';
-        super(message);
-    }
-}
-
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
@@ -1031,7 +1109,13 @@ function filterVisibleSections(sectionsWithEntries) {
     })
         .map(([, section]) => section);
     if (!sectionsToDisplay.length) {
-        throw new InternalError();
+        const message = 'No valid entries were found. Please ensure that:\n' +
+            '1) Input files exist in the `.changelog/` directory.\n' +
+            '2) The `cwd` parameter points to the root of your project.\n' +
+            '3) The `packagesDirectory` parameter correctly specifies the packages folder.\n' +
+            'If no errors appear in the console but inputs are present, your project configuration may be incorrect.\n' +
+            'If validation errors are shown, please resolve them according to the details provided.\n';
+        throw new InternalError(message);
     }
     return sectionsToDisplay;
 }
@@ -1058,13 +1142,12 @@ function getDateFormatted(date) {
  * * 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.
+ * * Special handling for single-package repositories.
  */
 async function composeChangelog(options) {
-    const { cwd, date, currentVersion, newVersion, sections, releasedPackagesInfo, isInternal, isSinglePackage, packagesMetadata } = options;
+    const { cwd, date, currentVersion, newVersion, sections, releasedPackagesInfo, isSinglePackage } = options;
     const gitHubUrl = await workspaces.getRepositoryUrl(cwd, { async: true });
     const dateFormatted = getDateFormatted(date);
-    const packagesNames = [...packagesMetadata.keys()];
     const header = currentVersion === '0.0.1' ?
         `## ${newVersion} (${dateFormatted})` :
         `## [${newVersion}](${gitHubUrl}/compare/v${currentVersion}...v${newVersion}) (${dateFormatted})`;
@@ -1080,19 +1163,13 @@ async function composeChangelog(options) {
         '',
         ...packages.map(packageName => `* [${packageName}](${NPM_URL}/${packageName}/v/${newVersion}): ${version}`)
     ])).flat().join('\n');
-    const internalVersionsBumps = [
-        '',
-        SECTIONS.other.title + ':',
-        '',
-        packagesNames.map(name => `* [${name}](${NPM_URL}/${name}/v/${newVersion}): v${currentVersion} => v${newVersion}`)
-    ].flat().join('\n');
     const changelog = [
         header,
         '',
-        isInternal ? 'Internal changes only (updated dependencies, documentation, etc.).\n' : sectionsAsString
+        sectionsAsString
     ];
     if (!isSinglePackage) {
-        changelog.push('### Released packages', '', `Check out the [Versioning policy](${VERSIONING_POLICY_URL}) guide for more information.`, '', '<details>', '<summary>Released packages (summary)</summary>', isInternal ? internalVersionsBumps : packagesVersionBumps, '</details>', '');
+        changelog.push('### Released packages', '', `Check out the [Versioning policy](${VERSIONING_POLICY_URL}) guide for more information.`, '', '<details>', '<summary>Released packages (summary)</summary>', packagesVersionBumps, '</details>', '');
     }
     return changelog.join('\n');
 }
@@ -1112,6 +1189,40 @@ async function removeChangelogEntryFiles(entryPaths) {
         .map(file => fs$1.unlink(file)));
 }
 
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Moves changelog entry files to cycle-specific directories instead of deleting them.
+ * This preserves the history of changes across prerelease cycles.
+ * Returns an array of entry paths that were modified by the move operation
+ */
+async function moveChangelogEntryFiles(entryPaths) {
+    const targetDir = PRE_RELEASE_DIRECTORY;
+    const modifiedEntryPaths = [];
+    logInfo(`○ ${chalk.cyan(`Moving changelog entries to ${targetDir}/ directory...`)}`);
+    for (const repo of entryPaths) {
+        const { cwd, filePaths } = repo;
+        const changelogDir = upath.join(cwd, CHANGESET_DIRECTORY);
+        const targetPath = upath.join(changelogDir, targetDir);
+        await fs$1.ensureDir(targetPath);
+        const modifiedFilePaths = [];
+        for (const filePath of filePaths) {
+            const fileName = upath.basename(filePath);
+            const targetFilePath = upath.join(targetPath, fileName);
+            await fs$1.rename(filePath, targetFilePath);
+            modifiedFilePaths.push(targetFilePath);
+            modifiedFilePaths.push(filePath);
+        }
+        modifiedEntryPaths.push({
+            ...repo,
+            filePaths: modifiedFilePaths
+        });
+    }
+    return modifiedEntryPaths;
+}
+
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
@@ -1134,6 +1245,61 @@ async function commitChanges(version, repositories) {
     }
 }
 
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+/**
+ * Prompts the user to choose between latest or prerelease
+ */
+async function promptReleaseType(currentVersion) {
+    const { releaseType } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'releaseType',
+            message: 'Please select the release type.',
+            choices: getQuestions(currentVersion)
+        }
+    ]);
+    return releaseType;
+}
+function getQuestions(currentVersion) {
+    const currentVersionPrerelease = semver.prerelease(currentVersion);
+    if (!currentVersionPrerelease) {
+        return [
+            { name: 'Latest (stable) release (e.g. 1.0.0 -> 2.0.0)', value: 'latest' },
+            { name: 'Pre-release (e.g. 1.0.0 -> 2.0.0-alpha.0)', value: 'prerelease' }
+        ];
+    }
+    if (currentVersionPrerelease[0] === 'rc') {
+        return [
+            { name: 'Latest (stable) release (e.g. 1.0.0-beta.2 -> 1.0.0)', value: 'latest' },
+            { name: 'Pre-release continuation (e.g. 1.0.0-alpha.0 -> 1.0.0-alpha.1)', value: 'prerelease' }
+        ];
+    }
+    return [
+        { name: 'Latest (stable) release (e.g. 1.0.0-beta.2 -> 1.0.0)', value: 'latest' },
+        { name: 'Pre-release continuation (e.g. 1.0.0-alpha.0 -> 1.0.0-alpha.1)', value: 'prerelease' },
+        { name: 'Pre-release promotion (e.g. 1.0.0-alpha.1 -> 1.0.0-beta.0)', value: 'prerelease-promote' }
+    ];
+}
+
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+function getReleaseType(currentVersion, nextVersion) {
+    const [currentChannel] = semver.prerelease(currentVersion) || ['latest'];
+    const [nextChannel] = semver.prerelease(nextVersion) || ['latest'];
+    if (nextChannel === 'latest') {
+        return 'latest';
+    }
+    if (nextChannel === currentChannel) {
+        return 'prerelease';
+    }
+    return 'prerelease-promote';
+}
+
 /**
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md.
@@ -1156,7 +1322,7 @@ async function commitChanges(version, repositories) {
  * and the assembled changelog object will be returned instead.
  */
 const main = async (options) => {
-    const { nextVersion, packagesDirectory, isSinglePackage, transformScope, npmPackageToCheck, cwd = process.cwd(), externalRepositories = [], date = format(new Date(), 'yyyy-MM-dd'), shouldSkipLinks = false, shouldIgnoreRootPackage = false, disableFilesystemOperations = false } = options;
+    const { nextVersion, packagesDirectory, isSinglePackage, transformScope, npmPackageToCheck, linkFilter, shouldSkipLinks, cwd = process.cwd(), externalRepositories = [], date = format(new Date(), 'yyyy-MM-dd'), shouldIgnoreRootPackage = false, disableFilesystemOperations = false } = options;
     const { version: currentVersion, name: rootPackageName } = await workspaces.getPackageJson(cwd, { async: true });
     const packagesMetadata = await findPackages({
         cwd,
@@ -1164,10 +1330,13 @@ const main = async (options) => {
         shouldIgnoreRootPackage,
         externalRepositories
     });
+    const releaseType = nextVersion ? getReleaseType(currentVersion, nextVersion) : await promptReleaseType(currentVersion);
     const entryPaths = await findChangelogEntryPaths({
         cwd,
         externalRepositories,
-        shouldSkipLinks
+        linkFilter,
+        shouldSkipLinks,
+        includeSubdirectories: releaseType === 'latest' || releaseType === 'prerelease-promote'
     });
     const parsedChangesetFiles = await parseChangelogEntries(entryPaths, isSinglePackage);
     const sectionsWithEntries = groupEntriesBySection({
@@ -1191,9 +1360,10 @@ const main = async (options) => {
         });
     }
     // Display a prompt to provide a new version in the console.
-    const { isInternal, newVersion } = await determineNextVersion({
+    const newVersion = await determineNextVersion({
         currentVersion,
         nextVersion,
+        releaseType,
         sections: sectionsWithEntries,
         packageName: shouldIgnoreRootPackage ? npmPackageToCheck : rootPackageName
     });
@@ -1208,18 +1378,23 @@ const main = async (options) => {
         cwd,
         date,
         newVersion,
-        isInternal,
         isSinglePackage,
-        packagesMetadata,
         releasedPackagesInfo,
         sections: filterVisibleSections(sectionsWithEntries)
     });
     if (disableFilesystemOperations) {
         return newChangelog;
     }
-    await removeChangelogEntryFiles(entryPaths);
+    let pathsToCommit = entryPaths;
+    // Handle changelog entry files based on release type.
+    if (releaseType === 'latest') {
+        await removeChangelogEntryFiles(entryPaths);
+    }
+    else {
+        pathsToCommit = await moveChangelogEntryFiles(entryPaths);
+    }
     await modifyChangelog(newChangelog, cwd);
-    await commitChanges(newVersion, entryPaths.map(({ cwd, isRoot, filePaths }) => ({ cwd, isRoot, filePaths })));
+    await commitChanges(newVersion, pathsToCommit.map(({ cwd, isRoot, filePaths }) => ({ cwd, isRoot, filePaths })));
     logInfo('○ ' + chalk.green('Done!'));
 };
 /**
@@ -1263,7 +1438,7 @@ function isExpectedError(error) {
  * For licensing, see LICENSE.md.
  */
 const generateChangelogForMonoRepository = async (options) => {
-    const { date, cwd, externalRepositories, nextVersion, disableFilesystemOperations, npmPackageToCheck, packagesDirectory, shouldSkipLinks, shouldIgnoreRootPackage, transformScope } = options;
+    const { date, cwd, externalRepositories, nextVersion, disableFilesystemOperations, npmPackageToCheck, packagesDirectory, linkFilter, shouldSkipLinks, shouldIgnoreRootPackage, transformScope } = options;
     return generateChangelog({
         nextVersion,
         cwd,
@@ -1271,6 +1446,7 @@ const generateChangelogForMonoRepository = async (options) => {
         externalRepositories,
         transformScope,
         date,
+        linkFilter,
         shouldSkipLinks,
         disableFilesystemOperations,
         ...(shouldIgnoreRootPackage && npmPackageToCheck ?
@@ -1285,12 +1461,13 @@ const generateChangelogForMonoRepository = async (options) => {
  * For licensing, see LICENSE.md.
  */
 const generateChangelogForSingleRepository = async (options) => {
-    const { cwd, date, externalRepositories, nextVersion, disableFilesystemOperations, shouldSkipLinks } = options;
+    const { cwd, date, externalRepositories, nextVersion, disableFilesystemOperations, linkFilter, shouldSkipLinks } = options;
     return generateChangelog({
         nextVersion,
         cwd,
         externalRepositories,
         date,
+        linkFilter,
         shouldSkipLinks,
         disableFilesystemOperations,
         isSinglePackage: true,

package/dist/types.d.ts

@@ -6,9 +6,9 @@ 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.
+     * Must be a valid version in terms of the semantic versioning specification.
      */
-    nextVersion?: string | 'internal';
+    nextVersion?: string;
     /**
      * Array of external repository configurations to include in the changelog.
      */
@@ -41,6 +41,12 @@ export type RepositoryConfig = {
      * The directory containing the packages. Defaults to 'packages'.
      */
     packagesDirectory: null | string;
+    /**
+     * Function that decides whether to filter out a link in the changelog entry.
+     * If `shouldSkipLinks` flag is set, the `shouldSkipLinks` flag takes precedence over the `linkFilter` function.
+     * No links are skipped by default.
+     */
+    linkFilter?: LinkFilter;
     /**
      * Whether to skip links in the changelog entries. Defaults to false.
      */
@@ -73,7 +79,7 @@ export type ParsedFile<T = FileMetadata> = {
     changesetPath: string;
     createdAt: Date;
     gitHubUrl: string;
-    shouldSkipLinks: boolean;
+    linkFilter: LinkFilter;
 };
 export type Section = {
     entries: Array<Entry>;
@@ -94,7 +100,7 @@ export type TransformScope = (name: string) => {
 export type ChangesetPathsWithGithubUrl = {
     filePaths: Array<string>;
     gitHubUrl: string;
-    shouldSkipLinks: boolean;
+    linkFilter: LinkFilter;
     cwd: string;
     isRoot: boolean;
 };
@@ -109,6 +115,7 @@ export type LinkObject = {
     displayName: string;
     link: string;
 };
+export type LinkFilter = (resourceUrl: string) => boolean;
 export type FileMetadata = {
     type: string;
     scope: Array<string>;
@@ -117,4 +124,8 @@ export type FileMetadata = {
     communityCredits: Array<string>;
     validations: Array<string>;
 };
+export type ChangelogReleaseType = 'latest' | // e.g. 1.0.0 -> 2.0.0 or 2.0.0-beta.1 -> 2.0.0.
+'prerelease' | // e.g. 1.0.0 -> 2.0.0-alpha.0 or 2.0.0-alpha.0 -> 2.0.0-alpha.1.
+'prerelease-promote';
+export type ReleaseChannel = 'alpha' | 'beta' | 'rc' | 'latest';
 export {};

package/dist/utils/composechangelog.d.ts

@@ -3,16 +3,14 @@
  * For licensing, see LICENSE.md.
  */
 import type { ReleaseInfo, Section } from '../types.js';
-type ComposeChangelogOptions = {
+export 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.
@@ -21,7 +19,6 @@ type ComposeChangelogOptions = {
  * * 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.
+ * * Special handling for single-package repositories.
  */
 export declare function composeChangelog(options: ComposeChangelogOptions): Promise<string>;
-export {};

package/dist/utils/constants.d.ts

@@ -7,6 +7,7 @@ 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 PRE_RELEASE_DIRECTORY = "pre-release";
 export declare const TEMPLATE_FILE: string;
 export declare const SECTIONS: {
     readonly major: {

package/dist/utils/detectreleasechannel.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 { ReleaseChannel } from '../types.js';
+/**
+ * Detects the release channel from a version string.
+ */
+export declare function detectReleaseChannel(version: string, promotePrerelease?: boolean): ReleaseChannel;

package/dist/utils/determinenextversion.d.ts

@@ -2,25 +2,21 @@
  * @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;
-};
+import type { ChangelogReleaseType, SectionsWithEntries } from '../types.js';
 export type DetermineNextVersionOptions = {
     sections: SectionsWithEntries;
     currentVersion: string;
     packageName: string;
     nextVersion: string | undefined;
+    releaseType: ChangelogReleaseType;
 };
 /**
  * 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 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.
+ * * Version bump for prerelease channels.
  * * User prompts for version input when no explicit version is provided.
  */
-export declare function determineNextVersion(options: DetermineNextVersionOptions): Promise<NextVersionOutput>;
-export {};
+export declare function determineNextVersion(options: DetermineNextVersionOptions): Promise<string>;

package/dist/utils/findchangelogentrypaths.d.ts

@@ -2,11 +2,13 @@
  * @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';
+import type { ChangesetPathsWithGithubUrl, LinkFilter, RepositoryConfig } from '../types.js';
 type FindChangelogEntryPathsOptions = {
     cwd: string;
     externalRepositories: Array<RepositoryConfig>;
-    shouldSkipLinks: boolean;
+    linkFilter?: LinkFilter;
+    shouldSkipLinks?: boolean;
+    includeSubdirectories?: boolean;
 };
 /**
  * Gathers changelog entry file paths (Markdown files) from the main repository and any configured external repositories.

package/dist/utils/getreleasetype.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 ChangelogReleaseType } from '../types.js';
+export declare function getReleaseType(currentVersion: string, nextVersion: string): ChangelogReleaseType;

package/dist/utils/internalerror.d.ts

@@ -6,5 +6,4 @@
  * Custom error class for handling validation errors in the changelog generation process.
  */
 export declare class InternalError extends Error {
-    constructor();
 }

package/dist/utils/movechangelogentryfiles.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 { ChangesetPathsWithGithubUrl } from '../types.js';
+/**
+ * Moves changelog entry files to cycle-specific directories instead of deleting them.
+ * This preserves the history of changes across prerelease cycles.
+ * Returns an array of entry paths that were modified by the move operation
+ */
+export declare function moveChangelogEntryFiles(entryPaths: Array<ChangesetPathsWithGithubUrl>): Promise<Array<ChangesetPathsWithGithubUrl>>;

package/dist/utils/promptreleasetype.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 { ChangelogReleaseType } from '../types.js';
+/**
+ * Prompts the user to choose between latest or prerelease
+ */
+export declare function promptReleaseType(currentVersion: string): Promise<ChangelogReleaseType>;

package/dist/utils/providenewversion.d.ts

@@ -3,12 +3,15 @@
  * For licensing, see LICENSE.md.
  */
 import { type ReleaseType } from 'semver';
+import type { ChangelogReleaseType, ReleaseChannel } from '../types.js';
 type Options = {
     packageName: string;
     version: string;
     bumpType: ReleaseType;
+    releaseChannel: ReleaseChannel;
     indentLevel?: number;
     displayValidationWarning: boolean;
+    releaseType: ChangelogReleaseType;
 };
 /**
  * Prompts the user to provide a new version for a package.

package/dist/utils/validateinputversion.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md.
+ */
+import type { ChangelogReleaseType } from '../types.js';
+type ValidateOptions = {
+    newVersion: string;
+    version: string;
+    releaseType: ChangelogReleaseType;
+    packageName: string;
+    suggestedVersion: string;
+};
+export declare function validateInputVersion(options: ValidateOptions): Promise<string | true>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-dev-changelog",
-  "version": "50.3.1",
+  "version": "51.1.0",
   "description": "A CKEditor 5 development tool for handling changelogs.",
   "keywords": [],
   "author": "CKSource (http://cksource.com/)",
@@ -28,7 +28,7 @@
     "ckeditor5-dev-changelog-create-entry": "bin/generate-template.js"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-dev-utils": "^50.3.1",
+    "@ckeditor/ckeditor5-dev-utils": "^51.1.0",
     "chalk": "^5.0.0",
     "date-fns": "^4.0.0",
     "fs-extra": "^11.0.0",

package/template/template.md

@@ -9,10 +9,10 @@
 #
 # For guidance on breaking changes, see:
 # https://ckeditor.com/docs/ckeditor5/latest/updating/versioning-policy.html#major-and-minor-breaking-changes
-type:
+type: 
 
 # Optional: Affected package(s), using short names.
-# Can be skipped when processing a non-mono-repository.
+# Leave empty when used in a single-package repository.
 # Example: ckeditor5-core
 scope:
   -