nx 24.0.6 → 24.1.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/dist/bin/init-local.js +2 -4
  2. package/dist/bin/nx-cloud.js +2 -1
  3. package/dist/bin/nx.js +12 -14
  4. package/dist/bin/run-executor.js +5 -0
  5. package/dist/src/adapter/compat.d.ts +1 -1
  6. package/dist/src/adapter/compat.js +1 -0
  7. package/dist/src/adapter/ngcli-adapter.js +7 -20
  8. package/dist/src/command-line/completion/scripts/bash.sh +9 -2
  9. package/dist/src/command-line/completion/scripts/fish.fish +10 -2
  10. package/dist/src/command-line/completion/scripts/zsh.zsh +8 -2
  11. package/dist/src/command-line/completion/scripts.js +18 -8
  12. package/dist/src/command-line/configure-ai-agents/configure-ai-agents.js +0 -1
  13. package/dist/src/command-line/conformance/command-object.d.ts +3 -0
  14. package/dist/src/command-line/conformance/command-object.js +66 -0
  15. package/dist/src/command-line/generate/generate.js +14 -27
  16. package/dist/src/command-line/generate/generator-utils.d.ts +1 -0
  17. package/dist/src/command-line/generate/generator-utils.js +9 -0
  18. package/dist/src/command-line/graph/graph.js +1 -7
  19. package/dist/src/command-line/import/import.js +26 -2
  20. package/dist/src/command-line/import/utils/ai-output.d.ts +9 -1
  21. package/dist/src/command-line/import/utils/ai-output.js +20 -1
  22. package/dist/src/command-line/import/utils/prepare-source-repo.js +0 -3
  23. package/dist/src/command-line/init/implementation/angular/standalone-workspace.js +2 -2
  24. package/dist/src/command-line/init/init-v2.js +2 -2
  25. package/dist/src/command-line/migrate/migrate.js +1 -4
  26. package/dist/src/command-line/migrate/prompt-files.js +5 -5
  27. package/dist/src/command-line/migrate/run/orchestrator.js +2 -3
  28. package/dist/src/command-line/migrate/run/worker.js +7 -5
  29. package/dist/src/command-line/migrate/run-migration-process.js +3 -2
  30. package/dist/src/command-line/nx-commands.d.ts +1 -1
  31. package/dist/src/command-line/nx-commands.js +82 -132
  32. package/dist/src/command-line/release/changelog.js +8 -39
  33. package/dist/src/command-line/release/command-object.d.ts +1 -0
  34. package/dist/src/command-line/release/command-object.js +4 -0
  35. package/dist/src/command-line/release/config/use-legacy-versioning.js +1 -1
  36. package/dist/src/command-line/release/release.js +6 -4
  37. package/dist/src/command-line/release/utils/diff.js +0 -14
  38. package/dist/src/command-line/release/utils/git.js +1 -1
  39. package/dist/src/command-line/release/utils/resolve-nx-json-error-message.js +2 -24
  40. package/dist/src/command-line/report/report.js +1 -1
  41. package/dist/src/command-line/run/executor-utils.js +1 -1
  42. package/dist/src/command-line/show/show-target/utils.js +1 -1
  43. package/dist/src/command-line/watch/watch.js +1 -1
  44. package/dist/src/commands-runner/get-command-projects.js +0 -3
  45. package/dist/src/config/misc-interfaces.d.ts +0 -1
  46. package/dist/src/config/nx-json.d.ts +117 -0
  47. package/dist/src/config/workspace-json-project-json.d.ts +6 -7
  48. package/dist/src/core/graph/main.js +1 -1
  49. package/dist/src/core/graph/styles.css +1 -1
  50. package/dist/src/core/graph/styles.js +1 -1
  51. package/dist/src/daemon/server/project-graph-incremental-recomputation.js +13 -20
  52. package/dist/src/devkit-exports.d.ts +1 -1
  53. package/dist/src/devkit-internals.d.ts +11 -4
  54. package/dist/src/devkit-internals.js +27 -5
  55. package/dist/src/executors/run-commands/run-commands.impl.d.ts +1 -1
  56. package/dist/src/executors/run-commands/run-commands.impl.js +35 -13
  57. package/dist/src/hasher/hash-task.js +4 -4
  58. package/dist/src/hasher/task-hasher.js +2 -2
  59. package/dist/src/migrations/update-24-1-0/replace-powerpack-conformance.d.ts +4 -0
  60. package/dist/src/migrations/update-24-1-0/replace-powerpack-conformance.js +117 -0
  61. package/dist/src/migrations/update-24-1-0/replace-powerpack-conformance.md +38 -0
  62. package/dist/src/native/index.d.ts +6 -4
  63. package/dist/src/native/index.js +5 -0
  64. package/dist/src/native/native-bindings.js +1 -0
  65. package/dist/src/native/nx.wasm32-wasi.debug.wasm +0 -0
  66. package/dist/src/native/nx.wasm32-wasi.wasm +0 -0
  67. package/dist/src/native/transform-objects.d.ts +2 -0
  68. package/dist/src/native/transform-objects.js +15 -0
  69. package/dist/src/nx-cloud/utilities/environment.js +0 -17
  70. package/dist/src/plugins/js/lock-file/bun-parser.d.ts +1 -2
  71. package/dist/src/plugins/js/lock-file/bun-parser.js +5 -5
  72. package/dist/src/plugins/js/lock-file/lock-file-names.d.ts +6 -0
  73. package/dist/src/plugins/js/lock-file/lock-file-names.js +16 -0
  74. package/dist/src/plugins/js/lock-file/lock-file.d.ts +1 -2
  75. package/dist/src/plugins/js/lock-file/lock-file.js +24 -31
  76. package/dist/src/plugins/js/lock-file/npm-parser.js +1 -2
  77. package/dist/src/plugins/js/project-graph/affected/npm-packages.js +50 -2
  78. package/dist/src/plugins/js/project-graph/build-dependencies/target-project-locator.d.ts +5 -0
  79. package/dist/src/plugins/js/project-graph/build-dependencies/target-project-locator.js +75 -13
  80. package/dist/src/plugins/js/utils/get-workspace-packages-from-graph.js +1 -1
  81. package/dist/src/plugins/js/utils/register.js +13 -6
  82. package/dist/src/project-graph/affected/affected-tasks.js +1 -1
  83. package/dist/src/project-graph/build-project-graph.js +5 -2
  84. package/dist/src/project-graph/nx-deps-cache.d.ts +3 -2
  85. package/dist/src/project-graph/nx-deps-cache.js +8 -2
  86. package/dist/src/project-graph/utils/project-graph-paths.d.ts +8 -0
  87. package/dist/src/project-graph/utils/project-graph-paths.js +170 -0
  88. package/dist/src/tasks-runner/batch/run-batch.js +3 -13
  89. package/dist/src/tasks-runner/cache.js +19 -18
  90. package/dist/src/tasks-runner/run-command.js +12 -10
  91. package/dist/src/tasks-runner/task-orchestrator.d.ts +1 -0
  92. package/dist/src/tasks-runner/task-orchestrator.js +14 -3
  93. package/dist/src/tasks-runner/utils.js +1 -12
  94. package/dist/src/ultracache/overrides.js +1 -1
  95. package/dist/src/utils/child-process.js +2 -1
  96. package/dist/src/utils/code-frames.js +0 -1
  97. package/dist/src/utils/db-connection.js +6 -4
  98. package/dist/src/utils/find-workspace-root.js +2 -4
  99. package/dist/src/utils/git-utils.d.ts +5 -0
  100. package/dist/src/utils/git-utils.js +23 -1
  101. package/dist/src/utils/handle-import.js +6 -0
  102. package/dist/src/utils/installation-directory.d.ts +16 -0
  103. package/dist/src/utils/installation-directory.js +96 -2
  104. package/dist/src/utils/json.d.ts +7 -0
  105. package/dist/src/utils/json.js +27 -0
  106. package/dist/src/utils/min-release-age/behavior/pnpm.js +9 -9
  107. package/dist/src/utils/min-release-age/behavior/yarn.js +2 -2
  108. package/dist/src/utils/nx-key.js +11 -8
  109. package/dist/src/utils/output.d.ts +5 -0
  110. package/dist/src/utils/output.js +11 -4
  111. package/dist/src/utils/owned-private-dir.d.ts +10 -0
  112. package/dist/src/utils/owned-private-dir.js +28 -0
  113. package/dist/src/utils/plugins/output.js +0 -2
  114. package/dist/src/utils/require-nx-key.js +6 -4
  115. package/dist/src/utils/workspace-root.d.ts +12 -0
  116. package/dist/src/utils/workspace-root.js +56 -7
  117. package/migrations.json +6 -0
  118. package/package.json +14 -12
  119. package/schemas/nx-schema.json +75 -9
  120. package/schemas/project-schema.json +5 -0
