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

package/dist/src/command-line/migrate/run-migration-process.js

@@ -1,110 +0,0 @@
-const { runNxOrAngularMigration, ChangedDepInstaller } = require('./migrate');
-const { commitMigrationIfRequested } = require('./migrate-commits');
-const { execSync } = require('child_process');
-
-async function runMigrationProcess() {
-  const [
-    ,
-    ,
-    workspacePath,
-    migrationId,
-    migrationPackage,
-    migrationName,
-    migrationVersion,
-    createCommits,
-    commitPrefix,
-  ] = process.argv;
-
-  const migration = {
-    id: migrationId,
-    package: migrationPackage,
-    name: migrationName,
-    version: migrationVersion,
-  };
-
-  const configuration = {
-    createCommits: createCommits === 'true',
-    commitPrefix: commitPrefix || 'chore: [nx migration] ',
-  };
-
-  try {
-    const gitRefBefore = execSync('git rev-parse HEAD', {
-      cwd: workspacePath,
-      encoding: 'utf-8',
-      windowsHide: true,
-    }).trim();
-
-    // Snapshot package.json deps now so we can detect post-migration drift
-    // and run a single install, whether commits are on or off.
-    const installer = new ChangedDepInstaller(workspacePath);
-    const installDepsIfChanged = () => installer.installDepsIfChanged();
-
-    const {
-      changes: fileChanges,
-      nextSteps,
-      skipAgentic,
-    } = await runNxOrAngularMigration(workspacePath, migration, false);
-
-    if (configuration.createCommits) {
-      const commitResult = await commitMigrationIfRequested(
-        workspacePath,
-        migration,
-        true,
-        configuration.commitPrefix,
-        installDepsIfChanged
-      );
-      if (commitResult.status === 'failed') {
-        // Single-migration UI child surfaces the failure via stdout (logged
-        // inside commitMigrationIfRequested) and continues with success-
-        // with-warning. The executor's absorption flow does not apply here:
-        // there is no later migration that could pick up this migration's
-        // diff, so the working tree is left in its post-migration state
-        // for the user to commit or revert through the UI.
-      }
-    } else {
-      await installDepsIfChanged();
-    }
-
-    const gitRefAfter = execSync('git rev-parse HEAD', {
-      cwd: workspacePath,
-      encoding: 'utf-8',
-      windowsHide: true,
-    }).trim();
-
-    // Report success
-    process.stdout.write(
-      JSON.stringify({
-        type: 'success',
-        fileChanges: fileChanges.map((change) => ({
-          path: change.path,
-          type: change.type,
-        })),
-        gitRefAfter,
-        nextSteps,
-        skipAgentic,
-      })
-    );
-
-    process.exit(0);
-  } catch (error) {
-    // Report failure
-    process.stdout.write(
-      JSON.stringify({
-        type: 'error',
-        message: error.message,
-      })
-    );
-
-    process.exit(1);
-  }
-}
-
-runMigrationProcess().catch((error) => {
-  process.stdout.write(
-    JSON.stringify({
-      type: 'error',
-      message: error.message,
-    })
-  );
-  process.exit(1);
-});

package/dist/src/command-line/migrate/safe-prompt.d.ts

@@ -1,21 +0,0 @@
-import { Choice } from '../../utils/prompt-helpers';
-/**
- * Whether `nx migrate` may show interactive prompts: requires a TTY on stdin,
- * not running in CI, and the user not having passed `--no-interactive`.
- */
-export declare function canPrompt(interactive: boolean | undefined): boolean;
-/**
- * Yes/no question for `nx migrate`, aborting the run if the user cancels.
- */
-export declare function migrateConfirm(options: {
-    message: string;
-    initial?: boolean;
-}): Promise<boolean>;
-/**
- * Single-choice question for `nx migrate`, aborting the run if the user cancels.
- */
-export declare function migrateChoice<T extends string>(options: {
-    message: string;
-    choices: Choice<T>[];
-    initial?: T;
-}): Promise<T>;

