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

package/dist/src/command-line/migrate/execute-migration.d.ts

@@ -1,91 +0,0 @@
-import { MigrationsJson } from '../../config/misc-interfaces';
-import { FileChange } from '../../generators/tree';
-import { ArrayPackageGroup, NxMigrationsConfiguration, PackageJson } from '../../utils/package-json';
-interface PackageMigrationConfig extends NxMigrationsConfiguration {
-    packageJson: PackageJson;
-    packageGroup: ArrayPackageGroup;
-}
-export declare function readPackageMigrationConfig(packageName: string, dir: string): PackageMigrationConfig;
-export declare function runInstall(nxWorkspaceRoot?: string, phase?: MigrationInstallPhase, rerunCommand?: string): Promise<void>;
-export type MigrationInstallPhase = 'pre-migration' | 'post-migration';
-export declare class NpmPeerDepsInstallError extends Error {
-    constructor();
-}
-/**
- * Detects npm peer-dependency resolution failures. Keyed on the `ERESOLVE`
- * error code, which npm consistently emits for this class of failure across
- * v7+ (`npm ERR! code ERESOLVE` / `npm error code ERESOLVE`). Falls back to a
- * small set of stable phrases in case the code line is missing from the
- * captured output.
- */
-export declare function isNpmPeerDepsError(stderr: string): boolean;
-export declare function formatSingleMigrationRerunCommand(migrationId: string): string;
-export declare function logNpmPeerDepsError(phase: MigrationInstallPhase, rerunCommand?: string): void;
-export declare function logSkippedPostMigrationInstall(root: string): void;
-export declare class ChangedDepInstaller {
-    private readonly root;
-    private readonly shouldSkipInstall;
-    private readonly rerunCommand?;
-    private initialDeps;
-    private _skippedInstall;
-    private _installed;
-    constructor(root: string, shouldSkipInstall?: boolean, rerunCommand?: string);
-    get skippedInstall(): boolean;
-    /**
-     * Whether an install actually ran. Distinct from `!skippedInstall`, which is
-     * only about the skip-install flag: dependencies that never changed leave
-     * both false.
-     */
-    get installed(): boolean;
-    installDepsIfChanged(): Promise<void>;
-}
-export declare function runNxOrAngularMigration(root: string, migration: {
-    package: string;
-    name: string;
-    description?: string;
-    version: string;
-}, isVerbose: boolean, captureGeneratorOutput?: boolean, resolvedCollection?: ResolvedMigrationCollection): Promise<{
-    changes: FileChange[];
-    nextSteps: string[];
-    agentContext: string[];
-    skipAgentic: boolean;
-    logs: string;
-    madeChanges: boolean;
-}>;
-/**
- * The workspace's declared dependencies, serialized for equality comparison,
- * or `null` when package.json could not be read or parsed. Callers that
- * persist the value across processes need that distinction: an unreadable
- * package.json is not an empty dependency set.
- */
-export declare function readPackageJsonDeps(root: string): string | null;
-export declare function getStringifiedPackageJsonDeps(root: string): string;
-export declare function runNxMigration(root: string, collectionPath: string, collection: MigrationsJson, name: string, migrationVersion: string | undefined, captureGeneratorOutput: boolean): Promise<{
-    changes: FileChange[];
-    nextSteps: string[];
-    agentContext: string[];
-    skipAgentic: boolean;
-    logs: string;
-}>;
-export declare function parseMigrationReturn(value: unknown): {
-    nextSteps: string[];
-    agentContext: string[];
-    skipAgentic: boolean;
-};
-export declare function filterStrings(value: unknown): string[];
-export interface ResolvedMigrationCollection {
-    collection: MigrationsJson;
-    collectionPath: string;
-}
-export declare function readMigrationCollection(packageName: string, root: string): ResolvedMigrationCollection;
-export declare function resolveDocumentationFileToWorkspacePath(root: string, migrationsDir: string, documentation: string): string | undefined;
-export declare function getImplementationPath(collection: MigrationsJson, collectionPath: string, name: string, migrationVersion?: string): {
-    path: string;
-    fnSymbol: string;
-};
-export declare class MigrationImplementationMissingError extends Error {
-    constructor(baseMessage: string, collectionPath: string, migrationVersion: string | undefined);
-}
-export declare function isAngularMigration(collection: MigrationsJson, name: string): import("../../config/misc-interfaces").MigrationsJsonEntry;
-export declare const getNgCompatLayer: () => Promise<typeof import("../../adapter/ngcli-adapter")>;
-export {};

