@nx/devkit 23.1.1 → 23.1.3

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/config-utils.d.ts

@@ -1,5 +1,8 @@
 export declare let dynamicImport: Function;
 export declare function loadConfigFile<T extends object = any>(configFilePath: string, tsconfigFileNames?: string[]): Promise<T>;
+export declare function isTranspilerRecoverableError(err: unknown, path: string): boolean;
+export declare function clearConfigFromRequireCache(rootId: string, cache?: NodeJS.Dict<NodeModule>): void;
+export declare function unwrapCjsInterop(path: string, module: unknown, cache?: NodeJS.Dict<NodeModule>): unknown;
 export declare function getRootTsConfigPath(): string | null;
 export declare function getRootTsConfigFileName(): string | null;
 export declare function clearRequireCache(): void;

package/dist/src/utils/config-utils.js

@@ -2,11 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dynamicImport = void 0;
 exports.loadConfigFile = loadConfigFile;
+exports.isTranspilerRecoverableError = isTranspilerRecoverableError;
+exports.clearConfigFromRequireCache = clearConfigFromRequireCache;
+exports.unwrapCjsInterop = unwrapCjsInterop;
 exports.getRootTsConfigPath = getRootTsConfigPath;
 exports.getRootTsConfigFileName = getRootTsConfigFileName;
 exports.clearRequireCache = clearRequireCache;
 const fs_1 = require("fs");
 const node_url_1 = require("node:url");
+const node_util_1 = require("node:util");
 const devkit_exports_1 = require("nx/src/devkit-exports");
 const devkit_internals_1 = require("nx/src/devkit-internals");
 const path_1 = require("path");
@@ -27,8 +31,22 @@ function isTypeScriptFile(extension) {
 }
 async function loadTypeScriptModule(path, extension, tsconfigFileNames) {
     const tsConfigPath = getTypeScriptConfigPath(path, tsconfigFileNames);
+    const modulePath = resolveModulePath(path);
     if (!tsConfigPath) {
-        return await loadModuleByExtension(path, extension);
+        // The tsconfig-less path needs the same ESM-registry routing as below:
+        // require() of a sync-ESM .ts serves the stale registry entry on reloads.
+        if (esmRegistryPaths.has(modulePath)) {
+            // Clear first so an ESM-to-CJS rewrite re-evaluates instead of the
+            // import() serving the cached require.cache entry.
+            clearConfigFromRequireCache(modulePath);
+            return unwrapCjsInterop(path, await loadESM(path));
+        }
+        clearConfigFromRequireCache(modulePath);
+        const result = await loadModuleByExtension(path, extension);
+        if (node_util_1.types.isModuleNamespaceObject(result)) {
+            esmRegistryPaths.add(modulePath);
+        }
+        return result;
     }
     // loadTsFile was added in nx@23. @nx/devkit's peer range supports older
     // nx majors, so fall back to the legacy registerTsProject + require path
@@ -42,57 +60,202 @@ async function loadTypeScriptModule(path, extension, tsconfigFileNames) {
             cleanup();
         }
     }
+    // require.cache busting cannot invalidate a module the ESM registry
+    // holds; reloads of known-ESM paths need a cache-busted import().
+    if (esmRegistryPaths.has(modulePath)) {
+        return await loadTsFileViaImport(path, tsConfigPath);
+    }
+    // A CJS-shaped .ts stays in require.cache and may have changed on disk
+    // since; clear it so the reload re-reads the file.
+    clearConfigFromRequireCache(modulePath);
     // Both .ts and .mts go through loadTsFile first. Node 22.12+ supports
     // require() of synchronous ESM by default, and loadTsFile's lazy fallback
     // covers swc/ts-node + tsconfig-paths registration when needed (swc-node
     // hooks .cts/.mts/.ts via Module._extensions). Async-only ESM modules
     // (top-level await) throw ERR_REQUIRE_ASYNC_MODULE and fall through to
