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

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

@@ -1,91 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsWatchCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-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 (0, handle_import_1.handleImport)('./watch.js', __dirname).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('includeDependencies', {
-        type: 'boolean',
-        description: 'When watching selected projects, also include the projects they depend on.',
-        alias: 'd',
-    })
-        // TODO(v24): remove the deprecated --includeDependentProjects alias
-        .option('includeDependentProjects', {
-        type: 'boolean',
-        hidden: true,
-        describe: "Deprecated in favor of --includeDependencies; will be removed in Nx 24. The flag name was misleading since it includes the watched project's dependencies, not its dependents. The new flag is functionally identical.",
-    })
-        .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.');
-        }
-        // --includeDependentProjects was renamed to --includeDependencies in
-        // Nx 23 because the original name was misleading: it includes the
-        // watched project's *dependencies*, not its dependents. The new flag
-        // is functionally identical — only the name changed. Map the legacy
-        // name through so existing scripts keep working during the
-        // deprecation window.
-        // TODO(v24): remove the legacy includeDependentProjects pass-through
-        const a = args;
-        if (a.includeDependentProjects !== undefined &&
-            a.includeDependencies === undefined) {
-            a.includeDependencies = a.includeDependentProjects;
-            // eslint-disable-next-line no-console
-            console.warn("--includeDependentProjects is deprecated in favor of --includeDependencies and will be removed in Nx 24. The flag name was misleading since it includes the watched project's dependencies, not its dependents. The new flag is functionally identical.");
-        }
-    }, true));
-}

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

@@ -1 +0,0 @@
-export {};

package/dist/src/command-line/watch/completion.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const metadata_1 = require("../completion/metadata");
-const completion_providers_1 = require("../completion/completion-providers");
-(0, metadata_1.registerCompletion)('watch', {
-    flags: {
-        projects: completion_providers_1.getProjectNameCompletions,
-        p: completion_providers_1.getProjectNameCompletions,
-    },
-});

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