package/dist/src/command-line/migrate/execute-migration.js

@@ -1,474 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNgCompatLayer = exports.MigrationImplementationMissingError = exports.ChangedDepInstaller = exports.NpmPeerDepsInstallError = void 0;
-exports.readPackageMigrationConfig = readPackageMigrationConfig;
-exports.runInstall = runInstall;
-exports.isNpmPeerDepsError = isNpmPeerDepsError;
-exports.formatSingleMigrationRerunCommand = formatSingleMigrationRerunCommand;
-exports.logNpmPeerDepsError = logNpmPeerDepsError;
-exports.logSkippedPostMigrationInstall = logSkippedPostMigrationInstall;
-exports.runNxOrAngularMigration = runNxOrAngularMigration;
-exports.readPackageJsonDeps = readPackageJsonDeps;
-exports.getStringifiedPackageJsonDeps = getStringifiedPackageJsonDeps;
-exports.runNxMigration = runNxMigration;
-exports.parseMigrationReturn = parseMigrationReturn;
-exports.filterStrings = filterStrings;
-exports.readMigrationCollection = readMigrationCollection;
-exports.resolveDocumentationFileToWorkspacePath = resolveDocumentationFileToWorkspacePath;
-exports.getImplementationPath = getImplementationPath;
-exports.isAngularMigration = isAngularMigration;
-const tslib_1 = require("tslib");
-const pc = tslib_1.__importStar(require("picocolors"));
-const child_process_1 = require("child_process");
-const path_1 = require("path");
-const semver_1 = require("semver");
-const handle_import_1 = require("../../utils/handle-import");
-const tree_1 = require("../../generators/tree");
-const fileutils_1 = require("../../utils/fileutils");
-const logger_1 = require("../../utils/logger");
-const text_1 = require("./text");
-const package_json_1 = require("../../utils/package-json");
-const package_manager_1 = require("../../utils/package-manager");
-const output_1 = require("../../utils/output");
-const fs_1 = require("fs");
-const installation_directory_1 = require("../../utils/installation-directory");
-const shell_quoting_1 = require("../../utils/shell-quoting");
-const project_graph_1 = require("../../project-graph/project-graph");
-const version_utils_1 = require("./version-utils");
-function readPackageMigrationConfig(packageName, dir) {
-    const { path: packageJsonPath, packageJson: json } = (0, package_json_1.readModulePackageJson)(packageName, (0, installation_directory_1.getNxRequirePaths)(dir));
-    const config = (0, package_json_1.readNxMigrateConfig)(json);
-    if (!config) {
-        return { packageJson: json, migrations: null, packageGroup: [] };
-    }
-    try {
-        const migrationFile = require.resolve(config.migrations, {
-            paths: [(0, path_1.dirname)(packageJsonPath)],
-        });
-        return {
-            packageJson: json,
-            migrations: migrationFile,
-            packageGroup: config.packageGroup,
-            supportsOptionalMigrations: config.supportsOptionalMigrations,
-        };
-    }
-    catch {
-        return {
-            packageJson: json,
-            migrations: null,
-            packageGroup: config.packageGroup,
-            supportsOptionalMigrations: config.supportsOptionalMigrations,
-        };
-    }
-}
-function runInstall(nxWorkspaceRoot, phase = 'pre-migration', rerunCommand) {
-    const cwd = nxWorkspaceRoot ?? process.cwd();
-    const packageManager = (0, package_manager_1.detectPackageManager)(cwd);
-    const pmCommands = (0, package_manager_1.getPackageManagerCommand)(packageManager, cwd);
-    const installCommand = `${pmCommands.install} ${pmCommands.ignoreScriptsFlag ?? ''}`;
-    output_1.output.log({
-        title: `Running '${installCommand}' to make sure necessary packages are installed`,
-    });
-    return new Promise((resolve, reject) => {
-        // For npm, pipe stderr so we can detect peer dependency errors while still
-        // mirroring it live to the user's terminal. Other package managers inherit
-        // stderr directly since we don't need to inspect their output.
-        const shouldCaptureStderr = packageManager === 'npm';
-        const child = (0, child_process_1.spawn)(installCommand, {
-            shell: true,
-            stdio: ['inherit', 'inherit', shouldCaptureStderr ? 'pipe' : 'inherit'],
-            windowsHide: true,
-            cwd,
-        });
-        const stderrChunks = [];
-        child.stderr?.on('data', (chunk) => {
-            process.stderr.write(chunk);
-            stderrChunks.push(chunk);
-        });
-        child.on('error', reject);
-        child.on('close', (code) => {
-            if (code === 0) {
-                resolve();
-                return;
-            }
-            if (shouldCaptureStderr) {
-                const stderr = Buffer.concat(stderrChunks).toString().trim();
-                if (isNpmPeerDepsError(stderr)) {
-                    // Log the remediation guidance here so every caller of `runInstall`
-                    // (CLI migrate, `nx repair`, single-migration runner, etc.) surfaces
-                    // it consistently. Top-level callers catch `NpmPeerDepsInstallError`
-                    // and return a non-zero exit code without re-logging.
-                    logNpmPeerDepsError(phase, rerunCommand);
-                    reject(new NpmPeerDepsInstallError());
-                    return;
-                }
-            }
-            reject(new Error(`Command failed: ${installCommand}`));
-        });
-    });
-}
-class NpmPeerDepsInstallError extends Error {
-    constructor() {
-        super('npm install failed due to peer dependency conflicts.');
-        this.name = 'NpmPeerDepsInstallError';
-    }
-}
-exports.NpmPeerDepsInstallError = NpmPeerDepsInstallError;
-/**
- * Detects npm peer-dependency resolution failures. Keyed on the `ERESOLVE`
- * error code, which npm consistently emits for this class of failure across
- * v7+ (`npm ERR! code ERESOLVE` / `npm error code ERESOLVE`). Falls back to a
- * small set of stable phrases in case the code line is missing from the
- * captured output.
- */
-function isNpmPeerDepsError(stderr) {
-    if (/\bERESOLVE\b/.test(stderr)) {
-        return true;
-    }
-    const lowerStderr = stderr.toLowerCase();
-    return (lowerStderr.includes('unable to resolve dependency tree') ||
-        lowerStderr.includes('could not resolve dependency') ||
-        lowerStderr.includes('conflicting peer dependency'));
-}
-// The single-migration rerun command lands in copyable guidance (see
-// `logNpmPeerDepsError` below), so quote ids a shell would split or expand.
-// Single quotes stay literal in POSIX shells and PowerShell alike; double
-// quotes would leave $-expansion active in both. The embedded-quote escape is
-// the POSIX '\'' sequence, the one character PowerShell disagrees on (it wants
-// ''). cmd.exe is knowingly not covered: it does not group on single quotes,
-// and no quoting suppresses its %VAR% expansion.
-function formatSingleMigrationRerunCommand(migrationId) {
-    const id = (0, shell_quoting_1.needsShellQuoting)(migrationId)
-        ? `'${migrationId.replace(/'/g, String.raw `'\''`)}'`
-        : migrationId;
-    return `nx migrate --run-migration=${id}`;
-}
-function logNpmPeerDepsError(phase, rerunCommand = 'nx migrate --run-migrations') {
-    const peerDepsResolutionSteps = [
-        'Recommended approaches (in order of preference):',
-        '',
-        '1. Use "overrides" in package.json to force compatible versions across the dependency tree.',
-        '   See https://docs.npmjs.com/cli/configuring-npm/package-json#overrides',
-        '2. Persist legacy peer deps resolution in the project ".npmrc":',
-        '   npm config set legacy-peer-deps=true --location=project',
-        '   (bypasses peer dependency resolution; use with caution)',
-        '3. As a last resort, force the installation by running "npm install --force".',
-        '   (does not persist and may produce broken installs)',
-    ];
-    const manualInstallHint = [
-        'If you installed the dependencies manually, pass "--skip-install" to avoid re-installing them:',
-        `   ${rerunCommand} --skip-install`,
-    ];
-    if (phase === 'pre-migration') {
-        output_1.output.error({
-            title: 'You need to resolve the peer dependency conflicts before the migration can continue',
-            bodyLines: [
-                ...peerDepsResolutionSteps,
-                '',
-                'Once the conflicts are resolved, re-run the migration command:',
-                `   ${rerunCommand}`,
-                '',
-                ...manualInstallHint,
-            ],
-        });
-    }
-    else {
-        output_1.output.error({
-            title: 'Some migrations have been applied, but installing the updated dependencies failed',
-            bodyLines: [
-                ...peerDepsResolutionSteps,
-                '',
-                'Once the conflicts are resolved, run "npm install" to install the updated dependencies.',
-                'If the migration run was interrupted before completing, re-run it:',
-                `   ${rerunCommand}`,
-                '',
-                ...manualInstallHint,
-            ],
-        });
-    }
-}
-function logSkippedPostMigrationInstall(root) {
-    const packageManager = (0, package_manager_1.detectPackageManager)(root);
-    const installCommand = (0, package_manager_1.getPackageManagerCommand)(packageManager, root).install;
-    output_1.output.warn({
-        title: 'Migrations updated your dependencies, but the install was skipped',
-        bodyLines: [`Run "${installCommand}" to install the updated dependencies.`],
-    });
-}
-class ChangedDepInstaller {
-    constructor(root, shouldSkipInstall = false, rerunCommand) {
-        this.root = root;
-        this.shouldSkipInstall = shouldSkipInstall;
-        this.rerunCommand = rerunCommand;
-        this._skippedInstall = false;
-        this._installed = false;
-        this.initialDeps = getStringifiedPackageJsonDeps(root);
-    }
-    get skippedInstall() {
-        return this._skippedInstall;
-    }
-    /**
-     * Whether an install actually ran. Distinct from `!skippedInstall`, which is
-     * only about the skip-install flag: dependencies that never changed leave
-     * both false.
-     */
-    get installed() {
-        return this._installed;
-    }
-    async installDepsIfChanged() {
-        const currentDeps = getStringifiedPackageJsonDeps(this.root);
-        if (this.initialDeps !== currentDeps) {
-            if (this.shouldSkipInstall) {
-                this._skippedInstall = true;
-            }
-            else {
-                await runInstall(this.root, 'post-migration', this.rerunCommand);
-                this._installed = true;
-            }
-        }
-        this.initialDeps = currentDeps;
-    }
-}
-exports.ChangedDepInstaller = ChangedDepInstaller;
-async function runNxOrAngularMigration(root, migration, isVerbose, captureGeneratorOutput = false, resolvedCollection) {
-    const { collection, collectionPath } = resolvedCollection ?? readMigrationCollection(migration.package, root);
-    let changes = [];
-    let nextSteps = [];
-    let agentContext = [];
-    // Angular schematics have no return channel, so they can never waive it.
-    let skipAgentic = false;
-    let logs = '';
-    // Angular's `ngResult.changes` is synthesized from the schematic's
-    // DryRunEvent stream so Nx and Angular paths can share commit/validation
-    // gating via `changes.length > 0`.
-    let madeChanges = false;
-    logger_1.logger.info(pc.dim('→ Running generator…'));
-    if (!isAngularMigration(collection, migration.name)) {
-        ({ nextSteps, changes, agentContext, skipAgentic, logs } =
-            await runNxMigration(root, collectionPath, collection, migration.name, migration.version, captureGeneratorOutput));
-        madeChanges = changes.length > 0;
-        logger_1.logger.info((0, text_1.singleLine)(`Ran ${migration.name} from ${migration.package}`));
-        if (migration.description) {
-            logger_1.logger.info((0, text_1.singleLine)(`  ${migration.description}`));
-        }
-        logger_1.logger.info('');
-        if (!madeChanges) {
-            logger_1.logger.info(`No changes were made\n`);
-            return {
-                changes,
-                nextSteps,
-                agentContext,
-                skipAgentic,
-                logs,
-                madeChanges,
-            };
-        }
-        logger_1.logger.info('Changes:');
-        (0, tree_1.printChanges)(changes, '  ');
-        logger_1.logger.info('');
-    }
-    else {
-        const ngCliAdapter = await (0, exports.getNgCompatLayer)();
-        const migrationProjectGraph = await (0, project_graph_1.createProjectGraphAsync)();
-        const ngResult = await ngCliAdapter.runMigration(root, migration.package, migration.name, (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(migrationProjectGraph).projects, isVerbose, migrationProjectGraph);
-        changes = ngResult.changes;
-        madeChanges = ngResult.madeChanges;
-        logs = ngResult.loggingQueue.join('\n');
-        logger_1.logger.info((0, text_1.singleLine)(`Ran ${migration.name} from ${migration.package}`));
-        if (migration.description) {
-            logger_1.logger.info((0, text_1.singleLine)(`  ${migration.description}`));
-        }
-        logger_1.logger.info('');
-        if (!madeChanges) {
-            logger_1.logger.info(`No changes were made\n`);
-            return {
-                changes,
-                nextSteps,
-                agentContext,
-                skipAgentic,
-                logs,
-                madeChanges,
-            };
-        }
-        logger_1.logger.info('Changes:');
-        ngResult.loggingQueue.forEach((log) => logger_1.logger.info((0, text_1.singleLine)('  ' + log)));
-        logger_1.logger.info('');
-    }
-    return { changes, nextSteps, agentContext, skipAgentic, logs, madeChanges };
-}
-/**
- * The workspace's declared dependencies, serialized for equality comparison,
- * or `null` when package.json could not be read or parsed. Callers that
- * persist the value across processes need that distinction: an unreadable
- * package.json is not an empty dependency set.
- */
-function readPackageJsonDeps(root) {
-    try {
-        const { dependencies, devDependencies } = (0, fileutils_1.readJsonFile)((0, path_1.join)(root, 'package.json'));
-        return JSON.stringify([dependencies, devDependencies]);
-    }
-    catch {
-        return null;
-    }
-}
-function getStringifiedPackageJsonDeps(root) {
-    // We don't really care if the .nx/installation property changes,
-    // whenever nxw is invoked it will handle the dep updates.
-    return readPackageJsonDeps(root) ?? '';
-}
-async function runNxMigration(root, collectionPath, collection, name, migrationVersion, captureGeneratorOutput) {
-    const { path: implPath, fnSymbol } = getImplementationPath(collection, collectionPath, name, migrationVersion);
-    const fn = require(implPath)[fnSymbol];
-    const host = new tree_1.FsTree(root, process.env.NX_VERBOSE_LOGGING === 'true', `migration ${collection.name}:${name}`);
-    let result;
-    let logs = '';
-    if (captureGeneratorOutput) {
-        const { withGeneratorOutputCapture } = require('./agentic/capture-generator-output');
-        ({ result, logs } = await withGeneratorOutputCapture(() => fn(host, {})));
-    }
-    else {
-        result = await fn(host, {});
-    }
-    const { nextSteps, agentContext, skipAgentic } = parseMigrationReturn(result);
-    host.lock();
-    const changes = host.listChanges();
-    (0, tree_1.flushChanges)(root, changes);
-    return { changes, nextSteps, agentContext, skipAgentic, logs };
-}
-function parseMigrationReturn(value) {
-    if (Array.isArray(value)) {
-        return {
-            nextSteps: filterStrings(value),
-            agentContext: [],
-            skipAgentic: false,
-        };
-    }
-    if (value && typeof value === 'object') {
-        const obj = value;
-        return {
-            nextSteps: filterStrings(obj.nextSteps),
-            agentContext: filterStrings(obj.agentContext),
-            // Strict, so a truthy non-boolean can't opt a migration out of its AI step.
-            skipAgentic: obj.skipAgentic === true,
-        };
-    }
-    // Catches `void`, mistakenly-returned generator callbacks, malformed values.
-    return { nextSteps: [], agentContext: [], skipAgentic: false };
-}
-// Bucket-level tolerance: a single non-string entry shouldn't discard the
-// whole `nextSteps` / `agentContext` array. Migration authors occasionally
-// push `null` / `undefined` / a number into the array; we drop the bad entries
-// and keep the rest so end-of-run guidance isn't silently lost.
-function filterStrings(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.filter((v) => typeof v === 'string');
-}
-function readMigrationCollection(packageName, root) {
-    const collectionPath = readPackageMigrationConfig(packageName, root).migrations;
-    const collection = (0, fileutils_1.readJsonFile)(collectionPath);
-    collection.name ??= packageName;
-    return {
-        collection,
-        collectionPath,
-    };
-}
-// Workspace-relative because the agent runs with cwd at the workspace root;
-// absolute only for layouts that resolve outside it (hoisted/symlinked).
-function resolveDocumentationFileToWorkspacePath(root, migrationsDir, documentation) {
-    let documentationFile;
-    try {
-        documentationFile = require.resolve(documentation, {
-            paths: [migrationsDir],
-        });
-    }
-    catch {
-        return undefined;
-    }
-    const relativePath = (0, path_1.relative)(root, documentationFile);
-    return relativePath.startsWith('..') ? documentationFile : relativePath;
-}
-function getImplementationPath(collection, collectionPath, name, migrationVersion) {
-    const g = collection.generators?.[name] || collection.schematics?.[name];
-    if (!g) {
-        throw new MigrationImplementationMissingError(`Unable to determine implementation path for "${collectionPath}:${name}"`, collectionPath, migrationVersion);
-    }
-    const implRelativePathAndMaybeSymbol = g.implementation || g.factory;
-    const [implRelativePath, fnSymbol = 'default'] = implRelativePathAndMaybeSymbol.split('#');
-    let implPath;
-    try {
-        implPath = require.resolve(implRelativePath, {
-            paths: [(0, path_1.dirname)(collectionPath)],
-        });
-    }
-    catch (e) {
-        try {
-            // workaround for a bug in node 12
-            implPath = require.resolve(`${(0, path_1.dirname)(collectionPath)}/${implRelativePath}`);
-        }
-        catch {
-            throw new MigrationImplementationMissingError(`Could not resolve implementation for migration "${name}" from "${collectionPath}"`, collectionPath, migrationVersion ?? g.version);
-        }
-    }
-    return { path: implPath, fnSymbol };
-}
-class MigrationImplementationMissingError extends Error {
-    constructor(baseMessage, collectionPath, migrationVersion) {
-        super(buildMigrationMissingMessage(baseMessage, collectionPath, migrationVersion));
-        this.name = 'MigrationImplementationMissingError';
-    }
-}
-exports.MigrationImplementationMissingError = MigrationImplementationMissingError;
-function buildMigrationMissingMessage(baseMessage, collectionPath, migrationVersion) {
-    if (!migrationVersion) {
-        return baseMessage;
-    }
-    try {
-        const packageJsonPath = (0, path_1.join)((0, path_1.dirname)(collectionPath), 'package.json');
-        if (!(0, fs_1.existsSync)(packageJsonPath)) {
-            return baseMessage;
-        }
-        const packageJson = (0, fileutils_1.readJsonFile)(packageJsonPath);
-        const installedVersion = packageJson.version;
-        if (installedVersion &&
-            (0, semver_1.lt)((0, version_utils_1.normalizeVersion)(installedVersion), (0, version_utils_1.normalizeVersion)(migrationVersion))) {
-            const packageManager = (0, package_manager_1.detectPackageManager)();
-            const pmc = (0, package_manager_1.getPackageManagerCommand)(packageManager);
-            const overrideFieldName = getOverrideFieldName(packageManager);
-            return (`${baseMessage}\n\n` +
-                `The installed version of "${packageJson.name}" is ${installedVersion}, ` +
-                `but this migration requires version ${migrationVersion}. ` +
-                `This likely means the package version is being held back by an ${overrideFieldName} ` +
-                `in your package.json. ` +
-                `Remove the ${overrideFieldName} and run "${pmc.install}" to install the correct version.`);
-        }
-    }
-    catch {
-        // Fall through to return the base message if we can't read package info
-    }
-    return baseMessage;
-}
-function getOverrideFieldName(packageManager) {
-    switch (packageManager) {
-        case 'pnpm':
-            return '"pnpm.overrides"';
-        case 'yarn':
-            return '"resolutions"';
-        case 'npm':
-        case 'bun':
-            return '"overrides"';
-    }
-}
-function isAngularMigration(collection, name) {
-    return !collection.generators?.[name] && collection.schematics?.[name];
-}
-exports.getNgCompatLayer = (() => {
-    let _ngCliAdapter;
-    return async function getNgCompatLayer() {
-        if (!_ngCliAdapter) {
-            _ngCliAdapter = await (0, handle_import_1.handleImport)('../../adapter/ngcli-adapter.js', __dirname);
-            require('../../adapter/compat');
-        }
-        return _ngCliAdapter;
-    };
-})();

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

@@ -1,106 +0,0 @@
-import type { MigrateInclude } from './command-object';
-export type MigrateIncludeSource = 'flag' | 'nx-json' | 'prompt' | 'default';
-export type MigrateMultiMajorChoice = 'gradual' | 'direct';
-export type MigrateFetchFallbackReason = 'env-skip' | 'unsupported-registry' | 'provenance' | 'registry-error';
-export type MigrateFetchStats = {
-    registryCount: number;
-    installCount: number;
-    fallbackReason?: MigrateFetchFallbackReason;
-};
-export type MigrateAgenticOutcome = 'enabled' | 'disabled' | 'inside-agent';
-export type MigratePromptChoices = {
-    include: MigrateInclude;
-    multi_major: 'direct' | 'latest-in-current' | 'latest-in-next';
-    agentic: 'yes-once' | 'yes-flex' | 'yes-pin' | 'no-once' | 'no-never';
-    agent_select: string;
-    ambiguous_agent_outcome: 'abort' | 'continue';
-};
-export type MigratePromptName = keyof MigratePromptChoices;
-export type MigrateGenerateErrorCode = 'resolve_version' | 'fetch_migrations' | 'package_updates';
-export type MigrateRunErrorCode = 'npm_install' | 'migration_exec' | 'agentic' | 'other';
-export declare function setMigrateInclude(include: MigrateInclude): void;
-export declare function setMigrateIncludeSource(source: MigrateIncludeSource): void;
-export declare function classifyMigrateFetchFallback(error: unknown): MigrateFetchFallbackReason;
-/**
- * Records an interactive migrate prompt and the user's selection.
- *
- * The prompt identity is encoded in the event name (`migrate_prompt_<prompt>`)
- * so it doesn't cost a GA custom dimension; `choice` is one dimension
- * multiplexed across all prompts, read conditioned on the event name. The
- * per-prompt value-spaces are typed in {@link MigratePromptChoices}.
- */
-export declare function reportMigratePrompt<P extends MigratePromptName>(prompt: P, choice: MigratePromptChoices[P]): void;
-export declare function reportMigrateGenerateStart(opts: {
-    targetPackage: string;
-    interactive?: boolean;
-    excludeAppliedMigrations?: boolean;
-}): void;
-export declare function reportMigrateGenerateComplete(opts: {
-    targetVersion: string;
-    requestedTargetVersion: string;
-    installedTargetVersion: string | null | undefined;
-    include: MigrateInclude;
-    multiMajorChoice?: MigrateMultiMajorChoice;
-    fetchStats?: MigrateFetchStats;
-}): void;
-export declare function reportMigrateGenerateError(code: MigrateGenerateErrorCode, error: unknown): void;
-export declare function reportMigrateRunStart(opts: {
-    createCommits: boolean;
-    migrationCount: number;
-}): void;
-/**
- * Whether the current process recorded a `migrate_run_start` event. Lets
- * shared code paths (e.g. `executeMigrations`, reused by `nx repair`) skip
- * migrate events when not running inside a migrate run.
- */
-export declare function hasMigrateRunStarted(): boolean;
-export declare function reportMigrateRunComplete(opts: {
-    agenticOutcome: MigrateAgenticOutcome;
-    agentUsed?: string;
-    migrationCount: number;
-    appliedCount: number;
-}): void;
-export declare function reportMigrateRunError(opts: {
-    code: MigrateRunErrorCode;
-    migrationPackage?: string;
-    migrationName?: string;
-    migrationCount?: number;
-    error?: unknown;
-}): void;
-export declare function reportMigrateOrchestratorInit(opts: {
-    migrationCount: number;
-    createCommits: boolean;
-}): void;
-/**
- * One event per orchestrator dispense. The `action` (dispense case) is a
- * closed enum carried on a reused dimension, read conditioned on the event
- * name (the same multiplexing pattern as {@link reportMigratePrompt});
- * `attempt` rides the migration-count dimension.
- */
-export declare function reportMigrateOrchestratorDispense(opts: {
-    action: string;
-    attempt: number;
-}): void;
-/**
- * Terminal funnel event. The two step tallies and the total dispense count
- * ride reused numeric dimensions, read conditioned on the event name.
- */
-export declare function reportMigrateOrchestratorComplete(opts: {
-    completed: number;
-    skipped: number;
-    dispenseCount: number;
-}): void;
-/**
- * Counts invocations, not completions: emitted as soon as the migration id
- * resolves, while the worker can still stop before running anything.
- *
- * An invocation recorded into an orchestrated run (`--run-id`) gets its own
- * event name. Every other one keeps the name `--run-migration` shipped with,
- * so that series stays continuous for users who never enable the orchestrator.
- */
-export declare function reportMigrateSingleMigrationInvocation(opts: {
-    migrationType: 'generator' | 'prompt' | 'hybrid';
-    orchestrated: boolean;
-}): void;
-export declare function computeMajorsCrossed(installed: string | null | undefined, target: string | null | undefined): number | undefined;
-export declare function safeReport(emit: () => void): void;