nx 23.2.0-beta.4 → 23.2.0-beta.6

package/dist/src/devkit-internals.d.ts

@@ -1,7 +1,21 @@
 /**
- * Note to developers: STOP! These exports are available via requireNx in @nx/devkit.
+ * Note to developers: STOP! These are nx internals, not part of the public
+ * @nx/devkit API.
  *
- * These may not be available in certain version of Nx, so be sure to check them first.
+ * This barrel is NOT under @nx/devkit's version-tolerance contract. That contract
+ * (nx at the current major +/- 1, per devkit's peerDependencies) covers the public
+ * @nx/devkit API only. Two classes of consumer read this file, and the rules
+ * differ:
+ *
+ *   1. packages/devkit/src/ — devkit's own implementation. It ships to external
+ *      plugins, so it *does* run under the +/- 1 tolerance (@nx/devkit@23 may be
+ *      installed against nx@22) and must still guard: check at runtime, or only
+ *      use symbols that have existed since the oldest supported nx major.
+ *   2. First-party plugins in this repo, via @nx/devkit/internal. They release in
+ *      lockstep with nx, so they require an exactly matching nx version and need
+ *      no guarding.
+ *
+ * See packages/devkit/CLAUDE.md.
  */
 export { createTempNpmDirectory } from './utils/package-manager';
 export { getExecutorInformation, parseExecutor, } from './command-line/run/executor-utils';
@@ -13,7 +27,7 @@ export { readProjectConfigurationsFromRootMap } from './project-graph/utils/proj
 export { findMatchingConfigFiles } from './project-graph/utils/project-configuration-utils';
 export { findMatchingProjects } from './utils/find-matching-projects';
 export { readTargetDefaultsForTarget } from './project-graph/utils/project-configuration/target-defaults';
-export { getIgnoreObjectForTree } from './utils/ignore';
+export { createGitIgnoreChecker, createPrettierIgnoreChecker, type TreeIgnoreChecker, } from './utils/ignore';
 export { splitTarget } from './utils/split-target';
 export { combineOptionsForExecutor } from './utils/params';
 export { sortObjectByKeys } from './utils/object-sort';
@@ -41,3 +55,78 @@ export { resolvePrompt, PromptResolutionError, } from './command-line/migrate/pr
 export { checkFilesAreInputs, checkFilesAreOutputs, } from './hasher/check-task-files';
 export { getCatalogManager, getCatalogDependenciesFromPackageJson, } from './utils/catalog';
 export { acknowledgeBuildScripts } from './utils/acknowledge-build-scripts';
