@ohos-ports/nx 23.2.0-beta.0 → 23.2.1-beta.0

package/dist/src/command-line/yargs-utils/shared-options.js

@@ -1,397 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultYargsParserConfiguration = void 0;
-exports.withExcludeOption = withExcludeOption;
-exports.withTuiOptions = withTuiOptions;
-exports.withRunOptions = withRunOptions;
-exports.withTargetAndConfigurationOption = withTargetAndConfigurationOption;
-exports.withConfiguration = withConfiguration;
-exports.withVerbose = withVerbose;
-exports.withBatch = withBatch;
-exports.withAffectedOptions = withAffectedOptions;
-exports.withRunManyOptions = withRunManyOptions;
-exports.withOverrides = withOverrides;
-exports.withOutputStyleOption = withOutputStyleOption;
-exports.withRunOneOptions = withRunOneOptions;
-exports.parseNewlines = parseNewlines;
-exports.parseCSV = parseCSV;
-exports.readParallelFromArgsAndEnv = readParallelFromArgsAndEnv;
-const nx_json_1 = require("../../config/nx-json");
-const is_tui_enabled_1 = require("../../tasks-runner/is-tui-enabled");
-const node_os_1 = require("node:os");
-exports.defaultYargsParserConfiguration = {
-    'strip-dashed': true,
-    'unknown-options-as-args': true,
-    'populate--': true,
-    'parse-numbers': false,
-    'parse-positional-numbers': false,
-};
-function withExcludeOption(yargs) {
-    return yargs.option('exclude', {
-        describe: 'Exclude certain projects from being processed.',
-        type: 'string',
-        coerce: parseCSV,
-    });
-}
-function withTuiOptions(yargs) {
-    return yargs
-        .options('tuiAutoExit', {
-        describe: 'Whether or not to exit the TUI automatically after all tasks finish, and after how long. If set to `true`, the TUI will exit immediately. If set to `false` the TUI will not automatically exit. If set to a number, an interruptible countdown popup will be shown for that many seconds before the TUI exits.',
-        type: 'string',
-        coerce: (v) => coerceTuiAutoExit(v),
-    })
-        .option('tui', {
-        describe: 'Enable or disable the Nx Terminal UI.',
-        type: 'boolean',
-        conflicts: 'outputStyle',
-    })
-        .middleware((args) => {
-        if (args.tuiAutoExit !== undefined) {
-            process.env.NX_TUI_AUTO_EXIT = args.tuiAutoExit.toString();
-        }
-        else if (process.env.NX_TUI_AUTO_EXIT) {
-            args.tuiAutoExit = coerceTuiAutoExit(process.env.NX_TUI_AUTO_EXIT
-            // have to cast here because yarg's typings do not account for the
-            // coercion function
-            );
-        }
-    });
-}
-function withRunOptions(yargs) {
-    return withVerbose(withExcludeOption(yargs))
-        .option('parallel', {
-        describe: 'Max number of parallel processes [default is 3].',
-        type: 'string',
-    })
-        .option('maxParallel', {
-        type: 'number',
-        hidden: true,
-    })
-        .options('runner', {
-        describe: 'This is the name of the tasks runner configured in nx.json.',
-        type: 'string',
-    })
-        .option('prod', {
-        describe: 'Use the production configuration.',
-        type: 'boolean',
-        default: false,
-        hidden: true,
-    })
-        .option('graph', {
-        type: 'string',
-        describe: 'Show the task graph of the command. Pass a file path to save the graph data instead of viewing it in the browser. Pass "stdout" to print the results to the terminal.',
-        coerce: (value) => 
-        // when the type of an opt is "string", passing `--opt` comes through as having an empty string value.
-        // this coercion allows `--graph` to be passed through as a boolean directly, and also normalizes the
-        // `--graph=true` to produce the same behaviour as `--graph`.
-        value === '' || value === 'true' || value === true
-            ? true
-            : value === 'false' || value === false
-                ? false
-                : value,
-    })
-        .option('nxBail', {
-        describe: 'Stop command execution after the first failed task.',
-        type: 'boolean',
-    })
-        .middleware((args) => {
-        if (args.nxBail === undefined) {
-            args.nxBail = process.env.NX_BAIL === 'true';
-        }
-    })
-        .option('nxIgnoreCycles', {
-        describe: 'Ignore cycles in the task graph.',
-        type: 'boolean',
-        default: false,
-    })
-        .options('skipNxCache', {
-        describe: 'Rerun the tasks even when the results are available in the cache.',
-        type: 'boolean',
-        default: false,
-        alias: 'disableNxCache',
-    })
-        .options('skipRemoteCache', {
-        type: 'boolean',
-        describe: 'Disables the remote cache.',
-        default: false,
-        alias: 'disableRemoteCache',
-    })
-        .options('excludeTaskDependencies', {
-        describe: 'Skips running dependent tasks first.',
-        type: 'boolean',
-        default: false,
-    })
-        .option('skipSync', {
-        describe: 'Skips running the sync generators associated with the tasks.',
-        type: 'boolean',
-        default: false,
-    })
-        .options('cloud', {
-        type: 'boolean',
-        hidden: true,
-    })
-        .options('dte', {
-        type: 'boolean',
-        hidden: true,
-    })
-        .options('useAgents', {
-        type: 'boolean',
-        hidden: true,
-        alias: 'agents',
-    });
-}
-function withTargetAndConfigurationOption(yargs, demandOption = true) {
-    return withConfiguration(yargs).option('targets', {
-        describe: 'Tasks to run for affected projects.',
-        type: 'string',
-        alias: ['target', 't'],
-        requiresArg: true,
-        coerce: parseCSV,
-        demandOption,
-        global: false,
-    });
-}
-function withConfiguration(yargs) {
-    return yargs.options('configuration', {
-        describe: 'This is the configuration to use when performing tasks on projects.',
-        type: 'string',
-        alias: 'c',
-    });
-}
-function withVerbose(yargs) {
-    return yargs
-        .option('verbose', {
-        describe: 'Prints additional information about the commands (e.g., stack traces).',
-        type: 'boolean',
-    })
-        .middleware((args) => {
-        args.verbose ??= process.env.NX_VERBOSE_LOGGING === 'true';
-        // If NX_VERBOSE_LOGGING=false and --verbose is passed, we want to set it to true favoring the arg
-        process.env.NX_VERBOSE_LOGGING = args.verbose.toString();
-    });
-}
-function withBatch(yargs) {
-    return yargs.options('batch', {
-        type: 'boolean',
-        describe: 'Run task(s) in batches for executors which support batches.',
-        coerce: (v) => {
-            if (v !== undefined)
-                return v;
-            if (process.env.NX_BATCH_MODE === 'true')
-                return true;
-            return undefined; // Let preferBatch decide
-        },
-        default: undefined,
-    });
-}
-function withAffectedOptions(yargs) {
-    return withExcludeOption(yargs)
-        .parserConfiguration(exports.defaultYargsParserConfiguration)
-        .option('files', {
-        describe: 'Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces.',
-        type: 'string',
-        requiresArg: true,
-        coerce: parseCSV,
-    })
-        .option('stdin', {
-        describe: 'Change the way Nx is calculating the affected command by providing directly changed files from stdin, one file per line.',
-        type: 'boolean',
-    })
-        .option('uncommitted', {
-        describe: 'Uncommitted changes.',
-        type: 'boolean',
-    })
-        .option('untracked', {
-        describe: 'Untracked changes.',
-        type: 'boolean',
-    })
-        .option('base', {
-        describe: 'Base of the current branch (usually main).',
-        type: 'string',
-        requiresArg: true,
-    })
-        .option('head', {
-        describe: 'Latest commit of the current branch (usually HEAD).',
-        type: 'string',
-        requiresArg: true,
-    })
-        .group(['base'], 'Run command using --base=[SHA1] (affected by the committed, uncommitted and untracked changes):')
-        .group(['base', 'head'], 'or using --base=[SHA1] --head=[SHA2] (affected by the committed changes):')
-        .group(['files', 'uncommitted', 'untracked'], 'or using:')
-        .implies('head', 'base')
-        .conflicts({
-        files: ['uncommitted', 'untracked', 'base', 'head'],
-        stdin: ['uncommitted', 'untracked', 'base', 'head'],
-        untracked: ['uncommitted', 'files', 'base', 'head'],
-        uncommitted: ['files', 'untracked', 'base', 'head'],
-    })
-        .middleware(async (args) => {
-        if (args.stdin) {
-            if (process.stdin.isTTY) {
-                throw new Error('The --stdin option requires piped input (e.g., `git diff --name-only | nx affected --stdin`). It cannot be used when stdin is a terminal.');
-            }
-            const chunks = [];
-            for await (const chunk of process.stdin) {
-                chunks.push(chunk);
-            }
-            const files = parseNewlines(Buffer.concat(chunks).toString());
-            if (Array.isArray(args.files))
-                files.push(...args.files);
-            else if (typeof args.files === 'string')
-                files.push(args.files);
-            args.files = files; // Yargs types don't reflect the coerce option
-        }
-    }, true);
-}
-function withRunManyOptions(yargs) {
-    return withRunOptions(yargs)
-        .parserConfiguration(exports.defaultYargsParserConfiguration)
-        .option('projects', {
-        type: 'string',
-        alias: 'p',
-        coerce: parseCSV,
-        describe: 'Projects to run. (comma/space delimited project names and/or patterns).',
-    })
-        .option('all', {
-        describe: '[deprecated] `run-many` runs all targets on all projects in the workspace if no projects are provided. This option is no longer required.',
-        type: 'boolean',
-        default: true,
-    });
-}
-function withOverrides(args, commandLevel = 1) {
-    const unparsedArgs = (args['--'] ?? args._.slice(commandLevel)).map((v) => v.toString());
-    delete args['--'];
-    delete args._;
-    return {
-        ...args,
-        __overrides_unparsed__: unparsedArgs,
-    };
-}
-const allOutputStyles = [
-    'tui',
-    'dynamic',
-    'dynamic-legacy',
-    'static',
-    'static-failures-only',
-    'stream',
-    'stream-without-prefixes',
-];
-function withOutputStyleOption(yargs, choices = [
-    'dynamic-legacy',
-    'dynamic',
-    'tui',
-    'static',
-    'static-failures-only',
-    'stream',
-    'stream-without-prefixes',
-]) {
-    return yargs
-        .option('outputStyle', {
-        describe: `Defines how Nx emits outputs tasks logs. **tui**: enables the Nx Terminal UI, recommended for local development environments. **dynamic-legacy**: use dynamic-legacy output life cycle, previous content is overwritten or modified as new outputs are added, display minimal logs by default, always show errors. This output format is recommended for local development environments where tui is not supported. **static**: uses static output life cycle, no previous content is rewritten or modified as new outputs are added, and every task prints its full output regardless of status. **static-failures-only**: same as **static**, but successful and cached tasks collapse to a single line, so only failing tasks (and, for a single-project run, the project you asked for) print their full output. This is what Nx uses by default in CI and other non-interactive environments. **stream**: nx by default logs output to an internal output stream, enable this option to stream logs to stdout / stderr. **stream-without-prefixes**: nx prefixes the project name the target is running on, use this option remove the project name prefix from output.`,
-        type: 'string',
-        choices,
-    })
-        .middleware([
-        (args) => {
-            if (!args.outputStyle &&
-                process.env.NX_DEFAULT_OUTPUT_STYLE &&
-                choices.includes(process.env.NX_DEFAULT_OUTPUT_STYLE)) {
-                args.outputStyle = process.env.NX_DEFAULT_OUTPUT_STYLE;
-            }
-        },
-        (args) => {
-            const useTui = (0, is_tui_enabled_1.shouldUseTui)((0, nx_json_1.readNxJson)(), args);
-            if (useTui) {
-                // We have to set both of these because `check` runs after the normalization that
-                // handles the kebab-case'd args -> camelCase'd args translation.
-                args['output-style'] = 'tui';
-                args.outputStyle = 'tui';
-            }
-            process.env.NX_TUI = useTui.toString();
-        },
-    ]);
-}
-function withRunOneOptions(yargs) {
-    const executorShouldShowHelp = !(process.argv[2] === 'run' && process.argv[3] === '--help');
-    const res = withRunOptions(withOutputStyleOption(withConfiguration(yargs), allOutputStyles))
-        .parserConfiguration(exports.defaultYargsParserConfiguration)
-        .option('project', {
-        describe: 'Target project.',
-        type: 'string',
-        alias: 'p',
-    })
-        .option('target', {
-        describe: 'Target to run. Useful when the target name contains a colon, which conflicts with the positional `project:target:configuration` form.',
-        type: 'string',
-        alias: 't',
-        requiresArg: true,
-    })
-        .option('help', {
-        describe: 'Show Help.',
-        type: 'boolean',
-    });
-    if (executorShouldShowHelp) {
-        return res.help(false);
-    }
-    else {
-        return res.epilog(`Run "nx run myapp:mytarget --help" to see information about the executor's schema.`);
-    }
-}
-function parseNewlines(input) {
-    if (!input) {
-        return [];
-    }
-    return input.split('\n').filter((line) => line.length > 0);
-}
-function parseCSV(args) {
-    if (!args) {
-        return [];
-    }
-    if (Array.isArray(args)) {
-        // If parseCSV is used on `type: 'array'`, the first option may be something like ['a,b,c'].
-        return args.length === 1 && args[0].includes(',')
-            ? parseCSV(args[0])
-            : args;
-    }
-    const items = args.split(',');
-    return items.map((i) => i.startsWith('"') && i.endsWith('"') ? i.slice(1, -1) : i);
-}
-function readParallelFromArgsAndEnv(args) {
-    if (args['parallel'] === 'false' || args['parallel'] === false) {
-        return 1;
-    }
-    else if (args['parallel'] === 'true' ||
-        args['parallel'] === true ||
-        args['parallel'] === '' ||
-        // don't require passing --parallel if NX_PARALLEL is set, but allow overriding it
-        (process.env.NX_PARALLEL && args['parallel'] === undefined)) {
-        return concurrency(args['maxParallel'] ||
-            args['max-parallel'] ||
-            process.env.NX_PARALLEL ||
-            '3');
-    }
-    else if (args['parallel'] !== undefined) {
-        return concurrency(args['parallel']);
-    }
-}
-const coerceTuiAutoExit = (value) => {
-    if (value === 'true') {
-        return true;
-    }
-    if (value === 'false') {
-        return false;
-    }
-    const num = Number(value);
-    if (!Number.isNaN(num)) {
-        return num;
-    }
-    throw new Error(`Invalid value for --tui-auto-exit: ${value}`);
-};
-function concurrency(val) {
-    let parallel = typeof val === 'number' ? val : parseInt(val);
-    if (typeof val === 'string' && val.at(-1) === '%') {
-        const maxCores = (0, node_os_1.availableParallelism)?.() ?? (0, node_os_1.cpus)().length;
-        parallel = (maxCores * parallel) / 100;
-    }
-    return Math.max(1, Math.floor(parallel));
-}

