@nx/js 24.0.0-beta.2 → 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/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

@@ -1,6 +1,10 @@
 import { type CreateNodes, type TargetConfiguration } from '@nx/devkit';
 import { type Shebang } from './shebang';
-export interface ScriptPluginDefinition<T> {
+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;
@@ -12,7 +16,7 @@ export interface ScriptPluginDefinition<T> {
     extraTargets?(projectRoot: string, workspaceRoot: string, options: T): Promise<ScriptTargets>;
 }
 export type ScriptTargets = Record<string, TargetConfiguration>;
-export declare function createScriptNodes<T extends object>(definition: ScriptPluginDefinition<T>): CreateNodes<T>;
+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%`.

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

@@ -2,14 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createScriptNodes = createScriptNodes;
 exports.quoteShellArg = quoteShellArg;
-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 frontmatter_1 = require("./frontmatter");
 const shebang_1 = require("./shebang");
-// Frontmatter keys the plugin interprets; any other key merges into the target.
-const RESERVED_KEYS = ['name', 'description', 'disable', 'watch', 'cwd'];
+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) {
@@ -36,7 +32,7 @@ function createScriptNodes(definition) {
                     if (!cache.has(key)) {
                         cache.set(key, {
                             ...(await definition.extraTargets?.(projectRoot, context.workspaceRoot, options)),
-                            ...createTargets(definition, context.workspaceRoot, projectRoot, scripts),
+                            ...createTargets(definition, context.workspaceRoot, projectRoot, scripts, options?.watch === true),
                         });
                     }
                     const targets = cache.get(key);
@@ -91,31 +87,23 @@ function groupScriptsByProjectRoot(files, includeAllRoots) {
     }
     return byRoot;
 }
-function createTargets(definition, workspaceRoot, projectRoot, scripts) {
+function createTargets(definition, workspaceRoot, projectRoot, scripts, watch) {
     const claimed = [];
     for (const script of scripts) {
-        const absolutePath = (0, node_path_1.join)(workspaceRoot, script);
-        const line = (0, shebang_1.readShebangLine)(absolutePath);
-        const shebang = line === null ? null : (0, shebang_1.parseShebang)(line);
+        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;
         }
-        let frontmatter = {};
-        try {
-            frontmatter = (0, frontmatter_1.parseFrontmatter)((0, node_fs_1.readFileSync)(absolutePath, 'utf-8'));
-        }
-        catch (e) {
-            devkit_1.logger.warn(`Ignoring the nx frontmatter in ${script}: ${e.message}`);
-        }
-        frontmatter = dropInvalidKeys(frontmatter, script);
-        if (frontmatter.disable === true) {
-            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,
-            frontmatter,
+            targetName: name,
         });
     }
     const baseNameCounts = new Map();
@@ -126,67 +114,26 @@ function createTargets(definition, workspaceRoot, projectRoot, scripts) {
     const targets = {};
     for (const script of claimed) {
         const baseName = withoutExtension((0, node_path_1.basename)(script.relativePath));
-        const name = typeof script.frontmatter.name === 'string'
-            ? script.frontmatter.name
-            : baseNameCounts.get(baseName) > 1
+        const name = script.targetName ??
+            (baseNameCounts.get(baseName) > 1
                 ? withoutExtension(script.relativePath)
-                : baseName;
-        targets[name] = createTarget(definition, projectRoot, script);
+                : baseName);
+        targets[name] = createTarget(definition, projectRoot, script, watch);
     }
     return targets;
 }
-function createTarget(definition, projectRoot, { path, relativePath, shebang, frontmatter }) {
-    const { description, watch, cwd, options, metadata } = frontmatter;
-    const rest = { ...frontmatter };
-    for (const key of [...RESERVED_KEYS, 'options', 'metadata']) {
-        delete rest[key];
-    }
-    const targetCwd = cwd ?? (typeof options?.cwd === 'string' ? options.cwd : projectRoot);
+function createTarget(definition, projectRoot, { path, relativePath, shebang }, watch) {
     return {
-        command: definition.command(quoteShellArg(node_path_1.posix.relative(targetCwd, path)), shebang, watch === true),
-        options: { ...options, cwd: targetCwd },
+        command: definition.command(quoteShellArg(node_path_1.posix.relative(projectRoot, path)), shebang, watch),
+        options: { cwd: projectRoot },
         cache: false,
-        ...(watch === true && { continuous: true }),
+        ...(watch && { continuous: true }),
         metadata: {
             technologies: [definition.technology],
-            description: description ?? `Runs ${relativePath}`,
-            ...metadata,
+            description: `Runs ${relativePath}`,
         },
-        ...rest,
     };
 }
-const EXPECTED_TYPES = {
-    name: 'string',
-    description: 'string',
-    cwd: 'string',
-    cache: 'boolean',
-    continuous: 'boolean',
-    watch: 'boolean',
-    disable: 'boolean',
-    dependsOn: 'array',
-    inputs: 'array',
-    outputs: 'array',
-    options: 'object',
-    metadata: 'object',
-};
-/** Drops known keys with the wrong type so they cannot break the project graph. */
-function dropInvalidKeys(frontmatter, script) {
-    const valid = {};
-    for (const [key, value] of Object.entries(frontmatter)) {
-        const expected = EXPECTED_TYPES[key];
-        const actual = Array.isArray(value)
-            ? 'array'
-            : value === null
-                ? 'null'
-                : typeof value;
-        if (expected && actual !== expected) {
-            devkit_1.logger.warn(`Ignoring nx frontmatter key "${key}" in ${script}: expected ${expected}, got ${actual}.`);
-            continue;
-        }
-        valid[key] = value;
-    }
-    return valid;
-}
 /**
  * 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%`.

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

@@ -1,4 +1,5 @@
-export interface NodeScriptsPluginOptions {
+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"]`.

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

@@ -4,8 +4,13 @@ export interface Shebang {
     /** Arguments that follow the interpreter on the shebang line. */
     args: string[];
 }
-/** Returns the shebang line without `#!`, or `null` when the file has none. */
-export declare function readShebangLine(absolutePath: string): string | null;
+/**
+ * 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`.

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

@@ -1,29 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readShebangLine = readShebangLine;
+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 shebang line without `#!`, or `null` when the file has none. */
-function readShebangLine(absolutePath) {
+/**
+ * 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);
-    const fd = (0, node_fs_1.openSync)(absolutePath, 'r');
     let bytesRead;
     try {
-        bytesRead = (0, node_fs_1.readSync)(fd, buffer, 0, SNIFF_BYTES, 0);
+        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);
+        }
     }
-    finally {
-        (0, node_fs_1.closeSync)(fd);
+    catch {
+        return null;
     }
-    const text = stripBom(buffer.toString('utf8', 0, bytesRead));
+    let text = stripBom(buffer.toString('utf8', 0, bytesRead));
     if (!text.startsWith('#!')) {
         return null;
     }
-    const end = text.search(/\r?\n/);
-    return (end === -1 ? text : text.slice(0, end)).slice(2).trim();
+    // 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`,

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

@@ -1,2 +1,3 @@
-export declare const createNodes: import("@nx/devkit").CreateNodes<Record<string, never>>;
-export declare const createNodesV2: import("@nx/devkit").CreateNodes<Record<string, never>>;
+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/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;

package/dist/src/plugins/typescript/build-typechecks.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTypechecksProject = buildTypechecksProject;
+const TYPECHECKING_EXECUTORS = new Set([
+    '@nx/js:tsc',
+    '@nx/angular:application',
+    '@nx/angular:browser-esbuild',
+    '@nx/angular:ng-packagr-lite',
+    '@nx/angular:package',
+    '@angular-devkit/build-angular:application',
+    '@angular-devkit/build-angular:browser',
+    '@angular-devkit/build-angular:browser-esbuild',
+    '@angular-devkit/build-angular:ng-packagr',
+    '@angular/build:application',
+    '@angular/build:ng-packagr',
+]);
+const SKIP_TYPECHECK_EXECUTORS = new Set(['@nx/js:swc', '@nx/esbuild:esbuild']);
+const TYPECHECKING_BUILD_CONFIG = /^(webpack|rspack|rollup)\.config\.[cm]?[jt]s$/;
+/**
+ * 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.
+ */
+function buildTypechecksProject(siblingFiles, targets) {
+    let hasBuildExecutor = false;
+    for (const { executor, options } of Object.values(targets ?? {})) {
+        if (!executor) {
+            continue;
+        }
+        if (TYPECHECKING_EXECUTORS.has(executor)) {
+            return true;
+        }
+        if (SKIP_TYPECHECK_EXECUTORS.has(executor)) {
+            hasBuildExecutor = true;
+            if (options?.skipTypeCheck !== true) {
+                return true;
+            }
+        }
+    }
+    if (hasBuildExecutor) {
+        return false;
+    }
+    return siblingFiles.some((file) => TYPECHECKING_BUILD_CONFIG.test(file));
+}