@nx/js 23.0.0 → 23.1.0-beta.0

package/README.md

@@ -7,13 +7,12 @@
 
 <div style="text-align: center;">
 
-[![CircleCI](https://circleci.com/gh/nrwl/nx.svg?style=svg)](https://circleci.com/gh/nrwl/nx)
 [![License](https://img.shields.io/npm/l/@nx/workspace.svg?style=flat-square)]()
 [![NPM Version](https://badge.fury.io/js/nx.svg)](https://www.npmjs.com/package/nx)
 [![Semantic Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)]()
 [![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
-[![Join the chat at https://gitter.im/nrwl-nx/community](https://badges.gitter.im/nrwl-nx/community.svg)](https://gitter.im/nrwl-nx/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Join us on the Official Nx Discord Server](https://img.shields.io/discord/1143497901675401286?label=discord)](https://go.nx.dev/community)
+[![Nx Sandboxing](https://staging.nx.app/workspaces/62d013ea0852fe0a2df74438/sandbox-badge.svg)](https://nx.dev/docs/features/ci-features/sandboxing)
 
 </div>
 

package/dist/internal.d.ts

@@ -4,7 +4,9 @@ export { findProjectsNpmDependencies } from 'nx/src/plugins/js/package-json/crea
 export { walkTsconfigExtendsChain, type RawTsconfigJsonCache, } from './src/utils/typescript/raw-tsconfig';
 export { isEsmProject } from './src/utils/module-format/is-esm-project';
 export { TS_SOLUTION_SETUP_TSCONFIG_INPUT, addProjectToTsSolutionWorkspace, assertNotUsingTsSolutionSetup, findRuntimeTsConfigName, getDefinedCustomConditionName, getProjectSourceRoot, getProjectType, isUsingTsSolutionSetup, shouldConfigureTsSolutionSetup, updateTsconfigFiles, } from './src/utils/typescript/ts-solution-setup';
+export { getTsConfigBaseOptions } from './src/utils/typescript/create-ts-config';
 export { ensureTypescript } from './src/utils/typescript/ensure-typescript';
+export { getRangeMinimum, getTsConfigModuleResolution, isTypescriptVersionAtLeast, } from './src/utils/is-typescript-version-at-least';
 export { getNeededCompilerOptionOverrides } from './src/utils/typescript/configuration';
 export { compileTypeScript, type TypeScriptCompilationOptions, } from './src/utils/typescript/compilation';
 export { calculateProjectBuildableDependencies, calculateProjectDependencies, computeCompilerOptionsPaths, createTmpTsConfig, type DependentBuildableProjectNode, } from './src/utils/buildable-libs-utils';

package/dist/internal.js

@@ -5,8 +5,8 @@
 // internal consumers and may change without semver protection. Consider it
 // the @nx/js equivalent of `@nx/devkit/internal`.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.esbuildVersion = exports.nxVersion = exports.releaseTasks = exports.addReleaseConfigForTsSolution = exports.addReleaseConfigForNonTsSolution = exports.addLocalRegistryScripts = exports.stripGlobToBaseDir = exports.getImportPath = exports.createGlobPatternsForDependencies = exports.normalizeUnitTestRunnerOption = exports.normalizeLinterOption = exports.isValidPackageJsonBuildConfig = exports.addBuildAndWatchDepsTargets = exports.findNpmDependencies = exports.getProjectPackageManagerWorkspaceStateWarningTask = exports.getProjectPackageManagerWorkspaceState = exports.getNpmScope = exports.sortPackageJsonFields = exports.CopyAssetsHandler = exports.addSwcRegisterDependencies = exports.addSwcDependencies = exports.addSwcTestConfig = exports.addSwcConfig = exports.createTmpTsConfig = exports.computeCompilerOptionsPaths = exports.calculateProjectDependencies = exports.calculateProjectBuildableDependencies = exports.compileTypeScript = exports.getNeededCompilerOptionOverrides = exports.ensureTypescript = exports.updateTsconfigFiles = exports.shouldConfigureTsSolutionSetup = exports.isUsingTsSolutionSetup = exports.getProjectType = exports.getProjectSourceRoot = exports.getDefinedCustomConditionName = exports.findRuntimeTsConfigName = exports.assertNotUsingTsSolutionSetup = exports.addProjectToTsSolutionWorkspace = exports.TS_SOLUTION_SETUP_TSCONFIG_INPUT = exports.isEsmProject = exports.walkTsconfigExtendsChain = exports.findProjectsNpmDependencies = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.requireWithTsconfigFallback = exports.registerTsConfigPaths = exports.registerTsProject = exports.loadTsFile = exports.forceRegisterEsmLoader = void 0;
-exports.typesNodeVersion = exports.tsLibVersion = exports.swcNodeVersion = exports.swcHelpersVersion = exports.swcCoreVersion = exports.swcCliVersion = exports.prettierVersion = void 0;
+exports.addReleaseConfigForNonTsSolution = exports.addLocalRegistryScripts = exports.stripGlobToBaseDir = exports.getImportPath = exports.createGlobPatternsForDependencies = exports.normalizeUnitTestRunnerOption = exports.normalizeLinterOption = exports.isValidPackageJsonBuildConfig = exports.addBuildAndWatchDepsTargets = exports.findNpmDependencies = exports.getProjectPackageManagerWorkspaceStateWarningTask = exports.getProjectPackageManagerWorkspaceState = exports.getNpmScope = exports.sortPackageJsonFields = exports.CopyAssetsHandler = exports.addSwcRegisterDependencies = exports.addSwcDependencies = exports.addSwcTestConfig = exports.addSwcConfig = exports.createTmpTsConfig = exports.computeCompilerOptionsPaths = exports.calculateProjectDependencies = exports.calculateProjectBuildableDependencies = exports.compileTypeScript = exports.getNeededCompilerOptionOverrides = exports.isTypescriptVersionAtLeast = exports.getTsConfigModuleResolution = exports.getRangeMinimum = exports.ensureTypescript = exports.getTsConfigBaseOptions = exports.updateTsconfigFiles = exports.shouldConfigureTsSolutionSetup = exports.isUsingTsSolutionSetup = exports.getProjectType = exports.getProjectSourceRoot = exports.getDefinedCustomConditionName = exports.findRuntimeTsConfigName = exports.assertNotUsingTsSolutionSetup = exports.addProjectToTsSolutionWorkspace = exports.TS_SOLUTION_SETUP_TSCONFIG_INPUT = exports.isEsmProject = exports.walkTsconfigExtendsChain = exports.findProjectsNpmDependencies = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.requireWithTsconfigFallback = exports.registerTsConfigPaths = exports.registerTsProject = exports.loadTsFile = exports.forceRegisterEsmLoader = void 0;
+exports.typesNodeVersion = exports.tsLibVersion = exports.swcNodeVersion = exports.swcHelpersVersion = exports.swcCoreVersion = exports.swcCliVersion = exports.prettierVersion = exports.esbuildVersion = exports.nxVersion = exports.releaseTasks = exports.addReleaseConfigForTsSolution = void 0;
 // Re-exports of nx-source internals (need `no-restricted-imports` overrides).
 // eslint-disable-next-line @typescript-eslint/no-restricted-imports
 var register_1 = require("nx/src/plugins/js/utils/register");
@@ -41,11 +41,18 @@ Object.defineProperty(exports, "getProjectType", { enumerable: true, get: functi
 Object.defineProperty(exports, "isUsingTsSolutionSetup", { enumerable: true, get: function () { return ts_solution_setup_1.isUsingTsSolutionSetup; } });
 Object.defineProperty(exports, "shouldConfigureTsSolutionSetup", { enumerable: true, get: function () { return ts_solution_setup_1.shouldConfigureTsSolutionSetup; } });
 Object.defineProperty(exports, "updateTsconfigFiles", { enumerable: true, get: function () { return ts_solution_setup_1.updateTsconfigFiles; } });
-// TypeScript helpers (resolvePathsBaseUrl, extractTsConfigBase,
-// tsConfigBaseOptions, addTsLibDependencies, resolveModuleByImport — all ship
-// via the public @nx/js entry)
+// TypeScript helpers. resolvePathsBaseUrl, extractTsConfigBase,
+// tsConfigBaseOptions, addTsLibDependencies, and resolveModuleByImport ship via
+// the public @nx/js entry. getTsConfigBaseOptions is public too, but is
+// re-exported here so internal consumers can import it from @nx/js/internal.
+var create_ts_config_1 = require("./src/utils/typescript/create-ts-config");
+Object.defineProperty(exports, "getTsConfigBaseOptions", { enumerable: true, get: function () { return create_ts_config_1.getTsConfigBaseOptions; } });
 var ensure_typescript_1 = require("./src/utils/typescript/ensure-typescript");
 Object.defineProperty(exports, "ensureTypescript", { enumerable: true, get: function () { return ensure_typescript_1.ensureTypescript; } });
+var is_typescript_version_at_least_1 = require("./src/utils/is-typescript-version-at-least");
+Object.defineProperty(exports, "getRangeMinimum", { enumerable: true, get: function () { return is_typescript_version_at_least_1.getRangeMinimum; } });
+Object.defineProperty(exports, "getTsConfigModuleResolution", { enumerable: true, get: function () { return is_typescript_version_at_least_1.getTsConfigModuleResolution; } });
+Object.defineProperty(exports, "isTypescriptVersionAtLeast", { enumerable: true, get: function () { return is_typescript_version_at_least_1.isTypescriptVersionAtLeast; } });
 var configuration_1 = require("./src/utils/typescript/configuration");
 Object.defineProperty(exports, "getNeededCompilerOptionOverrides", { enumerable: true, get: function () { return configuration_1.getNeededCompilerOptionOverrides; } });
 var compilation_1 = require("./src/utils/typescript/compilation");

package/dist/src/generators/init/files/non-ts-solution/__fileName__

@@ -4,7 +4,7 @@
     "rootDir": ".",
     "sourceMap": true,
     "declaration": false,
-    "moduleResolution": "node",
+    "moduleResolution": "<%= moduleResolution %>",
     "emitDecoratorMetadata": true,
     "experimentalDecorators": true,
     "importHelpers": true,
@@ -13,6 +13,7 @@
     "lib": ["es2020", "dom"],
     "skipLibCheck": true,
     "skipDefaultLibCheck": true,
+    "strict": false,
     "paths": {}
   },
   "exclude": ["node_modules", "tmp"]

package/dist/src/generators/init/init.js

@@ -8,6 +8,7 @@ const path_1 = require("path");
 const plugin_1 = require("../../plugins/typescript/plugin");
 const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const prettier_1 = require("../../utils/prettier");
+const create_ts_config_1 = require("../../utils/typescript/create-ts-config");
 const ts_config_1 = require("../../utils/typescript/ts-config");
 const ts_solution_setup_1 = require("../../utils/typescript/ts-solution-setup");
 const versions_1 = require("../../utils/versions");
@@ -70,6 +71,7 @@ async function initGeneratorInternal(tree, schema) {
         else {
             (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, './files/non-ts-solution'), '.', {
                 fileName: schema.tsConfigName ?? 'tsconfig.base.json',
+                moduleResolution: (0, create_ts_config_1.getTsConfigBaseOptions)(tree).moduleResolution,
             });
         }
     }

package/dist/src/generators/library/library.js

@@ -771,7 +771,7 @@ function createProjectTsConfigs(tree, options) {
             ? undefined
             : (0, ts_config_1.getRelativePathToRootTsConfig)(tree, options.projectRoot),
         compilerOptions: {
-            ...(options.rootProject ? create_ts_config_1.tsConfigBaseOptions : {}),
+            ...(options.rootProject ? (0, create_ts_config_1.getTsConfigBaseOptions)(tree) : {}),
             ...compilerOptionOverrides,
         },
         files: [],

package/dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.d.ts

@@ -0,0 +1,28 @@
+import { type Tree } from '@nx/devkit';
+/**
+ * Two independent passes over every tsconfig*.json in the workspace:
+ *
+ * 1. ignoreDeprecations pass - adds `ignoreDeprecations: "6.0"` to any
+ *    compilerOptions (or ts-node.compilerOptions) block that directly carries a
+ *    TS6 hard-deprecated option value (moduleResolution node/node10/classic,
+ *    baseUrl, target es5, esModuleInterop false, outFile, module
+ *    amd/umd/system/none, alwaysStrict false, allowSyntheticDefaultImports
+ *    false, downlevelIteration set to any value).
+ *
+ * 2. default-preserving pass - for every chain root (no "extends" key), pins
+ *    the TS6 compiler-option defaults that flipped to a stricter value back to
+ *    their pre-TS6 value, but only when the root does not set them explicitly:
+ *      - "strict": false - TS6 treats an absent "strict" as true; TS5 as false.
+ *      - "noUncheckedSideEffectImports": false - TS6 defaults it to true, which
+ *        turns a bare side-effect import of an asset lacking an ambient
+ *        declaration (e.g. `import './styles.css'`) into a hard TS2882 error; it
+ *        is a semantic diagnostic, not a deprecation, so `ignoreDeprecations`
+ *        cannot silence it.
+ *    Files with "extends" inherit from their chain root and are left untouched.
+ *    Pure solution-style containers (root has `"files": []` and no "include")
+ *    select no source files, so pinning there is noise and they are skipped.
+ *
+ * Only runs on TS6 workspaces (gated by `requires` in migrations.json), because
+ * `ignoreDeprecations: "6.0"` is itself a hard error (TS5103) on TS 5.x.
+ */
+export default function (tree: Tree): Promise<void>;

package/dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const devkit_1 = require("@nx/devkit");
+const node_path_1 = require("node:path");
+const jsonc_parser_1 = require("jsonc-parser");
+const FORMATTING_OPTIONS = {
+    formattingOptions: { keepLines: true, insertSpaces: true, tabSize: 2 },
+};
+/**
+ * Two independent passes over every tsconfig*.json in the workspace:
+ *
+ * 1. ignoreDeprecations pass - adds `ignoreDeprecations: "6.0"` to any
+ *    compilerOptions (or ts-node.compilerOptions) block that directly carries a
+ *    TS6 hard-deprecated option value (moduleResolution node/node10/classic,
+ *    baseUrl, target es5, esModuleInterop false, outFile, module
+ *    amd/umd/system/none, alwaysStrict false, allowSyntheticDefaultImports
+ *    false, downlevelIteration set to any value).
+ *
+ * 2. default-preserving pass - for every chain root (no "extends" key), pins
+ *    the TS6 compiler-option defaults that flipped to a stricter value back to
+ *    their pre-TS6 value, but only when the root does not set them explicitly:
+ *      - "strict": false - TS6 treats an absent "strict" as true; TS5 as false.
+ *      - "noUncheckedSideEffectImports": false - TS6 defaults it to true, which
+ *        turns a bare side-effect import of an asset lacking an ambient
+ *        declaration (e.g. `import './styles.css'`) into a hard TS2882 error; it
+ *        is a semantic diagnostic, not a deprecation, so `ignoreDeprecations`
+ *        cannot silence it.
+ *    Files with "extends" inherit from their chain root and are left untouched.
+ *    Pure solution-style containers (root has `"files": []` and no "include")
+ *    select no source files, so pinning there is noise and they are skipped.
+ *
+ * Only runs on TS6 workspaces (gated by `requires` in migrations.json), because
+ * `ignoreDeprecations: "6.0"` is itself a hard error (TS5103) on TS 5.x.
+ */
+async function default_1(tree) {
+    let deprecationCount = 0;
+    let defaultsPinCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        const name = (0, node_path_1.basename)(filePath);
+        if (!name.startsWith('tsconfig') || !name.endsWith('.json')) {
+            return;
+        }
+        if (addIgnoreDeprecations(tree, filePath)) {
+            deprecationCount += 1;
+        }
+        if (pinPreTs6Defaults(tree, filePath)) {
+            defaultsPinCount += 1;
+        }
+    });
+    if (deprecationCount > 0) {
+        devkit_1.logger.info(`Added "ignoreDeprecations": "6.0" to ${deprecationCount} tsconfig file(s) carrying TS6-deprecated options.`);
+    }
+    if (defaultsPinCount > 0) {
+        devkit_1.logger.info(`Pinned pre-TS6 compiler option defaults ("strict", "noUncheckedSideEffectImports") on ${defaultsPinCount} tsconfig chain root(s) to preserve existing behavior.`);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+function addIgnoreDeprecations(tree, tsconfigPath) {
+    const original = tree.read(tsconfigPath, 'utf-8');
+    if (!original) {
+        return false;
+    }
+    // Each entry targets a distinct compilerOptions block within the same file.
+    const blocks = [
+        ['compilerOptions'],
+        ['ts-node', 'compilerOptions'],
+    ];
+    let contents = original;
+    let changed = false;
+    for (const blockPath of blocks) {
+        // Re-parse each iteration: a prior edit shifts offsets in `contents`.
+        const root = (0, jsonc_parser_1.parseTree)(contents);
+        const blockNode = root && (0, jsonc_parser_1.findNodeAtLocation)(root, blockPath);
+        if (!blockNode || blockNode.type !== 'object') {
+            continue;
+        }
+        const compilerOptions = (0, jsonc_parser_1.getNodeValue)(blockNode);
+        if (!hasDeprecatedValue(compilerOptions)) {
+            continue;
+        }
+        // An existing non-"6.0" value (e.g. "5.0") does NOT silence 6.0-class
+        // deprecations, so upgrade it; only "6.0" is already correct.
+        if (compilerOptions.ignoreDeprecations === '6.0') {
+            continue;
+        }
+        const edits = (0, jsonc_parser_1.modify)(contents, [...blockPath, 'ignoreDeprecations'], '6.0', FORMATTING_OPTIONS);
+        contents = (0, jsonc_parser_1.applyEdits)(contents, edits);
+        changed = true;
+    }
+    if (changed) {
+        tree.write(tsconfigPath, contents);
+    }
+    return changed;
+}
+// Values that compile silently on TS 5.8 but are hard deprecation errors
+// (TS5101/TS5107) on TS 6.0 - derived by differential 5.8-vs-6.0 probing.
+function hasDeprecatedValue(compilerOptions) {
+    const moduleResolution = asLowerString(compilerOptions.moduleResolution);
+    if (moduleResolution === 'node' ||
+        moduleResolution === 'node10' ||
+        moduleResolution === 'classic') {
+        return true;
+    }
+    // `baseUrl`/`outFile` only deprecate when set to a real value; `null`/unset
+    // is inert on TS6.
+    if (compilerOptions.baseUrl != null) {
+        return true;
+    }
+    if (asLowerString(compilerOptions.target) === 'es5') {
+        return true;
+    }
+    if (compilerOptions.esModuleInterop === false) {
+        return true;
+    }
+    if (compilerOptions.outFile != null) {
+        return true;
+    }
+    const moduleValue = asLowerString(compilerOptions.module);
+    if (moduleValue === 'amd' ||
+        moduleValue === 'umd' ||
+        moduleValue === 'system' ||
+        moduleValue === 'none') {
+        return true;
+    }
+    // Only the explicit `false` value triggers TS5107 for these two flags.
+    if (compilerOptions.alwaysStrict === false) {
+        return true;
+    }
+    if (compilerOptions.allowSyntheticDefaultImports === false) {
+        return true;
+    }
+    // A real boolean triggers TS5101; `null`/unset is inert. `!= null` also flags
+    // non-boolean JSON, but that only adds a harmless no-op `ignoreDeprecations`.
+    if (compilerOptions.downlevelIteration != null) {
+        return true;
+    }
+    return false;
+}
+// TS6 compiler-option defaults that flipped to a stricter value. We pin each
+// back to its pre-TS6 value on chain roots that don't set it, so existing
+// workspaces keep building without adopting a legit TS6 setup.
+const DEFAULT_PRESERVING_PINS = [
+    ['strict', false],
+    ['noUncheckedSideEffectImports', false],
+];
+function pinPreTs6Defaults(tree, tsconfigPath) {
+    const original = tree.read(tsconfigPath, 'utf-8');
+    if (!original) {
+        return false;
+    }
+    const root = (0, jsonc_parser_1.parseTree)(original);
+    if (!root || root.type !== 'object') {
+        return false;
+    }
+    const rootValue = (0, jsonc_parser_1.getNodeValue)(root);
+    // Only touch chain roots - files with "extends" inherit from their ancestor.
+    if ('extends' in rootValue) {
+        return false;
+    }
+    // Skip pure solution-style containers: root has "files": [] and no "include".
+    // They select no source files, so pinning defaults there is noise.
+    const filesNode = (0, jsonc_parser_1.findNodeAtLocation)(root, ['files']);
+    const hasEmptyFiles = filesNode?.type === 'array' && filesNode.children?.length === 0;
+    if (hasEmptyFiles && !('include' in rootValue)) {
+        return false;
+    }
+    const compilerOptionsNode = (0, jsonc_parser_1.findNodeAtLocation)(root, ['compilerOptions']);
+    // A present-but-non-object compilerOptions can't receive pinned keys; bailing
+    // avoids modify() throwing and aborting the whole migration.
+    if (compilerOptionsNode && compilerOptionsNode.type !== 'object') {
+        return false;
+    }
+    const compilerOptions = compilerOptionsNode
+        ? (0, jsonc_parser_1.getNodeValue)(compilerOptionsNode)
+        : {};
+    let contents = original;
+    let changed = false;
+    for (const [key, value] of DEFAULT_PRESERVING_PINS) {
+        // An explicit value (true or false) means the user opted in - leave it.
+        if (key in compilerOptions) {
+            continue;
+        }
+        const edits = (0, jsonc_parser_1.modify)(contents, ['compilerOptions', key], value, FORMATTING_OPTIONS);
+        contents = (0, jsonc_parser_1.applyEdits)(contents, edits);
+        changed = true;
+    }
+    if (changed) {
+        tree.write(tsconfigPath, contents);
+    }
+    return changed;
+}
+function asLowerString(value) {
+    return typeof value === 'string' ? value.toLowerCase() : undefined;
+}

package/dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.md

@@ -0,0 +1,37 @@
+#### Keep Existing Workspaces Compiling on TypeScript 6
+
+TypeScript 6 turns several long-deprecated compiler options into hard errors and flips a few option defaults to stricter values. So that an existing workspace keeps compiling on TypeScript 6 without being migrated to a full TypeScript 6 setup, this migration makes two edits to the `tsconfig*.json` files in the workspace:
+
+- Adds `"ignoreDeprecations": "6.0"` to any `compilerOptions` (or `ts-node.compilerOptions`) block that directly sets a TypeScript 6 deprecated option - for example `moduleResolution` set to `node`/`node10`/`classic`, `baseUrl`, `target` set to `es5`, `esModuleInterop: false`, `outFile`, `module` set to `amd`/`umd`/`system`/`none`, `alwaysStrict: false`, `allowSyntheticDefaultImports: false`, or `downlevelIteration`.
+- Pins `"strict": false` and `"noUncheckedSideEffectImports": false` on every chain-root tsconfig (one without an `extends`) that does not already set them. TypeScript 6 treats an absent `strict` as `true` (it was `false` when unset before) and defaults `noUncheckedSideEffectImports` to `true`, which turns a bare side-effect import such as `import './styles.css'` without an ambient module declaration into an error. Pinning both preserves the pre-TypeScript 6 behavior.
+
+Files that use `extends` inherit these settings from their chain root and are left untouched, and pure solution-style tsconfigs (`"files": []` with no `include`) are skipped. The migration only runs when the workspace is on TypeScript 6.
+
+#### Sample Code Changes
+
+##### Before
+
+```json title="tsconfig.json"
+{
+  "compilerOptions": {
+    "target": "es5",
+    "module": "esnext",
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+##### After
+
+```json title="tsconfig.json" {6-8}
+{
+  "compilerOptions": {
+    "target": "es5",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "ignoreDeprecations": "6.0",
+    "strict": false,
+    "noUncheckedSideEffectImports": false
+  }
+}
+```

package/dist/src/utils/is-typescript-version-at-least.d.ts

@@ -0,0 +1,37 @@
+import { type Tree } from '@nx/devkit';
+/**
+ * Checks whether the workspace's `typescript` is at or above the given version.
+ *
+ * Resolution order:
+ * - When `typescript` is declared and the installed version satisfies that
+ *   declared range, the installed version decides. This resolves open ranges
+ *   (e.g. `>=5.8.0`, `^5 || ^6`) to what is actually installed.
+ * - Otherwise the declared range's minimum is used (e.g. `^5.9.2` -> `5.9.2`,
+ *   `<6` -> `0.0.0`). This is the fresh-workspace path (nothing installed yet)
+ *   and the case where a generator is mid-flight re-pinning `typescript` - the
+ *   new range no longer satisfies the still-installed version, so intent wins.
+ * - When `typescript` is not declared at all, Nx's default install version is
+ *   assumed; a transitively-hoisted install is ignored as it does not reflect
+ *   a workspace choice.
+ *
+ * Dist-tags and unparseable ranges (e.g. `latest`, `next`) have no resolvable
+ * floor, so they are treated as meeting any version.
+ *
+ * Use from generators to emit version-appropriate config when a single value
+ * is not valid across the supported TypeScript range.
+ */
+export declare function isTypescriptVersionAtLeast(tree: Tree, version: string): boolean;
+/**
+ * The `moduleResolution` to emit in generated tsconfig files, chosen for the
+ * workspace's TypeScript version: `bundler` on TS >= 6, `node10` on TS < 6.
+ * node-family resolution is a TS5107 deprecation error on TS 6, and `bundler`
+ * is invalid in a commonjs setup on TS < 6 (TS5095); `node10` also preserves
+ * classic node resolution for pre-TS6 workspaces.
+ */
+export declare function getTsConfigModuleResolution(tree: Tree): 'bundler' | 'node10';
+/**
+ * Returns the minimum satisfying version for a semver range, stripping
+ * prerelease so `>=6.0.0-beta.1` still counts as 6.0. Falls back to coerce()
+ * for dist-tags and garbage inputs that minVersion() cannot parse.
+ */
+export declare function getRangeMinimum(range: string): string | undefined;

package/dist/src/utils/is-typescript-version-at-least.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTypescriptVersionAtLeast = isTypescriptVersionAtLeast;
+exports.getTsConfigModuleResolution = getTsConfigModuleResolution;
+exports.getRangeMinimum = getRangeMinimum;
+const devkit_1 = require("@nx/devkit");
+const semver_1 = require("semver");
+const versions_1 = require("./versions");
+/**
+ * Checks whether the workspace's `typescript` is at or above the given version.
+ *
+ * Resolution order:
+ * - When `typescript` is declared and the installed version satisfies that
+ *   declared range, the installed version decides. This resolves open ranges
+ *   (e.g. `>=5.8.0`, `^5 || ^6`) to what is actually installed.
+ * - Otherwise the declared range's minimum is used (e.g. `^5.9.2` -> `5.9.2`,
+ *   `<6` -> `0.0.0`). This is the fresh-workspace path (nothing installed yet)
+ *   and the case where a generator is mid-flight re-pinning `typescript` - the
+ *   new range no longer satisfies the still-installed version, so intent wins.
+ * - When `typescript` is not declared at all, Nx's default install version is
+ *   assumed; a transitively-hoisted install is ignored as it does not reflect
+ *   a workspace choice.
+ *
+ * Dist-tags and unparseable ranges (e.g. `latest`, `next`) have no resolvable
+ * floor, so they are treated as meeting any version.
+ *
+ * Use from generators to emit version-appropriate config when a single value
+ * is not valid across the supported TypeScript range.
+ */
+function isTypescriptVersionAtLeast(tree, version) {
+    const declared = (0, devkit_1.getDependencyVersionFromPackageJson)(tree, 'typescript');
+    if (declared) {
+        const installed = getInstalledTypescriptVersion(tree);
+        if (installed && (0, semver_1.satisfies)(installed, declared)) {
+            return (0, semver_1.gte)(installed, version);
+        }
+    }
+    const minimum = getRangeMinimum(declared ?? versions_1.typescriptVersion);
+    return !minimum || (0, semver_1.gte)(minimum, version);
+}
+/**
+ * Reads the installed `typescript` version via the tree (not `require`), so it
+ * reflects in-flight tree changes and stays controllable in tests. Returns
+ * undefined when not resolvable.
+ */
+function getInstalledTypescriptVersion(tree) {
+    try {
+        const pkgJson = tree.read('node_modules/typescript/package.json', 'utf-8');
+        if (!pkgJson) {
+            return undefined;
+        }
+        // Strip any prerelease (e.g. `6.0.0-rc.1` -> `6.0.0`) so it compares
+        // consistently with getRangeMinimum's normalization.
+        return (0, semver_1.coerce)(JSON.parse(pkgJson).version)?.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The `moduleResolution` to emit in generated tsconfig files, chosen for the
+ * workspace's TypeScript version: `bundler` on TS >= 6, `node10` on TS < 6.
+ * node-family resolution is a TS5107 deprecation error on TS 6, and `bundler`
+ * is invalid in a commonjs setup on TS < 6 (TS5095); `node10` also preserves
+ * classic node resolution for pre-TS6 workspaces.
+ */
+function getTsConfigModuleResolution(tree) {
+    return isTypescriptVersionAtLeast(tree, '6.0.0') ? 'bundler' : 'node10';
+}
+/**
+ * Returns the minimum satisfying version for a semver range, stripping
+ * prerelease so `>=6.0.0-beta.1` still counts as 6.0. Falls back to coerce()
+ * for dist-tags and garbage inputs that minVersion() cannot parse.
+ */
+function getRangeMinimum(range) {
+    try {
+        const min = (0, semver_1.minVersion)(range);
+        if (min) {
+            return `${min.major}.${min.minor}.${min.patch}`;
+        }
+    }
+    catch {
+        // fall through to coerce for dist-tags and other unparseable inputs
+    }
+    return (0, semver_1.coerce)(range)?.version;
+}

package/dist/src/utils/typescript/create-ts-config.d.ts

@@ -12,6 +12,23 @@ export declare const tsConfigBaseOptions: {
     lib: string[];
     skipLibCheck: boolean;
     skipDefaultLibCheck: boolean;
+    strict: boolean;
     paths: {};
 };
+export declare function getTsConfigBaseOptions(tree: Tree): {
+    rootDir: string;
+    sourceMap: boolean;
+    declaration: boolean;
+    emitDecoratorMetadata: boolean;
+    experimentalDecorators: boolean;
+    importHelpers: boolean;
+    target: string;
+    module: string;
+    lib: string[];
+    skipLibCheck: boolean;
+    skipDefaultLibCheck: boolean;
+    strict: boolean;
+    paths: {};
+    moduleResolution: "bundler" | "node10";
+};
 export declare function extractTsConfigBase(host: Tree): void;

package/dist/src/utils/typescript/create-ts-config.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tsConfigBaseOptions = void 0;
+exports.getTsConfigBaseOptions = getTsConfigBaseOptions;
 exports.extractTsConfigBase = extractTsConfigBase;
 const json_1 = require("nx/src/generators/utils/json");
+const is_typescript_version_at_least_1 = require("../is-typescript-version-at-least");
 exports.tsConfigBaseOptions = {
     rootDir: '.',
     sourceMap: true,
@@ -16,8 +18,17 @@ exports.tsConfigBaseOptions = {
     lib: ['es2020', 'dom'],
     skipLibCheck: true,
     skipDefaultLibCheck: true,
+    // TS 6.0 flips the `strict` default to true; pin false to keep this base
+    // config's behavior identical on TS 5.8 and 6.0.
+    strict: false,
     paths: {},
 };
+function getTsConfigBaseOptions(tree) {
+    return {
+        ...exports.tsConfigBaseOptions,
+        moduleResolution: (0, is_typescript_version_at_least_1.getTsConfigModuleResolution)(tree),
+    };
+}
 function extractTsConfigBase(host) {
     if (host.exists('tsconfig.base.json'))
         return;

package/dist/src/utils/versions.d.ts

@@ -8,10 +8,10 @@ export declare const swcNodeVersion = "~1.11.1";
 export declare const tsLibVersion = "^2.3.0";
 export declare const typesNodeVersion = "^22.0.0";
 export declare const verdaccioVersion = "^6.3.2";
-export declare const typescriptVersion = "~5.9.2";
+export declare const typescriptVersion = "~6.0.3";
 /**
  * The minimum version is currently determined from the lowest version
  * that's supported by the lowest Angular supported version, e.g.
- * `npm view @angular/compiler-cli@18.0.0 peerDependencies.typescript`
+ * `npm view @angular/compiler-cli@20.0.0 peerDependencies.typescript`
  */
-export declare const minSupportedTypescriptVersion = "5.4.0";
+export declare const minSupportedTypescriptVersion = "5.8.0";

package/dist/src/utils/versions.js

@@ -13,10 +13,10 @@ exports.tsLibVersion = '^2.3.0';
 exports.typesNodeVersion = '^22.0.0';
 exports.verdaccioVersion = '^6.3.2';
 // Typescript
-exports.typescriptVersion = '~5.9.2';
+exports.typescriptVersion = '~6.0.3';
 /**
  * The minimum version is currently determined from the lowest version
  * that's supported by the lowest Angular supported version, e.g.
- * `npm view @angular/compiler-cli@18.0.0 peerDependencies.typescript`
+ * `npm view @angular/compiler-cli@20.0.0 peerDependencies.typescript`
  */
-exports.minSupportedTypescriptVersion = '5.4.0';
+exports.minSupportedTypescriptVersion = '5.8.0';

package/migrations.json

@@ -28,6 +28,15 @@
       "description": "Rename imports of `createNodesV2` from `@nx/js/typescript` to the canonical `createNodes` export.",
       "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
       "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md"
+    },
+    "23-1-0-add-ignore-deprecations-for-ts6": {
+      "version": "23.1.0-beta.0",
+      "description": "Adds `\"ignoreDeprecations\": \"6.0\"` to tsconfig files whose compilerOptions (or ts-node.compilerOptions) directly carry a TypeScript 6 deprecated option value (e.g. moduleResolution node/node10/classic, baseUrl, target es5, esModuleInterop false, outFile, module amd/umd/system/none, alwaysStrict false, allowSyntheticDefaultImports false, downlevelIteration set). Also pins `\"strict\": false` and `\"noUncheckedSideEffectImports\": false` in chain-root tsconfigs (no \"extends\") that lack each key, preserving pre-TS6 behavior where their defaults were less strict.",
+      "requires": {
+        "typescript": ">=6.0.0"
+      },
+      "factory": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6",
+      "documentation": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.md"
     }
   },
   "packageJsonUpdates": {
@@ -106,6 +115,21 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "23.1.0-typescript": {
+      "version": "23.1.0-beta.0",
+      "incompatibleWith": {
+        "@remix-run/dev": "*"
+      },
+      "requires": {
+        "typescript": ">=5.9.0 <6.0.0"
+      },
+      "packages": {
+        "typescript": {
+          "version": "~6.0.3",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/js",
-  "version": "23.0.0",
+  "version": "23.1.0-beta.0",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -144,11 +144,11 @@
     "source-map-support": "0.5.19",
     "tinyglobby": "^0.2.12",
     "tslib": "^2.3.0",
-    "@nx/devkit": "23.0.0",
-    "@nx/workspace": "23.0.0"
+    "@nx/devkit": "23.1.0-beta.0",
+    "@nx/workspace": "23.1.0-beta.0"
   },
   "devDependencies": {
-    "nx": "23.0.0"
+    "nx": "23.1.0-beta.0"
   },
   "peerDependencies": {
     "@swc/cli": ">=0.6.0 <0.9.0",