package/dist/src/command-line/migrate/safe-prompt.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.canPrompt = canPrompt;
-exports.migrateConfirm = migrateConfirm;
-exports.migrateChoice = migrateChoice;
-const exit_codes_1 = require("../../utils/exit-codes");
-const is_ci_1 = require("../../utils/is-ci");
-const output_1 = require("../../utils/output");
-const prompt_helpers_1 = require("../../utils/prompt-helpers");
-/**
- * Whether `nx migrate` may show interactive prompts: requires a TTY on stdin,
- * not running in CI, and the user not having passed `--no-interactive`.
- */
-function canPrompt(interactive) {
-    return !!process.stdin.isTTY && !(0, is_ci_1.isCI)() && interactive !== false;
-}
-/**
- * Aborts the run the way `nx migrate` wants a cancel to look: one notice, then
- * POSIX 130 (128 + SIGINT). The user asked to stop, so there is no state worth
- * preserving.
- */
-function cancelMigrate() {
-    process.stdout.write('\n');
-    output_1.output.warn({ title: 'nx migrate interrupted by user.' });
-    (0, exit_codes_1.exitAsInterrupted)();
-}
-/**
- * Yes/no question for `nx migrate`, aborting the run if the user cancels.
- */
-async function migrateConfirm(options) {
-    return (0, prompt_helpers_1.confirmationPrompt)({
-        message: options.message,
-        initial: options.initial,
-        onCancel: cancelMigrate,
-    });
-}
-/**
- * Single-choice question for `nx migrate`, aborting the run if the user cancels.
- */
-async function migrateChoice(options) {
-    return (0, prompt_helpers_1.selectPrompt)({
-        message: options.message,
-        choices: options.choices,
-        initial: options.initial,
-        onCancel: cancelMigrate,
-    });
-}

package/dist/src/command-line/migrate/sort-migrations.d.ts

@@ -1,16 +0,0 @@
-interface SortableMigration {
-    package: string;
-    name: string;
-    version: string;
-}
-/**
- * Sorts in place (like `Array.prototype.sort`) and returns the same array.
- *
- * `hoistHandoffGitignore` is set for agentic runs, which write scratch under
- * `.nx/migrate-runs`; see `agentic/handoff-gitignore.ts` for why the v23
- * gitignore migration must run first there.
- */
-export declare function sortMigrations<T extends SortableMigration>(migrations: T[], opts: {
-    hoistHandoffGitignore: boolean;
-}): T[];
-export {};

package/dist/src/command-line/migrate/sort-migrations.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortMigrations = sortMigrations;
-const semver_1 = require("semver");
-const types_1 = require("./agentic/types");
-const version_utils_1 = require("./version-utils");
-/**
- * Sorts in place (like `Array.prototype.sort`) and returns the same array.
- *
- * `hoistHandoffGitignore` is set for agentic runs, which write scratch under
- * `.nx/migrate-runs`; see `agentic/handoff-gitignore.ts` for why the v23
- * gitignore migration must run first there.
- */
-function sortMigrations(migrations, opts) {
-    return migrations.sort((a, b) => {
-        if (opts.hoistHandoffGitignore) {
-            if ((0, types_1.isHandoffGitignoreMigration)(a))
-                return -1;
-            if ((0, types_1.isHandoffGitignoreMigration)(b))
-                return 1;
-        }
-        if (a.name === '15-7-0-split-configuration-into-project-json-files') {
-            return -1;
-        }
-        if (b.name === '15-7-0-split-configuration-into-project-json-files') {
-            return 1;
-        }
-        return (0, semver_1.lt)((0, version_utils_1.normalizeVersion)(a.version), (0, version_utils_1.normalizeVersion)(b.version))
-            ? -1
-            : 1;
-    });
-}

package/dist/src/command-line/migrate/step-actions.d.ts

@@ -1,5 +0,0 @@
-/** Allowed values for `--step-action`, the orchestrated reconcile's decision relay. */
-export declare const STEP_ACTIONS: readonly ['retry', 'skip', 'retry-clean', 'adopt'];
-export type StepAction = (typeof STEP_ACTIONS)[number];
-/** Runtime guard backed by {@link STEP_ACTIONS} so the two can't drift apart. */
-export declare function isStepAction(value: unknown): value is StepAction;

package/dist/src/command-line/migrate/step-actions.js

