nx 20.8.4 → 22.7.7

package/schemas/nx-schema.json

@@ -77,6 +77,35 @@
         "$ref": "#/definitions/plugins"
       }
     },
+    "tui": {
+      "type": "object",
+      "description": "Settings for the Nx Terminal User Interface (TUI)",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether to enable the Terminal UI whenever possible (based on the current environment and terminal).",
+          "default": true
+        },
+        "autoExit": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "Whether to exit the TUI automatically after all tasks finish. If set to `true`, the TUI will exit immediately. If set to `false` the TUI will not automatically exit. If set to a number, an interruptible countdown popup will be shown for that many seconds before the TUI exits.",
+          "default": 3
+        },
+        "suppressHints": {
+          "type": "boolean",
+          "description": "Whether to suppress hint popups that provide guidance for unhandled keys.",
+          "default": false
+        }
+      },
+      "additionalProperties": false
+    },
     "defaultProject": {
       "type": "string",
       "description": "Default project. When project isn't provided, the default project will be used."
@@ -95,7 +124,7 @@
     },
     "neverConnectToCloud": {
       "type": "boolean",
-      "description": "Set this to true to disable all connections to Nx Cloud."
+      "description": "Setting this to true will cause all attempts to connect your workspace to Nx Cloud to fail. This value does not prevent using Nx Cloud if already connected. Use NX_NO_CLOUD=true env var to prevent using Nx Cloud when running commands."
     },
     "parallel": {
       "type": "number",
@@ -113,6 +142,10 @@
       "type": "boolean",
       "description": "Specifies whether to add inference plugins when generating new projects."
     },
+    "analytics": {
+      "type": "boolean",
+      "description": "Set this to true to allow Nx to collect usage analytics."
+    },
     "release": {
       "type": "object",
       "description": "Configuration for the nx release commands.",
@@ -172,9 +205,46 @@
                   }
                 ]
               },
+              "releaseTag": {
+                "type": "object",
+                "description": "Configuration for release tag generation and matching.",
+                "properties": {
+                  "pattern": {
+                    "type": "string",
+                    "description": "Optionally override the git/release tag pattern to use for this group."
+                  },
+                  "checkAllBranchesWhen": {
+                    "oneOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ],
+                    "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+                  },
+                  "requireSemver": {
+                    "type": "boolean",
+                    "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
+                  },
+                  "preferDockerVersion": {
+                    "type": ["boolean", "string"],
+                    "enum": [true, false, "both"],
+                    "description": "Controls how docker versions are used relative to semver versions when creating git tags and changelog entries. Set to true to use only the docker version, false to use only the semver version, or 'both' to create tags and changelog entries for both docker and semver versions. By default, this is set to true when docker configuration is present, and false otherwise."
+                  },
+                  "strictPreid": {
+                    "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
+                  }
+                },
+                "additionalProperties": false
+              },
               "releaseTagPattern": {
                 "type": "string",
-                "description": "Optionally override the git/release tag pattern to use for this group."
+                "description": "DEPRECATED: Use releaseTag.pattern instead. Will be removed in Nx 23."
               },
               "releaseTagPatternCheckAllBranchesWhen": {
                 "oneOf": [
@@ -188,7 +258,20 @@
                     }
                   }
                 ],
-                "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+                "description": "DEPRECATED: Use releaseTag.checkAllBranchesWhen instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternRequireSemver": {
+                "type": "boolean",
+                "description": "DEPRECATED: Use releaseTag.requireSemver instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternPreferDockerVersion": {
+                "type": ["boolean", "string"],
+                "enum": [true, false, "both"],
+                "description": "DEPRECATED: Use releaseTag.preferDockerVersion instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternStrictPreid": {
+                "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration",
+                "description": "DEPRECATED: Use releaseTag.strictPreid instead. Will be removed in Nx 23."
               },
               "versionPlans": {
                 "oneOf": [
@@ -200,6 +283,18 @@
                     "description": "Enables using version plans as a specifier source for versioning and to determine changes for changelog generation."
                   }
                 ]
+              },
+              "docker": {
+                "oneOf": [
+                  {
+                    "type": "boolean",
+                    "enum": [true],
+                    "description": "Enable docker configuration with default settings. Warning: Docker support is experimental. Breaking changes may occur and not adhere to semver versioning. "
+                  },
+                  {
+                    "$ref": "#/definitions/NxReleaseGroupDockerConfiguration"
+                  }
+                ]
               }
             },
             "required": ["projects"]
