nx 19.2.0-canary.20240604-0594deb → 19.2.0-rc.0

package/migrations.json

@@ -71,6 +71,12 @@
       "version": "18.1.0-beta.3",
       "description": "Moves affected.defaultBase to defaultBase in `nx.json`",
       "implementation": "./src/migrations/update-17-2-0/move-default-base"
+    },
+    "19-2-0-move-graph-cache-directory": {
+      "cli": "nx",
+      "version": "19.2.0-beta.2",
+      "description": "Updates the default workspace data directory to .nx/workspace-data",
+      "implementation": "./src/migrations/update-19-2-0/move-workspace-data-directory"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "19.2.0-canary.20240604-0594deb",
+  "version": "19.2.0-rc.0",
   "private": false,
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
@@ -50,6 +50,7 @@
     "enquirer": "~2.3.6",
     "figures": "3.2.0",
     "flat": "^5.0.2",
+    "front-matter": "^4.0.2",
     "fs-extra": "^11.1.0",
     "ignore": "^5.0.4",
     "jest-diff": "^29.4.1",
@@ -69,7 +70,7 @@
     "yargs-parser": "21.1.1",
     "node-machine-id": "1.1.12",
     "ora": "5.3.0",
-    "@nrwl/tao": "19.2.0-canary.20240604-0594deb"
+    "@nrwl/tao": "19.2.0-rc.0"
   },
   "peerDependencies": {
     "@swc-node/register": "^1.8.0",
@@ -84,16 +85,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-x64": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-darwin-arm64": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-linux-x64-gnu": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-linux-x64-musl": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-win32-x64-msvc": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-linux-arm64-gnu": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-linux-arm64-musl": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-linux-arm-gnueabihf": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-win32-arm64-msvc": "19.2.0-canary.20240604-0594deb",
-    "@nx/nx-freebsd-x64": "19.2.0-canary.20240604-0594deb"
+    "@nx/nx-darwin-x64": "19.2.0-rc.0",
+    "@nx/nx-darwin-arm64": "19.2.0-rc.0",
+    "@nx/nx-linux-x64-gnu": "19.2.0-rc.0",
+    "@nx/nx-linux-x64-musl": "19.2.0-rc.0",
+    "@nx/nx-win32-x64-msvc": "19.2.0-rc.0",
+    "@nx/nx-linux-arm64-gnu": "19.2.0-rc.0",
+    "@nx/nx-linux-arm64-musl": "19.2.0-rc.0",
+    "@nx/nx-linux-arm-gnueabihf": "19.2.0-rc.0",
+    "@nx/nx-win32-arm64-msvc": "19.2.0-rc.0",
+    "@nx/nx-freebsd-x64": "19.2.0-rc.0"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/release/changelog-renderer/index.d.ts

@@ -1,5 +1,6 @@
+import { ChangelogChange } from '../../src/command-line/release/changelog';
 import { NxReleaseConfig } from '../../src/command-line/release/config/config';
-import type { GitCommit } from '../../src/command-line/release/utils/git';
+import { GitCommit } from '../../src/command-line/release/utils/git';
 import { RepoSlug } from '../../src/command-line/release/utils/github';
 import type { ProjectGraph } from '../../src/config/project-graph';
 /**
@@ -22,7 +23,8 @@ export type DependencyBump = {
  *
  * @param {Object} config The configuration object for the ChangelogRenderer
  * @param {ProjectGraph} config.projectGraph The project graph for the workspace
- * @param {GitCommit[]} config.commits The collection of extracted commits to generate a changelog for
+ * @param {GitCommit[]} config.commits DEPRECATED [Use 'config.changes' instead] - The collection of extracted commits to generate a changelog for
+ * @param {ChangelogChange[]} config.changes The collection of changes to show in the changelog
  * @param {string} config.releaseVersion The version that is being released
  * @param {string | null} config.project The name of specific project to generate a changelog for, or `null` if the overall workspace changelog
  * @param {string | false} config.entryWhenNoChanges The (already interpolated) string to use as the changelog entry when there are no changes, or `false` if no entry should be generated
@@ -31,7 +33,8 @@ export type DependencyBump = {
  */
 export type ChangelogRenderer = (config: {
     projectGraph: ProjectGraph;
-    commits: GitCommit[];
+    commits?: GitCommit[];
+    changes?: ChangelogChange[];
     releaseVersion: string;
     project: string | null;
     entryWhenNoChanges: string | false;

package/release/changelog-renderer/index.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const semver_1 = require("semver");
 const github_1 = require("../../src/command-line/release/utils/github");
-const shared_1 = require("../../src/command-line/release/utils/shared");
 // axios types and values don't seem to match
 const _axios = require("axios");
 const axios = _axios;
@@ -10,18 +9,18 @@ const axios = _axios;
  * The default ChangelogRenderer implementation that nx exports for the common case of generating markdown
  * from the given commits and other metadata.
  */
-const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion, project, entryWhenNoChanges, changelogRenderOptions, dependencyBumps, repoSlug, conventionalCommitsConfig, }) => {
-    const commitTypes = conventionalCommitsConfig.types;
+const defaultChangelogRenderer = async ({ projectGraph, changes, releaseVersion, project, entryWhenNoChanges, changelogRenderOptions, dependencyBumps, repoSlug, conventionalCommitsConfig, }) => {
+    const changeTypes = conventionalCommitsConfig.types;
     const markdownLines = [];
     const breakingChanges = [];
-    // If the current range of commits contains both a commit and its revert, we strip them both from the final list
-    for (const commit of commits) {
-        if (commit.type === 'revert') {
-            for (const revertedHash of commit.revertedHashes) {
-                const revertedCommit = commits.find((c) => revertedHash.startsWith(c.shortHash));
+    // If the current range of changes contains both a commit and its revert, we strip them both from the final list. Changes from version plans are unaffected, as they have no hashes.
+    for (const change of changes) {
+        if (change.type === 'revert' && change.revertedHashes) {
+            for (const revertedHash of change.revertedHashes) {
+                const revertedCommit = changes.find((c) => c.shortHash && revertedHash.startsWith(c.shortHash));
                 if (revertedCommit) {
-                    commits.splice(commits.indexOf(revertedCommit), 1);
-                    commits.splice(commits.indexOf(commit), 1);
+                    changes.splice(changes.indexOf(revertedCommit), 1);
+                    changes.splice(changes.indexOf(change), 1);
                 }
             }
         }
@@ -29,7 +28,7 @@ const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion,
     // workspace root level changelog
     if (project === null) {
         // No changes for the workspace
-        if (commits.length === 0) {
+        if (changes.length === 0) {
             if (dependencyBumps?.length) {
                 applyAdditionalDependencyBumps({
                     markdownLines,
@@ -43,31 +42,31 @@ const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion,
             }
             return markdownLines.join('\n').trim();
         }
-        const typeGroups = groupBy(commits, 'type');
+        const typeGroups = groupBy(changes, 'type');
         markdownLines.push('', createVersionTitle(releaseVersion, changelogRenderOptions), '');
-        for (const type of Object.keys(commitTypes)) {
+        for (const type of Object.keys(changeTypes)) {
             const group = typeGroups[type];
             if (!group || group.length === 0) {
                 continue;
             }
-            markdownLines.push('', '### ' + commitTypes[type].changelog.title, '');
+            markdownLines.push('', '### ' + changeTypes[type].changelog.title, '');
             /**
-             * In order to make the final changelog most readable, we organize commits as follows:
-             * - By scope, where scopes are in alphabetical order (commits with no scope are listed first)
-             * - Within a particular scope grouping, we list commits in chronological order
+             * In order to make the final changelog most readable, we organize changes as follows:
+             * - By scope, where scopes are in alphabetical order (changes with no scope are listed first)
+             * - Within a particular scope grouping, we list changes in chronological order
              */
-            const commitsInChronologicalOrder = group.reverse();
-            const commitsGroupedByScope = groupBy(commitsInChronologicalOrder, 'scope');
-            const scopesSortedAlphabetically = Object.keys(commitsGroupedByScope).sort();
+            const changesInChronologicalOrder = group.reverse();
+            const changesGroupedByScope = groupBy(changesInChronologicalOrder, 'scope');
+            const scopesSortedAlphabetically = Object.keys(changesGroupedByScope).sort();
             for (const scope of scopesSortedAlphabetically) {
-                const commits = commitsGroupedByScope[scope];
-                for (const commit of commits) {
-                    const line = formatCommit(commit, changelogRenderOptions, repoSlug);
+                const changes = changesGroupedByScope[scope];
+                for (const change of changes) {
+                    const line = formatChange(change, changelogRenderOptions, repoSlug);
                     markdownLines.push(line);
-                    if (commit.isBreaking) {
-                        const breakingChangeExplanation = extractBreakingChangeExplanation(commit.body);
+                    if (change.isBreaking) {
+                        const breakingChangeExplanation = extractBreakingChangeExplanation(change.body);
                         breakingChanges.push(breakingChangeExplanation
-                            ? `- ${commit.scope ? `**${commit.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
+                            ? `- ${change.scope ? `**${change.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
                             : line);
                     }
                 }
@@ -76,9 +75,10 @@ const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion,
     }
     else {
         // project level changelog
-        const relevantCommits = await (0, shared_1.getCommitsRelevantToProjects)(projectGraph, commits, [project]);
+        const relevantChanges = changes.filter((c) => c.affectedProjects &&
+            (c.affectedProjects === '*' || c.affectedProjects.includes(project)));
         // Generating for a named project, but that project has no relevant changes in the current set of commits, exit early
-        if (relevantCommits.length === 0) {
+        if (relevantChanges.length === 0) {
             if (dependencyBumps?.length) {
                 applyAdditionalDependencyBumps({
                     markdownLines,
@@ -94,22 +94,22 @@ const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion,
         }
         markdownLines.push('', createVersionTitle(releaseVersion, changelogRenderOptions), '');
         const typeGroups = groupBy(
-        // Sort the relevant commits to have the unscoped commits first, before grouping by type
-        relevantCommits.sort((a, b) => (b.scope ? 1 : 0) - (a.scope ? 1 : 0)), 'type');
-        for (const type of Object.keys(commitTypes)) {
+        // Sort the relevant changes to have the unscoped changes first, before grouping by type
+        relevantChanges.sort((a, b) => (b.scope ? 1 : 0) - (a.scope ? 1 : 0)), 'type');
+        for (const type of Object.keys(changeTypes)) {
             const group = typeGroups[type];
             if (!group || group.length === 0) {
                 continue;
             }
-            markdownLines.push('', `### ${commitTypes[type].changelog.title}`, '');
-            const commitsInChronologicalOrder = group.reverse();
-            for (const commit of commitsInChronologicalOrder) {
-                const line = formatCommit(commit, changelogRenderOptions, repoSlug);
+            markdownLines.push('', `### ${changeTypes[type].changelog.title}`, '');
+            const changesInChronologicalOrder = group.reverse();
+            for (const change of changesInChronologicalOrder) {
+                const line = formatChange(change, changelogRenderOptions, repoSlug);
                 markdownLines.push(line + '\n');
-                if (commit.isBreaking) {
-                    const breakingChangeExplanation = extractBreakingChangeExplanation(commit.body);
+                if (change.isBreaking) {
+                    const breakingChangeExplanation = extractBreakingChangeExplanation(change.body);
                     breakingChanges.push(breakingChangeExplanation
-                        ? `- ${commit.scope ? `**${commit.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
+                        ? `- ${change.scope ? `**${change.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
                         : line);
                 }
             }
@@ -128,20 +128,20 @@ const defaultChangelogRenderer = async ({ projectGraph, commits, releaseVersion,
     }
     if (changelogRenderOptions.authors) {
         const _authors = new Map();
-        for (const commit of commits) {
-            if (!commit.author) {
+        for (const change of changes) {
+            if (!change.author) {
                 continue;
             }
-            const name = formatName(commit.author.name);
+            const name = formatName(change.author.name);
             if (!name || name.includes('[bot]')) {
                 continue;
             }
             if (_authors.has(name)) {
                 const entry = _authors.get(name);
-                entry.email.add(commit.author.email);
+                entry.email.add(change.author.email);
             }
             else {
-                _authors.set(name, { email: new Set([commit.author.email]) });
+                _authors.set(name, { email: new Set([change.author.email]) });
             }
         }
         // Try to map authors to github usernames
@@ -214,15 +214,15 @@ function groupBy(items, key) {
     }
     return groups;
 }
-function formatCommit(commit, changelogRenderOptions, repoSlug) {
-    let commitLine = '- ' +
-        (commit.isBreaking ? '⚠️  ' : '') +
-        (commit.scope ? `**${commit.scope.trim()}:** ` : '') +
-        commit.description;
+function formatChange(change, changelogRenderOptions, repoSlug) {
+    let changeLine = '- ' +
+        (change.isBreaking ? '⚠️  ' : '') +
+        (change.scope ? `**${change.scope.trim()}:** ` : '') +
+        change.description;
     if (repoSlug && changelogRenderOptions.commitReferences) {
-        commitLine += (0, github_1.formatReferences)(commit.references, repoSlug);
+        changeLine += (0, github_1.formatReferences)(change.githubReferences, repoSlug);
     }
-    return commitLine;
+    return changeLine;
 }
 /**
  * It is common to add further information about a breaking change in the commit body,
@@ -230,6 +230,9 @@ function formatCommit(commit, changelogRenderOptions, repoSlug) {
  * section of changelog, rather than repeating the commit title/description.
  */
 function extractBreakingChangeExplanation(message) {
+    if (!message) {
+        return null;
+    }
     const breakingChangeIdentifier = 'BREAKING CHANGE:';
     const startIndex = message.indexOf(breakingChangeIdentifier);
     if (startIndex === -1) {

package/schemas/nx-schema.json

@@ -184,6 +184,10 @@
               },
               "releaseTagPattern": {
                 "type": "string"
+              },
+              "versionPlans": {
+                "type": "boolean",
+                "description": "Enables using version plans as a specifier source for versioning and to determine changes for changelog generation."
               }
             },
             "required": ["projects"]
@@ -234,6 +238,10 @@
         "version": {
           "$ref": "#/definitions/NxReleaseVersionConfiguration"
         },
+        "versionPlans": {
+          "type": "boolean",
+          "description": "Enables using version plans as a specifier source for versioning and to determine changes for changelog generation."
+        },
         "releaseTagPattern": {
           "type": "string"
         }

package/src/command-line/add/add.d.ts

@@ -1,3 +1,3 @@
 import type { AddOptions } from './command-object';
-export declare function addHandler(options: AddOptions): Promise<void>;
+export declare function addHandler(options: AddOptions): Promise<number>;
 export declare const coreNxPluginVersions: Map<string, string>;

package/src/command-line/add/command-object.js

@@ -25,5 +25,7 @@ exports.yargsAddCommand = {
         .example('$0 add @nx/react', 'Install the latest version of the `@nx/react` package and run its `@nx/react:init` generator')
         .example('$0 add non-core-nx-plugin', 'Install the latest version of the `non-core-nx-plugin` package and run its `non-core-nx-plugin:init` generator if available')
         .example('$0 add @nx/react@17.0.0', 'Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator'),
-    handler: (args) => Promise.resolve().then(() => require('./add')).then((m) => m.addHandler((0, shared_options_1.withOverrides)(args))),
+    handler: async (args) => {
+        process.exit(await Promise.resolve().then(() => require('./add')).then((m) => m.addHandler((0, shared_options_1.withOverrides)(args))));
+    },
 };

package/src/command-line/affected/command-object.js

@@ -18,9 +18,10 @@ exports.yargsAffectedCommand = {
         }
     }), 'affected'),
     handler: async (args) => {
-        return (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             return (await Promise.resolve().then(() => require('./affected'))).affected('affected', (0, shared_options_1.withOverrides)(args));
         });
+        process.exit(exitCode);
     },
 };
 exports.yargsAffectedTestCommand = {
@@ -28,12 +29,13 @@ exports.yargsAffectedTestCommand = {
     describe: false,
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withConfiguration)(yargs)))), 'affected'),
     handler: async (args) => {
-        return (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             return (await Promise.resolve().then(() => require('./affected'))).affected('affected', {
                 ...(0, shared_options_1.withOverrides)(args),
                 target: 'test',
             });
         });
+        process.exit(exitCode);
     },
 };
 exports.yargsAffectedBuildCommand = {
@@ -41,12 +43,13 @@ exports.yargsAffectedBuildCommand = {
     describe: false,
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withConfiguration)(yargs)))), 'affected'),
     handler: async (args) => {
-        return (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             return (await Promise.resolve().then(() => require('./affected'))).affected('affected', {
                 ...(0, shared_options_1.withOverrides)(args),
                 target: 'build',
             });
         });
+        process.exit(exitCode);
     },
 };
 exports.yargsAffectedLintCommand = {
@@ -54,12 +57,13 @@ exports.yargsAffectedLintCommand = {
     describe: false,
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withConfiguration)(yargs)))), 'affected'),
     handler: async (args) => {
-        return (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             return (await Promise.resolve().then(() => require('./affected'))).affected('affected', {
                 ...(0, shared_options_1.withOverrides)(args),
                 target: 'lint',
             });
         });
+        process.exit(exitCode);
     },
 };
 exports.yargsAffectedE2ECommand = {
@@ -67,11 +71,12 @@ exports.yargsAffectedE2ECommand = {
     describe: false,
     builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withAffectedOptions)((0, shared_options_1.withRunOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withConfiguration)(yargs)))), 'affected'),
     handler: async (args) => {
-        return (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
+        const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
             return (await Promise.resolve().then(() => require('./affected'))).affected('affected', {
                 ...(0, shared_options_1.withOverrides)(args),
                 target: 'e2e',
             });
         });
+        process.exit(exitCode);
     },
 };

package/src/command-line/deprecated/command-objects.js

@@ -14,9 +14,12 @@ exports.yargsAffectedGraphCommand = {
     describe: false,
     aliases: ['affected:dep-graph'],
     builder: (yargs) => (0, shared_options_1.withAffectedOptions)((0, command_object_1.withGraphOptions)(yargs)),
-    handler: (args) => (0, params_1.handleErrors)(false, () => {
-        throw new Error(affectedGraphDeprecationMessage);
-    }),
+    handler: async (args) => {
+        const exitCode = await (0, params_1.handleErrors)(false, () => {
+            throw new Error(affectedGraphDeprecationMessage);
+        });
+        process.exit(exitCode);
+    },
     deprecated: affectedGraphDeprecationMessage,
 };
 /**
@@ -35,8 +38,11 @@ exports.yargsPrintAffectedCommand = {
         choices: ['app', 'lib'],
         describe: 'Select the type of projects to be returned (e.g., --type=app)',
     }),
-    handler: (args) => (0, params_1.handleErrors)(false, () => {
-        throw new Error(printAffectedDeprecationMessage);
-    }),
+    handler: async (args) => {
+        const exitCode = await (0, params_1.handleErrors)(false, () => {
+            throw new Error(printAffectedDeprecationMessage);
+        });
+        process.exit(exitCode);
+    },
     deprecated: printAffectedDeprecationMessage,
 };

package/src/command-line/examples.js

@@ -284,6 +284,24 @@ exports.examples = {
             description: 'Create a dedicated commit for each successfully completed migration. You can customize the prefix used for each commit by additionally setting --commit-prefix="PREFIX_HERE "',
         },
     ],
+    reset: [
+        {
+            command: 'reset',
+            description: 'Clears the internal state of the daemon and metadata that Nx is tracking. Helpful if you are getting strange errors and want to start fresh',
+        },
+        {
+            command: 'reset --only-cache',
+            description: 'Clears the Nx Cache directory. This will remove all local cache entries for tasks, but will not affect the remote cache',
+        },
+        {
+            command: 'reset --only-daemon',
+            description: 'Stops the Nx Daemon, it will be restarted fresh when the next Nx command is run.',
+        },
+        {
+            command: 'reset --only-workspace-data',
+            description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc)',
+        },
+    ],
     show: [
         {
             command: 'show projects',

package/src/command-line/generate/generate.d.ts

@@ -18,4 +18,4 @@ export declare function parseGeneratorString(value: string): {
 export declare function printGenHelp(opts: GenerateOptions, schema: Schema, normalizedGeneratorName: string, aliases: string[]): void;
 export declare function generate(cwd: string, args: {
     [k: string]: any;
-}): Promise<any>;
+}): Promise<number>;

package/src/command-line/migrate/migrate.d.ts

@@ -110,5 +110,5 @@ export declare function executeMigrations(root: string, migrations: {
 }[]>;
 export declare function migrate(root: string, args: {
     [k: string]: any;
-}, rawArgs: string[]): Promise<any>;
+}, rawArgs: string[]): Promise<number>;
 export {};

package/src/command-line/new/new.d.ts

@@ -1,3 +1,3 @@
 export declare function newWorkspace(cwd: string, args: {
     [k: string]: any;
-}): Promise<any>;
+}): Promise<number>;

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

@@ -1,5 +1,6 @@
 import { NxReleaseChangelogConfiguration } from '../../config/nx-json';
 import { ChangelogOptions } from './command-object';
+import { Reference } from './utils/git';
 import { ReleaseVersion } from './utils/shared';
 export interface NxReleaseChangelogResult {
     workspaceChangelog?: {
@@ -13,7 +14,22 @@ export interface NxReleaseChangelogResult {
         };
     };
 }
-export declare const releaseChangelogCLIHandler: (args: ChangelogOptions) => Promise<any>;
+export interface ChangelogChange {
+    type: string;
+    scope: string;
+    description: string;
+    affectedProjects: string[] | '*';
+    body?: string;
+    isBreaking?: boolean;
+    githubReferences?: Reference[];
+    author?: {
+        name: string;
+        email: string;
+    };
+    shortHash?: string;
+    revertedHashes?: string[];
+}
+export declare const releaseChangelogCLIHandler: (args: ChangelogOptions) => Promise<number>;
 /**
  * NOTE: This function is also exported for programmatic usage and forms part of the public API
  * of Nx. We intentionally do not wrap the implementation with handleErrors because users need