+export { default as runCommandsExecutor } from './executors/run-commands/run-commands.impl';
+export type { TaskResult } from './config/misc-interfaces';
+export { toNewFormat, toOldFormat } from './adapter/angular-json';
+export { setupAiAgentsGenerator } from './ai/set-up-ai-agents/set-up-ai-agents';
+export type { Agent } from './ai/utils';
+export type { GeneratorInformation } from './command-line/generate/generator-utils';
+export { getGeneratorInformation } from './command-line/generate/generator-utils';
+export type { FinalConfigForProject } from './command-line/release/utils/release-graph';
+export { BatchFunctionRunner } from './command-line/watch/watch';
+export type { BatchExecutorTaskResult } from './config/misc-interfaces';
+export type { NxReleaseVersionConfiguration } from './config/nx-json';
+export type { FileDataDependency } from './config/project-graph';
+export { fileDataDepTarget, fileDataDepType, isProjectGraphExternalNode, isProjectGraphProjectNode, } from './config/project-graph';
+export type { InputDefinition } from './config/workspace-json-project-json';
+export type { ChangedFile, UnregisterCallback } from './daemon/client/client';
+export { daemonClient } from './daemon/client/client';
+export type { RunCommandsOptions } from './executors/run-commands/run-commands.impl';
+export { LARGE_BUFFER } from './executors/run-commands/run-commands.impl';
+export { FsTree } from './generators/tree';
+export { getRelativeProjectJsonSchemaPath } from './generators/utils/project-configuration';
+export { hashFile } from './hasher/file-hasher';
+export { filterUsingGlobPatterns, getTargetInputs } from './hasher/task-hasher';
+export type { JsonInput } from './native';
+export { killProcessTreeGraceful } from './native';
+export { connectToNxCloud } from './nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud';
+export type { NxCloudOnBoardingStatus } from './nx-cloud/models/onboarding-status';
+export { createNxCloudOnboardingURLForWelcomeApp, getNxCloudAppOnBoardingUrl, } from './nx-cloud/utilities/onboarding';
+export { createNxCloudOnboardingURL } from './nx-cloud/utilities/url-shorten';
+export { createLockFile, getLockFileName, } from './plugins/js/lock-file/lock-file';
+export { createPackageJson, findProjectsNpmDependencies, } from './plugins/js/package-json/create-package-json';
+export { TargetProjectLocator, isBuiltinModuleImport, } from './plugins/js/project-graph/build-dependencies/target-project-locator';
+export { getWorkspacePackagesFromGraph } from './plugins/js/utils/get-workspace-packages-from-graph';
+export { registerTsConfigPaths } from './plugins/js/utils/register';
+export { getGlobPatternsFromPackageManagerWorkspaces } from './plugins/package-json';
+export type { Change, FileChange } from './project-graph/file-utils';
+export { DeletedFileChange, LockFileChange, TEN_MEGABYTES, WholeFileChange, calculateFileChanges, defaultFileRead, isDeletedFileChange, isLockFileChange, isWholeFileChange, readPackageJson, } from './project-graph/file-utils';
+export type { FileMapCache } from './project-graph/nx-deps-cache';
+export { readFileMapCache } from './project-graph/nx-deps-cache';
+export { isNpmProject } from './project-graph/operators';
+export { buildProjectGraphAndSourceMapsWithoutDaemon, createProjectGraphAndSourceMapsAsync, handleProjectGraphError, preventRecursionInGraphConstruction, readCachedProjectConfiguration, } from './project-graph/project-graph';
+export type { ProjectRootMappings } from './project-graph/utils/find-project-for-path';
+export type { BatchResults } from './tasks-runner/batch/batch-messages';
+export type { CachedResult, TaskWithCachedResult } from './tasks-runner/cache';
+export { Cache } from './tasks-runner/cache';
+export { RemoteCacheV2 } from './tasks-runner/default-tasks-runner';
+export type { LifeCycle, TaskMetadata } from './tasks-runner/life-cycle';
+export { CompositeLifeCycle } from './tasks-runner/life-cycle';
+export { createRunManyDynamicOutputRenderer } from './tasks-runner/life-cycles/dynamic-run-many-terminal-output-life-cycle';
+export type { TaskStatus, TasksRunner } from './tasks-runner/tasks-runner';
+export type { DependsOnEntryLocation, NormalizedTargetDependencyConfig, } from './tasks-runner/utils';
+export { calculateReverseDeps, createTaskId, expandDependencyConfigSyntaxSugar, expandInitiatingTasksThroughNoop, expandWildcardTargetConfiguration, getCliPath, getCustomHasher, getDependencyConfigs, getExecutorForTask, getExecutorNameForTask, getOutputs, getPrintableCommandArgsForTask, getSerializedArgsForTask, getTargetConfigurationForTask, getUnparsedOverrideArgs, isCacheableTask, normalizeDependencyConfigDefinition, normalizeDependencyConfigProjects, normalizeTargetDependencyWithStringProjects, readProjectAndTargetFromTargetString, removeTasksFromTaskGraph, shouldStreamOutput, transformLegacyOutputs, unparse, validateOutputs, } from './tasks-runner/utils';
+export { getLastValueFromAsyncIterableIterator } from './utils/async-iterator';
+export { workspaceDataDirectory } from './utils/cache-directory';
+export { runNxSync } from './utils/child-process';
+export { codeFrameColumns } from './utils/code-frames';
+export { deduceDefaultBase } from './utils/default-base';
+export { createDirectory, directoryExists, fileExists, isRelativePath, readFileIfExisting, } from './utils/fileutils';
+export { getLatestCommitSha } from './utils/git-utils';
+export { combineGlobPatterns } from './utils/globs';
+export { getNxRequirePaths } from './utils/installation-directory';
+export { NX_PREFIX } from './utils/logger';
+export type { CLIErrorMessageConfig, CLINoteMessageConfig, CLISuccessMessageConfig, CLIWarnMessageConfig, } from './utils/output';
+export { orange } from './utils/output';
+export { getNxCloudUrl, isNxCloudUsed } from './utils/nx-cloud-utils';
+export type { PackageJson, PackageJsonDependencySection, } from './utils/package-json';
+export { readNxMigrateConfig } from './utils/package-json';
+export type { PackageManagerCommands } from './utils/package-manager';
+export { deriveGroupNameFromTarget } from './utils/plugins/atomizer-utils';
+export { findInstalledPlugins } from './utils/plugins/installed-plugins';
+export { findAllProjectNodeDependencies, getSourceDirOfDependentProjects, } from './utils/project-graph-utils';
+export type { SyncGeneratorResult } from './utils/sync-generators';
+export { SyncError } from './utils/sync-generators';
+export { nxVersion } from './utils/versions';
+export { getFilesInDirectoryUsingContext, globWithWorkspaceContext, resetWorkspaceContext, setupWorkspaceContext, } from './utils/workspace-context';
+export { setWorkspaceRoot, workspaceRootInner } from './utils/workspace-root';