@@ -1,12 +0,0 @@
-"use strict";
-// Zero-dep source of truth for --step-action: keeps migrate/run's execution
-// chain out of CLI startup for callers that only need the value list or type.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STEP_ACTIONS = void 0;
-exports.isStepAction = isStepAction;
-/** Allowed values for `--step-action`, the orchestrated reconcile's decision relay. */
-exports.STEP_ACTIONS = ['retry', 'skip', 'retry-clean', 'adopt'];
-/** Runtime guard backed by {@link STEP_ACTIONS} so the two can't drift apart. */
-function isStepAction(value) {
-    return exports.STEP_ACTIONS.includes(value);
-}

package/dist/src/command-line/migrate/text.d.ts

@@ -1,18 +0,0 @@
-/**
- * Collapses every character a reader could take for a line break, so a value
- * cannot break out of the line it is rendered on. The driving agent scans the
- * same stdout for `<nx_migrate_*>` blocks, which are framed by a bare newline,
- * so a value carrying its own break could open a forged one at a line start.
- *
- * The set is the line terminators and nothing else. U+0085, U+2028 and U+2029
- * are in it because "line start" is the reader's notion, not this process's: a
- * JavaScript `^` under `/m` treats the latter two as terminators, and Nx does
- * not know what parses its output. Quoting is not a substitute either, since
- * `JSON.stringify` leaves all three literal.
- *
- * Deliberately not every control character. Some of this text is already
- * colored when it arrives, and stripping ESC would leave the rest of the
- * escape sequence behind as visible noise without closing anything: only a
- * real terminator can put a value at the start of a line.
- */
-export declare function singleLine(value: string): string;

package/dist/src/command-line/migrate/text.js

@@ -1,26 +0,0 @@
-"use strict";
-// Dependency-free on purpose. Every module that renders text an AI agent will
-// read needs this, run/run-state.ts included, and that one cannot reach
-// run/util.ts without a cycle through run/state-lock.ts.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.singleLine = singleLine;
-/**
- * Collapses every character a reader could take for a line break, so a value
- * cannot break out of the line it is rendered on. The driving agent scans the
- * same stdout for `<nx_migrate_*>` blocks, which are framed by a bare newline,
- * so a value carrying its own break could open a forged one at a line start.
- *
- * The set is the line terminators and nothing else. U+0085, U+2028 and U+2029
- * are in it because "line start" is the reader's notion, not this process's: a
- * JavaScript `^` under `/m` treats the latter two as terminators, and Nx does
- * not know what parses its output. Quoting is not a substitute either, since
- * `JSON.stringify` leaves all three literal.
- *
- * Deliberately not every control character. Some of this text is already
- * colored when it arrives, and stripping ESC would leave the rest of the
- * escape sequence behind as visible noise without closing anything: only a
- * real terminator can put a value at the start of a line.
- */
-function singleLine(value) {
-    return value.replace(/[\r\n\u000b\u000c\u0085\u2028\u2029]+/g, ' ');
-}

package/dist/src/command-line/migrate/update-filters.d.ts

@@ -1,11 +0,0 @@
-import type { PackageJsonUpdateForPackage as PackageUpdate } from '../../config/misc-interfaces';
-import type { PackageJson } from '../../utils/package-json';
-/**
- * Drop entries from `packageUpdates` that would either downgrade the package
- * (move resolved version backward) or rewrite a specifier that is already
- * exactly pinned to the resolved version (a no-op write). Keep genuine
- * upgrades and narrowing rewrites where the user's range covers a version
- * lower than what's resolved (the migrator's traditional "lock to recommended
- * exact pin" behavior).
- */
-export declare function filterDowngradedUpdates(packageUpdates: Record<string, PackageUpdate>, packageJson: PackageJson | null, getInstalledVersion: (packageName: string) => string | null): Record<string, PackageUpdate>;