package/dist/src/commands-runner/command-graph.d.ts

@@ -1,13 +0,0 @@
-/**
- * Graph of Tasks to be executed
- */
-export interface CommandGraph {
-    /**
-     * Projects that do not have any dependencies and are thus ready to execute immediately
-     */
-    roots: string[];
-    /**
-     * Map of projects to projects which the task depends on
-     */
-    dependencies: Record<string, string[]>;
-}

package/dist/src/commands-runner/command-graph.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/commands-runner/create-command-graph.d.ts

@@ -1,4 +0,0 @@
-import { ProjectGraph } from '../config/project-graph';
-import { NxArgs } from '../utils/command-line-utils';
-import { CommandGraph } from './command-graph';
-export declare function createCommandGraph(projectGraph: ProjectGraph, projectNames: string[], nxArgs: NxArgs): CommandGraph;

package/dist/src/commands-runner/create-command-graph.js

@@ -1,72 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCommandGraph = createCommandGraph;
-const task_graph_utils_1 = require("../tasks-runner/task-graph-utils");
-const output_1 = require("../utils/output");
-/**
- * Make structure { lib: [dep], dep: [dep1], dep1: [] } from projectName lib and projectGraph
- * @param projectGraph
- * @param projectName
- * @param resolved reference to an object that will contain resolved dependencies
- * @returns
- */
-const recursiveResolveDeps = (projectGraph, projectName, resolved) => {
-    if (projectGraph.dependencies[projectName].length === 0) {
-        // no deps - no resolve
-        resolved[projectName] = [];
-        return;
-    }
-    // if already resolved - just skip
-    if (resolved[projectName]) {
-        return resolved[projectName];
-    }
-    // deps string list
-    const projectDeps = [
-        ...new Set(projectGraph.dependencies[projectName]
-            .map((projectDep) => projectDep.target)
-            .filter((projectDep) => projectGraph.nodes[projectDep])).values(),
-    ];
-    // define
-    resolved[projectName] = projectDeps;
-    if (projectDeps.length > 0) {
-        for (const dep of projectDeps) {
-            recursiveResolveDeps(projectGraph, dep, resolved);
-        }
-    }
-};
-function createCommandGraph(projectGraph, projectNames, nxArgs) {
-    const dependencies = {};
-    if (!nxArgs.excludeTaskDependencies) {
-        for (const projectName of projectNames) {
-            recursiveResolveDeps(projectGraph, projectName, dependencies);
-        }
-    }
-    else {
-        for (const projectName of projectNames) {
-            dependencies[projectName] = [];
-        }
-    }
-    const roots = Object.keys(dependencies).filter((d) => dependencies[d].length === 0);
-    const commandGraph = {
-        dependencies,
-        roots,
-    };
-    const cycle = (0, task_graph_utils_1.findCycle)(commandGraph);
-    if (cycle) {
-        if (process.env.NX_IGNORE_CYCLES === 'true' || nxArgs.nxIgnoreCycles) {
-            output_1.output.warn({
-                title: `The command graph has a circular dependency`,
-                bodyLines: [`${cycle.join(' --> ')}`],
-            });
-            (0, task_graph_utils_1.makeAcyclic)(commandGraph);
-        }
-        else {
-            output_1.output.error({
-                title: `Could not execute command because the project graph has a circular dependency`,
-                bodyLines: [`${cycle.join(' --> ')}`],
-            });
-            process.exit(1);
-        }
-    }
-    return commandGraph;
-}