@@ -1,31 +0,0 @@
-import { ChangedFile } from '../../daemon/client/client';
-export interface WatchArguments {
-    projects?: string[];
-    all?: boolean;
-    includeDependencies?: boolean;
-    /**
-     * @deprecated Renamed to {@link WatchArguments.includeDependencies}; will be
-     * removed in Nx 24. The original name was misleading: this flag includes
-     * the watched project's dependencies, not its dependents. The new property
-     * is functionally identical — only the name changed.
-     */
-    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>;

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

@@ -1,211 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BatchFunctionRunner = void 0;
-exports.watch = watch;
-const child_process_1 = require("child_process");
-const client_1 = require("../../daemon/client/client");
-const daemon_socket_messenger_1 = require("../../daemon/client/daemon-socket-messenger");
-const output_1 = require("../../utils/output");
-const DEFAULT_PROJECT_NAME_ENV = 'NX_PROJECT_NAME';
-const DEFAULT_FILE_CHANGES_ENV = 'NX_FILE_CHANGES';
-class BatchFunctionRunner {
-    get _verbose() {
-        return process.env.NX_VERBOSE_LOGGING === 'true';
-    }
-    get hasPending() {
-        return this.pendingProjects.size > 0 || this.pendingFiles.size > 0;
-    }
-    constructor(callback) {
-        this.callback = callback;
-        this.running = false;
-        this.pendingProjects = new Set();
-        this.pendingFiles = new Set();
-    }
-    enqueue(projectNames, fileChanges) {
-        projectNames.forEach((projectName) => {
-            this.pendingProjects.add(projectName);
-        });
-        fileChanges.forEach((fileChange) => {
-            this.pendingFiles.add(fileChange.path);
-        });
-        return this.process(true);
-    }
-    async process(runAnyway) {
-        if (!this.running && (this.hasPending || runAnyway)) {
-            this.running = true;
-            // Clone the pending projects and files before clearing
-            const projects = new Set(this.pendingProjects);
-            const files = new Set(this.pendingFiles);
-            // Clear the pending projects and files
-            this.pendingProjects.clear();
-            this.pendingFiles.clear();
-            return this.callback(projects, files).then(() => {
-                this.running = false;
-                this.process(false);
-            });
-        }
-        else {
-            this._verbose &&
-                this.running &&
-                output_1.output.logSingleLine('waiting for function to finish executing');
-            this._verbose &&
-                !this.hasPending &&
-                output_1.output.logSingleLine('no more function to process');
-        }
-    }
-}
-exports.BatchFunctionRunner = BatchFunctionRunner;
-class BatchCommandRunner extends BatchFunctionRunner {
-    constructor(command, projectNameEnv = DEFAULT_PROJECT_NAME_ENV, fileChangesEnv = DEFAULT_FILE_CHANGES_ENV) {
-        super((projects, files) => {
-            // process all pending commands together
-            const envs = this.createCommandEnvironments(projects, files);
-            return this.run(envs);
-        });
-        this.command = command;
-        this.projectNameEnv = projectNameEnv;
-        this.fileChangesEnv = fileChangesEnv;
-    }
-    createCommandEnvironments(projects, files) {
-        const commandsToRun = [];
-        if (projects.size > 0) {
-            projects.forEach((projectName) => {
-                commandsToRun.push({
-                    [this.projectNameEnv]: projectName,
-                    [this.fileChangesEnv]: Array.from(files).join(' '),
-                });
-            });
-        }
-        else {
-            commandsToRun.push({
-                [this.projectNameEnv]: '',
-                [this.fileChangesEnv]: Array.from(files).join(' '),
-            });
-        }
-        return commandsToRun;
-    }
-    async run(envs) {
-        this._verbose &&
-            output_1.output.logSingleLine('about to run commands with these environments: ' + JSON.stringify(envs));
-        return Promise.all(envs.map((env) => {
-            return new Promise((resolve, reject) => {
-                const commandExec = (0, child_process_1.spawn)(this.command, {
-                    stdio: 'inherit',
-                    shell: true,
-                    cwd: process.cwd(),
-                    env: {
-                        ...process.env,
-                        [this.projectNameEnv]: env[this.projectNameEnv],
-                        [this.fileChangesEnv]: env[this.fileChangesEnv],
-                    },
-                    windowsHide: true,
-                });
-                commandExec.on('close', () => {
-                    resolve();
-                });
-                commandExec.on('exit', () => {
-                    resolve();
-                });
-            });
-        })).then((r) => {
-            this._verbose &&
-                output_1.output.logSingleLine('running complete, processing the next batch');
-            return r;
-        });
-    }
-}
-async function watch(args) {
-    const projectReplacementRegex = new RegExp(args.projectNameEnvName ?? DEFAULT_PROJECT_NAME_ENV, 'g');
-    if (!client_1.daemonClient.enabled()) {
-        output_1.output.error({
-            title: 'Daemon is not running. The watch command is not supported without the Nx Daemon.',
-        });
-        process.exit(1);
-    }
-    if (args.includeGlobalWorkspaceFiles &&
-        args.command.match(projectReplacementRegex)) {
-        output_1.output.error({
-            title: 'Invalid command',
-            bodyLines: [
-                'The command you provided has a replacement for projects ($NX_PROJECT_NAME), but you are also including global workspace files.',
-                'You cannot use a replacement for projects when including global workspace files because there will be scenarios where there are file changes not associated with a project.',
-            ],
-        });
-        process.exit(1);
-    }
-    args.verbose &&
-        output_1.output.logSingleLine('running with args: ' + JSON.stringify(args));
-    args.verbose && output_1.output.logSingleLine('starting watch process');
-    const whatToWatch = args.all ? 'all' : args.projects;
-    const batchQueue = new BatchCommandRunner(args.command ?? '', args.projectNameEnvName, args.fileChangesEnvName);
-    // Run the command initially if requested
-    if (args.initialRun) {
-        args.verbose && output_1.output.logSingleLine('running command initially...');
-        const initialProjects = args.all
-            ? [] // When using --all, we don't need to pass specific projects
-            : args.projects || [];
-        // Execute the initial run
-        await batchQueue.enqueue(initialProjects, []);
-    }
-    await client_1.daemonClient.registerFileWatcher({
-        watchProjects: whatToWatch,
-        includeDependencies: args.includeDependencies ?? args.includeDependentProjects,
-        includeGlobalWorkspaceFiles: args.includeGlobalWorkspaceFiles,
-    }, async (err, data) => {
-        if (err === 'reconnecting') {
-            // Silent - daemon restarts automatically on lockfile changes
-            return;
-        }
-        else if (err === 'reconnected') {
-            // Silent - reconnection succeeded
-            return;
-        }
-        else if (err === 'closed') {
-            output_1.output.error({
-                title: 'Failed to reconnect to daemon after multiple attempts',
-                bodyLines: ['Please restart your watch command.'],
-            });
-            process.exit(1);
-        }
-        else if (err instanceof daemon_socket_messenger_1.VersionMismatchError) {
-            output_1.output.error({
-                title: 'Nx version changed. Please restart your command.',
-            });
-            process.exit(1);
-        }
-        else if (err instanceof client_1.WatcherFailedError) {
-            output_1.output.error({
-                title: 'The Nx Daemon stopped watching for file changes',
-                bodyLines: [
-                    err.message,
-                    'On Linux this is usually the inotify watch limit. See https://askubuntu.com/questions/1088272/inotify-add-watch-failed-no-space-left-on-device',
-                    'Please restart your watch command.',
-                ],
-            });
-            process.exit(1);
-        }
-        else if (err !== null) {
-            output_1.output.error({
-                title: 'Watch error',
-                bodyLines: [
-                    'An error occurred during the watch process:',
-                    err.message,
-                ],
-            });
-            // `data` is null on the error path; falling through dereferences it.
-            return;
-        }
-        // Only pass the projects to the queue if the command has a replacement for projects
-        if (args.command.match(projectReplacementRegex)) {
-            batchQueue.enqueue(data.changedProjects, data.changedFiles);
-        }
-        else {
-            batchQueue.enqueue([], data.changedFiles);
-        }
-    });
-    args.verbose && output_1.output.logSingleLine('watch process waiting...');
-    // Keep the process alive while watching for file changes
-    // The file watcher callbacks will handle incoming events
-    // The process will exit when Ctrl+C is pressed or if the connection closes
-    await new Promise(() => { });
-}

package/dist/src/command-line/yargs-utils/arguments-of.d.ts

@@ -1,11 +0,0 @@
-import type { Argv, CommandModule as YargsCommandModule } from 'yargs';
-export type Builder<InitialArgs, FinalArgs> = (yargs: Argv<InitialArgs>) => Argv<FinalArgs>;
-export type Handler<B extends Builder<any, any>> = (args: Awaited<ReturnType<B>['argv']>) => void | Promise<void>;
-export interface CommandModule<T, U> extends Omit<YargsCommandModule<T, U>, 'handler'> {
-    builder: Builder<T, U>;
-    handler: Handler<Builder<T, U>>;
-}
-/**
- * Helper function to define a Yargs CommandModule with proper typing and not sacrifice inference.
- */
-export declare function makeCommandModule<T, U>(module: CommandModule<T, U>): CommandModule<T, U>;

package/dist/src/command-line/yargs-utils/arguments-of.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeCommandModule = makeCommandModule;
-/**
- * Helper function to define a Yargs CommandModule with proper typing and not sacrifice inference.
- */
-function makeCommandModule(module) {
-    return module;
-}

package/dist/src/command-line/yargs-utils/documentation.d.ts

@@ -1,2 +0,0 @@
-import yargs = require('yargs');
-export declare function linkToNxDevAndExamples<T>(yargs: yargs.Argv<T>, command: string): yargs.Argv<T>;

package/dist/src/command-line/yargs-utils/documentation.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.linkToNxDevAndExamples = linkToNxDevAndExamples;
-const tslib_1 = require("tslib");
-const pc = tslib_1.__importStar(require("picocolors"));
-const examples_1 = require("../examples");
-function linkToNxDevAndExamples(yargs, command) {
-    (examples_1.examples[command] || []).forEach((t) => {
-        yargs = yargs.example(t.command, t.description);
-    });
-    return yargs.epilog(pc.bold(`Find more information and examples at https://nx.dev/nx/${command.replace(':', '-')}`));
-}

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

@@ -1,91 +0,0 @@
-import type { Argv, ParserConfigurationOptions } from 'yargs';
-interface ExcludeOptions {
-    exclude: string[];
-}
-export declare const defaultYargsParserConfiguration: Partial<ParserConfigurationOptions>;
-export declare function withExcludeOption<T>(yargs: Argv<T>): Argv<T & ExcludeOptions>;
-export interface RunOptions {
-    exclude: string;
-    parallel: string;
-    maxParallel: number;
-    runner: string;
-    prod: boolean;
-    graph: string;
-    verbose: boolean;
-    nxBail: boolean;
-    nxIgnoreCycles: boolean;
-    skipNxCache: boolean;
-    skipRemoteCache: boolean;
-    cloud: boolean;
-    dte: boolean;
-    batch: boolean;
-    useAgents: boolean;
-    excludeTaskDependencies: boolean;
-    skipSync: boolean;
-}
-export interface TuiOptions {
-    tuiAutoExit: boolean | number;
-    tui: boolean;
-}
-export declare function withTuiOptions<T>(yargs: Argv<T>): Argv<T & TuiOptions>;
-export declare function withRunOptions<T>(yargs: Argv<T>): Argv<T & RunOptions>;
-export declare function withTargetAndConfigurationOption(yargs: Argv, demandOption?: boolean): Argv<{
-    configuration: string;
-} & {
-    targets: string;
-}>;
-export declare function withConfiguration(yargs: Argv): Argv<{
-    configuration: string;
-}>;
-export declare function withVerbose<T>(yargs: Argv<T>): Argv<T & {
-    verbose: boolean;
-}>;
-export declare function withBatch(yargs: Argv): any;
-export declare function withAffectedOptions(yargs: Argv): Argv<ExcludeOptions & {
-    files: string;
-} & {
-    stdin: boolean;
-} & {
-    uncommitted: boolean;
-} & {
-    untracked: boolean;
-} & {
-    base: string;
-} & {
-    head: string;
-}>;
-export interface RunManyOptions extends RunOptions {
-    projects: string[];
-    /**
-     * @deprecated This is deprecated
-     */
-    all: boolean;
-}
-export declare function withRunManyOptions<T>(yargs: Argv<T>): Argv<T & RunManyOptions>;
-export declare function withOverrides<T extends {
-    _: Array<string | number>;
-}>(args: T, commandLevel?: number): T & {
-    __overrides_unparsed__: string[];
-};
-declare const allOutputStyles: readonly ['tui', 'dynamic', 'dynamic-legacy', 'static', 'static-failures-only', 'stream', 'stream-without-prefixes'];
-export type OutputStyle = (typeof allOutputStyles)[number];
-export declare function withOutputStyleOption<T>(yargs: Argv<T>, choices?: ReadonlyArray<OutputStyle>): Argv<T & {
-    outputStyle: OutputStyle;
-}>;
-export declare function withRunOneOptions(yargs: Argv): Argv<{
-    configuration: string;
-} & {
-    outputStyle: OutputStyle;
-} & RunOptions & {
-    project: string;
-} & {
-    target: string;
-} & {
-    help: boolean;
-}>;
-export declare function parseNewlines(input: string): string[];
-export declare function parseCSV(args: string[] | string): string[];
-export declare function readParallelFromArgsAndEnv(args: {
-    [k: string]: any;
-}): number;
-export {};