package/dist/src/command-line/migrate/update-filters.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterDowngradedUpdates = filterDowngradedUpdates;
-const semver_1 = require("semver");
-const version_utils_1 = require("./version-utils");
-/**
- * Drop entries from `packageUpdates` that would either downgrade the package
- * (move resolved version backward) or rewrite a specifier that is already
- * exactly pinned to the resolved version (a no-op write). Keep genuine
- * upgrades and narrowing rewrites where the user's range covers a version
- * lower than what's resolved (the migrator's traditional "lock to recommended
- * exact pin" behavior).
- */
-function filterDowngradedUpdates(packageUpdates, packageJson, getInstalledVersion) {
-    const result = {};
-    for (const [name, update] of Object.entries(packageUpdates)) {
-        const resolved = getInstalledVersion(name);
-        if (!resolved) {
-            // Not installed; let downstream logic decide whether to add it.
-            result[name] = update;
-            continue;
-        }
-        const proposed = (0, version_utils_1.normalizeVersion)(update.version);
-        const resolvedNorm = (0, version_utils_1.normalizeVersion)(resolved);
-        if ((0, semver_1.gt)(proposed, resolvedNorm)) {
-            result[name] = update;
-            continue;
-        }
-        if ((0, semver_1.lt)(proposed, resolvedNorm)) {
-            continue;
-        }
-        // proposed === resolved: keep when narrowing a looser specifier to an
-        // exact pin; drop when the specifier is already exact at resolved.
-        const specifier = packageJson?.dependencies?.[name] ?? packageJson?.devDependencies?.[name];
-        if (!specifier) {
-            continue;
-        }
-        // Skip specifiers that aren't semver ranges (workspace:/npm:/git/file).
-        const floor = (0, semver_1.validRange)(specifier) ? (0, semver_1.minVersion)(specifier) : null;
-        if (floor && (0, semver_1.lt)(floor.version, resolvedNorm)) {
-            result[name] = update;
-        }
-    }
-    return result;
-}

package/dist/src/command-line/migrate/version-skew-guard.d.ts

@@ -1,60 +0,0 @@
-export declare const NEW_MIGRATE_FLAGS_FLOOR = "23.2.0";
-export declare const NEW_MIGRATE_FLAGS: readonly ['--run-migration', '--runMigration', '--run-id', '--runId', '--step-action', '--stepAction'];
-export declare function findNewMigrateFlag(argv: string[]): string | undefined;
-/**
- * Whether the invocation names an existing orchestrated run. Such an
- * invocation has to execute against the workspace-local nx that owns the run's
- * state under `.nx/migrate-runs`, so it never routes to a temp installation.
- */
-export declare function targetsExistingRun(argv: string[]): boolean;
-/**
- * Guard A (local side, before hop A). The current nx knows the new flags, but
- * the temp CLI 'nx migrate' is about to install may be older and would
- * silently drop them. Decides where a new-flag invocation runs:
- *
- * - No new flag in `argv`, or the temp CLI version resolves at or above the
- *   feature floor: 'temp-cli', the normal temp-installation path.
- * - The temp CLI resolves below the floor, or resolution fails (a registry
- *   error, or a minimum-release-age violation that a temp install must not
- *   bypass): 'local-nx', provided the workspace-local nx can take the flags.
- *   The local nx qualifies when it is the exact version running this code
- *   (it parsed the flag, so it supports it regardless of the floor) or is at
- *   or above the floor. An unreadable local version throws: the hand-off's
- *   spawn normally lands on the very install this read verifies, and a
- *   layout where the version cannot be read gives no such assurance, so
- *   handing off blind could run a below-floor nx that silently drops the
- *   flag.
- * - Neither side is capable: throw with remediation.
- *
- * An explicit NX_MIGRATE_CLI_VERSION pinned below the floor throws instead of
- * silently overriding the user's pin with the local fallback.
- *
- * `cliVersionSpec` is NX_MIGRATE_CLI_VERSION when set, else 'latest'.
- */
-export declare function resolveNewMigrateFlagsRunTarget(options: {
-    argv: string[];
-    cliVersionSpec: string;
-    fromEnvOverride: boolean;
-    ownNxVersion: string;
-    resolveVersion: (spec: string) => Promise<string>;
-    readLocalNxVersion: () => string | undefined;
-}): Promise<'temp-cli' | 'local-nx'>;
-/**
- * Guard B (temp side, before hop B). The temp CLI knows the new flags, but the
- * workspace-local nx it is about to hand off to may be older and would silently
- * drop them.
- *
- * A workspace pinned to a feature-carrying 23.2.0 prerelease is refused here
- * too: published prereleases that predate the feature cannot be told apart by
- * version alone. Guard A's same-version bypass does not apply on this side
- * because the invoking nx's version is not forwarded across hop A; the
- * refusal names the workspace update that resolves it.
- *
- * `readLocalNxVersion` returning undefined does not block: the hand-off then
- * resolves nx as it always does, which may fail visibly or land on another nx
- * the package manager locates.
- */
-export declare function assertWorkspaceNxSupportsNewMigrateFlags(options: {
-    argv: string[];
-    readLocalNxVersion: () => string | undefined;
-}): void;

