@nx/devkit 24.0.0-canary.20261013-994ecba → 24.0.0-pr.37405.acdaf31

package/dist/internal.d.ts

@@ -21,6 +21,8 @@ export { loadConfigFile, clearRequireCache } from './src/utils/config-utils';
 export { isRequireEsmRaceError, retryOnRequireEsmRace, } from './src/utils/require-esm-race';
 export { findPluginForConfigFile } from './src/utils/find-plugin-for-config-file';
 export { getNamedInputs } from './src/utils/get-named-inputs';
+export { applyTestFileDirectives } from './src/utils/test-file-directives';
+export { hasUltracacheImportsDirective } from './src/utils/ultracache-directive';
 export { logShowProjectCommand } from './src/utils/log-show-project-command';
 export { eachValueFrom } from './src/utils/rxjs-for-await';
 export { checkAndCleanWithSemver } from './src/utils/semver';

package/dist/internal.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getInstalledPackageVersion = exports.getDeclaredPackageVersion = exports.addPlugin = exports.upsertTargetDefault = exports.updateTargetDefault = exports.readTargetDefaultsForTarget = exports.findTargetDefault = exports.addE2eCiTargetDefaults = exports.addBuildTargetDefaults = exports.isInteractive = exports.resolveImportPath = exports.ensureRootProjectName = exports.determineProjectNameAndRootOptions = exports.toProjectRelativePath = exports.deleteMatchingProperties = exports.processTargetOutputs = exports.NoTargetsToMigrateError = exports.migrateProjectExecutorsToPluginV1 = exports.migrateProjectExecutorsToPlugin = exports.openBatchConversionSession = exports.finalizeBatchConversion = exports.AggregatedLog = exports.forEachExecutorOptions = exports.getE2EWebServerInfo = exports.getRelativeCwd = exports.determineArtifactNameAndDirectoryOptions = exports.oxfmtConfigFiles = exports.prettierConfigFiles = exports.detectFormatterInTree = exports.hashDaemonClientEnv = exports.getGraphTimeDotEnvForTask = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = exports.getDaemonClientEnvGeneration = exports.getCatalogManager = exports.isAiAgent = exports.createOverrides = exports.createCliOptions = exports.acknowledgeBuildScripts = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.createProjectRootMappingsFromProjectConfigurations = exports.signalToCode = void 0;
-exports.createNxCloudOnboardingURLForWelcomeApp = exports.createNxCloudOnboardingURL = exports.createLockFile = exports.createDirectory = exports.connectToNxCloud = exports.combineGlobPatterns = exports.codeFrameColumns = exports.calculateReverseDeps = exports.calculateFileChanges = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.WholeFileChange = exports.TargetProjectLocator = exports.TEN_MEGABYTES = exports.SyncError = exports.RemoteCacheV2 = exports.NX_PREFIX = exports.LockFileChange = exports.LARGE_BUFFER = exports.FsTree = exports.confirmationPrompt = exports.DeletedFileChange = exports.CompositeLifeCycle = exports.Cache = exports.BatchFunctionRunner = exports.runCommandsExecutor = exports.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.checkAndCleanWithSemver = exports.eachValueFrom = exports.logShowProjectCommand = exports.getNamedInputs = exports.findPluginForConfigFile = exports.retryOnRequireEsmRace = exports.isRequireEsmRaceError = exports.clearRequireCache = exports.loadConfigFile = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.getSatisfyingInstalledPackageVersion = exports.getResolvedPackageVersion = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersionFromTree = void 0;
-exports.getSourceDirOfDependentProjects = exports.getSerializedArgsForTask = exports.getRelativeProjectJsonSchemaPath = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getNxRequirePaths = exports.getNxCloudUrl = exports.getNxCloudAppOnBoardingUrl = exports.getLockFileName = exports.getLatestCommitSha = exports.getLastValueFromAsyncIterableIterator = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.getGeneratorInformation = exports.getFilesInDirectoryUsingContext = exports.getExecutorNameForTask = exports.getExecutorInformation = exports.getExecutorForTask = exports.getEnvPathsForTask = exports.getEnvFilesForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.generatePrunedDeployOutput = exports.forceRegisterEsmLoader = exports.findProjectsNpmDependencies = exports.findProjectForPath = exports.findMatchingTargetNames = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.findInstalledPlugins = exports.findAllProjectNodeDependencies = exports.filterUsingGlobPatterns = exports.fileExists = exports.fileDataDepType = exports.fileDataDepTarget = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.dropEmptyPeerDependencySections = exports.directoryExists = exports.deriveGroupNameFromTarget = exports.defaultFileRead = exports.deduceDefaultBase = exports.daemonClient = exports.createTaskId = exports.createTargetDefaultsResults = exports.createRunManyDynamicOutputRenderer = exports.createProjectRootMappings = exports.createProjectGraphAndSourceMapsAsync = exports.createPackageJson = void 0;
-exports.requireWithTsconfigFallback = exports.removeTasksFromTaskGraph = exports.relocatePrunedLocalPathSpec = exports.registerTsProject = exports.registerTsConfigPaths = exports.readProjectAndTargetFromTargetString = exports.readPackageJson = exports.readNxMigrateConfig = exports.readNxJsonFromDisk = exports.readModulePackageJson = exports.readFileMapCache = exports.readFileIfExisting = exports.readCachedProjectConfiguration = exports.quoteShellArg = exports.preventRecursionInGraphConstruction = exports.parseVersionFromPackageManagerField = exports.parseExecutor = exports.orange = exports.nxVersion = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.multiselectPrompt = exports.movePeerDependencyToDependencies = exports.mergeTargetConfigurations = exports.loadTsFile = exports.killProcessTreeGraceful = exports.killChildOnHostExit = exports.isWholeFileChange = exports.isRelativePath = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.isNxCloudUsed = exports.isNpmProject = exports.isLockFileChange = exports.isDeletedFileChange = exports.isCacheableTask = exports.isCI = exports.isBuiltinModuleImport = exports.interpolate = exports.hashWithWorkspaceContext = exports.hashObject = exports.hashFile = exports.handleProjectGraphError = exports.handleImport = exports.globWithWorkspaceContext = exports.getWorkspacePackagesFromGraph = exports.getUnparsedOverrideArgs = exports.getTargetInputs = exports.getTargetConfigurationForTask = void 0;
-exports.workspaceRootInner = exports.workspaceDataDirectory = exports.warnUnshippableLocalPathSpec = exports.validateOutputs = exports.unparse = exports.textPrompt = exports.transformLegacyOutputs = exports.toOldFormat = exports.toNewFormat = exports.shouldStreamOutput = exports.setupWorkspaceContext = exports.setupAiAgentsGenerator = exports.setWorkspaceRoot = exports.selectPrompt = exports.safeSpawn = exports.safeExecFileSync = exports.runNxSync = exports.resolveCommandSyntacticSugar = exports.resetWorkspaceContext = void 0;
+exports.createLockFile = exports.createDirectory = exports.connectToNxCloud = exports.combineGlobPatterns = exports.codeFrameColumns = exports.calculateReverseDeps = exports.calculateFileChanges = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.WholeFileChange = exports.TargetProjectLocator = exports.TEN_MEGABYTES = exports.SyncError = exports.RemoteCacheV2 = exports.NX_PREFIX = exports.LockFileChange = exports.LARGE_BUFFER = exports.FsTree = exports.confirmationPrompt = exports.DeletedFileChange = exports.CompositeLifeCycle = exports.Cache = exports.BatchFunctionRunner = exports.runCommandsExecutor = exports.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.checkAndCleanWithSemver = exports.eachValueFrom = exports.logShowProjectCommand = exports.hasUltracacheImportsDirective = exports.applyTestFileDirectives = exports.getNamedInputs = exports.findPluginForConfigFile = exports.retryOnRequireEsmRace = exports.isRequireEsmRaceError = exports.clearRequireCache = exports.loadConfigFile = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.getSatisfyingInstalledPackageVersion = exports.getResolvedPackageVersion = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersionFromTree = void 0;
+exports.getRelativeProjectJsonSchemaPath = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getNxRequirePaths = exports.getNxCloudUrl = exports.getNxCloudAppOnBoardingUrl = exports.getLockFileName = exports.getLatestCommitSha = exports.getLastValueFromAsyncIterableIterator = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.getGeneratorInformation = exports.getFilesInDirectoryUsingContext = exports.getExecutorNameForTask = exports.getExecutorInformation = exports.getExecutorForTask = exports.getEnvPathsForTask = exports.getEnvFilesForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.generatePrunedDeployOutput = exports.forceRegisterEsmLoader = exports.findProjectsNpmDependencies = exports.findProjectForPath = exports.findMatchingTargetNames = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.findInstalledPlugins = exports.findAllProjectNodeDependencies = exports.filterUsingGlobPatterns = exports.fileExists = exports.fileDataDepType = exports.fileDataDepTarget = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.dropEmptyPeerDependencySections = exports.directoryExists = exports.deriveGroupNameFromTarget = exports.defaultFileRead = exports.deduceDefaultBase = exports.daemonClient = exports.createTaskId = exports.createTargetDefaultsResults = exports.createRunManyDynamicOutputRenderer = exports.createProjectRootMappings = exports.createProjectGraphAndSourceMapsAsync = exports.createPackageJson = exports.createNxCloudOnboardingURLForWelcomeApp = exports.createNxCloudOnboardingURL = void 0;
+exports.relocatePrunedLocalPathSpec = exports.registerTsProject = exports.registerTsConfigPaths = exports.readProjectAndTargetFromTargetString = exports.readPackageJson = exports.readNxMigrateConfig = exports.readNxJsonFromDisk = exports.readModulePackageJson = exports.readFileMapCache = exports.readFileIfExisting = exports.readCachedProjectConfiguration = exports.quoteShellArg = exports.preventRecursionInGraphConstruction = exports.parseVersionFromPackageManagerField = exports.parseExecutor = exports.orange = exports.nxVersion = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.multiselectPrompt = exports.movePeerDependencyToDependencies = exports.mergeTargetConfigurations = exports.loadTsFile = exports.killProcessTreeGraceful = exports.killChildOnHostExit = exports.isWholeFileChange = exports.isRelativePath = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.isNxCloudUsed = exports.isNpmProject = exports.isLockFileChange = exports.isDeletedFileChange = exports.isCacheableTask = exports.isCI = exports.isBuiltinModuleImport = exports.interpolate = exports.hashWithWorkspaceContext = exports.hashObject = exports.hashFile = exports.handleProjectGraphError = exports.handleImport = exports.globWithWorkspaceContext = exports.getWorkspacePackagesFromGraph = exports.getUnparsedOverrideArgs = exports.getTargetInputs = exports.getTargetConfigurationForTask = exports.getSourceDirOfDependentProjects = exports.getSerializedArgsForTask = void 0;
+exports.workspaceRootInner = exports.workspaceDataDirectory = exports.warnUnshippableLocalPathSpec = exports.validateOutputs = exports.unparse = exports.textPrompt = exports.transformLegacyOutputs = exports.toOldFormat = exports.toNewFormat = exports.shouldStreamOutput = exports.setupWorkspaceContext = exports.setupAiAgentsGenerator = exports.setWorkspaceRoot = exports.selectPrompt = exports.safeSpawn = exports.safeExecFileSync = exports.runNxSync = exports.resolveCommandSyntacticSugar = exports.resetWorkspaceContext = exports.requireWithTsconfigFallback = exports.removeTasksFromTaskGraph = void 0;
 var devkit_internals_1 = require("nx/src/devkit-internals");
 Object.defineProperty(exports, "signalToCode", { enumerable: true, get: function () { return devkit_internals_1.signalToCode; } });
 Object.defineProperty(exports, "createProjectRootMappingsFromProjectConfigurations", { enumerable: true, get: function () { return devkit_internals_1.createProjectRootMappingsFromProjectConfigurations; } });