@@ -261,9 +356,46 @@
             }
           ]
         },
+        "releaseTag": {
+          "type": "object",
+          "description": "Configuration for release tag generation and matching.",
+          "properties": {
+            "pattern": {
+              "type": "string",
+              "description": "Optionally override the git/release tag pattern to use. This field is the source of truth for changelog generation and release tagging, as well as for conventional commits parsing. It supports interpolating the version as {version} and (if releasing independently or forcing project level version control system releases) the project name as {projectName} within the string. The default releaseTagPattern for fixed/unified releases is: \"v{version}\". The default releaseTagPattern for independent releases at the project level is: \"{projectName}@{version}\""
+            },
+            "checkAllBranchesWhen": {
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+            },
+            "requireSemver": {
+              "type": "boolean",
+              "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
+            },
+            "preferDockerVersion": {
+              "type": ["boolean", "string"],
+              "enum": [true, false, "both"],
+              "description": "Controls how docker versions are used relative to semver versions when creating git tags and changelog entries. Set to true to use only the docker version, false to use only the semver version, or 'both' to create tags and changelog entries for both docker and semver versions. By default, this is set to true when docker configuration is present, and false otherwise."
+            },
+            "strictPreid": {
+              "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
+            }
+          },
+          "additionalProperties": false
+        },
         "releaseTagPattern": {
           "type": "string",
-          "description": "Optionally override the git/release tag pattern to use. This field is the source of truth for changelog generation and release tagging, as well as for conventional commits parsing. It supports interpolating the version as {version} and (if releasing independently or forcing project level version control system releases) the project name as {projectName} within the string. The default releaseTagPattern for fixed/unified releases is: \"v{version}\". The default releaseTagPattern for independent releases at the project level is: \"{projectName}@{version}\""
+          "description": "DEPRECATED: Use releaseTag.pattern instead. Will be removed in Nx 23."
         },
         "releaseTagPatternCheckAllBranchesWhen": {
           "oneOf": [
@@ -277,7 +409,32 @@
               }
             }
           ],
-          "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+          "description": "DEPRECATED: Use releaseTag.checkAllBranchesWhen instead. Will be removed in Nx 23."
+        },
+        "releaseTagPatternRequireSemver": {
+          "type": "boolean",
+          "description": "DEPRECATED: Use releaseTag.requireSemver instead. Will be removed in Nx 23."
+        },
+        "releaseTagPatternPreferDockerVersion": {
+          "type": ["boolean", "string"],
+          "enum": [true, false, "both"],
+          "description": "DEPRECATED: Use releaseTag.preferDockerVersion instead. Will be removed in Nx 23."
+        },
+        "releaseTagPatternStrictPreid": {
+          "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration",
+          "description": "DEPRECATED: Use releaseTag.strictPreid instead. Will be removed in Nx 23."
+        },
+        "docker": {
+          "oneOf": [
+            {
+              "type": "boolean",
+              "enum": [true],
+              "description": "Enable docker configuration with default settings. Warning: Docker support is experimental. Breaking changes may occur and not adhere to semver versioning."
+            },
+            {
+              "$ref": "#/definitions/NxReleaseDockerConfiguration"
+            }
+          ]
         }
       }
     },
@@ -312,9 +469,190 @@
         }
       },
       "additionalProperties": false
