nx 21.0.0-canary.20250423-16fc551 → 21.0.0-canary.20250425-ee097a8

package/migrations.json

@@ -63,6 +63,11 @@
       "description": "Set `useLegacyCache` to true for migrating workspaces",
       "implementation": "./src/migrations/update-20-0-1/use-legacy-cache",
       "x-repair-skip": true
+    },
+    "release-version-config-changes": {
+      "version": "21.0.0-beta.1",
+      "description": "Updates release version config based on the breaking changes in Nx v21",
+      "implementation": "./src/migrations/update-21-0-0/release-version-config-changes"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "21.0.0-canary.20250423-16fc551",
+  "version": "21.0.0-canary.20250425-ee097a8",
   "private": false,
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
@@ -83,16 +83,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-arm64": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-darwin-x64": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-freebsd-x64": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-linux-arm-gnueabihf": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-linux-arm64-gnu": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-linux-arm64-musl": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-linux-x64-gnu": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-linux-x64-musl": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-win32-arm64-msvc": "21.0.0-canary.20250423-16fc551",
-    "@nx/nx-win32-x64-msvc": "21.0.0-canary.20250423-16fc551"
+    "@nx/nx-darwin-arm64": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-darwin-x64": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-freebsd-x64": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-linux-arm-gnueabihf": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-linux-arm64-gnu": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-linux-arm64-musl": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-linux-x64-gnu": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-linux-x64-musl": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-win32-arm64-msvc": "21.0.0-canary.20250425-ee097a8",
+    "@nx/nx-win32-x64-msvc": "21.0.0-canary.20250425-ee097a8"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/schemas/nx-schema.json

@@ -707,49 +707,17 @@
         "$comment": "When using the latest versioning implementation a lot of configuration has been able to move directly onto the version property.",
         "properties": {
           "useLegacyVersioning": {
-            "const": true
+            "const": false
           }
         }
       },
       "then": {
-        "properties": {
-          "useLegacyVersioning": {
-            "type": "boolean",
-            "description": "Whether to use the legacy versioning strategy. This value will be true in Nx v20 and false in Nx v21. The legacy versioning implementation will be removed in Nx v22, as will this flag.",
-            "default": true
-          },
-          "conventionalCommits": {
-            "type": "boolean",
-            "description": "Shorthand for enabling the current version of projects to be resolved from git tags, and the next version to be determined by analyzing commit messages according to the Conventional Commits specification.",
-            "default": false
-          },
-          "git": {
-            "$ref": "#/definitions/NxReleaseGitConfiguration"
-          },
-          "preVersionCommand": {
-            "type": "string",
-            "description": "A command to run after validation of nx release configuration, but before versioning begins. Useful for preparing build artifacts. If --dry-run is passed, the command is still executed, but with the NX_DRY_RUN environment variable set to 'true'."
-          },
-          "generator": {
-            "type": "string",
-            "description": "The generator implementation to use for versioning.",
-            "default": "@nx/js:release-version"
-          },
-          "generatorOptions": {
-            "type": "object",
-            "description": "These options will be passed to the configured \"release.version.generator\" (which will be \"@nx/js:release-version\" if not set explicitly).",
-            "additionalProperties": true
-          }
-        },
-        "additionalProperties": false
-      },
-      "else": {
         "additionalProperties": false,
         "properties": {
           "useLegacyVersioning": {
             "type": "boolean",
             "description": "Whether to use the legacy versioning strategy. This value will be true in Nx v20 and false in Nx v21. The legacy versioning implementation will be removed in Nx v22, as will this flag.",
-            "default": true
+            "default": false
           },
           "conventionalCommits": {
             "type": "boolean",
@@ -791,10 +759,6 @@
             "enum": ["disk"],
             "description": "The fallback version resolver to use when the configured currentVersionResolver fails to resolve the current version."
           },
-          "firstRelease": {
-            "type": "boolean",
-            "description": "Whether or not this is the first release of one of more projects. This removes certain validation checks that are not possible to enforce if the project has never been released before."
-          },
           "versionPrefix": {
             "type": "string",
             "enum": ["auto", "", "~", "^", "="],
@@ -833,6 +797,38 @@
             "additionalProperties": true
           }
         }
+      },
+      "else": {
+        "properties": {
+          "useLegacyVersioning": {
+            "type": "boolean",
+            "description": "Whether to use the legacy versioning strategy. This value was true in Nx v20 and became false in Nx v21. The legacy versioning implementation will be removed in Nx v22, as will this flag.",
+            "default": false
+          },
+          "conventionalCommits": {
+            "type": "boolean",
+            "description": "Shorthand for enabling the current version of projects to be resolved from git tags, and the next version to be determined by analyzing commit messages according to the Conventional Commits specification.",
+            "default": false
+          },
+          "git": {
+            "$ref": "#/definitions/NxReleaseGitConfiguration"
+          },
+          "preVersionCommand": {
+            "type": "string",
+            "description": "A command to run after validation of nx release configuration, but before versioning begins. Useful for preparing build artifacts. If --dry-run is passed, the command is still executed, but with the NX_DRY_RUN environment variable set to 'true'."
+          },
+          "generator": {
+            "type": "string",
+            "description": "The generator implementation to use for versioning.",
+            "default": "@nx/js:release-version"
+          },
+          "generatorOptions": {
+            "type": "object",
+            "description": "These options will be passed to the configured \"release.version.generator\" (which will be \"@nx/js:release-version\" if not set explicitly).",
+            "additionalProperties": true
+          }
+        },
+        "additionalProperties": false
       }
     },
     "NxReleaseGroupVersionConfiguration": {

package/schemas/project-schema.json

@@ -138,6 +138,11 @@
             "type": "boolean",
             "description": "Specifies if the given target should be cacheable"
           },
