@nx/devkit 23.1.1 → 23.1.2

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-export { signalToCode, createProjectRootMappingsFromProjectConfigurations, PluginCache, safeWriteFileCache, emitPluginWorkerLog, resolveImplementation, resolveSchema, ImplementationResolutionError, SchemaResolutionError, resolvePrompt, PromptResolutionError, acknowledgeBuildScripts, } from 'nx/src/devkit-internals';
+export { signalToCode, createProjectRootMappingsFromProjectConfigurations, PluginCache, safeWriteFileCache, emitPluginWorkerLog, resolveImplementation, resolveSchema, ImplementationResolutionError, SchemaResolutionError, resolvePrompt, PromptResolutionError, acknowledgeBuildScripts, getCatalogManager, } from 'nx/src/devkit-internals';
 export { determineArtifactNameAndDirectoryOptions, getRelativeCwd, type FileExtensionType, } from './src/generators/artifact-name-and-directory-utils';
 export { getE2EWebServerInfo, type E2EWebServerDetails, } from './src/generators/e2e-web-server-info-utils';
 export { forEachExecutorOptions } from './src/generators/executor-options-utils';
@@ -13,7 +13,6 @@ export { getDeclaredPackageVersion, getInstalledPackageVersion, } from './src/ut
 export { assertSupportedInstalledPackageVersion, assertSupportedPackageVersion, } from './src/utils/version-floor';
 export { createAsyncIterable, combineAsyncIterables, mapAsyncIterable, } from './src/utils/async-iterable';
 export { calculateHashForCreateNodes, calculateHashesForCreateNodes, } from './src/utils/calculate-hash-for-create-nodes';
-export { getCatalogManager } from 'nx/src/utils/catalog';
 export { loadConfigFile, clearRequireCache } from './src/utils/config-utils';
 export { findPluginForConfigFile } from './src/utils/find-plugin-for-config-file';
 export { getNamedInputs } from './src/utils/get-named-inputs';
@@ -21,3 +20,5 @@ export { logShowProjectCommand } from './src/utils/log-show-project-command';
 export { eachValueFrom } from './src/utils/rxjs-for-await';
 export { checkAndCleanWithSemver } from './src/utils/semver';
 export { camelize, capitalize, classify, dasherize, } from './src/utils/string-utils';
+export { runCommandsExecutor, type TaskResult, type Agent, type BatchExecutorTaskResult, BatchFunctionRunner, type BatchResults, type CLIErrorMessageConfig, type CLINoteMessageConfig, type CLISuccessMessageConfig, type CLIWarnMessageConfig, Cache, type CachedResult, type Change, type ChangedFile, CompositeLifeCycle, DeletedFileChange, type DependsOnEntryLocation, type FileChange, type FileDataDependency, type FileMapCache, type FinalConfigForProject, FsTree, type GeneratorInformation, type InputDefinition, type JsonInput, LARGE_BUFFER, type LifeCycle, LockFileChange, NX_PREFIX, type NormalizedTargetDependencyConfig, type NxCloudOnBoardingStatus, type NxReleaseVersionConfiguration, type PackageJson, type PackageJsonDependencySection, type PackageManagerCommands, type ProjectRootMappings, RemoteCacheV2, type RunCommandsOptions, SyncError, type SyncGeneratorResult, TEN_MEGABYTES, TargetProjectLocator, type TaskMetadata, type TaskStatus, type TaskWithCachedResult, type TasksRunner, type UnregisterCallback, WholeFileChange, buildProjectGraphAndSourceMapsWithoutDaemon, calculateFileChanges, calculateReverseDeps, codeFrameColumns, combineGlobPatterns, connectToNxCloud, createDirectory, createLockFile, createNxCloudOnboardingURL, createNxCloudOnboardingURLForWelcomeApp, createPackageJson, createProjectGraphAndSourceMapsAsync, createProjectRootMappings, createRunManyDynamicOutputRenderer, createTaskId, daemonClient, deduceDefaultBase, defaultFileRead, deriveGroupNameFromTarget, directoryExists, expandDependencyConfigSyntaxSugar, expandInitiatingTasksThroughNoop, expandWildcardTargetConfiguration, fileDataDepTarget, fileDataDepType, fileExists, filterUsingGlobPatterns, findAllProjectNodeDependencies, findInstalledPlugins, findMatchingConfigFiles, findMatchingProjects, findProjectForPath, findProjectsNpmDependencies, forceRegisterEsmLoader, getCliPath, getCustomHasher, getDependencyConfigs, getExecutorForTask, getExecutorInformation, getExecutorNameForTask, getFilesInDirectoryUsingContext, getGeneratorInformation, getGlobPatternsFromPackageManagerWorkspaces, getLastValueFromAsyncIterableIterator, getLatestCommitSha, getLockFileName, getNxCloudAppOnBoardingUrl, getNxCloudUrl, getNxRequirePaths, getOutputs, getPrintableCommandArgsForTask, getRelativeProjectJsonSchemaPath, getSerializedArgsForTask, getSourceDirOfDependentProjects, getTargetConfigurationForTask, getTargetInputs, getUnparsedOverrideArgs, getWorkspacePackagesFromGraph, globWithWorkspaceContext, handleProjectGraphError, hashFile, hashObject, hashWithWorkspaceContext, interpolate, isBuiltinModuleImport, isCI, isCacheableTask, isDeletedFileChange, isLockFileChange, isNpmProject, isNxCloudUsed, isProjectGraphExternalNode, isProjectGraphProjectNode, isRelativePath, isWholeFileChange, killProcessTreeGraceful, loadTsFile, mergeTargetConfigurations, normalizeDependencyConfigDefinition, normalizeDependencyConfigProjects, normalizeTargetDependencyWithStringProjects, nxVersion, orange, parseExecutor, preventRecursionInGraphConstruction, readCachedProjectConfiguration, readFileIfExisting, readFileMapCache, readModulePackageJson, readNxJsonFromDisk, readNxMigrateConfig, readPackageJson, readProjectAndTargetFromTargetString, registerTsConfigPaths, registerTsProject, removeTasksFromTaskGraph, requireWithTsconfigFallback, resetWorkspaceContext, runNxSync, safeExecFileSync, safeSpawn, setWorkspaceRoot, setupAiAgentsGenerator, setupWorkspaceContext, shouldStreamOutput, toNewFormat, toOldFormat, transformLegacyOutputs, unparse, validateOutputs, workspaceDataDirectory, workspaceRootInner, } from 'nx/src/devkit-internals';
+export type { AfterAllProjectsVersioned } from 'nx/release';

