nx 23.1.0 → 23.1.2

package/dist/src/devkit-internals.js

@@ -1,11 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.handleImport = exports.signalToCode = exports.globalSpinner = exports.readYamlFile = exports.isUsingPrettierInTree = exports.isCI = exports.interpolate = exports.requireWithTsconfigFallback = exports.forceRegisterEsmLoader = exports.loadTsFile = exports.registerTsProject = exports.LoadedNxPlugin = exports.retrieveProjectConfigurations = exports.findProjectForPath = exports.createProjectRootMappings = exports.createProjectRootMappingsFromProjectConfigurations = exports.hashMultiGlobWithWorkspaceContext = exports.hashWithWorkspaceContext = exports.hashObject = exports.splitByColons = exports.installPackageToTmpAsync = exports.installPackageToTmp = exports.readModulePackageJson = exports.stripIndent = exports.sortObjectByKeys = exports.combineOptionsForExecutor = exports.splitTarget = exports.getIgnoreObjectForTree = exports.readTargetDefaultsForTarget = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.readProjectConfigurationsFromRootMap = exports.mergeTargetConfigurations = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.parseExecutor = exports.getExecutorInformation = exports.createTempNpmDirectory = void 0;
+exports.checkFilesAreInputs = exports.PromptResolutionError = exports.resolvePrompt = exports.SchemaResolutionError = exports.ImplementationResolutionError = exports.resolveSchema = exports.resolveImplementation = exports.emitPluginWorkerLog = exports.safeWriteFileCache = exports.PluginCache = exports.handleImport = exports.signalToCode = exports.globalSpinner = exports.readYamlFile = exports.isUsingPrettierInTree = exports.isCI = exports.interpolate = exports.requireWithTsconfigFallback = exports.forceRegisterEsmLoader = exports.loadTsFile = exports.registerTsProject = exports.LoadedNxPlugin = exports.retrieveProjectConfigurations = exports.findProjectForPath = exports.createProjectRootMappings = exports.createProjectRootMappingsFromProjectConfigurations = exports.hashMultiGlobWithWorkspaceContext = exports.hashWithWorkspaceContext = exports.hashObject = exports.splitByColons = exports.installPackageToTmpAsync = exports.installPackageToTmp = exports.readModulePackageJson = exports.stripIndent = exports.sortObjectByKeys = exports.combineOptionsForExecutor = exports.splitTarget = exports.createPrettierIgnoreChecker = exports.createGitIgnoreChecker = exports.readTargetDefaultsForTarget = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.readProjectConfigurationsFromRootMap = exports.mergeTargetConfigurations = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.parseExecutor = exports.getExecutorInformation = exports.createTempNpmDirectory = void 0;
+exports.handleProjectGraphError = exports.createProjectGraphAndSourceMapsAsync = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.isNpmProject = exports.readFileMapCache = exports.readPackageJson = exports.isWholeFileChange = exports.isLockFileChange = exports.isDeletedFileChange = exports.defaultFileRead = exports.calculateFileChanges = exports.WholeFileChange = exports.TEN_MEGABYTES = exports.LockFileChange = exports.DeletedFileChange = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.registerTsConfigPaths = exports.getWorkspacePackagesFromGraph = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.findProjectsNpmDependencies = exports.createPackageJson = exports.getLockFileName = exports.createLockFile = exports.createNxCloudOnboardingURL = exports.getNxCloudAppOnBoardingUrl = exports.createNxCloudOnboardingURLForWelcomeApp = exports.connectToNxCloud = exports.killProcessTreeGraceful = exports.getTargetInputs = exports.filterUsingGlobPatterns = exports.hashFile = exports.getRelativeProjectJsonSchemaPath = exports.FsTree = exports.LARGE_BUFFER = exports.daemonClient = exports.isProjectGraphProjectNode = exports.isProjectGraphExternalNode = exports.fileDataDepType = exports.fileDataDepTarget = exports.BatchFunctionRunner = exports.getGeneratorInformation = exports.setupAiAgentsGenerator = exports.toOldFormat = exports.toNewFormat = exports.runCommandsExecutor = exports.acknowledgeBuildScripts = exports.getCatalogDependenciesFromPackageJson = exports.getCatalogManager = exports.checkFilesAreOutputs = void 0;
+exports.deriveGroupNameFromTarget = exports.readNxMigrateConfig = exports.isNxCloudUsed = exports.getNxCloudUrl = exports.orange = exports.NX_PREFIX = exports.getNxRequirePaths = exports.combineGlobPatterns = exports.getLatestCommitSha = exports.readFileIfExisting = exports.isRelativePath = exports.fileExists = exports.directoryExists = exports.createDirectory = exports.deduceDefaultBase = exports.codeFrameColumns = exports.runNxSync = exports.workspaceDataDirectory = exports.getLastValueFromAsyncIterableIterator = exports.validateOutputs = exports.unparse = exports.transformLegacyOutputs = exports.shouldStreamOutput = exports.removeTasksFromTaskGraph = exports.readProjectAndTargetFromTargetString = exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.isCacheableTask = exports.getUnparsedOverrideArgs = exports.getTargetConfigurationForTask = exports.getSerializedArgsForTask = exports.getPrintableCommandArgsForTask = exports.getOutputs = exports.getExecutorNameForTask = exports.getExecutorForTask = exports.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.createTaskId = exports.calculateReverseDeps = exports.createRunManyDynamicOutputRenderer = exports.CompositeLifeCycle = exports.RemoteCacheV2 = exports.Cache = exports.readCachedProjectConfiguration = exports.preventRecursionInGraphConstruction = void 0;
+exports.safeSpawn = exports.safeExecFileSync = exports.workspaceRootInner = exports.setWorkspaceRoot = exports.setupWorkspaceContext = exports.resetWorkspaceContext = exports.globWithWorkspaceContext = exports.getFilesInDirectoryUsingContext = exports.nxVersion = exports.SyncError = exports.getSourceDirOfDependentProjects = exports.findAllProjectNodeDependencies = exports.findInstalledPlugins = void 0;
 const tslib_1 = require("tslib");
 /**
- * Note to developers: STOP! These exports are available via requireNx in @nx/devkit.
+ * Note to developers: STOP! These are nx internals, not part of the public
+ * @nx/devkit API.
  *
- * These may not be available in certain version of Nx, so be sure to check them first.
+ * This barrel is NOT under @nx/devkit's version-tolerance contract. That contract
+ * (nx at the current major +/- 1, per devkit's peerDependencies) covers the public
+ * @nx/devkit API only. Two classes of consumer read this file, and the rules
+ * differ:
+ *
+ *   1. packages/devkit/src/ — devkit's own implementation. It ships to external
+ *      plugins, so it *does* run under the +/- 1 tolerance (@nx/devkit@23 may be
+ *      installed against nx@22) and must still guard: check at runtime, or only
+ *      use symbols that have existed since the oldest supported nx major.
+ *   2. First-party plugins in this repo, via @nx/devkit/internal. They release in
+ *      lockstep with nx, so they require an exactly matching nx version and need
+ *      no guarding.
+ *
+ * See packages/devkit/CLAUDE.md.
  */
 var package_manager_1 = require("./utils/package-manager");
 Object.defineProperty(exports, "createTempNpmDirectory", { enumerable: true, get: function () { return package_manager_1.createTempNpmDirectory; } });