package/dist/src/commands-runner/get-command-projects.d.ts

@@ -1,3 +0,0 @@
-import { ProjectGraph, ProjectGraphProjectNode } from '../config/project-graph';
-import { NxArgs } from '../utils/command-line-utils';
-export declare function getCommandProjects(projectGraph: ProjectGraph, projects: ProjectGraphProjectNode[], nxArgs: NxArgs): string[];

package/dist/src/commands-runner/get-command-projects.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCommandProjects = getCommandProjects;
-const create_command_graph_1 = require("./create-command-graph");
-function getCommandProjects(projectGraph, projects, nxArgs) {
-    const commandGraph = (0, create_command_graph_1.createCommandGraph)(projectGraph, projects.map((project) => project.name), nxArgs);
-    return getSortedProjects(commandGraph);
-}
-function getSortedProjects(commandGraph, sortedProjects = []) {
-    const roots = commandGraph.roots;
-    if (!roots.length) {
-        return sortedProjects;
-    }
-    sortedProjects.push(...roots);
-    const newGraph = removeIdsFromGraph(commandGraph, roots, commandGraph.dependencies);
-    return getSortedProjects(newGraph, sortedProjects);
-}
-function removeIdsFromGraph(graph, ids, mapWithIds) {
-    const filteredMapWithIds = {};
-    const dependencies = {};
-    const removedSet = new Set(ids);
-    for (let id of Object.keys(mapWithIds)) {
-        if (!removedSet.has(id)) {
-            filteredMapWithIds[id] = mapWithIds[id];
-            dependencies[id] = graph.dependencies[id].filter((depId) => !removedSet.has(depId));
-        }
-    }
-    return {
-        mapWithIds: filteredMapWithIds,
-        dependencies: dependencies,
-        roots: Object.keys(dependencies).filter((k) => dependencies[k].length === 0),
-    };
-}

