nx 19.7.0-canary.20240905-ccda7f9 → 19.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (41) hide show
  1. package/package.json +12 -12
  2. package/src/command-line/add/command-object.js +2 -2
  3. package/src/command-line/affected/command-object.js +1 -1
  4. package/src/command-line/connect/command-object.js +2 -2
  5. package/src/command-line/daemon/command-object.js +1 -1
  6. package/src/command-line/deprecated/command-objects.js +2 -2
  7. package/src/command-line/exec/command-object.js +1 -1
  8. package/src/command-line/format/command-object.js +4 -4
  9. package/src/command-line/generate/command-object.js +4 -4
  10. package/src/command-line/graph/command-object.js +6 -6
  11. package/src/command-line/import/command-object.js +6 -6
  12. package/src/command-line/list/command-object.js +1 -1
  13. package/src/command-line/login/command-object.js +1 -1
  14. package/src/command-line/logout/command-object.js +1 -1
  15. package/src/command-line/migrate/command-object.js +9 -9
  16. package/src/command-line/new/command-object.js +2 -2
  17. package/src/command-line/release/command-object.js +27 -27
  18. package/src/command-line/report/command-object.js +1 -1
  19. package/src/command-line/reset/command-object.js +1 -1
  20. package/src/command-line/run/command-object.js +1 -1
  21. package/src/command-line/run-many/command-object.js +1 -1
  22. package/src/command-line/show/command-object.js +10 -10
  23. package/src/command-line/watch/command-object.js +1 -1
  24. package/src/command-line/yargs-utils/shared-options.js +20 -20
  25. package/src/core/graph/main.js +1 -1
  26. package/src/core/graph/styles.css +1 -1
  27. package/src/daemon/server/server.js +1 -1
  28. package/src/daemon/server/watcher.d.ts +1 -1
  29. package/src/daemon/server/watcher.js +14 -12
  30. package/src/migrations/update-15-0-0/prefix-outputs.js +3 -18
  31. package/src/native/index.d.ts +4 -0
  32. package/src/native/native-bindings.js +2 -0
  33. package/src/native/nx.wasi-browser.js +53 -49
  34. package/src/native/nx.wasi.cjs +53 -49
  35. package/src/native/nx.wasm32-wasi.wasm +0 -0
  36. package/src/nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud.js +6 -41
  37. package/src/tasks-runner/cache.d.ts +2 -0
  38. package/src/tasks-runner/cache.js +15 -1
  39. package/src/tasks-runner/task-orchestrator.js +1 -10
  40. package/src/tasks-runner/utils.d.ts +1 -8
  41. package/src/tasks-runner/utils.js +9 -12
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nx",
3
- "version": "19.7.0-canary.20240905-ccda7f9",
3
+ "version": "19.7.0",
4
4
  "private": false,
5
5
  "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
6
6
  "repository": {
@@ -71,7 +71,7 @@
71
71
  "yargs-parser": "21.1.1",
72
72
  "node-machine-id": "1.1.12",
73
73
  "ora": "5.3.0",
74
- "@nrwl/tao": "19.7.0-canary.20240905-ccda7f9"
74
+ "@nrwl/tao": "19.7.0"
75
75
  },
76
76
  "peerDependencies": {
77
77
  "@swc-node/register": "^1.8.0",
@@ -86,16 +86,16 @@
86
86
  }
87
87
  },
88
88
  "optionalDependencies": {
89
- "@nx/nx-darwin-x64": "19.7.0-canary.20240905-ccda7f9",
90
- "@nx/nx-darwin-arm64": "19.7.0-canary.20240905-ccda7f9",
91
- "@nx/nx-linux-x64-gnu": "19.7.0-canary.20240905-ccda7f9",
92
- "@nx/nx-linux-x64-musl": "19.7.0-canary.20240905-ccda7f9",
93
- "@nx/nx-win32-x64-msvc": "19.7.0-canary.20240905-ccda7f9",
94
- "@nx/nx-linux-arm64-gnu": "19.7.0-canary.20240905-ccda7f9",
95
- "@nx/nx-linux-arm64-musl": "19.7.0-canary.20240905-ccda7f9",
96
- "@nx/nx-linux-arm-gnueabihf": "19.7.0-canary.20240905-ccda7f9",
97
- "@nx/nx-win32-arm64-msvc": "19.7.0-canary.20240905-ccda7f9",
98
- "@nx/nx-freebsd-x64": "19.7.0-canary.20240905-ccda7f9"
89
+ "@nx/nx-darwin-x64": "19.7.0",
90
+ "@nx/nx-darwin-arm64": "19.7.0",
91
+ "@nx/nx-linux-x64-gnu": "19.7.0",
92
+ "@nx/nx-linux-x64-musl": "19.7.0",
93
+ "@nx/nx-win32-x64-msvc": "19.7.0",
94
+ "@nx/nx-linux-arm64-gnu": "19.7.0",
95
+ "@nx/nx-linux-arm64-musl": "19.7.0",
96
+ "@nx/nx-linux-arm-gnueabihf": "19.7.0",
97
+ "@nx/nx-win32-arm64-msvc": "19.7.0",
98
+ "@nx/nx-freebsd-x64": "19.7.0"
99
99
  },