+    },
+    "conformance": {
+      "type": "object",
+      "description": "Configuration for Nx Conformance",
+      "properties": {
+        "outputPath": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Path to write the conformance results to"
+            },
+            {
+              "type": "boolean",
+              "enum": [false],
+              "description": "Disable writing the conformance results to a file"
+            }
+          ],
+          "description": "Optional path to write the conformance results to, defaults to 'dist/conformance-result.json'. Set to false to disable writing the conformance results to a file."
+        },
+        "rules": {
+          "type": "array",
+          "description": "List of conformance rules to apply",
+          "items": {
+            "type": "object",
+            "properties": {
+              "rule": {
+                "type": "string",
+                "description": "Relative path to a local rule implementation, node_module path or nx-cloud rule ID for Nx Cloud Enterprise."
+              },
+              "options": {
+                "type": "object",
+                "description": "Rule specific configuration options.",
+                "additionalProperties": true
+              },
+              "projects": {
+                "type": "array",
+                "description": "The projects to apply this rule to. This property accepts an array of strings which can be project names, glob patterns, directories, tag references or anything else that is supported by the `--projects` filter. By default, the implied value is ['*'] (all projects). You can also use objects with 'matcher' and 'explanation' properties to document why specific projects are included or excluded.",
+                "items": {
+                  "oneOf": [
+                    {
+                      "type": "string",
+                      "description": "A project name, glob pattern, directory, tag reference, or any other valid project filter"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "matcher": {
+                          "type": "string",
+                          "description": "A project name, glob pattern, directory, tag reference, or any other valid project filter"
+                        },
+                        "explanation": {
+                          "type": "string",
+                          "description": "An explanation to communicate to colleagues why this particular project or projects were included or excluded from the rule"
+                        }
+                      },
+                      "required": ["matcher", "explanation"],
+                      "additionalProperties": false
+                    }
+                  ]
+                }
+              },
+              "explanation": {
+                "type": "string",
+                "description": "Optional explanation field for users to be able to communicate to their colleagues why a particular rule is enabled and important to the workspace in question."
+              },
+              "status": {
+                "type": "string",
+                "enum": ["enforced", "evaluated", "disabled"],
+                "description": "Override the default status of the rule, which is 'enforced'. If set to 'evaluated', the rule will be reported as normal, but not enforced (will exit with code 0). If set to 'disabled', the rule will not be evaluated at all.",
+                "default": "enforced"
+              }
+            },
+            "required": ["rule"],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": ["rules"],
+      "additionalProperties": false
+    },
+    "owners": {
+      "description": "Configuration for Nx Owners (CODEOWNERS generation). Set to true to enable with all defaults.",
+      "oneOf": [
+        {
+          "type": "boolean",
+          "enum": [true],
+          "description": "Enable owners with all default settings."
+        },
+        {
+          "type": "object",
+          "properties": {
+            "format": {
+              "type": "string",
+              "description": "The format to use for the generated owners file. Defaults to 'github'.",
+              "enum": ["github", "gitlab", "bitbucket"],
+              "default": "github"
+            },
+            "outputPath": {
+              "type": "string",
+              "description": "The path to write the generated owners file to. Defaults based on format (e.g. '.github/CODEOWNERS')."
+            },
+            "patterns": {
+              "type": "array",
+              "description": "List of ownership patterns to apply.",
+              "items": {
+                "$ref": "#/definitions/ownersPattern"
+              }
+            },
+            "sections": {
+              "type": "array",
+              "description": "List of ownership sections (GitLab only). Sections allow grouping patterns with approval requirements.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "The section label."
+                  },
+                  "defaultOwners": {
+                    "type": "array",
+                    "description": "Default owners for all patterns in this section.",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "numberOfRequiredApprovals": {
+                    "type": "number",
+                    "description": "Number of required approvals for this section. Mutually exclusive with 'optional'."
+                  },
+                  "optional": {
+                    "type": "boolean",
+                    "description": "Whether this section is optional. Mutually exclusive with 'numberOfRequiredApprovals'."
+                  },
+                  "patterns": {
+                    "type": "array",
+                    "description": "List of ownership patterns within this section.",
+                    "items": {
+                      "$ref": "#/definitions/ownersPattern"
+                    }
+                  }
+                },
+                "required": ["name"],
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
     }
   },
   "definitions": {
+    "ownersPattern": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "A human-readable description of this ownership pattern."
+        },
+        "projects": {
+          "type": "array",
+          "description": "The projects this pattern applies to. Accepts project names, glob patterns, tag references, or any other valid project filter supported by the --projects flag.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "files": {
+          "type": "array",
+          "description": "File glob patterns this ownership pattern applies to (for non-project-based ownership).",
+          "items": {
+            "type": "string"
+          }
+        },
+        "owners": {
+          "type": "array",
+          "description": "List of owners (e.g. GitHub usernames or team handles) for the matched projects or files.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": ["owners"],
+      "additionalProperties": false
+    },
     "inputs": {
       "type": "array",
       "items": {
@@ -328,8 +666,13 @@
               "fileset": {
                 "type": "string",
                 "description": "A glob"
+              },
+              "dependencies": {
+                "type": "boolean",
+                "description": "Include files matching the fileset for all the project dependencies of this target."
               }
             },
+            "required": ["fileset"],
             "additionalProperties": false
           },
           {
@@ -429,6 +772,31 @@
             },
             "required": ["dependentTasksOutputFiles"],
             "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "json": {
+                "type": "string",
+                "description": "Path to a JSON file. Must start with {workspaceRoot} or {projectRoot}. Supports globs."
+              },
+              "fields": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Allowlist of fields to include in the hash. Supports dot notation for nested paths (e.g. 'compilerOptions.target')."
+              },
+              "excludeFields": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Denylist of fields to exclude from the hash. Supports dot notation for nested paths."
+              }
+            },
+            "required": ["json"],
+            "additionalProperties": false
           }
         ]
       }