package/dist/internal.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eachValueFrom = exports.logShowProjectCommand = exports.getNamedInputs = exports.findPluginForConfigFile = exports.clearRequireCache = exports.loadConfigFile = exports.getCatalogManager = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersion = exports.getDeclaredPackageVersion = exports.addPlugin = exports.upsertTargetDefault = exports.updateTargetDefault = exports.readTargetDefaultsForTarget = exports.findTargetDefault = exports.addE2eCiTargetDefaults = exports.addBuildTargetDefaults = exports.promptWhenInteractive = exports.resolveImportPath = exports.ensureRootProjectName = exports.determineProjectNameAndRootOptions = exports.toProjectRelativePath = exports.deleteMatchingProperties = exports.processTargetOutputs = exports.NoTargetsToMigrateError = exports.migrateProjectExecutorsToPluginV1 = exports.migrateProjectExecutorsToPlugin = exports.AggregatedLog = exports.forEachExecutorOptions = exports.getE2EWebServerInfo = exports.getRelativeCwd = exports.determineArtifactNameAndDirectoryOptions = 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.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.checkAndCleanWithSemver = void 0;
+exports.eachValueFrom = exports.logShowProjectCommand = exports.getNamedInputs = exports.findPluginForConfigFile = exports.clearRequireCache = exports.loadConfigFile = exports.calculateHashesForCreateNodes = exports.calculateHashForCreateNodes = exports.mapAsyncIterable = exports.combineAsyncIterables = exports.createAsyncIterable = exports.assertSupportedPackageVersion = exports.assertSupportedInstalledPackageVersion = exports.getInstalledPackageVersion = exports.getDeclaredPackageVersion = exports.addPlugin = exports.upsertTargetDefault = exports.updateTargetDefault = exports.readTargetDefaultsForTarget = exports.findTargetDefault = exports.addE2eCiTargetDefaults = exports.addBuildTargetDefaults = exports.promptWhenInteractive = exports.resolveImportPath = exports.ensureRootProjectName = exports.determineProjectNameAndRootOptions = exports.toProjectRelativePath = exports.deleteMatchingProperties = exports.processTargetOutputs = exports.NoTargetsToMigrateError = exports.migrateProjectExecutorsToPluginV1 = exports.migrateProjectExecutorsToPlugin = exports.AggregatedLog = exports.forEachExecutorOptions = exports.getE2EWebServerInfo = exports.getRelativeCwd = exports.determineArtifactNameAndDirectoryOptions = exports.getCatalogManager = 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.findMatchingProjects = exports.findMatchingConfigFiles = exports.findInstalledPlugins = exports.findAllProjectNodeDependencies = exports.filterUsingGlobPatterns = exports.fileExists = exports.fileDataDepType = exports.fileDataDepTarget = exports.expandWildcardTargetConfiguration = exports.expandInitiatingTasksThroughNoop = exports.expandDependencyConfigSyntaxSugar = exports.directoryExists = exports.deriveGroupNameFromTarget = exports.defaultFileRead = exports.deduceDefaultBase = exports.daemonClient = exports.createTaskId = exports.createRunManyDynamicOutputRenderer = exports.createProjectRootMappings = exports.createProjectGraphAndSourceMapsAsync = exports.createPackageJson = exports.createNxCloudOnboardingURLForWelcomeApp = exports.createNxCloudOnboardingURL = exports.createLockFile = exports.createDirectory = exports.connectToNxCloud = exports.combineGlobPatterns = exports.codeFrameColumns = exports.calculateReverseDeps = exports.calculateFileChanges = exports.buildProjectGraphAndSourceMapsWithoutDaemon = exports.WholeFileChange = exports.TargetProjectLocator = exports.TEN_MEGABYTES = exports.SyncError = exports.RemoteCacheV2 = exports.NX_PREFIX = exports.LockFileChange = exports.LARGE_BUFFER = exports.FsTree = exports.DeletedFileChange = exports.CompositeLifeCycle = exports.Cache = exports.BatchFunctionRunner = exports.runCommandsExecutor = exports.dasherize = exports.classify = exports.capitalize = exports.camelize = exports.checkAndCleanWithSemver = void 0;
+exports.normalizeTargetDependencyWithStringProjects = exports.normalizeDependencyConfigProjects = exports.normalizeDependencyConfigDefinition = exports.mergeTargetConfigurations = exports.loadTsFile = exports.killProcessTreeGraceful = 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.globWithWorkspaceContext = exports.getWorkspacePackagesFromGraph = exports.getUnparsedOverrideArgs = exports.getTargetInputs = exports.getTargetConfigurationForTask = 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.getDependencyConfigs = exports.getCustomHasher = exports.getCliPath = exports.forceRegisterEsmLoader = exports.findProjectsNpmDependencies = exports.findProjectForPath = void 0;
+exports.workspaceRootInner = exports.workspaceDataDirectory = exports.validateOutputs = exports.unparse = exports.transformLegacyOutputs = exports.toOldFormat = exports.toNewFormat = exports.shouldStreamOutput = exports.setupWorkspaceContext = exports.setupAiAgentsGenerator = exports.setWorkspaceRoot = exports.safeSpawn = exports.safeExecFileSync = exports.runNxSync = exports.resetWorkspaceContext = exports.requireWithTsconfigFallback = exports.removeTasksFromTaskGraph = exports.registerTsProject = exports.registerTsConfigPaths = exports.readProjectAndTargetFromTargetString = exports.readPackageJson = exports.readNxMigrateConfig = exports.readNxJsonFromDisk = exports.readModulePackageJson = exports.readFileMapCache = exports.readFileIfExisting = exports.readCachedProjectConfiguration = exports.preventRecursionInGraphConstruction = exports.parseExecutor = exports.orange = exports.nxVersion = 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; } });
@@ -15,6 +17,12 @@ Object.defineProperty(exports, "SchemaResolutionError", { enumerable: true, get:
 Object.defineProperty(exports, "resolvePrompt", { enumerable: true, get: function () { return devkit_internals_1.resolvePrompt; } });
 Object.defineProperty(exports, "PromptResolutionError", { enumerable: true, get: function () { return devkit_internals_1.PromptResolutionError; } });
 Object.defineProperty(exports, "acknowledgeBuildScripts", { enumerable: true, get: function () { return devkit_internals_1.acknowledgeBuildScripts; } });
+// getCatalogManager takes the barrel route here because this file *is*
+// @nx/devkit/internal — first-party consumers only, released in lockstep. Its
+// class-1 siblings in packages/devkit/src/utils/ (semver.ts, package-json.ts)
+// ship to external plugins under the +/- 1 tolerance, so they must keep
+// importing nx/src/utils/catalog directly. See packages/devkit/CLAUDE.md.
+Object.defineProperty(exports, "getCatalogManager", { enumerable: true, get: function () { return devkit_internals_1.getCatalogManager; } });
 // Generators
 var artifact_name_and_directory_utils_1 = require("./src/generators/artifact-name-and-directory-utils");
 Object.defineProperty(exports, "determineArtifactNameAndDirectoryOptions", { enumerable: true, get: function () { return artifact_name_and_directory_utils_1.determineArtifactNameAndDirectoryOptions; } });
@@ -62,9 +70,6 @@ Object.defineProperty(exports, "mapAsyncIterable", { enumerable: true, get: func
 var calculate_hash_for_create_nodes_1 = require("./src/utils/calculate-hash-for-create-nodes");
 Object.defineProperty(exports, "calculateHashForCreateNodes", { enumerable: true, get: function () { return calculate_hash_for_create_nodes_1.calculateHashForCreateNodes; } });
 Object.defineProperty(exports, "calculateHashesForCreateNodes", { enumerable: true, get: function () { return calculate_hash_for_create_nodes_1.calculateHashesForCreateNodes; } });
-// eslint-disable-next-line @typescript-eslint/no-restricted-imports -- nx/src/utils/catalog exists since nx 22.0.0, the whole supported range; swap to the nx/src/devkit-internals re-export in v25
-var catalog_1 = require("nx/src/utils/catalog");
-Object.defineProperty(exports, "getCatalogManager", { enumerable: true, get: function () { return catalog_1.getCatalogManager; } });
 var config_utils_1 = require("./src/utils/config-utils");
 Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return config_utils_1.loadConfigFile; } });
 Object.defineProperty(exports, "clearRequireCache", { enumerable: true, get: function () { return config_utils_1.clearRequireCache; } });
@@ -83,3 +88,131 @@ Object.defineProperty(exports, "camelize", { enumerable: true, get: function ()
 Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return string_utils_1.capitalize; } });
 Object.defineProperty(exports, "classify", { enumerable: true, get: function () { return string_utils_1.classify; } });
 Object.defineProperty(exports, "dasherize", { enumerable: true, get: function () { return string_utils_1.dasherize; } });