-    // dynamic import(). ERR_REQUIRE_ESM is the legacy code for the same case
-    // - kept for older Node lines.
+    // dynamic import(). ERR_REQUIRE_ESM is the legacy code for the same case,
+    // kept for older Node lines.
     try {
-        return (0, devkit_internals_1.loadTsFile)(path, tsConfigPath);
+        const result = (0, devkit_internals_1.loadTsFile)(path, tsConfigPath);
+        if (node_util_1.types.isModuleNamespaceObject(result)) {
+            esmRegistryPaths.add(modulePath);
+        }
+        return result;
     }
     catch (e) {
         if (e?.code !== 'ERR_REQUIRE_ESM' &&
             e?.code !== 'ERR_REQUIRE_ASYNC_MODULE') {
             throw e;
         }
-        // The module must be loaded via dynamic import(). Register
-        // tsconfig-paths first so workspace alias imports resolve, then try a
-        // native dynamic import. Node 22.18+ LTS strips TS types on the ESM
-        // path natively, so pure-ESM TLA configs load without any swc/ts-node
-        // ESM loader. Only escalate to forceRegisterEsmLoader (which throws
-        // when neither @swc-node/register nor ts-node is installed) if the
-        // native attempt hits unsupported TS syntax.
+        return await loadTsFileViaImport(path, tsConfigPath);
+    }
+}
+// Resolved paths of configs that require() loaded as synchronous ESM;
+// reloads of these route through a cache-busted import(). On globalThis so the
+// state survives clearRequireCache evicting this module itself (a
+// workspace-linked devkit resolves outside node_modules).
+const esmRegistryPaths = (globalThis[Symbol.for('@nx/devkit:esmRegistryPaths')] ??= new Set());
+// Error codes from the load machinery (resolution, type stripping) that
+// warrant registering swc/ts-node + tsconfig-paths and importing again.
+// Unlisted errors propagate unchanged so a failing config is not
+// re-evaluated. A not-found error can also come from the config's own
+// dynamic import()/require() of a missing module, in which case the retry
+// re-runs its top-level side effects; accepted so that static alias and
+// extensionless imports (which fail at link time, before any user code
+// runs) stay recoverable.
+const ESM_LOAD_FALLBACK_ERROR_CODES = new Set([
+    'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX',
+    'ERR_MODULE_NOT_FOUND',
+    'MODULE_NOT_FOUND',
+    'ERR_UNKNOWN_FILE_EXTENSION',
+]);
+// Code-less errors that loadTsFile recovers on first load via the swc/
+// ts-node fallback: a CJS-only global (__dirname, __filename, require) or a
+// type-only named import evaluated on the native ESM path. Reloads must
+// recover them too or an edit that introduces one turns into a hard graph
+// failure. Prefer the host nx's classifiers so the gate matches what its
+// loadTsFile recovers; nx versions that support the error classes without
+// re-exporting the classifiers fall back to local replicas of them.
+function isTranspilerRecoverableError(err, path) {
+    return ((typeof devkit_internals_1.isRequireInEsmScopeError === 'function'
+        ? (0, devkit_internals_1.isRequireInEsmScopeError)(err, path)
+        : isRequireInEsmScopeErrorReplica(err, path)) ||
+        (typeof devkit_internals_1.isTsEsmNamedExportLinkageError === 'function'
+            ? (0, devkit_internals_1.isTsEsmNamedExportLinkageError)(err, path)
+            : isTsEsmNamedExportLinkageErrorReplica(err, path)));
+}
+function isRequireInEsmScopeErrorReplica(err, filePath) {
+    if (!(err instanceof ReferenceError)) {
+        return false;
+    }
+    if (!(filePath.endsWith('.ts') || filePath.endsWith('.mts'))) {
+        return false;
+    }
+    return /(require|__dirname|__filename) is not defined/.test(err.message);
+}
+function isTsEsmNamedExportLinkageErrorReplica(err, filePath) {
+    if (!(err instanceof SyntaxError)) {
+        return false;
+    }
+    return ((filePath.endsWith('.ts') || filePath.endsWith('.mts')) &&
+        err.message.includes('does not provide an export named'));
+}
+// Invalidates a config module and its local CommonJS dependency subtree,
+// leaving unrelated cached modules untouched (a broad clear re-evaluates
+// them and breaks singleton identity). Walks each module's recorded
+// children AND the cache-current instance for the same id, since another
+// config may retain an older instance of a shared dependency. Detaches the
+// root from its requiring parent so repeated reloads don't accumulate
+// Module objects in the parent's children array.
+function clearConfigFromRequireCache(rootId, cache = require.cache) {
+    const root = cache[rootId];
+    if (!root) {
+        return;
+    }
+    const visited = new Set();
+    const idsToDelete = new Set();
+    const queue = [root];
+    while (queue.length) {
+        const mod = queue.pop();
+        if (!mod || visited.has(mod)) {
+            continue;
+        }
+        visited.add(mod);
+        if (packageInstallationDirectories.some((dir) => mod.id.includes(dir))) {
+            continue;
+        }
+        idsToDelete.add(mod.id);
+        const current = cache[mod.id];
+        if (current && current !== mod) {
+            queue.push(current);
+        }
+        for (const child of mod.children) {
+            queue.push(child);
+        }
+    }
+    for (const id of idsToDelete) {
+        delete cache[id];
+    }
+    if (root.parent) {
+        root.parent.children = root.parent.children.filter((child) => child.id !== rootId);
+    }
+}
+// Canonical key for require.cache checks and esmRegistryPaths: a symlinked
+// config's caller path differs from require's resolved filename.
+function resolveModulePath(path) {
+    try {
+        return require.resolve(path);
+    }
+    catch {
+        return path;
+    }
+}
+async function loadTsFileViaImport(path, tsConfigPath) {
+    // Clear any prior require.cache entry so an ESM-to-CJS rewrite (or a
+    // loader-classified CJS load) re-evaluates instead of serving the cached
+    // copy.
+    clearConfigFromRequireCache(resolveModulePath(path));
+    // Try a bare native import first: Node 22.18+ strips TS types on the ESM
+    // path natively, and registerTsProject must NOT run up front. A
+    // registered swc/ts-node ESM loader intercepts every subsequent import
+    // in the process (it cannot be unregistered) and may classify a .ts
+    // config as CommonJS, defeating loadESM's cache-busting query on
+    // reloads. Register only when the native attempt fails.
+    try {
+        return unwrapCjsInterop(path, await loadESM(path));
+    }
+    catch (esmErr) {
+        if (!ESM_LOAD_FALLBACK_ERROR_CODES.has(esmErr?.code) &&
+            !isTranspilerRecoverableError(esmErr, path)) {
+            throw esmErr;
+        }
         const cleanup = (0, devkit_internals_1.registerTsProject)(tsConfigPath);
         try {
-            return await loadESM(path);
+            return unwrapCjsInterop(path, await loadESM(path));
         }
-        catch (esmErr) {
-            if (esmErr?.code !== 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX' ||
+        catch (retryErr) {
+            if (isTranspilerRecoverableError(retryErr, path)) {
+                // A registered swc ESM loader compiles the retry to CJS, but
+                // ts-node/esm keeps the file ESM, so CJS globals stay undefined on
+                // the import path. Route through the CJS transpiler hook
+                // registerTsProject installed; it reads fresh from disk. A
+                // namespace result means no hook intercepted and require() hit the
+                // stale ESM registry, so surface the error instead.
+                const required = require(path);
+                if (!node_util_1.types.isModuleNamespaceObject(required)) {
+                    return required;
+                }
+                throw retryErr;
+            }
+            if (retryErr?.code !== 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX' ||
                 typeof devkit_internals_1.forceRegisterEsmLoader !== 'function') {
-                throw esmErr;
+                throw retryErr;
             }
-            // Module.register is global and one-shot per process. After this
-            // runs, every subsequent ESM import in the process is routed
-            // through the registered loader, forfeiting Node's native TS
-            // stripping for the dynamic-import path. If neither swc-node nor
-            // ts-node is installed, forceRegisterEsmLoader throws - surface the
-            // original ESM error in that case so the user sees the real
-            // problem, not a misleading "loader missing" message.
+            // Loader registration cannot be undone. Preserve the import error
+            // if registration itself fails.
             try {
                 (0, devkit_internals_1.forceRegisterEsmLoader)();
             }
             catch {
-                throw esmErr;
+                throw retryErr;
             }
-            return await loadESM(path);
+            return unwrapCjsInterop(path, await loadESM(path));
         }
         finally {
             cleanup();
         }
     }
 }
+// Some loaders emit CJS for a dynamic import, wrapping module.exports in
+// namespace.default (the __esModule marker is optional), so cache identity is
+// the discriminator: a require(esm) entry holds the namespace itself, and the
+// entry check stops a default-less namespace from matching undefined.
+function unwrapCjsInterop(path, module, cache = require.cache) {
+    const entry = cache[resolveModulePath(path)];
+    const cjsExports = module
+        ?.default;
+    return entry && entry.exports === cjsExports ? cjsExports : module;
+}
 function getTypeScriptConfigPath(path, tsconfigFileNames) {
     const siblingFiles = (0, fs_1.readdirSync)((0, path_1.dirname)(path));
     const tsConfigFileName = (tsconfigFileNames ?? ['tsconfig.json']).find((name) => siblingFiles.includes(name));
@@ -165,7 +328,14 @@ async function loadCommonJS(path) {
     }
     return require(path);
 }
+// Global monotonic counter (not Date.now()) so two reloads never share a
+// cache-busting URL, across same-millisecond loads, module reloads, and
+// devkit copies.
+const esmLoadState = (globalThis[Symbol.for('@nx/devkit:esmLoadState')] ??= { count: 0 });
 async function loadESM(path) {
-    const pathAsFileUrl = (0, node_url_1.pathToFileURL)(path).pathname;
-    return await (0, exports.dynamicImport)(`${pathAsFileUrl}?t=${Date.now()}`);
+    // Keep the full file URL (.pathname would drop a UNC authority); the
+    // unique query gives each reload a fresh ESM registry key.
+    const fileUrl = (0, node_url_1.pathToFileURL)(path);
+    fileUrl.searchParams.set('t', (esmLoadState.count++).toString());
+    return await (0, exports.dynamicImport)(fileUrl.href);
 }

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.3",
   "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.3"
   },
   "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",