@ohos-ports/nx 17.3.2-beta.0

package/src/daemon/server/watcher.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertChangeEventsToLogMessage = exports.watchOutputFiles = exports.watchWorkspace = void 0;
+const workspace_root_1 = require("../../utils/workspace-root");
+const path_1 = require("path");
+const socket_utils_1 = require("../socket-utils");
+const shutdown_utils_1 = require("./shutdown-utils");
+const path_2 = require("../../utils/path");
+const ignore_1 = require("../../utils/ignore");
+const cache_1 = require("../cache");
+const ALWAYS_IGNORE = [...(0, ignore_1.getAlwaysIgnore)(workspace_root_1.workspaceRoot), socket_utils_1.FULL_OS_SOCKET_PATH];
+async function watchWorkspace(server, cb) {
+    const { Watcher } = await Promise.resolve().then(() => require('../../native'));
+    let relativeServerProcess = (0, path_2.normalizePath)((0, path_1.relative)(workspace_root_1.workspaceRoot, cache_1.serverProcessJsonPath));
+    let watcher = new Watcher(workspace_root_1.workspaceRoot, [`!${relativeServerProcess}`]);
+    watcher.watch((err, events) => {
+        if (err) {
+            return cb(err, null);
+        }
+        for (const event of events) {
+            if (event.path == relativeServerProcess &&
+                (0, cache_1.getDaemonProcessIdSync)() !== process.pid) {
+                (0, shutdown_utils_1.handleServerProcessTermination)({
+                    server,
+                    reason: 'this process is no longer the current daemon (native)',
+                });
+            }
+            if (event.path.endsWith('.gitignore') || event.path === '.nxignore') {
+                // If the ignore files themselves have changed we need to dynamically update our cached ignoreGlobs
+                (0, shutdown_utils_1.handleServerProcessTermination)({
+                    server,
+                    reason: 'Stopping the daemon the set of ignored files changed (native)',
+                });
+            }
+        }
+        cb(null, events);
+    });
+    return watcher;
+}
+exports.watchWorkspace = watchWorkspace;
+async function watchOutputFiles(cb) {
+    const { Watcher } = await Promise.resolve().then(() => require('../../native'));
+    let watcher = new Watcher(workspace_root_1.workspaceRoot, null, false);
+    watcher.watch((err, events) => {
+        if (err) {
+            return cb(err, null);
+        }
+        if (events.length !== 0) {
+            cb(null, events);
+        }
+    });
+    return watcher;
+}
+exports.watchOutputFiles = watchOutputFiles;
+/**
+ * NOTE: An event type of "create" will also apply to the case where the user has restored
+ * an original version of a file after modifying/deleting it by using git, so we adjust
+ * our log language accordingly.
+ */
+function convertChangeEventsToLogMessage(changeEvents) {
+    // If only a single file was changed, show the information inline
+    if (changeEvents.length === 1) {
+        const { path, type } = changeEvents[0];
+        let typeLog = 'updated';
+        switch (type) {
+            case 'create':
+                typeLog = 'created or restored';
+                break;
+            case 'update':
+                typeLog = 'modified';
+                break;
+            case 'delete':
+                typeLog = 'deleted';
+                break;
+        }
+        return `${path} was ${typeLog}`;
+    }
+    let numCreatedOrRestoredFiles = 0;
+    let numModifiedFiles = 0;
+    let numDeletedFiles = 0;
+    for (const event of changeEvents) {
+        switch (event.type) {
+            case 'create':
+                numCreatedOrRestoredFiles++;
+                break;
+            case 'update':
+                numModifiedFiles++;
+                break;
+            case 'delete':
+                numDeletedFiles++;
+                break;
+        }
+    }
+    return `${numCreatedOrRestoredFiles} file(s) created or restored, ${numModifiedFiles} file(s) modified, ${numDeletedFiles} file(s) deleted`;
+}
+exports.convertChangeEventsToLogMessage = convertChangeEventsToLogMessage;

package/src/daemon/socket-utils.d.ts