+// Re-exported for first-party plugins in this repo.
+var devkit_internals_2 = require("nx/src/devkit-internals");
+Object.defineProperty(exports, "runCommandsExecutor", { enumerable: true, get: function () { return devkit_internals_2.runCommandsExecutor; } });
+Object.defineProperty(exports, "BatchFunctionRunner", { enumerable: true, get: function () { return devkit_internals_2.BatchFunctionRunner; } });
+Object.defineProperty(exports, "Cache", { enumerable: true, get: function () { return devkit_internals_2.Cache; } });
+Object.defineProperty(exports, "CompositeLifeCycle", { enumerable: true, get: function () { return devkit_internals_2.CompositeLifeCycle; } });
+Object.defineProperty(exports, "DeletedFileChange", { enumerable: true, get: function () { return devkit_internals_2.DeletedFileChange; } });
+Object.defineProperty(exports, "FsTree", { enumerable: true, get: function () { return devkit_internals_2.FsTree; } });
+Object.defineProperty(exports, "LARGE_BUFFER", { enumerable: true, get: function () { return devkit_internals_2.LARGE_BUFFER; } });
+Object.defineProperty(exports, "LockFileChange", { enumerable: true, get: function () { return devkit_internals_2.LockFileChange; } });
+Object.defineProperty(exports, "NX_PREFIX", { enumerable: true, get: function () { return devkit_internals_2.NX_PREFIX; } });
+Object.defineProperty(exports, "RemoteCacheV2", { enumerable: true, get: function () { return devkit_internals_2.RemoteCacheV2; } });
+Object.defineProperty(exports, "SyncError", { enumerable: true, get: function () { return devkit_internals_2.SyncError; } });
+Object.defineProperty(exports, "TEN_MEGABYTES", { enumerable: true, get: function () { return devkit_internals_2.TEN_MEGABYTES; } });
+Object.defineProperty(exports, "TargetProjectLocator", { enumerable: true, get: function () { return devkit_internals_2.TargetProjectLocator; } });
+Object.defineProperty(exports, "WholeFileChange", { enumerable: true, get: function () { return devkit_internals_2.WholeFileChange; } });
+Object.defineProperty(exports, "buildProjectGraphAndSourceMapsWithoutDaemon", { enumerable: true, get: function () { return devkit_internals_2.buildProjectGraphAndSourceMapsWithoutDaemon; } });
+Object.defineProperty(exports, "calculateFileChanges", { enumerable: true, get: function () { return devkit_internals_2.calculateFileChanges; } });
+Object.defineProperty(exports, "calculateReverseDeps", { enumerable: true, get: function () { return devkit_internals_2.calculateReverseDeps; } });
+Object.defineProperty(exports, "codeFrameColumns", { enumerable: true, get: function () { return devkit_internals_2.codeFrameColumns; } });
+Object.defineProperty(exports, "combineGlobPatterns", { enumerable: true, get: function () { return devkit_internals_2.combineGlobPatterns; } });
+Object.defineProperty(exports, "connectToNxCloud", { enumerable: true, get: function () { return devkit_internals_2.connectToNxCloud; } });
+Object.defineProperty(exports, "createDirectory", { enumerable: true, get: function () { return devkit_internals_2.createDirectory; } });
+Object.defineProperty(exports, "createLockFile", { enumerable: true, get: function () { return devkit_internals_2.createLockFile; } });
+Object.defineProperty(exports, "createNxCloudOnboardingURL", { enumerable: true, get: function () { return devkit_internals_2.createNxCloudOnboardingURL; } });
+Object.defineProperty(exports, "createNxCloudOnboardingURLForWelcomeApp", { enumerable: true, get: function () { return devkit_internals_2.createNxCloudOnboardingURLForWelcomeApp; } });
+Object.defineProperty(exports, "createPackageJson", { enumerable: true, get: function () { return devkit_internals_2.createPackageJson; } });
+Object.defineProperty(exports, "createProjectGraphAndSourceMapsAsync", { enumerable: true, get: function () { return devkit_internals_2.createProjectGraphAndSourceMapsAsync; } });
+Object.defineProperty(exports, "createProjectRootMappings", { enumerable: true, get: function () { return devkit_internals_2.createProjectRootMappings; } });
+Object.defineProperty(exports, "createRunManyDynamicOutputRenderer", { enumerable: true, get: function () { return devkit_internals_2.createRunManyDynamicOutputRenderer; } });
+Object.defineProperty(exports, "createTaskId", { enumerable: true, get: function () { return devkit_internals_2.createTaskId; } });
+Object.defineProperty(exports, "daemonClient", { enumerable: true, get: function () { return devkit_internals_2.daemonClient; } });
+Object.defineProperty(exports, "deduceDefaultBase", { enumerable: true, get: function () { return devkit_internals_2.deduceDefaultBase; } });
+Object.defineProperty(exports, "defaultFileRead", { enumerable: true, get: function () { return devkit_internals_2.defaultFileRead; } });
+Object.defineProperty(exports, "deriveGroupNameFromTarget", { enumerable: true, get: function () { return devkit_internals_2.deriveGroupNameFromTarget; } });
+Object.defineProperty(exports, "directoryExists", { enumerable: true, get: function () { return devkit_internals_2.directoryExists; } });
+Object.defineProperty(exports, "expandDependencyConfigSyntaxSugar", { enumerable: true, get: function () { return devkit_internals_2.expandDependencyConfigSyntaxSugar; } });
+Object.defineProperty(exports, "expandInitiatingTasksThroughNoop", { enumerable: true, get: function () { return devkit_internals_2.expandInitiatingTasksThroughNoop; } });
+Object.defineProperty(exports, "expandWildcardTargetConfiguration", { enumerable: true, get: function () { return devkit_internals_2.expandWildcardTargetConfiguration; } });
+Object.defineProperty(exports, "fileDataDepTarget", { enumerable: true, get: function () { return devkit_internals_2.fileDataDepTarget; } });
+Object.defineProperty(exports, "fileDataDepType", { enumerable: true, get: function () { return devkit_internals_2.fileDataDepType; } });
+Object.defineProperty(exports, "fileExists", { enumerable: true, get: function () { return devkit_internals_2.fileExists; } });
+Object.defineProperty(exports, "filterUsingGlobPatterns", { enumerable: true, get: function () { return devkit_internals_2.filterUsingGlobPatterns; } });
+Object.defineProperty(exports, "findAllProjectNodeDependencies", { enumerable: true, get: function () { return devkit_internals_2.findAllProjectNodeDependencies; } });
+Object.defineProperty(exports, "findInstalledPlugins", { enumerable: true, get: function () { return devkit_internals_2.findInstalledPlugins; } });
+Object.defineProperty(exports, "findMatchingConfigFiles", { enumerable: true, get: function () { return devkit_internals_2.findMatchingConfigFiles; } });
+Object.defineProperty(exports, "findMatchingProjects", { enumerable: true, get: function () { return devkit_internals_2.findMatchingProjects; } });
+Object.defineProperty(exports, "findProjectForPath", { enumerable: true, get: function () { return devkit_internals_2.findProjectForPath; } });
+Object.defineProperty(exports, "findProjectsNpmDependencies", { enumerable: true, get: function () { return devkit_internals_2.findProjectsNpmDependencies; } });
+Object.defineProperty(exports, "forceRegisterEsmLoader", { enumerable: true, get: function () { return devkit_internals_2.forceRegisterEsmLoader; } });
+Object.defineProperty(exports, "getCliPath", { enumerable: true, get: function () { return devkit_internals_2.getCliPath; } });
+Object.defineProperty(exports, "getCustomHasher", { enumerable: true, get: function () { return devkit_internals_2.getCustomHasher; } });
+Object.defineProperty(exports, "getDependencyConfigs", { enumerable: true, get: function () { return devkit_internals_2.getDependencyConfigs; } });
+Object.defineProperty(exports, "getExecutorForTask", { enumerable: true, get: function () { return devkit_internals_2.getExecutorForTask; } });
+Object.defineProperty(exports, "getExecutorInformation", { enumerable: true, get: function () { return devkit_internals_2.getExecutorInformation; } });
+Object.defineProperty(exports, "getExecutorNameForTask", { enumerable: true, get: function () { return devkit_internals_2.getExecutorNameForTask; } });
+Object.defineProperty(exports, "getFilesInDirectoryUsingContext", { enumerable: true, get: function () { return devkit_internals_2.getFilesInDirectoryUsingContext; } });
+Object.defineProperty(exports, "getGeneratorInformation", { enumerable: true, get: function () { return devkit_internals_2.getGeneratorInformation; } });
+Object.defineProperty(exports, "getGlobPatternsFromPackageManagerWorkspaces", { enumerable: true, get: function () { return devkit_internals_2.getGlobPatternsFromPackageManagerWorkspaces; } });
+Object.defineProperty(exports, "getLastValueFromAsyncIterableIterator", { enumerable: true, get: function () { return devkit_internals_2.getLastValueFromAsyncIterableIterator; } });
+Object.defineProperty(exports, "getLatestCommitSha", { enumerable: true, get: function () { return devkit_internals_2.getLatestCommitSha; } });
+Object.defineProperty(exports, "getLockFileName", { enumerable: true, get: function () { return devkit_internals_2.getLockFileName; } });
+Object.defineProperty(exports, "getNxCloudAppOnBoardingUrl", { enumerable: true, get: function () { return devkit_internals_2.getNxCloudAppOnBoardingUrl; } });
+Object.defineProperty(exports, "getNxCloudUrl", { enumerable: true, get: function () { return devkit_internals_2.getNxCloudUrl; } });
+Object.defineProperty(exports, "getNxRequirePaths", { enumerable: true, get: function () { return devkit_internals_2.getNxRequirePaths; } });
+Object.defineProperty(exports, "getOutputs", { enumerable: true, get: function () { return devkit_internals_2.getOutputs; } });
+Object.defineProperty(exports, "getPrintableCommandArgsForTask", { enumerable: true, get: function () { return devkit_internals_2.getPrintableCommandArgsForTask; } });
+Object.defineProperty(exports, "getRelativeProjectJsonSchemaPath", { enumerable: true, get: function () { return devkit_internals_2.getRelativeProjectJsonSchemaPath; } });
+Object.defineProperty(exports, "getSerializedArgsForTask", { enumerable: true, get: function () { return devkit_internals_2.getSerializedArgsForTask; } });
+Object.defineProperty(exports, "getSourceDirOfDependentProjects", { enumerable: true, get: function () { return devkit_internals_2.getSourceDirOfDependentProjects; } });
+Object.defineProperty(exports, "getTargetConfigurationForTask", { enumerable: true, get: function () { return devkit_internals_2.getTargetConfigurationForTask; } });
+Object.defineProperty(exports, "getTargetInputs", { enumerable: true, get: function () { return devkit_internals_2.getTargetInputs; } });
+Object.defineProperty(exports, "getUnparsedOverrideArgs", { enumerable: true, get: function () { return devkit_internals_2.getUnparsedOverrideArgs; } });
+Object.defineProperty(exports, "getWorkspacePackagesFromGraph", { enumerable: true, get: function () { return devkit_internals_2.getWorkspacePackagesFromGraph; } });
+Object.defineProperty(exports, "globWithWorkspaceContext", { enumerable: true, get: function () { return devkit_internals_2.globWithWorkspaceContext; } });
+Object.defineProperty(exports, "handleProjectGraphError", { enumerable: true, get: function () { return devkit_internals_2.handleProjectGraphError; } });
+Object.defineProperty(exports, "hashFile", { enumerable: true, get: function () { return devkit_internals_2.hashFile; } });
+Object.defineProperty(exports, "hashObject", { enumerable: true, get: function () { return devkit_internals_2.hashObject; } });
+Object.defineProperty(exports, "hashWithWorkspaceContext", { enumerable: true, get: function () { return devkit_internals_2.hashWithWorkspaceContext; } });
+Object.defineProperty(exports, "interpolate", { enumerable: true, get: function () { return devkit_internals_2.interpolate; } });
+Object.defineProperty(exports, "isBuiltinModuleImport", { enumerable: true, get: function () { return devkit_internals_2.isBuiltinModuleImport; } });
+Object.defineProperty(exports, "isCI", { enumerable: true, get: function () { return devkit_internals_2.isCI; } });
+Object.defineProperty(exports, "isCacheableTask", { enumerable: true, get: function () { return devkit_internals_2.isCacheableTask; } });
+Object.defineProperty(exports, "isDeletedFileChange", { enumerable: true, get: function () { return devkit_internals_2.isDeletedFileChange; } });
+Object.defineProperty(exports, "isLockFileChange", { enumerable: true, get: function () { return devkit_internals_2.isLockFileChange; } });
+Object.defineProperty(exports, "isNpmProject", { enumerable: true, get: function () { return devkit_internals_2.isNpmProject; } });
+Object.defineProperty(exports, "isNxCloudUsed", { enumerable: true, get: function () { return devkit_internals_2.isNxCloudUsed; } });
+Object.defineProperty(exports, "isProjectGraphExternalNode", { enumerable: true, get: function () { return devkit_internals_2.isProjectGraphExternalNode; } });
+Object.defineProperty(exports, "isProjectGraphProjectNode", { enumerable: true, get: function () { return devkit_internals_2.isProjectGraphProjectNode; } });
+Object.defineProperty(exports, "isRelativePath", { enumerable: true, get: function () { return devkit_internals_2.isRelativePath; } });
+Object.defineProperty(exports, "isWholeFileChange", { enumerable: true, get: function () { return devkit_internals_2.isWholeFileChange; } });
+Object.defineProperty(exports, "killProcessTreeGraceful", { enumerable: true, get: function () { return devkit_internals_2.killProcessTreeGraceful; } });
+Object.defineProperty(exports, "loadTsFile", { enumerable: true, get: function () { return devkit_internals_2.loadTsFile; } });
+Object.defineProperty(exports, "mergeTargetConfigurations", { enumerable: true, get: function () { return devkit_internals_2.mergeTargetConfigurations; } });
+Object.defineProperty(exports, "normalizeDependencyConfigDefinition", { enumerable: true, get: function () { return devkit_internals_2.normalizeDependencyConfigDefinition; } });
+Object.defineProperty(exports, "normalizeDependencyConfigProjects", { enumerable: true, get: function () { return devkit_internals_2.normalizeDependencyConfigProjects; } });
+Object.defineProperty(exports, "normalizeTargetDependencyWithStringProjects", { enumerable: true, get: function () { return devkit_internals_2.normalizeTargetDependencyWithStringProjects; } });
+Object.defineProperty(exports, "nxVersion", { enumerable: true, get: function () { return devkit_internals_2.nxVersion; } });
+Object.defineProperty(exports, "orange", { enumerable: true, get: function () { return devkit_internals_2.orange; } });
+Object.defineProperty(exports, "parseExecutor", { enumerable: true, get: function () { return devkit_internals_2.parseExecutor; } });
+Object.defineProperty(exports, "preventRecursionInGraphConstruction", { enumerable: true, get: function () { return devkit_internals_2.preventRecursionInGraphConstruction; } });
+Object.defineProperty(exports, "readCachedProjectConfiguration", { enumerable: true, get: function () { return devkit_internals_2.readCachedProjectConfiguration; } });
+Object.defineProperty(exports, "readFileIfExisting", { enumerable: true, get: function () { return devkit_internals_2.readFileIfExisting; } });
+Object.defineProperty(exports, "readFileMapCache", { enumerable: true, get: function () { return devkit_internals_2.readFileMapCache; } });
+Object.defineProperty(exports, "readModulePackageJson", { enumerable: true, get: function () { return devkit_internals_2.readModulePackageJson; } });
+Object.defineProperty(exports, "readNxJsonFromDisk", { enumerable: true, get: function () { return devkit_internals_2.readNxJsonFromDisk; } });
+Object.defineProperty(exports, "readNxMigrateConfig", { enumerable: true, get: function () { return devkit_internals_2.readNxMigrateConfig; } });
+Object.defineProperty(exports, "readPackageJson", { enumerable: true, get: function () { return devkit_internals_2.readPackageJson; } });
+Object.defineProperty(exports, "readProjectAndTargetFromTargetString", { enumerable: true, get: function () { return devkit_internals_2.readProjectAndTargetFromTargetString; } });
+Object.defineProperty(exports, "registerTsConfigPaths", { enumerable: true, get: function () { return devkit_internals_2.registerTsConfigPaths; } });
+Object.defineProperty(exports, "registerTsProject", { enumerable: true, get: function () { return devkit_internals_2.registerTsProject; } });
+Object.defineProperty(exports, "removeTasksFromTaskGraph", { enumerable: true, get: function () { return devkit_internals_2.removeTasksFromTaskGraph; } });
+Object.defineProperty(exports, "requireWithTsconfigFallback", { enumerable: true, get: function () { return devkit_internals_2.requireWithTsconfigFallback; } });
+Object.defineProperty(exports, "resetWorkspaceContext", { enumerable: true, get: function () { return devkit_internals_2.resetWorkspaceContext; } });
+Object.defineProperty(exports, "runNxSync", { enumerable: true, get: function () { return devkit_internals_2.runNxSync; } });
+Object.defineProperty(exports, "safeExecFileSync", { enumerable: true, get: function () { return devkit_internals_2.safeExecFileSync; } });
+Object.defineProperty(exports, "safeSpawn", { enumerable: true, get: function () { return devkit_internals_2.safeSpawn; } });
+Object.defineProperty(exports, "setWorkspaceRoot", { enumerable: true, get: function () { return devkit_internals_2.setWorkspaceRoot; } });
+Object.defineProperty(exports, "setupAiAgentsGenerator", { enumerable: true, get: function () { return devkit_internals_2.setupAiAgentsGenerator; } });
+Object.defineProperty(exports, "setupWorkspaceContext", { enumerable: true, get: function () { return devkit_internals_2.setupWorkspaceContext; } });
+Object.defineProperty(exports, "shouldStreamOutput", { enumerable: true, get: function () { return devkit_internals_2.shouldStreamOutput; } });
+Object.defineProperty(exports, "toNewFormat", { enumerable: true, get: function () { return devkit_internals_2.toNewFormat; } });
+Object.defineProperty(exports, "toOldFormat", { enumerable: true, get: function () { return devkit_internals_2.toOldFormat; } });
+Object.defineProperty(exports, "transformLegacyOutputs", { enumerable: true, get: function () { return devkit_internals_2.transformLegacyOutputs; } });
+Object.defineProperty(exports, "unparse", { enumerable: true, get: function () { return devkit_internals_2.unparse; } });
+Object.defineProperty(exports, "validateOutputs", { enumerable: true, get: function () { return devkit_internals_2.validateOutputs; } });
+Object.defineProperty(exports, "workspaceDataDirectory", { enumerable: true, get: function () { return devkit_internals_2.workspaceDataDirectory; } });
+Object.defineProperty(exports, "workspaceRootInner", { enumerable: true, get: function () { return devkit_internals_2.workspaceRootInner; } });