@@ -526,6 +894,11 @@
             "type": "object"
           }
         },
+        "continuous": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this target runs continuously until stopped"
+        },
         "parallelism": {
           "type": "boolean",
           "default": true,
@@ -679,155 +1052,273 @@
         "tagArgs": {
           "type": ["string", "array"],
           "description": "Additional arguments to pass to the `git tag` command invoked behind the scenes"
+        },
+        "push": {
+          "type": "boolean",
+          "description": "Whether or not to automatically push the changes made by this command. This defaults to false"
+        },
+        "pushArgs": {
+          "type": ["string", "array"],
+          "description": "Additional arguments to pass to the `git push` command invoked behind the scenes"
         }
       }
     },
     "NxReleaseVersionConfiguration": {
       "type": "object",
-      "$comment": "The configuration for versioning is dynamic depending on the value of the useLegacyVersioning property. Through trial and error the best in editor DX seems to come from having the if/else at the top level and explicitly include all possible properties and apply additionalProperties false in each case.",
       "description": "Configuration for the versioning phase of releases.",
-      "if": {
-        "$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
-          }
-        }
-      },
-      "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,
+      "properties": {
+        "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
         },
-        "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
-          },
-          "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'."
-          },
-          "specifierSource": {
-            "type": "string",
-            "enum": ["prompt", "conventional-commits", "version-plans"],
-            "default": "prompt",
-            "description": "The source to use for determining the specifier to use when versioning. 'prompt' is the default and will interactively prompt the user for an explicit/imperative specifier. 'conventional-commits' will attempt determine a specifier from commit messages conforming to the Conventional Commits specification. 'version-plans' will determine the specifier from the version plan files available on disk."
-          },
-          "manifestRootsToUpdate": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "A list of directories containing manifest files (such as package.json) to apply updates to when versioning. By default, only the project root will be used, but you could customize this to only version a manifest in a dist directory, or even version multiple manifests in different directories, such as both source and dist."
-          },
-          "currentVersionResolver": {
-            "type": "string",
-            "enum": ["registry", "disk", "git-tag", "none"],
-            "description": "The resolver to use for determining the current version of a project during versioning. This is needed for versioning approaches which involve relatively modifying a current version to arrive at a new version, such as semver bumps like 'patch', 'minor' etc. Using 'none' explicitly declares that the current version is not needed to compute the new version, and should only be used with appropriate version actions implementations that support it."
-          },
-          "currentVersionResolverMetadata": {
-            "type": "object",
-            "additionalProperties": true,
-            "description": "Metadata to provide to the configured currentVersionResolver to help it in determining the current version. What to pass here is specific to each resolver."
-          },
-          "fallbackCurrentVersionResolver": {
-            "type": "string",
-            "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", "", "~", "^", "="],
-            "default": "auto",
-            "description": "The prefix to use when versioning dependencies. This can be one of the following: auto, '', '~', '^', '=', where auto means the existing prefix will be preserved."
-          },
-          "deleteVersionPlans": {
-            "type": "boolean",
-            "description": "Whether to delete the processed version plans file after versioning is complete. This is false by default because the version plans are also needed for changelog generation.",
-            "default": false
-          },
-          "updateDependents": {
-            "type": "string",
-            "enum": ["never", "auto"],
-            "default": "auto",
-            "description": "When versioning independent projects, this controls whether to update their dependents (i.e. the things that depend on them). 'never' means no dependents will be updated (unless they happen to be versioned directly as well). 'auto' is the default and will cause dependents to be updated (a patch version bump) when a dependency is versioned."
-          },
-          "logUnchangedProjects": {
-            "type": "boolean",
-            "description": "Whether to log projects that have not changed during versioning.",
-            "default": true
-          },
-          "preserveLocalDependencyProtocols": {
-            "type": "boolean",
-            "description": "Whether to preserve local dependency protocols (e.g. file references, or the `workspace:` protocol in package.json files) of local dependencies when updating them during versioning. This was false by default in legacy versioning, but is true by default now.",
-            "default": true
+        "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'."
+        },
+        "specifierSource": {
+          "type": "string",
+          "enum": ["prompt", "conventional-commits", "version-plans"],
+          "default": "prompt",
+          "description": "The source to use for determining the specifier to use when versioning. 'prompt' is the default and will interactively prompt the user for an explicit/imperative specifier. 'conventional-commits' will attempt determine a specifier from commit messages conforming to the Conventional Commits specification. 'version-plans' will determine the specifier from the version plan files available on disk."
+        },
+        "manifestRootsToUpdate": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Path to the directory containing a manifest file to update. Supports placeholders like {projectRoot} and {projectName}."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Path to the directory containing a manifest file to update. Supports placeholders like {projectRoot} and {projectName}."
+                  },
+                  "preserveLocalDependencyProtocols": {
+                    "type": "boolean",
+                    "description": "Whether to preserve local dependency references using protocols like 'workspace:' or 'file:'. Set this to false for dist files that need to be published if not using a package manager that swaps references at publish time like pnpm or bun.",
+                    "default": true
+                  }
+                },
+                "required": ["path"],
+                "additionalProperties": false
+              }
+            ]
           },