@@ -0,0 +1,11 @@
+export declare const isWindows: boolean;
+/**
+ * For IPC with the daemon server we use unix sockets or windows named pipes, depending on the user's operating system.
+ *
+ * See https://nodejs.org/dist/latest-v14.x/docs/api/net.html#net_identifying_paths_for_ipc_connections for a full breakdown
+ * of OS differences between Unix domain sockets and named pipes.
+ */
+export declare const FULL_OS_SOCKET_PATH: string;
+export declare const FORKED_PROCESS_OS_SOCKET_PATH: (id: string) => string;
+export declare function killSocketOrPath(): void;
+export declare function serializeResult(error: Error | null, serializedProjectGraph: string | null, serializedSourceMaps: string | null): string | null;

package/src/daemon/socket-utils.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeResult = exports.killSocketOrPath = exports.FORKED_PROCESS_OS_SOCKET_PATH = exports.FULL_OS_SOCKET_PATH = exports.isWindows = void 0;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const tmp_dir_1 = require("./tmp-dir");
+exports.isWindows = (0, os_1.platform)() === 'win32';
+/**
+ * For IPC with the daemon server we use unix sockets or windows named pipes, depending on the user's operating system.
+ *
+ * See https://nodejs.org/dist/latest-v14.x/docs/api/net.html#net_identifying_paths_for_ipc_connections for a full breakdown
+ * of OS differences between Unix domain sockets and named pipes.
+ */
+exports.FULL_OS_SOCKET_PATH = exports.isWindows
+    ? '\\\\.\\pipe\\nx\\' + (0, path_1.resolve)(tmp_dir_1.DAEMON_SOCKET_PATH)
+    : (0, path_1.resolve)(tmp_dir_1.DAEMON_SOCKET_PATH);
+const FORKED_PROCESS_OS_SOCKET_PATH = (id) => {
+    let path = (0, path_1.resolve)((0, path_1.join)(tmp_dir_1.socketDir, 'fp' + id + '.sock'));
+    return exports.isWindows ? '\\\\.\\pipe\\nx\\' + (0, path_1.resolve)(path) : (0, path_1.resolve)(path);
+};
+exports.FORKED_PROCESS_OS_SOCKET_PATH = FORKED_PROCESS_OS_SOCKET_PATH;
+function killSocketOrPath() {
+    try {
+        (0, fs_1.unlinkSync)(exports.FULL_OS_SOCKET_PATH);
+    }
+    catch { }
+}
+exports.killSocketOrPath = killSocketOrPath;
+// Include the original stack trace within the serialized error so that the client can show it to the user.
+function serializeError(error) {
+    if (!error) {
+        return null;
+    }
+    return JSON.stringify(error, Object.getOwnPropertyNames(error));
+}
+// Prepare a serialized project graph result for sending over IPC from the server to the client
+function serializeResult(error, serializedProjectGraph, serializedSourceMaps) {
+    // We do not want to repeat work `JSON.stringify`ing an object containing the potentially large project graph so merge as strings
+    return `{ "error": ${serializeError(error)}, "projectGraph": ${serializedProjectGraph}, "sourceMaps": ${serializedSourceMaps} }`;
+}
+exports.serializeResult = serializeResult;

package/src/daemon/tmp-dir.d.ts

@@ -0,0 +1,8 @@
+export declare const DAEMON_DIR_FOR_CURRENT_WORKSPACE: string;
+export declare const DAEMON_OUTPUT_LOG_FILE: string;
+export declare const socketDir: string;
+export declare const DAEMON_SOCKET_PATH: string;
+export declare function writeDaemonLogs(error?: string): string;
+export declare function markDaemonAsDisabled(): void;
+export declare function isDaemonDisabled(): boolean;
+export declare function removeSocketDir(): void;