package/dist/src/config/calculate-default-project-name.d.ts

@@ -1,4 +0,0 @@
-import type { NxJsonConfiguration } from './nx-json';
-import { ProjectConfiguration, ProjectsConfigurations } from './workspace-json-project-json';
-export declare function calculateDefaultProjectName(cwd: string, root: string, { projects }: ProjectsConfigurations, nxJson: NxJsonConfiguration): string;
-export declare function findMatchingProjectInCwd(projects: Record<string, ProjectConfiguration>, relativeCwd: string): string | undefined;

package/dist/src/config/calculate-default-project-name.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateDefaultProjectName = calculateDefaultProjectName;
-exports.findMatchingProjectInCwd = findMatchingProjectInCwd;
-const find_project_for_path_1 = require("../project-graph/utils/find-project-for-path");
-const path_1 = require("path");
-function calculateDefaultProjectName(cwd, root, { projects }, nxJson) {
-    const relativeCwd = (0, path_1.relative)(root, cwd).replace(/\\/g, '/') ?? null;
-    if (relativeCwd !== null) {
-        const matchingProject = findMatchingProjectInCwd(projects, relativeCwd);
-        // We have found a project
-        if (matchingProject) {
-            // That is not at the root
-            if (projects[matchingProject].root !== '.' &&
-                projects[matchingProject].root !== '') {
-                return matchingProject;
-                // But its at the root, and NX_DEFAULT_PROJECT is set
-            }
-            else if (process.env.NX_DEFAULT_PROJECT) {
-                return process.env.NX_DEFAULT_PROJECT;
-                // Its root, and NX_DEFAULT_PROJECT is not set
-            }
-            else {
-                return matchingProject;
-            }
-        }
-    }
-    // There was no matching project in cwd.
-    return (process.env.NX_DEFAULT_PROJECT ??
-        nxJson.cli?.defaultProjectName ??
-        nxJson?.defaultProject);
-}
-function findMatchingProjectInCwd(projects, relativeCwd) {
-    const projectRootMappings = new Map();
-    for (const projectName of Object.keys(projects)) {
-        const { root } = projects[projectName];
-        projectRootMappings.set((0, find_project_for_path_1.normalizeProjectRoot)(root), projectName);
-    }
-    const matchingProject = (0, find_project_for_path_1.findProjectForPath)(relativeCwd, projectRootMappings);
-    return matchingProject;
-}

package/dist/src/config/configuration.d.ts

@@ -1,8 +0,0 @@
-/**
- * Returns information about where apps and libs will be created.
- */
-export declare function workspaceLayout(): {
-    appsDir: string;
-    libsDir: string;
-};
-export { readNxJson } from './nx-json';

package/dist/src/config/configuration.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readNxJson = void 0;
-exports.workspaceLayout = workspaceLayout;
-const nx_json_1 = require("./nx-json");
-/**
- * Returns information about where apps and libs will be created.
- */
-function workspaceLayout() {
-    const nxJson = (0, nx_json_1.readNxJson)();
-    return {
-        appsDir: nxJson.workspaceLayout?.appsDir ?? 'apps',
-        libsDir: nxJson.workspaceLayout?.libsDir ?? 'libs',
-    };
-}
-var nx_json_2 = require("./nx-json");
-Object.defineProperty(exports, "readNxJson", { enumerable: true, get: function () { return nx_json_2.readNxJson; } });