@@ -28,8 +45,14 @@ var find_matching_projects_1 = require("./utils/find-matching-projects");
 Object.defineProperty(exports, "findMatchingProjects", { enumerable: true, get: function () { return find_matching_projects_1.findMatchingProjects; } });
 var target_defaults_1 = require("./project-graph/utils/project-configuration/target-defaults");
 Object.defineProperty(exports, "readTargetDefaultsForTarget", { enumerable: true, get: function () { return target_defaults_1.readTargetDefaultsForTarget; } });
+// Only the tree-bound checkers and their type cross the boundary. The
+// primitives they are built from carry preconditions a caller can violate - a
+// chain must be resolved from the file's own directory, and the array it
+// returns is the memo cache itself - and nothing outside this package needs
+// them.
 var ignore_1 = require("./utils/ignore");
-Object.defineProperty(exports, "getIgnoreObjectForTree", { enumerable: true, get: function () { return ignore_1.getIgnoreObjectForTree; } });
+Object.defineProperty(exports, "createGitIgnoreChecker", { enumerable: true, get: function () { return ignore_1.createGitIgnoreChecker; } });
+Object.defineProperty(exports, "createPrettierIgnoreChecker", { enumerable: true, get: function () { return ignore_1.createPrettierIgnoreChecker; } });
 var split_target_1 = require("./utils/split-target");
 Object.defineProperty(exports, "splitTarget", { enumerable: true, get: function () { return split_target_1.splitTarget; } });
 var params_1 = require("./utils/params");