package/src/daemon/tmp-dir.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeSocketDir = exports.isDaemonDisabled = exports.markDaemonAsDisabled = exports.writeDaemonLogs = exports.DAEMON_SOCKET_PATH = exports.socketDir = exports.DAEMON_OUTPUT_LOG_FILE = exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE = void 0;
+/**
+ * Per workspace (to avoid subtle differences and issues), we want to have a deterministic
+ * location within the OS's tmp directory where we write log files for background processes
+ * and where we create the actual unix socket/named pipe for the daemon.
+ */
+const fs_1 = require("fs");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const cache_directory_1 = require("../utils/cache-directory");
+const crypto_1 = require("crypto");
+const tmp_1 = require("tmp");
+const workspace_root_1 = require("../utils/workspace-root");
+exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE = (0, path_1.join)(cache_directory_1.projectGraphCacheDirectory, 'd');
+exports.DAEMON_OUTPUT_LOG_FILE = (0, path_1.join)(exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE, 'daemon.log');
+exports.socketDir = process.env.NX_DAEMON_SOCKET_DIR || createSocketDir();
+exports.DAEMON_SOCKET_PATH = (0, path_1.join)(exports.socketDir, 
+// As per notes above on socket/named pipe length limitations, we keep this intentionally short
+'d.sock');
+function writeDaemonLogs(error) {
+    const file = (0, path_1.join)(exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE, 'daemon-error.log');
+    (0, fs_1.writeFileSync)(file, error);
+    return file;
+}
+exports.writeDaemonLogs = writeDaemonLogs;
+function markDaemonAsDisabled() {
+    (0, fs_1.writeFileSync)((0, path_1.join)(exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE, 'disabled'), 'true');
+}
+exports.markDaemonAsDisabled = markDaemonAsDisabled;
+function isDaemonDisabled() {
+    try {
+        (0, fs_1.statSync)((0, path_1.join)(exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE, 'disabled'));
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+exports.isDaemonDisabled = isDaemonDisabled;
+function socketDirName() {
+    const hasher = (0, crypto_1.createHash)('sha256');
+    hasher.update(workspace_root_1.workspaceRoot.toLowerCase());
+    const unique = hasher.digest('hex').substring(0, 20);
+    return (0, path_1.join)(tmp_1.tmpdir, unique);
+}
+/**
+ * We try to create a socket file in a tmp dir, but if it doesn't work because
+ * for instance we don't have permissions, we create it in DAEMON_DIR_FOR_CURRENT_WORKSPACE
+ */
+function createSocketDir() {
+    try {
+        const dir = socketDirName();
+        (0, fs_extra_1.ensureDirSync)(dir);
+        return dir;
+    }
+    catch (e) {
+        return exports.DAEMON_DIR_FOR_CURRENT_WORKSPACE;
+    }
+}
+function removeSocketDir() {
+    try {
+        (0, fs_extra_1.rmSync)(exports.socketDir, { recursive: true, force: true });
+    }
+    catch (e) { }
+}
+exports.removeSocketDir = removeSocketDir;

package/src/devkit-exports.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Note to developers: STOP! These exports end up as the public API of @nx/devkit.
+ * Try hard to not add to this API to reduce the surface area we need to maintain.
+ */
+/**
+ * @category Tree
+ */
+export type { Tree, FileChange } from './generators/tree';
+/**
+ * @category Workspace
+ */
+export type { WorkspaceJsonConfiguration, ProjectsConfigurations, TargetDependencyConfig, TargetConfiguration, ProjectConfiguration, ProjectType, Workspace, } from './config/workspace-json-project-json';
+/**
+ * @category Workspace
+ */
+export type { Generator, GeneratorCallback, Executor, ExecutorContext, TaskGraphExecutor, GeneratorsJson, ExecutorsJson, MigrationsJson, CustomHasher, HasherContext, } from './config/misc-interfaces';
+/**
+ * @category Workspace
+ */
+export { Workspaces } from './config/workspaces';
+export { workspaceLayout } from './config/configuration';
+export type { NxPlugin, NxPluginV1, NxPluginV2, ProjectTargetConfigurator, CreateNodes, CreateNodesFunction, CreateNodesResult, CreateNodesContext, CreateDependencies, CreateDependenciesContext, } from './utils/nx-plugin';
+/**
+ * @category Workspace
+ */
+export type { Task, TaskGraph } from './config/task-graph';
+/**
+ * @category Workspace
+ */
+export type { ImplicitDependencyEntry, ImplicitJsonSubsetDependency, NxJsonConfiguration, PluginConfiguration, TargetDefaults, NxAffectedConfig, } from './config/nx-json';
+/**
+ * @category Logger
+ */
+export { logger } from './utils/logger';
+/**
+ * @category Utils
+ */
+export { output } from './utils/output';
+/**
+ * @category Package Manager
+ */
+export type { PackageManager } from './utils/package-manager';
+/**
+ * @category Package Manager
+ */
+export { getPackageManagerCommand, detectPackageManager, getPackageManagerVersion, } from './utils/package-manager';
+/**
+ * @category Commands
+ */
+export type { Target } from './command-line/run/run';
+/**
+ * @category Commands
+ */
+export { runExecutor } from './command-line/run/run';
+/**
+ * @category Generators
+ */
+export { addProjectConfiguration, readProjectConfiguration, removeProjectConfiguration, updateProjectConfiguration, getProjects, } from './generators/utils/project-configuration';
+/**
+ * @category Generators
+ */
+export { glob } from './generators/utils/glob';
+/**
+ * @category Generators
+ */
+export { readNxJson, updateNxJson, } from './generators/utils/project-configuration';
+/**
+ * @category Project Graph
+ */
+export type { ProjectFileMap, FileMap, FileData, ProjectGraph, ProjectGraphDependency, ProjectGraphNode, ProjectGraphProjectNode, ProjectGraphExternalNode, ProjectGraphProcessorContext, } from './config/project-graph';
+/**
+ * @category Project Graph
+ */
+export { DependencyType } from './config/project-graph';
+/**
+ * @category Project Graph
+ */
+export { ProjectGraphBuilder, RawProjectGraphDependency, DynamicDependency, ImplicitDependency, StaticDependency, validateDependency, } from './project-graph/project-graph-builder';
+/**
+ * @category Generators
+ */
+export { readJson, writeJson, updateJson } from './generators/utils/json';
+/**
+ * @category Utils
+ */
+export { parseJson, serializeJson, stripJsonComments } from './utils/json';
+/**
+ * @category Utils
+ */
+export type { JsonParseOptions, JsonSerializeOptions } from './utils/json';
+/**
+ * @category Utils
+ */
+export { readJsonFile, writeJsonFile } from './utils/fileutils';
+/**
+ * @category Utils
+ */
+export { stripIndents } from './utils/strip-indents';
+/**
+ * @category Utils
+ */
+export { joinPathFragments, normalizePath } from './utils/path';
+/**
+ * @category Utils
+ */
+export { workspaceRoot, appRootPath } from './utils/app-root';
+/**
+ * @category Utils
+ */
+export { reverse } from './project-graph/operators';
+/**
+ * @category Utils
+ */
+export { createProjectGraphAsync, readCachedProjectGraph, readProjectsConfigurationFromProjectGraph, } from './project-graph/project-graph';
+/**
+ * @category Utils
+ */
+export { getOutputsForTargetAndConfiguration } from './tasks-runner/utils';
+/**
+ * @category Utils
+ */
+export { defaultTasksRunner, DefaultTasksRunnerOptions, RemoteCache, } from './tasks-runner/default-tasks-runner';
+/**
+ * @category Utils
+ */
+export { Hash, TaskHasher, Hasher } from './hasher/task-hasher';
+export { hashArray } from './hasher/file-hasher';
+/**
+ * @category Utils
+ */
+export { cacheDir } from './utils/cache-directory';
+/**
+ * @category Utils
+ */
+export { createProjectFileMapUsingProjectGraph } from './project-graph/file-map-utils';

package/src/devkit-exports.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Note to developers: STOP! These exports end up as the public API of @nx/devkit.
+ * Try hard to not add to this API to reduce the surface area we need to maintain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectFileMapUsingProjectGraph = exports.cacheDir = exports.hashArray = exports.defaultTasksRunner = exports.getOutputsForTargetAndConfiguration = exports.readProjectsConfigurationFromProjectGraph = exports.readCachedProjectGraph = exports.createProjectGraphAsync = exports.reverse = exports.appRootPath = exports.workspaceRoot = exports.normalizePath = exports.joinPathFragments = exports.stripIndents = exports.writeJsonFile = exports.readJsonFile = exports.stripJsonComments = exports.serializeJson = exports.parseJson = exports.updateJson = exports.writeJson = exports.readJson = exports.validateDependency = exports.ProjectGraphBuilder = exports.DependencyType = exports.updateNxJson = exports.readNxJson = exports.glob = exports.getProjects = exports.updateProjectConfiguration = exports.removeProjectConfiguration = exports.readProjectConfiguration = exports.addProjectConfiguration = exports.runExecutor = exports.getPackageManagerVersion = exports.detectPackageManager = exports.getPackageManagerCommand = exports.output = exports.logger = exports.workspaceLayout = exports.Workspaces = void 0;
+// TODO(v19): Remove this export
+/**
+ * @category Workspace
+ */
+var workspaces_1 = require("./config/workspaces");
+Object.defineProperty(exports, "Workspaces", { enumerable: true, get: function () { return workspaces_1.Workspaces; } });
+var configuration_1 = require("./config/configuration");
+Object.defineProperty(exports, "workspaceLayout", { enumerable: true, get: function () { return configuration_1.workspaceLayout; } });
+/**
+ * @category Logger
+ */
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "logger", { enumerable: true, get: function () { return logger_1.logger; } });
+/**
+ * @category Utils
+ */
+var output_1 = require("./utils/output");
+Object.defineProperty(exports, "output", { enumerable: true, get: function () { return output_1.output; } });
+/**
+ * @category Package Manager
+ */
+var package_manager_1 = require("./utils/package-manager");
+Object.defineProperty(exports, "getPackageManagerCommand", { enumerable: true, get: function () { return package_manager_1.getPackageManagerCommand; } });
+Object.defineProperty(exports, "detectPackageManager", { enumerable: true, get: function () { return package_manager_1.detectPackageManager; } });
+Object.defineProperty(exports, "getPackageManagerVersion", { enumerable: true, get: function () { return package_manager_1.getPackageManagerVersion; } });
+/**
+ * @category Commands
+ */
+var run_1 = require("./command-line/run/run");
+Object.defineProperty(exports, "runExecutor", { enumerable: true, get: function () { return run_1.runExecutor; } });
+/**
+ * @category Generators
+ */
+var project_configuration_1 = require("./generators/utils/project-configuration");
+Object.defineProperty(exports, "addProjectConfiguration", { enumerable: true, get: function () { return project_configuration_1.addProjectConfiguration; } });
+Object.defineProperty(exports, "readProjectConfiguration", { enumerable: true, get: function () { return project_configuration_1.readProjectConfiguration; } });
+Object.defineProperty(exports, "removeProjectConfiguration", { enumerable: true, get: function () { return project_configuration_1.removeProjectConfiguration; } });
+Object.defineProperty(exports, "updateProjectConfiguration", { enumerable: true, get: function () { return project_configuration_1.updateProjectConfiguration; } });
+Object.defineProperty(exports, "getProjects", { enumerable: true, get: function () { return project_configuration_1.getProjects; } });
+/**
+ * @category Generators
+ */
+var glob_1 = require("./generators/utils/glob");
+Object.defineProperty(exports, "glob", { enumerable: true, get: function () { return glob_1.glob; } });
+/**
+ * @category Generators
+ */
+var project_configuration_2 = require("./generators/utils/project-configuration");
+Object.defineProperty(exports, "readNxJson", { enumerable: true, get: function () { return project_configuration_2.readNxJson; } });
+Object.defineProperty(exports, "updateNxJson", { enumerable: true, get: function () { return project_configuration_2.updateNxJson; } });
+/**
+ * @category Project Graph
+ */
+var project_graph_1 = require("./config/project-graph");
+Object.defineProperty(exports, "DependencyType", { enumerable: true, get: function () { return project_graph_1.DependencyType; } });
+/**
+ * @category Project Graph
+ */
+var project_graph_builder_1 = require("./project-graph/project-graph-builder");
+Object.defineProperty(exports, "ProjectGraphBuilder", { enumerable: true, get: function () { return project_graph_builder_1.ProjectGraphBuilder; } });
+Object.defineProperty(exports, "validateDependency", { enumerable: true, get: function () { return project_graph_builder_1.validateDependency; } });
+/**
+ * @category Generators
+ */
+var json_1 = require("./generators/utils/json");
+Object.defineProperty(exports, "readJson", { enumerable: true, get: function () { return json_1.readJson; } });
+Object.defineProperty(exports, "writeJson", { enumerable: true, get: function () { return json_1.writeJson; } });
+Object.defineProperty(exports, "updateJson", { enumerable: true, get: function () { return json_1.updateJson; } });
+/**
+ * @category Utils
+ */
+var json_2 = require("./utils/json");
+Object.defineProperty(exports, "parseJson", { enumerable: true, get: function () { return json_2.parseJson; } });
+Object.defineProperty(exports, "serializeJson", { enumerable: true, get: function () { return json_2.serializeJson; } });
+Object.defineProperty(exports, "stripJsonComments", { enumerable: true, get: function () { return json_2.stripJsonComments; } });
+/**
+ * @category Utils
+ */
+var fileutils_1 = require("./utils/fileutils");
+Object.defineProperty(exports, "readJsonFile", { enumerable: true, get: function () { return fileutils_1.readJsonFile; } });
+Object.defineProperty(exports, "writeJsonFile", { enumerable: true, get: function () { return fileutils_1.writeJsonFile; } });
+/**
+ * @category Utils
+ */
+var strip_indents_1 = require("./utils/strip-indents");
+Object.defineProperty(exports, "stripIndents", { enumerable: true, get: function () { return strip_indents_1.stripIndents; } });
+/**
+ * @category Utils
+ */
+var path_1 = require("./utils/path");
+Object.defineProperty(exports, "joinPathFragments", { enumerable: true, get: function () { return path_1.joinPathFragments; } });
+Object.defineProperty(exports, "normalizePath", { enumerable: true, get: function () { return path_1.normalizePath; } });
+// TODO(v16): Change this to export from './utils/workspace-root'
+/**
+ * @category Utils
+ */
+var app_root_1 = require("./utils/app-root");
+Object.defineProperty(exports, "workspaceRoot", { enumerable: true, get: function () { return app_root_1.workspaceRoot; } });
+Object.defineProperty(exports, "appRootPath", { enumerable: true, get: function () { return app_root_1.appRootPath; } });
+/**
+ * @category Utils
+ */
+var operators_1 = require("./project-graph/operators");
+Object.defineProperty(exports, "reverse", { enumerable: true, get: function () { return operators_1.reverse; } });
+/**
+ * @category Utils
+ */
+var project_graph_2 = require("./project-graph/project-graph");
+Object.defineProperty(exports, "createProjectGraphAsync", { enumerable: true, get: function () { return project_graph_2.createProjectGraphAsync; } });
+Object.defineProperty(exports, "readCachedProjectGraph", { enumerable: true, get: function () { return project_graph_2.readCachedProjectGraph; } });
+Object.defineProperty(exports, "readProjectsConfigurationFromProjectGraph", { enumerable: true, get: function () { return project_graph_2.readProjectsConfigurationFromProjectGraph; } });
+/**
+ * @category Utils
+ */
+var utils_1 = require("./tasks-runner/utils");
+Object.defineProperty(exports, "getOutputsForTargetAndConfiguration", { enumerable: true, get: function () { return utils_1.getOutputsForTargetAndConfiguration; } });
+/**
+ * @category Utils
+ */
+var default_tasks_runner_1 = require("./tasks-runner/default-tasks-runner");
+Object.defineProperty(exports, "defaultTasksRunner", { enumerable: true, get: function () { return default_tasks_runner_1.defaultTasksRunner; } });
+var file_hasher_1 = require("./hasher/file-hasher");
+Object.defineProperty(exports, "hashArray", { enumerable: true, get: function () { return file_hasher_1.hashArray; } });
+/**
+ * @category Utils
+ */
+var cache_directory_1 = require("./utils/cache-directory");
+Object.defineProperty(exports, "cacheDir", { enumerable: true, get: function () { return cache_directory_1.cacheDir; } });
+/**
+ * @category Utils
+ */
+var file_map_utils_1 = require("./project-graph/file-map-utils");
+Object.defineProperty(exports, "createProjectFileMapUsingProjectGraph", { enumerable: true, get: function () { return file_map_utils_1.createProjectFileMapUsingProjectGraph; } });

package/src/devkit-internals.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Note to developers: STOP! These exports are available via requireNx in @nx/devkit.
+ *
+ * These may not be available in certain version of Nx, so be sure to check them first.
+ */
+export { createTempNpmDirectory } from './utils/package-manager';
+export { getExecutorInformation } from './command-line/run/executor-utils';
+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 { splitTarget } from './utils/split-target';
+export { combineOptionsForExecutor } from './utils/params';
+export { sortObjectByKeys } from './utils/object-sort';
+export { stripIndent } from './utils/logger';
+export { readModulePackageJson } from './utils/package-json';
+export { splitByColons } from './utils/split-target';
+export { hashObject } from './hasher/file-hasher';
+export { hashWithWorkspaceContext } from './utils/workspace-context';
+export { createProjectRootMappingsFromProjectConfigurations, findProjectForPath, } from './project-graph/utils/find-project-for-path';

package/src/devkit-internals.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findProjectForPath = exports.createProjectRootMappingsFromProjectConfigurations = exports.hashWithWorkspaceContext = exports.hashObject = exports.splitByColons = exports.readModulePackageJson = exports.stripIndent = exports.sortObjectByKeys = exports.combineOptionsForExecutor = exports.splitTarget = exports.retrieveProjectConfigurationsWithAngularProjects = exports.calculateDefaultProjectName = exports.readNxJsonFromDisk = exports.getExecutorInformation = exports.createTempNpmDirectory = void 0;
+/**
+ * Note to developers: STOP! These exports are available via requireNx in @nx/devkit.
+ *
+ * These may not be available in certain version of Nx, so be sure to check them first.
+ */
+var package_manager_1 = require("./utils/package-manager");
+Object.defineProperty(exports, "createTempNpmDirectory", { enumerable: true, get: function () { return package_manager_1.createTempNpmDirectory; } });
+var executor_utils_1 = require("./command-line/run/executor-utils");
+Object.defineProperty(exports, "getExecutorInformation", { enumerable: true, get: function () { return executor_utils_1.getExecutorInformation; } });
+var nx_json_1 = require("./config/nx-json");
+Object.defineProperty(exports, "readNxJsonFromDisk", { enumerable: true, get: function () { return nx_json_1.readNxJson; } });
+var calculate_default_project_name_1 = require("./config/calculate-default-project-name");
+Object.defineProperty(exports, "calculateDefaultProjectName", { enumerable: true, get: function () { return calculate_default_project_name_1.calculateDefaultProjectName; } });
+var retrieve_workspace_files_1 = require("./project-graph/utils/retrieve-workspace-files");
+Object.defineProperty(exports, "retrieveProjectConfigurationsWithAngularProjects", { enumerable: true, get: function () { return retrieve_workspace_files_1.retrieveProjectConfigurationsWithAngularProjects; } });
+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");
+Object.defineProperty(exports, "combineOptionsForExecutor", { enumerable: true, get: function () { return params_1.combineOptionsForExecutor; } });
+var object_sort_1 = require("./utils/object-sort");
+Object.defineProperty(exports, "sortObjectByKeys", { enumerable: true, get: function () { return object_sort_1.sortObjectByKeys; } });
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "stripIndent", { enumerable: true, get: function () { return logger_1.stripIndent; } });
+var package_json_1 = require("./utils/package-json");
+Object.defineProperty(exports, "readModulePackageJson", { enumerable: true, get: function () { return package_json_1.readModulePackageJson; } });
+var split_target_2 = require("./utils/split-target");
+Object.defineProperty(exports, "splitByColons", { enumerable: true, get: function () { return split_target_2.splitByColons; } });
+var file_hasher_1 = require("./hasher/file-hasher");
+Object.defineProperty(exports, "hashObject", { enumerable: true, get: function () { return file_hasher_1.hashObject; } });
+var workspace_context_1 = require("./utils/workspace-context");
+Object.defineProperty(exports, "hashWithWorkspaceContext", { enumerable: true, get: function () { return workspace_context_1.hashWithWorkspaceContext; } });
+var find_project_for_path_1 = require("./project-graph/utils/find-project-for-path");
+Object.defineProperty(exports, "createProjectRootMappingsFromProjectConfigurations", { enumerable: true, get: function () { return find_project_for_path_1.createProjectRootMappingsFromProjectConfigurations; } });
+Object.defineProperty(exports, "findProjectForPath", { enumerable: true, get: function () { return find_project_for_path_1.findProjectForPath; } });

