@nx/js 21.4.0-beta.0 → 21.4.0-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/js",
-  "version": "21.4.0-beta.0",
+  "version": "21.4.0-beta.10",
   "private": false,
   "description": "The JS plugin for Nx contains executors and generators that provide the best experience for developing JavaScript and TypeScript projects. ",
   "repository": {
@@ -39,8 +39,8 @@
     "@babel/preset-env": "^7.23.2",
     "@babel/preset-typescript": "^7.22.5",
     "@babel/runtime": "^7.22.6",
-    "@nx/devkit": "21.4.0-beta.0",
-    "@nx/workspace": "21.4.0-beta.0",
+    "@nx/devkit": "21.4.0-beta.10",
+    "@nx/workspace": "21.4.0-beta.10",
     "@zkochan/js-yaml": "0.0.7",
     "babel-plugin-const-enum": "^1.0.1",
     "babel-plugin-macros": "^3.1.0",
@@ -63,7 +63,7 @@
     "tslib": "^2.3.0"
   },
   "devDependencies": {
-    "nx": "21.4.0-beta.0"
+    "nx": "21.4.0-beta.10"
   },
   "peerDependencies": {
     "verdaccio": "^6.0.5"

package/spec/src/executors/node/lib/detect-module-format.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=detect-module-format.spec.d.ts.map

package/spec/src/executors/node/lib/detect-module-format.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-module-format.spec.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/js/src/executors/node/lib/detect-module-format.spec.ts"],"names":[],"mappings":""}

package/spec/src/executors/node/lib/esm-loader.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=esm-loader.spec.d.ts.map

package/spec/src/executors/node/lib/esm-loader.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-loader.spec.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/js/src/executors/node/lib/esm-loader.spec.ts"],"names":[],"mappings":""}

package/spec/src/executors/release-publish/release-publish.impl.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-publish.impl.spec.d.ts.map

package/spec/src/executors/release-publish/release-publish.impl.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-publish.impl.spec.d.ts","sourceRoot":"","sources":["../../../../../../../packages/js/src/executors/release-publish/release-publish.impl.spec.ts"],"names":[],"mappings":""}

package/src/executors/node/lib/detect-module-format.d.ts

@@ -0,0 +1,10 @@
+export type ModuleFormat = 'cjs' | 'esm';
+export interface ModuleFormatDetectionOptions {
+    projectRoot: string;
+    workspaceRoot: string;
+    tsConfig?: string;
+    main: string;
+    buildOptions?: any;
+}
+export declare function detectModuleFormat(options: ModuleFormatDetectionOptions): ModuleFormat;
+//# sourceMappingURL=detect-module-format.d.ts.map

package/src/executors/node/lib/detect-module-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-module-format.d.ts","sourceRoot":"","sources":["../../../../../../../packages/js/src/executors/node/lib/detect-module-format.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,4BAA4B,GACpC,YAAY,CAiEd"}

package/src/executors/node/lib/detect-module-format.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectModuleFormat = detectModuleFormat;
+const devkit_1 = require("@nx/devkit");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const ts_config_1 = require("../../../utils/typescript/ts-config");
+const ts = require("typescript");
+function detectModuleFormat(options) {
+    if (options.buildOptions?.format) {
+        const formats = Array.isArray(options.buildOptions.format)
+            ? options.buildOptions.format
+            : [options.buildOptions.format];
+        if (formats.includes('esm')) {
+            return 'esm';
+        }
+        if (formats.includes('cjs')) {
+            return 'cjs';
+        }
+    }
+    if (options.main.endsWith('.mjs')) {
+        return 'esm';
+    }
+    if (options.main.endsWith('.cjs')) {
+        return 'cjs';
+    }
+    const packageJsonPath = (0, path_1.join)(options.workspaceRoot, options.projectRoot, 'package.json');
+    if ((0, fs_1.existsSync)(packageJsonPath)) {
+        try {
+            const packageJson = (0, devkit_1.readJsonFile)(packageJsonPath);
+            if (packageJson.type === 'module') {
+                return 'esm';
+            }
+            if (packageJson.type === 'commonjs') {
+                return 'cjs';
+            }
+        }
+        catch {
+            // Continue to next detection method
+        }
+    }
+    if (options.tsConfig && (0, fs_1.existsSync)(options.tsConfig)) {
+        try {
+            const tsConfig = (0, ts_config_1.readTsConfig)(options.tsConfig);
+            if (tsConfig.options.module === ts.ModuleKind.ES2015 ||
+                tsConfig.options.module === ts.ModuleKind.ES2020 ||
+                tsConfig.options.module === ts.ModuleKind.ES2022 ||
+                tsConfig.options.module === ts.ModuleKind.ESNext ||
+                tsConfig.options.module === ts.ModuleKind.NodeNext) {
+                // For NodeNext, we need to check moduleResolution
+                if (tsConfig.options.module === ts.ModuleKind.NodeNext) {
+                    // NodeNext uses package.json type field, which we already checked
+                    // Default to CJS if no type field
+                    return 'cjs';
+                }
+                return 'esm';
+            }
+        }
+        catch {
+            // Continue to default
+        }
+    }
+    return 'cjs';
+}

package/src/executors/node/lib/esm-loader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Custom ESM resolver for Node.js that handles Nx workspace library mappings.
+ *
+ * This resolver is necessary because:
+ * 1. Node.js ESM resolution doesn't understand TypeScript path mappings (e.g., @myorg/mylib)
+ * 2. Nx workspace libraries need to be resolved to their actual built output locations
+ * 3. The built output might be in different formats (.js, .mjs) or locations (index.js)
+ *
+ * The resolver intercepts import requests for workspace libraries and maps them to their
+ * actual file system locations based on the NX_MAPPINGS environment variable set by
+ * the Node executor.
+ */
+export declare function resolve(specifier: string, context: any, nextResolve: any): Promise<any>;
+//# sourceMappingURL=esm-loader.d.ts.map

package/src/executors/node/lib/esm-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-loader.d.ts","sourceRoot":"","sources":["../../../../../../../packages/js/src/executors/node/lib/esm-loader.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,WAAW,EAAE,GAAG,gBA0CjB"}

package/src/executors/node/lib/esm-loader.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolve = resolve;
+const node_url_1 = require("node:url");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Custom ESM resolver for Node.js that handles Nx workspace library mappings.
+ *
+ * This resolver is necessary because:
+ * 1. Node.js ESM resolution doesn't understand TypeScript path mappings (e.g., @myorg/mylib)
+ * 2. Nx workspace libraries need to be resolved to their actual built output locations
+ * 3. The built output might be in different formats (.js, .mjs) or locations (index.js)
+ *
+ * The resolver intercepts import requests for workspace libraries and maps them to their
+ * actual file system locations based on the NX_MAPPINGS environment variable set by
+ * the Node executor.
+ */
+async function resolve(specifier, context, nextResolve) {
+    // Parse mappings on each call to ensure we get the latest values
+    const mappings = JSON.parse(process.env.NX_MAPPINGS || '{}');
+    const mappingKeys = Object.keys(mappings);
+    // Check if this is a workspace library mapping
+    const matchingKey = mappingKeys.find((key) => specifier === key || specifier.startsWith(key + '/'));
+    if (matchingKey) {
+        const mappedPath = mappings[matchingKey];
+        const restOfPath = specifier.slice(matchingKey.length);
+        const fullPath = (0, node_path_1.join)(mappedPath, restOfPath);
+        // Try to resolve the mapped path as a file first
+        if ((0, node_fs_1.existsSync)(fullPath)) {
+            const stats = (0, node_fs_1.statSync)(fullPath);
+            if (stats.isFile()) {
+                return nextResolve((0, node_url_1.pathToFileURL)(fullPath).href, context);
+            }
+        }
+        // Try with index.js
+        const indexPath = (0, node_path_1.join)(fullPath, 'index.js');
+        if ((0, node_fs_1.existsSync)(indexPath)) {
+            return nextResolve((0, node_url_1.pathToFileURL)(indexPath).href, context);
+        }
+        const jsPath = fullPath + '.js';
+        if ((0, node_fs_1.existsSync)(jsPath)) {
+            return nextResolve((0, node_url_1.pathToFileURL)(jsPath).href, context);
+        }
+        const mjsPath = fullPath + '.mjs';
+        if ((0, node_fs_1.existsSync)(mjsPath)) {
+            return nextResolve((0, node_url_1.pathToFileURL)(mjsPath).href, context);
+        }
+    }
+    return nextResolve(specifier, context);
+}

package/src/executors/node/node-with-esm-loader.d.ts

@@ -0,0 +1,6 @@
+declare const pathToFileURL: any;
+declare const register: any;
+declare const path: any;
+declare const dynamicImportEsm: Function;
+declare function main(): Promise<void>;
+//# sourceMappingURL=node-with-esm-loader.d.ts.map

package/src/executors/node/node-with-esm-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-with-esm-loader.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/executors/node/node-with-esm-loader.ts"],"names":[],"mappings":"AAAA,QAAA,MAAQ,aAAa,KAAwB,CAAC;AAC9C,QAAA,MAAQ,QAAQ,KAA2B,CAAC;AAC5C,QAAA,MAAM,IAAI,KAAuB,CAAC;AAGlC,QAAA,MAAM,gBAAgB,UAAwD,CAAC;AAE/E,iBAAe,IAAI,kBAkBlB"}

package/src/executors/node/node-with-esm-loader.js

@@ -0,0 +1,25 @@
+const { pathToFileURL } = require('node:url');
+const { register } = require('node:module');
+const path = require('node:path');
+// Dynamic import helper to prevent TypeScript from transforming it
+const dynamicImportEsm = new Function('specifier', 'return import(specifier)');
+async function main() {
+    try {
+        // Register ESM loader for workspace path mappings
+        register(path.join(__dirname, 'lib', 'esm-loader.js'), pathToFileURL(__filename));
+        // Import and run the file
+        const fileToRun = process.env.NX_FILE_TO_RUN;
+        if (!fileToRun) {
+            throw new Error('NX_FILE_TO_RUN environment variable not set');
+        }
+        await dynamicImportEsm(pathToFileURL(fileToRun).href);
+    }
+    catch (error) {
+        console.error('ESM loader error:', error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});

package/src/executors/node/node.impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.impl.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/executors/node/node.impl.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EAQhB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAe,mBAAmB,EAAE,MAAM,UAAU,CAAC;AA4C5D,wBAAuB,YAAY,CACjC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,eAAe;aAqDb,OAAO;cACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;cAuNhC;AA+HD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"node.impl.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/executors/node/node.impl.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EAQhB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAe,mBAAmB,EAAE,MAAM,UAAU,CAAC;AA6C5D,wBAAuB,YAAY,CACjC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,eAAe;aAgEb,OAAO;cACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;cA4NhC;AA+HD,eAAe,YAAY,CAAC"}

package/src/executors/node/node.impl.js

@@ -14,6 +14,7 @@ const kill_tree_1 = require("./lib/kill-tree");
 const fileutils_1 = require("nx/src/utils/fileutils");
 const get_main_file_dir_1 = require("../../utils/get-main-file-dir");
 const utils_1 = require("nx/src/tasks-runner/utils");
+const detect_module_format_1 = require("./lib/detect-module-format");
 function debounce(fn, wait) {
     let timeoutId;
     let pendingPromise = null;
@@ -67,6 +68,15 @@ async function* nodeExecutor(options, context) {
     // Re-map buildable workspace projects to their output directory.
     const mappings = calculateResolveMappings(context, options);
     const fileToRun = getFileToRun(context, project, buildOptions, buildTargetExecutor);
+    // Detect module format for the project
+    const moduleFormat = (0, detect_module_format_1.detectModuleFormat)({
+        projectRoot: project.data.root,
+        workspaceRoot: context.root,
+        tsConfig: buildOptions.tsConfig ||
+            (0, path_1.join)(context.root, project.data.root, 'tsconfig.json'),
+        main: buildOptions.main || fileToRun,
+        buildOptions,
+    });
     let additionalExitHandler = null;
     let currentTask = null;
     const tasks = [];
@@ -108,7 +118,10 @@ async function* nodeExecutor(options, context) {
                         return;
                     // Run the program
                     task.promise = new Promise((resolve, reject) => {
-                        task.childProcess = (0, child_process_1.fork)((0, devkit_1.joinPathFragments)(__dirname, 'node-with-require-overrides'), options.args ?? [], {
+                        const loaderFile = moduleFormat === 'esm'
+                            ? 'node-with-esm-loader'
+                            : 'node-with-require-overrides';
+                        task.childProcess = (0, child_process_1.fork)((0, devkit_1.joinPathFragments)(__dirname, loaderFile), options.args ?? [], {
                             execArgv: getExecArgv(options),
                             stdio: [0, 1, 'pipe', 'ipc'],
                             env: {

package/src/executors/release-publish/release-publish.impl.js

@@ -155,10 +155,10 @@ Please update the local dependency on "${depName}" to be a valid semantic versio
                             !(err.stderr?.toString().includes('E404') &&
                                 err.stderr?.toString().includes('no such package available'))) {
                             console.error('npm dist-tag add error:');
-                            if (stdoutData.error.summary) {
+                            if (stdoutData.error?.summary) {
                                 console.error(stdoutData.error.summary);
                             }
-                            if (stdoutData.error.detail) {
+                            if (stdoutData.error?.detail) {
                                 console.error(stdoutData.error.detail);
                             }
                             if (context.isVerbose) {

package/src/generators/library/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/generators/library/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,iBAAiB,EAYjB,IAAI,EAKL,MAAM,YAAY,CAAC;AAwCpB,OAAO,KAAK,EAEV,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,UAAU,CAAC;AASlB,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,sBAAsB,8BAO/B;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,sBAAsB,8BAoL/B;AA4HD,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,iCAAiC,EAC/B,MAAM,GACN,QAAQ,GACR,aAAa,GACb,gBAAgB,GAChB,IAAI,GACJ,yBAAyB,GACzB,aAAa,GACb,SAAS,GACT,WAAW,CACd,CAAC;AAEF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAqG5B;AA4vBD,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/generators/library/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,iBAAiB,EAYjB,IAAI,EAKL,MAAM,YAAY,CAAC;AAyCpB,OAAO,KAAK,EAEV,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,UAAU,CAAC;AASlB,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,sBAAsB,8BAO/B;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,sBAAsB,8BAsL/B;AA4HD,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,iCAAiC,EAC/B,MAAM,GACN,QAAQ,GACR,aAAa,GACb,gBAAgB,GAChB,IAAI,GACJ,yBAAyB,GACzB,aAAa,GACb,SAAS,GACT,WAAW,CACd,CAAC;AAEF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAqG5B;AA4vBD,eAAe,gBAAgB,CAAC"}

package/src/generators/library/library.js

@@ -34,11 +34,13 @@ async function libraryGenerator(tree, schema) {
 }
 async function libraryGeneratorInternal(tree, schema) {
     const tasks = [];
+    const addTsPlugin = (0, ts_solution_setup_1.shouldConfigureTsSolutionSetup)(tree, schema.addPlugin);
     tasks.push(await (0, init_1.default)(tree, {
         ...schema,
         skipFormat: true,
         tsConfigName: schema.rootProject ? 'tsconfig.json' : 'tsconfig.base.json',
         addTsConfigBase: true,
+        addTsPlugin,
         // In the new setup, Prettier is prompted for and installed during `create-nx-workspace`.
         formatter: (0, ts_solution_setup_1.isUsingTsSolutionSetup)(tree) ? 'none' : 'prettier',
     }));

package/src/generators/typescript-sync/typescript-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-sync.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/generators/typescript-sync/typescript-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAIpB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AA0CtC,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyM5E;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"typescript-sync.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/generators/typescript-sync/typescript-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AAIpB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AAuCtC,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgO5E;AAED,eAAe,aAAa,CAAC"}

package/src/generators/typescript-sync/typescript-sync.js

@@ -22,7 +22,6 @@ async function syncGenerator(tree) {
         composite: new Map(),
         content: new Map(),
         exists: new Map(),
-        isFile: new Map(),
     };
     // Root tsconfig containing project references for the whole workspace
     const rootTsconfigPath = 'tsconfig.json';
@@ -63,18 +62,18 @@ async function syncGenerator(tree) {
     // made by this generator to know if the TS config is out of sync with the
     // project graph. Therefore, we don't format the files if there were no changes
     // to avoid potential format-only changes that can lead to false positives.
-    let hasChanges = false;
+    const changedFiles = new Map();
     if (tsconfigProjectNodeValues.length > 0) {
         const referencesSet = new Set();
         for (const ref of rootTsconfig.references ?? []) {
             // reference path is relative to the tsconfig file
-            const resolvedRefPath = getTsConfigPathFromReferencePath(tree, rootTsconfigPath, ref.path, tsconfigInfoCaches);
+            const resolvedRefPath = getTsConfigPathFromReferencePath(rootTsconfigPath, ref.path);
             if (tsconfigExists(tree, tsconfigInfoCaches, resolvedRefPath)) {
                 // we only keep the references that still exist
                 referencesSet.add(normalizeReferencePath(ref.path));
             }
             else {
-                hasChanges = true;
+                addChangedFile(changedFiles, rootTsconfigPath, resolvedRefPath, 'stale');
             }
         }
         for (const node of tsconfigProjectNodeValues) {
@@ -82,10 +81,10 @@ async function syncGenerator(tree) {
             // Skip the root tsconfig itself
             if (node.data.root !== '.' && !referencesSet.has(normalizedPath)) {
                 referencesSet.add(normalizedPath);
-                hasChanges = true;
+                addChangedFile(changedFiles, rootTsconfigPath, toFullProjectReferencePath(node.data.root), 'missing');
             }
         }
-        if (hasChanges) {
+        if (changedFiles.size > 0) {
             const updatedReferences = Array.from(referencesSet)
                 // Check composite is true in the internal reference before proceeding
                 .filter((ref) => hasCompositeEnabled(tsSysFromTree, tsconfigInfoCaches, (0, devkit_1.joinPathFragments)(ref, 'tsconfig.json')))
@@ -101,7 +100,7 @@ async function syncGenerator(tree) {
             COMMON_RUNTIME_TS_CONFIG_FILE_NAMES,
     };
     const collectedDependencies = new Map();
-    for (const [projectName, data] of Object.entries(projectGraph.dependencies)) {
+    for (const projectName of Object.keys(projectGraph.dependencies)) {
         if (!projectGraph.nodes[projectName] ||
             projectGraph.nodes[projectName].data.root === '.') {
             continue;
@@ -124,17 +123,26 @@ async function syncGenerator(tree) {
                 continue;
             }
             // Update project references for the runtime tsconfig
-            hasChanges =
-                updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, runtimeTsConfigPath, dependencies, sourceProjectNode.data.root, projectRoots, runtimeTsConfigFileName, runtimeTsConfigFileNames) || hasChanges;
+            updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, runtimeTsConfigPath, dependencies, sourceProjectNode.data.root, projectRoots, changedFiles, runtimeTsConfigFileName, runtimeTsConfigFileNames);
         }
         // Update project references for the tsconfig.json file
-        hasChanges =
-            updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, sourceProjectTsconfigPath, dependencies, sourceProjectNode.data.root, projectRoots) || hasChanges;
+        updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, sourceProjectTsconfigPath, dependencies, sourceProjectNode.data.root, projectRoots, changedFiles);
     }
-    if (hasChanges) {
+    if (changedFiles.size > 0) {
         await (0, devkit_1.formatFiles)(tree);
+        const outOfSyncDetails = [];
+        for (const [filePath, details] of changedFiles) {
+            outOfSyncDetails.push(`${filePath}:`);
+            if (details.missing.size > 0) {
+                outOfSyncDetails.push(`  - Missing references: ${Array.from(details.missing).join(', ')}`);
+            }
+            if (details.stale.size > 0) {
+                outOfSyncDetails.push(`  - Stale references: ${Array.from(details.stale).join(', ')}`);
+            }
+        }
         return {
-            outOfSyncMessage: 'Some TypeScript configuration files are missing project references to the projects they depend on or contain outdated project references.',
+            outOfSyncMessage: 'Some TypeScript configuration files are missing project references to the projects they depend on or contain stale project references.',
+            outOfSyncDetails,
         };
     }
 }
@@ -159,7 +167,7 @@ function tsconfigExists(tree, tsconfigInfoCaches, tsconfigPath) {
     }
     return tsconfigInfoCaches.exists.get(tsconfigPath);
 }
-function updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, tsConfigPath, dependencies, projectRoot, projectRoots, runtimeTsConfigFileName, possibleRuntimeTsConfigFileNames) {
+function updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, tsConfigPath, dependencies, projectRoot, projectRoots, changedFiles, runtimeTsConfigFileName, possibleRuntimeTsConfigFileNames) {
     const stringifiedJsonContents = readRawTsconfigContents(tree, tsconfigInfoCaches, tsConfigPath);
     const tsConfig = (0, devkit_1.parseJson)(stringifiedJsonContents);
     const ignoredReferences = new Set(tsConfig.nx?.sync?.ignoredReferences ?? []);
@@ -177,13 +185,16 @@ function updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, tsCon
             continue;
         }
         // reference path is relative to the tsconfig file
-        const resolvedRefPath = getTsConfigPathFromReferencePath(tree, tsConfigPath, ref.path, tsconfigInfoCaches);
-        if (isProjectReferenceWithinNxProject(tree, tsconfigInfoCaches, resolvedRefPath, projectRoot, projectRoots) ||
+        const resolvedRefPath = getTsConfigPathFromReferencePath(tsConfigPath, ref.path);
+        if (isProjectReferenceWithinNxProject(resolvedRefPath, projectRoot, projectRoots) ||
             isProjectReferenceIgnored(tree, resolvedRefPath)) {
             // we keep all references within the current Nx project or that are ignored
             references.push(ref);
             newReferencesSet.add(normalizedPath);
         }
+        if (!newReferencesSet.has(normalizedPath)) {
+            addChangedFile(changedFiles, tsConfigPath, resolvedRefPath, 'stale');
+        }
     }
     let hasChanges = false;
     for (const dep of dependencies) {
@@ -238,13 +249,13 @@ function updateTsConfigReferences(tree, tsSysFromTree, tsconfigInfoCaches, tsCon
         }
         if (!originalReferencesSet.has(relativePathToTargetRoot)) {
             hasChanges = true;
+            addChangedFile(changedFiles, tsConfigPath, toFullProjectReferencePath(referencePath), 'missing');
         }
     }
     hasChanges ||= newReferencesSet.size !== originalReferencesSet.size;
     if (hasChanges) {
         patchTsconfigJsonReferences(tree, tsconfigInfoCaches, tsConfigPath, references);
     }
-    return hasChanges;
 }
 // TODO(leo): follow up with the TypeScript team to confirm if we really need
 // to reference transitive dependencies.
@@ -288,8 +299,14 @@ function normalizeReferencePath(path) {
         .replace(/\/tsconfig.json$/, '')
         .replace(/^\.\//, '');
 }
-function isProjectReferenceWithinNxProject(tree, tsconfigInfoCaches, refTsConfigPath, projectRoot, projectRoots) {
-    let currentPath = getTsConfigDirName(tree, tsconfigInfoCaches, refTsConfigPath);
+function toFullProjectReferencePath(path) {
+    const normalizedPath = normalizeReferencePath(path);
+    return normalizedPath.endsWith('.json')
+        ? normalizedPath
+        : (0, devkit_1.joinPathFragments)(normalizedPath, 'tsconfig.json');
+}
+function isProjectReferenceWithinNxProject(refTsConfigPath, projectRoot, projectRoots) {
+    let currentPath = getTsConfigDirName(refTsConfigPath);
     if ((0, posix_1.relative)(projectRoot, currentPath).startsWith('..')) {
         // it's outside of the project root, so it's an external project reference
         return false;
@@ -315,14 +332,14 @@ function isProjectReferenceIgnored(tree, refTsConfigPath) {
     }
     return ig.ignores(refTsConfigPath);
 }
-function getTsConfigDirName(tree, tsconfigInfoCaches, tsConfigPath) {
-    return tsconfigIsFile(tree, tsconfigInfoCaches, tsConfigPath)
+function getTsConfigDirName(tsConfigPath) {
+    return tsConfigPath.endsWith('.json')
         ? (0, posix_1.dirname)(tsConfigPath)
         : (0, posix_1.normalize)(tsConfigPath);
 }
-function getTsConfigPathFromReferencePath(tree, ownerTsConfigPath, referencePath, tsconfigInfoCaches) {
+function getTsConfigPathFromReferencePath(ownerTsConfigPath, referencePath) {
     const resolvedRefPath = (0, devkit_1.joinPathFragments)((0, posix_1.dirname)(ownerTsConfigPath), referencePath);
-    return tsconfigIsFile(tree, tsconfigInfoCaches, resolvedRefPath)
+    return resolvedRefPath.endsWith('.json')
         ? resolvedRefPath
         : (0, devkit_1.joinPathFragments)(resolvedRefPath, 'tsconfig.json');
 }
@@ -344,15 +361,9 @@ function hasCompositeEnabled(tsSysFromTree, tsconfigInfoCaches, tsconfigPath) {
     }
     return tsconfigInfoCaches.composite.get(tsconfigPath);
 }
-function tsconfigIsFile(tree, tsconfigInfoCaches, tsconfigPath) {
-    if (tsconfigInfoCaches.isFile.has(tsconfigPath)) {
-        return tsconfigInfoCaches.isFile.get(tsconfigPath);
-    }
-    if (tsconfigInfoCaches.content.has(tsconfigPath)) {
-        // if it has content, it's a file
-        tsconfigInfoCaches.isFile.set(tsconfigPath, true);
-        return true;
+function addChangedFile(changedFiles, filePath, referencePath, type) {
+    if (!changedFiles.has(filePath)) {
+        changedFiles.set(filePath, { missing: new Set(), stale: new Set() });
     }
-    tsconfigInfoCaches.isFile.set(tsconfigPath, tree.isFile(tsconfigPath));
-    return tsconfigInfoCaches.isFile.get(tsconfigPath);
+    changedFiles.get(filePath)[type].add(referencePath);
 }

package/src/plugins/typescript/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/plugins/typescript/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,iBAAiB,EACjB,SAAS,GAAG,mBAAmB,GAAG,KAAK,CACxC,GAAG;IACF,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC5C,OAAO,EAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,EACvE,GAAG,EAAE,sBAAsB,GAC1B,IAAI,CA2BN;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,kBAAkB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAgLT"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/plugins/typescript/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,iBAAiB,EACjB,SAAS,GAAG,mBAAmB,GAAG,KAAK,CACxC,GAAG;IACF,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC5C,OAAO,EAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,EACvE,GAAG,EAAE,sBAAsB,GAC1B,IAAI,CA2BN;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,kBAAkB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAqLT"}

package/src/plugins/typescript/util.js

@@ -77,7 +77,7 @@ function isValidPackageJsonBuildConfig(tsConfig, workspaceRoot, projectRoot) {
                 }
                 else if (typeof dotExport === 'object') {
                     const hasMatch = Object.entries(dotExport).some(([key, value]) => {
-                        if (key === 'types' || key === 'development')
+                        if (key === 'types' || key === 'development' || key.startsWith('@'))
                             return false;
                         return typeof value === 'string' && isPathSourceFile(value);
                     });
@@ -146,7 +146,9 @@ function isValidPackageJsonBuildConfig(tsConfig, workspaceRoot, projectRoot) {
         else if (typeof value === 'object') {
             return Object.entries(value).some(([currentKey, subValue]) => {
                 // Skip types and development conditions
-                if (currentKey === 'types' || currentKey === 'development') {
+                if (currentKey === 'types' ||
+                    currentKey === 'development' ||
+                    currentKey.startsWith('@')) {
                     return false;
                 }
                 if (typeof subValue === 'string') {

package/src/release/version-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-actions.d.ts","sourceRoot":"","sources":["../../../../../packages/js/src/release/version-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAEZ,IAAI,EAGL,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAK3E,eAAO,MAAM,yBAAyB,EAAE,yBAmBvC,CAAC;AAKF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IAC1D,sBAAsB,WAAoB;IAEpC,oCAAoC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAC9D,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAkBI,8BAA8B,CAClC,IAAI,EAAE,IAAI,EACV,8BAA8B,EAAE,6BAA6B,CAAC,gCAAgC,CAAC,GAC9F,OAAO,CAAC;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IA0DI,8BAA8B,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC;QACT,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,CAAC;IA+BI,oBAAoB,CACxB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC;IAcd,yBAAyB,CAC7B,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC;IA+DpB,OAAO,CAAC,yBAAyB;CAyClC"}
+{"version":3,"file":"version-actions.d.ts","sourceRoot":"","sources":["../../../../../packages/js/src/release/version-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAEZ,IAAI,EAGL,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAK3E,eAAO,MAAM,yBAAyB,EAAE,yBAmBvC,CAAC;AAKF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,cAAc;IAC1D,sBAAsB,WAAoB;IAEpC,oCAAoC,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAC9D,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAkBI,8BAA8B,CAClC,IAAI,EAAE,IAAI,EACV,8BAA8B,EAAE,6BAA6B,CAAC,gCAAgC,CAAC,GAC9F,OAAO,CAAC;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAkEI,8BAA8B,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC;QACT,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,CAAC;IA+BI,oBAAoB,CACxB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC;IAcd,yBAAyB,CAC7B,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC;IA+DpB,OAAO,CAAC,yBAAyB;CAyClC"}

package/src/release/version-actions.js

@@ -66,7 +66,13 @@ class JsVersionActions extends release_1.VersionActions {
                     if (error) {
                         return reject(error);
                     }
-                    if (stderr) {
+                    // Only reject on stderr if it contains actual errors, not just npm warnings
+                    // npm 11+ writes "npm warn" messages to stderr even on successful commands
+                    if (stderr &&
+                        !stderr
+                            .trim()
+                            .split('\n')
+                            .every((line) => line.startsWith('npm warn'))) {
                         return reject(stderr);
                     }
                     return resolve(stdout.trim());

package/src/utils/assets/copy-assets-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-assets-handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/utils/assets/copy-assets-handler.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,WAAW,EAAgB,MAAM,6BAA6B,CAAC;AAGxE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,uBAAuB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;CAC1C;AAUD,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,EAAE,SAiB1D,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAE7C,IAAI,EAAE,uBAAuB;IAoDnC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3C,wBAAwB,IAAI,IAAI;IAe1B,4BAA4B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAqBnD,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B9D,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,qBAAqB;CAG9B"}
+{"version":3,"file":"copy-assets-handler.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/utils/assets/copy-assets-handler.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,WAAW,EAAgB,MAAM,6BAA6B,CAAC;AAGxE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,uBAAuB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;CAC1C;AAUD,eAAO,MAAM,uBAAuB,GAAI,QAAQ,SAAS,EAAE,SAiB1D,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;gBAE7C,IAAI,EAAE,uBAAuB;IAuDnC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3C,wBAAwB,IAAI,IAAI;IAgB1B,4BAA4B,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAqBnD,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC9D,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,qBAAqB;CAG9B"}

package/src/utils/assets/copy-assets-handler.js

@@ -41,10 +41,12 @@ class CopyAssetsHandler {
         this.ignore = (0, ignore_1.default)();
         const gitignore = pathPosix.join(opts.rootDir, '.gitignore');
         const nxignore = pathPosix.join(opts.rootDir, '.nxignore');
-        if ((0, node_fs_1.existsSync)(gitignore))
+        if ((0, node_fs_1.existsSync)(gitignore)) {
             this.ignore.add((0, node_fs_1.readFileSync)(gitignore).toString());
-        if ((0, node_fs_1.existsSync)(nxignore))
+        }
+        if ((0, node_fs_1.existsSync)(nxignore)) {
             this.ignore.add((0, node_fs_1.readFileSync)(nxignore).toString());
+        }
         this.assetGlobs = opts.assets.map((f) => {
             let isGlob = false;
             let pattern;
@@ -85,6 +87,8 @@ class CopyAssetsHandler {
                 cwd: this.rootDir,
                 dot: true, // enable hidden files
                 expandDirectories: false,
+                // Ignore common directories that should not be copied or processed
+                ignore: ['**/node_modules/**', '**/.git/**'],
             });
             this.callback(this.filesToEvent(files, ag));
         }));
@@ -97,6 +101,7 @@ class CopyAssetsHandler {
                 cwd: this.rootDir,
                 dot: true, // enable hidden files
                 expandDirectories: false,
+                ignore: ['**/node_modules/**', '**/.git/**'],
             });
             this.callback(this.filesToEvent(files, ag));
         });
@@ -120,6 +125,8 @@ class CopyAssetsHandler {
         return () => unregisterFileWatcher();
     }
     async processWatchEvents(events) {
+        if (events.length === 0)
+            return;
         const fileEvents = [];
         for (const event of events) {
             const pathFromRoot = event.path.startsWith(this.rootDir)

package/src/utils/typescript/ts-solution-setup.d.ts

@@ -1,5 +1,6 @@
 import { type ProjectConfiguration, type Tree } from '@nx/devkit';
 export declare function isUsingTypeScriptPlugin(tree: Tree): boolean;
+export declare function shouldConfigureTsSolutionSetup(tree: Tree, addPlugins: boolean, addTsPlugin?: boolean): boolean;
 export declare function isUsingTsSolutionSetup(tree?: Tree): boolean;
 export declare function assertNotUsingTsSolutionSetup(tree: Tree, pluginName: string, generatorName: string): void;
 export declare function findRuntimeTsConfigName(projectRoot: string, tree?: Tree): string | null;

package/src/utils/typescript/ts-solution-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ts-solution-setup.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/utils/typescript/ts-solution-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAGzB,KAAK,IAAI,EAGV,MAAM,YAAY,CAAC;AAWpB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAU3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAO3D;AA4CD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,IAAI,CAsBN;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,IAAI,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,uBAAuB,EAAE,MAAM,EAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAC5D,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,SAAQ,QAoFhB;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,iBAqDnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,GACtC,SAAS,GAAG,aAAa,CAa3B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,CAAC,EAAE,IAAI,GACV,MAAM,CAgBR"}
+{"version":3,"file":"ts-solution-setup.d.ts","sourceRoot":"","sources":["../../../../../../packages/js/src/utils/typescript/ts-solution-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EAGzB,KAAK,IAAI,EAGV,MAAM,YAAY,CAAC;AAWpB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAU3D;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,OAAO,EACnB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAsBT;AAED,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAO3D;AAuDD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,IAAI,CAsBN;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,IAAI,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,uBAAuB,EAAE,MAAM,EAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAC5D,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,SAAQ,QAoFhB;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,iBAqDnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,GACtC,SAAS,GAAG,aAAa,CAoB3B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,CAAC,EAAE,IAAI,GACV,MAAM,CAgBR"}

package/src/utils/typescript/ts-solution-setup.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isUsingTypeScriptPlugin = isUsingTypeScriptPlugin;
+exports.shouldConfigureTsSolutionSetup = shouldConfigureTsSolutionSetup;
 exports.isUsingTsSolutionSetup = isUsingTsSolutionSetup;
 exports.assertNotUsingTsSolutionSetup = assertNotUsingTsSolutionSetup;
 exports.findRuntimeTsConfigName = findRuntimeTsConfigName;
@@ -20,11 +21,39 @@ function isUsingTypeScriptPlugin(tree) {
         ? p === '@nx/js/typescript'
         : p.plugin === '@nx/js/typescript') ?? false);
 }
+function shouldConfigureTsSolutionSetup(tree, addPlugins, addTsPlugin) {
+    if (addTsPlugin !== undefined) {
+        return addTsPlugin;
+    }
+    if (addPlugins === undefined) {
+        const nxJson = (0, devkit_1.readNxJson)(tree);
+        addPlugins =
+            process.env.NX_ADD_PLUGINS !== 'false' &&
+                nxJson.useInferencePlugins !== false;
+    }
+    if (!addPlugins) {
+        return false;
+    }
+    if (!(0, package_manager_workspaces_1.isUsingPackageManagerWorkspaces)(tree)) {
+        return false;
+    }
+    // if there are no root tsconfig files, we should configure the TS solution setup
+    return !tree.exists('tsconfig.base.json') && !tree.exists('tsconfig.json');
+}
 function isUsingTsSolutionSetup(tree) {
     tree ??= new tree_1.FsTree(devkit_1.workspaceRoot, false);
     return ((0, package_manager_workspaces_1.isUsingPackageManagerWorkspaces)(tree) &&
         isWorkspaceSetupWithTsSolution(tree));
 }
+/**
+ * The TS solution setup requires:
+ * - `tsconfig.base.json`: TS config with common compiler options needed by the
+ *    majority of projects in the workspace. It's meant to be extended by other
+ *    tsconfig files in the workspace to reuse them.
+ * - `tsconfig.json`: TS solution config file that references all other projects
+ *    in the repo. It shouldn't include any file and it's not meant to be
+ *    extended or define any common compiler options.
+ */
 function isWorkspaceSetupWithTsSolution(tree) {
     if (!tree.exists('tsconfig.base.json') || !tree.exists('tsconfig.json')) {
         return false;
@@ -34,27 +63,30 @@ function isWorkspaceSetupWithTsSolution(tree) {
         return false;
     }
     /**
-     * New setup:
-     * - `files` is defined and set to an empty array
-     * - `references` is defined and set to an empty array
-     * - `include` is not defined or is set to an empty array
+     * TS solution setup requires:
+     * - One of `files` or `include` defined
+     * - If set, they must be empty arrays
+     *
+     * Note: while the TS solution setup uses TS project references, in the initial
+     * state of the workspace, where there are no projects, `references` is not
+     * required to be defined.
      */
-    if (!tsconfigJson.files ||
-        tsconfigJson.files.length > 0 ||
-        !tsconfigJson.references ||
-        !!tsconfigJson.include?.length) {
+    if ((!tsconfigJson.files && !tsconfigJson.include) ||
+        tsconfigJson.files?.length > 0 ||
+        tsconfigJson.include?.length > 0) {
         return false;
     }
+    /**
+     * TS solution setup requires:
+     * - `compilerOptions.composite`: true
+     * - `compilerOptions.declaration`: true or not set (default to true)
+     */
     const baseTsconfigJson = (0, devkit_1.readJson)(tree, 'tsconfig.base.json');
     if (!baseTsconfigJson.compilerOptions ||
         !baseTsconfigJson.compilerOptions.composite ||
         baseTsconfigJson.compilerOptions.declaration === false) {
         return false;
     }
-    const { compilerOptions, ...rest } = baseTsconfigJson;
-    if (Object.keys(rest).length > 0) {
-        return false;
-    }
     return true;
 }
 function assertNotUsingTsSolutionSetup(tree, pluginName, generatorName) {
@@ -198,13 +230,17 @@ function getProjectType(tree, projectRoot, projectType) {
         return 'library';
     if (tree.exists((0, devkit_1.joinPathFragments)(projectRoot, 'tsconfig.app.json')))
         return 'application';
-    // If there are no exports, assume it is an application since both buildable and non-buildable libraries have exports.
+    // If it doesn't have any common library entry points, assume it is an application
     const packageJsonPath = (0, devkit_1.joinPathFragments)(projectRoot, 'package.json');
     const packageJson = tree.exists(packageJsonPath)
         ? (0, devkit_1.readJson)(tree, (0, devkit_1.joinPathFragments)(projectRoot, 'package.json'))
         : null;
-    if (!packageJson?.exports)
+    if (!packageJson?.exports &&
+        !packageJson?.main &&
+        !packageJson?.module &&
+        !packageJson?.bin) {
         return 'application';
+    }
     return 'library';
 }
 function getProjectSourceRoot(project, tree) {