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

package/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2017-2026 Narwhal Technologies Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,18 +1,65 @@
-# @ohos-ports/nx (launcher-side local-natives loader, openharmony-arm64)
+<p style="text-align: center;">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-dark.svg">
+    <img alt="Nx - Smart Repos · Fast Builds" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
+  </picture>
+</p>
 
-Launcher-side companion for the `@ohos-ports/nx-openharmony-arm64` native
-binding package (ported from `@nx/nx-linux-arm-gnueabihf`). Follows the
-upstream `@nx/nx` `local-natives.js` / `native-bindings.js` loading pattern:
-resolve the binding dynamically via `process.platform` + `process.arch`. The
-`openharmony` platform identifier is used verbatim and is never patched/aliased
-to `linux`.
+<div style="text-align: center;">
 
-## Usage
+[![License](https://img.shields.io/npm/l/@nx/workspace.svg?style=flat-square)](<>)
+[![NPM Version](https://badge.fury.io/js/nx.svg)](https://www.npmjs.com/package/nx)
+[![Semantic Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](<>)
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
+[![Join us on the Official Nx Discord Server](https://img.shields.io/discord/1143497901675401286?label=discord)](https://go.nx.dev/community)
+[![Nx Sandboxing](https://staging.nx.app/workspaces/62d013ea0852fe0a2df74438/sandbox-badge.svg)](https://nx.dev/docs/features/ci-features/sandboxing)
 
-```js
-const native = require('@ohos-ports/nx')
-// e.g. native.formatDuration(...), native.hashArray(...), native.copy(...)
+</div>
+
+
+<hr>
+
+# Nx: Smart Repos · Fast Builds
+
+Get to green PRs in half the time. Nx optimizes your builds, scales your CI, and fixes failed PRs. Built for developers and AI agents.
+
+## Getting Started
+
+### Creating an Nx Workspace
+
+**Using `npx`**
+
+```bash
+npx create-nx-workspace
+```
+
+**Using `npm init`**
+
+```bash
+npm init nx-workspace
 ```
 
-On `openharmony` / `arm64` the loader resolves `@ohos-ports/nx-openharmony-arm64`;
-other platforms fall back to the upstream `@nx/nx-{platform}-{arch}` packages.
+**Using `yarn create`**
+
+```bash
+yarn create nx-workspace
+```
+
+### Adding Nx to an Existing Repository
+
+Run:
+
+```bash
+npx nx@latest init
+```
+
+## Documentation & Resources
+
+- [Nx.Dev: Documentation, Guides, Tutorials](https://nx.dev)
+- [Intro to Nx](https://nx.dev/getting-started/intro)
+- [Official Nx YouTube Channel](https://www.youtube.com/@NxDevtools)
+- [Blog Posts About Nx](https://nx.dev/blog)
+
+<p style="text-align: center;"><a href="https://nx.dev/#learning-materials" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-courses-and-videos.svg" 
+width="100%" alt="Nx - Smart Monorepos · Fast Builds"></a></p>
+

package/dist/bin/init-local.d.ts

@@ -0,0 +1,8 @@
+import { WorkspaceTypeAndRoot } from '../src/utils/find-workspace-root';
+/**
+ * Nx is being run inside a workspace.
+ *
+ * @param workspace Relevant local workspace properties
+ */
+export declare function initLocal(workspace: WorkspaceTypeAndRoot): Promise<void>;
+export declare function rewriteTargetsAndProjects(args: string[]): string[];

package/dist/bin/init-local.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initLocal = initLocal;
+exports.rewriteTargetsAndProjects = rewriteTargetsAndProjects;
+const perf_hooks_1 = require("perf_hooks");
+const nx_commands_1 = require("../src/command-line/nx-commands");
+const strip_indents_1 = require("../src/utils/strip-indents");
+const client_1 = require("../src/daemon/client/client");
+const prompt_helpers_1 = require("../src/utils/prompt-helpers");
+const output_1 = require("../src/utils/output");
+const analytics_1 = require("../src/analytics");
+/**
+ * Nx is being run inside a workspace.
+ *
+ * @param workspace Relevant local workspace properties
+ */
+async function initLocal(workspace) {
+    process.env.NX_CLI_SET = 'true';
+    try {
+        // In case Nx Cloud forcibly exits while the TUI is running, ensure the terminal is restored etc.
+        process.on('exit', (...args) => {
+            if (typeof globalThis.tuiOnProcessExit === 'function') {
+                globalThis.tuiOnProcessExit(...args);
+            }
+        });
+        perf_hooks_1.performance.mark('init-local');
+        if (workspace.type !== 'nx' && shouldDelegateToAngularCLI()) {
+            console.warn((0, strip_indents_1.stripIndents) `Using Nx to run Angular CLI commands is deprecated and will be removed in a future version.
+        To run Angular CLI commands, use \`ng\`.`);
+            handleAngularCLIFallbacks(workspace);
+            return;
+        }
+        // Skip per-TAB shell completion calls — those must not spawn the daemon.
+        if (!process.env.NX_COMPLETE) {
+            try {
+                await ensureNxConsoleInstalledViaDaemon();
+            }
+            catch { }
+        }
+        const command = process.argv[2];
+        if (command === 'completion' ||
+            command === 'run' ||
+            command === 'g' ||
+            command === 'generate') {
+            nx_commands_1.commandsObject.parse(process.argv.slice(2));
+        }
+        else if (isKnownCommand(command)) {
+            const newArgs = rewriteTargetsAndProjects(process.argv);
+            const help = newArgs.indexOf('--help');
+            const split = newArgs.indexOf('--');
+            if (help > -1 && (split === -1 || split > help)) {
+                nx_commands_1.commandsObject.showHelp();
+                process.exit(0);
+            }
+            else {
+                nx_commands_1.commandsObject.parse(newArgs);
+            }
+        }
+        else {
+            nx_commands_1.commandsObject.parse(process.argv.slice(2));
+        }
+    }
+    catch (e) {
+        console.error(e.message);
+        (0, analytics_1.flushAnalytics)();
+        process.exit(1);
+    }
+}
+function rewriteTargetsAndProjects(args) {
+    const newArgs = [args[2]];
+    let i = 3;
+    while (i < args.length) {
+        if (args[i] === '--') {
+            return [...newArgs, ...args.slice(i)];
+        }
+        else if (args[i] === '-p' ||
+            args[i] === '--projects' ||
+            args[i] === '--exclude' ||
+            args[i] === '--files' ||
+            args[i] === '-t' ||
+            args[i] === '--target' ||
+            args[i] === '--targets') {
+            newArgs.push(args[i]);
+            i++;
+            const items = [];
+            while (i < args.length && !args[i].startsWith('-')) {
+                items.push(args[i]);
+                i++;
+            }
+            newArgs.push(items.join(','));
+        }
+        else {
+            newArgs.push(args[i]);
+            ++i;
+        }
+    }
+    return newArgs;
+}
+function isKnownCommand(command) {
+    const commands = [
+        ...Object.keys(nx_commands_1.commandsObject
+            .getInternalMethods()
+            .getCommandInstance()
+            .getCommandHandlers()),
+        'g',
+        'dep-graph',
+        'affected:dep-graph',
+        'format',
+        'workspace-schematic',
+        'connect-to-nx-cloud',
+        'clear-cache',
+        'help',
+    ];
+    return !command || command.startsWith('-') || commands.indexOf(command) > -1;
+}
+function shouldDelegateToAngularCLI() {
+    const command = process.argv[2];
+    const commands = ['analytics', 'cache', 'config', 'doc', 'update'];
+    return commands.indexOf(command) > -1;
+}
+async function ensureNxConsoleInstalledViaDaemon() {
+    // Only proceed if daemon is available
+    if (!client_1.daemonClient.enabled() || !(await client_1.daemonClient.isServerAvailable())) {
+        return;
+    }
+    // Get status from daemon
+    const status = await client_1.daemonClient.getNxConsoleStatus();
+    // If we should prompt the user
+    if (status.shouldPrompt && process.stdout.isTTY) {
+        output_1.output.log({
+            title: "Install Nx's official editor extension to:",
+            bodyLines: [
+                '- Enable your AI assistant to do more by understanding your workspace',
+                '- Add IntelliSense for Nx configuration files',
+                '- Explore your workspace visually',
+            ],
+        });
+        try {
+            const shouldInstallNxConsole = await (0, prompt_helpers_1.confirmationPrompt)({
+                message: 'Install Nx Console? (you can uninstall anytime)',
+                onCancel: () => false,
+            });
+            // Set preference and install if user said yes
+            const result = await client_1.daemonClient.setNxConsolePreferenceAndInstall(shouldInstallNxConsole);
+            if (result.installed) {
+                output_1.output.log({ title: 'Successfully installed Nx Console!' });
+            }
+        }
+        catch (error) {
+            // User cancelled or error occurred, save preference as false
+            await client_1.daemonClient.setNxConsolePreferenceAndInstall(false);
+        }
+    }
+}
+function handleAngularCLIFallbacks(workspace) {
+    if (process.argv[2] === 'update' && process.env.FORCE_NG_UPDATE != 'true') {
+        console.log(`Nx provides a much improved version of "ng update". It runs the same migrations, but allows you to:`);
+        console.log(`- rerun the same migration multiple times`);
+        console.log(`- reorder migrations, skip migrations`);
+        console.log(`- fix migrations that "almost work"`);
+        console.log(`- commit a partially migrated state`);
+        console.log(`- change versions of packages to match organizational requirements`);
+        console.log(`And, in general, it is lot more reliable for non-trivial workspaces. Read more at: https://nx.dev/docs/technologies/angular/guides/nx-and-angular#ng-update-vs-nx-migrate`);
+        console.log(`Run "nx migrate latest" to update to the latest version of Nx.`);
+        console.log(`Running "ng update" can still be useful in some dev workflows, so we aren't planning to remove it.`);
+        console.log(`If you need to use it, run "FORCE_NG_UPDATE=true ng update".`);
+    }
+    else if (process.argv[2] === 'cache') {
+        console.log(`"ng cache" is not natively supported by Nx.
+To clear the cache, you can delete the ".angular/cache" directory (or the directory configured by "cli.cache.path" in the "nx.json" file).
+To update the cache configuration, you can directly update the relevant options in your "nx.json" file (https://angular.dev/reference/configs/workspace-config#cache-options).`);
+    }
+    else {
+        try {
+            // nx-ignore-next-line
+            const cli = require.resolve('@angular/cli/lib/init.js', {
+                paths: [workspace.dir],
+            });
+            require(cli);
+        }
+        catch (e) {
+            console.error(`Could not find '@angular/cli/lib/init.js' module in this workspace.`, e);
+            process.exit(1);
+        }
+    }
+}

package/dist/bin/nx-cloud.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import type { CloudTaskRunnerOptions } from '../src/nx-cloud/nx-cloud-tasks-runner-shell';
+export declare function invokeCommandWithNxCloudClient(options: CloudTaskRunnerOptions): Promise<any>;

package/dist/bin/nx-cloud.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invokeCommandWithNxCloudClient = invokeCommandWithNxCloudClient;
+const get_cloud_options_1 = require("../src/nx-cloud/utilities/get-cloud-options");
+const update_manager_1 = require("../src/nx-cloud/update-manager");
+const output_1 = require("../src/utils/output");
+const client_1 = require("../src/nx-cloud/utilities/client");
+const command = process.argv[2];
+const options = (0, get_cloud_options_1.getCloudOptions)();
+Promise.resolve().then(async () => invokeCommandWithNxCloudClient(options));
+async function invokeCommandWithNxCloudClient(options) {
+    try {
+        const client = await (0, client_1.getCloudClient)(options);
+        client.invoke(command);
+    }
+    catch (e) {
+        if (e instanceof client_1.UnknownCommandError) {
+            output_1.output.error({
+                title: `Unknown Command "${e.command}"`,
+            });
+            output_1.output.log({
+                title: 'Available Commands:',
+                bodyLines: e.availableCommands.map((c) => `- ${c}`),
+            });
+            process.exit(1);
+        }
+        const body = ['Cannot run commands from the `nx-cloud` CLI.'];
+        if (e instanceof update_manager_1.NxCloudEnterpriseOutdatedError) {
+            try {
+                // TODO: Remove this when all enterprise customers have updated.
+                // Try requiring the bin from the `nx-cloud` package.
+                return require('nx-cloud/bin/nx-cloud');
+            }
+            catch { }
+            body.push('If you are an Nx Enterprise customer, please reach out to your assigned Developer Productivity Engineer.', 'If you are NOT an Nx Enterprise customer but are seeing this message, please reach out to cloud-support@nrwl.io.');
+        }
+        if (e instanceof update_manager_1.NxCloudClientUnavailableError) {
+            body.unshift('You may be offline. Please try again when you are back online.');
+        }
+        output_1.output.error({
+            title: e.message,
+            bodyLines: body,
+        });
+        process.exit(1);
+    }
+}

package/dist/bin/nx.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import '../src/utils/enable-compile-cache';
+import '../src/utils/perf-logging';