package/src/devkit-testing-exports.d.ts

@@ -0,0 +1,2 @@
+export { createTreeWithEmptyWorkspace, createTreeWithEmptyV1Workspace, } from './generators/testing-utils/create-tree-with-empty-workspace';
+export { createTree } from './generators/testing-utils/create-tree';

package/src/devkit-testing-exports.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTree = exports.createTreeWithEmptyV1Workspace = exports.createTreeWithEmptyWorkspace = void 0;
+var create_tree_with_empty_workspace_1 = require("./generators/testing-utils/create-tree-with-empty-workspace");
+Object.defineProperty(exports, "createTreeWithEmptyWorkspace", { enumerable: true, get: function () { return create_tree_with_empty_workspace_1.createTreeWithEmptyWorkspace; } });
+Object.defineProperty(exports, "createTreeWithEmptyV1Workspace", { enumerable: true, get: function () { return create_tree_with_empty_workspace_1.createTreeWithEmptyV1Workspace; } });
+var create_tree_1 = require("./generators/testing-utils/create-tree");
+Object.defineProperty(exports, "createTree", { enumerable: true, get: function () { return create_tree_1.createTree; } });

package/src/executors/noop/noop.impl.d.ts

@@ -0,0 +1,3 @@
+export default function (): Promise<{
+    success: boolean;
+}>;

