@depup/nx 22.5.4-depup.0

package/src/command-line/show/command-object.d.ts

@@ -0,0 +1,27 @@
+import type { ProjectGraphProjectNode } from '../../config/project-graph';
+import { CommandModule } from 'yargs';
+export interface NxShowArgs {
+    json?: boolean;
+}
+export type ShowProjectsOptions = NxShowArgs & {
+    exclude?: string[];
+    files?: string;
+    uncommitted?: any;
+    untracked?: any;
+    base?: string;
+    head?: string;
+    affected?: boolean;
+    type?: ProjectGraphProjectNode['type'];
+    projects?: string[];
+    withTarget?: string[];
+    verbose?: boolean;
+    sep?: string;
+};
+export type ShowProjectOptions = NxShowArgs & {
+    projectName?: string;
+    web?: boolean;
+    open?: boolean;
+    verbose?: boolean;
+};
+export declare const yargsShowCommand: CommandModule<Record<string, unknown>, NxShowArgs>;
+//# sourceMappingURL=command-object.d.ts.map

package/src/command-line/show/command-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/show/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAY,MAAM,OAAO,CAAC;AAQhD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,UAAU,CA6BX,CAAC"}

package/src/command-line/show/command-object.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsShowCommand = void 0;
+const yargs_1 = require("yargs");
+const shared_options_1 = require("../yargs-utils/shared-options");
+const handle_errors_1 = require("../../utils/handle-errors");
+exports.yargsShowCommand = {
+    command: 'show',
+    describe: 'Show information about the workspace (e.g., list of projects).',
+    builder: (yargs) => yargs
+        .command(showProjectsCommand)
+        .command(showProjectCommand)
+        .demandCommand()
+        .option('json', {
+        type: 'boolean',
+        description: 'Output JSON.',
+    })
+        .example('$0 show projects', 'Show a list of all projects in the workspace')
+        .example('$0 show projects --with-target serve', 'Show a list of all projects in the workspace that have a "serve" target')
+        .example('$0 show project [projectName]', 'Shows the resolved configuration for [projectName]'),
+    handler: async (args) => {
+        (0, yargs_1.showHelp)();
+        process.exit(1);
+    },
+};
+const showProjectsCommand = {
+    command: 'projects',
+    describe: 'Show a list of projects in the workspace.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)((0, shared_options_1.withAffectedOptions)(yargs))
+        .option('affected', {
+        type: 'boolean',
+        description: 'Show only affected projects.',
+    })
+        .option('projects', {
+        type: 'string',
+        alias: ['p'],
+        description: 'Show only projects that match a given pattern.',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('withTarget', {
+        type: 'string',
+        alias: ['t'],
+        description: 'Show only projects that have a specific target.',
+        coerce: shared_options_1.parseCSV,
+    })
+        .option('type', {
+        type: 'string',
+        description: 'Select only projects of the given type.',
+        choices: ['app', 'lib', 'e2e'],
+    })
+        .option('sep', {
+        type: 'string',
+        description: 'Outputs projects with the specified seperator.',
+    })
+        .implies('untracked', 'affected')
+        .implies('uncommitted', 'affected')
+        .implies('files', 'affected')
+        .implies('base', 'affected')
+        .implies('head', 'affected')
+        .conflicts('sep', 'json')
+        .conflicts('json', 'sep')
+        .example('$0 show projects --projects "apps/*"', 'Show all projects in the apps directory')
+        .example('$0 show projects --projects "shared-*"', 'Show all projects that start with "shared-"')
+        .example('$0 show projects --affected', 'Show affected projects in the workspace')
+        .example('$0 show projects --type app --affected', 'Show affected apps in the workspace')
+        .example('$0 show projects --affected --exclude=*-e2e', 'Show affected projects in the workspace, excluding end-to-end projects'),
+    handler: async (args) => {
+        const exitCode = await (0, handle_errors_1.handleErrors)(args.verbose, async () => {
+            const { showProjectsHandler } = await Promise.resolve().then(() => require('./projects'));
+            await showProjectsHandler(args);
+        });
+        process.exit(exitCode);
+    },
+};
+const showProjectCommand = {
+    command: 'project [projectName]',
+    describe: 'Shows resolved project configuration for a given project. If run within a project directory and no project name is provided, the project is inferred from the current working directory.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)(yargs)
+        .positional('projectName', {
+        type: 'string',
+        alias: 'p',
+        description: 'The project to show. If not provided, infers the project from the current working directory.',
+    })
+        .option('web', {
+        type: 'boolean',
+        description: 'Show project details in the browser. (default when interactive).',
+    })
+        .option('open', {
+        type: 'boolean',
+        description: 'Set to false to prevent the browser from opening when using --web.',
+        implies: 'web',
+    })
+        .check((argv) => {
+        // If TTY is enabled, default to web. Otherwise, default to JSON.
+        const alreadySpecified = argv.web !== undefined || argv.json !== undefined;
+        if (!alreadySpecified) {
+            if (process.stdout.isTTY) {
+                argv.web = true;
+            }
+            else {
+                argv.json = true;
+            }
+        }
+        return true;
+    })
+        .example('$0 show project my-app', 'View project information for my-app in JSON format')
+        .example('$0 show project my-app --web', 'View project information for my-app in the browser')
+        .example('$0 show project', 'View project information for the project in the current working directory'),
+    handler: async (args) => {
+        const exitCode = await (0, handle_errors_1.handleErrors)(args.verbose, async () => {
+            const { showProjectHandler } = await Promise.resolve().then(() => require('./project'));
+            await showProjectHandler(args);
+        });
+        process.exit(exitCode);
+    },
+};

package/src/command-line/show/project.d.ts

@@ -0,0 +1,3 @@
+import { ShowProjectOptions } from './command-object';
+export declare function showProjectHandler(args: ShowProjectOptions): Promise<void>;
+//# sourceMappingURL=project.d.ts.map

package/src/command-line/show/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/show/project.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAOtD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAqHf"}

package/src/command-line/show/project.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showProjectHandler = showProjectHandler;
+const output_1 = require("../../utils/output");
+const project_graph_1 = require("../../project-graph/project-graph");
+const graph_1 = require("../graph/graph");
+const find_matching_projects_1 = require("../../utils/find-matching-projects");
+const workspace_root_1 = require("../../utils/workspace-root");
+const configuration_1 = require("../../config/configuration");
+const calculate_default_project_name_1 = require("../../config/calculate-default-project-name");
+async function showProjectHandler(args) {
+    performance.mark('code-loading:end');
+    performance.measure('code-loading', 'init-local', 'code-loading:end');
+    const graph = await (0, project_graph_1.createProjectGraphAsync)();
+    let projectName = args.projectName;
+    // If no project name is provided, try to infer from cwd
+    if (!projectName) {
+        const nxJson = (0, configuration_1.readNxJson)();
+        projectName = (0, calculate_default_project_name_1.calculateDefaultProjectName)(process.cwd(), workspace_root_1.workspaceRoot, (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(graph), nxJson);
+        if (!projectName) {
+            output_1.output.error({
+                title: 'Could not find a project in the current working directory.',
+                bodyLines: [
+                    `Please specify a project name using:`,
+                    `  nx show project <project-name>`,
+                    ``,
+                    `Or run this command from within a project directory.`,
+                ],
+            });
+            process.exit(1);
+        }
+    }
+    let node = graph.nodes[projectName];
+    if (!node) {
+        const projects = (0, find_matching_projects_1.findMatchingProjects)([projectName], graph.nodes);
+        if (projects.length === 1) {
+            const matchedProjectName = projects[0];
+            node = graph.nodes[matchedProjectName];
+        }
+        else if (projects.length > 1) {
+            output_1.output.error({
+                title: `Multiple projects matched:`,
+                bodyLines: projects.length > 100 ? [...projects.slice(0, 100), '...'] : projects,
+            });
+            console.log(`Multiple projects matched:\n  ${(projects.length > 100
+                ? [...projects.slice(0, 100), '...']
+                : projects).join('  \n')}`);
+            process.exit(1);
+        }
+        else {
+            console.log(`Could not find project ${projectName}`);
+            process.exit(1);
+        }
+    }
+    if (args.json) {
+        console.log(JSON.stringify(node.data));
+    }
+    else if (args.web) {
+        await (0, graph_1.generateGraph)({
+            view: 'project-details',
+            focus: node.name,
+            watch: true,
+            open: args.open ?? true,
+        }, []);
+    }
+    else {
+        const pc = require('picocolors');
+        const logIfExists = (label, key) => {
+            if (node.data[key]) {
+                console.log(`${pc.bold(label)}: ${node.data[key]}`);
+            }
+        };
+        logIfExists('Name', 'name');
+        logIfExists('Root', 'root');
+        logIfExists('Source Root', 'sourceRoot');
+        logIfExists('Tags', 'tags');
+        logIfExists('Implicit Dependencies', 'implicitDependencies');
+        const targets = Object.entries(node.data.targets ?? {});
+        const maxTargetNameLength = Math.max(...targets.map(([t]) => t.length));
+        const maxExecutorNameLength = Math.max(...targets.map(([, t]) => t?.executor?.length ?? 0));
+        if (targets.length > 0) {
+            console.log(`${pc.bold('Targets')}: `);
+            for (const [target, targetConfig] of targets) {
+                const executorCommandText = targetConfig.metadata?.scriptContent ??
+                    targetConfig?.options?.command ??
+                    (targetConfig?.options?.commands?.length === 1
+                        ? targetConfig.options.commands[0]
+                        : targetConfig?.executor) ??
+                    '';
+                console.log(`- ${pc.bold((target + ':').padEnd(maxTargetNameLength + 2))} ${executorCommandText.padEnd(maxExecutorNameLength + 2)} ${(() => {
+                    const configurations = Object.keys(targetConfig.configurations ?? {});
+                    if (configurations.length) {
+                        return pc.dim(configurations.join(', '));
+                    }
+                    return '';
+                })()}`);
+            }
+        }
+    }
+    // TODO: Find a better fix for this
+    await new Promise((res) => setImmediate(res));
+    await output_1.output.drain();
+}

package/src/command-line/show/projects.d.ts

@@ -0,0 +1,3 @@
+import { ShowProjectsOptions } from './command-object';
+export declare function showProjectsHandler(args: ShowProjectsOptions): Promise<void>;
+//# sourceMappingURL=projects.d.ts.map

package/src/command-line/show/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/show/projects.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAoEf"}

package/src/command-line/show/projects.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showProjectsHandler = showProjectsHandler;
+const output_1 = require("../../utils/output");
+const nx_json_1 = require("../../config/nx-json");
+const affected_project_graph_1 = require("../../project-graph/affected/affected-project-graph");
+const file_utils_1 = require("../../project-graph/file-utils");
+const operators_1 = require("../../project-graph/operators");
+const project_graph_1 = require("../../project-graph/project-graph");
+const command_line_utils_1 = require("../../utils/command-line-utils");
+const find_matching_projects_1 = require("../../utils/find-matching-projects");
+async function showProjectsHandler(args) {
+    performance.mark('code-loading:end');
+    performance.measure('code-loading', 'init-local', 'code-loading:end');
+    let graph = await (0, project_graph_1.createProjectGraphAsync)();
+    const nxJson = (0, nx_json_1.readNxJson)();
+    const { nxArgs } = (0, command_line_utils_1.splitArgsIntoNxArgsAndOverrides)(args, 'affected', {
+        printWarnings: false,
+    }, nxJson);
+    // Affected touches dependencies so it needs to be processed first.
+    if (args.affected) {
+        const touchedFiles = await getTouchedFiles(nxArgs);
+        graph = await getAffectedGraph(touchedFiles, nxJson, graph);
+    }
+    const filter = (0, operators_1.filterNodes)((node) => {
+        if (args.type && node.type !== args.type) {
+            return false;
+        }
+        return true;
+    });
+    graph = filter(graph);
+    // Apply projects filter and get resultant graph
+    if (args.projects) {
+        graph.nodes = getGraphNodesMatchingPatterns(graph, args.projects);
+    }
+    // Grab only the nodes with the specified target
+    if (args.withTarget) {
+        graph.nodes = Object.entries(graph.nodes).reduce((acc, [name, node]) => {
+            if (args.withTarget.some((target) => node.data.targets?.[target])) {
+                acc[name] = node;
+            }
+            return acc;
+        }, {});
+    }
+    const selectedProjects = new Set(Object.keys(graph.nodes));
+    if (args.exclude) {
+        const excludedProjects = (0, find_matching_projects_1.findMatchingProjects)(nxArgs.exclude, graph.nodes);
+        for (const excludedProject of excludedProjects) {
+            selectedProjects.delete(excludedProject);
+        }
+    }
+    if (args.json) {
+        console.log(JSON.stringify(Array.from(selectedProjects)));
+    }
+    else if (args.sep) {
+        console.log(Array.from(selectedProjects.values()).join(args.sep));
+    }
+    else {
+        for (const project of selectedProjects) {
+            console.log(project);
+        }
+    }
+    // TODO: Find a better fix for this
+    await new Promise((res) => setImmediate(res));
+    await output_1.output.drain();
+}
+function getGraphNodesMatchingPatterns(graph, patterns) {
+    const nodes = {};
+    const matches = (0, find_matching_projects_1.findMatchingProjects)(patterns, graph.nodes);
+    for (const match of matches) {
+        nodes[match] = graph.nodes[match];
+    }
+    return nodes;
+}
+function getAffectedGraph(touchedFiles, nxJson, graph) {
+    return (0, affected_project_graph_1.filterAffected)(graph, touchedFiles, nxJson);
+}
+async function getTouchedFiles(nxArgs) {
+    return (0, file_utils_1.calculateFileChanges)((0, command_line_utils_1.parseFiles)(nxArgs).files, nxArgs);
+}

package/src/command-line/sync/command-object.d.ts

@@ -0,0 +1,7 @@
+import type { CommandModule } from 'yargs';
+export interface SyncArgs {
+    verbose?: boolean;
+}
+export declare const yargsSyncCommand: CommandModule<Record<string, unknown>, SyncArgs>;
+export declare const yargsSyncCheckCommand: CommandModule<Record<string, unknown>, SyncArgs>;
+//# sourceMappingURL=command-object.d.ts.map

package/src/command-line/sync/command-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/sync/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,QAAQ,CAQT,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,QAAQ,CAaT,CAAC"}

package/src/command-line/sync/command-object.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsSyncCheckCommand = exports.yargsSyncCommand = void 0;
+const shared_options_1 = require("../yargs-utils/shared-options");
+exports.yargsSyncCommand = {
+    command: 'sync',
+    describe: 'Sync the workspace files by running all the sync generators.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)(yargs),
+    handler: async (args) => {
+        process.exit(await Promise.resolve().then(() => require('./sync')).then((m) => m.syncHandler(args)));
+    },
+};
+exports.yargsSyncCheckCommand = {
+    command: 'sync:check',
+    describe: 'Check that no changes are required after running all sync generators.',
+    builder: (yargs) => (0, shared_options_1.withVerbose)(yargs),
+    handler: async (args) => {
+        process.exit(await Promise.resolve().then(() => require('./sync')).then((m) => m.syncHandler({ ...args, check: true })));
+    },
+};

package/src/command-line/sync/sync.d.ts

@@ -0,0 +1,7 @@
+import type { SyncArgs } from './command-object';
+interface SyncOptions extends SyncArgs {
+    check?: boolean;
+}
+export declare function syncHandler(options: SyncOptions): Promise<number>;
+export {};
+//# sourceMappingURL=sync.d.ts.map

package/src/command-line/sync/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/sync/sync.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,UAAU,WAAY,SAAQ,QAAQ;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAwJjE"}

package/src/command-line/sync/sync.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncHandler = syncHandler;
+const nx_json_1 = require("../../config/nx-json");
+const project_graph_1 = require("../../project-graph/project-graph");
+const output_1 = require("../../utils/output");
+const handle_errors_1 = require("../../utils/handle-errors");
+const sync_generators_1 = require("../../utils/sync-generators");
+const pc = require("picocolors");
+const spinner_1 = require("../../utils/spinner");
+function syncHandler(options) {
+    return (0, handle_errors_1.handleErrors)(options.verbose, async () => {
+        const projectGraph = await (0, project_graph_1.createProjectGraphAsync)();
+        const nxJson = (0, nx_json_1.readNxJson)();
+        const { globalGenerators, taskGenerators } = await (0, sync_generators_1.collectAllRegisteredSyncGenerators)(projectGraph, nxJson);
+        if (!globalGenerators.length && !taskGenerators.length) {
+            output_1.output.success({
+                title: options.check
+                    ? 'The workspace is up to date'
+                    : 'The workspace is already up to date',
+                bodyLines: ['There are no sync generators to run.'],
+            });
+            return 0;
+        }
+        const syncGenerators = Array.from(new Set([...globalGenerators, ...taskGenerators]));
+        const results = await (0, sync_generators_1.getSyncGeneratorChanges)(syncGenerators);
+        if (!results.length) {
+            output_1.output.success({
+                title: options.check
+                    ? 'The workspace is up to date'
+                    : 'The workspace is already up to date',
+                bodyLines: syncGenerators.map((generator) => `[${pc.bold(generator)}]: All files are up to date.`),
+            });
+            return 0;
+        }
+        const { failedGeneratorsCount, areAllResultsFailures, anySyncGeneratorsFailed, } = (0, sync_generators_1.processSyncGeneratorResultErrors)(results);
+        const failedSyncGeneratorsFixMessageLines = (0, sync_generators_1.getFailedSyncGeneratorsFixMessageLines)(results, options.verbose, new Set(globalGenerators));
+        if (areAllResultsFailures) {
+            output_1.output.error({
+                title: `The workspace is probably out of sync because ${failedGeneratorsCount === 1
+                    ? 'a sync generator'
+                    : 'some sync generators'} failed to run`,
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+            return 1;
+        }
+        const resultBodyLines = (0, sync_generators_1.getSyncGeneratorSuccessResultsMessageLines)(results, 
+        // log the out of sync details if the user is running `nx sync --check`
+        options.check);
+        if (options.check) {
+            output_1.output.error({
+                title: 'The workspace is out of sync',
+                bodyLines: [
+                    ...resultBodyLines,
+                    '',
+                    'Run `nx sync` to sync the workspace.',
+                ],
+            });
+            if (anySyncGeneratorsFailed) {
+                output_1.output.error({
+                    title: failedGeneratorsCount === 1
+                        ? 'A sync generator failed to run'
+                        : 'Some sync generators failed to run',
+                    bodyLines: failedSyncGeneratorsFixMessageLines,
+                });
+            }
+            return 1;
+        }
+        output_1.output.warn({
+            title: 'The workspace is out of sync',
+            bodyLines: resultBodyLines,
+        });
+        const spinner = spinner_1.globalSpinner.start('Syncing the workspace...');
+        try {
+            const flushResult = await (0, sync_generators_1.flushSyncGeneratorChanges)(results);
+            if ('generatorFailures' in flushResult) {
+                spinner.fail();
+                output_1.output.error({
+                    title: 'Failed to sync the workspace',
+                    bodyLines: (0, sync_generators_1.getFlushFailureMessageLines)(flushResult, options.verbose, new Set(globalGenerators)),
+                });
+                return 1;
+            }
+        }
+        catch (e) {
+            spinner.fail();
+            output_1.output.error({
+                title: 'Failed to sync the workspace',
+                bodyLines: [
+                    'Syncing the workspace failed with the following error:',
+                    '',
+                    e.message,
+                    ...(!!e.stack ? [`\n${e.stack}`] : []),
+                    '',
+                    'Please report the error at: https://github.com/nrwl/nx/issues/new/choose',
+                ],
+            });
+            return 1;
+        }
+        const successTitle = anySyncGeneratorsFailed
+            ? // the identified changes were synced successfully, but the workspace
+                // is still not up to date, which we'll mention next
+                'The identified changes were synced successfully!'
+            : // the workspace is fully up to date
+                'The workspace was synced successfully!';
+        const successSubtitle = 'Please make sure to commit the changes to your repository.';
+        spinner.succeed(`${successTitle}\n\n${successSubtitle}`);
+        if (anySyncGeneratorsFailed) {
+            output_1.output.error({
+                title: `The workspace is probably still out of sync because ${failedGeneratorsCount === 1
+                    ? 'a sync generator'
+                    : 'some sync generators'} failed to run`,
+                bodyLines: failedSyncGeneratorsFixMessageLines,
+            });
+            return 1;
+        }
+        return 0;
+    });
+}

package/src/command-line/watch/command-object.d.ts

@@ -0,0 +1,3 @@
+import { CommandModule } from 'yargs';
+export declare const yargsWatchCommand: CommandModule;
+//# sourceMappingURL=command-object.d.ts.map

package/src/command-line/watch/command-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/watch/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,aAAa,EAAE,MAAM,OAAO,CAAC;AAK5C,eAAO,MAAM,iBAAiB,EAAE,aAO/B,CAAC"}

package/src/command-line/watch/command-object.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yargsWatchCommand = void 0;
+const documentation_1 = require("../yargs-utils/documentation");
+const shared_options_1 = require("../yargs-utils/shared-options");
+exports.yargsWatchCommand = {
+    command: 'watch',
+    describe: 'Watch for changes within projects, and execute commands.',
+    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withWatchOptions(yargs), 'watch'),
+    handler: async (args) => {
+        await Promise.resolve().then(() => require('./watch')).then((m) => m.watch(args));
+    },
+};
+function withWatchOptions(yargs) {
+    return (0, shared_options_1.withVerbose)(yargs)
+        .parserConfiguration({
+        'strip-dashed': true,
+        'populate--': true,
+    })
+        .option('projects', {
+        type: 'string',
+        alias: 'p',
+        coerce: shared_options_1.parseCSV,
+        description: 'Projects to watch (comma/space delimited).',
+    })
+        .option('all', {
+        type: 'boolean',
+        description: 'Watch all projects.',
+    })
+        .option('includeDependentProjects', {
+        type: 'boolean',
+        description: 'When watching selected projects, include dependent projects as well.',
+        alias: 'd',
+    })
+        .option('includeGlobalWorkspaceFiles', {
+        type: 'boolean',
+        description: 'Include global workspace files that are not part of a project. For example, the root eslint, or tsconfig file.',
+        alias: 'g',
+        hidden: true,
+    })
+        .option('command', { type: 'string', hidden: true })
+        .option('verbose', {
+        type: 'boolean',
+        description: 'Run watch mode in verbose mode, where commands are logged before execution.',
+    })
+        .option('initialRun', {
+        type: 'boolean',
+        description: 'Run the command once before watching for changes.',
+        alias: 'i',
+        default: false,
+    })
+        .conflicts({
+        all: 'projects',
+    })
+        .check((args) => {
+        if (!args.all && !args.projects) {
+            throw Error('Please specify either --all or --projects');
+        }
+        return true;
+    })
+        .middleware((args) => {
+        const { '--': doubledash } = args;
+        if (doubledash && Array.isArray(doubledash)) {
+            args.command = doubledash.join(' ');
+        }
+        else {
+            throw Error('No command specified for watch mode.');
+        }
+    }, true);
+}

package/src/command-line/watch/watch.d.ts

@@ -0,0 +1,25 @@
+import { ChangedFile } from '../../daemon/client/client';
+export interface WatchArguments {
+    projects?: string[];
+    all?: boolean;
+    includeDependentProjects?: boolean;
+    includeGlobalWorkspaceFiles?: boolean;
+    verbose?: boolean;
+    command?: string;
+    initialRun?: boolean;
+    projectNameEnvName?: string;
+    fileChangesEnvName?: string;
+}
+export declare class BatchFunctionRunner {
+    private callback;
+    private running;
+    private pendingProjects;
+    private pendingFiles;
+    protected get _verbose(): boolean;
+    private get hasPending();
+    constructor(callback: (projects: Set<string>, files: Set<string>) => Promise<unknown>);
+    enqueue(projectNames: string[], fileChanges: ChangedFile[]): Promise<void>;
+    private process;
+}
+export declare function watch(args: WatchArguments): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

package/src/command-line/watch/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/watch/watch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,MAAM,4BAA4B,CAAC;AAIvE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAKD,qBAAa,mBAAmB;IAe5B,OAAO,CAAC,QAAQ;IAdlB,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,YAAY,CAAqB;IAEzC,SAAS,KAAK,QAAQ,YAErB;IAED,OAAO,KAAK,UAAU,GAErB;gBAGS,QAAQ,EAAE,CAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KACf,OAAO,CAAC,OAAO,CAAC;IAGvB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;YAW5C,OAAO;CA0BtB;AA2ED,wBAAsB,KAAK,CAAC,IAAI,EAAE,cAAc,iBAoG/C"}