+          "continuous": {
+            "type": "boolean",
+            "default": false,
+            "description": "Whether this target runs continuously until stopped"
+          },
           "parallelism": {
             "type": "boolean",
             "default": true,

package/src/command-line/init/configure-plugins.js

@@ -65,9 +65,11 @@ async function runPluginInitGenerator(plugin, repoRoot = workspace_root_1.worksp
     }
     catch {
         // init generator does not exist, so this function should noop
-        output_1.output.log({
-            title: `No "init" generator found in ${plugin}. Skipping initialization.`,
-        });
+        if (process.env.NX_VERBOSE_LOGGING === 'true') {
+            output_1.output.log({
+                title: `No "init" generator found in ${plugin}. Skipping initialization.`,
+            });
+        }
         return;
     }
 }

package/src/command-line/init/implementation/utils.d.ts

@@ -12,8 +12,9 @@ export declare function initCloud(installationSource: 'nx-init' | 'nx-init-angul
 export declare function addVsCodeRecommendedExtensions(repoRoot: string, extensions: string[]): void;
 export declare function markRootPackageJsonAsNxProjectLegacy(repoRoot: string, cacheableScripts: string[], pmc: PackageManagerCommands): void;
 export declare function markPackageJsonAsNxProject(packageJsonPath: string): void;
-export declare function printFinalMessage({ learnMoreLink, }: {
+export declare function printFinalMessage({ learnMoreLink, appendLines, }: {
     learnMoreLink?: string;
+    appendLines?: string[];
 }): void;
 export declare function isMonorepo(packageJson: PackageJson): boolean;
 export declare function isCRA(packageJson: PackageJson): boolean;

package/src/command-line/init/implementation/utils.js

@@ -248,7 +248,7 @@ function markPackageJsonAsNxProject(packageJsonPath) {
     json.nx = {};
     (0, fileutils_1.writeJsonFile)(packageJsonPath, json);
 }
-function printFinalMessage({ learnMoreLink, }) {
+function printFinalMessage({ learnMoreLink, appendLines, }) {
     const pmc = (0, package_manager_1.getPackageManagerCommand)();
     output_1.output.success({
         title: '🎉 Done!',
@@ -256,6 +256,7 @@ function printFinalMessage({ learnMoreLink, }) {
             `- Run "${(0, child_process_2.getRunNxBaseCommand)(pmc)} run-many -t build" to run the build target for every project in the workspace. Run it again to replay the cached computation. https://nx.dev/features/cache-task-results`,
             `- Run "${(0, child_process_2.getRunNxBaseCommand)(pmc)} graph" to see the graph of projects and tasks in your workspace. https://nx.dev/core-features/explore-graph`,
             learnMoreLink ? `- Learn more at ${learnMoreLink}.` : undefined,
+            ...(appendLines ?? []),
         ].filter(Boolean),
     });
 }

package/src/command-line/init/init-v2.js

@@ -45,11 +45,6 @@ async function initHandler(options) {
     const _isTurborepo = (0, fs_1.existsSync)('turbo.json');
     const _isMonorepo = _isNonJs ? false : (0, utils_1.isMonorepo)(packageJson);
     const _isCRA = _isNonJs ? false : (0, utils_1.isCRA)(packageJson);
-    const learnMoreLink = _isTurborepo
-        ? 'https://nx.dev/recipes/adopting-nx/from-turborepo'
-        : _isMonorepo
-            ? 'https://nx.dev/getting-started/tutorials/npm-workspaces-tutorial'
-            : 'https://nx.dev/recipes/adopting-nx/adding-to-existing-project';
     /**
      * Turborepo users must have set up individual scripts already, and we keep the transition as minimal as possible.
      * We log a message during the conversion process in addNxToTurborepo about how they can learn more about the power
@@ -61,7 +56,7 @@ async function initHandler(options) {
             interactive: options.interactive,
         });
         (0, utils_1.printFinalMessage)({
-            learnMoreLink,
+            learnMoreLink: 'https://nx.dev/recipes/adopting-nx/from-turborepo',
         });
         return;
     }
@@ -118,7 +113,13 @@ async function initHandler(options) {
         await (0, utils_1.initCloud)('nx-init');
     }
     (0, utils_1.printFinalMessage)({
-        learnMoreLink,
+        appendLines: _isMonorepo
+            ? [
+                `- Learn how Nx helps manage your TypeScript monorepo at https://nx.dev/features/maintain-ts-monorepos.`,
+            ]
+            : [
+                `- Learn how Nx works with any type of project at https://nx.dev/recipes/adopting-nx/adding-to-existing-project.`,
+            ],
     });
 }
 const npmPackageToPluginMap = {

package/src/command-line/release/command-object.d.ts

@@ -26,7 +26,13 @@ export type VersionOptions = NxReleaseArgs & GitOptions & VersionPlanArgs & Firs
     specifier?: string;
     preid?: string;
     stageChanges?: boolean;
+    /**
+     * @deprecated Use versionActionsOptionsOverrides instead.
+     *
+     * Using generatorOptionsOverrides is only valid when release.version.useLegacyVersioning is set to true.
+     */
     generatorOptionsOverrides?: Record<string, unknown>;
+    versionActionsOptionsOverrides?: Record<string, unknown>;
 };
 export type ChangelogOptions = NxReleaseArgs & GitOptions & VersionPlanArgs & FirstReleaseArgs & {
     version?: string | null;

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

@@ -151,9 +151,12 @@ async function createNxReleaseConfig(projectGraph, projectFileMap, userConfig =
                     versionActionsOptions: {},
                     currentVersionResolver: defaultGeneratorOptions.currentVersionResolver,
                     specifierSource: defaultGeneratorOptions.specifierSource,
-                    preserveLocalDependencyProtocols: userConfig.version?.preserveLocalDependencyProtocols ?? true,
-                    logUnchangedProjects: userConfig.version?.logUnchangedProjects ?? true,
-                    updateDependents: userConfig.version?.updateDependents ?? 'auto',
+                    preserveLocalDependencyProtocols: userConfig.version
+                        ?.preserveLocalDependencyProtocols ?? true,
+                    logUnchangedProjects: userConfig.version
+                        ?.logUnchangedProjects ?? true,
+                    updateDependents: userConfig.version
+                        ?.updateDependents ?? 'auto',
                 }),
         },
         changelog: {
@@ -438,8 +441,11 @@ async function createNxReleaseConfig(projectGraph, projectFileMap, userConfig =
         }
         if (releaseGroup.version?.conventionalCommits === false &&
             releaseGroupName !== exports.IMPLICIT_DEFAULT_RELEASE_GROUP) {
-            delete finalReleaseGroup.version.generatorOptions.currentVersionResolver;
-            delete finalReleaseGroup.version.generatorOptions.specifierSource;
+            if (USE_LEGACY_VERSIONING) {
+                delete finalReleaseGroup.version.generatorOptions
+                    ?.currentVersionResolver;
+                delete finalReleaseGroup.version.generatorOptions?.specifierSource;
+            }
             delete finalReleaseGroup.version
                 .currentVersionResolver;
             delete finalReleaseGroup.version
@@ -462,7 +468,9 @@ async function createNxReleaseConfig(projectGraph, projectFileMap, userConfig =
         }
         if (releaseGroup.versionPlans === false &&
             releaseGroupName !== exports.IMPLICIT_DEFAULT_RELEASE_GROUP) {
-            delete finalReleaseGroup.version.generatorOptions.specifierSource;
+            if (USE_LEGACY_VERSIONING) {
+                delete finalReleaseGroup.version.generatorOptions?.specifierSource;
+            }
             delete finalReleaseGroup.version
                 .specifierSource;
         }
@@ -796,8 +804,7 @@ function hasInvalidConventionalCommitsConfig(userConfig) {
         // v2 config - directly on version config
         (userConfig.version
             ?.currentVersionResolver ||
-            userConfig.version
-                ?.specifierSource ||
+            userConfig.version?.specifierSource ||
             // Legacy config - on generatorOptions
             userConfig.version
                 ?.generatorOptions?.currentVersionResolver ||

package/src/command-line/release/config/use-legacy-versioning.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.shouldUseLegacyVersioning = shouldUseLegacyVersioning;
+// TODO(v22): remove this function and entire concept of legacy versioning in v22
 function shouldUseLegacyVersioning(releaseConfig) {
-    return process.env.NX_INTERNAL_USE_LEGACY_VERSIONING === 'false'
-        ? false
-        : // TODO(v21): switch this to false by default in Nx v21 and remove this function in v22
-            releaseConfig?.version?.useLegacyVersioning ?? true;
+    return process.env.NX_INTERNAL_USE_LEGACY_VERSIONING === 'true'
+        ? true
+        : releaseConfig?.version?.useLegacyVersioning ?? false;
 }

package/src/command-line/release/version/release-group-processor.d.ts

@@ -1,4 +1,4 @@
-import { NxReleaseVersionV2Configuration } from '../../../config/nx-json';
+import { ManifestRootToUpdate, NxReleaseVersionConfiguration } from '../../../config/nx-json';
 import { ProjectGraph } from '../../../config/project-graph';
 import { Tree } from '../../../generators/tree';
 import { type NxReleaseConfig } from '../config/config';
@@ -10,14 +10,14 @@ import type { VersionData } from '../utils/shared';
  * and referenced throughout the versioning process.
  */
 export interface FinalConfigForProject {
-    specifierSource: NxReleaseVersionV2Configuration['specifierSource'];
-    currentVersionResolver: NxReleaseVersionV2Configuration['currentVersionResolver'];
-    currentVersionResolverMetadata: NxReleaseVersionV2Configuration['currentVersionResolverMetadata'];
-    fallbackCurrentVersionResolver: NxReleaseVersionV2Configuration['fallbackCurrentVersionResolver'];
-    versionPrefix: NxReleaseVersionV2Configuration['versionPrefix'];
-    preserveLocalDependencyProtocols: NxReleaseVersionV2Configuration['preserveLocalDependencyProtocols'];
-    versionActionsOptions: NxReleaseVersionV2Configuration['versionActionsOptions'];
-    manifestRootsToUpdate: NxReleaseVersionV2Configuration['manifestRootsToUpdate'];
+    specifierSource: NxReleaseVersionConfiguration['specifierSource'];
+    currentVersionResolver: NxReleaseVersionConfiguration['currentVersionResolver'];
+    currentVersionResolverMetadata: NxReleaseVersionConfiguration['currentVersionResolverMetadata'];
+    fallbackCurrentVersionResolver: NxReleaseVersionConfiguration['fallbackCurrentVersionResolver'];
+    versionPrefix: NxReleaseVersionConfiguration['versionPrefix'];
+    preserveLocalDependencyProtocols: NxReleaseVersionConfiguration['preserveLocalDependencyProtocols'];
+    versionActionsOptions: NxReleaseVersionConfiguration['versionActionsOptions'];
+    manifestRootsToUpdate: Array<Exclude<ManifestRootToUpdate, string>>;
 }
 export declare const BUMP_TYPE_REASON_TEXT: {
     readonly DEPENDENCY_WAS_BUMPED: ", because a dependency was bumped, ";
@@ -44,6 +44,7 @@ interface ReleaseGroupProcessorOptions {
         projects?: string[];
         groups?: string[];
     };
+    versionActionsOptionsOverrides?: Record<string, unknown>;
 }
 export declare class ReleaseGroupProcessor {
     private tree;

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

@@ -775,12 +775,26 @@ Valid values are: ${version_1.validReleaseVersionPrefixes
         /**
          * versionActionsOptions, defaults to {}
          */
-        const versionActionsOptions = projectVersionConfig?.versionActionsOptions ??
+        let versionActionsOptions = projectVersionConfig?.versionActionsOptions ??
             releaseGroupVersionConfig?.versionActionsOptions ??
             {};
-        const manifestRootsToUpdate = projectVersionConfig?.manifestRootsToUpdate ??
+        // Apply any optional overrides that may be passed in from the programmatic API
+        versionActionsOptions = {
+            ...versionActionsOptions,
+            ...(this.options.versionActionsOptionsOverrides ?? {}),
+        };
+        const manifestRootsToUpdate = (projectVersionConfig?.manifestRootsToUpdate ??
             releaseGroupVersionConfig?.manifestRootsToUpdate ??
-            [];
+            []).map((manifestRoot) => {
+            if (typeof manifestRoot === 'string') {
+                return {
+                    path: manifestRoot,
+                    // Apply the project level preserveLocalDependencyProtocols setting that was already resolved
+                    preserveLocalDependencyProtocols,
+                };
+            }
+            return manifestRoot;
+        });
         return {
             specifierSource,
             currentVersionResolver,
@@ -818,11 +832,6 @@ Valid values are: ${version_1.validReleaseVersionPrefixes
                     if (!currentDependencyVersion) {
                         continue;
                     }
-                    // If preserveLocalDependencyProtocols is true, and the dependency uses a local dependency protocol, skip updating the dependency
-                    if (cachedFinalConfigForProject.preserveLocalDependencyProtocols &&
-                        (await versionActions.isLocalDependencyProtocol(currentDependencyVersion))) {
-                        continue;
-                    }
                     let finalPrefix = '';
                     if (cachedFinalConfigForProject.versionPrefix === 'auto') {
                         const prefixMatch = currentDependencyVersion?.match(/^([~^=])/);

package/src/command-line/release/version/test-utils.d.ts

@@ -1,4 +1,4 @@
-import type { NxJsonConfiguration, NxReleaseVersionV2Configuration } from '../../../config/nx-json';
+import type { NxJsonConfiguration, NxReleaseVersionConfiguration } from '../../../config/nx-json';
 import type { ProjectGraph } from '../../../config/project-graph';
 import type { Tree } from '../../../generators/tree';
 import { NxReleaseConfig } from '../config/config';
@@ -48,7 +48,7 @@ export declare class ExampleRustVersionActions extends VersionActions {
         currentVersion: string;
         manifestPath: string;
     }>;
-    readCurrentVersionFromRegistry(tree: Tree, _currentVersionResolverMetadata: NxReleaseVersionV2Configuration['currentVersionResolverMetadata']): Promise<{
+    readCurrentVersionFromRegistry(tree: Tree, _currentVersionResolverMetadata: NxReleaseVersionConfiguration['currentVersionResolverMetadata']): Promise<{
         currentVersion: string;
         logText: string;
     }>;
@@ -57,7 +57,6 @@ export declare class ExampleRustVersionActions extends VersionActions {
         currentVersion: string;
         dependencyCollection: string;
     }>;
-    isLocalDependencyProtocol(_versionSpecifier: string): Promise<boolean>;
     updateProjectDependencies(tree: Tree, _projectGraph: ProjectGraph, dependenciesToUpdate: Record<string, string>): Promise<string[]>;
 }
 export declare class ExampleNonSemverVersionActions extends VersionActions {
@@ -68,7 +67,6 @@ export declare class ExampleNonSemverVersionActions extends VersionActions {
         currentVersion: any;
         dependencyCollection: any;
     }>;
-    isLocalDependencyProtocol(): Promise<boolean>;
     updateProjectVersion(tree: any, newVersion: any): Promise<any[]>;
     updateProjectDependencies(): Promise<any[]>;
     calculateNewVersion(currentVersion: string | null, newVersionInput: string, newVersionInputReason: string, newVersionInputReasonData: Record<string, unknown>, preid: string): Promise<{

package/src/command-line/release/version/test-utils.js

@@ -91,13 +91,15 @@ class ExampleRustVersionActions extends version_actions_1.VersionActions {
     }
     async updateProjectVersion(tree, newVersion) {
         const logMessages = [];
-        for (const manifestPath of this.manifestsToUpdate) {
-            const cargoTomlString = tree.read(manifestPath, 'utf-8').toString();
+        for (const manifestToUpdate of this.manifestsToUpdate) {
+            const cargoTomlString = tree
+                .read(manifestToUpdate.manifestPath, 'utf-8')
+                .toString();
             const cargoToml = this.parseCargoToml(cargoTomlString);
             ExampleRustVersionActions.modifyCargoTable(cargoToml, 'package', 'version', newVersion);
             const updatedCargoTomlString = ExampleRustVersionActions.stringifyCargoToml(cargoToml);
-            tree.write(manifestPath, updatedCargoTomlString);
-            logMessages.push(`✍️  New version ${newVersion} written to manifest: ${manifestPath}`);
+            tree.write(manifestToUpdate.manifestPath, updatedCargoTomlString);
+            logMessages.push(`✍️  New version ${newVersion} written to manifest: ${manifestToUpdate.manifestPath}`);
         }
         return logMessages;
     }
@@ -117,9 +119,7 @@ class ExampleRustVersionActions extends version_actions_1.VersionActions {
             dependencyCollection: 'dependencies',
         };
     }
-    async isLocalDependencyProtocol(_versionSpecifier) {
-        return false;
-    }
+    // NOTE: Does not take the preserveLocalDependencyProtocols setting into account yet
     async updateProjectDependencies(tree, _projectGraph, dependenciesToUpdate) {
         const numDependenciesToUpdate = Object.keys(dependenciesToUpdate).length;
         const depText = numDependenciesToUpdate === 1 ? 'dependency' : 'dependencies';
@@ -127,15 +127,17 @@ class ExampleRustVersionActions extends version_actions_1.VersionActions {
             return [];
         }
         const logMessages = [];
-        for (const manifestPath of this.manifestsToUpdate) {
-            const cargoTomlString = tree.read(manifestPath, 'utf-8').toString();
+        for (const manifestToUpdate of this.manifestsToUpdate) {
+            const cargoTomlString = tree
+                .read(manifestToUpdate.manifestPath, 'utf-8')
+                .toString();
             const cargoToml = this.parseCargoToml(cargoTomlString);
             for (const [dep, version] of Object.entries(dependenciesToUpdate)) {
                 ExampleRustVersionActions.modifyCargoTable(cargoToml, 'dependencies', dep, version);
             }
             const updatedCargoTomlString = ExampleRustVersionActions.stringifyCargoToml(cargoToml);
-            tree.write(manifestPath, updatedCargoTomlString);
-            logMessages.push(`✍️  Updated ${numDependenciesToUpdate} ${depText} in manifest: ${manifestPath}`);
+            tree.write(manifestToUpdate.manifestPath, updatedCargoTomlString);
+            logMessages.push(`✍️  Updated ${numDependenciesToUpdate} ${depText} in manifest: ${manifestToUpdate.manifestPath}`);
         }
         return logMessages;
     }
@@ -158,9 +160,6 @@ class ExampleNonSemverVersionActions extends version_actions_1.VersionActions {
             dependencyCollection: null,
         };
     }
-    async isLocalDependencyProtocol() {
-        return false;
-    }
     async updateProjectVersion(tree, newVersion) {
         tree.write((0, node_path_1.join)(this.projectGraphNode.data.root, 'version.txt'), newVersion);
         return [];

package/src/command-line/release/version/version-actions.d.ts

@@ -1,5 +1,5 @@
 import { ReleaseType } from 'semver';
-import { NxReleaseVersionV2Configuration } from '../../../config/nx-json';
+import { NxReleaseVersionConfiguration } from '../../../config/nx-json';
 import type { ProjectGraph, ProjectGraphDependency, ProjectGraphProjectNode } from '../../../config/project-graph';
 import type { Tree } from '../../../generators/tree';
 import { ReleaseGroupWithName } from '../config/filter-release-groups';
@@ -49,8 +49,14 @@ export declare abstract class VersionActions {
      * The interpolated manifest paths to update, if applicable based on the user's configuration, when new
      * versions and dependencies are determined. If no manifest files should be updated based on the user's
      * configuration, this will be an empty array.
+     *
+     * The final value for preserveLocalDependencyProtocols will be based on the resolved config for the current
+     * project and any overrides from the user's configuration for the manifestRootsToUpdate.
      */
-    manifestsToUpdate: string[];
+    manifestsToUpdate: {
+        manifestPath: string;
+        preserveLocalDependencyProtocols: boolean;
+    }[];
     constructor(releaseGroup: ReleaseGroupWithName, projectGraphNode: ProjectGraphProjectNode, finalConfigForProject: FinalConfigForProject);
     /**
      * Asynchronous initialization of the version actions and validation of certain configuration options.
@@ -106,7 +112,7 @@ export declare abstract class VersionActions {
      * NOTE: The version actions implementation does not need to provide the method for handling resolution
      * from git tags, this is done directly by nx release.
      */
-    abstract readCurrentVersionFromRegistry(tree: Tree, currentVersionResolverMetadata: NxReleaseVersionV2Configuration['currentVersionResolverMetadata']): Promise<{
+    abstract readCurrentVersionFromRegistry(tree: Tree, currentVersionResolverMetadata: NxReleaseVersionConfiguration['currentVersionResolverMetadata']): Promise<{
         currentVersion: string | null;
         logText: string;
     } | null>;
@@ -138,11 +144,6 @@ export declare abstract class VersionActions {
         currentVersion: string | null;
         dependencyCollection: string | null;
     }>;
-    /**
-     * Implementation details of determining if a version specifier uses a local dependency protocol that is relevant to this
-     * specific project. E.g. in a package.json context, `file:` and `workspace:` protocols should return true here.
-     */
-    abstract isLocalDependencyProtocol(versionSpecifier: string): Promise<boolean>;
     /**
      * Implementation details of updating a newly derived version in some source of truth.
      *

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

@@ -92,6 +92,9 @@ class VersionActions {
          * The interpolated manifest paths to update, if applicable based on the user's configuration, when new
          * versions and dependencies are determined. If no manifest files should be updated based on the user's
          * configuration, this will be an empty array.
+         *
+         * The final value for preserveLocalDependencyProtocols will be based on the resolved config for the current
+         * project and any overrides from the user's configuration for the manifestRootsToUpdate.
          */
         this.manifestsToUpdate = [];
     }
@@ -104,31 +107,40 @@ class VersionActions {
             this.finalConfigForProject.manifestRootsToUpdate.length === 0) {
             for (const manifestFilename of this.validManifestFilenames) {
                 if (tree.exists((0, node_path_1.join)(this.projectGraphNode.data.root, manifestFilename))) {
-                    this.finalConfigForProject.manifestRootsToUpdate.push(this.projectGraphNode.data.root);
+                    this.finalConfigForProject.manifestRootsToUpdate.push({
+                        path: this.projectGraphNode.data.root,
+                        preserveLocalDependencyProtocols: this.finalConfigForProject.preserveLocalDependencyProtocols,
+                    });
                     break;
                 }
             }
         }
         const interpolatedManifestRoots = this.finalConfigForProject.manifestRootsToUpdate.map((manifestRoot) => {
-            return (0, utils_1.interpolate)(manifestRoot, {
-                workspaceRoot: '',
-                projectRoot: this.projectGraphNode.data.root,
-                projectName: this.projectGraphNode.name,
-            });
+            return {
+                ...manifestRoot,
+                path: (0, utils_1.interpolate)(manifestRoot.path, {
+                    workspaceRoot: '',
+                    projectRoot: this.projectGraphNode.data.root,
+                    projectName: this.projectGraphNode.name,
+                }),
+            };
         });
         for (const interpolatedManifestRoot of interpolatedManifestRoots) {
             let hasValidManifest = false;
             for (const manifestFilename of this.validManifestFilenames) {
-                const manifestPath = (0, node_path_1.join)(interpolatedManifestRoot, manifestFilename);
+                const manifestPath = (0, node_path_1.join)(interpolatedManifestRoot.path, manifestFilename);
                 if (tree.exists(manifestPath)) {
-                    this.manifestsToUpdate.push(manifestPath);
+                    this.manifestsToUpdate.push({
+                        ...interpolatedManifestRoot,
+                        manifestPath,
+                    });
                     hasValidManifest = true;
                     break;
                 }
             }
             if (!hasValidManifest) {
                 const validManifestFilenames = this.validManifestFilenames?.join(' or ');
-                throw new Error(`The project "${this.projectGraphNode.name}" does not have a ${validManifestFilenames} file available in ./${interpolatedManifestRoot}.
+                throw new Error(`The project "${this.projectGraphNode.name}" does not have a ${validManifestFilenames} file available in ./${interpolatedManifestRoot.path}.
           
 To fix this you will either need to add a ${validManifestFilenames} file at that location, or configure "release" within your nx.json to exclude "${this.projectGraphNode.name}" from the current release group, or amend the "release.version.manifestRootsToUpdate" configuration to point to where the relevant manifest should be.`);
             }

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

@@ -133,6 +133,7 @@ function createAPI(overrideReleaseConfig) {
                 projects: args.projects,
                 groups: args.groups,
             },
+            versionActionsOptionsOverrides: args.versionActionsOptionsOverrides,
         });
         try {
             await processor.init();
@@ -160,8 +161,11 @@ function createAPI(overrideReleaseConfig) {
             : [];
         (0, shared_1.handleDuplicateGitTags)(gitTagValues);
         printAndFlushChanges(tree, !!args.dryRun);
-        const { changedFiles: changed, deletedFiles: deleted } = await processor.afterAllProjectsVersioned(nxReleaseConfig.version
-            .versionActionsOptions);
+        const { changedFiles: changed, deletedFiles: deleted } = await processor.afterAllProjectsVersioned({
+            ...nxReleaseConfig.version
+                .versionActionsOptions,
+            ...(args.versionActionsOptionsOverrides ?? {}),
+        });
         changed.forEach((f) => additionalChangedFiles.add(f));
         deleted.forEach((f) => additionalDeletedFiles.add(f));
         // Only applicable when there is a single release group with a fixed relationship