@@ -106,6 +106,10 @@ var find_plugin_for_config_file_1 = require("./src/utils/find-plugin-for-config-
 Object.defineProperty(exports, "findPluginForConfigFile", { enumerable: true, get: function () { return find_plugin_for_config_file_1.findPluginForConfigFile; } });
 var get_named_inputs_1 = require("./src/utils/get-named-inputs");
 Object.defineProperty(exports, "getNamedInputs", { enumerable: true, get: function () { return get_named_inputs_1.getNamedInputs; } });
+var test_file_directives_1 = require("./src/utils/test-file-directives");
+Object.defineProperty(exports, "applyTestFileDirectives", { enumerable: true, get: function () { return test_file_directives_1.applyTestFileDirectives; } });
+var ultracache_directive_1 = require("./src/utils/ultracache-directive");
+Object.defineProperty(exports, "hasUltracacheImportsDirective", { enumerable: true, get: function () { return ultracache_directive_1.hasUltracacheImportsDirective; } });
 var log_show_project_command_1 = require("./src/utils/log-show-project-command");
 Object.defineProperty(exports, "logShowProjectCommand", { enumerable: true, get: function () { return log_show_project_command_1.logShowProjectCommand; } });
 var rxjs_for_await_1 = require("./src/utils/rxjs-for-await");

package/dist/src/utils/nx-directives.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The `@nx-<name>: <value>` directives in the comment block that opens a file,
+ * by name, with their trimmed values in order. Reading stops at the first line
+ * that is not blank, a shebang or a comment.
+ */
+export declare function parseNxDirectives(content: string): Map<string, string[]>;

package/dist/src/utils/nx-directives.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNxDirectives = parseNxDirectives;
+const DIRECTIVE = /^@nx-([\w-]+):(.*)$/;
+/**
+ * The `@nx-<name>: <value>` directives in the comment block that opens a file,
+ * by name, with their trimmed values in order. Reading stops at the first line
+ * that is not blank, a shebang or a comment.
+ */
+function parseNxDirectives(content) {
+    const directives = new Map();
+    let inBlock = false;
+    let start = 0;
+    while (start < content.length) {
+        const newline = content.indexOf('\n', start);
+        const end = newline === -1 ? content.length : newline;
+        let line = content.slice(start, end).trim();
+        start = end + 1;
+        if (!inBlock) {
+            if (line === '' || line.startsWith('#!')) {
+                continue;
+            }
+            if (line.startsWith('//')) {
+                line = line.slice(2);
+            }
+            else if (line.startsWith('/*')) {
+                inBlock = true;
+                line = line.slice(2);
+            }
+            else {
+                break;
+            }
+        }
+        if (inBlock) {
+            const blockEnd = line.indexOf('*/');
+            if (blockEnd !== -1) {
+                inBlock = false;
+                // Code after `*/` means the block is not a file header.
+                if (line.slice(blockEnd + 2).trim() !== '') {
+                    break;
+                }
+                line = line.slice(0, blockEnd);
+            }
+            line = line.replace(/^\s*\*+/, '');
+        }
+        const match = line.trim().match(DIRECTIVE);
+        if (match) {
+            const [, name, value] = match;
+            const values = directives.get(name);
+            if (values) {
+                values.push(value.trim());
+            }
+            else {
+                directives.set(name, [value.trim()]);
+            }
+        }
+    }
+    return directives;
+}

package/dist/src/utils/test-file-depends-on.d.ts

@@ -0,0 +1,11 @@
+import type { TargetConfiguration } from 'nx/src/devkit-exports';
+/** The distinct projects the `@nx-depends-on` values name. */
+export declare function dependsOnProjects(values: string[]): string[];
+/**
+ * `target` narrowed to the projects a test file names: its dependency inputs
+ * (`^…`, `dependencies: true`) become one input selecting `projects`, by the
+ * first named input among them (else `default`) and kept under ultracache
+ * (`always: true`). Its `dependsOn` entries naming projects, the servers the
+ * test talks to, get `inputs: false`.
+ */
+export declare function scopeTestTargetToProjects(target: TargetConfiguration, projects: string[]): TargetConfiguration;

package/dist/src/utils/test-file-depends-on.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dependsOnProjects = dependsOnProjects;
+exports.scopeTestTargetToProjects = scopeTestTargetToProjects;
+const without_server_inputs_1 = require("./without-server-inputs");
+/** The distinct projects the `@nx-depends-on` values name. */
+function dependsOnProjects(values) {
+    const projects = new Set();
+    for (const value of values) {
+        for (const project of value.split(',')) {
+            const name = project.trim();
+            if (name) {
+                projects.add(name);
+            }
+        }
+    }
+    return [...projects];
+}
+/**
+ * `target` narrowed to the projects a test file names: its dependency inputs
+ * (`^…`, `dependencies: true`) become one input selecting `projects`, by the
+ * first named input among them (else `default`) and kept under ultracache
+ * (`always: true`). Its `dependsOn` entries naming projects, the servers the
+ * test talks to, get `inputs: false`.
+ */
+function scopeTestTargetToProjects(target, projects) {
+    return {
+        ...target,
+        inputs: scopeDependencyInputs(target.inputs, projects),
+        ...(target.dependsOn && {
+            dependsOn: (0, without_server_inputs_1.withoutServerInputs)(target.dependsOn),
+        }),
+    };
+}
+function scopeDependencyInputs(inputs, projects) {
+    let namedInput;
+    let position;
+    const own = [];
+    for (const input of inputs ?? []) {
+        const dependency = typeof input === 'string'
+            ? input.startsWith('^')
+            : 'dependencies' in input && input.dependencies === true;
+        if (!dependency) {
+            own.push(input);
+            continue;
+        }
+        position ??= own.length;
+        if (namedInput === undefined) {
+            if (typeof input === 'string' && !input.startsWith('^{')) {
+                namedInput = input.slice(1);
+            }
+            else if (typeof input !== 'string' && 'input' in input) {
+                namedInput = input.input;
+            }
+        }
+    }
+    own.splice(position ?? own.length, 0, {
+        input: namedInput ?? 'default',
+        projects,
+        always: true,
+    });
+    return own;
+}

package/dist/src/utils/test-file-directives.d.ts

@@ -0,0 +1,12 @@
+import type { TargetConfiguration } from 'nx/src/devkit-exports';
+declare const TEST_FILE_DIRECTIVES: readonly ['depends-on', 'ultracache'];
+/** An `@nx-<name>` directive a plugin can apply to a test file's target. */
+type TestFileDirective = (typeof TEST_FILE_DIRECTIVES)[number];
+/**
+ * `target` with the `@nx-*` directives of a workspace-relative test file
+ * applied, for the directives in `supported`. A directive that is not
+ * supported, has an unsupported value or lists no projects is skipped with a
+ * warning.
+ */
+export declare function applyTestFileDirectives(target: TargetConfiguration, workspaceRoot: string, file: string, supported: readonly TestFileDirective[]): TargetConfiguration;
+export {};

package/dist/src/utils/test-file-directives.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTestFileDirectives = applyTestFileDirectives;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const devkit_internals_1 = require("nx/src/devkit-internals");
+const nx_directives_1 = require("./nx-directives");
+const test_file_depends_on_1 = require("./test-file-depends-on");
+const ultracache_directive_1 = require("./ultracache-directive");
+const without_server_inputs_1 = require("./without-server-inputs");
+const TEST_FILE_DIRECTIVES = ['depends-on', 'ultracache'];
+/**
+ * `target` with the `@nx-*` directives of a workspace-relative test file
+ * applied, for the directives in `supported`. A directive that is not
+ * supported, has an unsupported value or lists no projects is skipped with a
+ * warning.
+ */
+function applyTestFileDirectives(target, workspaceRoot, file, supported) {
+    const directives = (0, nx_directives_1.parseNxDirectives)((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceRoot, file), 'utf-8'));
+    let result = target;
+    for (const directive of TEST_FILE_DIRECTIVES) {
+        const values = directives.get(directive);
+        if (values === undefined) {
+            continue;
+        }
+        if (!supported.includes(directive)) {
+            (0, devkit_internals_1.emitPluginWorkerLog)('warn', `${file}: "@nx-${directive}" is not supported in this test file, so Nx ignores it.`);
+            continue;
+        }
+        result = applyDirective(result, directive, values, file);
+    }
+    return result;
+}
+function applyDirective(target, directive, values, file) {
+    switch (directive) {
+        case 'depends-on': {
+            const projects = (0, test_file_depends_on_1.dependsOnProjects)(values);
+            if (projects.length === 0) {
+                (0, devkit_internals_1.emitPluginWorkerLog)('warn', `${file}: "@nx-depends-on:" lists no projects, so Nx ignores it. List the projects the test depends on, separated by commas.`);
+                return target;
+            }
+            return (0, test_file_depends_on_1.scopeTestTargetToProjects)(target, projects);
+        }
+        case 'ultracache': {
+            const unsupported = (0, ultracache_directive_1.findUnsupportedUltracacheValue)(values);
+            if (unsupported !== undefined) {
+                (0, devkit_internals_1.emitPluginWorkerLog)('warn', `${file}: "@nx-ultracache:${unsupported && ` ${unsupported}`}" is not supported, so Nx ignores "@nx-ultracache" in this file. Use "@nx-ultracache: imports".`);
+                return target;
+            }
+            return target.dependsOn
+                ? { ...target, dependsOn: (0, without_server_inputs_1.withoutServerInputs)(target.dependsOn) }
+                : target;
+        }
+        default: {
+            const unhandled = directive;
+            throw new Error(`Unhandled test file directive: ${unhandled}`);
+        }
+    }
+}