-          "versionActions": {
+          "description": "A list of directories containing manifest files (such as package.json) to apply updates to when versioning. By default, only the project root will be used, but you could customize this to only version a manifest in a dist directory, or even version multiple manifests in different directories, such as both source and dist."
+        },
+        "currentVersionResolver": {
+          "type": "string",
+          "enum": ["registry", "disk", "git-tag", "none"],
+          "description": "The resolver to use for determining the current version of a project during versioning. This is needed for versioning approaches which involve relatively modifying a current version to arrive at a new version, such as semver bumps like 'patch', 'minor' etc. Using 'none' explicitly declares that the current version is not needed to compute the new version, and should only be used with appropriate version actions implementations that support it."
+        },
+        "currentVersionResolverMetadata": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Metadata to provide to the configured currentVersionResolver to help it in determining the current version. What to pass here is specific to each resolver."
+        },
+        "fallbackCurrentVersionResolver": {
+          "type": "string",
+          "enum": ["disk"],
+          "description": "The fallback version resolver to use when the configured currentVersionResolver fails to resolve the current version."
+        },
+        "versionPrefix": {
+          "type": "string",
+          "enum": ["auto", "", "~", "^", "="],
+          "default": "auto",
+          "description": "The prefix to use when versioning dependencies. This can be one of the following: auto, '', '~', '^', '=', where auto means the existing prefix will be preserved."
+        },
+        "deleteVersionPlans": {
+          "type": "boolean",
+          "description": "Whether to delete the processed version plans file after versioning is complete. This is false by default because the version plans are also needed for changelog generation.",
+          "default": false
+        },
+        "updateDependents": {
+          "type": "string",
+          "enum": ["never", "auto", "always"],
+          "default": "auto",
+          "description": "When versioning independent projects, this controls whether to update their dependents (i.e. the things that depend on them). 'never' means no dependents will be updated (unless they happen to be versioned directly as well). 'auto' is the default and will cause dependents to be updated (a patch version bump) when a dependency is versioned, as long as a group or projects filter is not applied that does not include them. 'always' will cause dependents to be updated (a patch version bump) when a dependency is versioned, even if they are not included in the group or projects filter."
+        },
+        "logUnchangedProjects": {
+          "type": "boolean",
+          "description": "Whether to log projects that have not changed during versioning.",
+          "default": true
+        },
+        "preserveLocalDependencyProtocols": {
+          "type": "boolean",
+          "description": "Whether to preserve local dependency protocols (e.g. file references, or the `workspace:` protocol in package.json files) of local dependencies when updating them during versioning.",
+          "default": true
+        },
+        "preserveMatchingDependencyRanges": {
+          "type": ["boolean", "array"],
+          "description": "Whether to preserve matching dependency ranges when updating them during versioning. This is true by default. (e.g. The new version will be '1.2.0' and the current version range in dependents is already '^1.0.0'. Therefore, the manifest file is not updated.)",
+          "default": true,
+          "items": {
             "type": "string",
-            "description": "The path to the version actions implementation to use for releasing all projects by default. This can also be overridden on the release group and project levels.",
-            "default": "@nx/js/src/release"
-          },
-          "versionActionsOptions": {
-            "type": "object",
-            "description": "The specific options that are defined by each version actions implementation. They will be passed to the version actions implementation when running a release.",
-            "additionalProperties": true
+            "enum": [
+              "dependencies",
+              "devDependencies",
+              "peerDependencies",
+              "optionalDependencies"
+            ]
           }
+        },
+        "adjustSemverBumpsForZeroMajorVersion": {
+          "type": "boolean",
+          "description": "Whether to strictly follow SemVer V2 spec for 0.x versions where breaking changes bump the minor version (instead of major), and new features bump the patch version (instead of minor). When enabled: 'major' bumps become 'minor' bumps for 0.x versions, 'minor' bumps become 'patch' bumps for 0.x versions. Versions 1.0.0 and above are unaffected. This is false by default for backward compatibility.",
+          "default": false
+        },
+        "applyPreidToDependents": {
+          "type": "boolean",
+          "description": "Whether to apply the --preid value to the implicit patch bumps given to dependents (and other projects in a fixed release group) when a dependency is versioned. When true, those dependents become prepatch bumps using the same preid (e.g. 1.0.1-rc.0 instead of 1.0.1). This is false by default for backward compatibility.",
+          "default": false
+        },
+        "versionActions": {
+          "type": "string",
+          "description": "The path to the version actions implementation to use for releasing all projects by default. This can also be overridden on the release group and project levels.",
+          "default": "@nx/js/src/release"
+        },
+        "versionActionsOptions": {
+          "type": "object",
+          "description": "The specific options that are defined by each version actions implementation. They will be passed to the version actions implementation when running a release.",
+          "additionalProperties": true
         }
       }
     },
     "NxReleaseGroupVersionConfiguration": {
       "type": "object",
-      "$comment": "We need to improve this configuration definition to be more precise once legacy versioning is removed. Right now it needs to be left open and runtime validation will ensure correct behavior.",
       "properties": {
         "groupPreVersionCommand": {
           "type": "string",
           "description": "A command to run after validation of nx release configuration AND after the release.version.preVersionCommand (if any), but before versioning begins for this specific group. Useful for preparing build artifacts for the group. If --dry-run is passed, the command is still executed, but with the NX_DRY_RUN environment variable set to '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"
+        },
+        "specifierSource": {
+          "type": "string",
+          "enum": ["prompt", "conventional-commits", "version-plans"],
+          "default": "prompt",
+          "description": "The source to use for determining the specifier to use when versioning. 'prompt' is the default and will interactively prompt the user for an explicit/imperative specifier. 'conventional-commits' will attempt determine a specifier from commit messages conforming to the Conventional Commits specification. 'version-plans' will determine the specifier from the version plan files available on disk."
+        },
+        "manifestRootsToUpdate": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "Path to the directory containing a manifest file to update. Supports placeholders like {projectRoot} and {projectName}."
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "path": {
+                    "type": "string",
+                    "description": "Path to the directory containing a manifest file to update. Supports placeholders like {projectRoot} and {projectName}."
+                  },
+                  "preserveLocalDependencyProtocols": {
+                    "type": "boolean",
+                    "description": "Whether to preserve local dependency references using protocols like 'workspace:' or 'file:'. Set this to false for dist files that need to be published if not using a package manager that swaps references at publish time like pnpm or bun.",
+                    "default": true
+                  }
+                },
+                "required": ["path"],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "description": "A list of directories containing manifest files (such as package.json) to apply updates to when versioning. By default, only the project root will be used, but you could customize this to only version a manifest in a dist directory, or even version multiple manifests in different directories, such as both source and dist."
+        },
+        "currentVersionResolver": {
+          "type": "string",
+          "enum": ["registry", "disk", "git-tag", "none"],
+          "description": "The resolver to use for determining the current version of a project during versioning. This is needed for versioning approaches which involve relatively modifying a current version to arrive at a new version, such as semver bumps like 'patch', 'minor' etc. Using 'none' explicitly declares that the current version is not needed to compute the new version, and should only be used with appropriate version actions implementations that support it."
+        },
+        "currentVersionResolverMetadata": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Metadata to provide to the configured currentVersionResolver to help it in determining the current version. What to pass here is specific to each resolver."
+        },
+        "fallbackCurrentVersionResolver": {
+          "type": "string",
+          "enum": ["disk"],
+          "description": "The fallback version resolver to use when the configured currentVersionResolver fails to resolve the current version."
+        },
+        "versionPrefix": {
+          "type": "string",
+          "enum": ["auto", "", "~", "^", "="],
+          "default": "auto",
+          "description": "The prefix to use when versioning dependencies. This can be one of the following: auto, '', '~', '^', '=', where auto means the existing prefix will be preserved."
+        },
+        "deleteVersionPlans": {
+          "type": "boolean",
+          "description": "Whether to delete the processed version plans file after versioning is complete. This is false by default because the version plans are also needed for changelog generation.",
+          "default": false
+        },
+        "updateDependents": {
+          "type": "string",
+          "enum": ["never", "auto"],
+          "default": "auto",
+          "description": "When versioning independent projects, this controls whether to update their dependents (i.e. the things that depend on them). 'never' means no dependents will be updated (unless they happen to be versioned directly as well). 'auto' is the default and will cause dependents to be updated (a patch version bump) when a dependency is versioned."
+        },
+        "logUnchangedProjects": {
+          "type": "boolean",
+          "description": "Whether to log projects that have not changed during versioning.",
+          "default": true
+        },
+        "preserveLocalDependencyProtocols": {
+          "type": "boolean",
+          "description": "Whether to preserve local dependency protocols (e.g. file references, or the `workspace:` protocol in package.json files) of local dependencies when updating them during versioning.",
+          "default": true
+        },
+        "preserveMatchingDependencyRanges": {
+          "type": ["boolean", "array"],
+          "description": "Whether to preserve matching dependency ranges when updating them during versioning. This is false by default. (e.g. The new version will be '1.2.0' and the current version range in dependents is already '^1.0.0'. Therefore, the manifest file is not updated.)",
+          "default": false,
+          "items": {
+            "type": "string",
+            "enum": [
+              "dependencies",
+              "devDependencies",
+              "peerDependencies",
+              "optionalDependencies"
+            ]
+          }
+        },
+        "adjustSemverBumpsForZeroMajorVersion": {
+          "type": "boolean",
+          "description": "Whether to apply the common convention for 0.x versions where breaking changes bump the minor version (instead of major), and new features bump the patch version (instead of minor). When enabled: 'major' bumps become 'minor' bumps for 0.x versions, 'minor' bumps become 'patch' bumps for 0.x versions. Versions 1.0.0 and above are unaffected. This is false by default for backward compatibility.",
+          "default": false
+        },
+        "applyPreidToDependents": {
+          "type": "boolean",
+          "description": "Whether to apply the --preid value to the implicit patch bumps given to dependents (and other projects in a fixed release group) when a dependency is versioned. When true, those dependents become prepatch bumps using the same preid (e.g. 1.0.1-rc.0 instead of 1.0.1). This is false by default for backward compatibility.",
+          "default": false
+        },
+        "versionActions": {
+          "type": "string",
+          "description": "The path to the version actions implementation to use for releasing all projects by default. This can also be overridden on the release group and project levels.",
+          "default": "@nx/js/src/release"
+        },
+        "versionActionsOptions": {
+          "type": "object",
+          "description": "The specific options that are defined by each version actions implementation. They will be passed to the version actions implementation when running a release.",
+          "additionalProperties": true
         }
       },