package/dist/src/command-line/migrate/version-skew-guard.js

@@ -1,175 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NEW_MIGRATE_FLAGS = exports.NEW_MIGRATE_FLAGS_FLOOR = void 0;
-exports.findNewMigrateFlag = findNewMigrateFlag;
-exports.targetsExistingRun = targetsExistingRun;
-exports.resolveNewMigrateFlagsRunTarget = resolveNewMigrateFlagsRunTarget;
-exports.assertWorkspaceNxSupportsNewMigrateFlags = assertWorkspaceNxSupportsNewMigrateFlags;
-const semver_1 = require("semver");
-const logger_1 = require("../../utils/logger");
-const output_1 = require("../../utils/output");
-const version_utils_1 = require("./version-utils");
-// The first stable release shipping --run-migration/--run-id. Deliberately
-// the final release rather than its first prerelease: 23.2.0 prereleases
-// published before the feature landed do not carry it, so a prerelease floor
-// would wrongly accept them. The cost is that a later 23.2.0 prerelease that
-// does carry the feature is refused too, which fails toward refusal.
-// Permanent; never bumped at release time, but it must name the release that
-// actually ships the feature: if that slips past 23.2.0, versions in the gap
-// pass this floor and route to a temp CLI that drops the new flags and runs
-// the plan phase instead.
-exports.NEW_MIGRATE_FLAGS_FLOOR = '23.2.0';
-// yargs accepts both spellings of each flag and the raw argv is forwarded
-// across both migrate hops, so detection must catch every one.
-exports.NEW_MIGRATE_FLAGS = [
-    '--run-migration',
-    '--runMigration',
-    '--run-id',
-    '--runId',
-    '--step-action',
-    '--stepAction',
-];
-const RUN_ID_FLAGS = ['--run-id', '--runId'];
-/**
- * Matches an exact token or `<flag>=<value>`. The `=` matters: a bare
- * `startsWith` would also match `--run-migrations` (trailing s).
- */
-function findFlag(argv, flags) {
-    for (const arg of argv) {
-        // Everything after the -- separator is positional data, not options.
-        if (arg === '--') {
-            return undefined;
-        }
-        for (const flag of flags) {
-            if (arg === flag || arg.startsWith(`${flag}=`)) {
-                return flag;
-            }
-        }
-    }
-    return undefined;
-}
-function findNewMigrateFlag(argv) {
-    return findFlag(argv, exports.NEW_MIGRATE_FLAGS);
-}
-/**
- * Whether the invocation names an existing orchestrated run. Such an
- * invocation has to execute against the workspace-local nx that owns the run's
- * state under `.nx/migrate-runs`, so it never routes to a temp installation.
- */
-function targetsExistingRun(argv) {
-    return findFlag(argv, RUN_ID_FLAGS) !== undefined;
-}
-/**
- * Guard A (local side, before hop A). The current nx knows the new flags, but
- * the temp CLI 'nx migrate' is about to install may be older and would
- * silently drop them. Decides where a new-flag invocation runs:
- *
- * - No new flag in `argv`, or the temp CLI version resolves at or above the
- *   feature floor: 'temp-cli', the normal temp-installation path.
- * - The temp CLI resolves below the floor, or resolution fails (a registry
- *   error, or a minimum-release-age violation that a temp install must not
- *   bypass): 'local-nx', provided the workspace-local nx can take the flags.
- *   The local nx qualifies when it is the exact version running this code
- *   (it parsed the flag, so it supports it regardless of the floor) or is at
- *   or above the floor. An unreadable local version throws: the hand-off's
- *   spawn normally lands on the very install this read verifies, and a
- *   layout where the version cannot be read gives no such assurance, so
- *   handing off blind could run a below-floor nx that silently drops the
- *   flag.
- * - Neither side is capable: throw with remediation.
- *
- * An explicit NX_MIGRATE_CLI_VERSION pinned below the floor throws instead of
- * silently overriding the user's pin with the local fallback.
- *
- * `cliVersionSpec` is NX_MIGRATE_CLI_VERSION when set, else 'latest'.
- */
-async function resolveNewMigrateFlagsRunTarget(options) {
-    const flag = findNewMigrateFlag(options.argv);
-    if (!flag) {
-        return 'temp-cli';
-    }
-    // `valid()` returns null for a dist-tag like 'latest' and a normalized
-    // version for a concrete spec, which then skips the registry round-trip.
-    const concrete = (0, semver_1.valid)(options.cliVersionSpec);
-    let resolved;
-    try {
-        resolved =
-            concrete ?? (await options.resolveVersion(options.cliVersionSpec));
-    }
-    catch (e) {
-        // The local-fallback check below decides what a failed resolution means.
-        logger_1.logger.verbose(`Could not resolve the nx version for '${options.cliVersionSpec}': ${e}`);
-    }
-    if (resolved !== undefined &&
-        !(0, semver_1.lt)((0, version_utils_1.normalizeVersion)(resolved), exports.NEW_MIGRATE_FLAGS_FLOOR)) {
-        return 'temp-cli';
-    }
-    if (resolved !== undefined && options.fromEnvOverride) {
-        throw new Error(`The nx version 'nx migrate' is about to install (${resolved}) does not support ${flag}. ` +
-            `This flag ships in nx ${exports.NEW_MIGRATE_FLAGS_FLOOR} or newer. ` +
-            `NX_MIGRATE_CLI_VERSION is set to '${options.cliVersionSpec}'. ` +
-            `Unset it or set it to nx ${exports.NEW_MIGRATE_FLAGS_FLOOR} or newer.`);
-    }
-    const localNxVersion = options.readLocalNxVersion();
-    if (localNxVersion !== undefined &&
-        (localNxVersion === options.ownNxVersion ||
-            !(0, semver_1.lt)((0, version_utils_1.normalizeVersion)(localNxVersion), exports.NEW_MIGRATE_FLAGS_FLOOR))) {
-        // A pinned spec reaching this point failed to resolve: a resolved pin
-        // either returned 'temp-cli' or threw above.
-        if (options.fromEnvOverride) {
-            output_1.output.warn({
-                title: `The nx version pinned by NX_MIGRATE_CLI_VERSION ('${options.cliVersionSpec}') could not be resolved. Running ${flag} with the workspace's installed nx (${localNxVersion}) instead.`,
-            });
-        }
-        return 'local-nx';
-    }
-    const tempSideOutcome = resolved !== undefined
-        ? `resolves to ${resolved}, which does not support it`
-        : `could not be resolved`;
-    const localSideOutcome = localNxVersion !== undefined
-        ? `the workspace's installed nx (${localNxVersion}) does not support it either`
-        : `the workspace's installed nx version could not be read to verify support`;
-    // The worked example assumes the steady state, where 'latest' satisfies
-    // the floor: this branch then fires only when the spec could not be
-    // resolved (default or pinned), and updating the workspace to latest
-    // genuinely fixes it. Before the floor's stable release the example
-    // cannot resolve high enough; that window is deliberately not catered
-    // for, since no stable release carries the flags then anyway.
-    throw new Error(`${flag} requires nx ${exports.NEW_MIGRATE_FLAGS_FLOOR} or newer. ` +
-        `'${options.cliVersionSpec}' (the version 'nx migrate' would install) ${tempSideOutcome}, ` +
-        `and ${localSideOutcome}. ` +
-        `Update the workspace to nx ${exports.NEW_MIGRATE_FLAGS_FLOOR} or newer first, ` +
-        `for example by running 'nx migrate nx@latest' (without ${flag}) or by updating your dependencies.`);
-}
-/**
- * Guard B (temp side, before hop B). The temp CLI knows the new flags, but the
- * workspace-local nx it is about to hand off to may be older and would silently
- * drop them.
- *
- * A workspace pinned to a feature-carrying 23.2.0 prerelease is refused here
- * too: published prereleases that predate the feature cannot be told apart by
- * version alone. Guard A's same-version bypass does not apply on this side
- * because the invoking nx's version is not forwarded across hop A; the
- * refusal names the workspace update that resolves it.
- *
- * `readLocalNxVersion` returning undefined does not block: the hand-off then
- * resolves nx as it always does, which may fail visibly or land on another nx
- * the package manager locates.
- */
-function assertWorkspaceNxSupportsNewMigrateFlags(options) {
-    const flag = findNewMigrateFlag(options.argv);
-    if (!flag) {
-        return;
-    }
-    const localNxVersion = options.readLocalNxVersion();
-    if (!localNxVersion) {
-        return;
-    }
-    if ((0, semver_1.lt)((0, version_utils_1.normalizeVersion)(localNxVersion), exports.NEW_MIGRATE_FLAGS_FLOOR)) {
-        // The worked example assumes the steady state (latest at or above the
-        // floor); the pre-floor stable window is deliberately not catered for.
-        throw new Error(`The workspace's installed nx (${localNxVersion}) does not support ${flag}. ` +
-            `Update the workspace to nx ${exports.NEW_MIGRATE_FLAGS_FLOOR} or newer first, ` +
-            `for example by running 'nx migrate nx@latest' (without ${flag}) or by updating your dependencies.`);
-    }
-}

