nx 22.0.0-beta.2 → 22.0.0-beta.4

package/src/command-line/release/release.js

@@ -12,8 +12,6 @@ const output_1 = require("../../utils/output");
 const changelog_1 = require("./changelog");
 const config_1 = require("./config/config");
 const deep_merge_json_1 = require("./config/deep-merge-json");
-const filter_release_groups_1 = require("./config/filter-release-groups");
-const use_legacy_versioning_1 = require("./config/use-legacy-versioning");
 const version_plans_1 = require("./config/version-plans");
 const publish_1 = require("./publish");
 const git_1 = require("./utils/git");
@@ -49,8 +47,7 @@ function createAPI(overrideReleaseConfig) {
         // Apply default configuration to any optional user configuration
         const { error: configError, nxReleaseConfig } = await (0, config_1.createNxReleaseConfig)(projectGraph, await (0, file_map_utils_1.createProjectFileMapUsingProjectGraph)(projectGraph), userProvidedReleaseConfig);
         if (configError) {
-            const USE_LEGACY_VERSIONING = (0, use_legacy_versioning_1.shouldUseLegacyVersioning)(userProvidedReleaseConfig);
-            return await (0, config_1.handleNxReleaseConfigError)(configError, USE_LEGACY_VERSIONING);
+            return await (0, config_1.handleNxReleaseConfigError)(configError);
         }
         // --print-config exits directly as it is not designed to be combined with any other programmatic operations
         if (args.printConfig) {
@@ -60,16 +57,6 @@ function createAPI(overrideReleaseConfig) {
                 isDebug: args.printConfig === 'debug',
             });
         }
