@nx/js 23.0.0-beta.2 → 23.0.0-beta.21

package/{src → dist/src}/generators/init/init.js

@@ -2,41 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initGenerator = initGenerator;
 exports.initGeneratorInternal = initGeneratorInternal;
+const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
-const add_plugin_1 = require("@nx/devkit/src/utils/add-plugin");
-const semver_1 = require("@nx/devkit/src/utils/semver");
-const package_json_1 = require("nx/src/utils/package-json");
 const path_1 = require("path");
-const semver_2 = require("semver");
 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 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");
-async function getInstalledTypescriptVersion(tree) {
-    const tsVersionInRootPackageJson = (0, devkit_1.getDependencyVersionFromPackageJson)(tree, 'typescript');
-    if (!tsVersionInRootPackageJson) {
-        return null;
-    }
-    if ((0, semver_2.valid)(tsVersionInRootPackageJson)) {
-        // it's a pinned version, return it
-        return tsVersionInRootPackageJson;
-    }
-    // it's a version range, check whether the installed version matches it
-    try {
-        const tsPackageJson = (0, package_json_1.readModulePackageJson)('typescript').packageJson;
-        const installedTsVersion = tsPackageJson.devDependencies?.['typescript'] ??
-            tsPackageJson.dependencies?.['typescript'];
-        // the installed version matches the package.json version range
-        if (installedTsVersion &&
-            (0, semver_2.satisfies)(installedTsVersion, tsVersionInRootPackageJson)) {
-            return installedTsVersion;
-        }
-    }
-    finally {
-        return (0, semver_1.checkAndCleanWithSemver)(tree, 'typescript', tsVersionInRootPackageJson);
-    }
-}
 async function initGenerator(tree, schema) {
     schema.addTsPlugin ??= false;
     const isUsingNewTsSetup = schema.addTsPlugin || (0, ts_solution_setup_1.isUsingTsSolutionSetup)(tree);
@@ -47,6 +21,7 @@ async function initGenerator(tree, schema) {
     });
 }
 async function initGeneratorInternal(tree, schema) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     const tasks = [];
     const nxJson = (0, devkit_1.readNxJson)(tree);
     schema.addPlugin ??=