package/dist/src/utils/ultracache-directive.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether the comment block that opens `content` has an
+ * `@nx-ultracache: imports` directive. False when any `@nx-ultracache` value
+ * there is unsupported.
+ */
+export declare function hasUltracacheImportsDirective(content: string): boolean;
+/** The first of the `@nx-ultracache` values that is not supported. */
+export declare function findUnsupportedUltracacheValue(values: string[]): string | undefined;

package/dist/src/utils/ultracache-directive.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasUltracacheImportsDirective = hasUltracacheImportsDirective;
+exports.findUnsupportedUltracacheValue = findUnsupportedUltracacheValue;
+const nx_directives_1 = require("./nx-directives");
+const IMPORTS = 'imports';
+/**
+ * Whether the comment block that opens `content` has an
+ * `@nx-ultracache: imports` directive. False when any `@nx-ultracache` value
+ * there is unsupported.
+ */
+function hasUltracacheImportsDirective(content) {
+    const values = (0, nx_directives_1.parseNxDirectives)(content).get('ultracache');
+    return (values !== undefined && findUnsupportedUltracacheValue(values) === undefined);
+}
+/** The first of the `@nx-ultracache` values that is not supported. */
+function findUnsupportedUltracacheValue(values) {
+    return values.find((value) => value !== IMPORTS);
+}