-      "additionalProperties": true
+      "additionalProperties": false
     },
     "NxReleaseChangelogConfiguration": {
       "type": "object",
@@ -836,7 +1327,7 @@
           "oneOf": [
             {
               "type": "string",
-              "enum": ["github"]
+              "enum": ["github", "gitlab"]
             },
             {
               "type": "boolean",
@@ -882,7 +1373,7 @@
       "properties": {
         "provider": {
           "type": "string",
-          "enum": ["github-enterprise-server"]
+          "enum": ["github-enterprise-server", "gitlab"]
         },
         "hostname": {
           "type": "string",
@@ -890,7 +1381,7 @@
         },
         "apiBaseUrl": {
           "type": "string",
-          "description": "The base URL for the relevant VCS provider API. If not set, this will default to `https://${hostname}/api/v3`"
+          "description": "The base URL for the relevant VCS provider API. If not set, this will default to `https://${hostname}/api/v3` (github) or `https://${hostname}/api/v4` (gitlab)."
         }
       },
       "required": ["provider", "hostname"]
@@ -907,6 +1398,10 @@
         }
       }
     },
+    "NxReleaseReleaseTagPatternStrictPreidConfiguration": {
+      "type": "boolean",
+      "description": "When set to true and multiple tags match your configured \"releaseTagPattern\", the git tag matching logic will strictly prefer the tag which contain a semver preid which matches the one given to the nx release invocation.\n\nFor example, let's say your \"releaseTagPattern\" is \"{projectName}@{version}\" and you have the following tags for project \"my-lib\", which uses semver:\n- my-lib@1.2.4-beta.1\n- my-lib@1.2.4-alpha.1\n- my-lib@1.2.3\n\nIf \"releaseTagPatternStrictPreid\" is set to true and you run:\n- `nx release --preid beta`, the git tag \"my-lib@1.2.4-beta.1\" will be resolved.\n- `nx release --preid alpha`, the git tag \"my-lib@1.2.4-alpha.1\" will be resolved.\n- `nx release` (no preid), the git tag \"my-lib@1.2.3\" will be resolved.\n\nIf \"releaseTagPatternStrictPreid\" is set to false, the git tag \"my-lib@1.2.4-beta.1\" will always be resolved as the latest tag that matches the pattern, regardless of any preid which gets passed to nx release.\n\nNOTE: This feature was added in a minor version and is therefore set to false by default, but this may change in a future major version."
+    },
     "ChangelogRenderOptions": {
       "type": "object",
       "additionalProperties": true
@@ -914,6 +1409,10 @@
     "NxReleaseConventionalCommitsConfiguration": {
       "type": "object",
       "properties": {
+        "useCommitScope": {
+          "type": "boolean",
+          "description": "Whether or not to rely on commit scope to resolve version specifier.\nIf set to 'true', then only commits with scope matching projectName and commits without scope affects version determined, rest are assumed as patch change.\nIf set to 'false', then all commits that affected project used to determine semver change.\nIf not set, this will default to 'true'"
+        },
         "types": {
           "type": "object",
           "description": "A map of commit types to their configuration. If a type is set to 'true', then it will be enabled with the default 'semverBump' of 'patch' and will appear in the changelog. If a type is set to 'false', then it will not trigger a version bump and will be hidden from the changelog.",
@@ -959,6 +1458,89 @@
           }
         }
       }
+    },
+    "NxReleaseDockerConfiguration": {
+      "type": "object",
+      "description": "Configuration for handling Docker projects during nx release.",
+      "properties": {
+        "preVersionCommand": {
+          "type": "string",
+          "description": "A command to run after validation of nx release configuration, but before docker versioning begins. Useful for preparing docker build artifacts. If --dry-run is passed, the command is still executed, but with the NX_DRY_RUN environment variable set to 'true'."
+        },
+        "skipVersionActions": {
+          "oneOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of projects which should use a no-op VersionActions implementation rather than any potentially inferred by default or via Inference Plugins."
+            },
+            {
+              "type": "boolean",
+              "description": "When set to true, all projects in the release setup/release group will use a no-op VersionActions implementation."
+            }
+          ],
+          "description": "Projects which should use a no-op VersionActions implementation rather than any potentially inferred by default or via Inference Plugins. Can be an array of project names (subset of projects in the release setup/release group) or a boolean (true means all projects)."
+        },
+        "versionSchemes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Record of named version patterns to choose between when versioning docker projects. e.g. \"production\": \"{currentDate|YYMM.DD}.{shortCommitSha}\", \"hotfix\": \"{currentDate|YYMM.DD}-hotfix\""
+        },
+        "repositoryName": {
+          "type": "string",
+          "description": "Repository name for the image on the configured registry"
+        },
+        "registryUrl": {
+          "type": "string",
+          "description": "Url of the Docker Image/Container Registry to push images to. Defaults to Docker Hub."
+        }
+      },
+      "additionalProperties": false
+    },
+    "NxReleaseGroupDockerConfiguration": {
+      "type": "object",
+      "properties": {
+        "groupPreVersionCommand": {
+          "type": "string",
+          "description": "A command to run after validation of nx release configuration, but before docker versioning begins. Used for preparing docker build artifacts. If --dry-run is passed, the command is still executed, but with the NX_DRY_RUN environment variable set to 'true'. It will run in addition to the global `preVersionCommand`"
+        },
+        "skipVersionActions": {
+          "oneOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Array of projects which should use a no-op VersionActions implementation rather than any potentially inferred by default or via Inference Plugins."
+            },
+            {
+              "type": "boolean",
+              "description": "When set to true, all projects in the release setup/release group will use a no-op VersionActions implementation."
+            }
+          ],
+          "description": "Projects which should use a no-op VersionActions implementation rather than any potentially inferred by default or via Inference Plugins. Can be an array of project names (subset of projects in the release setup/release group) or a boolean (true means all projects)."
+        },
+        "versionSchemes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Record of named version patterns to choose between when versioning docker projects. e.g. \"production\": \"{currentDate|YYMM.DD}.{shortCommitSha}\", \"hotfix\": \"{currentDate|YYMM.DD}-hotfix\""
+        },
+        "repositoryName": {
+          "type": "string",
+          "description": "Repository name for the image on the configured registry"
+        },
+        "registryUrl": {
+          "type": "string",
+          "description": "Url of the Docker Image/Container Registry to push images to. Defaults to Docker Hub."
+        }
+      },
+      "additionalProperties": false
     }
   }
 }