@@ -74,12 +74,14 @@ function createAPI(overrideReleaseConfig, ignoreNxJsonConfig) {
74
74
  const shouldCommit = userProvidedReleaseConfig.git?.commit ?? true;
75
75
  const shouldStage = (shouldCommit || userProvidedReleaseConfig.git?.stageChanges) ?? false;
76
76
  const shouldTag = userProvidedReleaseConfig.git?.tag ?? true;
77
+ const shouldPushFromGitConfig = args.gitPush ?? nxReleaseConfig.git.push;
77
78
  const shouldCreateWorkspaceRemoteRelease = shouldCreateRemoteRelease(nxReleaseConfig.changelog.workspaceChangelog);
78
79
  const { workspaceVersion, projectsVersionData, releaseGraph, } = await releaseVersion({
79
80
  ...args,
80
81
  stageChanges: shouldStage,
81
82
  gitCommit: false,
82
83
  gitTag: false,
84
+ gitPush: false,
83
85
  deleteVersionPlans: false,
84
86
  });
85
87
  // Suppress the filter log for the changelog command as it would have already been printed by the version command
@@ -185,10 +187,10 @@ function createAPI(overrideReleaseConfig, ignoreNxJsonConfig) {
185
187
  }
186
188
  }
187
189
  let hasPushedChanges = false;