-        const { error: filterError, filterLog, releaseGroups, releaseGroupToFilteredProjects, } = (0, filter_release_groups_1.filterReleaseGroups)(projectGraph, nxReleaseConfig, args.projects, args.groups);
-        if (filterError) {
-            output_1.output.error(filterError);
-            process.exit(1);
-        }
-        if (filterLog) {
-            output_1.output.note(filterLog);
-        }
-        // Do not repeat the filter log in the release subcommands
-        process.env.NX_RELEASE_INTERNAL_SUPPRESS_FILTER_LOG = 'true';
         const rawVersionPlans = await (0, version_plans_1.readRawVersionPlans)();
         if (args.specifier && rawVersionPlans.length > 0) {
             output_1.output.error({
@@ -86,21 +73,21 @@ function createAPI(overrideReleaseConfig) {
         const shouldStage = (shouldCommit || userProvidedReleaseConfig.git?.stageChanges) ?? false;
         const shouldTag = userProvidedReleaseConfig.git?.tag ?? true;
         const shouldCreateWorkspaceRemoteRelease = shouldCreateRemoteRelease(nxReleaseConfig.changelog.workspaceChangelog);
-        // If the workspace or any of the release groups specify that a remote release should be created, we need to push the changes to the remote
-        const shouldPush = (shouldCreateWorkspaceRemoteRelease ||
-            releaseGroups.some((group) => shouldCreateRemoteRelease(group.changelog))) ??
-            false;
-        const versionResult = await releaseVersion({
+        const { workspaceVersion, projectsVersionData, releaseGraph, } = await releaseVersion({
             ...args,
             stageChanges: shouldStage,
             gitCommit: false,
             gitTag: false,
             deleteVersionPlans: false,
         });
+        // Suppress the filter log for the changelog command as it would have already been printed by the version command
+        process.env.NX_RELEASE_INTERNAL_SUPPRESS_FILTER_LOG = 'true';
         const changelogResult = await releaseChangelog({
             ...args,
-            versionData: versionResult.projectsVersionData,
-            version: versionResult.workspaceVersion,
+            // Re-use existing release graph
+            releaseGraph,
+            versionData: projectsVersionData,
+            version: workspaceVersion,
             stageChanges: shouldStage,
             gitCommit: false,
             gitTag: false,
@@ -108,16 +95,16 @@ function createAPI(overrideReleaseConfig) {
             createRelease: false,
             deleteVersionPlans: false,
         });
-        await (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGroups, Object.keys(projectGraph.nodes), args.verbose);
+        await (0, version_plans_1.setResolvedVersionPlansOnGroups)(rawVersionPlans, releaseGraph.releaseGroups, Object.keys(projectGraph.nodes), args.verbose);
         // Validate version plans against the filter after resolution
-        const versionPlanValidationError = (0, version_plan_utils_1.validateResolvedVersionPlansAgainstFilter)(releaseGroups, releaseGroupToFilteredProjects);
+        const versionPlanValidationError = (0, version_plan_utils_1.validateResolvedVersionPlansAgainstFilter)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects);
         if (versionPlanValidationError) {
             output_1.output.error(versionPlanValidationError);
             process.exit(1);
         }
         const planFiles = new Set();
-        releaseGroups.forEach((group) => {
-            const filteredProjects = releaseGroupToFilteredProjects.get(group);
+        releaseGraph.releaseGroups.forEach((group) => {
+            const filteredProjects = releaseGraph.releaseGroupToFilteredProjects.get(group);
             if (group.resolvedVersionPlans) {
                 // Check each version plan individually to see if it should be deleted
                 const plansToDelete = [];
@@ -164,7 +151,7 @@ function createAPI(overrideReleaseConfig) {
         if (shouldCommit) {
             output_1.output.logSingleLine(`Committing changes with git`);
             const commitMessage = nxReleaseConfig.git.commitMessage;
-            const commitMessageValues = (0, shared_1.createCommitMessageValues)(releaseGroups, releaseGroupToFilteredProjects, versionResult.projectsVersionData, commitMessage);
+            const commitMessageValues = (0, shared_1.createCommitMessageValues)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects, projectsVersionData, commitMessage);
             await (0, git_1.gitCommit)({
                 messages: commitMessageValues,
                 additionalArgs: nxReleaseConfig.git.commitArgs,
@@ -175,7 +162,7 @@ function createAPI(overrideReleaseConfig) {
         if (shouldTag) {
             output_1.output.logSingleLine(`Tagging commit with git`);
             // Resolve any git tags as early as possible so that we can hard error in case of any duplicates before reaching the actual git command
-            const gitTagValues = (0, shared_1.createGitTagValues)(releaseGroups, releaseGroupToFilteredProjects, versionResult.projectsVersionData);
+            const gitTagValues = (0, shared_1.createGitTagValues)(releaseGraph.releaseGroups, releaseGraph.releaseGroupToFilteredProjects, projectsVersionData);
             (0, shared_1.handleDuplicateGitTags)(gitTagValues);
             for (const tag of gitTagValues) {
                 await (0, git_1.gitTag)({
@@ -188,6 +175,10 @@ function createAPI(overrideReleaseConfig) {
             }
         }
         let hasPushedChanges = false;
+        // If the workspace or any of the release groups specify that a remote release should be created, we need to push the changes to the remote
+        const shouldPush = (shouldCreateWorkspaceRemoteRelease ||
+            releaseGraph.releaseGroups.some((group) => shouldCreateRemoteRelease(group.changelog))) ??
+            false;
         if (shouldPush) {
             output_1.output.logSingleLine(`Pushing to git remote "origin"`);
             await (0, git_1.gitPush)({
@@ -211,7 +202,11 @@ function createAPI(overrideReleaseConfig) {
             latestCommit = await (0, git_1.getCommitHash)('HEAD');
             await remoteReleaseClient.createOrUpdateRelease(changelogResult.workspaceChangelog.releaseVersion, changelogResult.workspaceChangelog.contents, latestCommit, { dryRun: args.dryRun });
         }
-        for (const releaseGroup of releaseGroups) {
+        for (const releaseGroupName of releaseGraph.sortedReleaseGroups) {
+            const releaseGroup = releaseGraph.releaseGroups.find((g) => g.name === releaseGroupName);
+            if (!releaseGroup) {
+                continue;
+            }
             const shouldCreateProjectRemoteReleases = shouldCreateRemoteRelease(releaseGroup.changelog);
             if (shouldCreateProjectRemoteReleases &&
                 changelogResult.projectChangelogs) {
@@ -221,7 +216,7 @@ function createAPI(overrideReleaseConfig) {
                     .createRelease);
                 const projects = args.projects?.length
                     ? // If the user has passed a list of projects, we need to use the filtered list of projects within the release group
-                        Array.from(releaseGroupToFilteredProjects.get(releaseGroup))
+                        Array.from(releaseGraph.releaseGroupToFilteredProjects.get(releaseGroup))
                     : // Otherwise, we use the full list of projects within the release group
                         releaseGroup.projects;
                 const projectNodes = projects.map((name) => projectGraph.nodes[name]);
@@ -243,8 +238,8 @@ function createAPI(overrideReleaseConfig) {
         }
         let hasNewVersion = false;
         // null means that all projects are versioned together but there were no changes
-        if (versionResult.workspaceVersion !== null) {
-            hasNewVersion = Object.values(versionResult.projectsVersionData).some((version) => 
+        if (workspaceVersion !== null) {
+            hasNewVersion = Object.values(projectsVersionData).some((version) => 
             /**
              * There is a scenario where applications will not have a newVersion created by VerisonActions,
              * however, there will still be a dockerVersion created from the docker release.
@@ -259,7 +254,7 @@ function createAPI(overrideReleaseConfig) {
         if (shouldPublish) {
             const publishResults = await releasePublish({
                 ...args,
-                versionData: versionResult.projectsVersionData,
+                versionData: projectsVersionData,
             });
             const allExitOk = Object.values(publishResults).every((result) => result.code === 0);
             if (!allExitOk) {
@@ -270,7 +265,11 @@ function createAPI(overrideReleaseConfig) {
         else {
             output_1.output.logSingleLine('Skipped publishing packages.');
         }
-        return versionResult;
+        return {
+            workspaceVersion,
+            projectsVersionData,
+            releaseGraph,
+        };
     };
 }
 async function promptForPublish() {

package/src/command-line/release/utils/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../../../../packages/nx/src/command-line/release/utils/git.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../../../../packages/nx/src/command-line/release/utils/git.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B,EAAE,OAAO,CAAC;IACxC,4BAA4B,EAAE,OAAO,CAAC;CACvC;AAUD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAclB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,CAC7C,iBAAiB,EAAE,MAAM,EACzB,2BAA2B,IAAK,EAChC,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA2JlC;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,EAAE,SAAS,GACV,OAAO,CAAC,YAAY,EAAE,CAAC,CA2CzB;AAUD,wBAAsB,MAAM,CAAC,EAC3B,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,OAAO,EACP,KAAK,EACL,GAAG,GACJ,EAAE;IACD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACzC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB;AAcD,wBAAsB,SAAS,CAAC,EAC9B,QAAQ,EACR,cAAc,EACd,MAAM,EACN,OAAO,EACP,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAED,wBAAsB,MAAM,CAAC,EAC3B,GAAG,EACH,OAAO,EACP,cAAc,EACd,MAAM,EACN,OAAO,EACP,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,wBAAsB,OAAO,CAAC,EAC5B,SAAS,EACT,MAAM,EACN,OAAO,EACP,cAAc,GACf,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACpC,iBAoCA;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAEjE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,IAAI,CAiBP;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,CAiC7E;AA2BD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG;IAC5D,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAKA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAqDrE;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,mBAM9C;AAED,wBAAsB,iBAAiB,oBAatC"}

package/src/command-line/release/utils/git.js

@@ -140,11 +140,13 @@ async function getLatestGitTagForPattern(releaseTagPattern, additionalInterpolat
         const interpolatedTagPattern = (0, utils_1.interpolate)(releaseTagPattern, {
             version: '%v%',
             projectName: '%p%',
+            releaseGroupName: '%rg%',
             ...additionalInterpolationData,
         });
         const tagRegexp = `^${escapeRegExp(interpolatedTagPattern)
             .replace('%v%', '(.+)')
-            .replace('%p%', '(.+)')}`;
+            .replace('%p%', '(.+)')
+            .replace('%rg%', '(.+)')}`;
         const matchingTags = tags.filter((tag) => {
             if (releaseTagPatternRequireSemver) {
                 // Match against Semver Regex when using semverVersioning to ensure only valid semver tags are matched

package/src/command-line/release/utils/release-graph.d.ts

@@ -0,0 +1,219 @@
+import type { NxReleaseDockerConfiguration, NxReleaseVersionConfiguration } from '../../../config/nx-json';
+import type { ProjectGraph } from '../../../config/project-graph';
+import type { Tree } from '../../../generators/tree';
+import { type NxReleaseConfig } from '../config/config';
+import type { ReleaseGroupWithName } from '../config/filter-release-groups';
+import { ProjectLogger } from '../version/project-logger';
+import { type AfterAllProjectsVersioned, type VersionActions } from '../version/version-actions';
+/**
+ * Final configuration for a project after applying release group and project level overrides
+ */
+export interface FinalConfigForProject {
+    specifierSource: NxReleaseVersionConfiguration['specifierSource'];
+    currentVersionResolver: NxReleaseVersionConfiguration['currentVersionResolver'];
+    currentVersionResolverMetadata: NxReleaseVersionConfiguration['currentVersionResolverMetadata'];
+    fallbackCurrentVersionResolver: NxReleaseVersionConfiguration['fallbackCurrentVersionResolver'];
+    versionPrefix: NxReleaseVersionConfiguration['versionPrefix'];
+    preserveLocalDependencyProtocols: NxReleaseVersionConfiguration['preserveLocalDependencyProtocols'];
+    preserveMatchingDependencyRanges: NxReleaseVersionConfiguration['preserveMatchingDependencyRanges'];
+    versionActionsOptions: NxReleaseVersionConfiguration['versionActionsOptions'];
+    manifestRootsToUpdate: Array<Exclude<NxReleaseVersionConfiguration['manifestRootsToUpdate'][number], string>>;
+    dockerOptions: NxReleaseDockerConfiguration & {
+        groupPreVersionCommand?: string;
+    };
+}
+interface GroupNode {
+    group: ReleaseGroupWithName;
+    dependencies: Set<string>;
+    dependents: Set<string>;
+}
+export interface CreateReleaseGraphOptions {
+    tree: Tree;
+    projectGraph: ProjectGraph;
+    nxReleaseConfig: NxReleaseConfig;
+    filters: {
+        projects?: string[];
+        groups?: string[];
+    };
+    firstRelease: boolean;
+    preid?: string;
+    verbose: boolean;
+    /**
+     * Current version resolution is not needed for publishing, so in cases where the publish subcommand needs to build a release graph,
+     * we allow it to skip this step.
+     */
+    skipVersionResolution?: boolean;
+    versionActionsOptionsOverrides?: Record<string, unknown>;
+}
+export declare const validReleaseVersionPrefixes: readonly ["auto", "", "~", "^", "="];
+/**
+ * The complete release graph containing all relationships, caches, and computed data
+ * necessary for efficient release operations across versioning, changelog, and publishing.
+ *
+ * This class encapsulates the complex dependency graph between projects and release groups,
+ * providing convenient methods for querying relationships and accessing cached data.
+ */
+export declare class ReleaseGraph {
+    releaseGroups: ReleaseGroupWithName[];
+    readonly filters: {
+        projects?: string[];
+        groups?: string[];
+    };
+    readonly projectToReleaseGroup: Map<string, ReleaseGroupWithName>;
+    readonly projectToDependents: Map<string, Set<string>>;
+    readonly projectToDependencies: Map<string, Set<string>>;
+    readonly projectToUpdateDependentsSetting: Map<string, "never" | "auto" | "always">;
+    readonly groupGraph: Map<string, GroupNode>;
+    sortedReleaseGroups: string[];
+    readonly sortedProjects: Map<string, string[]>;
+    readonly allProjectsConfiguredForNxRelease: Set<string>;
+    allProjectsToProcess: Set<string>;
+    readonly finalConfigsByProject: Map<string, FinalConfigForProject>;
+    readonly projectsToVersionActions: Map<string, VersionActions>;
+    readonly uniqueAfterAllProjectsVersioned: Map<string, AfterAllProjectsVersioned>;
+    readonly projectLoggers: Map<string, ProjectLogger>;
+    readonly cachedCurrentVersions: Map<string, string>;
+    readonly cachedLatestMatchingGitTag: Map<string, import("./git").GitTagAndVersion>;
+    readonly currentVersionsPerFixedReleaseGroup: Map<string, {
+        currentVersion: string;
+        originatingProjectName: string;
+        logText: string;
+    }>;
+    readonly originalDependentProjectsPerProject: Map<string, {
+        source: string;
+        target: string;
+        type: string;
+        dependencyCollection: string;
+        rawVersionSpec: string;
+    }[]>;
+    readonly releaseGroupToFilteredProjects: Map<ReleaseGroupWithName, Set<string>>;
+    private originalFilteredProjects;
+    /**
+     * User-friendly log describing what the filter matched.
+     * Null if no filters were applied.
+     */
+    filterLog: {
+        title: string;
+        bodyLines: string[];
+    } | null;
+    constructor(releaseGroups: ReleaseGroupWithName[], filters: {
+        projects?: string[];
+        groups?: string[];
+    });
+    /**
+     * Initialize the graph by building all relationships and caches
+     * @internal - Called by createReleaseGraph(), not meant for external use
+     */
+    init(options: CreateReleaseGraphOptions): Promise<void>;
+    /**
+     * Setup mapping from project to release group and cache updateDependents settings
+     */
+    private setupProjectReleaseGroupMapping;
+    /**
+     * Apply initial filtering to construct releaseGroupToFilteredProjects based on filters.
+     * This determines the base set of projects and groups before considering dependencies.
+     */
+    private applyInitialFiltering;
+    /**
+     * Check if any filters are applied
+     */
+    private hasAnyFilters;
+    /**
+     * Setup projects to process and resolve version actions
+     */
+    private setupProjectsToProcess;
+    /**
+     * Precompute dependency relationships between all projects
+     */
+    private precomputeDependencyRelationships;
+    /**
+     * Apply dependency-aware filtering that considers updateDependents configuration.
+     * This includes transitive dependents when updateDependents='auto'.
+     */
+    private applyDependencyAwareFiltering;
+    /**
+     * Validate that the filter doesn't try to isolate projects in fixed release groups
+     */
+    private validateFilterAgainstFixedGroups;
+    /**
+     * Find dependents that should be included in processing based on updateDependents configuration
+     */
+    private findDependentsToProcess;
+    /**
+     * Generate user-friendly log describing what the filter matched
+     */
+    private generateFilterLog;
+    /**
+     * Build the group graph structure
+     */
+    private buildGroupGraphStructure;
+    /**
+     * Resolve current versions for all projects that will be processed
+     */
+    private resolveCurrentVersionsForProjects;
+    /**
+     * Build dependency relationships between release groups
+     */
+    private buildGroupDependencyGraph;
+    /**
+     * Topologically sort release groups
+     */
+    private topologicallySortReleaseGroups;
+    /**
+     * Topologically sort projects within a release group
+     */
+    private topologicallySortProjects;
+    private populateDependentProjectsData;
+    /**
+     * Get all non-implicit dependents for a set of projects
+     */
+    private getAllNonImplicitDependents;
+    /**
+     * Resolve final configuration for a project
+     *
+     * NOTE: We are providing ultimate fallback values via ?? here mainly just to keep TypeScript happy.
+     * All default values should have been applied by this point by config.ts but the types can't know
+     * that for sure at this point.
+     */
+    private static resolveFinalConfigForProject;
+    /**
+     * Get the release group for a given project
+     */
+    getReleaseGroupForProject(projectName: string): ReleaseGroupWithName | undefined;
+    /**
+     * Get the release group name for a given project
+     */
+    getReleaseGroupNameForProject(projectName: string): string | null;
+    /**
+     * Get the dependencies of a project
+     */
+    getProjectDependencies(projectName: string): Set<string>;
+    /**
+     * Get the dependents of a project (projects that depend on it)
+     */
+    getProjectDependents(projectName: string): Set<string>;
+    /**
+     * Get the version actions for a project
+     */
+    getVersionActionsForProject(projectName: string): VersionActions | undefined;
+    /**
+     * Check if a project will be processed
+     */
+    isProjectToProcess(projectName: string): boolean;
+    /**
+     * Runs validation on resolved VersionActions instances. E.g. check that manifest files exist for all projects that will be processed.
+     * This should be called after preVersionCommand has run, as those commands may create manifest files that are needed for versioning.
+     */
+    validate(tree: Tree): Promise<void>;
+}
+/**
+ * Creates a complete release graph by analyzing all release groups, projects, and their relationships.
+ *
+ * This function builds the graph structure, applies filtering logic that considers dependencies
+ * and updateDependents configuration, and caches all necessary data.
+ *
+ * The returned graph can be reused across versioning, changelog, and publishing operations.
+ */
+export declare function createReleaseGraph(options: CreateReleaseGraphOptions): Promise<ReleaseGraph>;
+export {};
+//# sourceMappingURL=release-graph.d.ts.map

package/src/command-line/release/utils/release-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-graph.d.ts","sourceRoot":"","sources":["../../../../../../../packages/nx/src/command-line/release/utils/release-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAIpC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,6BAA6B,CAAC,iBAAiB,CAAC,CAAC;IAClE,sBAAsB,EAAE,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;IAChF,8BAA8B,EAAE,6BAA6B,CAAC,gCAAgC,CAAC,CAAC;IAChG,8BAA8B,EAAE,6BAA6B,CAAC,gCAAgC,CAAC,CAAC;IAChG,aAAa,EAAE,6BAA6B,CAAC,eAAe,CAAC,CAAC;IAC9D,gCAAgC,EAAE,6BAA6B,CAAC,kCAAkC,CAAC,CAAC;IACpG,gCAAgC,EAAE,6BAA6B,CAAC,kCAAkC,CAAC,CAAC;IACpG,qBAAqB,EAAE,6BAA6B,CAAC,uBAAuB,CAAC,CAAC;IAC9E,qBAAqB,EAAE,KAAK,CAC1B,OAAO,CACL,6BAA6B,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,EAC9D,MAAM,CACP,CACF,CAAC;IACF,aAAa,EAAE,4BAA4B,GAAG;QAC5C,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,8BAA8B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,2BAA2B,sCAAuC,CAAC;AAEhF;;;;;;GAMG;AACH,qBAAa,YAAY;IAkDd,aAAa,EAAE,oBAAoB,EAAE;aAC5B,OAAO,EAAE;QACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB;IArDH,QAAQ,CAAC,qBAAqB,oCAA2C;IACzE,QAAQ,CAAC,mBAAmB,2BAAkC;IAC9D,QAAQ,CAAC,qBAAqB,2BAAkC;IAChE,QAAQ,CAAC,gCAAgC,2CAGrC;IACJ,QAAQ,CAAC,UAAU,yBAAgC;IACnD,mBAAmB,EAAE,MAAM,EAAE,CAAM;IACnC,QAAQ,CAAC,cAAc,wBAA+B;IACtD,QAAQ,CAAC,iCAAiC,cAAqB;IAC/D,oBAAoB,cAAqB;IACzC,QAAQ,CAAC,qBAAqB,qCAA4C;IAC1E,QAAQ,CAAC,wBAAwB,8BAAqC;IACtE,QAAQ,CAAC,+BAA+B,yCAGpC;IACJ,QAAQ,CAAC,cAAc,6BAAoC;IAC3D,QAAQ,CAAC,qBAAqB,sBAAoC;IAClE,QAAQ,CAAC,0BAA0B,gDAG/B;IACJ,QAAQ,CAAC,mCAAmC;wBAGxB,MAAM;gCACE,MAAM;iBACrB,MAAM;OAEf;IACJ,QAAQ,CAAC,mCAAmC;;;;;;SAGxC;IACJ,QAAQ,CAAC,8BAA8B,yCAGnC;IACJ,OAAO,CAAC,wBAAwB,CAAqB;IAErD;;;OAGG;IACH,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAQ;gBAGvD,aAAa,EAAE,oBAAoB,EAAE,EAC5B,OAAO,EAAE;QACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB;IAGH;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD7D;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAavC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAsD7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;YACW,sBAAsB;IA0FpC;;OAEG;YACW,iCAAiC;IA4B/C;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAmBrC;;OAEG;IACH,OAAO,CAAC,gCAAgC;IA6BxC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqG/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;YACW,iCAAiC;IA4D/C;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;OAEG;IACH,OAAO,CAAC,8BAA8B;IActC;;OAEG;IACH,OAAO,CAAC,yBAAyB;YAmBnB,6BAA6B;IAqC3C;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAMnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAiK3C;;OAEG;IACH,yBAAyB,CACvB,WAAW,EAAE,MAAM,GAClB,oBAAoB,GAAG,SAAS;IAInC;;OAEG;IACH,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKjE;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIxD;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAItD;;OAEG;IACH,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI5E;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIhD;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1C;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,YAAY,CAAC,CAgBvB"}