package/dist/src/command-line/migrate/version-utils.d.ts

@@ -1,5 +0,0 @@
-export declare const DIST_TAGS: readonly ['latest', 'next', 'canary'];
-export type DistTag = (typeof DIST_TAGS)[number];
-export declare function isLegacyEra(targetVersion: string): boolean;
-export declare function normalizeVersion(version: string): string;
-export declare function normalizeVersionWithTagCheck(pkg: string, version: string): Promise<string>;

package/dist/src/command-line/migrate/version-utils.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DIST_TAGS = void 0;
-exports.isLegacyEra = isLegacyEra;
-exports.normalizeVersion = normalizeVersion;
-exports.normalizeVersionWithTagCheck = normalizeVersionWithTagCheck;
-const semver_1 = require("semver");
-const resolve_package_version_1 = require("./resolve-package-version");
-exports.DIST_TAGS = ['latest', 'next', 'canary'];
-const LEGACY_ERA_BOUNDARY = '14.0.0-beta.0';
-// Pre-14 (legacy) installs used `@nrwl/workspace` as the canonical Nx package.
-// Non-semver values (e.g. dist-tags or the literal `'latest'` sentinel before
-// tag resolution) are treated as modern era.
-function isLegacyEra(targetVersion) {
-    return (0, semver_1.valid)(targetVersion) && (0, semver_1.lt)(targetVersion, LEGACY_ERA_BOUNDARY);
-}
-function normalizeVersion(version) {
-    const [semver, ...prereleaseTagParts] = version.split('-');
-    // Handle versions like 1.0.0-beta-next.2
-    const prereleaseTag = prereleaseTagParts.join('-');
-    const [major, minor, patch] = semver.split('.');
-    const newSemver = `${major || 0}.${minor || 0}.${patch || 0}`;
-    const newVersion = prereleaseTag
-        ? `${newSemver}-${prereleaseTag}`
-        : newSemver;
-    const withoutPatch = `${major || 0}.${minor || 0}.0`;
-    const withoutPatchAndMinor = `${major || 0}.0.0`;
-    const variationsToCheck = [
-        newVersion,
-        newSemver,
-        withoutPatch,
-        withoutPatchAndMinor,
-    ];
-    for (const variation of variationsToCheck) {
-        try {
-            if ((0, semver_1.gt)(variation, '0.0.0')) {
-                return variation;
-            }
-        }
-        catch { }
-    }
-    return '0.0.0';
-}
-async function normalizeVersionWithTagCheck(pkg, version) {
-    // Treat non-parseable inputs (e.g. dist-tags like `latest`/`next`) as
-    // registry references and resolve them. Throws on registry failure;
-    // callers that need to tolerate registry outages must wrap.
-    if (version && !(0, semver_1.parse)(version)) {
-        return (0, resolve_package_version_1.resolvePackageVersionRespectingMinReleaseAge)(pkg, version);
-    }
-    return normalizeVersion(version);
-}

package/dist/src/command-line/new/command-object.d.ts

@@ -1,2 +0,0 @@
-import { CommandModule } from 'yargs';
-export declare const yargsNewCommand: CommandModule;