@ohos-ports/nx 23.2.1-beta.0 → 23.3.0-beta.0

package/dist/src/command-line/release/version/release-group-processor.js

@@ -0,0 +1,706 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReleaseGroupProcessor = exports.BUMP_TYPE_REASON_TEXT = void 0;
+const tslib_1 = require("tslib");
+const semver = tslib_1.__importStar(require("semver"));
+const workspace_root_1 = require("../../../utils/workspace-root");
+const config_1 = require("../config/config");
+const resolve_semver_specifier_1 = require("../utils/resolve-semver-specifier");
+const derive_specifier_from_conventional_commits_1 = require("./derive-specifier-from-conventional-commits");
+const deriver_specifier_from_version_plans_1 = require("./deriver-specifier-from-version-plans");
+const version_actions_1 = require("./version-actions");
+exports.BUMP_TYPE_REASON_TEXT = {
+    DEPENDENCY_WAS_BUMPED: ', because a dependency was bumped, ',
+    USER_SPECIFIER: ', from the given specifier, ',
+    PROMPTED_USER_SPECIFIER: ', from the prompted specifier, ',
+    CONVENTIONAL_COMMITS: ', derived from conventional commits data, ',
+    VERSION_PLANS: ', read from version plan {versionPlanPath}, ',
+    DEPENDENCY_ACROSS_GROUPS_WAS_BUMPED: ', because a dependency project belonging to another release group was bumped, ',
+    OTHER_PROJECT_IN_FIXED_GROUP_WAS_BUMPED_DUE_TO_DEPENDENCY: ', because of a dependency-only bump to another project in the same fixed release group, ',
+    NOOP_VERSION_ACTIONS: ', because this project uses docker and has been configured to skip VersionActions, ',
+};
+class ReleaseGroupProcessor {
+    constructor(tree, projectGraph, nxReleaseConfig, releaseGraph, options) {
+        this.tree = tree;
+        this.projectGraph = projectGraph;
+        this.nxReleaseConfig = nxReleaseConfig;
+        this.releaseGraph = releaseGraph;
+        this.options = options;
+        /**
+         * Tracks which release groups have already been processed to avoid
+         * processing them multiple times. Used during the group traversal.
+         */
+        this.processedGroups = new Set();
+        /**
+         * Tracks release groups that have completed all version decisions. A group
+         * can reach this state before its dependency manifests are updated.
+         */
+        this.groupsWithFinalizedVersionDecisions = new Set();
+        /**
+         * Tracks projects whose dependency manifests must wait until all release
+         * groups have completed their version decisions.
+         */
+        this.projectsWithDeferredDependencyUpdates = new Set();
+        /**
+         * Indicates that every release group has completed its version decisions,
+         * so dependency manifests can use final versions safely.
+         */
+        this.allVersionDecisionsFinalized = false;
+        /**
+         * Keeps track of which projects have already had their versions bumped.
+         * This is used to avoid redundant version bumping and to determine which
+         * projects need their dependencies updated.
+         */
+        this.bumpedProjects = new Set();
+        /**
+         * versionData that will ultimately be returned to the nx release version handler by getVersionData()
+         */
+        this.versionData = new Map();
+        /**
+         * Track any version plan files that have been processed so that we can delete them after versioning is complete,
+         * while leaving any unprocessed files in place.
+         */
+        this.processedVersionPlanFiles = new Set();
+        /**
+         * To match legacy versioning behavior in the case of semver versions with leading "v" characters,
+         * e.g. "v1.0.0", we strip the leading "v" and use the rest of the string as the user given specifier
+         * to ensure that it is valid. If it is a non-semver version, we just use the string as is.
+         *
+         * TODO: re-evaluate if this is definitely what we want... Maybe we can just delegate isValid to the
+         * version actions implementation during prompting?
+         */
+        if (options.userGivenSpecifier?.startsWith('v')) {
+            const userGivenSpecifierWithoutLeadingV = options.userGivenSpecifier?.replace(/^v/, '');
+            if (semver.valid(userGivenSpecifierWithoutLeadingV)) {
+                this.userGivenSpecifier = userGivenSpecifierWithoutLeadingV;
+            }
+        }
+        else {
+            this.userGivenSpecifier = options.userGivenSpecifier;
+        }
+        // Ensure that there is an entry in versionData for each project being processed
+        for (const projectName of this.releaseGraph.allProjectsToProcess) {
+            this.versionData.set(projectName, {
+                currentVersion: this.getCurrentCachedVersionForProject(projectName),
+                newVersion: null,
+                dockerVersion: null,
+                dependentProjects: this.getOriginalDependentProjects(projectName),
+            });
+        }
+    }
+    getReleaseGroupNameForProject(projectName) {
+        const group = this.releaseGraph.projectToReleaseGroup.get(projectName);
+        return group ? group.name : null;
+    }
+    getNextGroup() {
+        for (const [groupName, groupNode] of this.releaseGraph.groupGraph) {
+            if (!this.processedGroups.has(groupName) &&
+                Array.from(groupNode.dependencies).every((dep) => this.processedGroups.has(dep))) {
+                return groupName;
+            }
+        }
+        return null;
+    }
+    async processGroups() {
+        const processOrder = [];
+        // Use the topologically sorted groups
+        for (const nextGroup of this.releaseGraph.sortedReleaseGroups) {
+            // Skip groups that have already been processed (could happen with circular dependencies)
+            if (this.processedGroups.has(nextGroup)) {
+                continue;
+            }
+            // The next group might not present in the groupGraph if it has been filtered out
+            if (!this.releaseGraph.groupGraph.has(nextGroup)) {
+                continue;
+            }
+            const allDependenciesProcessed = Array.from(this.releaseGraph.groupGraph.get(nextGroup).dependencies).every((dep) => this.processedGroups.has(dep));
+            if (!allDependenciesProcessed) {
+                // If we encounter a group whose dependencies aren't all processed,
+                // it means there's a circular dependency that our topological sort broke.
+                // We need to process any unprocessed dependencies first.
+                for (const dep of this.releaseGraph.groupGraph.get(nextGroup)
+                    .dependencies) {
+                    if (!this.processedGroups.has(dep)) {
+                        // The next group might not present in the groupGraph if it has been filtered out
+                        if (!this.releaseGraph.groupGraph.has(dep)) {
+                            continue;
+                        }
+                        await this.processGroup(dep);
+                        this.processedGroups.add(dep);
+                        processOrder.push(dep);
+                    }
+                }
+            }
+            await this.processGroup(nextGroup);
+            this.processedGroups.add(nextGroup);
+            processOrder.push(nextGroup);
+        }
+        await this.finalizeAllVersionDecisions(processOrder);
+        return processOrder;
+    }
+    flushAllProjectLoggers() {
+        for (const projectLogger of this.releaseGraph.projectLoggers.values()) {
+            projectLogger.flush();
+        }
+    }
+    deleteProcessedVersionPlanFiles() {
+        for (const versionPlanPath of this.processedVersionPlanFiles) {
+            this.tree.delete(versionPlanPath);
+        }
+    }
+    getVersionData() {
+        return Object.fromEntries(this.versionData);
+    }
+    /**
+     * Invoke the afterAllProjectsVersioned functions for each unique versionActions type.
+     * This can be useful for performing actions like updating a workspace level lock file.
+     *
+     * Because the tree has already been flushed to disk at this point, each afterAllProjectsVersioned
+     * function is responsible for returning the list of changed and deleted files that it affected.
+     *
+     * The root level `release.version.versionActionsOptions` is what is passed in here because this
+     * is a one time action for the whole workspace. Release group and project level overrides are
+     * not applicable.
+     */
+    async afterAllProjectsVersioned(rootVersionActionsOptions) {
+        const changedFiles = new Set();
+        const deletedFiles = new Set();
+        for (const [, afterAllProjectsVersioned] of this.releaseGraph
+            .uniqueAfterAllProjectsVersioned) {
+            const { changedFiles: changedFilesForVersionActions, deletedFiles: deletedFilesForVersionActions, } = await afterAllProjectsVersioned(this.tree.root, {
+                dryRun: this.options.dryRun,
+                verbose: this.options.verbose,
+                rootVersionActionsOptions,
+            });
+            for (const file of changedFilesForVersionActions) {
+                changedFiles.add(file);
+            }
+            for (const file of deletedFilesForVersionActions) {
+                deletedFiles.add(file);
+            }
+        }
+        return {
+            changedFiles: Array.from(changedFiles),
+            deletedFiles: Array.from(deletedFiles),
+        };
+    }
+    async processDockerProjects(dockerVersionScheme, dockerVersion) {
+        const dockerProjects = new Map();
+        for (const project of this.versionData.keys()) {
+            const hasDockerTechnology = Object.values(this.projectGraph.nodes[project]?.data?.targets ?? []).some(({ metadata }) => metadata?.technologies?.includes('docker'));
+            if (!hasDockerTechnology) {
+                continue;
+            }
+            const finalConfigForProject = this.releaseGraph.finalConfigsByProject.get(project);
+            dockerProjects.set(project, finalConfigForProject);
+        }
+        // If no docker projects to process, exit early to avoid unnecessary loading of docker handling
+        if (dockerProjects.size === 0) {
+            return;
+        }
+        let handleDockerVersion;
+        try {
+            const dockerVersionUtilsPath = '@nx/docker/release/version-utils';
+            const { handleDockerVersion: _handleDockerVersion } = require(dockerVersionUtilsPath);
+            handleDockerVersion = _handleDockerVersion;
+        }
+        catch (e) {
+            console.error('Could not find `@nx/docker`. Please run `nx add @nx/docker` before attempting to release Docker images.');
+            throw e;
+        }
+        for (const [project, finalConfigForProject] of dockerProjects.entries()) {
+            const projectNode = this.projectGraph.nodes[project];
+            const projectVersionData = this.versionData.get(project);
+            const { newVersion, logs } = await handleDockerVersion(workspace_root_1.workspaceRoot, projectNode, finalConfigForProject, dockerVersionScheme, dockerVersion, projectVersionData.newVersion);
+            logs.forEach((log) => this.getProjectLoggerForProject(project).buffer(log));
+            const newVersionData = {
+                ...projectVersionData,
+                dockerVersion: newVersion,
+            };
+            this.versionData.set(project, newVersionData);
+        }
+        this.flushAllProjectLoggers();
+    }
+    async processGroup(releaseGroupName) {
+        const groupNode = this.releaseGraph.groupGraph.get(releaseGroupName);
+        await this.bumpVersions(groupNode.group);
+    }
+    async bumpVersions(releaseGroup) {
+        if (releaseGroup.projectsRelationship === 'fixed') {
+            return this.bumpFixedVersionGroup(releaseGroup);
+        }
+        else {
+            return this.bumpIndependentVersionGroup(releaseGroup);
+        }
+    }
+    async bumpFixedVersionGroup(releaseGroup) {
+        if (releaseGroup.projects.length === 0) {
+            this.finalizeVersionDecisionsForGroup(releaseGroup);
+            return false;
+        }
+        let bumped = false;
+        const firstProject = releaseGroup.projects[0];
+        const { newVersionInput, newVersionInputReason, newVersionInputReasonData, } = await this.determineVersionBumpForProject(releaseGroup, firstProject);
+        if (newVersionInput === 'none') {
+            // No direct bump for this group, but we may still need to bump if a dependency group has been bumped
+            let bumpedByDependency = false;
+            // Use sorted projects to check for dependencies in processed groups
+            const sortedProjects = this.releaseGraph.sortedProjects.get(releaseGroup.name) || [];
+            // Iterate through each project in the release group in topological order
+            for (const project of sortedProjects) {
+                const dependencies = this.projectGraph.dependencies[project] || [];
+                for (const dep of dependencies) {
+                    const depGroup = this.getReleaseGroupNameForProject(dep.target);
+                    if (depGroup &&
+                        depGroup !== releaseGroup.name &&
+                        this.processedGroups.has(depGroup)) {
+                        const depGroupBumpType = await this.getFixedReleaseGroupBumpType(depGroup);
+                        // If a dependency group has been bumped, determine if it should trigger a bump in this group
+                        if (depGroupBumpType !== 'none') {
+                            bumpedByDependency = true;
+                            const depBumpType = this.determineSideEffectBump(releaseGroup, depGroupBumpType);
+                            await this.bumpVersionForProject(project, depBumpType, 'DEPENDENCY_ACROSS_GROUPS_WAS_BUMPED', {});
+                            this.bumpedProjects.add(project);
+                            // Update any dependencies in the manifest
+                            await this.updateDependenciesForProject(project);
+                        }
+                    }
+                }
+            }
+            // If any project in the group was bumped due to dependency changes, we must bump all projects in the fixed group
+            if (bumpedByDependency) {
+                // Update all projects in topological order
+                for (const project of sortedProjects) {
+                    if (!this.bumpedProjects.has(project)) {
+                        await this.bumpVersionForProject(project, this.applyPreidToBumpType('patch', project), 'OTHER_PROJECT_IN_FIXED_GROUP_WAS_BUMPED_DUE_TO_DEPENDENCY', {});
+                        // Ensure the bump for remaining projects
+                        this.bumpedProjects.add(project);
+                        await this.updateDependenciesForProject(project);
+                    }
+                }
+            }
+            else {
+                /**
+                 * No projects in the group are being bumped, but as it stands only the first project would have an appropriate log,
+                 * therefore add in an extra log for each additional project in the group, and we also need to make sure that the
+                 * versionData is fully populated.
+                 */
+                for (const project of releaseGroup.projects) {
+                    this.versionData.set(project, {
+                        currentVersion: this.getCurrentCachedVersionForProject(project),
+                        newVersion: null,
+                        dockerVersion: null,
+                        dependentProjects: this.getOriginalDependentProjects(project),
+                    });
+                    if (project === firstProject) {
+                        continue;
+                    }
+                    const projectLogger = this.getProjectLoggerForProject(project);
+                    projectLogger.buffer(`🚫 Skipping versioning for ${project} as it is a part of a fixed release group with ${firstProject} and no dependency bumps were detected`);
+                }
+            }
+            this.finalizeVersionDecisionsForGroup(releaseGroup);
+            return bumpedByDependency;
+        }
+        const { newVersion } = await this.calculateNewVersion(firstProject, newVersionInput, newVersionInputReason, newVersionInputReasonData);
+        // Use sorted projects for processing projects in the right order
+        const sortedProjects = this.releaseGraph.sortedProjects.get(releaseGroup.name) ||
+            releaseGroup.projects;
+        // First, update versions for all projects in the fixed group in topological order
+        for (const project of sortedProjects) {
+            const versionActions = this.getVersionActionsForProject(project);
+            const projectLogger = this.getProjectLoggerForProject(project);
+            const currentVersion = this.getCurrentCachedVersionForProject(project);
+            // The first project's version was determined above, so this log is only appropriate for the remaining projects
+            if (project !== firstProject) {
+                projectLogger.buffer(`❓ Applied version ${newVersion} directly, because the project is a member of a fixed release group containing ${firstProject}`);
+            }
+            /**
+             * Update the project's version based on the implementation details of the configured VersionActions
+             * and display any returned log messages to the user.
+             */
+            const logMessages = await versionActions.updateProjectVersion(this.tree, newVersion);
+            for (const logMessage of logMessages) {
+                projectLogger.buffer(logMessage);
+            }
+            this.bumpedProjects.add(project);
+            bumped = true;
+            // Populate version data for each project
+            this.versionData.set(project, {
+                currentVersion,
+                newVersion,
+                dependentProjects: this.getOriginalDependentProjects(project),
+            });
+        }
+        this.finalizeVersionDecisionsForGroup(releaseGroup);
+        // Then, update dependencies for all projects in the fixed group, also in topological order
+        if (bumped) {
+            for (const project of sortedProjects) {
+                await this.updateDependenciesForProject(project);
+            }
+        }
+        return bumped;
+    }
+    async bumpIndependentVersionGroup(releaseGroup) {
+        const releaseGroupFilteredProjects = this.releaseGraph.releaseGroupToFilteredProjects.get(releaseGroup);
+        let bumped = false;
+        const projectBumpTypes = new Map();
+        const projectsToUpdate = new Set();
+        // First pass: Determine bump types (only for projects in this release group)
+        for (const project of releaseGroupFilteredProjects) {
+            const { newVersionInput: bumpType, newVersionInputReason: bumpTypeReason, newVersionInputReasonData: bumpTypeReasonData, } = await this.determineVersionBumpForProject(releaseGroup, project);
+            projectBumpTypes.set(project, {
+                bumpType,
+                bumpTypeReason,
+                bumpTypeReasonData,
+            });
+            if (bumpType !== 'none') {
+                projectsToUpdate.add(project);
+            }
+        }
+        // Second pass: Update versions using topologically sorted projects
+        // This ensures dependencies are processed before dependents
+        const sortedProjects = this.releaseGraph.sortedProjects.get(releaseGroup.name) || [];
+        // Process projects in topological order
+        for (const project of sortedProjects) {
+            if (projectsToUpdate.has(project) &&
+                releaseGroupFilteredProjects.has(project)) {
+                const { bumpType: finalBumpType, bumpTypeReason: finalBumpTypeReason, bumpTypeReasonData: finalBumpTypeReasonData, } = projectBumpTypes.get(project);
+                if (finalBumpType !== 'none') {
+                    await this.bumpVersionForProject(project, finalBumpType, finalBumpTypeReason, finalBumpTypeReasonData);
+                    this.bumpedProjects.add(project);
+                    bumped = true;
+                }
+            }
+        }
+        this.finalizeVersionDecisionsForGroup(releaseGroup);
+        // Third pass: Update dependencies also in topological order
+        for (const project of sortedProjects) {
+            if (projectsToUpdate.has(project) &&
+                releaseGroupFilteredProjects.has(project)) {
+                await this.updateDependenciesForProject(project);
+            }
+        }
+        return bumped;
+    }
+    async determineVersionBumpForProject(releaseGroup, projectName) {
+        // User given specifier has the highest precedence
+        if (this.userGivenSpecifier) {
+            return {
+                newVersionInput: this.userGivenSpecifier,
+                newVersionInputReason: 'USER_SPECIFIER',
+                newVersionInputReasonData: {},
+            };
+        }
+        const projectGraphNode = this.projectGraph.nodes[projectName];
+        const projectLogger = this.getProjectLoggerForProject(projectName);
+        const cachedFinalConfigForProject = this.getCachedFinalConfigForProject(projectName);
+        if (cachedFinalConfigForProject.specifierSource === 'conventional-commits') {
+            const currentVersion = this.getCurrentCachedVersionForProject(projectName);
+            const bumpType = await (0, derive_specifier_from_conventional_commits_1.deriveSpecifierFromConventionalCommits)(this.nxReleaseConfig, this.projectGraph, projectLogger, releaseGroup, projectGraphNode, !!semver.prerelease(currentVersion ?? ''), this.releaseGraph.cachedLatestMatchingGitTag.get(projectName), this.releaseGraph, cachedFinalConfigForProject.fallbackCurrentVersionResolver, this.options.preid);
+            return {
+                newVersionInput: bumpType,
+                newVersionInputReason: 'CONVENTIONAL_COMMITS',
+                newVersionInputReasonData: {},
+            };
+        }
+        // Resolve the semver relative bump via version-plans
+        if (releaseGroup.versionPlans) {
+            const currentVersion = this.getCurrentCachedVersionForProject(projectName);
+            const { bumpType, versionPlanPath } = await (0, deriver_specifier_from_version_plans_1.deriveSpecifierFromVersionPlan)(projectLogger, releaseGroup, projectGraphNode, currentVersion);
+            if (bumpType !== 'none') {
+                this.processedVersionPlanFiles.add(versionPlanPath);
+            }
+            return {
+                newVersionInput: bumpType,
+                newVersionInputReason: 'VERSION_PLANS',
+                newVersionInputReasonData: {
+                    versionPlanPath,
+                },
+            };
+        }
+        // Only add the release group name to the log if it is one set by the user, otherwise it is useless noise
+        const maybeLogReleaseGroup = (log) => {
+            if (releaseGroup.name === config_1.IMPLICIT_DEFAULT_RELEASE_GROUP) {
+                return log;
+            }
+            return `${log} within release group "${releaseGroup.name}"`;
+        };
+        const versionActions = this.getVersionActionsForProject(projectName);
+        if (versionActions instanceof version_actions_1.NOOP_VERSION_ACTIONS) {
+            return {
+                newVersionInput: 'none',
+                newVersionInputReason: 'NOOP_VERSION_ACTIONS',
+                newVersionInputReasonData: {},
+            };
+        }
+        if (cachedFinalConfigForProject.specifierSource === 'prompt') {
+            let specifier;
+            if (releaseGroup.projectsRelationship === 'independent') {
+                specifier = await (0, resolve_semver_specifier_1.resolveSemverSpecifierFromPrompt)(`${maybeLogReleaseGroup(`What kind of change is this for project "${projectName}"`)}?`, `${maybeLogReleaseGroup(`What is the exact version for project "${projectName}"`)}?`);
+            }
+            else {
+                specifier = await (0, resolve_semver_specifier_1.resolveSemverSpecifierFromPrompt)(`${maybeLogReleaseGroup(`What kind of change is this for the ${releaseGroup.projects.length} matched projects(s)`)}?`, `${maybeLogReleaseGroup(`What is the exact version for the ${releaseGroup.projects.length} matched project(s)`)}?`);
+            }
+            return {
+                newVersionInput: specifier,
+                newVersionInputReason: 'PROMPTED_USER_SPECIFIER',
+                newVersionInputReasonData: {},
+            };
+        }
+        throw new Error(`Unhandled version bump config, please report this as a bug on https://github.com/nrwl/nx/issues`);
+    }
+    getVersionActionsForProject(projectName) {
+        const versionActions = this.releaseGraph.projectsToVersionActions.get(projectName);
+        if (!versionActions) {
+            throw new Error(`No versionActions found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
+        }
+        return versionActions;
+    }
+    getProjectLoggerForProject(projectName) {
+        const projectLogger = this.releaseGraph.projectLoggers.get(projectName);
+        if (!projectLogger) {
+            throw new Error(`No project logger found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
+        }
+        return projectLogger;
+    }
+    getCurrentCachedVersionForProject(projectName) {
+        return this.releaseGraph.cachedCurrentVersions.get(projectName);
+    }
+    getCachedFinalConfigForProject(projectName) {
+        const cachedFinalConfig = this.releaseGraph.finalConfigsByProject.get(projectName);
+        if (!cachedFinalConfig) {
+            throw new Error(`Unexpected error: No cached config found for project ${projectName}, please report this as a bug on https://github.com/nrwl/nx/issues`);
+        }
+        return cachedFinalConfig;
+    }
+    async calculateNewVersion(project, newVersionInput, // any arbitrary string, whether or not it is valid is dependent upon the version actions implementation
+    newVersionInputReason, newVersionInputReasonData) {
+        const currentVersion = this.getCurrentCachedVersionForProject(project);
+        const versionActions = this.getVersionActionsForProject(project);
+        const { newVersion, logText } = await versionActions.calculateNewVersion(currentVersion, newVersionInput, newVersionInputReason, newVersionInputReasonData, this.options.preid);
+        const projectLogger = this.getProjectLoggerForProject(project);
+        projectLogger.buffer(logText);
+        return { currentVersion, newVersion };
+    }
+    async updateDependenciesForProject(projectName) {
+        if (!this.releaseGraph.allProjectsToProcess.has(projectName)) {
+            throw new Error(`Unable to find ${projectName} in allProjectsToProcess, please report this as a bug on https://github.com/nrwl/nx/issues`);
+        }
+        if (!this.allVersionDecisionsFinalized) {
+            this.projectsWithDeferredDependencyUpdates.add(projectName);
+            return;
+        }
+        this.projectsWithDeferredDependencyUpdates.delete(projectName);
+        const versionActions = this.getVersionActionsForProject(projectName);
+        const cachedFinalConfigForProject = this.getCachedFinalConfigForProject(projectName);
+        const dependenciesToUpdate = {};
+        const dependencies = this.projectGraph.dependencies[projectName] || [];
+        for (const dep of dependencies) {
+            if (this.releaseGraph.allProjectsToProcess.has(dep.target)) {
+                const targetVersionData = this.versionData.get(dep.target);
+                if (targetVersionData) {
+                    const { currentVersion: currentDependencyVersion } = await versionActions.readCurrentVersionOfDependency(this.tree, this.projectGraph, dep.target);
+                    if (!currentDependencyVersion) {
+                        continue;
+                    }
+                    let finalPrefix = '';
+                    if (cachedFinalConfigForProject.versionPrefix === 'auto') {
+                        const prefixMatch = currentDependencyVersion?.match(/^([~^=])/);
+                        finalPrefix = prefixMatch ? prefixMatch[1] : '';
+                    }
+                    else if (['~', '^', '='].includes(cachedFinalConfigForProject.versionPrefix)) {
+                        finalPrefix = cachedFinalConfigForProject.versionPrefix;
+                    }
+                    const newVersion = targetVersionData.newVersion ??
+                        this.releaseGraph.cachedCurrentVersions.get(dep.target) ??
+                        currentDependencyVersion;
+                    // Remove any existing prefix from the new version before applying the finalPrefix
+                    const cleanNewVersion = newVersion.replace(/^[~^=]/, '');
+                    dependenciesToUpdate[dep.target] = `${finalPrefix}${cleanNewVersion}`;
+                }
+            }
+        }
+        const projectLogger = this.getProjectLoggerForProject(projectName);
+        const logMessages = await versionActions.updateProjectDependencies(this.tree, this.projectGraph, dependenciesToUpdate, (dependencyProjectName) => this.resolveVersionForDependency(dependencyProjectName));
+        for (const logMessage of logMessages) {
+            projectLogger.buffer(logMessage);
+        }
+    }
+    finalizeVersionDecisionsForGroup(releaseGroup) {
+        this.groupsWithFinalizedVersionDecisions.add(releaseGroup.name);
+    }
+    async finalizeAllVersionDecisions(processOrder) {
+        const unfinalizedReleaseGroups = Array.from(this.releaseGraph.groupGraph.keys()).filter((releaseGroupName) => !this.groupsWithFinalizedVersionDecisions.has(releaseGroupName));
+        if (unfinalizedReleaseGroups.length > 0) {
+            const releaseGroupNames = unfinalizedReleaseGroups
+                .map((releaseGroupName) => `"${releaseGroupName}"`)
+                .join(', ');
+            throw new Error(`Unable to finalize version decisions for release groups ${releaseGroupNames}. Please report this as a bug on https://github.com/nrwl/nx/issues.`);
+        }
+        this.allVersionDecisionsFinalized = true;
+        for (const releaseGroupName of processOrder) {
+            const releaseGroup = this.releaseGraph.groupGraph.get(releaseGroupName);
+            for (const projectName of releaseGroup.group.projects) {
+                if (this.projectsWithDeferredDependencyUpdates.has(projectName)) {
+                    await this.updateDependenciesForProject(projectName);
+                }
+            }
+            // Keep each group's buffered output together and in processing order.
+            for (const projectName of releaseGroup.group.projects) {
+                this.getProjectLoggerForProject(projectName).flush();
+            }
+        }
+        if (this.projectsWithDeferredDependencyUpdates.size > 0) {
+            const deferredProjects = Array.from(this.projectsWithDeferredDependencyUpdates, (projectName) => `"${projectName}"`).join(', ');
+            throw new Error(`Unable to update dependencies for projects ${deferredProjects} because their release groups were not processed. Please report this as a bug on https://github.com/nrwl/nx/issues.`);
+        }
+        this.flushAllProjectLoggers();
+    }
+    /**
+     * Resolve a dependency version when `dependenciesToUpdate` does not contain
+     * a concrete version for a manifest entry.
+     *
+     * @internal
+     */
+    async resolveVersionForDependency(dependencyProjectName) {
+        const versionData = this.versionData.get(dependencyProjectName);
+        if (versionData?.newVersion) {
+            return versionData.newVersion;
+        }
+        if (!this.releaseGraph.allProjectsToProcess.has(dependencyProjectName)) {
+            return this.releaseGraph.resolveCurrentVersionForDependency(this.tree, this.projectGraph, dependencyProjectName, this.options.preid);
+        }
+        const releaseGroupName = this.getReleaseGroupNameForProject(dependencyProjectName);
+        if (!releaseGroupName ||
+            !this.groupsWithFinalizedVersionDecisions.has(releaseGroupName)) {
+            throw new Error(`Cannot resolve a concrete version for dependency project "${dependencyProjectName}" because its release group has not finalized its version decisions. Ensure the release group can finalize the dependency version before Nx Release updates the dependent manifest.`);
+        }
+        if (versionData?.currentVersion) {
+            return versionData.currentVersion;
+        }
+        throw new Error(`Cannot resolve a concrete version for dependency project "${dependencyProjectName}" because its finalized release data has no current or new version.`);
+    }
+    async bumpVersionForProject(projectName, bumpType, bumpTypeReason, bumpTypeReasonData) {
+        const projectLogger = this.getProjectLoggerForProject(projectName);
+        if (bumpType === 'none') {
+            projectLogger.buffer(`⏩ Skipping bump for ${projectName} as bump type is "none"`);
+            return;
+        }
+        const versionActions = this.getVersionActionsForProject(projectName);
+        const { currentVersion, newVersion } = await this.calculateNewVersion(projectName, bumpType, bumpTypeReason, bumpTypeReasonData);
+        /**
+         * Update the project's version based on the implementation details of the configured VersionActions
+         * and display any returned log messages to the user.
+         */
+        const logMessages = await versionActions.updateProjectVersion(this.tree, newVersion);
+        for (const logMessage of logMessages) {
+            projectLogger.buffer(logMessage);
+        }
+        // Update version data and bumped projects
+        this.versionData.set(projectName, {
+            currentVersion,
+            newVersion,
+            dependentProjects: this.getOriginalDependentProjects(projectName),
+        });
+        this.bumpedProjects.add(projectName);
+        // Find the release group for this project
+        const releaseGroupName = this.getReleaseGroupNameForProject(projectName);
+        if (!releaseGroupName) {
+            projectLogger.buffer(`⚠️ Cannot find release group for ${projectName}, skipping dependent updates`);
+            return;
+        }
+        const releaseGroup = this.releaseGraph.groupGraph.get(releaseGroupName).group;
+        const releaseGroupVersionConfig = releaseGroup.version;
+        // Get updateDependents from the release group level config
+        const updateDependents = releaseGroupVersionConfig?.updateDependents || 'always';
+        // Only update dependencies for dependents if the group's updateDependents is 'auto' or 'always'
+        if (updateDependents === 'auto' || updateDependents === 'always') {
+            const dependents = this.getNonImplicitDependentsForProject(projectName);
+            // Only process dependents that are actually being processed
+            const dependentsToProcess = dependents.filter((dep) => this.releaseGraph.allProjectsToProcess.has(dep));
+            await this.updateDependenciesForDependents(dependentsToProcess);
+            for (const dependent of dependentsToProcess) {
+                if (!this.bumpedProjects.has(dependent)) {
+                    await this.bumpVersionForProject(dependent, this.applyPreidToBumpType('patch', dependent), 'DEPENDENCY_WAS_BUMPED', {});
+                }
+            }
+        }
+        else {
+            const releaseGroupText = releaseGroupName !== config_1.IMPLICIT_DEFAULT_RELEASE_GROUP
+                ? ` in release group "${releaseGroupName}" `
+                : ' ';
+            projectLogger.buffer(`⏩ Skipping dependent updates as "updateDependents"${releaseGroupText}is not "auto"`);
+        }
+    }
+    async updateDependenciesForDependents(dependents) {
+        for (const dependent of dependents) {
+            if (!this.releaseGraph.allProjectsToProcess.has(dependent)) {
+                throw new Error(`Unable to find project "${dependent}" in allProjectsToProcess, please report this as a bug on https://github.com/nrwl/nx/issues`);
+            }
+            await this.updateDependenciesForProject(dependent);
+        }
+    }
+    getOriginalDependentProjects(project) {
+        return (this.releaseGraph.originalDependentProjectsPerProject.get(project) || []);
+    }
+    async getFixedReleaseGroupBumpType(releaseGroupName) {
+        const releaseGroup = this.releaseGraph.groupGraph.get(releaseGroupName).group;
+        const releaseGroupFilteredProjects = this.releaseGraph.releaseGroupToFilteredProjects.get(releaseGroup);
+        if (releaseGroupFilteredProjects.size === 0) {
+            return 'none';
+        }
+        // It's a fixed release group, so we can just pick any project in the group
+        const anyProject = releaseGroupFilteredProjects.values().next().value;
+        // If already bumped, no need to re-calculate it
+        const { currentVersion, newVersion } = this.versionData.get(anyProject);
+        if (newVersion) {
+            return semver.diff(currentVersion, newVersion);
+        }
+        return (await this.determineVersionBumpForProject(releaseGroup, anyProject))
+            .newVersionInput;
+    }
+    // TODO: Support influencing the side effect bump in a future version, always patch for now like in legacy versioning
+    determineSideEffectBump(releaseGroup, dependencyBumpType) {
+        // Any project in the group can be used to resolve the applyPreidToDependents
+        // setting, since it is a group/workspace level option.
+        const anyProject = releaseGroup.projects[0];
+        return this.applyPreidToBumpType('patch', anyProject);
+    }
+    /**
+     * When a preid is set (e.g. --preid rc) and the project has opted in via
+     * `applyPreidToDependents`, convert a "patch" side-effect bump into a
+     * "prepatch" so that semver.inc() actually applies the preid.
+     * semver.inc('1.0.0', 'patch', 'rc') ignores preid and returns '1.0.1'.
+     * semver.inc('1.0.0', 'prepatch', 'rc') returns '1.0.1-rc.0' as expected.
+     */
+    applyPreidToBumpType(bumpType, projectName) {
+        if (!this.options.preid ||
+            bumpType === 'none' ||
+            bumpType.startsWith('pre')) {
+            return bumpType;
+        }
+        const finalConfig = this.getCachedFinalConfigForProject(projectName);
+        if (!finalConfig.applyPreidToDependents) {
+            return bumpType;
+        }
+        switch (bumpType) {
+            case 'major':
+                return 'premajor';
+            case 'minor':
+                return 'preminor';
+            case 'patch':
+                return 'prepatch';
+            default:
+                return bumpType;
+        }
+    }
+    getProjectDependents(project) {
+        return this.releaseGraph.projectToDependents.get(project) || new Set();
+    }
+    getNonImplicitDependentsForProject(project) {
+        // Use the cached dependents for O(1) lookup instead of O(n) scan
+        return Array.from(this.getProjectDependents(project));
+    }
+}
+exports.ReleaseGroupProcessor = ReleaseGroupProcessor;