188
- // If the workspace or any of the release groups specify that a remote release should be created, we need to push the changes to the remote
189
- const shouldPush = (shouldCreateWorkspaceRemoteRelease ||
190
- releaseGraph.releaseGroups.some((group) => shouldCreateRemoteRelease(group.changelog))) ??
191
- false;
190
+ // Push the release commit and tags when git push is enabled, or when a remote release needs them on the remote.
191
+ const shouldPush = shouldPushFromGitConfig ||
192
+ shouldCreateWorkspaceRemoteRelease ||
193
+ releaseGraph.releaseGroups.some((group) => shouldCreateRemoteRelease(group.changelog));
192
194
  if (shouldPush) {
193
195
  output_1.output.logSingleLine(`Pushing to git remote "origin"`);
194
196
  await (0, git_1.gitPush)({
@@ -47,8 +47,6 @@ function diffLinesRaw(aLines, bLines) {
47
47
  }
48
48
  function formatNoExpand(diffs, contextLines, aColor, bColor, patchColor) {
49
49
  const lines = [];
50
- let aLine = 0;
51
- let bLine = 0;
52
50
  // Group diffs into hunks with context
53
51
  const hunks = [];
54
52
  let currentHunk = null;
@@ -61,8 +59,6 @@ function formatNoExpand(diffs, contextLines, aColor, bColor, patchColor) {
61
59
  if (!currentHunk) {
62
60
  const contextStart = Math.max(0, i - contextLines);
63
61
  currentHunk = {
64
- aStart: aLine - (i - contextStart),
65
- bStart: bLine - (i - contextStart),
66
62
  lines: [],
67
63
  };
68
64
  // Add leading context
@@ -104,16 +100,6 @@ function formatNoExpand(diffs, contextLines, aColor, bColor, patchColor) {
104
100
  }
105
101
  }
106
102
  }
107
- if (type === DIFF_DELETE) {
108
- aLine++;
109
- }
110
- else if (type === DIFF_INSERT) {
111
- bLine++;
112
- }
113
- else {
114
- aLine++;
115
- bLine++;
116
- }
117
103
  }
118
104
  if (currentHunk) {
119
105
  hunks.push(currentHunk);
@@ -534,7 +534,7 @@ function parseGitCommit(commit) {
534
534
  }
535
535
  // Find all authors
536
536
  const authors = getAllAuthorsForCommit(commit);
537
- const affectedFiles = Array.from((commit.nameStatus ?? '').matchAll(ChangedFileRegex)).reduce((prev, [fullLine, changeType, file1, file2]) =>
537
+ const affectedFiles = Array.from((commit.nameStatus ?? '').matchAll(ChangedFileRegex)).reduce((prev, [, , file1, file2]) =>
538
538
  // file2 only exists for some change types, such as renames
539
539
  file2 ? [...prev, file1, file2] : [...prev, file1], []);
540
540
  return {
@@ -4,6 +4,7 @@ exports.resolveNxJsonConfigErrorMessage = resolveNxJsonConfigErrorMessage;
4
4
  const node_fs_1 = require("node:fs");
5
5
  const node_path_1 = require("node:path");
6
6
  const handle_import_1 = require("../../../utils/handle-import");
7
+ const json_1 = require("../../../utils/json");
7
8
  const path_1 = require("../../../utils/path");
8
9
  const workspace_root_1 = require("../../../utils/workspace-root");
9
10
  async function resolveNxJsonConfigErrorMessage(propPath) {
@@ -22,32 +23,9 @@ async function getJsonConfigLinesForErrorMessage(rawConfig, jsonPath) {
22
23
  const jsonParser = await (0, handle_import_1.handleImport)('jsonc-parser');
23
24
  const rootNode = jsonParser.parseTree(rawConfig);
24
25
  const node = jsonParser.findNodeAtLocation(rootNode, jsonPath);
25
- return computeJsonLineNumbers(rawConfig, node?.offset, node?.length);
26
+ return (0, json_1.computeJsonLineNumbers)(rawConfig, node?.offset, node?.length);
26
27
  }
27
28
  catch {
28
29
  return null;
29
30
  }
30
31
  }
31
- function computeJsonLineNumbers(inputText, startOffset, characterCount) {
32
- let lines = inputText.split('\n');
33
- let totalChars = 0;
34
- let startLine = 0;
35
- let endLine = 0;
36
- for (let i = 0; i < lines.length; i++) {
37
- totalChars += lines[i].length + 1; // +1 for '\n' character
38
- if (!startLine && totalChars >= startOffset) {
39
- startLine = i + 1; // +1 because arrays are 0-based
40
- }
41
- if (totalChars >= startOffset + characterCount) {
42
- endLine = i + 1; // +1 because arrays are 0-based
43
- break;
44
- }
45
- }
46
- if (!startLine) {
47
- throw new Error('Start offset exceeds the text length');
48
- }
49
- if (!endLine) {
50
- throw new Error('Character count exceeds the text length after start offset');
51
- }
52
- return { startLine, endLine };
53
- }
@@ -394,7 +394,7 @@ function findMisalignedPackagesForPackage(base) {
394
394
  }
395
395
  function findInstalledPowerpackPlugins() {
396
396
  const installedPlugins = (0, installed_plugins_1.findInstalledPlugins)();
397
- return installedPlugins.filter((dep) => new RegExp('@nx/powerpack*|@nx/(.+)-cache|@nx/(conformance|owners|enterprise*)').test(dep.name));
397
+ return installedPlugins.filter((dep) => new RegExp('@nx/powerpack*|@nx/(.+)-cache|@nx/enterprise*').test(dep.name));
398
398
  }
399
399
  function findInstalledCommunityPlugins() {
400
400
  const installedPlugins = (0, installed_plugins_1.findInstalledPlugins)();
@@ -44,7 +44,7 @@ projects) {
44
44
  const batchImplementationFactory = executorConfig.batchImplementation
45
45
  ? (0, schema_utils_1.getImplementationFactory)(executorConfig.batchImplementation, executorsDir, nodeModule, projects)
46
46
  : null;
47
- // TODO(v25): remove custom hasher support.
47
+ // TODO(v25): remove custom hasher support (NXC-5052).
48
48
  const hasherFactory = executorConfig.hasher
49
49
  ? (0, schema_utils_1.getImplementationFactory)(executorConfig.hasher, executorsDir, nodeModule, projects)
50
50
  : null;
@@ -142,7 +142,7 @@ function validateConfiguration(projectName, targetName, configuration, targetCon
142
142
  }
143
143
  }
144
144
  // ── Custom hasher detection ──────────────────────────────────────────
145
- // TODO(v25): remove custom hasher support.
145
+ // TODO(v25): remove custom hasher support (NXC-5052).
146
146
  /**
147
147
  * Checks whether a target's executor defines a custom hasher.
148
148
  * Returns true if the executor has a hasherFactory — meaning the
@@ -88,7 +88,7 @@ class BatchCommandRunner extends BatchFunctionRunner {
88
88
  this._verbose &&
89
89
  output_1.output.logSingleLine('about to run commands with these environments: ' + JSON.stringify(envs));
90
90
  return Promise.all(envs.map((env) => {
91
- return new Promise((resolve, reject) => {
91
+ return new Promise((resolve) => {
92
92
  const commandExec = (0, child_process_1.spawn)(this.command, {
93
93
  stdio: 'inherit',
94
94
  shell: true,
@@ -16,17 +16,14 @@ function getSortedProjects(commandGraph, sortedProjects = []) {
16
16
  return getSortedProjects(newGraph, sortedProjects);
17
17
  }
18
18
  function removeIdsFromGraph(graph, ids, mapWithIds) {
19
- const filteredMapWithIds = {};
20
19
  const dependencies = {};
21
20
  const removedSet = new Set(ids);
22
21
  for (let id of Object.keys(mapWithIds)) {
23
22
  if (!removedSet.has(id)) {
24
- filteredMapWithIds[id] = mapWithIds[id];
25
23
  dependencies[id] = graph.dependencies[id].filter((depId) => !removedSet.has(depId));
26
24
  }
27
25
  }
28
26
  return {
29
- mapWithIds: filteredMapWithIds,
30
27
  dependencies: dependencies,
31
28
  roots: Object.keys(dependencies).filter((k) => dependencies[k].length === 0),
32
29
  };
@@ -23,7 +23,6 @@ export interface GeneratorsJsonEntry {
23
23
  cli?: 'nx';
24
24
  'x-type'?: 'library' | 'application';
25
25
  'x-deprecated'?: string;
26
- 'x-use-standalone-layout'?: boolean;
27
26
  }
28
27
  export type OutputCaptureMethod = 'direct-nodejs' | 'pipe';
29
28
  export interface ExecutorJsonEntryConfig {
@@ -688,6 +688,115 @@ export interface NxReleaseConfiguration {
688
688
  */
689
689
  versionPlans?: NxReleaseVersionPlansConfiguration | boolean;
690
690
  }
691
+ /**
692
+ * Configuration for the `nx conformance` command, provided by `@nx/conformance`.
693
+ */
694
+ export interface NxConformanceConfiguration {
695
+ /**
696
+ * Optional path to write the conformance results to, defaults to "dist/conformance-result.json".
697
+ * Set to false to disable writing the conformance results to a file.
698
+ */
699
+ outputPath?: string | false;
700
+ rules: {
701
+ /**
702
+ * Relative path to a local rule implementation, node_module path or nx-cloud rule ID for Nx Cloud Enterprise.
703
+ */
704
+ rule: string;
705
+ /**
706
+ * Rule specific configuration options.
707
+ */
708
+ options?: Record<string, unknown>;
709
+ /**
710
+ * The projects array allows users to opt in or out of violations for specific projects being reported by the current rule.
711
+ * The array can contain any valid matchers for findMatchingProjects(), by default the implied value is ["*"].
712
+ *
713
+ * We additionally provide an object syntax for projects which allows users to provide by a matcher string and an
714
+ * explanation to communicate to their colleagues why a particular project or projects was included or excluded from
715
+ * consideration from the rule.
716
+ *
717
+ * The explanation currently does nothing to affect any functionality.
718
+ */
719
+ projects?: Array<string | {
720
+ matcher: string;
721
+ explanation: string;
722
+ }>;
723
+ /**
724
+ * Optional explanation field for users to be able to communicate to their colleague why a particular rule is
725
+ * enabled and important to the workspace in question.
726
+ *
727
+ * Currently does nothing to affect any functionality.
728
+ */
729
+ explanation?: string;
730
+ /**
731
+ * Override the default status of the rule, which is "enforced".
732
+ *
733
+ * If set to "evaluated", the rule will be reported as normal, but not enforced (will exit with code 0).
734
+ * If set to "disabled", the rule will not be evaluated at all.
735
+ */
736
+ status?: 'enforced' | 'evaluated' | 'disabled';
737
+ }[];
738
+ }
739
+ type NxOwnersPatternBase = {
740
+ /**
741
+ * Owner IDs for the matched files, or `false` to mark them as having no owners
742
+ * (e.g. files managed by a bot user).
743
+ */
744
+ owners: string[] | false;
745
+ description?: string;
746
+ /**
747
+ * Whether the root `owners.prefix` applies to this pattern. Defaults to `true`.
748
+ */
749
+ applyPrefix?: boolean;
750
+ /**
751
+ * Prefix for this pattern's owners, taking precedence over the root `owners.prefix`.
752
+ */
753
+ prefix?: string;
754
+ };
755
+ type NxOwnersPattern = NxOwnersPatternBase & NxOwnersPatternTarget;
756
+ type NxOwnersSectionPattern = Omit<NxOwnersPatternBase, 'owners'> & Partial<Pick<NxOwnersPatternBase, 'owners'>> & NxOwnersPatternTarget;
757
+ /**
758
+ * When both `projects` and `files` are provided, file patterns are evaluated relative to each
759
+ * matched project root instead of the workspace root.
760
+ */
761
+ type NxOwnersPatternTarget = {
762
+ files: string[];
763
+ } | {
764
+ projects: string[];
765
+ } | {
766
+ projects: string[];
767
+ files: string[];
768
+ };
769
+ /**
770
+ * Configuration for CODEOWNERS generation, provided by `@nx/owners`.
771
+ */
772
+ export interface NxOwnersConfiguration {
773
+ /**
774
+ * Defaults to `github`.
775
+ */
776
+ format?: 'github' | 'gitlab' | 'bitbucket';
777
+ /**
778
+ * Defaults to the format's conventional location, e.g. `.github/CODEOWNERS`.
779
+ */
780
+ outputPath?: string;
781
+ /**
782
+ * Prefix applied to owner strings, e.g. `@org`.
783
+ */
784
+ prefix?: string;
785
+ patterns?: NxOwnersPattern[];
786
+ /**
787
+ * GitLab only. Groups patterns with approval requirements.
788
+ */
789
+ sections?: {
790
+ name: string;
791
+ /**
792
+ * A pattern without `owners` uses the section's `defaultOwners`.
793
+ */
794
+ patterns: NxOwnersSectionPattern[];
795
+ defaultOwners?: string[];
796
+ numberOfRequiredApprovals?: number;
797
+ optional?: boolean;
798
+ }[];
799
+ }
691
800
  export interface NxSyncConfiguration {
692
801
  /**
693
802
  * List of workspace-wide sync generators to be run (not attached to targets).
@@ -935,6 +1044,14 @@ export interface NxJsonConfiguration<T = '*' | string[]> {
935
1044
  * Configuration for the `nx migrate` command.
936
1045
  */
937
1046
  migrate?: NxMigrateConfiguration;
1047
+ /**
1048
+ * Configuration for the `nx conformance` command.
1049
+ */
1050
+ conformance?: NxConformanceConfiguration;
1051
+ /**
1052
+ * Configuration for CODEOWNERS generation. Set to `true` to enable it with defaults.
1053
+ */
1054
+ owners?: NxOwnersConfiguration | boolean;
938
1055
  /**
939
1056
  * Sets the maximum size of the local cache. Accepts a number followed by a unit (e.g. 100MB). Accepted units are B, KB, MB, and GB.
940
1057
  */
@@ -371,13 +371,12 @@ export interface TargetConfiguration<T = any> {
371
371
  */
372
372
  syncGenerators?: string[];
373
373
  /**
374
- * Spread token used when merging target configurations. When set to `true`,
375
- * base (inferred) values take priority over this target's values for any
376
- * shared keys — effectively "only add new keys without overwriting inferred
377
- * values". Keys that do not exist in the base target are still added.
378
- *
379
- * The position of `'...'` in the object's key order follows standard
380
- * last-write-wins semantics with {@link https://nx.dev/reference/project-configuration#spread-token}.
374
+ * Spread token used when merging with a compatible base (inferred) target.
375
+ * Keys before it defer to the base value; keys after it win. In project
376
+ * configuration, a target with a different executor, command or script
377
+ * replaces the base regardless. `options`, `configurations`, `ultracache`
378
+ * and `metadata` merge by their own rules wherever the token sits.
379
+ * See {@link https://nx.dev/reference/project-configuration#spread-token}.
381
380
  */
382
381
  '...'?: true;
383
382
  }