@nx/js 24.0.0-beta.1 → 24.0.0-beta.3

package/dist/internal.d.ts

@@ -7,6 +7,7 @@ export { PNPM_INSTALL_SETTINGS_INPUTS, PNPM_MAJOR_RUNTIME_INPUT, pnpmInstallSett
 export { addPnpmDeployOutputCacheInputs } from './src/utils/pnpm-deploy-output-cache-inputs';
 export type { MatchedTargetRef } from './src/utils/target-defaults-matching';
 export { TS_SOLUTION_SETUP_TSCONFIG_INPUT, addProjectToTsSolutionWorkspace, assertNotUsingTsSolutionSetup, findRuntimeTsConfigName, getDefinedCustomConditionName, getProjectSourceRoot, getProjectType, isUsingTsSolutionSetup, shouldConfigureTsSolutionSetup, updateTsconfigFiles, } from './src/utils/typescript/ts-solution-setup';
+export { ensureTypescriptPlugin, registerTypescriptPluginForTypecheck, } from './src/utils/typescript/add-typescript-plugin';
 export { getTsConfigBaseOptions } from './src/utils/typescript/create-ts-config';
 export { createTreeParseConfigHost, type TreeParseConfigHost, } from './src/utils/typescript/ts-config';
 export { ensureTypescript } from './src/utils/typescript/ensure-typescript';
@@ -23,6 +24,7 @@ export { getNpmScope } from './src/utils/package-json/get-npm-scope';
 export { getProjectPackageManagerWorkspaceState, getProjectPackageManagerWorkspaceStateWarningTask, } from './src/utils/package-manager-workspaces';
 export { findNpmDependencies } from './src/utils/find-npm-dependencies';
 export { addBuildAndWatchDepsTargets, isValidPackageJsonBuildConfig, } from './src/plugins/typescript/util';
+export { createTypecheckTarget, selectTypecheckTsConfig, type TypecheckTargetOptions, } from './src/plugins/typescript/typecheck-target';
 export { normalizeLinterOption, normalizeUnitTestRunnerOption, } from './src/utils/generator-prompts';
 export { detectLinters } from './src/utils/linter';
 export { addLintingToProject, type AddLintingToProjectOptions, } from './src/utils/add-linting-to-project';

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.isValidPackageJsonBuildConfig = exports.addBuildAndWatchDepsTargets = exports.findNpmDependencies = exports.getProjectPackageManagerWorkspaceStateWarningTask = exports.getProjectPackageManagerWorkspaceState = exports.getNpmScope = exports.sortPackageJsonFields = exports.CopyAssetsHandler = exports.addSwcRegisterDependencies = exports.addSwcDependencies = exports.acknowledgeSwcBuildScripts = 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.createTreeParseConfigHost = 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.addPnpmDeployOutputCacheInputs = exports.shouldIncludePnpmMajorRuntimeInput = exports.pnpmInstallSettingsInputsForInferredTarget = exports.PNPM_MAJOR_RUNTIME_INPUT = exports.PNPM_INSTALL_SETTINGS_INPUTS = 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 = exports.addReleaseConfigForNonTsSolution = exports.addLocalRegistryScripts = exports.stripGlobToBaseDir = exports.getImportPath = exports.createGlobPatternsForDependencies = exports.addLintingToProject = exports.detectLinters = exports.normalizeUnitTestRunnerOption = exports.normalizeLinterOption = void 0;
+exports.findNpmDependencies = exports.getProjectPackageManagerWorkspaceStateWarningTask = exports.getProjectPackageManagerWorkspaceState = exports.getNpmScope = exports.sortPackageJsonFields = exports.CopyAssetsHandler = exports.addSwcRegisterDependencies = exports.addSwcDependencies = exports.acknowledgeSwcBuildScripts = 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.createTreeParseConfigHost = exports.getTsConfigBaseOptions = exports.registerTypescriptPluginForTypecheck = exports.ensureTypescriptPlugin = 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.addPnpmDeployOutputCacheInputs = exports.shouldIncludePnpmMajorRuntimeInput = exports.pnpmInstallSettingsInputsForInferredTarget = exports.PNPM_MAJOR_RUNTIME_INPUT = exports.PNPM_INSTALL_SETTINGS_INPUTS = 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 = exports.addReleaseConfigForNonTsSolution = exports.addLocalRegistryScripts = exports.stripGlobToBaseDir = exports.getImportPath = exports.createGlobPatternsForDependencies = exports.addLintingToProject = exports.detectLinters = exports.normalizeUnitTestRunnerOption = exports.normalizeLinterOption = exports.selectTypecheckTsConfig = exports.createTypecheckTarget = exports.isValidPackageJsonBuildConfig = exports.addBuildAndWatchDepsTargets = void 0;
 // Re-exports of nx-source internals.
 var internal_1 = require("@nx/devkit/internal");
 Object.defineProperty(exports, "forceRegisterEsmLoader", { enumerable: true, get: function () { return internal_1.forceRegisterEsmLoader; } });
@@ -46,6 +46,9 @@ 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; } });
+var add_typescript_plugin_1 = require("./src/utils/typescript/add-typescript-plugin");
+Object.defineProperty(exports, "ensureTypescriptPlugin", { enumerable: true, get: function () { return add_typescript_plugin_1.ensureTypescriptPlugin; } });
+Object.defineProperty(exports, "registerTypescriptPluginForTypecheck", { enumerable: true, get: function () { return add_typescript_plugin_1.registerTypescriptPluginForTypecheck; } });
 // TypeScript helpers. resolvePathsBaseUrl, extractTsConfigBase,
 // tsConfigBaseOptions, addTsLibDependencies, and resolveModuleByImport ship via
 // the public @nx/js entry. getTsConfigBaseOptions is public too, but is