package/dist/ngcli-adapter.d.ts

@@ -1,4 +1,4 @@
 /**
  * @category Ng CLI Adapter
  */
-export { wrapAngularDevkitSchematic, mockSchematicsForTesting, NxScopedHost, } from 'nx/src/adapter/ngcli-adapter';
+export { wrapAngularDevkitSchematic, mockSchematicsForTesting, NxScopedHost, createBuilderContext, } from 'nx/src/adapter/ngcli-adapter';

package/dist/ngcli-adapter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NxScopedHost = exports.mockSchematicsForTesting = exports.wrapAngularDevkitSchematic = void 0;
+exports.createBuilderContext = exports.NxScopedHost = exports.mockSchematicsForTesting = exports.wrapAngularDevkitSchematic = void 0;
 /**
  * @category Ng CLI Adapter
  */
@@ -9,3 +9,4 @@ var ngcli_adapter_1 = require("nx/src/adapter/ngcli-adapter");
 Object.defineProperty(exports, "wrapAngularDevkitSchematic", { enumerable: true, get: function () { return ngcli_adapter_1.wrapAngularDevkitSchematic; } });
 Object.defineProperty(exports, "mockSchematicsForTesting", { enumerable: true, get: function () { return ngcli_adapter_1.mockSchematicsForTesting; } });
 Object.defineProperty(exports, "NxScopedHost", { enumerable: true, get: function () { return ngcli_adapter_1.NxScopedHost; } });