package/dist/src/utils/without-server-inputs.d.ts

@@ -0,0 +1,6 @@
+import type { TargetDependencyConfig } from 'nx/src/devkit-exports';
+/**
+ * `dependsOn` with `inputs: false` on the entries that name projects: the
+ * servers a test talks to, not its readiness gate.
+ */
+export declare function withoutServerInputs(dependsOn: (string | TargetDependencyConfig)[]): (string | TargetDependencyConfig)[];

package/dist/src/utils/without-server-inputs.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withoutServerInputs = withoutServerInputs;
+/**
+ * `dependsOn` with `inputs: false` on the entries that name projects: the
+ * servers a test talks to, not its readiness gate.
+ */
+function withoutServerInputs(dependsOn) {
+    return dependsOn.map((dependency) => typeof dependency !== 'string' && dependency.projects
+        ? { ...dependency, inputs: false }
+        : dependency);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/devkit",
-  "version": "24.0.0-canary.20261013-994ecba",
+  "version": "24.0.0-pr.37405.acdaf31",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -67,7 +67,7 @@
   },
   "devDependencies": {
     "jest": "30.3.0",
-    "nx": "24.0.0-canary.20261013-994ecba"
+    "nx": "24.0.0-pr.37405.acdaf31"
   },
   "peerDependencies": {
     "nx": ">= 23 <= 25 || ^24.0.0-0"