100
100
  "nx-migrations": {
101
101
  "migrations": "./migrations.json",
@@ -12,11 +12,11 @@ exports.yargsAddCommand = {
12
12
  })
13
13
  .positional('packageSpecifier', {
14
14
  type: 'string',
15
- description: 'The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize. If the version is not specified it will install the same version as the `nx` package for Nx core plugins or the latest version for other packages',
15
+ description: 'The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize. If the version is not specified it will install the same version as the `nx` package for Nx core plugins or the latest version for other packages.',
16
16
  })
17
17
  .option('updatePackageScripts', {
18
18
  type: 'boolean',
19
- description: 'Update `package.json` scripts with inferred targets. Defaults to `true` when the package is a core Nx plugin',
19
+ description: 'Update `package.json` scripts with inferred targets. Defaults to `true` when the package is a core Nx plugin.',
20
20
  })
21
21
  .example('$0 add @nx/react', 'Install the latest version of the `@nx/react` package and run its `@nx/react:init` generator')
22
22
  .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')
@@ -6,7 +6,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
6
6
  const params_1 = require("../../utils/params");
7
7
  exports.yargsAffectedCommand = {
8
8
  command: 'affected',
9
- describe: 'Run target for affected projects',
9
+ describe: 'Run target for affected projects.',
10
10
  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.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs)))))