+Object.defineProperty(exports, "createBuilderContext", { enumerable: true, get: function () { return ngcli_adapter_1.createBuilderContext; } });

package/dist/src/generators/format-files.d.ts

@@ -1,6 +1,8 @@
 import { Tree } from 'nx/src/devkit-exports';
 /**
- * Formats all the created or updated files using Prettier
+ * Formats the created or updated files using Prettier, skipping `node_modules`,
+ * `.git`, the nx and yarn caches, and anything the workspace's root
+ * `.gitignore` or `.prettierignore` covers
  * @param tree - the file system tree
  * @param options - options for the formatFiles function
  *

package/dist/src/generators/format-files.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 const devkit_exports_1 = require("nx/src/devkit-exports");
 const devkit_internals_1 = require("nx/src/devkit-internals");
 const path = tslib_1.__importStar(require("path"));
+const nx_ignore_internals_1 = require("../utils/nx-ignore-internals");
 // Prettier v3 (ESM) exposes its API as named exports; v2 (CJS) exposes it under
 // `.default` when loaded via `import()`. Return whichever carries the API, or
 // null if prettier isn't installed.
@@ -18,7 +19,9 @@ async function importPrettier() {
     }
 }
 /**
- * Formats all the created or updated files using Prettier
+ * Formats the created or updated files using Prettier, skipping `node_modules`,
+ * `.git`, the nx and yarn caches, and anything the workspace's root
+ * `.gitignore` or `.prettierignore` covers
  * @param tree - the file system tree
  * @param options - options for the formatFiles function
  *
@@ -56,7 +59,16 @@ async function formatFiles(tree, options = {}) {
     catch { }
     if (!prettier)
         return;
-    const files = new Set(tree.listChanges().filter((file) => file.type !== 'DELETE'));
+    // `getFileInfo` below looks like it filters ignored files but only covers its
+    // own built-in `node_modules` skip: with no `ignorePath` it never reads the
+    // workspace's ignore files, so `ignored` is false for everything else
+    // (measured).
+    //
+    // The optional call is the older-nx path - see `NOTHING_IGNORED`.
+    const { isIgnoredFile } = (0, devkit_internals_1.createPrettierIgnoreChecker)?.(tree) ?? nx_ignore_internals_1.NOTHING_IGNORED;
+    const files = new Set(tree
+        .listChanges()
+        .filter((file) => file.type !== 'DELETE' && !isIgnoredFile(file.path)));
     const changedPrettierInTree = getChangedPrettierConfigInTree(tree);
     await Promise.all(Array.from(files).map(async (file) => {
         try {

package/dist/src/generators/plugin-migrations/executor-to-plugin-migrator.d.ts

@@ -1,6 +1,5 @@
 import type { ProjectConfiguration } from 'nx/src/config/workspace-json-project-json';
-import { type CreateNodes, type NxJsonConfiguration, type ProjectGraph, type TargetConfiguration, type Tree } from 'nx/src/devkit-exports';
-import { logger as devkitLogger } from 'nx/src/devkit-exports';
+import { type CreateNodes, type NxJsonConfiguration, type ProjectGraph, type TargetConfiguration, type Tree, logger as devkitLogger } from 'nx/src/devkit-exports';
 export type InferredTargetConfiguration = TargetConfiguration & {
     name: string;
 };

package/dist/src/generators/plugin-migrations/executor-to-plugin-migrator.js

@@ -14,7 +14,6 @@ const devkit_internals_1 = require("nx/src/devkit-internals");
 const executor_options_utils_1 = require("../executor-options-utils");
 const target_defaults_utils_1 = require("../target-defaults-utils");
 const plugin_migration_utils_1 = require("./plugin-migration-utils");
-const devkit_exports_2 = require("nx/src/devkit-exports");
 class ExecutorToPluginMigrator {
     constructor(tree, projectGraph, executor, pluginPath, pluginOptionsBuilder, postTargetTransformer, createNodes, createNodesV2, specificProjectToMigrate, filters, logger) {
         _ExecutorToPluginMigrator_instances.add(this);
@@ -45,7 +44,7 @@ class ExecutorToPluginMigrator {
         tslib_1.__classPrivateFieldSet(this, _ExecutorToPluginMigrator_specificProjectToMigrate, specificProjectToMigrate, "f");
         tslib_1.__classPrivateFieldSet(this, _ExecutorToPluginMigrator_skipProjectFilter, filters?.skipProjectFilter ?? ((...args) => false), "f");
         tslib_1.__classPrivateFieldSet(this, _ExecutorToPluginMigrator_skipTargetFilter, filters?.skipTargetFilter ?? ((...args) => false), "f");
-        tslib_1.__classPrivateFieldSet(this, _ExecutorToPluginMigrator_logger, logger ?? devkit_exports_2.logger, "f");
+        tslib_1.__classPrivateFieldSet(this, _ExecutorToPluginMigrator_logger, logger ?? devkit_exports_1.logger, "f");
     }
     async run() {
         await tslib_1.__classPrivateFieldGet(this, _ExecutorToPluginMigrator_instances, "m", _ExecutorToPluginMigrator_init).call(this);

package/dist/src/generators/visit-not-ignored-files.d.ts

@@ -1,5 +1,12 @@
 import type { Tree } from 'nx/src/devkit-exports';
 /**
  * Utility to act on all files in a tree that are not ignored by git.
+ *
+ * Ignore files cascade, so a nested `.gitignore` covers the files under it and a
+ * nested negation overrides the root. They are read from the tree, not disk, so
+ * one a generator wrote in the same run counts.
+ *
+ * `node_modules`, `.git` and the nx and yarn caches are never visited, whatever
+ * the workspace's ignore files say.
  */
 export declare function visitNotIgnoredFiles(tree: Tree, dirPath: string, visitor: (path: string) => void): void;