package/dist/src/devkit-internals.js

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

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

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

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

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

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

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

package/dist/src/native/index.d.ts

@@ -416,6 +416,16 @@ export declare function getEventDimensions(): EventDimensions
  */
 export declare function getFilesForOutputsBatch(directory: string, entriesBatch: Array<Array<string>>): Array<Array<string>>
 
+/**
+ * The same list, for JavaScript callers that walk a tree rather than the
+ * filesystem - `visitNotIgnoredFiles` - so both sides apply one baseline
+ * instead of maintaining a second copy that drifts.
+ *
+ * The patterns are gitignore-shaped, so they read the same to the `ignore`
+ * crate here and the `ignore` npm package there.
+ */
+export declare function getHardcodedIgnorePatterns(): Array<string>
+
 /**
  * If `workspace_root` is inside a git worktree, returns the main repo root.
  * Returns `None` when already in the main repo (or not in a git repo at all).

package/dist/src/native/index.js

@@ -1,15 +1,11 @@
 const { join, basename } = require('path');
-const {
-  copyFileSync,
-  existsSync,
-  mkdirSync,
-  renameSync,
-  statSync,
-  unlinkSync,
-} = require('fs');
+const { copyFileSync, renameSync, statSync, unlinkSync } = require('fs');
+const { createHash } = require('crypto');
 const Module = require('module');
 const { nxVersion } = require('../utils/versions');
-const { getNativeFileCacheLocation } = require('./native-file-cache-location');
+const {
+  ensureSecureNativeFileCacheLocation,
+} = require('./native-file-cache-location');
 
 const MAX_COPY_RETRIES = 3;
 
@@ -73,6 +69,14 @@ function statsOrNull(path) {
   }
 }
 
+function removeIfPresent(path) {
+  try {
+    unlinkSync(path);
+  } catch {
+    // Ignore cleanup errors
+  }
+}
+
 function isNoExecError(e) {
   return e.code === 'EACCES' || e.code === 'EPERM';
 }
@@ -95,20 +99,44 @@ Module._load = function (request, parent, isMain) {
     const nativeLocation = require.resolve(modulePath);
     const fileName = basename(nativeLocation);
 
-    // we copy the file to a workspace-scoped tmp directory and prefix with nxVersion to avoid stale files being loaded
-    const nativeFileCacheLocation = getNativeFileCacheLocation();
+    // null when the cache dir cannot be created *and trusted*; loading in place
+    // from node_modules is safer than loading out of a directory we don't own.
+    const nativeFileCacheLocation = ensureSecureNativeFileCacheLocation();
+    if (!nativeFileCacheLocation) {
+      return originalLoad.apply(this, [nativeLocation, parent, isMain]);
+    }
+
+    // nxVersion alone is not enough: in a source checkout it is the placeholder
+    // 0.0.1 for every worktree, so hashing the resolved binding path keeps each
+    // checkout in its own entry.
+    const cacheKey =
+      nxVersion +
+      '-' +
+      createHash('sha256')
+        .update(nativeLocation)
+        .digest('hex')
+        .substring(0, 12);
+
     // This is a path to copy to, not the one that gets loaded
     const tmpTmpFile = join(
       nativeFileCacheLocation,
-      nxVersion + '-' + Math.random() + fileName
+      cacheKey + '-' + Math.random() + fileName
     );
     // This is the path that will get loaded
-    const tmpFile = join(nativeFileCacheLocation, nxVersion + '-' + fileName);
-    const expectedFileSize = statSync(nativeLocation).size;
+    const tmpFile = join(nativeFileCacheLocation, cacheKey + '-' + fileName);
+    const sourceStats = statSync(nativeLocation);
+    const expectedFileSize = sourceStats.size;
     const existingFileStats = statsOrNull(tmpFile);
 
-    // If the file to be loaded already exists, just load it
-    if (existingFileStats?.size === expectedFileSize) {
+    // Size alone does not detect a rebuilt binding: a small Rust edit routinely
+    // produces a byte-identical size. The copy is taken after the build, so a
+    // cache entry older than the source means the source was rebuilt since.
+    const isFresh =
+      existingFileStats?.size === expectedFileSize &&
+      existingFileStats.mtimeMs >= sourceStats.mtimeMs;
+
+    // If the file to be loaded already exists and is current, just load it
+    if (isFresh) {
       try {
         return originalLoad.apply(this, [tmpFile, parent, isMain]);
       } catch (e) {
@@ -119,20 +147,36 @@ Module._load = function (request, parent, isMain) {
         throw e;
       }
     }
-    if (!existsSync(nativeFileCacheLocation)) {
-      mkdirSync(nativeFileCacheLocation, { recursive: true });
-    }
 
     // Retry copying up to 3 times, validating after each copy
+    let attemptsMade = 0;
+    let cacheError = null;
     for (let attempt = 1; attempt <= MAX_COPY_RETRIES; attempt++) {
+      attemptsMade = attempt;
       // First copy to a unique location for each process
-      copyFileSync(nativeLocation, tmpTmpFile);
+      try {
+        copyFileSync(nativeLocation, tmpTmpFile);
+      } catch (e) {
+        // Permission errors won't heal on retry, and a throwing copy can still
+        // have left a partial file behind.
+        cacheError = e;
+        removeIfPresent(tmpTmpFile);
+        break;
+      }
 
       // Validate the copy - check file size matches expected
       const copiedFileStats = statsOrNull(tmpTmpFile);
       if (copiedFileStats?.size === expectedFileSize) {
         // Copy succeeded, rename to final location and load
-        renameSync(tmpTmpFile, tmpFile);
+        try {
+          renameSync(tmpTmpFile, tmpFile);
+        } catch (e) {
+          // Unguarded, this throws out of `require` and native-bindings.js
+          // reports it as a missing optional dependency, which it is not.
+          cacheError = e;
+          removeIfPresent(tmpTmpFile);
+          break;
+        }
         try {
           return originalLoad.apply(this, [tmpFile, parent, isMain]);
         } catch (e) {
@@ -145,16 +189,15 @@ Module._load = function (request, parent, isMain) {
       }
 
       // Copy failed validation, clean up the malformed file
-      try {
-        unlinkSync(tmpTmpFile);
-      } catch {
-        // Ignore cleanup errors
-      }
+      removeIfPresent(tmpTmpFile);
     }
 
-    // All retries failed - warn and load from original location
+    // Name the errno: ENOSPC, EROFS, EACCES and EDQUOT are all actionable and
+    // otherwise indistinguishable.
     console.warn(
-      `Warning: Failed to copy native module to cache after ${MAX_COPY_RETRIES} attempts. ` +
+      `Warning: Failed to copy native module to cache after ${attemptsMade} attempt${
+        attemptsMade === 1 ? '' : 's'
+      }${cacheError ? ` (${cacheError.code ?? cacheError.message})` : ''}. ` +
         `Loading from original location instead. ` +
         `This may cause file locking issues on Windows.`
     );

package/dist/src/native/native-bindings.js

@@ -610,6 +610,7 @@ module.exports.getBinaryTarget = nativeBinding.getBinaryTarget
 module.exports.getDefaultMaxCacheSize = nativeBinding.getDefaultMaxCacheSize
 module.exports.getEventDimensions = nativeBinding.getEventDimensions
 module.exports.getFilesForOutputsBatch = nativeBinding.getFilesForOutputsBatch
+module.exports.getHardcodedIgnorePatterns = nativeBinding.getHardcodedIgnorePatterns
 module.exports.getMainWorktreeRoot = nativeBinding.getMainWorktreeRoot
 module.exports.getTransformableOutputs = nativeBinding.getTransformableOutputs
 module.exports.GroupType = nativeBinding.GroupType

package/dist/src/native/native-file-cache-location.d.ts

@@ -1 +1,17 @@
-export declare function getNativeFileCacheLocation(): string;
+/**
+ * Path of the current user's native binary cache. Nothing about the constant is
+ * owner-only — `ensureSecureNativeFileCacheLocation` is what establishes that,
+ * and on Windows nothing does, since the OS temp dir is already per-account.
+ */
+export declare const NATIVE_CACHE_ROOT: string;
+export declare function getNativeFileCacheLocationToDelete(): string | null;
+/**
+ * Create the native file cache dir, or return `null` if it cannot be created
+ * *securely* — in which case the caller loads the binding in place.
+ *
+ * The stable top-level container is verified as safe for private children. The
+ * uid directory and every directory loaded through are owner-only.
+ * `ensureOwnedPrivateDir` refuses a directory or symlink another local user
+ * planted before us.
+ */
+export declare function ensureSecureNativeFileCacheLocation(cacheRoot?: string): string | null;