@@ -90,3 +113,176 @@ Object.defineProperty(exports, "SchemaResolutionError", { enumerable: true, get:
 var prompt_files_1 = require("./command-line/migrate/prompt-files");
 Object.defineProperty(exports, "resolvePrompt", { enumerable: true, get: function () { return prompt_files_1.resolvePrompt; } });
 Object.defineProperty(exports, "PromptResolutionError", { enumerable: true, get: function () { return prompt_files_1.PromptResolutionError; } });
+var check_task_files_1 = require("./hasher/check-task-files");
+Object.defineProperty(exports, "checkFilesAreInputs", { enumerable: true, get: function () { return check_task_files_1.checkFilesAreInputs; } });
+Object.defineProperty(exports, "checkFilesAreOutputs", { enumerable: true, get: function () { return check_task_files_1.checkFilesAreOutputs; } });
+var catalog_1 = require("./utils/catalog");
+Object.defineProperty(exports, "getCatalogManager", { enumerable: true, get: function () { return catalog_1.getCatalogManager; } });
+Object.defineProperty(exports, "getCatalogDependenciesFromPackageJson", { enumerable: true, get: function () { return catalog_1.getCatalogDependenciesFromPackageJson; } });
+var acknowledge_build_scripts_1 = require("./utils/acknowledge-build-scripts");
+Object.defineProperty(exports, "acknowledgeBuildScripts", { enumerable: true, get: function () { return acknowledge_build_scripts_1.acknowledgeBuildScripts; } });
+// Exposed for first-party plugins in this repo (imported via @nx/devkit/internal).
+var run_commands_impl_1 = require("./executors/run-commands/run-commands.impl");
+Object.defineProperty(exports, "runCommandsExecutor", { enumerable: true, get: function () { return tslib_1.__importDefault(run_commands_impl_1).default; } });
+var angular_json_1 = require("./adapter/angular-json");
+Object.defineProperty(exports, "toNewFormat", { enumerable: true, get: function () { return angular_json_1.toNewFormat; } });
+Object.defineProperty(exports, "toOldFormat", { enumerable: true, get: function () { return angular_json_1.toOldFormat; } });
+var set_up_ai_agents_1 = require("./ai/set-up-ai-agents/set-up-ai-agents");
+Object.defineProperty(exports, "setupAiAgentsGenerator", { enumerable: true, get: function () { return set_up_ai_agents_1.setupAiAgentsGenerator; } });
+var generator_utils_1 = require("./command-line/generate/generator-utils");
+Object.defineProperty(exports, "getGeneratorInformation", { enumerable: true, get: function () { return generator_utils_1.getGeneratorInformation; } });
+var watch_1 = require("./command-line/watch/watch");
+Object.defineProperty(exports, "BatchFunctionRunner", { enumerable: true, get: function () { return watch_1.BatchFunctionRunner; } });
+var project_graph_1 = require("./config/project-graph");
+Object.defineProperty(exports, "fileDataDepTarget", { enumerable: true, get: function () { return project_graph_1.fileDataDepTarget; } });
+Object.defineProperty(exports, "fileDataDepType", { enumerable: true, get: function () { return project_graph_1.fileDataDepType; } });
+Object.defineProperty(exports, "isProjectGraphExternalNode", { enumerable: true, get: function () { return project_graph_1.isProjectGraphExternalNode; } });
+Object.defineProperty(exports, "isProjectGraphProjectNode", { enumerable: true, get: function () { return project_graph_1.isProjectGraphProjectNode; } });
+var client_1 = require("./daemon/client/client");
+Object.defineProperty(exports, "daemonClient", { enumerable: true, get: function () { return client_1.daemonClient; } });
+var run_commands_impl_2 = require("./executors/run-commands/run-commands.impl");
+Object.defineProperty(exports, "LARGE_BUFFER", { enumerable: true, get: function () { return run_commands_impl_2.LARGE_BUFFER; } });
+var tree_1 = require("./generators/tree");
+Object.defineProperty(exports, "FsTree", { enumerable: true, get: function () { return tree_1.FsTree; } });
+var project_configuration_1 = require("./generators/utils/project-configuration");
+Object.defineProperty(exports, "getRelativeProjectJsonSchemaPath", { enumerable: true, get: function () { return project_configuration_1.getRelativeProjectJsonSchemaPath; } });
+var file_hasher_2 = require("./hasher/file-hasher");
+Object.defineProperty(exports, "hashFile", { enumerable: true, get: function () { return file_hasher_2.hashFile; } });
+var task_hasher_1 = require("./hasher/task-hasher");
+Object.defineProperty(exports, "filterUsingGlobPatterns", { enumerable: true, get: function () { return task_hasher_1.filterUsingGlobPatterns; } });
+Object.defineProperty(exports, "getTargetInputs", { enumerable: true, get: function () { return task_hasher_1.getTargetInputs; } });
+var native_1 = require("./native");
+Object.defineProperty(exports, "killProcessTreeGraceful", { enumerable: true, get: function () { return native_1.killProcessTreeGraceful; } });
+var connect_to_nx_cloud_1 = require("./nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud");
+Object.defineProperty(exports, "connectToNxCloud", { enumerable: true, get: function () { return connect_to_nx_cloud_1.connectToNxCloud; } });
+var onboarding_1 = require("./nx-cloud/utilities/onboarding");
+Object.defineProperty(exports, "createNxCloudOnboardingURLForWelcomeApp", { enumerable: true, get: function () { return onboarding_1.createNxCloudOnboardingURLForWelcomeApp; } });
+Object.defineProperty(exports, "getNxCloudAppOnBoardingUrl", { enumerable: true, get: function () { return onboarding_1.getNxCloudAppOnBoardingUrl; } });
+var url_shorten_1 = require("./nx-cloud/utilities/url-shorten");
+Object.defineProperty(exports, "createNxCloudOnboardingURL", { enumerable: true, get: function () { return url_shorten_1.createNxCloudOnboardingURL; } });
+var lock_file_1 = require("./plugins/js/lock-file/lock-file");
+Object.defineProperty(exports, "createLockFile", { enumerable: true, get: function () { return lock_file_1.createLockFile; } });
+Object.defineProperty(exports, "getLockFileName", { enumerable: true, get: function () { return lock_file_1.getLockFileName; } });
+var create_package_json_1 = require("./plugins/js/package-json/create-package-json");
+Object.defineProperty(exports, "createPackageJson", { enumerable: true, get: function () { return create_package_json_1.createPackageJson; } });
+Object.defineProperty(exports, "findProjectsNpmDependencies", { enumerable: true, get: function () { return create_package_json_1.findProjectsNpmDependencies; } });
+var target_project_locator_1 = require("./plugins/js/project-graph/build-dependencies/target-project-locator");
+Object.defineProperty(exports, "TargetProjectLocator", { enumerable: true, get: function () { return target_project_locator_1.TargetProjectLocator; } });
+Object.defineProperty(exports, "isBuiltinModuleImport", { enumerable: true, get: function () { return target_project_locator_1.isBuiltinModuleImport; } });
+var get_workspace_packages_from_graph_1 = require("./plugins/js/utils/get-workspace-packages-from-graph");
+Object.defineProperty(exports, "getWorkspacePackagesFromGraph", { enumerable: true, get: function () { return get_workspace_packages_from_graph_1.getWorkspacePackagesFromGraph; } });
+var register_2 = require("./plugins/js/utils/register");
+Object.defineProperty(exports, "registerTsConfigPaths", { enumerable: true, get: function () { return register_2.registerTsConfigPaths; } });
+var package_json_2 = require("./plugins/package-json");
+Object.defineProperty(exports, "getGlobPatternsFromPackageManagerWorkspaces", { enumerable: true, get: function () { return package_json_2.getGlobPatternsFromPackageManagerWorkspaces; } });
+var file_utils_1 = require("./project-graph/file-utils");
+Object.defineProperty(exports, "DeletedFileChange", { enumerable: true, get: function () { return file_utils_1.DeletedFileChange; } });
+Object.defineProperty(exports, "LockFileChange", { enumerable: true, get: function () { return file_utils_1.LockFileChange; } });
+Object.defineProperty(exports, "TEN_MEGABYTES", { enumerable: true, get: function () { return file_utils_1.TEN_MEGABYTES; } });
+Object.defineProperty(exports, "WholeFileChange", { enumerable: true, get: function () { return file_utils_1.WholeFileChange; } });
+Object.defineProperty(exports, "calculateFileChanges", { enumerable: true, get: function () { return file_utils_1.calculateFileChanges; } });
+Object.defineProperty(exports, "defaultFileRead", { enumerable: true, get: function () { return file_utils_1.defaultFileRead; } });
+Object.defineProperty(exports, "isDeletedFileChange", { enumerable: true, get: function () { return file_utils_1.isDeletedFileChange; } });
+Object.defineProperty(exports, "isLockFileChange", { enumerable: true, get: function () { return file_utils_1.isLockFileChange; } });
+Object.defineProperty(exports, "isWholeFileChange", { enumerable: true, get: function () { return file_utils_1.isWholeFileChange; } });
+Object.defineProperty(exports, "readPackageJson", { enumerable: true, get: function () { return file_utils_1.readPackageJson; } });
+var nx_deps_cache_1 = require("./project-graph/nx-deps-cache");
+Object.defineProperty(exports, "readFileMapCache", { enumerable: true, get: function () { return nx_deps_cache_1.readFileMapCache; } });
+var operators_1 = require("./project-graph/operators");
+Object.defineProperty(exports, "isNpmProject", { enumerable: true, get: function () { return operators_1.isNpmProject; } });
+var project_graph_2 = require("./project-graph/project-graph");
+Object.defineProperty(exports, "buildProjectGraphAndSourceMapsWithoutDaemon", { enumerable: true, get: function () { return project_graph_2.buildProjectGraphAndSourceMapsWithoutDaemon; } });
+Object.defineProperty(exports, "createProjectGraphAndSourceMapsAsync", { enumerable: true, get: function () { return project_graph_2.createProjectGraphAndSourceMapsAsync; } });
+Object.defineProperty(exports, "handleProjectGraphError", { enumerable: true, get: function () { return project_graph_2.handleProjectGraphError; } });
+Object.defineProperty(exports, "preventRecursionInGraphConstruction", { enumerable: true, get: function () { return project_graph_2.preventRecursionInGraphConstruction; } });
+Object.defineProperty(exports, "readCachedProjectConfiguration", { enumerable: true, get: function () { return project_graph_2.readCachedProjectConfiguration; } });
+var cache_1 = require("./tasks-runner/cache");
+Object.defineProperty(exports, "Cache", { enumerable: true, get: function () { return cache_1.Cache; } });
+var default_tasks_runner_1 = require("./tasks-runner/default-tasks-runner");
+Object.defineProperty(exports, "RemoteCacheV2", { enumerable: true, get: function () { return default_tasks_runner_1.RemoteCacheV2; } });
+var life_cycle_1 = require("./tasks-runner/life-cycle");
+Object.defineProperty(exports, "CompositeLifeCycle", { enumerable: true, get: function () { return life_cycle_1.CompositeLifeCycle; } });
+var dynamic_run_many_terminal_output_life_cycle_1 = require("./tasks-runner/life-cycles/dynamic-run-many-terminal-output-life-cycle");
+Object.defineProperty(exports, "createRunManyDynamicOutputRenderer", { enumerable: true, get: function () { return dynamic_run_many_terminal_output_life_cycle_1.createRunManyDynamicOutputRenderer; } });
+var utils_2 = require("./tasks-runner/utils");
+Object.defineProperty(exports, "calculateReverseDeps", { enumerable: true, get: function () { return utils_2.calculateReverseDeps; } });
+Object.defineProperty(exports, "createTaskId", { enumerable: true, get: function () { return utils_2.createTaskId; } });
+Object.defineProperty(exports, "expandDependencyConfigSyntaxSugar", { enumerable: true, get: function () { return utils_2.expandDependencyConfigSyntaxSugar; } });
+Object.defineProperty(exports, "expandInitiatingTasksThroughNoop", { enumerable: true, get: function () { return utils_2.expandInitiatingTasksThroughNoop; } });
+Object.defineProperty(exports, "expandWildcardTargetConfiguration", { enumerable: true, get: function () { return utils_2.expandWildcardTargetConfiguration; } });
+Object.defineProperty(exports, "getCliPath", { enumerable: true, get: function () { return utils_2.getCliPath; } });
+Object.defineProperty(exports, "getCustomHasher", { enumerable: true, get: function () { return utils_2.getCustomHasher; } });
+Object.defineProperty(exports, "getDependencyConfigs", { enumerable: true, get: function () { return utils_2.getDependencyConfigs; } });
+Object.defineProperty(exports, "getExecutorForTask", { enumerable: true, get: function () { return utils_2.getExecutorForTask; } });
+Object.defineProperty(exports, "getExecutorNameForTask", { enumerable: true, get: function () { return utils_2.getExecutorNameForTask; } });
+Object.defineProperty(exports, "getOutputs", { enumerable: true, get: function () { return utils_2.getOutputs; } });
+Object.defineProperty(exports, "getPrintableCommandArgsForTask", { enumerable: true, get: function () { return utils_2.getPrintableCommandArgsForTask; } });
+Object.defineProperty(exports, "getSerializedArgsForTask", { enumerable: true, get: function () { return utils_2.getSerializedArgsForTask; } });
+Object.defineProperty(exports, "getTargetConfigurationForTask", { enumerable: true, get: function () { return utils_2.getTargetConfigurationForTask; } });
+Object.defineProperty(exports, "getUnparsedOverrideArgs", { enumerable: true, get: function () { return utils_2.getUnparsedOverrideArgs; } });
+Object.defineProperty(exports, "isCacheableTask", { enumerable: true, get: function () { return utils_2.isCacheableTask; } });
+Object.defineProperty(exports, "normalizeDependencyConfigDefinition", { enumerable: true, get: function () { return utils_2.normalizeDependencyConfigDefinition; } });
+Object.defineProperty(exports, "normalizeDependencyConfigProjects", { enumerable: true, get: function () { return utils_2.normalizeDependencyConfigProjects; } });
+Object.defineProperty(exports, "normalizeTargetDependencyWithStringProjects", { enumerable: true, get: function () { return utils_2.normalizeTargetDependencyWithStringProjects; } });
+Object.defineProperty(exports, "readProjectAndTargetFromTargetString", { enumerable: true, get: function () { return utils_2.readProjectAndTargetFromTargetString; } });
+Object.defineProperty(exports, "removeTasksFromTaskGraph", { enumerable: true, get: function () { return utils_2.removeTasksFromTaskGraph; } });
+Object.defineProperty(exports, "shouldStreamOutput", { enumerable: true, get: function () { return utils_2.shouldStreamOutput; } });
+Object.defineProperty(exports, "transformLegacyOutputs", { enumerable: true, get: function () { return utils_2.transformLegacyOutputs; } });
+Object.defineProperty(exports, "unparse", { enumerable: true, get: function () { return utils_2.unparse; } });
+Object.defineProperty(exports, "validateOutputs", { enumerable: true, get: function () { return utils_2.validateOutputs; } });
+var async_iterator_1 = require("./utils/async-iterator");
+Object.defineProperty(exports, "getLastValueFromAsyncIterableIterator", { enumerable: true, get: function () { return async_iterator_1.getLastValueFromAsyncIterableIterator; } });
+var cache_directory_1 = require("./utils/cache-directory");
+Object.defineProperty(exports, "workspaceDataDirectory", { enumerable: true, get: function () { return cache_directory_1.workspaceDataDirectory; } });
+var child_process_1 = require("./utils/child-process");
+Object.defineProperty(exports, "runNxSync", { enumerable: true, get: function () { return child_process_1.runNxSync; } });
+var code_frames_1 = require("./utils/code-frames");
+Object.defineProperty(exports, "codeFrameColumns", { enumerable: true, get: function () { return code_frames_1.codeFrameColumns; } });
+var default_base_1 = require("./utils/default-base");
+Object.defineProperty(exports, "deduceDefaultBase", { enumerable: true, get: function () { return default_base_1.deduceDefaultBase; } });
+var fileutils_2 = require("./utils/fileutils");
+Object.defineProperty(exports, "createDirectory", { enumerable: true, get: function () { return fileutils_2.createDirectory; } });
+Object.defineProperty(exports, "directoryExists", { enumerable: true, get: function () { return fileutils_2.directoryExists; } });
+Object.defineProperty(exports, "fileExists", { enumerable: true, get: function () { return fileutils_2.fileExists; } });
+Object.defineProperty(exports, "isRelativePath", { enumerable: true, get: function () { return fileutils_2.isRelativePath; } });
+Object.defineProperty(exports, "readFileIfExisting", { enumerable: true, get: function () { return fileutils_2.readFileIfExisting; } });
+var git_utils_1 = require("./utils/git-utils");
+Object.defineProperty(exports, "getLatestCommitSha", { enumerable: true, get: function () { return git_utils_1.getLatestCommitSha; } });
+var globs_1 = require("./utils/globs");
+Object.defineProperty(exports, "combineGlobPatterns", { enumerable: true, get: function () { return globs_1.combineGlobPatterns; } });
+var installation_directory_1 = require("./utils/installation-directory");
+Object.defineProperty(exports, "getNxRequirePaths", { enumerable: true, get: function () { return installation_directory_1.getNxRequirePaths; } });
+var logger_2 = require("./utils/logger");
+Object.defineProperty(exports, "NX_PREFIX", { enumerable: true, get: function () { return logger_2.NX_PREFIX; } });
+var output_1 = require("./utils/output");
+Object.defineProperty(exports, "orange", { enumerable: true, get: function () { return output_1.orange; } });
+var nx_cloud_utils_1 = require("./utils/nx-cloud-utils");
+Object.defineProperty(exports, "getNxCloudUrl", { enumerable: true, get: function () { return nx_cloud_utils_1.getNxCloudUrl; } });
+Object.defineProperty(exports, "isNxCloudUsed", { enumerable: true, get: function () { return nx_cloud_utils_1.isNxCloudUsed; } });
+var package_json_3 = require("./utils/package-json");
+Object.defineProperty(exports, "readNxMigrateConfig", { enumerable: true, get: function () { return package_json_3.readNxMigrateConfig; } });
+// Sourced from the leaf module rather than ./utils/plugins: the barrel index
+// pulls output.ts and core-plugins.ts into the eager closure for a function that
+// depends on neither.
+var atomizer_utils_1 = require("./utils/plugins/atomizer-utils");
+Object.defineProperty(exports, "deriveGroupNameFromTarget", { enumerable: true, get: function () { return atomizer_utils_1.deriveGroupNameFromTarget; } });
+var installed_plugins_1 = require("./utils/plugins/installed-plugins");
+Object.defineProperty(exports, "findInstalledPlugins", { enumerable: true, get: function () { return installed_plugins_1.findInstalledPlugins; } });
+var project_graph_utils_1 = require("./utils/project-graph-utils");
+Object.defineProperty(exports, "findAllProjectNodeDependencies", { enumerable: true, get: function () { return project_graph_utils_1.findAllProjectNodeDependencies; } });
+Object.defineProperty(exports, "getSourceDirOfDependentProjects", { enumerable: true, get: function () { return project_graph_utils_1.getSourceDirOfDependentProjects; } });
+var sync_generators_1 = require("./utils/sync-generators");
+Object.defineProperty(exports, "SyncError", { enumerable: true, get: function () { return sync_generators_1.SyncError; } });
+var versions_1 = require("./utils/versions");
+Object.defineProperty(exports, "nxVersion", { enumerable: true, get: function () { return versions_1.nxVersion; } });
+var workspace_context_2 = require("./utils/workspace-context");
+Object.defineProperty(exports, "getFilesInDirectoryUsingContext", { enumerable: true, get: function () { return workspace_context_2.getFilesInDirectoryUsingContext; } });
+Object.defineProperty(exports, "globWithWorkspaceContext", { enumerable: true, get: function () { return workspace_context_2.globWithWorkspaceContext; } });
+Object.defineProperty(exports, "resetWorkspaceContext", { enumerable: true, get: function () { return workspace_context_2.resetWorkspaceContext; } });
+Object.defineProperty(exports, "setupWorkspaceContext", { enumerable: true, get: function () { return workspace_context_2.setupWorkspaceContext; } });
+var workspace_root_1 = require("./utils/workspace-root");
+Object.defineProperty(exports, "setWorkspaceRoot", { enumerable: true, get: function () { return workspace_root_1.setWorkspaceRoot; } });
+Object.defineProperty(exports, "workspaceRootInner", { enumerable: true, get: function () { return workspace_root_1.workspaceRootInner; } });
+var safe_spawn_1 = require("./utils/safe-spawn");
+Object.defineProperty(exports, "safeExecFileSync", { enumerable: true, get: function () { return safe_spawn_1.safeExecFileSync; } });
+Object.defineProperty(exports, "safeSpawn", { enumerable: true, get: function () { return safe_spawn_1.safeSpawn; } });

package/dist/src/generators/internal-utils/format-changed-files-with-prettier-if-available.d.ts

@@ -10,6 +10,11 @@ import type { Tree } from '../tree';
  */
 export declare function formatChangedFilesWithPrettierIfAvailable(tree: Tree, options?: {
     silent?: boolean;
+    /**
+     * Tree-relative paths to leave untouched. Both platform-native and
+     * forward-slash separators are accepted.
+     */
+    excludePaths?: Set<string>;
 }): Promise<void>;
 export declare function formatFilesWithPrettierIfAvailable(files: {
     path: string;

package/dist/src/generators/internal-utils/format-changed-files-with-prettier-if-available.js

@@ -5,6 +5,7 @@ exports.formatFilesWithPrettierIfAvailable = formatFilesWithPrettierIfAvailable;
 const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
 const is_using_prettier_1 = require("../../utils/is-using-prettier");
+const path_1 = require("../../utils/path");
 const installation_directory_1 = require("../../utils/installation-directory");
 /**
  * Formats all the created or updated files using Prettier
@@ -19,7 +20,13 @@ async function formatChangedFilesWithPrettierIfAvailable(tree, options) {
     if (process.env.NX_SKIP_FORMAT === 'true') {
         return;
     }
-    const files = new Set(tree.listChanges().filter((file) => file.type !== 'DELETE'));
+    const excludedPaths = options?.excludePaths
+        ? new Set(Array.from(options.excludePaths, path_1.normalizePath))
+        : undefined;
+    const files = new Set(tree
+        .listChanges()
+        .filter((file) => file.type !== 'DELETE' &&
+        !excludedPaths?.has((0, path_1.normalizePath)(file.path))));
     const results = await formatFilesWithPrettierIfAvailable(Array.from(files), tree.root, options);
     for (const [path, content] of results) {
         tree.write(path, content);
@@ -28,7 +35,7 @@ async function formatChangedFilesWithPrettierIfAvailable(tree, options) {
 async function formatFilesWithPrettierIfAvailable(files, root, options) {
     const results = new Map();
     // Check here as well for direct callers of this function
-    if (process.env.NX_SKIP_FORMAT === 'true') {
+    if (process.env.NX_SKIP_FORMAT === 'true' || files.length === 0) {
         return results;
     }
     let prettier;

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

@@ -19,12 +19,14 @@ export interface Tree {
      */
     root: string;
     /**
-     * Read the contents of a file.
+     * Read the contents of a file. `null` when the file does not exist - an
+     * empty file reads as empty, not as missing.
      * @param filePath A path to a file.
      */
     read(filePath: string): Buffer | null;
     /**
-     * Read the contents of a file as string.
+     * Read the contents of a file as string. `null` when the file does not
+     * exist - an empty file reads as `''`, not as missing.
      * @param filePath A path to a file.
      * @param encoding the encoding for the result
      */

package/dist/src/generators/utils/nx-json.js

@@ -42,9 +42,19 @@ function updateNxJson(tree, nxJson) {
 }
 function readNxJsonExtends(tree, extendsPath) {
     try {
-        return (0, json_1.readJson)(tree, (0, path_1.relative)(tree.root, require.resolve(extendsPath, {
-            paths: [tree.root],
-        })));
+        let resolvedExtendsPath;
+        try {
+            resolvedExtendsPath = require.resolve(extendsPath, {
+                paths: [tree.root],
+            });
+        }
+        catch {
+            // Tree roots without a node_modules folder (e.g. the in-memory trees
+            // used in tests) can't anchor module resolution; fall back to
+            // resolving from the running nx package.
+            resolvedExtendsPath = require.resolve(extendsPath);
+        }
+        return (0, json_1.readJson)(tree, (0, path_1.relative)(tree.root, resolvedExtendsPath));
     }
     catch (e) {
         throw new Error(`Unable to resolve nx.json extends. Error: ${e.message}`);

package/dist/src/hasher/check-task-files.d.ts

@@ -0,0 +1,86 @@
+import { type NxJsonConfiguration } from '../config/nx-json';
+import type { ProjectGraph } from '../config/project-graph';
+import type { HashInputs } from '../native';
+/**
+ * A project graph the caller has already built. `nx show target` resolves one to
+ * find the target in the first place, and `createProjectGraphAsync` is not
+ * memoized, so without this the CLI would build the graph a second time.
+ */
+export interface TaskFileCheckSeed {
+    projectGraph: ProjectGraph;
+    nxJson: NxJsonConfiguration;
+}
+/** The rule that made a value an input for a task. */
+export type InputCategory = 'files' | 'depOutputs' | 'dependentTasksOutputFiles' | 'runtime' | 'environment' | 'external';
+export interface InputCandidate {
+    /** The value as supplied — matched verbatim against environment/runtime/external. */
+    value: string;
+    /** Workspace-relative path form of `value` — matched against the path categories. */
+    path: string;
+}
+/**
+ * Check which values are legitimate inputs for the given task. A value matches
+ * when it is:
+ *   - a declared environment variable, runtime input, or external dependency;
+ *   - a file in the task's declared input file list;
+ *   - a file in the task's materialized `depOutputs` (upstream has run);
+ *   - a file matching a `dependentTasksOutputFiles` glob declared on the task
+ *     that lies inside the declared outputs of an upstream task in the task
+ *     graph (static — works even when upstream tasks have not yet run).
+ *
+ * `categories` records the rule each matched value satisfied. Paths may be
+ * workspace-relative or absolute; absolute ones are relativized against the
+ * workspace root, and a path outside the workspace simply matches nothing. A
+ * caller resolving paths against a cwd passes an {@link InputCandidate} so that
+ * names are still matched verbatim.
+ */
+export declare function checkFilesAreInputs(taskId: string, files: Array<string | InputCandidate>): Promise<{
+    matched: string[];
+    unmatched: string[];
+    categories: Map<string, InputCategory>;
+}>;
+/**
+ * Check which files match the output globs declared for the given task.
+ * Uses the same path-matching logic as the task runner (directory containment
+ * + glob matching through the native `globset` engine), including negated
+ * (`!`-prefixed) patterns acting as exclusions over the whole pattern set.
+ *
+ * Paths may be workspace-relative or absolute; absolute ones are relativized
+ * against the workspace root. An output pattern whose `{options.*}` token has no
+ * value resolves to nothing — exactly as the task runner drops it — so a file it
+ * would have covered is reported `unmatched`, like any other non-output.
+ *
+ * That last case makes `unmatched` two answers in one: "not an output" and
+ * "the outputs could not be determined". A consumer judging sandbox violations
+ * cannot tell them apart, and would call the second one illegal. `getTaskOutputs`
+ * already computes the `unresolved` list this would need; surfacing it here is
+ * deliberately deferred until a consumer's contract asks for the distinction.
+ */
+export declare function checkFilesAreOutputs(taskId: string, files: string[]): Promise<{
+    matched: string[];
+    unmatched: string[];
+}>;
+/**
+ * Returns the full hash inputs for a task (files + runtime + env + depOutputs
+ * + external). Used internally by the `nx show target --inputs` renderer.
+ */
+export declare function getTaskRawInputs(taskId: string, seed?: TaskFileCheckSeed): Promise<HashInputs | null>;
+export interface TaskOutputs {
+    /** Output patterns after token substitution — what the task runner will cache. */
+    resolved: string[];
+    /** `resolved`, expanded against the files currently on disk. */
+    expanded: string[];
+    /** Configured outputs left out of `resolved` because an option had no value. */
+    unresolved: string[];
+}
+/**
+ * Returns the outputs declared for a task, resolved against its effective
+ * configuration. Used internally by the `nx show target --outputs` renderer.
+ */
+export declare function getTaskOutputs(taskId: string, seed?: TaskFileCheckSeed): Promise<TaskOutputs>;
+/**
+ * Resets all module-level caches. Call this in `beforeEach` when testing so
+ * each test gets a fresh context load. Not part of the public API.
+ * @internal
+ */
+export declare function _resetContextForTesting(): void;