11
11
  .option('all', {
12
12
  type: 'boolean',
@@ -7,7 +7,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
7
7
  exports.yargsConnectCommand = {
8
8
  command: 'connect',
9
9
  aliases: ['connect-to-nx-cloud'],
10
- describe: `Connect workspace to Nx Cloud`,
10
+ describe: `Connect workspace to Nx Cloud.`,
11
11
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withConnectOptions(yargs), 'connect-to-nx-cloud'),
12
12
  handler: async (args) => {
13
13
  await (await Promise.resolve().then(() => require('./connect-to-nx-cloud'))).connectToNxCloudCommand(args);
@@ -22,7 +22,7 @@ exports.yargsConnectCommand = {
22
22
  function withConnectOptions(yargs) {
23
23
  return (0, shared_options_1.withVerbose)(yargs).option('generateToken', {
24
24
  type: 'boolean',
25
- description: 'Explicitly asks for a token to be created, do not override existing tokens from Nx Cloud',
25
+ description: 'Explicitly asks for a token to be created, do not override existing tokens from Nx Cloud.',
26
26
  });
27
27
  }
28
28
  exports.yargsViewLogsCommand = {
@@ -4,7 +4,7 @@ exports.yargsDaemonCommand = void 0;
4
4
  const documentation_1 = require("../yargs-utils/documentation");
5
5
  exports.yargsDaemonCommand = {
6
6
  command: 'daemon',
7
- describe: 'Prints information about the Nx Daemon process or starts a daemon process',
7
+ describe: 'Prints information about the Nx Daemon process or starts a daemon process.',
8
8
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withDaemonOptions(yargs), 'daemon'),
9
9
  handler: async (args) => (await Promise.resolve().then(() => require('./daemon'))).daemonHandler(args),
10
10
  };
@@ -31,12 +31,12 @@ exports.yargsPrintAffectedCommand = {
31
31
  builder: (yargs) => (0, shared_options_1.withAffectedOptions)((0, shared_options_1.withTargetAndConfigurationOption)(yargs, false))
32
32
  .option('select', {
33
33
  type: 'string',
34
- describe: 'Select the subset of the returned json document (e.g., --select=projects)',
34
+ describe: 'Select the subset of the returned json document (e.g., --select=projects).',
35
35
  })
36
36
  .option('type', {
37
37
  type: 'string',
38
38
  choices: ['app', 'lib'],
39
- describe: 'Select the type of projects to be returned (e.g., --type=app)',
39
+ describe: 'Select the type of projects to be returned (e.g., --type=app).',
40
40
  }),
41
41
  handler: async (args) => {
42
42
  const exitCode = await (0, params_1.handleErrors)(false, () => {
@@ -4,7 +4,7 @@ exports.yargsExecCommand = void 0;
4
4
  const shared_options_1 = require("../yargs-utils/shared-options");
5
5
  exports.yargsExecCommand = {
6
6
  command: 'exec',
7
- describe: 'Executes any command as if it was a target on the project',
7
+ describe: 'Executes any command as if it was a target on the project.',
8
8
  builder: (yargs) => (0, shared_options_1.withRunManyOptions)(yargs),
9
9
  handler: async (args) => {
10
10
  try {
@@ -5,7 +5,7 @@ const documentation_1 = require("../yargs-utils/documentation");
5
5
  const shared_options_1 = require("../yargs-utils/shared-options");
6
6
  exports.yargsFormatCheckCommand = {
7
7
  command: 'format:check',
8
- describe: 'Check for un-formatted files',
8
+ describe: 'Check for un-formatted files.',
9
9
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withFormatOptions(yargs), 'format:check'),
10
10
  handler: async (args) => {
11
11
  await (await Promise.resolve().then(() => require('./format'))).format('check', args);
@@ -14,7 +14,7 @@ exports.yargsFormatCheckCommand = {
14
14
  };
15
15
  exports.yargsFormatWriteCommand = {
16
16
  command: 'format:write',
17
- describe: 'Overwrite un-formatted files',
17
+ describe: 'Overwrite un-formatted files.',
18
18
  aliases: ['format'],
19
19
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withFormatOptions(yargs), 'format:write'),
20
20
  handler: async (args) => {
@@ -32,12 +32,12 @@ function withFormatOptions(yargs) {
32
32
  type: 'boolean',
33
33
  })
34
34
  .option('projects', {
35
- describe: 'Projects to format (comma/space delimited)',
35
+ describe: 'Projects to format (comma/space delimited).',
36
36
  type: 'string',
37
37
  coerce: shared_options_1.parseCSV,
38
38
  })
39
39
  .option('all', {
40
- describe: 'Format all projects',
40
+ describe: 'Format all projects.',
41
41
  type: 'boolean',
42
42
  })
43
43
  .conflicts({
@@ -18,23 +18,23 @@ function withGenerateOptions(yargs) {
18
18
  const generatorWillShowHelp = process.argv[3] && !process.argv[3].startsWith('-');
19
19
  const res = (0, shared_options_1.withVerbose)(yargs)
20
20
  .positional('generator', {
21
- describe: 'Name of the generator (e.g., @nx/js:library, library)',
21
+ describe: 'Name of the generator (e.g., @nx/js:library, library).',
22
22
  type: 'string',
23
23
  required: true,
24
24
  })
25
25
  .option('dryRun', {
26
- describe: 'Preview the changes without updating files',
26
+ describe: 'Preview the changes without updating files.',
27
27
  alias: 'd',
28
28
  type: 'boolean',
29
29
  default: false,
30
30
  })
31
31
  .option('interactive', {
32
- describe: 'When false disables interactive input prompts for options',
32
+ describe: 'When false disables interactive input prompts for options.',
33
33
  type: 'boolean',
34
34
  default: true,
35
35
  })
36
36
  .option('quiet', {
37
- describe: 'Hides logs from tree operations (e.g. `CREATE package.json`)',
37
+ describe: 'Hides logs from tree operations (e.g. `CREATE package.json`).',
38
38
  type: 'boolean',
39
39
  conflicts: ['verbose'],
40
40
  })
@@ -6,12 +6,12 @@ const documentation_1 = require("../yargs-utils/documentation");
6
6
  const shared_options_1 = require("../yargs-utils/shared-options");
7
7
  exports.yargsGraphCommand = {
8
8
  command: 'graph',
9
- describe: 'Graph dependencies within workspace',
9
+ describe: 'Graph dependencies within workspace.',
10
10
  aliases: ['dep-graph'],
11
11
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(withGraphOptions(yargs))), 'dep-graph')
12
12
  .option('affected', {
13
13
  type: 'boolean',
14
- description: 'Highlight affected projects',
14
+ description: 'Highlight affected projects.',
15
15
  })
16
16
  .implies('untracked', 'affected')
17
17
  .implies('uncommitted', 'affected')
@@ -31,13 +31,13 @@ function withGraphOptions(yargs) {
31
31
  type: 'boolean',
32
32
  })
33
33
  .option('view', {
34
- describe: 'Choose whether to view the projects or task graph',
34
+ describe: 'Choose whether to view the projects or task graph.',
35
35
  type: 'string',
36
36
  default: 'projects',
37
37
  choices: ['projects', 'tasks'],
38
38
  })
39
39
  .option('targets', {
40
- describe: 'The target to show tasks for in the task graph',
40
+ describe: 'The target to show tasks for in the task graph.',
41
41
  type: 'string',
42
42
  coerce: shared_options_1.parseCSV,
43
43
  })
@@ -51,7 +51,7 @@ function withGraphOptions(yargs) {
51
51
  coerce: shared_options_1.parseCSV,
52
52
  })
53
53
  .option('groupByFolder', {
54
- describe: 'Group projects by folder in the project graph',
54
+ describe: 'Group projects by folder in the project graph.',
55
55
  type: 'boolean',
56
56
  })
57
57
  .option('host', {
@@ -63,7 +63,7 @@ function withGraphOptions(yargs) {
63
63
  type: 'number',
64
64
  })
65
65
  .option('watch', {
66
- describe: 'Watch for changes to project graph and update in-browser',
66
+ describe: 'Watch for changes to project graph and update in-browser.',
67
67
  type: 'boolean',
68
68
  default: true,
69
69
  })
@@ -10,27 +10,27 @@ exports.yargsImportCommand = {
10
10
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)(yargs
11
11
  .positional('sourceRemoteUrl', {
12
12
  type: 'string',
13
- description: 'The remote URL of the source to import',
13
+ description: 'The remote URL of the source to import.',
14
14
  })
15
15
  .positional('destination', {
16
16
  type: 'string',
17
- description: 'The directory in the current workspace to import into',
17
+ description: 'The directory in the current workspace to import into.',
18
18
  })
19
19
  .option('source', {
20
20
  type: 'string',
21
- description: 'The directory in the source repository to import from',
21
+ description: 'The directory in the source repository to import from.',
22
22
  })
23
23
  .option('ref', {
24
24
  type: 'string',
25
- description: 'The branch from the source repository to import',
25
+ description: 'The branch from the source repository to import.',
26
26
  })
27
27
  .option('depth', {
28
28
  type: 'number',
29
- description: 'The depth to clone the source repository (limit this for faster git clone)',
29
+ description: 'The depth to clone the source repository (limit this for faster git clone).',
30
30
  })
31
31
  .option('interactive', {
32
32
  type: 'boolean',
33
- description: 'Interactive mode',
33
+ description: 'Interactive mode.',
34
34
  default: true,
35
35
  })), 'import'),
36
36
  handler: async (args) => {
@@ -6,7 +6,7 @@ exports.yargsListCommand = {
6
6
  describe: 'Lists installed plugins, capabilities of installed plugins and other available plugins.',
7
7
  builder: (yargs) => yargs.positional('plugin', {
8
8
  type: 'string',
9
- description: 'The name of an installed plugin to query',
9
+ description: 'The name of an installed plugin to query.',
10
10
  }),
11
11
  handler: async (args) => {
12
12
  await (await Promise.resolve().then(() => require('./list'))).listHandler(args);
@@ -4,7 +4,7 @@ exports.yargsLoginCommand = void 0;
4
4
  const shared_options_1 = require("../../command-line/yargs-utils/shared-options");
5
5
  exports.yargsLoginCommand = {
6
6
  command: 'login [nxCloudUrl]',
7
- describe: false,
7
+ describe: 'Login to Nx Cloud. This command is an alias for [`nx-cloud login`](/ci/reference/nx-cloud-cli#npx-nxcloud-login).',
8
8
  builder: (yargs) => (0, shared_options_1.withVerbose)(yargs.positional('nxCloudUrl', {
9
9
  describe: 'The Nx Cloud URL of the instance you are trying to connect to. If no positional argument is provided, this command will connect to https://cloud.nx.app.',
10
10
  type: 'string',
@@ -4,7 +4,7 @@ exports.yargsLogoutCommand = void 0;
4
4
  const shared_options_1 = require("../../command-line/yargs-utils/shared-options");
5
5
  exports.yargsLogoutCommand = {
6
6
  command: 'logout',
7
- describe: false,
7
+ describe: 'Logout from Nx Cloud. This command is an alias for [`nx-cloud logout`](/ci/reference/nx-cloud-cli#npx-nxcloud-logout).',
8
8
  builder: (yargs) => (0, shared_options_1.withVerbose)(yargs),
9
9
  handler: async (args) => {
10
10
  process.exit(await (await Promise.resolve().then(() => require('./logout'))).logoutHandler(args));
@@ -30,44 +30,44 @@ function withMigrationOptions(yargs) {
30
30
  const defaultCommitPrefix = 'chore: [nx migration] ';
31
31
  return (0, shared_options_1.withVerbose)(yargs)
32
32
  .positional('packageAndVersion', {
33
- describe: `The target package and version (e.g, @nx/workspace@16.0.0)`,
33
+ describe: `The target package and version (e.g, @nx/workspace@16.0.0).`,
34
34
  type: 'string',
35
35
  })
36
36
  .option('runMigrations', {
37
- describe: `Execute migrations from a file (when the file isn't provided, execute migrations from migrations.json)`,
37
+ describe: `Execute migrations from a file (when the file isn't provided, execute migrations from migrations.json).`,
38
38
  type: 'string',
39
39
  })
40
40
  .option('ifExists', {
41
- describe: `Run migrations only if the migrations file exists, if not continues successfully`,
41
+ describe: `Run migrations only if the migrations file exists, if not continues successfully.`,
42
42
  type: 'boolean',
43
43
  default: false,
44
44
  })
45
45
  .option('from', {
46
- describe: 'Use the provided versions for packages instead of the ones installed in node_modules (e.g., --from="@nx/react@16.0.0,@nx/js@16.0.0")',
46
+ describe: 'Use the provided versions for packages instead of the ones installed in node_modules (e.g., --from="@nx/react@16.0.0,@nx/js@16.0.0").',
47
47
  type: 'string',
48
48
  })
49
49
  .option('to', {
50
- describe: 'Use the provided versions for packages instead of the ones calculated by the migrator (e.g., --to="@nx/react@16.0.0,@nx/js@16.0.0")',
50
+ describe: 'Use the provided versions for packages instead of the ones calculated by the migrator (e.g., --to="@nx/react@16.0.0,@nx/js@16.0.0").',
51
51
  type: 'string',
52
52
  })
53
53
  .option('createCommits', {
54
- describe: 'Automatically create a git commit after each migration runs',
54
+ describe: 'Automatically create a git commit after each migration runs.',
55
55
  type: 'boolean',
56
56
  alias: ['C'],
57
57
  default: false,
58
58
  })
59
59
  .option('commitPrefix', {
60
- describe: 'Commit prefix to apply to the commit for each migration, when --create-commits is enabled',
60
+ describe: 'Commit prefix to apply to the commit for each migration, when --create-commits is enabled.',
61
61
  type: 'string',
62
62
  default: defaultCommitPrefix,
63
63
  })
64
64
  .option('interactive', {
65
- describe: 'Enable prompts to confirm whether to collect optional package updates and migrations',
65
+ describe: 'Enable prompts to confirm whether to collect optional package updates and migrations.',
66
66
  type: 'boolean',
67
67
  default: false,
68
68
  })
69
69
  .option('excludeAppliedMigrations', {
70
- describe: 'Exclude migrations that should have been applied on previous updates. To be used with --from',
70
+ describe: 'Exclude migrations that should have been applied on previous updates. To be used with --from.',
71
71
  type: 'boolean',
72
72
  default: false,
73
73
  })
@@ -13,12 +13,12 @@ exports.yargsNewCommand = {
13
13
  function withNewOptions(yargs) {
14
14
  return yargs
15
15
  .option('nxWorkspaceRoot', {
16
- describe: 'The folder where the new workspace is going to be created',
16
+ describe: 'The folder where the new workspace is going to be created.',
17
17
  type: 'string',
18
18
  required: true,
19
19
  })
20
20
  .option('interactive', {
21
- describe: 'When false disables interactive input prompts for options',
21
+ describe: 'When false disables interactive input prompts for options.',
22
22
  type: 'boolean',
23
23
  default: true,
24
24
  });
@@ -8,7 +8,7 @@ const logger_1 = require("../../utils/logger");
8
8
  const shared_options_1 = require("../yargs-utils/shared-options");
9
9
  exports.yargsReleaseCommand = {
10
10
  command: 'release',
11
- describe: 'Orchestrate versioning and publishing of applications and libraries',
11
+ describe: 'Orchestrate versioning and publishing of applications and libraries.',
12
12
  builder: (yargs) => (0, shared_options_1.withVerbose)(yargs)
13
13
  .command(releaseCommand)
14
14
  .command(versionCommand)
@@ -29,10 +29,10 @@ exports.yargsReleaseCommand = {
29
29
  type: 'string',
30
30
  alias: 'p',
31
31
  coerce: shared_options_1.parseCSV,
32
- describe: 'Projects to run. (comma/space delimited project names and/or patterns)',
32
+ describe: 'Projects to run. (comma/space delimited project names and/or patterns).',
33
33
  })
34
34
  .option('dry-run', {
35
- describe: 'Preview the changes without updating files/creating releases',
35
+ describe: 'Preview the changes without updating files/creating releases.',
36
36
  alias: 'd',
37
37
  type: 'boolean',
38
38
  default: false,
@@ -40,7 +40,7 @@ exports.yargsReleaseCommand = {
40
40
  // NOTE: The camel case format is required for the coerce() function to be called correctly. It still supports --print-config casing.
41
41
  .option('printConfig', {
42
42
  type: 'string',
43
- describe: 'Print the resolved nx release configuration that would be used for the current command and then exit',
43
+ describe: 'Print the resolved nx release configuration that would be used for the current command and then exit.',
44
44
  coerce: (val) => {
45
45
  if (val === '') {
46
46
  return true;
@@ -72,7 +72,7 @@ exports.yargsReleaseCommand = {
72
72
  };
73
73
  const releaseCommand = {
74
74
  command: '$0 [specifier]',
75
- describe: 'Create a version and release for the workspace, generate a changelog, and optionally publish the packages',
75
+ describe: 'Create a version and release for the workspace, generate a changelog, and optionally publish the packages.',
76
76
  builder: (yargs) => withFirstReleaseOptions(yargs)
77
77
  .positional('specifier', {
78
78
  type: 'string',
@@ -81,11 +81,11 @@ const releaseCommand = {
81
81
  .option('yes', {
82
82
  type: 'boolean',
83
83
  alias: 'y',
84
- description: 'Automatically answer yes to the confirmation prompt for publishing',
84
+ description: 'Automatically answer yes to the confirmation prompt for publishing.',
85
85
  })
86
86
  .option('skip-publish', {
87
87
  type: 'boolean',
88
- description: 'Skip publishing by automatically answering no to the confirmation prompt for publishing',
88
+ description: 'Skip publishing by automatically answering no to the confirmation prompt for publishing.',
89
89
  })
90
90
  .check((argv) => {
91
91
  if (argv.yes !== undefined && argv.skipPublish !== undefined) {
@@ -105,7 +105,7 @@ const releaseCommand = {
105
105
  const versionCommand = {
106
106
  command: 'version [specifier]',
107
107
  aliases: ['v'],
108
- describe: 'Create a version and release for one or more applications and libraries',
108
+ describe: 'Create a version and release for one or more applications and libraries.',
109
109
  builder: (yargs) => withFirstReleaseOptions(withGitCommitAndGitTagOptions(yargs
110
110
  .positional('specifier', {
111
111
  type: 'string',
@@ -113,7 +113,7 @@ const versionCommand = {
113
113
  })
114
114
  .option('preid', {
115
115
  type: 'string',
116
- describe: 'The optional prerelease identifier to apply to the version. This will only be applied in the case that the specifier argument has been set to `prerelease` OR when conventional commits are enabled, in which case it will modify the resolved specifier from conventional commits to be its prerelease equivalent. E.g. minor -> preminor',
116
+ describe: 'The optional prerelease identifier to apply to the version. This will only be applied in the case that the specifier argument has been set to `prerelease` OR when conventional commits are enabled, in which case it will modify the resolved specifier from conventional commits to be its prerelease equivalent. E.g. minor -> preminor.',
117
117
  default: '',
118
118
  })
119
119
  .option('stage-changes', {
@@ -132,32 +132,32 @@ const versionCommand = {
132
132
  const changelogCommand = {
133
133
  command: 'changelog [version]',
134
134
  aliases: ['c'],
135
- describe: 'Generate a changelog for one or more projects, and optionally push to Github',
135
+ describe: 'Generate a changelog for one or more projects, and optionally push to Github.',
136
136
  builder: (yargs) => withFirstReleaseOptions(withGitCommitAndGitTagOptions(yargs
137
137
  // Disable default meaning of yargs version for this command
138
138
  .version(false)
139
139
  .positional('version', {
140
140
  type: 'string',
141
- description: 'The version to create a Github release and changelog for',
141
+ description: 'The version to create a Github release and changelog for.',
142
142
  })
143
143
  .option('from', {
144
144
  type: 'string',
145
- description: 'The git reference to use as the start of the changelog. If not set it will attempt to resolve the latest tag and use that',
145
+ description: 'The git reference to use as the start of the changelog. If not set it will attempt to resolve the latest tag and use that.',
146
146
  })
147
147
  .option('to', {
148
148
  type: 'string',
149
- description: 'The git reference to use as the end of the changelog',
149
+ description: 'The git reference to use as the end of the changelog.',
150
150
  default: 'HEAD',
151
151
  })
152
152
  .option('interactive', {
153
153
  alias: 'i',
154
154
  type: 'string',
155
- description: 'Interactively modify changelog markdown contents in your code editor before applying the changes. You can set it to be interactive for all changelogs, or only the workspace level, or only the project level',
155
+ description: 'Interactively modify changelog markdown contents in your code editor before applying the changes. You can set it to be interactive for all changelogs, or only the workspace level, or only the project level.',
156
156
  choices: ['all', 'workspace', 'projects'],
157
157
  })
158
158
  .option('git-remote', {
159
159
  type: 'string',
160
- description: 'Alternate git remote in the form {user}/{repo} on which to create the Github release (useful for testing)',
160
+ description: 'Alternate git remote in the form {user}/{repo} on which to create the Github release (useful for testing).',
161
161
  default: 'origin',
162
162
  })
163
163
  .check((argv) => {
@@ -178,15 +178,15 @@ const changelogCommand = {
178
178
  const publishCommand = {
179
179
  command: 'publish',
180
180
  aliases: ['p'],
181
- describe: 'Publish a versioned project to a registry',
181
+ describe: 'Publish a versioned project to a registry.',
182
182
  builder: (yargs) => withFirstReleaseOptions((0, shared_options_1.withRunManyOptions)((0, shared_options_1.withOutputStyleOption)(yargs))
183
183
  .option('registry', {
184
184
  type: 'string',
185
- description: 'The registry to publish to',
185
+ description: 'The registry to publish to.',
186
186
  })
187
187
  .option('tag', {
188
188
  type: 'string',
189
- description: 'The distribution tag to apply to the published package',
189
+ description: 'The distribution tag to apply to the published package.',
190
190
  })
191
191
  .option('access', {
192
192
  type: 'string',
@@ -195,7 +195,7 @@ const publishCommand = {
195
195
  })
196
196
  .option('otp', {
197
197
  type: 'number',
198
- description: 'A one-time password for publishing to a registry that requires 2FA',
198
+ description: 'A one-time password for publishing to a registry that requires 2FA.',
199
199
  })),
200
200
  handler: async (args) => {
201
201
  const status = await (await Promise.resolve().then(() => require('./publish'))).releasePublishCLIHandler(coerceParallelOption((0, shared_options_1.withOverrides)(args, 2)));
@@ -208,7 +208,7 @@ const publishCommand = {
208
208
  const planCommand = {
209
209
  command: 'plan [bump]',
210
210
  aliases: ['pl'],
211
- describe: 'Create a version plan file to specify the desired semver bump for one or more projects or groups, as well as the relevant changelog entry',
211
+ describe: 'Create a version plan file to specify the desired semver bump for one or more projects or groups, as well as the relevant changelog entry.',
212
212
  builder: (yargs) => (0, shared_options_1.withAffectedOptions)(yargs)
213
213
  .positional('bump', {
214
214
  type: 'string',
@@ -226,11 +226,11 @@ const planCommand = {
226
226
  .option('message', {
227
227
  type: 'string',
228
228
  alias: 'm',
229
- describe: 'Custom message to use for the changelog entry',
229
+ describe: 'Custom message to use for the changelog entry.',
230
230
  })
231
231
  .option('onlyTouched', {
232
232
  type: 'boolean',
233
- describe: 'Only include projects that have been affected by the current changes',
233
+ describe: 'Only include projects that have been affected by the current changes.',
234
234
  default: true,
235
235
  }),
236
236
  handler: async (args) => {
@@ -244,7 +244,7 @@ const planCommand = {
244
244
  };
245
245
  const planCheckCommand = {
246
246
  command: 'plan:check',
247
- describe: 'Ensure that all touched projects have an applicable version plan created for them',
247
+ describe: 'Ensure that all touched projects have an applicable version plan created for them.',
248
248
  builder: (yargs) => (0, shared_options_1.withAffectedOptions)(yargs),
249
249
  handler: async (args) => {
250
250
  const release = await Promise.resolve().then(() => require('./plan-check'));
@@ -261,7 +261,7 @@ function coerceParallelOption(args) {
261
261
  function withGitCommitAndGitTagOptions(yargs) {
262
262
  return yargs
263
263
  .option('git-commit', {
264
- describe: 'Whether or not to automatically commit the changes made by this command',
264
+ describe: 'Whether or not to automatically commit the changes made by this command.',
265
265
  type: 'boolean',
266
266
  })
267
267
  .option('git-commit-message', {
@@ -269,11 +269,11 @@ function withGitCommitAndGitTagOptions(yargs) {
269
269
  type: 'string',
270
270
  })
271
271
  .option('git-commit-args', {
272
- describe: 'Additional arguments (added after the --message argument, which may or may not be customized with --git-commit-message) to pass to the `git commit` command invoked behind the scenes',
272
+ describe: 'Additional arguments (added after the --message argument, which may or may not be customized with --git-commit-message) to pass to the `git commit` command invoked behind the scenes.',
273
273
  type: 'string',
274
274
  })
275
275
  .option('git-tag', {
276
- describe: 'Whether or not to automatically tag the changes made by this command',
276
+ describe: 'Whether or not to automatically tag the changes made by this command.',
277
277
  type: 'boolean',
278
278
  })
279
279
  .option('git-tag-message', {
@@ -281,7 +281,7 @@ function withGitCommitAndGitTagOptions(yargs) {
281
281
  type: 'string',
282
282
  })
283
283
  .option('git-tag-args', {
284
- describe: 'Additional arguments to pass to the `git tag` command invoked behind the scenes',
284
+ describe: 'Additional arguments to pass to the `git tag` command invoked behind the scenes.',
285
285
  type: 'string',
286
286
  })
287
287
  .option('stage-changes', {
@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.yargsReportCommand = void 0;
4
4
  exports.yargsReportCommand = {
5
5
  command: 'report',
6
- describe: 'Reports useful version numbers to copy into the Nx issue template',
6
+ describe: 'Reports useful version numbers to copy into the Nx issue template.',
7
7
  handler: async () => {
8
8
  await (await Promise.resolve().then(() => require('./report'))).reportHandler();
9
9
  process.exit(0);
@@ -19,7 +19,7 @@ exports.yargsResetCommand = {
19
19
  type: 'boolean',
20
20
  })
21
21
  .option('onlyWorkspaceData', {
22
- description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc)',
22
+ description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc).',
23
23
  type: 'boolean',
24
24
  }),
25
25
  handler: async (argv) => (await Promise.resolve().then(() => require('./reset'))).resetHandler(argv),
@@ -27,7 +27,7 @@ exports.yargsRunCommand = {
27
27
  exports.yargsNxInfixCommand = {
28
28
  ...exports.yargsRunCommand,
29
29
  command: '$0 <target> [project] [_..]',
30
- describe: 'Run a target for a project',
30
+ describe: 'Run a target for a project.',
31
31
  handler: async (args) => {
32
32
  const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {
33
33
  // Yargs parses <target> as 'undefined' if running just 'nx'
@@ -6,7 +6,7 @@ const shared_options_1 = require("../yargs-utils/shared-options");
6
6
  const params_1 = require("../../utils/params");
7
7
  exports.yargsRunManyCommand = {
8
8
  command: 'run-many',
9
- describe: 'Run target for multiple listed projects',
9
+ describe: 'Run target for multiple listed projects.',
10
10
  builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withRunManyOptions)((0, shared_options_1.withOutputStyleOption)((0, shared_options_1.withTargetAndConfigurationOption)((0, shared_options_1.withBatch)(yargs)))), 'run-many'),
11
11
  handler: async (args) => {
12
12
  const exitCode = await (0, params_1.handleErrors)(args.verbose ?? process.env.NX_VERBOSE_LOGGING === 'true', async () => {