@@ -94,6 +97,9 @@ Object.defineProperty(exports, "findNpmDependencies", { enumerable: true, get: f
 var util_1 = require("./src/plugins/typescript/util");
 Object.defineProperty(exports, "addBuildAndWatchDepsTargets", { enumerable: true, get: function () { return util_1.addBuildAndWatchDepsTargets; } });
 Object.defineProperty(exports, "isValidPackageJsonBuildConfig", { enumerable: true, get: function () { return util_1.isValidPackageJsonBuildConfig; } });
+var typecheck_target_1 = require("./src/plugins/typescript/typecheck-target");
+Object.defineProperty(exports, "createTypecheckTarget", { enumerable: true, get: function () { return typecheck_target_1.createTypecheckTarget; } });
+Object.defineProperty(exports, "selectTypecheckTsConfig", { enumerable: true, get: function () { return typecheck_target_1.selectTypecheckTsConfig; } });
 // Generator helpers
 var generator_prompts_1 = require("./src/utils/generator-prompts");
 Object.defineProperty(exports, "normalizeLinterOption", { enumerable: true, get: function () { return generator_prompts_1.normalizeLinterOption; } });

package/dist/node.d.ts

@@ -0,0 +1 @@
+export { createNodes, createNodesV2, type NodeScriptsPluginOptions, } from './src/plugins/scripts/node-plugin';

package/dist/node.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesV2 = exports.createNodes = void 0;
+var node_plugin_1 = require("./src/plugins/scripts/node-plugin");
+Object.defineProperty(exports, "createNodes", { enumerable: true, get: function () { return node_plugin_1.createNodes; } });
+Object.defineProperty(exports, "createNodesV2", { enumerable: true, get: function () { return node_plugin_1.createNodesV2; } });

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

@@ -5,8 +5,8 @@ exports.initGeneratorInternal = initGeneratorInternal;
 const internal_1 = require("@nx/devkit/internal");
 const devkit_1 = require("@nx/devkit");
 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 add_typescript_plugin_1 = require("../../utils/typescript/add-typescript-plugin");
 const formatter_setup_1 = require("../../utils/formatter-setup");
 const nx_formatter_internals_1 = require("../../utils/nx-formatter-internals");
 const create_ts_config_1 = require("../../utils/typescript/create-ts-config");
@@ -36,39 +36,9 @@ 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 ??=
-        process.env.NX_ADD_PLUGINS !== 'false' &&
-            nxJson.useInferencePlugins !== false;
-    schema.addTsPlugin ??= schema.addPlugin;
+    schema.addTsPlugin ??= true;
     if (schema.addTsPlugin) {
-        await (0, internal_1.addPlugin)(tree, await (0, devkit_1.createProjectGraphAsync)(), '@nx/js/typescript', plugin_1.createNodesV2, {
-            typecheck: [
-                { targetName: 'typecheck' },
-                { targetName: 'tsc:typecheck' },
-                { targetName: 'tsc-typecheck' },
-            ],
-            build: [
-                {
-                    targetName: 'build',
-                    configName: 'tsconfig.lib.json',
-                    buildDepsName: 'build-deps',
-                    watchDepsName: 'watch-deps',
-                },
-                {
-                    targetName: 'tsc:build',
-                    configName: 'tsconfig.lib.json',
-                    buildDepsName: 'tsc:build-deps',
-                    watchDepsName: 'tsc:watch-deps',
-                },
-                {
-                    targetName: 'tsc-build',
-                    configName: 'tsconfig.lib.json',
-                    buildDepsName: 'tsc-build-deps',
-                    watchDepsName: 'tsc-watch-deps',
-                },
-            ],
-        }, schema.updatePackageScripts);
+        await (0, add_typescript_plugin_1.addTypescriptPlugin)(tree, schema.updatePackageScripts);
     }
     if (schema.addTsConfigBase && !(0, ts_config_1.getRootTsConfigFileName)(tree)) {
         if (schema.addTsPlugin) {

package/dist/src/generators/init/schema.d.ts

@@ -6,7 +6,6 @@ export interface InitSchema {
   skipFormat?: boolean;
   skipPackageJson?: boolean;
   tsConfigName?: string;
-  addPlugin?: boolean;
   updatePackageScripts?: boolean;
   addTsPlugin?: boolean;
   platform?: 'web' | 'node';

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

@@ -2,6 +2,6 @@ import { GeneratorCallback, Tree } from '@nx/devkit';
 import type { LibraryGeneratorSchema, NormalizedLibraryGeneratorOptions } from './schema';
 export declare function libraryGenerator(tree: Tree, schema: LibraryGeneratorSchema): Promise<GeneratorCallback>;
 export declare function libraryGeneratorInternal(tree: Tree, schema: LibraryGeneratorSchema): Promise<GeneratorCallback>;
-export type AddLintOptions = Pick<NormalizedLibraryGeneratorOptions, 'name' | 'linter' | 'projectRoot' | 'unitTestRunner' | 'js' | 'enableTypedLinting' | 'setParserOptionsProject' | 'rootProject' | 'bundler' | 'addPlugin' | 'isUsingTsSolutionConfig'>;
+export type AddLintOptions = Pick<NormalizedLibraryGeneratorOptions, 'name' | 'linter' | 'projectRoot' | 'unitTestRunner' | 'js' | 'enableTypedLinting' | 'setParserOptionsProject' | 'rootProject' | 'bundler' | 'isUsingTsSolutionConfig'>;
 export declare function addLint(tree: Tree, options: AddLintOptions): Promise<GeneratorCallback>;
 export default libraryGenerator;

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

@@ -26,7 +26,6 @@ const add_release_config_1 = require("./utils/add-release-config");
 const defaultOutputDirectory = 'dist';
 async function libraryGenerator(tree, schema) {
     return await libraryGeneratorInternal(tree, {
-        addPlugin: false,
         useProjectJson: true,
         ...schema,
     });
@@ -34,7 +33,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);
+    const addTsPlugin = (0, ts_solution_setup_1.shouldConfigureTsSolutionSetup)(tree);
     tasks.push(await (0, init_1.default)(tree, {
         ...schema,
         skipFormat: true,
@@ -72,7 +71,6 @@ async function libraryGeneratorInternal(tree, schema) {
             includeLib: true,
             skipFormat: true,
             testEnvironment: options.testEnvironment,
-            addPlugin: options.addPlugin,
         });
         tasks.push(viteTask);
         createOrEditViteConfig(tree, {
@@ -111,7 +109,6 @@ async function libraryGeneratorInternal(tree, schema) {
             compiler: options.compiler === 'swc' ? 'swc' : 'babel',
             passWithNoTests: options.passWithNoTests,
             skipPackageJson: options.skipPackageJson,
-            addPlugin: options.addPlugin,
         });
         tasks.push(vitestTask);
     }
@@ -255,7 +252,6 @@ async function addLint(tree, options) {
         return (0, add_linting_to_project_1.addLintingToProject)(tree, {
             linter: options.linter,
             project: options.name,
-            addPlugin: options.addPlugin,
             rootProject: options.rootProject,
             unitTestRunner: options.unitTestRunner,
         });
@@ -275,7 +271,6 @@ async function addLint(tree, options) {
         unitTestRunner: options.unitTestRunner,
         enableTypedLinting: isTypedLintingEnabled(options),
         rootProject: options.rootProject,
-        addPlugin: options.addPlugin,
         // Since the build target is inferred now, we need to let the generator know to add @nx/dependency-checks regardless.
         addPackageJsonDependencyChecks: options.bundler !== 'none',
     });
@@ -552,13 +547,10 @@ function replaceJestConfig(tree, options) {
 }
 async function normalizeOptions(tree, options) {
     await (0, internal_1.ensureRootProjectName)(options, 'library');
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    options.addPlugin ??=
-        process.env.NX_ADD_PLUGINS !== 'false' &&
-            nxJson.useInferencePlugins !== false;
     options.linter = await (0, generator_prompts_1.normalizeLinterOption)(tree, options.linter);
-    const hasPlugin = (0, ts_solution_setup_1.isUsingTypeScriptPlugin)(tree);
     const isUsingTsSolutionConfig = (0, ts_solution_setup_1.isUsingTsSolutionSetup)(tree);
+    // Outside TS solution setups the plugin may be registered for typecheck only.
+    const hasPlugin = isUsingTsSolutionConfig && (0, ts_solution_setup_1.isUsingTypeScriptPlugin)(tree);
     if (isUsingTsSolutionConfig) {
         options.unitTestRunner ??= (0, internal_1.isInteractive)()
             ? await (0, internal_1.selectPrompt)({

package/dist/src/generators/library/schema.d.ts

@@ -34,7 +34,6 @@ export interface LibraryGeneratorSchema {
   skipTypeCheck?: boolean;
   minimal?: boolean;
   rootProject?: boolean;
-  addPlugin?: boolean;
   useProjectJson?: boolean;
   useTscExecutor?: boolean;
   /** @internal Only honored by the vitest setup. */

package/dist/src/generators/setup-build/generator.js

@@ -72,9 +72,6 @@ async function setupBuildGenerator(tree, options) {
     }
     options.tsConfig = tsConfigFile;
     const isTsSolutionSetup = (0, ts_solution_setup_1.isUsingTsSolutionSetup)(tree);
-    const nxJson = (0, devkit_1.readNxJson)(tree);
-    const addPlugin = process.env.NX_ADD_PLUGINS !== 'false' &&
-        nxJson.useInferencePlugins !== false;
     switch (options.bundler) {
         case 'vite': {
             const { viteConfigurationGenerator } = (0, devkit_1.ensurePackage)('@nx/vite', versions_1.nxVersion);
@@ -85,7 +82,6 @@ async function setupBuildGenerator(tree, options) {
                 uiFramework: 'none',
                 includeVitest: false,
                 includeLib: true,
-                addPlugin,
                 skipFormat: true,
             });
             tasks.push(task);
@@ -113,7 +109,6 @@ async function setupBuildGenerator(tree, options) {
                 project: options.project,
                 compiler: 'tsc',
                 format: isTsSolutionSetup ? ['esm'] : ['cjs', 'esm'],
-                addPlugin,
                 skipFormat: true,
                 skipValidation: true,
             });

package/dist/src/plugins/scripts/create-script-nodes.d.ts

@@ -0,0 +1,24 @@
+import { type CreateNodes, type TargetConfiguration } from '@nx/devkit';
+import { type Shebang } from './shebang';
+export interface ScriptPluginOptions {
+    /** Runs claimed scripts in watch mode as continuous targets. */
+    watch?: boolean;
+}
+export interface ScriptPluginDefinition<T extends ScriptPluginOptions> {
+    /** Prefix of the plugin's cache file. */
+    cacheName: string;
+    technology: string;
+    /** Only files whose shebang the plugin claims become targets. */
+    claims(shebang: Shebang): boolean;
+    /** `file` is relative to the target's cwd. */
+    command(file: string, shebang: Shebang, watch: boolean): string;
+    /** Targets not tied to a shebang; claimed scripts win on name clashes. */
+    extraTargets?(projectRoot: string, workspaceRoot: string, options: T): Promise<ScriptTargets>;
+}
+export type ScriptTargets = Record<string, TargetConfiguration>;
+export declare function createScriptNodes<T extends ScriptPluginOptions>(definition: ScriptPluginDefinition<T>): CreateNodes<T>;
+/**
+ * Quotes a path for a shell command when the shell would split or expand it.
+ * Double quotes keep spaces intact in sh and cmd.exe; cmd.exe still expands `%VAR%`.
+ */
+export declare function quoteShellArg(arg: string): string;

package/dist/src/plugins/scripts/create-script-nodes.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScriptNodes = createScriptNodes;
+exports.quoteShellArg = quoteShellArg;
+const internal_1 = require("@nx/devkit/internal");
+const node_path_1 = require("node:path");
+const shebang_1 = require("./shebang");
+const target_name_1 = require("./target-name");
+const SCRIPT_GLOB = '**/*.{js,cjs,mjs,ts,cts,mts}';
+const PROJECT_MARKERS = ['package.json', 'project.json'];
+function createScriptNodes(definition) {
+    return [
+        (0, internal_1.combineGlobPatterns)([
+            SCRIPT_GLOB,
+            ...PROJECT_MARKERS.map((marker) => `**/${marker}`),
+        ]),
+        async (files, options, context) => {
+            const scriptsByRoot = groupScriptsByProjectRoot(files, !!definition.extraTargets);
+            const projectRoots = [...scriptsByRoot.keys()];
+            if (!projectRoots.length) {
+                return [];
+            }
+            const cache = new internal_1.PluginCache((0, node_path_1.join)(internal_1.workspaceDataDirectory, `${definition.cacheName}-${(0, internal_1.hashObject)(options ?? {})}.hash`));
+            try {
+                const hashes = await (0, internal_1.calculateHashesForCreateNodes)(projectRoots, options ?? {}, context);
+                const results = [];
+                for (const [i, projectRoot] of projectRoots.entries()) {
+                    const { marker, scripts } = scriptsByRoot.get(projectRoot);
+                    // include/exclude can change which scripts a project gets without
+                    // changing its contents.
+                    const key = (0, internal_1.hashObject)([hashes[i], [...scripts].sort()]);
+                    if (!cache.has(key)) {
+                        cache.set(key, {
+                            ...(await definition.extraTargets?.(projectRoot, context.workspaceRoot, options)),
+                            ...createTargets(definition, context.workspaceRoot, projectRoot, scripts, options?.watch === true),
+                        });
+                    }
+                    const targets = cache.get(key);
+                    if (Object.keys(targets).length) {
+                        results.push([
+                            scripts[0] ?? marker,
+                            { projects: { [projectRoot]: { root: projectRoot, targets } } },
+                        ]);
+                    }
+                }
+                return results;
+            }
+            finally {
+                cache.writeToDisk();
+            }
+        },
+    ];
+}
+/**
+ * Assigns each script to its nearest enclosing project root. Roots without
+ * scripts are kept only when `includeAllRoots` is set.
+ */
+function groupScriptsByProjectRoot(files, includeAllRoots) {
+    const markers = new Map();
+    const scripts = [];
+    for (const file of files) {
+        if (PROJECT_MARKERS.includes((0, node_path_1.basename)(file))) {
+            markers.set((0, node_path_1.dirname)(file), file);
+        }
+        else {
+            scripts.push(file);
+        }
+    }
+    const byRoot = new Map();
+    if (includeAllRoots) {
+        for (const [root, marker] of markers) {
+            byRoot.set(root, { marker, scripts: [] });
+        }
+    }
+    for (const script of scripts) {
+        let dir = (0, node_path_1.dirname)(script);
+        while (!markers.has(dir) && dir !== '.') {
+            dir = (0, node_path_1.dirname)(dir);
+        }
+        if (!markers.has(dir)) {
+            continue;
+        }
+        if (!byRoot.has(dir)) {
+            byRoot.set(dir, { marker: markers.get(dir), scripts: [] });
+        }
+        byRoot.get(dir).scripts.push(script);
+    }
+    return byRoot;
+}
+function createTargets(definition, workspaceRoot, projectRoot, scripts, watch) {
+    const claimed = [];
+    for (const script of scripts) {
+        const header = (0, shebang_1.readScriptHeader)((0, node_path_1.join)(workspaceRoot, script));
+        const shebang = header === null ? null : (0, shebang_1.parseShebang)((0, shebang_1.getShebangLine)(header));
+        if (!shebang || !definition.claims(shebang)) {
+            continue;
+        }
+        const { name, warnings } = (0, target_name_1.parseTargetName)(header);
+        for (const warning of warnings) {
+            (0, internal_1.emitPluginWorkerLog)('warn', `${script}: ${warning}.`);
+        }
+        claimed.push({
+            path: script,
+            relativePath: node_path_1.posix.relative(projectRoot, script),
+            shebang,
+            targetName: name,
+        });
+    }
+    const baseNameCounts = new Map();
+    for (const { relativePath } of claimed) {
+        const name = withoutExtension((0, node_path_1.basename)(relativePath));
+        baseNameCounts.set(name, (baseNameCounts.get(name) ?? 0) + 1);
+    }
+    const targets = {};
+    for (const script of claimed) {
+        const baseName = withoutExtension((0, node_path_1.basename)(script.relativePath));
+        const name = script.targetName ??
+            (baseNameCounts.get(baseName) > 1
+                ? withoutExtension(script.relativePath)
+                : baseName);
+        targets[name] = createTarget(definition, projectRoot, script, watch);
+    }
+    return targets;
+}
+function createTarget(definition, projectRoot, { path, relativePath, shebang }, watch) {
+    return {
+        command: definition.command(quoteShellArg(node_path_1.posix.relative(projectRoot, path)), shebang, watch),
+        options: { cwd: projectRoot },
+        cache: false,
+        ...(watch && { continuous: true }),
+        metadata: {
+            technologies: [definition.technology],
+            description: `Runs ${relativePath}`,
+        },
+    };
+}
+/**
+ * Quotes a path for a shell command when the shell would split or expand it.
+ * Double quotes keep spaces intact in sh and cmd.exe; cmd.exe still expands `%VAR%`.
+ */
+function quoteShellArg(arg) {
+    if (/^[\w@%+=:,./-]+$/.test(arg)) {
+        return arg;
+    }
+    return '"' + arg.replace(/(["\\$`])/g, '\\$1') + '"';
+}
+function withoutExtension(path) {
+    return path.slice(0, path.length - (0, node_path_1.extname)(path).length);
+}

package/dist/src/plugins/scripts/node-plugin.d.ts

@@ -0,0 +1,10 @@
+import { type ScriptPluginOptions } from './create-script-nodes';
+export interface NodeScriptsPluginOptions extends ScriptPluginOptions {
+    /**
+     * `dependsOn` for `bin` targets whose file is build output (not a tracked
+     * workspace file). Defaults to `["build"]`.
+     */
+    binDependsOn?: string[];
+}
+export declare const createNodes: import("@nx/devkit").CreateNodes<NodeScriptsPluginOptions>;
+export declare const createNodesV2: import("@nx/devkit").CreateNodes<NodeScriptsPluginOptions>;

package/dist/src/plugins/scripts/node-plugin.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesV2 = exports.createNodes = void 0;
+const devkit_1 = require("@nx/devkit");
+const internal_1 = require("@nx/devkit/internal");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const create_script_nodes_1 = require("./create-script-nodes");
+exports.createNodes = (0, create_script_nodes_1.createScriptNodes)({
+    cacheName: 'js-node-scripts',
+    technology: 'node',
+    claims: (shebang) => shebang.interpreter === 'node',
+    command: (file, shebang, watch) => ['node', ...(watch ? ['--watch'] : []), ...shebang.args, file].join(' '),
+    extraTargets: createBinTargets,
+});
+exports.createNodesV2 = exports.createNodes;
+async function createBinTargets(projectRoot, workspaceRoot, options) {
+    const packageJsonPath = (0, node_path_1.join)(workspaceRoot, projectRoot, 'package.json');
+    if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
+        return {};
+    }
+    const bins = readBinEntries((0, devkit_1.readJsonFile)(packageJsonPath));
+    if (!bins.length) {
+        return {};
+    }
+    const binFiles = bins.map(([, path]) => node_path_1.posix.join(projectRoot, node_path_1.posix.normalize(path)));
+    const tracked = new Set(await (0, internal_1.globWithWorkspaceContext)(workspaceRoot, binFiles));
+    const targets = {};
+    bins.forEach(([name, path], i) => {
+        const target = {
+            command: `node ${(0, create_script_nodes_1.quoteShellArg)(node_path_1.posix.normalize(path))}`,
+            options: { cwd: projectRoot },
+            cache: false,
+            metadata: {
+                technologies: ['node'],
+                description: `Runs the ${name} bin`,
+            },
+        };
+        if (!tracked.has(binFiles[i])) {
+            target.dependsOn = options?.binDependsOn ?? ['build'];
+        }
+        targets[name] = target;
+    });
+    return targets;
+}
+function readBinEntries(packageJson) {
+    const { name, bin } = packageJson;
+    if (typeof bin === 'string') {
+        return name ? [[name.replace(/^@[^/]+\//, ''), bin]] : [];
+    }
+    return Object.entries(bin ?? {}).filter((entry) => typeof entry[1] === 'string');
+}

package/dist/src/plugins/scripts/shebang.d.ts

@@ -0,0 +1,19 @@
+export interface Shebang {
+    /** Program that runs the file, e.g. `node` or `tsx`. */
+    interpreter: string;
+    /** Arguments that follow the interpreter on the shebang line. */
+    args: string[];
+}
+/**
+ * Returns the first bytes of a script that starts with `#!`, or `null` when it
+ * has no shebang or cannot be read (e.g. a tracked broken symlink).
+ */
+export declare function readScriptHeader(absolutePath: string): string | null;
+/** The shebang line of a header from `readScriptHeader`, without `#!`. */
+export declare function getShebangLine(header: string): string;
+/**
+ * Handles `/usr/bin/env node`, `/usr/bin/env -S node --flags`,
+ * `/usr/bin/env -S npx tsx` and direct paths such as `/usr/local/bin/node`.
+ */
+export declare function parseShebang(line: string): Shebang | null;
+export declare function stripBom(text: string): string;

package/dist/src/plugins/scripts/shebang.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readScriptHeader = readScriptHeader;
+exports.getShebangLine = getShebangLine;
+exports.parseShebang = parseShebang;
+exports.stripBom = stripBom;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const SNIFF_BYTES = 512;
+const PACKAGE_RUNNERS = new Set(['npx', 'pnpx', 'bunx']);
+/**
+ * Returns the first bytes of a script that starts with `#!`, or `null` when it
+ * has no shebang or cannot be read (e.g. a tracked broken symlink).
+ */
+function readScriptHeader(absolutePath) {
+    const buffer = Buffer.alloc(SNIFF_BYTES);
+    let bytesRead;
+    try {
+        const fd = (0, node_fs_1.openSync)(absolutePath, 'r');
+        try {
+            bytesRead = (0, node_fs_1.readSync)(fd, buffer, 0, SNIFF_BYTES, 0);
+        }
+        finally {
+            (0, node_fs_1.closeSync)(fd);
+        }
+    }
+    catch {
+        return null;
+    }
+    let text = stripBom(buffer.toString('utf8', 0, bytesRead));
+    if (!text.startsWith('#!')) {
+        return null;
+    }
+    // Drop a line the sniff cut off, so a directive is never read truncated.
+    if (bytesRead === SNIFF_BYTES && text.includes('\n')) {
+        text = text.slice(0, text.lastIndexOf('\n'));
+    }
+    return text;
+}
+/** The shebang line of a header from `readScriptHeader`, without `#!`. */
+function getShebangLine(header) {
+    const end = header.search(/\r?\n/);
+    return (end === -1 ? header : header.slice(0, end)).slice(2).trim();
+}
+/**
+ * Handles `/usr/bin/env node`, `/usr/bin/env -S node --flags`,
+ * `/usr/bin/env -S npx tsx` and direct paths such as `/usr/local/bin/node`.
+ */
+function parseShebang(line) {
+    let tokens = line.split(/\s+/).filter(Boolean);
+    if (tokens.length && (0, node_path_1.basename)(tokens[0]) === 'env') {
+        tokens = tokens.slice(1);
+        if (tokens[0] === '-S') {
+            tokens = tokens.slice(1);
+        }
+    }
+    if (tokens.length && PACKAGE_RUNNERS.has((0, node_path_1.basename)(tokens[0]))) {
+        tokens = tokens.slice(1);
+    }
+    if (!tokens.length) {
+        return null;
+    }
+    return { interpreter: (0, node_path_1.basename)(tokens[0]), args: tokens.slice(1) };
+}
+function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}

package/dist/src/plugins/scripts/target-name.d.ts

@@ -0,0 +1,9 @@
+export interface TargetNameDirective {
+    name?: string;
+    warnings: string[];
+}
+/**
+ * Reads `@nx-target-name: <name>` from the comment block that opens the
+ * script. Only the first directive counts; problems come back as warnings.
+ */
+export declare function parseTargetName(header: string): TargetNameDirective;

package/dist/src/plugins/scripts/target-name.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTargetName = parseTargetName;
+const internal_1 = require("@nx/devkit/internal");
+/**
+ * Reads `@nx-target-name: <name>` from the comment block that opens the
+ * script. Only the first directive counts; problems come back as warnings.
+ */
+function parseTargetName(header) {
+    const [value, ...extra] = (0, internal_1.parseNxDirectives)(header).get('target-name') ?? [];
+    const warnings = extra.map((v) => `ignoring the extra "@nx-target-name: ${v}" directive`);
+    if (value === undefined) {
+        return { warnings };
+    }
+    if (!value) {
+        return { warnings: ['"@nx-target-name" is empty', ...warnings] };
+    }
+    return { name: value, warnings };
+}

package/dist/src/plugins/scripts/tsx-plugin.d.ts

@@ -0,0 +1,3 @@
+import { type ScriptPluginOptions } from './create-script-nodes';
+export declare const createNodes: import("@nx/devkit").CreateNodes<ScriptPluginOptions>;
+export declare const createNodesV2: import("@nx/devkit").CreateNodes<ScriptPluginOptions>;

package/dist/src/plugins/scripts/tsx-plugin.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesV2 = exports.createNodes = void 0;
+const create_script_nodes_1 = require("./create-script-nodes");
+exports.createNodes = (0, create_script_nodes_1.createScriptNodes)({
+    cacheName: 'js-tsx-scripts',
+    technology: 'tsx',
+    claims: (shebang) => shebang.interpreter === 'tsx',
+    command: (file, shebang, watch) => ['tsx', ...(watch ? ['watch'] : []), ...shebang.args, file].join(' '),
+});
+exports.createNodesV2 = exports.createNodes;

package/dist/src/plugins/typescript/build-typechecks.d.ts

@@ -0,0 +1,8 @@
+import type { TargetConfiguration } from '@nx/devkit';
+/**
+ * Whether the project's build already type-checks it, judged from its
+ * `project.json` and `package.json` targets and, when no build executor is found, its bundler
+ * config files. Options set inside a bundler config can't be read, so those
+ * builds are assumed to type-check, which is their default.
+ */
+export declare function buildTypechecksProject(siblingFiles: string[], targets: Record<string, TargetConfiguration> | undefined): boolean;