package/dist/src/generators/visit-not-ignored-files.js

@@ -3,25 +3,50 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.visitNotIgnoredFiles = visitNotIgnoredFiles;
 const devkit_internals_1 = require("nx/src/devkit-internals");
 const path_1 = require("path");
+const nx_ignore_internals_1 = require("../utils/nx-ignore-internals");
 /**
  * Utility to act on all files in a tree that are not ignored by git.
+ *
+ * Ignore files cascade, so a nested `.gitignore` covers the files under it and a
+ * nested negation overrides the root. They are read from the tree, not disk, so
+ * one a generator wrote in the same run counts.
+ *
+ * `node_modules`, `.git` and the nx and yarn caches are never visited, whatever
+ * the workspace's ignore files say.
  */
 function visitNotIgnoredFiles(tree, dirPath = tree.root, visitor) {
-    const ig = (0, devkit_internals_1.getIgnoreObjectForTree)(tree);
-    dirPath = normalizePathRelativeToRoot(dirPath, tree.root);
-    if (dirPath !== '' && ig?.ignores(dirPath)) {
+    (0, nx_ignore_internals_1.assertNxSupportsIgnoreCheckers)();
+    // Built once for the whole traversal.
+    const isIgnored = (0, devkit_internals_1.createGitIgnoreChecker)(tree);
+    const start = normalizePathRelativeToRoot(dirPath, tree.root);
+    // The caller's own directory is the only one nothing has checked - every
+    // deeper one is checked before it is descended into.
+    if (start !== '' && isIgnored.isIgnoredDirectory(start)) {
         return;
     }
+    visitDirectory(tree, start, visitor, isIgnored);
+}
+/**
+ * Callers must have cleared `dirPath` already - both call sites do.
+ *
+ * Not descending into an ignored directory is what makes the answers match git,
+ * not just what makes them fast: git refuses to re-include a file inside an
+ * excluded directory, and `isIgnoredFile` alone does not implement that rule
+ * (see `isIgnoredByChain`). Flattening this into a per-file filter would start
+ * visiting files git ignores.
+ */
+function visitDirectory(tree, dirPath, visitor, isIgnored) {
     for (const child of tree.children(dirPath)) {
-        const fullPath = (0, path_1.join)(dirPath, child);
-        if (ig?.ignores(fullPath)) {
-            continue;
-        }
+        // Joined as POSIX rather than with `path.join`: tree paths are POSIX, and
+        // on Windows a backslash-separated path silently matches nothing.
+        const fullPath = dirPath ? `${dirPath}/${child}` : child;
         if (tree.isFile(fullPath)) {
-            visitor(fullPath);
+            if (!isIgnored.isIgnoredFile(fullPath)) {
+                visitor(fullPath);
+            }
         }
-        else {
-            visitNotIgnoredFiles(tree, fullPath, visitor);
+        else if (!isIgnored.isIgnoredDirectory(fullPath)) {
+            visitDirectory(tree, fullPath, visitor, isIgnored);
         }
     }
 }

package/dist/src/utils/installed-version.d.ts

@@ -1,15 +1,21 @@
-import type { Tree } from 'nx/src/devkit-exports';
+import { type Tree } from 'nx/src/devkit-exports';
 /**
  * Returns the concrete version of a package as resolved by Node module
  * resolution from the workspace. Reads the installed package's own
  * `package.json` — not the workspace's declared range.
  *
  * Use this from executor / runtime contexts where node_modules is present.
- * Generator-time code should use `getDeclaredPackageVersion` instead.
+ * Generator-time code should read from the tree first (the declared range or
+ * `getInstalledPackageVersionFromTree`) and may fall back to this with
+ * `requirePaths` restricted to the workspace root.
+ *
+ * Pass `requirePaths` to resolve from specific directories only (e.g. the
+ * workspace root, excluding the `.nx/installation` fallback); otherwise the
+ * default nx require paths are used.
  *
  * Returns `null` when the package is not resolvable.
  */
-export declare function getInstalledPackageVersion(packageName: string): string | null;
+export declare function getInstalledPackageVersion(packageName: string, requirePaths?: string[]): string | null;
 /**
  * Returns the declared version of a package as read from the workspace's
  * `package.json`, normalized to a plain semver string (range markers
@@ -23,6 +29,13 @@ export declare function getInstalledPackageVersion(packageName: string): string
  * `getInstalledPackageVersion` instead.
  */
 export declare function getDeclaredPackageVersion(tree: Tree, packageName: string, latestKnownVersion?: string): string | null;
+/**
+ * Reads the installed version of a package from the tree's `node_modules`,
+ * so it reflects in-flight tree changes and stays controllable in tests.
+ * Returns `null` when the package is not present in the tree's
+ * `node_modules`.
+ */
+export declare function getInstalledPackageVersionFromTree(tree: Tree, packageName: string): string | null;
 export declare const NON_SEMVER_DIST_TAGS: readonly ['latest', 'next'];
 export type NonSemverDistTag = (typeof NON_SEMVER_DIST_TAGS)[number];
 export declare function isNonSemverDistTag(version: string): version is NonSemverDistTag;

package/dist/src/utils/installed-version.js

@@ -3,9 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NON_SEMVER_DIST_TAGS = void 0;
 exports.getInstalledPackageVersion = getInstalledPackageVersion;
 exports.getDeclaredPackageVersion = getDeclaredPackageVersion;
+exports.getInstalledPackageVersionFromTree = getInstalledPackageVersionFromTree;
 exports.isNonSemverDistTag = isNonSemverDistTag;
 exports.normalizeSemver = normalizeSemver;
 const devkit_internals_1 = require("nx/src/devkit-internals");
+const devkit_exports_1 = require("nx/src/devkit-exports");
 const semver_1 = require("semver");
 const package_json_1 = require("./package-json");
 /**
@@ -14,14 +16,22 @@ const package_json_1 = require("./package-json");
  * `package.json` — not the workspace's declared range.
  *
  * Use this from executor / runtime contexts where node_modules is present.
- * Generator-time code should use `getDeclaredPackageVersion` instead.
+ * Generator-time code should read from the tree first (the declared range or
+ * `getInstalledPackageVersionFromTree`) and may fall back to this with
+ * `requirePaths` restricted to the workspace root.
+ *
+ * Pass `requirePaths` to resolve from specific directories only (e.g. the
+ * workspace root, excluding the `.nx/installation` fallback); otherwise the
+ * default nx require paths are used.
  *
  * Returns `null` when the package is not resolvable.
  */
-function getInstalledPackageVersion(packageName) {
+function getInstalledPackageVersion(packageName, requirePaths) {
     try {
-        const { packageJson } = (0, devkit_internals_1.readModulePackageJson)(packageName);
-        return packageJson.version ?? null;
+        const { packageJson } = requirePaths
+            ? (0, devkit_internals_1.readModulePackageJson)(packageName, requirePaths)
+            : (0, devkit_internals_1.readModulePackageJson)(packageName);
+        return typeof packageJson.version === 'string' ? packageJson.version : null;
     }
     catch {
         return null;
@@ -48,6 +58,21 @@ function getDeclaredPackageVersion(tree, packageName, latestKnownVersion) {
     }
     return latestKnownVersion ? normalizeSemver(latestKnownVersion) : null;
 }
+/**
+ * Reads the installed version of a package from the tree's `node_modules`,
+ * so it reflects in-flight tree changes and stays controllable in tests.
+ * Returns `null` when the package is not present in the tree's
+ * `node_modules`.
+ */
+function getInstalledPackageVersionFromTree(tree, packageName) {
+    try {
+        const { version } = (0, devkit_exports_1.readJson)(tree, `node_modules/${packageName}/package.json`);
+        return typeof version === 'string' ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
 exports.NON_SEMVER_DIST_TAGS = ['latest', 'next'];
 function isNonSemverDistTag(version) {
     return exports.NON_SEMVER_DIST_TAGS.includes(version);

package/dist/src/utils/invoke-nx-generator.js

@@ -141,9 +141,13 @@ class DevkitTreeFromAngularDevkitTree {
         return (0, path_1.relative)(this.root, (0, path_1.join)(this.root, path));
     }
     read(filePath, encoding) {
-        return encoding
-            ? this.tree.read(filePath).toString(encoding)
-            : this.tree.read(filePath);
+        // The schematics tree already returns null for a missing file, so honouring
+        // the `Tree` contract is a matter of not dereferencing it.
+        const content = this.tree.read(filePath);
+        if (content === null) {
+            return null;
+        }
+        return encoding ? content.toString(encoding) : content;
     }
     rename(from, to) {
         this.tree.rename(from, to);

package/dist/src/utils/nx-ignore-internals.d.ts

@@ -0,0 +1,23 @@
+import type { TreeIgnoreChecker } from 'nx/src/devkit-internals';
+/**
+ * `@nx/devkit`'s `nx` peer spans a major either side, so an older nx that
+ * predates the ignore checkers can legally be installed alongside it, and a
+ * missing CommonJS named export arrives as `undefined` rather than as a load
+ * error. The two callers want opposite things from that, so they get different
+ * helpers - see `NOTHING_IGNORED` for the other half.
+ *
+ * A tree walk cannot degrade: without a checker nothing would be ignored, and
+ * the walker would descend into `node_modules` and hand a migration every file
+ * in it to rewrite. That is worse than the older nx's own behaviour, which at
+ * least read the root `.gitignore`, so this fails instead - once, by name.
+ */
+export declare function assertNxSupportsIgnoreCheckers(): void;
+/**
+ * The degrade the other way, for formatting.
+ *
+ * Filtering nothing is what devkit did before the checkers existed - with no
+ * `ignorePath`, prettier's own `getFileInfo` never read the workspace's ignore
+ * files either (measured) - so an older nx gets the formatting behaviour it has
+ * always had rather than a generator that refuses to run.
+ */
+export declare const NOTHING_IGNORED: TreeIgnoreChecker;

package/dist/src/utils/nx-ignore-internals.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTHING_IGNORED = void 0;
+exports.assertNxSupportsIgnoreCheckers = assertNxSupportsIgnoreCheckers;
+const devkit_internals_1 = require("nx/src/devkit-internals");
+/**
+ * `@nx/devkit`'s `nx` peer spans a major either side, so an older nx that
+ * predates the ignore checkers can legally be installed alongside it, and a
+ * missing CommonJS named export arrives as `undefined` rather than as a load
+ * error. The two callers want opposite things from that, so they get different
+ * helpers - see `NOTHING_IGNORED` for the other half.
+ *
+ * A tree walk cannot degrade: without a checker nothing would be ignored, and
+ * the walker would descend into `node_modules` and hand a migration every file
+ * in it to rewrite. That is worse than the older nx's own behaviour, which at
+ * least read the root `.gitignore`, so this fails instead - once, by name.
+ */
+function assertNxSupportsIgnoreCheckers() {
+    if (devkit_internals_1.createGitIgnoreChecker) {
+        return;
+    }
+    throw new Error('The installed version of nx does not export the ignore checkers that @nx/devkit needs to decide which files a generator may touch. ' +
+        'This happens when nx and @nx/devkit are on different major versions. Run `nx migrate latest` to bring them into line.');
+}
+/**
+ * The degrade the other way, for formatting.
+ *
+ * Filtering nothing is what devkit did before the checkers existed - with no
+ * `ignorePath`, prettier's own `getFileInfo` never read the workspace's ignore
+ * files either (measured) - so an older nx gets the formatting behaviour it has
+ * always had rather than a generator that refuses to run.
+ */
+exports.NOTHING_IGNORED = {
+    isIgnoredFile: () => false,
+    isIgnoredDirectory: () => false,
+};

package/dist/src/utils/version-floor.d.ts

@@ -1,4 +1,4 @@
-import type { Tree } from 'nx/src/devkit-exports';
+import { type Tree } from 'nx/src/devkit-exports';
 /**
  * Throws a standardized error when a package is installed at a version below
  * a plugin's supported floor.
@@ -15,9 +15,21 @@ export declare function throwForUnsupportedVersion(packageName: string, installe
 /**
  * Asserts that a package detected in the workspace is at or above the
  * plugin's supported floor. No-op when the package is not detected
- * (fresh-install path) or when declared as `latest`/`next`. Throws via
- * `throwForUnsupportedVersion` (with the original declared range for
- * clarity) when below floor.
+ * (fresh-install path) or when declared as `latest`/`next`.
+ *
+ * Resolution order:
+ * - When the installed version satisfies the declared range, the installed
+ *   version decides. This resolves open ranges (e.g. `>=4.8.4 <6.1.0`) to
+ *   what is actually installed.
+ * - An exact declared version is compared to the floor directly.
+ * - A declared range that cannot reach the floor throws as unsupported. A
+ *   range that straddles the floor cannot be judged without an installed
+ *   version (the lockfile may pin either side), so when none resolves it
+ *   throws asking to install dependencies first.
+ *
+ * Prereleases count as their release version throughout (e.g. `6.0.0-rc.1`
+ * as `6.0.0`), for installed versions, exact declared versions, and range
+ * endpoints alike.
  *
  * Use from generator entry points to fail fast on unsupported workspaces
  * before writing any incompatible config.

package/dist/src/utils/version-floor.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.throwForUnsupportedVersion = throwForUnsupportedVersion;
 exports.assertSupportedPackageVersion = assertSupportedPackageVersion;
 exports.assertSupportedInstalledPackageVersion = assertSupportedInstalledPackageVersion;
+const devkit_exports_1 = require("nx/src/devkit-exports");
 const semver_1 = require("semver");
 const installed_version_1 = require("./installed-version");
 const package_json_1 = require("./package-json");
@@ -27,9 +28,21 @@ function throwForUnsupportedVersion(packageName, installedVersion, floor) {
 /**
  * Asserts that a package detected in the workspace is at or above the
  * plugin's supported floor. No-op when the package is not detected
- * (fresh-install path) or when declared as `latest`/`next`. Throws via
- * `throwForUnsupportedVersion` (with the original declared range for
- * clarity) when below floor.
+ * (fresh-install path) or when declared as `latest`/`next`.
+ *
+ * Resolution order:
+ * - When the installed version satisfies the declared range, the installed
+ *   version decides. This resolves open ranges (e.g. `>=4.8.4 <6.1.0`) to
+ *   what is actually installed.
+ * - An exact declared version is compared to the floor directly.
+ * - A declared range that cannot reach the floor throws as unsupported. A
+ *   range that straddles the floor cannot be judged without an installed
+ *   version (the lockfile may pin either side), so when none resolves it
+ *   throws asking to install dependencies first.
+ *
+ * Prereleases count as their release version throughout (e.g. `6.0.0-rc.1`
+ * as `6.0.0`), for installed versions, exact declared versions, and range
+ * endpoints alike.
  *
  * Use from generator entry points to fail fast on unsupported workspaces
  * before writing any incompatible config.
@@ -39,11 +52,64 @@ function assertSupportedPackageVersion(tree, packageName, minSupportedVersion) {
     if (!declared || (0, installed_version_1.isNonSemverDistTag)(declared)) {
         return;
     }
-    const cleaned = (0, installed_version_1.normalizeSemver)(declared);
-    if (cleaned && (0, semver_1.lt)(cleaned, minSupportedVersion)) {
+    const installed = (0, installed_version_1.getInstalledPackageVersionFromTree)(tree, packageName) ??
+        getInstalledPackageVersionFromProcess(tree, packageName);
+    if (installed) {
+        // An installed prerelease can match the declared range in either form:
+        // raw (a same-tuple prerelease comparator) or as its release version.
+        const release = (0, semver_1.coerce)(installed)?.version ?? installed;
+        if ((0, semver_1.satisfies)(installed, declared) || (0, semver_1.satisfies)(release, declared)) {
+            if ((0, semver_1.lt)(release, minSupportedVersion)) {
+                throwForUnsupportedVersion(packageName, installed, minSupportedVersion);
+            }
+            return;
+        }
+    }
+    const cleaned = (0, semver_1.clean)(declared);
+    if (cleaned) {
+        // Strip any prerelease so it counts as its release version.
+        const release = (0, semver_1.coerce)(cleaned)?.version ?? cleaned;
+        if ((0, semver_1.lt)(release, minSupportedVersion)) {
+            throwForUnsupportedVersion(packageName, declared, minSupportedVersion);
+        }
+        return;
+    }
+    if ((0, semver_1.validRange)(declared)) {
+        // The `-0` floor comparator admits prereleases of the floor version, so
+        // a range reaching the floor only through its prereleases still counts.
+        if (!(0, semver_1.intersects)(declared, `>=${minSupportedVersion}-0`)) {
+            throwForUnsupportedVersion(packageName, declared, minSupportedVersion);
+        }
+        const min = (0, semver_1.minVersion)(declared);
+        const rangeMinimum = min ? `${min.major}.${min.minor}.${min.patch}` : null;
+        if (rangeMinimum && (0, semver_1.lt)(rangeMinimum, minSupportedVersion)) {
+            throw new Error(`Unable to determine the installed version of \`${packageName}\`.\n\n` +
+                `  Declared: ${declared}\n` +
+                `  Supported: >= ${minSupportedVersion}\n\n` +
+                `The declared range allows versions below the supported minimum. ` +
+                `Install the workspace dependencies so the installed version can be verified, then try again.`);
+        }
+        return;
+    }
+    const coerced = (0, semver_1.coerce)(declared)?.version;
+    if (coerced && (0, semver_1.lt)(coerced, minSupportedVersion)) {
         throwForUnsupportedVersion(packageName, declared, minSupportedVersion);
     }
 }
+/**
+ * Module-resolution fallback for installs without a `node_modules` layout
+ * (e.g. Yarn PnP). Only valid when the tree is the running process's
+ * workspace; unit trees (e.g. rooted at `/virtual`) must not resolve
+ * packages from the process environment. Resolves from the workspace root
+ * only, so a copy hoisted into `.nx/installation` cannot shadow the
+ * workspace's own install.
+ */
+function getInstalledPackageVersionFromProcess(tree, packageName) {
+    if (tree.root !== devkit_exports_1.workspaceRoot) {
+        return null;
+    }
+    return (0, installed_version_1.getInstalledPackageVersion)(packageName, [tree.root]);
+}
 /**
  * Asserts that a package installed in the workspace is at or above the
  * plugin's supported floor. No-op when the package is not resolvable from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx/devkit",
-  "version": "23.1.1",
+  "version": "23.1.2",
   "private": false,
   "type": "commonjs",
   "files": [
@@ -40,6 +40,15 @@
       ],
       "internal-testing-utils": [
         "dist/internal-testing-utils.d.ts"
+      ],
+      "internal-testing-utils/mock-project-graph": [
+        "dist/internal-testing-utils/mock-project-graph.d.ts"
+      ],
+      "internal-testing-utils/mock-fs": [
+        "dist/internal-testing-utils/mock-fs.d.ts"
+      ],
+      "internal-testing-utils/mock-prettier": [
+        "dist/internal-testing-utils/mock-prettier.d.ts"
       ]
     }
   },
@@ -59,7 +68,7 @@
   },
   "devDependencies": {
     "jest": "30.3.0",
-    "nx": "23.1.1"
+    "nx": "23.1.2"
   },
   "peerDependencies": {
     "nx": ">= 22 <= 24 || ^23.0.0-0"
@@ -89,6 +98,21 @@
       "types": "./dist/internal-testing-utils.d.ts",
       "default": "./dist/internal-testing-utils.js"
     },
+    "./internal-testing-utils/mock-project-graph": {
+      "@nx/nx-source": "./internal-testing-utils/mock-project-graph.ts",
+      "types": "./dist/internal-testing-utils/mock-project-graph.d.ts",
+      "default": "./dist/internal-testing-utils/mock-project-graph.js"
+    },
+    "./internal-testing-utils/mock-fs": {
+      "@nx/nx-source": "./internal-testing-utils/mock-fs.ts",
+      "types": "./dist/internal-testing-utils/mock-fs.d.ts",
+      "default": "./dist/internal-testing-utils/mock-fs.js"
+    },
+    "./internal-testing-utils/mock-prettier": {
+      "@nx/nx-source": "./internal-testing-utils/mock-prettier.ts",
+      "types": "./dist/internal-testing-utils/mock-prettier.d.ts",
+      "default": "./dist/internal-testing-utils/mock-prettier.js"
+    },
     "./ngcli-adapter": {
       "@nx/nx-source": "./ngcli-adapter.ts",
       "types": "./dist/ngcli-adapter.d.ts",