@ohos-ports/nx 23.3.0-beta.3 → 24.0.2-beta.0

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

@@ -22,7 +22,7 @@ export { getExecutorInformation, parseExecutor, } from './command-line/run/execu
 export { readNxJson as readNxJsonFromDisk } from './config/nx-json';
 export { calculateDefaultProjectName } from './config/calculate-default-project-name';
 export { retrieveProjectConfigurationsWithAngularProjects } from './project-graph/utils/retrieve-workspace-files';
-export { mergeTargetConfigurations, resolveCommandSyntacticSugar, } from './project-graph/utils/project-configuration/target-merging';
+export { mergeTargetConfigurations, resolveCommandSyntacticSugar, resolveNxTokensInOptions, } from './project-graph/utils/project-configuration/target-merging';
 export { findMatchingTargetNames, readProjectConfigurationsFromRootMap, } from './project-graph/utils/project-configuration/project-nodes-manager';
 export { findMatchingConfigFiles } from './project-graph/utils/project-configuration-utils';
 export { findMatchingProjects } from './utils/find-matching-projects';
@@ -63,7 +63,7 @@ export { resolveImplementation, resolveSchema, ImplementationResolutionError, Sc
 export { resolvePrompt, PromptResolutionError, } from './command-line/migrate/prompt-files';
 export { checkFilesAreInputs, checkFilesAreOutputs, } from './hasher/check-task-files';
 export { getCatalogManager, getCatalogDependenciesFromPackageJson, } from './utils/catalog';
-export { acknowledgeBuildScripts } from './utils/acknowledge-build-scripts';
+export { acknowledgeBuildScripts, acknowledgeDeclaredBuildScripts, } 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';
@@ -81,13 +81,13 @@ 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 { LARGE_BUFFER, interpolateArgsIntoCommand, normalizeArgs as normalizeRunCommandsArgs, } 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 { isAiAgent, killProcessTreeGraceful } from './native';
+export { isAiAgent, killProcessTreeGraceful, readShebangHeaders, } from './native';
 export { killChildOnHostExit } from './utils/kill-child-on-host-exit';
 export { connectToNxCloud } from './nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud';
 export type { NxCloudOnBoardingStatus } from './nx-cloud/models/onboarding-status';
@@ -115,7 +115,7 @@ 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 type { 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';
@@ -144,3 +144,4 @@ export { nxVersion } from './utils/versions';
 export { getFilesInDirectoryUsingContext, globWithWorkspaceContext, resetWorkspaceContext, setupWorkspaceContext, } from './utils/workspace-context';
 export { setWorkspaceRoot, workspaceRootInner } from './utils/workspace-root';
 export { safeExecFileSync, safeSpawn } from './utils/safe-spawn';
+export { resolveStartupHost } from './tasks-runner/readiness/startup-host';

package/dist/src/devkit-internals.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDaemonClientEnvGeneration = exports.hashDaemonClientEnv = exports.getEnvPathsForTask = exports.getGraphTimeDotEnvForTask = exports.getEnvFilesForTask = exports.interpolate = exports.requireWithTsconfigFallback = exports.isTsEsmNamedExportLinkageError = exports.isRequireInEsmScopeError = 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.confirmationPrompt = exports.textPrompt = exports.multiselectPrompt = exports.selectPrompt = exports.splitTarget = exports.createPrettierIgnoreChecker = exports.createOxfmtIgnoreChecker = exports.createGitIgnoreChecker = exports.readTargetDefaultsForTarget = exports.createTargetDefaultsResults = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.readProjectConfigurationsFromRootMap = exports.findMatchingTargetNames = exports.resolveCommandSyntacticSugar = exports.mergeTargetConfigurations = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.parseExecutor = exports.getExecutorInformation = exports.parseVersionFromPackageManagerField = exports.createTempNpmDirectory = void 0;
-exports.connectToNxCloud = exports.killChildOnHostExit = exports.killProcessTreeGraceful = exports.isAiAgent = 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 = 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.oxfmtConfigFiles = exports.formatFilesWithOxfmt = exports.detectFormatterInTree = exports.detectFormatter = exports.prettierConfigFiles = exports.isUsingPrettierInTree = exports.createOverrides = exports.createCliOptions = exports.isCI = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = void 0;
-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 = 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.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.registerTsConfigPaths = exports.getWorkspacePackagesFromGraph = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.findProjectsNpmDependencies = exports.createPackageJson = exports.getLockFileName = exports.generatePrunedDeployOutput = exports.createLockFile = exports.createNxCloudOnboardingURL = exports.getNxCloudAppOnBoardingUrl = exports.createNxCloudOnboardingURLForWelcomeApp = void 0;
-exports.safeSpawn = exports.safeExecFileSync = exports.workspaceRootInner = exports.setWorkspaceRoot = exports.setupWorkspaceContext = exports.resetWorkspaceContext = exports.globWithWorkspaceContext = exports.getFilesInDirectoryUsingContext = exports.nxVersion = exports.SyncError = exports.quoteShellArg = exports.getSourceDirOfDependentProjects = exports.findAllProjectNodeDependencies = exports.findInstalledPlugins = exports.deriveGroupNameFromTarget = exports.warnUnshippableLocalPathSpec = exports.relocatePrunedLocalPathSpec = exports.movePeerDependencyToDependencies = exports.dropEmptyPeerDependencySections = exports.readNxMigrateConfig = exports.isNxCloudUsed = exports.getNxCloudUrl = exports.orange = exports.NX_PREFIX = exports.getNxRequirePaths = exports.isGlobPattern = 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 = void 0;
+exports.hashDaemonClientEnv = exports.getEnvPathsForTask = exports.getGraphTimeDotEnvForTask = exports.getEnvFilesForTask = exports.interpolate = exports.requireWithTsconfigFallback = exports.isTsEsmNamedExportLinkageError = exports.isRequireInEsmScopeError = 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.confirmationPrompt = exports.textPrompt = exports.multiselectPrompt = exports.selectPrompt = exports.splitTarget = exports.createPrettierIgnoreChecker = exports.createOxfmtIgnoreChecker = exports.createGitIgnoreChecker = exports.readTargetDefaultsForTarget = exports.createTargetDefaultsResults = exports.findMatchingProjects = exports.findMatchingConfigFiles = exports.readProjectConfigurationsFromRootMap = exports.findMatchingTargetNames = exports.resolveNxTokensInOptions = exports.resolveCommandSyntacticSugar = exports.mergeTargetConfigurations = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.parseExecutor = exports.getExecutorInformation = exports.parseVersionFromPackageManagerField = exports.createTempNpmDirectory = void 0;
+exports.getTargetInputs = exports.filterUsingGlobPatterns = exports.hashFile = exports.getRelativeProjectJsonSchemaPath = exports.FsTree = exports.normalizeRunCommandsArgs = exports.interpolateArgsIntoCommand = 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.acknowledgeDeclaredBuildScripts = exports.acknowledgeBuildScripts = exports.getCatalogDependenciesFromPackageJson = exports.getCatalogManager = 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.oxfmtConfigFiles = exports.formatFilesWithOxfmt = exports.detectFormatterInTree = exports.detectFormatter = exports.prettierConfigFiles = exports.isUsingPrettierInTree = exports.createOverrides = exports.createCliOptions = exports.isCI = exports.applyDaemonEnvFromClient = exports.getAppliedDaemonClientEnv = exports.getDaemonClientEnvGeneration = void 0;
+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 = 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.buildPackageJsonWorkspacesMatcher = exports.buildPackageJsonPatterns = exports.getGlobPatternsFromPackageManagerWorkspaces = exports.registerTsConfigPaths = exports.getWorkspacePackagesFromGraph = exports.isBuiltinModuleImport = exports.TargetProjectLocator = exports.findProjectsNpmDependencies = exports.createPackageJson = exports.getLockFileName = exports.generatePrunedDeployOutput = exports.createLockFile = exports.createNxCloudOnboardingURL = exports.getNxCloudAppOnBoardingUrl = exports.createNxCloudOnboardingURLForWelcomeApp = exports.connectToNxCloud = exports.killChildOnHostExit = exports.readShebangHeaders = exports.killProcessTreeGraceful = exports.isAiAgent = void 0;
+exports.setupWorkspaceContext = exports.resetWorkspaceContext = exports.globWithWorkspaceContext = exports.getFilesInDirectoryUsingContext = exports.nxVersion = exports.SyncError = exports.quoteShellArg = exports.getSourceDirOfDependentProjects = exports.findAllProjectNodeDependencies = exports.findInstalledPlugins = exports.deriveGroupNameFromTarget = exports.warnUnshippableLocalPathSpec = exports.relocatePrunedLocalPathSpec = exports.movePeerDependencyToDependencies = exports.dropEmptyPeerDependencySections = exports.readNxMigrateConfig = exports.isNxCloudUsed = exports.getNxCloudUrl = exports.orange = exports.NX_PREFIX = exports.getNxRequirePaths = exports.isGlobPattern = 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 = void 0;
+exports.resolveStartupHost = exports.safeSpawn = exports.safeExecFileSync = exports.workspaceRootInner = exports.setWorkspaceRoot = void 0;
 const tslib_1 = require("tslib");
 /**
  * Note to developers: STOP! These are nx internals, not part of the public
@@ -39,6 +40,7 @@ Object.defineProperty(exports, "retrieveProjectConfigurationsWithAngularProjects
 var target_merging_1 = require("./project-graph/utils/project-configuration/target-merging");
 Object.defineProperty(exports, "mergeTargetConfigurations", { enumerable: true, get: function () { return target_merging_1.mergeTargetConfigurations; } });
 Object.defineProperty(exports, "resolveCommandSyntacticSugar", { enumerable: true, get: function () { return target_merging_1.resolveCommandSyntacticSugar; } });
+Object.defineProperty(exports, "resolveNxTokensInOptions", { enumerable: true, get: function () { return target_merging_1.resolveNxTokensInOptions; } });
 var project_nodes_manager_1 = require("./project-graph/utils/project-configuration/project-nodes-manager");
 Object.defineProperty(exports, "findMatchingTargetNames", { enumerable: true, get: function () { return project_nodes_manager_1.findMatchingTargetNames; } });
 Object.defineProperty(exports, "readProjectConfigurationsFromRootMap", { enumerable: true, get: function () { return project_nodes_manager_1.readProjectConfigurationsFromRootMap; } });
@@ -154,6 +156,7 @@ 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; } });
+Object.defineProperty(exports, "acknowledgeDeclaredBuildScripts", { enumerable: true, get: function () { return acknowledge_build_scripts_1.acknowledgeDeclaredBuildScripts; } });
 // 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; } });
@@ -175,6 +178,8 @@ 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; } });
+Object.defineProperty(exports, "interpolateArgsIntoCommand", { enumerable: true, get: function () { return run_commands_impl_2.interpolateArgsIntoCommand; } });
+Object.defineProperty(exports, "normalizeRunCommandsArgs", { enumerable: true, get: function () { return run_commands_impl_2.normalizeArgs; } });
 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");
@@ -187,6 +192,7 @@ Object.defineProperty(exports, "getTargetInputs", { enumerable: true, get: funct
 var native_1 = require("./native");
 Object.defineProperty(exports, "isAiAgent", { enumerable: true, get: function () { return native_1.isAiAgent; } });
 Object.defineProperty(exports, "killProcessTreeGraceful", { enumerable: true, get: function () { return native_1.killProcessTreeGraceful; } });
+Object.defineProperty(exports, "readShebangHeaders", { enumerable: true, get: function () { return native_1.readShebangHeaders; } });
 var kill_child_on_host_exit_1 = require("./utils/kill-child-on-host-exit");
 Object.defineProperty(exports, "killChildOnHostExit", { enumerable: true, get: function () { return kill_child_on_host_exit_1.killChildOnHostExit; } });
 var connect_to_nx_cloud_1 = require("./nx-cloud/generators/connect-to-nx-cloud/connect-to-nx-cloud");
@@ -251,6 +257,7 @@ Object.defineProperty(exports, "expandDependencyConfigSyntaxSugar", { enumerable
 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; } });
+// TODO(v25): remove custom hasher support.
 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; } });
@@ -334,3 +341,5 @@ Object.defineProperty(exports, "workspaceRootInner", { enumerable: true, get: fu
 var safe_spawn_1 = require("./utils/safe-spawn");
 Object.defineProperty(exports, "safeExecFileSync", { enumerable: true, get: function () { return safe_spawn_1.safeExecFileSync; } });
 Object.defineProperty(exports, "safeSpawn", { enumerable: true, get: function () { return safe_spawn_1.safeSpawn; } });
+var startup_host_1 = require("./tasks-runner/readiness/startup-host");
+Object.defineProperty(exports, "resolveStartupHost", { enumerable: true, get: function () { return startup_host_1.resolveStartupHost; } });

package/dist/src/executors/run-commands/run-commands.impl.d.ts

@@ -56,5 +56,7 @@ export default function (options: RunCommandsOptions, context: ExecutorContext):
     success: boolean;
     terminalOutput: string;
 }>;
-export declare function runCommands(options: RunCommandsOptions, context: ExecutorContext, task?: Pick<Task, 'id' | 'ultracache'>): Promise<NoopChildProcess | ParallelRunningTasks | import("../../tasks-runner/pseudo-terminal").PseudoTtyProcess | SeriallyRunningTasks>;
-export declare function interpolateArgsIntoCommand(command: string, opts: Pick<NormalizedRunCommandsOptions, 'args' | 'parsedArgs' | '__unparsed__' | 'unknownOptions' | 'unparsedCommandArgs'>, forwardAllArgs: boolean): string;
+export declare function runCommands(options: RunCommandsOptions, context: ExecutorContext, task?: Pick<Task, 'id' | 'ultracache' | 'continuous'>, baseEnv?: NodeJS.ProcessEnv): Promise<NoopChildProcess | ParallelRunningTasks | import("../../tasks-runner/pseudo-terminal").PseudoTtyProcess | SeriallyRunningTasks>;
+/** The options `interpolateArgsIntoCommand` reads, from the task's options. */
+export declare function normalizeArgs(options: RunCommandsOptions): Pick<NormalizedRunCommandsOptions, 'args' | 'parsedArgs' | '__unparsed__' | 'unknownOptions' | 'unparsedCommandArgs'>;
+export declare function interpolateArgsIntoCommand(command: string, opts: Pick<NormalizedRunCommandsOptions, 'args' | 'parsedArgs' | '__unparsed__' | 'unknownOptions' | 'unparsedCommandArgs'>, forwardAllArgs: boolean, env?: () => NodeJS.ProcessEnv): string;

package/dist/src/executors/run-commands/run-commands.impl.js

@@ -3,11 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LARGE_BUFFER = void 0;
 exports.default = default_1;
 exports.runCommands = runCommands;
+exports.normalizeArgs = normalizeArgs;
 exports.interpolateArgsIntoCommand = interpolateArgsIntoCommand;
 const tslib_1 = require("tslib");
 const yargs_parser_1 = tslib_1.__importDefault(require("yargs-parser"));
 const is_tui_enabled_1 = require("../../tasks-runner/is-tui-enabled");
 const pseudo_terminal_1 = require("../../tasks-runner/pseudo-terminal");
+const tokens_1 = require("../../tasks-runner/tokens");
 const utils_1 = require("../../tasks-runner/utils");
 const noop_child_process_1 = require("../../tasks-runner/running-tasks/noop-child-process");
 const running_tasks_1 = require("./running-tasks");
@@ -40,8 +42,9 @@ async function default_1(options, context) {
         success: results.code === 0,
     };
 }
-async function runCommands(options, context, task) {
-    const normalized = normalizeOptions(options);
+async function runCommands(options, context, task, baseEnv) {
+    let env;
+    const normalized = normalizeOptions(options, () => (env ??= (0, running_tasks_1.processEnv)(options.color, (0, running_tasks_1.calculateCwd)(options.cwd, context), options.env ?? {}, options.envFile, baseEnv)));
     if (normalized.readyWhenStatus.length && !normalized.parallel) {
         throw new Error('ERROR: Bad executor config for run-commands - "readyWhen" can only be used when "parallel=true".');
     }
@@ -65,24 +68,30 @@ async function runCommands(options, context, task) {
         // The orchestrator's in-process path passes the task with a stub context,
         // so prefer it. `runExecutor` can name a target the task graph does not
         // hold, hence the project lookup; `convert-nx-executor` has neither graph,
-        // and only then is the config unknowable, which counts as tracked.
+        // and only then is the config unknowable, which counts as tracked and
+        // discrete.
         const resolvedTaskId = task?.id ??
             (0, utils_1.createTaskId)(context.projectName, context.targetName, context.configurationName);
+        // `projectGraph` is typed as present, but `convert-nx-executor` passes
+        // null for both graphs.
+        const targetConfiguration = context.projectName && context.targetName
+            ? context.projectGraph?.nodes?.[context.projectName]?.data.targets?.[context.targetName]
+            : undefined;
         const resolvedTask = task ??
             context.taskGraph?.tasks?.[resolvedTaskId] ?? {
             id: resolvedTaskId,
-            // Both graphs are typed as present, but `convert-nx-executor` passes
-            // null for each.
-            ultracache: context.projectName && context.targetName
-                ? context.projectGraph?.nodes?.[context.projectName]?.data
-                    .targets?.[context.targetName]?.ultracache
-                : undefined,
+            ultracache: targetConfiguration?.ultracache,
+            continuous: targetConfiguration?.continuous,
         };
-        const runningTask = isSingleCommandAndCanUsePseudoTerminal
-            ? await (0, running_tasks_1.runSingleCommandWithPseudoTerminal)(normalized, context, resolvedTask)
+        // The pseudo terminal runner ignores readyWhen, which keeps a continuous
+        // task running past the match. A discrete task must end there.
+        const usePtyRunner = isSingleCommandAndCanUsePseudoTerminal &&
+            (!normalized.readyWhenStatus.length || resolvedTask.continuous === true);
+        const runningTask = usePtyRunner
+            ? await (0, running_tasks_1.runSingleCommandWithPseudoTerminal)(normalized, context, resolvedTask, baseEnv)
             : options.parallel
-                ? new running_tasks_1.ParallelRunningTasks(normalized, context, resolvedTask)
-                : new running_tasks_1.SeriallyRunningTasks(normalized, context, tuiEnabled, resolvedTask);
+                ? new running_tasks_1.ParallelRunningTasks(normalized, context, resolvedTask, baseEnv)
+                : new running_tasks_1.SeriallyRunningTasks(normalized, context, tuiEnabled, resolvedTask, baseEnv);
         return runningTask;
     }
     catch (e) {
@@ -92,7 +101,7 @@ async function runCommands(options, context, task) {
         throw new Error(`ERROR: Something went wrong in run-commands - ${e.message}`);
     }
 }
-function normalizeOptions(options) {
+function normalizeOptions(options, env) {
     if (options.readyWhen && typeof options.readyWhen === 'string') {
         options.readyWhenStatus = [
             { stringToMatch: options.readyWhen, found: false },
@@ -118,9 +127,17 @@ function normalizeOptions(options) {
     else {
         options.commands = options.commands.map((c) => typeof c === 'string' ? { command: c } : c);
     }
-    if (options.args && Array.isArray(options.args)) {
-        options.args = options.args.join(' ');
-    }
+    Object.assign(options, normalizeArgs(options));
+    options.commands.forEach((c) => {
+        c.command = interpolateArgsIntoCommand(c.command, options, c.forwardAllArgs ?? options.forwardAllArgs ?? true, env);
+    });
+    return options;
+}
+/** The options `interpolateArgsIntoCommand` reads, from the task's options. */
+function normalizeArgs(options) {
+    const args = Array.isArray(options.args)
+        ? options.args.join(' ')
+        : options.args;
     const unparsedCommandArgs = (0, yargs_parser_1.default)(options.__unparsed__, {
         configuration: {
             'parse-numbers': false,
@@ -129,23 +146,32 @@ function normalizeOptions(options) {
             'camel-case-expansion': false,
         },
     });
-    options.unknownOptions = Object.keys(options)
+    const unknownOptions = Object.keys(options)
         .filter((p) => propKeys.indexOf(p) === -1 && unparsedCommandArgs[p] === undefined)
         .reduce((m, c) => ((m[c] = options[c]), m), {});
-    options.parsedArgs = parseArgs(unparsedCommandArgs, options.unknownOptions, options.args);
-    options.unparsedCommandArgs = unparsedCommandArgs;
-    options.commands.forEach((c) => {
-        c.command = interpolateArgsIntoCommand(c.command, options, c.forwardAllArgs ?? options.forwardAllArgs ?? true);
-    });
-    return options;
+    return {
+        args,
+        __unparsed__: options.__unparsed__,
+        unknownOptions,
+        parsedArgs: parseArgs(unparsedCommandArgs, unknownOptions, args),
+        unparsedCommandArgs,
+    };
 }
-function interpolateArgsIntoCommand(command, opts, forwardAllArgs) {
+function interpolateArgsIntoCommand(command, opts, forwardAllArgs, env = () => process.env) {
     if (command.indexOf('{args.') > -1 && command.indexOf('{args}') > -1) {
         throw new Error('Command should not contain both {args} and {args.*} values. Please choose one to use.');
     }
     if (command.indexOf('{args.') > -1) {
-        const regex = /{args\.([^}]+)}/g;
-        return command.replace(regex, (_, group) => opts.parsedArgs[group] !== undefined ? opts.parsedArgs[group] : '');
+        return (0, tokens_1.resolveTokens)(command, {
+            isToken: (name) => name === 'args',
+            // Overrides are parsed without dot-notation, so `{args.a.b}` reads the
+            // `--a.b` override
+            read: (_, path) => Object.hasOwn(opts.parsedArgs, path)
+                ? opts.parsedArgs[path]
+                : undefined,
+            env: { read: env },
+            noValue: () => '',
+        });
     }
     else if (command.indexOf('{args}') > -1) {
         const regex = /{args}/g;

package/dist/src/executors/run-commands/running-tasks.d.ts

@@ -13,7 +13,7 @@ export declare class ParallelRunningTasks implements RunningTask {
     private exited;
     private exitCode;
     private exitTerminalOutput;
-    constructor(options: NormalizedRunCommandsOptions, context: ExecutorContext, task: Pick<Task, 'id' | 'ultracache'>);
+    constructor(options: NormalizedRunCommandsOptions, context: ExecutorContext, task: Pick<Task, 'id' | 'ultracache'>, baseEnv?: NodeJS.ProcessEnv);
     getResults(): Promise<{
         code: number;
         terminalOutput: string;
@@ -29,6 +29,7 @@ export declare class ParallelRunningTasks implements RunningTask {
 export declare class SeriallyRunningTasks implements RunningTask {
     private readonly tuiEnabled;
     private readonly task;
+    private readonly baseEnv?;
     private terminalOutputChunks;
     private currentProcess;
     private exitCallbacks;
@@ -37,17 +38,25 @@ export declare class SeriallyRunningTasks implements RunningTask {
     private outputCallbacks;
     private exited;
     private exitTerminalOutput;
-    constructor(options: NormalizedRunCommandsOptions, context: ExecutorContext, tuiEnabled: boolean, task: Pick<Task, 'id' | 'ultracache'>);
+    constructor(options: NormalizedRunCommandsOptions, context: ExecutorContext, tuiEnabled: boolean, task: Pick<Task, 'id' | 'ultracache'>, baseEnv?: NodeJS.ProcessEnv);
     private emitExit;
     getResults(): Promise<{
         code: number;
         terminalOutput: string;
     }>;
     onExit(cb: (code: number, terminalOutput: string) => void): void;
-    onOutput(cb: (terminalOutput: string) => void): void;
+    onOutput(cb: (terminalOutput: string, isCommandHeader?: boolean) => void): void;
     send(message: Serializable): void;
     kill(signal?: NodeJS.Signals): void | Promise<void>;
     private run;
     private createProcess;
 }
-export declare function runSingleCommandWithPseudoTerminal(normalized: NormalizedRunCommandsOptions, context: ExecutorContext, task: Pick<Task, 'id' | 'ultracache'>): Promise<PseudoTtyProcess>;
+export declare function runSingleCommandWithPseudoTerminal(normalized: NormalizedRunCommandsOptions, context: ExecutorContext, task: Pick<Task, 'id' | 'ultracache'>, baseEnv?: NodeJS.ProcessEnv): Promise<PseudoTtyProcess>;
+export declare function calculateCwd(cwd: string | undefined, context: ExecutorContext): string;
+/**
+ * Env variables are processed in the following order:
+ * - env option from executor options
+ * - env file from envFile option if provided
+ * - local env variables, read from `baseEnv`
+ */
+export declare function processEnv(color: boolean, cwd: string, envOptionFromExecutor: Record<string, string>, envFile?: string, baseEnv?: NodeJS.ProcessEnv): Record<string, string>;