@@ -54,7 +29,7 @@ async function initGeneratorInternal(tree, schema) {
             nxJson.useInferencePlugins !== false;
     schema.addTsPlugin ??= schema.addPlugin;
     if (schema.addTsPlugin) {
-        await (0, add_plugin_1.addPlugin)(tree, await (0, devkit_1.createProjectGraphAsync)(), '@nx/js/typescript', plugin_1.createNodesV2, {
+        await (0, internal_1.addPlugin)(tree, await (0, devkit_1.createProjectGraphAsync)(), '@nx/js/typescript', plugin_1.createNodesV2, {
             typecheck: [
                 { targetName: 'typecheck' },
                 { targetName: 'tsc:typecheck' },
@@ -100,20 +75,18 @@ async function initGeneratorInternal(tree, schema) {
     }
     const devDependencies = {
         '@nx/js': versions_1.nxVersion,
-        // When loading .ts config files (e.g. webpack.config.ts, jest.config.ts, etc.)
-        // we prefer to use SWC, and fallback to ts-node for workspaces that don't use SWC.
-        '@swc-node/register': versions_1.swcNodeVersion,
-        '@swc/core': versions_1.swcCoreVersion,
+        // Required by SWC-compiled output (decorators -> @swc/helpers/_/_ts_decorate
+        // imports). The default @nx/jest setup transforms with @swc/jest, so any
+        // workspace using decorators (NestJS, Angular, etc.) needs @swc/helpers
+        // resolvable at test time. Cheap to ship and avoids per-generator install.
         '@swc/helpers': versions_1.swcHelpersVersion,
     };
-    if (!schema.js && !schema.keepExistingVersions) {
-        const installedTsVersion = await getInstalledTypescriptVersion(tree);
-        if (!installedTsVersion ||
-            !(0, semver_2.satisfies)(installedTsVersion, versions_1.supportedTypescriptVersions, {
-                includePrerelease: true,
-            })) {
-            devDependencies['typescript'] = versions_1.typescriptVersion;
-        }
+    // @swc-node/register and @swc/core are no longer installed by init - native
+    // Node.js type stripping handles .ts config loading on Node 23+ (or 22.6+
+    // with --experimental-strip-types). loadTsFile registers swc/ts-node lazily
+    // when a config uses syntax native strip can't handle.
+    if (!schema.js) {
+        devDependencies['typescript'] = versions_1.typescriptVersion;
     }
     if (schema.formatter === 'prettier') {
         const prettierTask = (0, prettier_1.generatePrettierSetup)(tree, {
@@ -131,7 +104,7 @@ async function initGeneratorInternal(tree, schema) {
         }
     }
     const installTask = !schema.skipPackageJson
-        ? (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDependencies, undefined, schema.keepExistingVersions)
+        ? (0, devkit_1.addDependenciesToPackageJson)(tree, {}, devDependencies, undefined, schema.keepExistingVersions ?? true)
         : () => { };
     tasks.push(installTask);
     if (!schema.skipPackageJson &&

package/{src → dist/src}/generators/init/schema.json

@@ -31,7 +31,7 @@
       "type": "boolean",
       "x-priority": "internal",
       "description": "Keep existing dependencies versions",
-      "default": false
+      "default": true
     },
     "addTsConfigBase": {
       "type": "boolean",

package/{src → dist/src}/generators/library/library.d.ts

@@ -5,4 +5,3 @@ export declare function libraryGeneratorInternal(tree: Tree, schema: LibraryGene
 export type AddLintOptions = Pick<NormalizedLibraryGeneratorOptions, 'name' | 'linter' | 'projectRoot' | 'unitTestRunner' | 'js' | 'setParserOptionsProject' | 'rootProject' | 'bundler' | 'addPlugin' | 'isUsingTsSolutionConfig'>;
 export declare function addLint(tree: Tree, options: AddLintOptions): Promise<GeneratorCallback>;
 export default libraryGenerator;
-//# sourceMappingURL=library.d.ts.map

package/{src → dist/src}/generators/library/library.js

@@ -4,12 +4,10 @@ exports.libraryGenerator = libraryGenerator;
 exports.libraryGeneratorInternal = libraryGeneratorInternal;
 exports.addLint = addLint;
 const tslib_1 = require("tslib");
+const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
-const project_name_and_root_utils_1 = require("@nx/devkit/src/generators/project-name-and-root-utils");
-const prompt_1 = require("@nx/devkit/src/generators/prompt");
-const target_defaults_utils_1 = require("@nx/devkit/src/generators/target-defaults-utils");
-const log_show_project_command_1 = require("@nx/devkit/src/utils/log-show-project-command");
 const path_1 = require("path");
+const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const generator_prompts_1 = require("../../utils/generator-prompts");
 const sort_fields_1 = require("../../utils/package-json/sort-fields");
 const update_package_json_1 = require("../../utils/package-json/update-package-json");
@@ -33,6 +31,7 @@ async function libraryGenerator(tree, schema) {
     });
 }
 async function libraryGeneratorInternal(tree, schema) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     const tasks = [];
     const addTsPlugin = (0, ts_solution_setup_1.shouldConfigureTsSolutionSetup)(tree, schema.addPlugin);
     tasks.push(await (0, init_1.default)(tree, {
@@ -153,7 +152,7 @@ async function libraryGeneratorInternal(tree, schema) {
         tasks.push(() => (0, devkit_1.installPackagesTask)(tree, true));
     }
     tasks.push(() => {
-        (0, log_show_project_command_1.logShowProjectCommand)(options.name);
+        (0, internal_1.logShowProjectCommand)(options.name);
     });
     return (0, devkit_1.runTasksInSerial)(...tasks);
 }
@@ -177,7 +176,7 @@ async function configureProject(tree, options) {
                 options.bundler === 'tsc'))) {
         const outputPath = getOutputPath(options);
         const executor = getBuildExecutor(options.bundler);
-        (0, target_defaults_utils_1.addBuildTargetDefaults)(tree, executor);
+        (0, internal_1.addBuildTargetDefaults)(tree, executor);
         projectConfiguration.targets.build = {
             executor,
             outputs: ['{options.outputPath}'],
@@ -267,7 +266,7 @@ async function addLint(tree, options) {
     });
     const { addOverrideToLintConfig, lintConfigHasOverride, isEslintConfigSupported, updateOverrideInLintConfig, addIgnoresToLintConfig,
     // nx-ignore-next-line
-     } = require('@nx/eslint/src/generators/utils/eslint-file');
+     } = require('@nx/eslint/internal');
     // if config is not supported, we don't need to do anything
     if (!isEslintConfigSupported(tree)) {
         return task;
@@ -318,7 +317,12 @@ async function addLint(tree, options) {
                 ignoredFiles.add('{projectRoot}/esbuild.config.{js,ts,mjs,mts}');
             }
             if (options.unitTestRunner === 'vitest') {
-                ignoredFiles.add('{projectRoot}/vite.config.{js,ts,mjs,mts}');
+                // When bundler is 'vite', vite.config holds both build and test config
+                // (added above). Otherwise, @nx/vitest:configuration generates a
+                // dedicated vitest.config file for non-framework JS libraries.
+                ignoredFiles.add(options.bundler === 'vite'
+                    ? '{projectRoot}/vite.config.{js,ts,mjs,mts}'
+                    : '{projectRoot}/vitest.config.{js,ts,mjs,mts}');
             }
             if (ignoredFiles.size) {
                 ruleOptions.ignoredFiles = Array.from(ignoredFiles);
@@ -535,7 +539,7 @@ function replaceJestConfig(tree, options) {
     });
 }
 async function normalizeOptions(tree, options) {
-    await (0, project_name_and_root_utils_1.ensureRootProjectName)(options, 'library');
+    await (0, internal_1.ensureRootProjectName)(options, 'library');
     const nxJson = (0, devkit_1.readNxJson)(tree);
     options.addPlugin ??=
         process.env.NX_ADD_PLUGINS !== 'false' &&
@@ -544,7 +548,7 @@ async function normalizeOptions(tree, options) {
     const hasPlugin = (0, ts_solution_setup_1.isUsingTypeScriptPlugin)(tree);
     const isUsingTsSolutionConfig = (0, ts_solution_setup_1.isUsingTsSolutionSetup)(tree);
     if (isUsingTsSolutionConfig) {
-        options.unitTestRunner ??= await (0, prompt_1.promptWhenInteractive)({
+        options.unitTestRunner ??= await (0, internal_1.promptWhenInteractive)({
             type: 'autocomplete',
             name: 'unitTestRunner',
             message: `Which unit test runner would you like to use?`,
@@ -553,7 +557,7 @@ async function normalizeOptions(tree, options) {
         }, { unitTestRunner: 'none' }).then(({ unitTestRunner }) => unitTestRunner);
     }
     else {
-        options.unitTestRunner ??= await (0, prompt_1.promptWhenInteractive)({
+        options.unitTestRunner ??= await (0, internal_1.promptWhenInteractive)({
             type: 'autocomplete',
             name: 'unitTestRunner',
             message: `Which unit test runner would you like to use?`,
@@ -614,7 +618,7 @@ async function normalizeOptions(tree, options) {
         (options.skipTypeCheck == null || !isUsingTsSolutionConfig)) {
         options.skipTypeCheck = false;
     }
-    const { projectName, names: projectNames, projectRoot, importPath, } = await (0, project_name_and_root_utils_1.determineProjectNameAndRootOptions)(tree, {
+    const { projectName, names: projectNames, projectRoot, importPath, } = await (0, internal_1.determineProjectNameAndRootOptions)(tree, {
         name: options.name,
         projectType: 'library',
         directory: options.directory,
@@ -652,7 +656,7 @@ function addProjectDependencies(tree, options) {
             '@types/node': versions_1.typesNodeVersion,
             esbuild: (0, devkit_1.getDependencyVersionFromPackageJson)(tree, 'esbuild') ??
                 versions_1.esbuildVersion,
-        });
+        }, undefined, true);
     }
     else if (options.bundler == 'rollup') {
         const { dependencies, devDependencies } = (0, add_swc_dependencies_1.getSwcDependencies)();
@@ -660,17 +664,17 @@ function addProjectDependencies(tree, options) {
             ...devDependencies,
             '@nx/rollup': versions_1.nxVersion,
             '@types/node': versions_1.typesNodeVersion,
-        });
+        }, undefined, true);
     }
     else if (options.bundler === 'tsc') {
-        return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { tslib: versions_1.tsLibVersion, '@types/node': versions_1.typesNodeVersion });
+        return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { tslib: versions_1.tsLibVersion, '@types/node': versions_1.typesNodeVersion }, undefined, true);
     }
     else if (options.bundler === 'swc') {
         const { dependencies, devDependencies } = (0, add_swc_dependencies_1.getSwcDependencies)();
-        return (0, devkit_1.addDependenciesToPackageJson)(tree, { ...dependencies }, { ...devDependencies, '@types/node': versions_1.typesNodeVersion });
+        return (0, devkit_1.addDependenciesToPackageJson)(tree, { ...dependencies }, { ...devDependencies, '@types/node': versions_1.typesNodeVersion }, undefined, true);
     }
     else {
-        return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@types/node': versions_1.typesNodeVersion });
+        return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@types/node': versions_1.typesNodeVersion }, undefined, true);
     }
     // Vite is being installed in the next step if bundler is vite
     // noop

package/{src → dist/src}/generators/library/schema.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectNameAndRootOptions } from '@nx/devkit/src/generators/project-name-and-root-utils';
+import type { ProjectNameAndRootOptions } from '@nx/devkit/internal';
 // nx-ignore-next-line
 const { Linter, LinterType } = require('@nx/eslint'); // use require to import to avoid circular dependency
 import type { ProjectPackageManagerWorkspaceState } from '../../utils/package-manager-workspaces';

package/{src → dist/src}/generators/library/utils/add-release-config.d.ts

@@ -9,4 +9,3 @@ export declare function addReleaseConfigForTsSolution(tree: Tree, projectName: s
  */
 export declare function addReleaseConfigForNonTsSolution(tree: Tree, projectName: string, projectConfiguration: ProjectConfiguration, defaultOutputDirectory?: string): Promise<ProjectConfiguration>;
 export declare function releaseTasks(tree: Tree): Promise<GeneratorCallback>;
-//# sourceMappingURL=add-release-config.d.ts.map

package/dist/src/generators/release-version/release-version.d.ts

@@ -0,0 +1 @@
+export {};

package/{src → dist/src}/generators/setup-build/generator.d.ts

@@ -2,4 +2,3 @@ import { type GeneratorCallback, type Tree } from '@nx/devkit';
 import { SetupBuildGeneratorSchema } from './schema';
 export declare function setupBuildGenerator(tree: Tree, options: SetupBuildGeneratorSchema): Promise<GeneratorCallback>;
 export default setupBuildGenerator;
-//# sourceMappingURL=generator.d.ts.map

package/{src → dist/src}/generators/setup-build/generator.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupBuildGenerator = setupBuildGenerator;
+const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
-const target_defaults_utils_1 = require("@nx/devkit/src/generators/target-defaults-utils");
 const posix_1 = require("node:path/posix");
 const devkit_internals_1 = require("nx/src/devkit-internals");
+const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const get_import_path_1 = require("../../utils/get-import-path");
 const update_package_json_1 = require("../../utils/package-json/update-package-json");
 const add_swc_config_1 = require("../../utils/swc/add-swc-config");
@@ -16,6 +17,7 @@ const ts_solution_setup_1 = require("../../utils/typescript/ts-solution-setup");
 const versions_1 = require("../../utils/versions");
 let ts;
 async function setupBuildGenerator(tree, options) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     const tasks = [];
     const project = (0, devkit_1.readProjectConfiguration)(tree, options.project);
     options.buildTarget ??= 'build';
@@ -127,7 +129,7 @@ async function setupBuildGenerator(tree, options) {
                 updatePackageJsonForTsc(tree, options, project);
             }
             else {
-                (0, target_defaults_utils_1.addBuildTargetDefaults)(tree, '@nx/js:tsc');
+                (0, internal_1.addBuildTargetDefaults)(tree, '@nx/js:tsc');
                 const outputPath = (0, devkit_1.joinPathFragments)('dist', project.root);
                 project.targets[options.buildTarget] = {
                     executor: `@nx/js:tsc`,
@@ -144,7 +146,7 @@ async function setupBuildGenerator(tree, options) {
             break;
         }
         case 'swc': {
-            (0, target_defaults_utils_1.addBuildTargetDefaults)(tree, '@nx/js:swc');
+            (0, internal_1.addBuildTargetDefaults)(tree, '@nx/js:swc');
             const outputPath = isTsSolutionSetup
                 ? (0, devkit_1.joinPathFragments)(project.root, 'dist')
                 : (0, devkit_1.joinPathFragments)('dist', project.root);
@@ -247,7 +249,5 @@ function updatePackageJson(tree, projectName, projectRoot, main, outputPath, roo
 function mergeTargetDefaults(tree, project, buildTarget) {
     const nxJson = (0, devkit_1.readNxJson)(tree);
     const projectTarget = project.targets[buildTarget];
-    return (0, devkit_internals_1.mergeTargetConfigurations)(projectTarget, (projectTarget.executor
-        ? nxJson.targetDefaults?.[projectTarget.executor]
-        : undefined) ?? nxJson.targetDefaults?.[buildTarget]);
+    return (0, devkit_internals_1.mergeTargetConfigurations)(projectTarget, (0, internal_1.readTargetDefaultsForTarget)(buildTarget, nxJson.targetDefaults, projectTarget.executor));
 }

package/{src → dist/src}/generators/setup-prettier/generator.d.ts

@@ -2,4 +2,3 @@ import { type GeneratorCallback, type Tree } from '@nx/devkit';
 import type { GeneratorOptions } from './schema';
 export declare function setupPrettierGenerator(tree: Tree, options: GeneratorOptions): Promise<GeneratorCallback>;
 export default setupPrettierGenerator;
-//# sourceMappingURL=generator.d.ts.map

package/{src → dist/src}/generators/setup-prettier/generator.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupPrettierGenerator = setupPrettierGenerator;
 const devkit_1 = require("@nx/devkit");
+const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const prettier_1 = require("../../utils/prettier");
 const versions_1 = require("../../utils/versions");
 async function setupPrettierGenerator(tree, options) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     const prettierTask = (0, prettier_1.generatePrettierSetup)(tree, {
         skipPackageJson: options.skipPackageJson,
     });

package/{src → dist/src}/generators/setup-verdaccio/generator.d.ts

@@ -2,4 +2,3 @@ import { Tree } from '@nx/devkit';
 import { SetupVerdaccioGeneratorSchema } from './schema';
 export declare function setupVerdaccio(tree: Tree, options: SetupVerdaccioGeneratorSchema): Promise<import("@nx/devkit").GeneratorCallback>;
 export default setupVerdaccio;
-//# sourceMappingURL=generator.d.ts.map

package/{src → dist/src}/generators/setup-verdaccio/generator.js

@@ -4,10 +4,12 @@ exports.setupVerdaccio = setupVerdaccio;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const path = tslib_1.__importStar(require("path"));
+const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const ts_solution_setup_1 = require("../../utils/typescript/ts-solution-setup");
 const versions_1 = require("../../utils/versions");
 const npm_config_1 = require("../../utils/npm-config");
 async function setupVerdaccio(tree, options) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     if (!tree.exists('.verdaccio/config.yml')) {
         (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files'), '.verdaccio', {
             npmUplinkRegistry: (await (0, npm_config_1.getNpmRegistry)(tree.root)) ?? 'https://registry.npmjs.org',
@@ -54,6 +56,6 @@ async function setupVerdaccio(tree, options) {
     if (!options.skipFormat) {
         await (0, devkit_1.formatFiles)(tree);
     }
-    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { verdaccio: versions_1.verdaccioVersion });
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { verdaccio: versions_1.verdaccioVersion }, undefined, true);
 }
 exports.default = setupVerdaccio;

package/{src → dist/src}/generators/typescript-sync/typescript-sync.d.ts

@@ -2,4 +2,3 @@ import { type Tree } from '@nx/devkit';
 import { type SyncGeneratorResult } from 'nx/src/utils/sync-generators';
 export declare function syncGenerator(tree: Tree): Promise<SyncGeneratorResult>;
 export default syncGenerator;
-//# sourceMappingURL=typescript-sync.d.ts.map

package/{src → dist/src}/generators/typescript-sync/typescript-sync.js

@@ -8,6 +8,7 @@ const jsonc_parser_1 = require("jsonc-parser");
 const posix_1 = require("node:path/posix");
 const sync_generators_1 = require("nx/src/utils/sync-generators");
 const ts = tslib_1.__importStar(require("typescript"));
+const assert_supported_typescript_version_1 = require("../../utils/assert-supported-typescript-version");
 const COMMON_RUNTIME_TS_CONFIG_FILE_NAMES = [
     'tsconfig.app.json',
     'tsconfig.lib.json',
@@ -17,6 +18,7 @@ const COMMON_RUNTIME_TS_CONFIG_FILE_NAMES = [
     'tsconfig.runtime.json',
 ];
 async function syncGenerator(tree) {
+    (0, assert_supported_typescript_version_1.assertSupportedTypescriptVersion)(tree);
     // Ensure that the plugin has been wired up in nx.json
     const nxJson = (0, devkit_1.readNxJson)(tree);
     const tsconfigInfoCaches = {

package/{src → dist/src}/index.d.ts

@@ -18,4 +18,3 @@ export { setupVerdaccio } from './generators/setup-verdaccio/generator';
 export { isValidVariable } from './utils/is-valid-variable';
 export { createLockFile, getLockFileName, } from 'nx/src/plugins/js/lock-file/lock-file';
 export { createPackageJson } from 'nx/src/plugins/js/package-json/create-package-json';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/internal.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @deprecated Backwards-compatibility shim for `@nx/js/src/internal`.
+ *
+ * The `./src/internal` subpath was removed in nx 23 — the canonical path is
+ * now `@nx/js/internal`.  Additionally, `getRootTsConfigPath` moved to the
+ * main `@nx/js` entry.
+ *
+ * This shim keeps `@nx/conformance@4` / `@nx/conformance@5.0.x` working on
+ * nx 23.  Both packages do:
+ *   `const { getRootTsConfigPath } = await import('@nx/js/src/internal')`
+ *   `const { registerTsProject }   = await import('@nx/js/src/internal')`
+ *
+ * Do NOT add new exports here.  Consumers should migrate to:
+ *   - `@nx/js/internal`   for `registerTsProject` (and other internal helpers)
+ *   - `@nx/js`            for `getRootTsConfigPath`
+ */
+export { registerTsProject } from '../internal';
+export { getRootTsConfigPath } from './utils/typescript/ts-config';

package/dist/src/internal.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @deprecated Backwards-compatibility shim for `@nx/js/src/internal`.
+ *
+ * The `./src/internal` subpath was removed in nx 23 — the canonical path is
+ * now `@nx/js/internal`.  Additionally, `getRootTsConfigPath` moved to the
+ * main `@nx/js` entry.
+ *
+ * This shim keeps `@nx/conformance@4` / `@nx/conformance@5.0.x` working on
+ * nx 23.  Both packages do:
+ *   `const { getRootTsConfigPath } = await import('@nx/js/src/internal')`
+ *   `const { registerTsProject }   = await import('@nx/js/src/internal')`
+ *
+ * Do NOT add new exports here.  Consumers should migrate to:
+ *   - `@nx/js/internal`   for `registerTsProject` (and other internal helpers)
+ *   - `@nx/js`            for `getRootTsConfigPath`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRootTsConfigPath = exports.registerTsProject = void 0;
+// registerTsProject lives in the new ./internal entry
+var internal_1 = require("../internal");
+Object.defineProperty(exports, "registerTsProject", { enumerable: true, get: function () { return internal_1.registerTsProject; } });
+// getRootTsConfigPath moved to the main @nx/js entry in nx 23
+var ts_config_1 = require("./utils/typescript/ts-config");
+Object.defineProperty(exports, "getRootTsConfigPath", { enumerable: true, get: function () { return ts_config_1.getRootTsConfigPath; } });

package/{src → dist/src}/migrations/update-21-5-0/migrate-development-custom-condition.d.ts

@@ -1,3 +1,2 @@
 import { type Tree } from '@nx/devkit';
 export default function (tree: Tree): Promise<void>;
-//# sourceMappingURL=migrate-development-custom-condition.d.ts.map

package/dist/src/migrations/update-21-5-0/migrate-development-custom-condition.md

@@ -0,0 +1,87 @@
+#### Migrate `development` custom condition to unique workspace-specific name
+
+Replace the TypeScript `development` custom condition with a unique workspace-specific name to avoid conflicts when consuming packages in other workspaces.
+
+#### Examples
+
+The migration will update the custom condition name in both `tsconfig.base.json` and all workspace package.json files that use the `development` custom condition:
+
+##### Before
+
+```json title="tsconfig.base.json" {3}
+{
+  "compilerOptions": {
+    "customConditions": ["development"]
+  }
+}
+```
+
+##### After
+
+```json title="tsconfig.base.json" {3}
+{
+  "compilerOptions": {
+    "customConditions": ["@my-org/source"] // assuming the root package.json name is `@my-org/source`
+  }
+}
+```
+
+The migration also updates `package.json` files that use the `development` condition in their `exports` field and point to TypeScript files:
+
+##### Before
+
+```json title="libs/my-lib/package.json" {5}
+{
+  "name": "@myorg/my-lib",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}
+```
+
+##### After
+
+```json title="libs/my-lib/package.json" {5}
+{
+  "name": "@myorg/my-lib",
+  "exports": {
+    ".": {
+      "@my-org/source": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}
+```
+
+If the custom condition is not set to `["development"]` or the `package.json`'s `exports` field doesn't point to TypeScript files, the migration will not modify the configuration:
+
+##### Before
+
+```json title="libs/my-lib/package.json" {5}
+{
+  "name": "@myorg/my-lib",
+  "exports": {
+    ".": {
+      "development": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  }
+}
+```
+
+##### After
+
+```json title="libs/my-lib/package.json" {5}
+{
+  "name": "@myorg/my-lib",
+  "exports": {
+    ".": {
+      "development": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  }
+}
+```

package/{src → dist/src}/migrations/update-22-0-0/remove-external-options-from-js-executors.d.ts

@@ -1,4 +1,3 @@
 import { type Tree } from '@nx/devkit';
 export declare const executors: string[];
 export default function (tree: Tree): Promise<void>;
-//# sourceMappingURL=remove-external-options-from-js-executors.d.ts.map

package/dist/src/migrations/update-22-0-0/remove-external-options-from-js-executors.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executors = void 0;
+exports.default = default_1;
+const internal_1 = require("@nx/devkit/internal");
+const devkit_1 = require("@nx/devkit");
+exports.executors = ['@nx/js:swc', '@nx/js:tsc'];
+async function default_1(tree) {
+    // update options from project configs
+    exports.executors.forEach((executor) => {
+        (0, internal_1.forEachExecutorOptions)(tree, executor, (options, project, target, configuration) => {
+            if (options.external === undefined &&
+                options.externalBuildTargets === undefined) {
+                return;
+            }
+            const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, project);
+            if (configuration) {
+                const config = projectConfiguration.targets[target].configurations[configuration];
+                delete config.external;
+                delete config.externalBuildTargets;
+            }
+            else {
+                const config = projectConfiguration.targets[target].options;
+                delete config.external;
+                delete config.externalBuildTargets;
+                if (!Object.keys(config).length) {
+                    delete projectConfiguration.targets[target].options;
+                }
+            }
+            (0, devkit_1.updateProjectConfiguration)(tree, project, projectConfiguration);
+        });
+    });
+    // update options from nx.json target defaults
+    const nxJson = (0, devkit_1.readNxJson)(tree);
+    if (!nxJson.targetDefaults) {
+        return;
+    }
+    const cleanEntry = (entry) => {
+        if (entry.options) {
+            delete entry.options.external;
+            delete entry.options.externalBuildTargets;
+            if (!Object.keys(entry.options).length) {
+                delete entry.options;
+            }
+        }
+        Object.entries(entry.configurations ?? {}).forEach(([, config]) => {
+            delete config.external;
+            delete config.externalBuildTargets;
+        });
+    };
+    if (Array.isArray(nxJson.targetDefaults)) {
+        const remaining = [];
+        for (const entry of nxJson.targetDefaults) {
+            const matches = exports.executors.includes(entry.executor) || exports.executors.includes(entry.target);
+            if (!matches) {
+                remaining.push(entry);
+                continue;
+            }
+            cleanEntry(entry);
+            const meaningfulKeys = Object.keys(entry).filter((k) => k !== 'target' &&
+                k !== 'executor' &&
+                k !== 'projects' &&
+                k !== 'plugin');
+            if (meaningfulKeys.length === 0)
+                continue;
+            remaining.push(entry);
+        }
+        if (remaining.length === 0) {
+            delete nxJson.targetDefaults;
+        }
+        else {
+            nxJson.targetDefaults = remaining;
+        }
+    }
+    else {
+        for (const [targetOrExecutor, targetConfig] of Object.entries(nxJson.targetDefaults)) {
+            if (!exports.executors.includes(targetOrExecutor) &&
+                !exports.executors.includes(targetConfig.executor)) {
+                continue;
+            }
+            cleanEntry(targetConfig);
+            if (!Object.keys(targetConfig).length ||
+                (Object.keys(targetConfig).length === 1 &&
+                    Object.keys(targetConfig)[0] === 'executor')) {
+                delete nxJson.targetDefaults[targetOrExecutor];
+            }
+            if (!Object.keys(nxJson.targetDefaults).length) {
+                delete nxJson.targetDefaults;
+            }
+        }
+    }
+    (0, devkit_1.updateNxJson)(tree, nxJson);
+    await (0, devkit_1.formatFiles)(tree);
+}