package/src/executors/noop/noop.impl.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+async function default_1() {
+    return { success: true };
+}
+exports.default = default_1;

package/src/executors/noop/schema.json

@@ -0,0 +1,10 @@
+{
+  "version": 2,
+  "title": "Noop",
+  "description": "An executor that does nothing.",
+  "type": "object",
+  "cli": "nx",
+  "outputCapture": "pipe",
+  "properties": {},
+  "additionalProperties": true
+}

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

@@ -0,0 +1,42 @@
+import { ExecutorContext } from '../../config/misc-interfaces';
+export declare const LARGE_BUFFER: number;
+export type Json = {
+    [k: string]: any;
+};
+export interface RunCommandsOptions extends Json {
+    command?: string;
+    commands?: ({
+        command: string;
+        forwardAllArgs?: boolean;
+        /**
+         * description was added to allow users to document their commands inline,
+         * it is not intended to be used as part of the execution of the command.
+         */
+        description?: string;
+        prefix?: string;
+        color?: string;
+        bgColor?: string;
+    } | string)[];
+    color?: boolean;
+    parallel?: boolean;
+    readyWhen?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+    args?: string | string[];
+    envFile?: string;
+    __unparsed__: string[];
+}
+export interface NormalizedRunCommandsOptions extends RunCommandsOptions {
+    commands: {
+        command: string;
+        forwardAllArgs?: boolean;
+    }[];
+    parsedArgs: {
+        [k: string]: any;
+    };
+    args?: string;
+}
+export default function (options: RunCommandsOptions, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;
+export declare function interpolateArgsIntoCommand(command: string, opts: Pick<NormalizedRunCommandsOptions, 'args' | 'parsedArgs' | '__unparsed__'>, forwardAllArgs: boolean): string;