@testspectra/cli 1.1.8-rc.3 → 1.1.8-rc.31

package/dist/commands/init.js

@@ -6,6 +6,7 @@ import chalk from 'chalk';
 import { ConfigLoader } from '../config/loader.js';
 import { TypeGenerator } from '../types/generator.js';
 import { TsConfigGenerator } from '../generator/tsconfig-generator.js';
+import { generateArchitectureDoc } from '../generator/architecture-doc-generator.js';
 function parsePnpmWorkspaceGlobs(content) {
     const lines = content.split('\n');
     const globs = [];
@@ -460,6 +461,8 @@ export async function initCommand(options = {}) {
                     (typeof rootPkg.devDependencies['@testspectra/matchers'] === 'string' &&
                         rootPkg.devDependencies['@testspectra/matchers'].startsWith('link:')))
                     rootPkg.devDependencies['@testspectra/matchers'] = cliDepVersion;
+                if (!rootPkg.devDependencies['nx'])
+                    rootPkg.devDependencies['nx'] = '^20.8.4';
                 if (!rootPkg.devDependencies['typescript'])
                     rootPkg.devDependencies['typescript'] = '^5.4.5';
                 if (!rootPkg.devDependencies['@wdio/cli'])
@@ -508,6 +511,7 @@ export async function initCommand(options = {}) {
             copyRecursive(sampleE2eSrc, targetE2eDir, {
                 'playground-e2e': e2eProjectName,
                 'packages/playground/e2e': path.relative(cwd, targetE2eDir).replace(/\\/g, '/'),
+                'testspectra:scope:playground': `testspectra:scope:${featureName}`,
                 'scope:playground': `scope:${featureName}`,
             });
             // Adjust project.json
@@ -519,7 +523,7 @@ export async function initCommand(options = {}) {
                     pObj.sourceRoot = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
                     pObj.targets.e2e.options.cwd = path.relative(cwd, targetE2eDir).replace(/\\/g, '/');
                     pObj.targets['type-check'].options.cwd = '.';
-                    pObj.tags = [`scope:${featureName}`, 'type:e2e'];
+                    pObj.tags = ['testspectra:e2e', `testspectra:scope:${featureName}`];
                     fs.writeFileSync(projJsonPath, JSON.stringify(pObj, null, 2), 'utf-8');
                 }
                 catch { }
@@ -557,137 +561,7 @@ export async function initCommand(options = {}) {
         // 7. Generate Ambient Types in ROOT only
         TypeGenerator.writeDeclarationFiles(cwd);
         ensureVsCodeExtensions(cwd);
-        const archDocContent = `# TestSpectra Enterprise Monorepo Architecture
-
-This workspace uses TestSpectra's **"Centralized Configuration, Distributed Implementation"** model for automated cross-platform testing.
-
----
-
-## 1. Directory & File Overview
-
-### Centralized Root Elements
-- \`./spectra.config.ts\`: Single source of truth for runtime configurations (Base URL, Appium devices, browser targets, timeouts).
-- \`./.testspectra/\`: Local test project cache, runtime metadata, auto-generated master TSConfig (\`.testspectra/tsconfig.json\`), platform sub-configs (\`.testspectra/tsconfig/\`), and universal ambient types (\`.testspectra/types/\`). Global binaries and drivers are managed at \`~/.testspectra/drivers/\`.
-- \`./nx.json\`: Nx target defaults with execution caching and inputs.
-- \`./pnpm-workspace.yaml\`: Monorepo package glob definitions.
-- \`./tsconfig.json\`: Solution-style TypeScript orchestrator referencing \`./.testspectra/tsconfig.json\`.
-
-### Centralized Shared Testing Library (\`./${sharedTestingRelPath}\`)
-Provides cross-feature reusable test entities with **100% zero-import global resolution**:
-- \`page-objects/\`: Shared Page Object models (e.g. NavigationBar, AppHeader).
-- \`steps/\`: Cross-feature business step flows (e.g. \`Step.loginAsAdmin()\`).
-- \`actions/\`: Custom atomic actions (e.g. \`Spectra.dismissBanner()\`).
-- \`fixtures/\`: Common test data and environment configurations (e.g. \`Fixture.appConfig\`).
-
-### Distributed Feature E2E Modules (${featureE2eDirs.length} Features)
-${featureE2eDirs
-            .map((d) => {
-            const rel = path.relative(cwd, d);
-            const name = path.basename(path.dirname(d));
-            const e2eName = `${name}-${e2eFolderName}`;
-            return `- \`./${rel}\` (**${name}**, Nx Project: \`${e2eName}\`):
-  - \`specs/\`: Feature test cases (\`specs/<SuiteName>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
-  - \`page-objects/\`: Feature-specific Page Objects (e.g. \`LoginPage\`, \`ProductPage\`).
-  - \`project.json\`: Nx targets (\`e2e\`, \`type-check\`) supporting configurations (\`--configuration=android\`, \`--configuration=ios\`, \`--configuration=headless\`).`;
-        })
-            .join('\n')}
-
----
-
-## 2. Zero-Import Consumption Flow & Mechanics
-
-TestSpectra completely eliminates boilerplate \`import\` statements across all test specs, steps, and page objects.
-
-### How It Works:
-1. **Centralized Ambient Aggregation**:  
-   TestSpectra Language Service Plugin & CLI automatically scan:
-   - **Local Feature Entities**: \`<feature>/${e2eFolderName}/page-objects/\`, \`<feature>/${e2eFolderName}/steps/\`, \`<feature>/${e2eFolderName}/actions/\`
-   - **Shared Library Entities**: \`./${sharedTestingRelPath}/page-objects/\`, \`./${sharedTestingRelPath}/steps/\`, \`./${sharedTestingRelPath}/actions/\`, \`./${sharedTestingRelPath}/fixtures/\`
-2. **Ambient Typing Generation**:  
-   These are compiled into \`.testspectra/types/web.d.ts\`, \`android.d.ts\`, \`ios.d.ts\`, \`fixtures.d.ts\`.
-3. **Instant IDE Autocomplete & Zero Clutter**:  
-   Specs consume both local feature objects and shared library utilities globally.
-
-### Code Example:
-\`\`\`typescript
-// packages/features/auth/e2e/specs/Auth/TC-AUTH-01/web.test.ts
-// 🌟 NOTICE: 100% Zero-Import & Flat Execution! (No import statement, no describe wrapper)
-
-it("should navigate via shared header and login with local POM", async () => {
-  // 1. Consumed from Shared Testing Library (${sharedTestingRelPath}/page-objects/NavigationBar)
-  await NavigationBar.goToLogin();
-
-  // 2. Consumed from Shared Testing Library (${sharedTestingRelPath}/steps/loginAsAdmin)
-  await Step.loginAsAdmin();
-
-  // 3. Consumed from Local Feature POM (page-objects/LoginPage)
-  await LoginPage.flashAlert.shouldBeVisible();
-  await LoginPage.flashAlert.shouldContainText("Welcome");
-
-  // 4. Consumed from Shared Testing Library Custom Action (${sharedTestingRelPath}/actions/dismissBanner)
-  await Spectra.dismissBanner();
-});
-\`\`\`
-
----
-
-## 3. How to Run Tests
-
-You can execute tests either from the **Monorepo Root via Nx** or directly inside each **Feature Directory via CLI**:
-
-### Option A: From Root Monorepo via Nx (Recommended for CI & Team Workflows)
-
-\`\`\`bash
-# 1. Run E2E for a SPECIFIC feature module (e.g. auth)
-pnpm nx run auth-${e2eFolderName}:e2e
-
-# 2. Run E2E for a specific feature on ANDROID or IOS
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=android
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=ios
-
-# 3. Run E2E for a specific feature in HEADLESS browser mode
-pnpm nx run auth-${e2eFolderName}:e2e --configuration=headless
-
-# 4. Run ALL feature E2E suites across the entire monorepo in parallel
-pnpm nx run-many -t e2e
-
-# 5. Run only E2E tests for features modified in current Git branch / PR
-pnpm nx affected -t e2e
-\`\`\`
-
-### Option B: From Inside the Feature Directory (Direct CLI)
-
-\`\`\`bash
-# Navigate to the feature e2e folder
-cd ${featureE2eDirs.length > 0 ? path.relative(cwd, featureE2eDirs[0]).replace(/\\/g, '/') : `modules/auth/${e2eFolderName}`}
-
-# Run all specs in this feature
-pnpm spectra run
-
-# Run a specific test case file
-pnpm spectra run specs/Auth/TC-AUTH-01/web.test.ts
-
-# Target Android device or emulator
-pnpm spectra run --target android
-
-# Run in headed / interactive browser mode
-pnpm spectra run --no-headless
-\`\`\`
-
----
-
-## 4. Type Checking & Validation
-
-\`\`\`bash
-# Type check all E2E projects via Nx
-pnpm nx run-many -t type-check
-
-# Or standard TypeScript project references build from root
-pnpm type-check
-# or: npx tsc -b
-\`\`\`
-`;
-        fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), archDocContent, 'utf-8');
+        generateArchitectureDoc(cwd);
         // 8. Ensure root .gitignore ignores .testspectra/ and *.tsbuildinfo
         const rootGitignorePath = path.join(cwd, '.gitignore');
         const ignoreEntries = ['.testspectra/', '*.tsbuildinfo', '.nx/cache'];
@@ -741,34 +615,7 @@ pnpm type-check
     TypeGenerator.writeDeclarationFiles(cwd);
     ensureVsCodeExtensions(cwd);
     // Standalone Architecture Documentation
-    const standaloneArchDoc = `# TestSpectra Project Architecture
-
-This project is built with the TestSpectra testing framework.
-
-## Structure & File Map
-- \`./spectra.config.ts\`: Typed runner configuration.
-- \`./specs/\`: Layered test cases (\`specs/<Suite>/<CaseId>/\` with \`web.test.ts\`, \`android.test.ts\`, \`ios.test.ts\`).
-- \`./page-objects/\`: Page Object models per platform.
-- \`./steps/\`: Business flows accessible globally via \`Step.*\`.
-- \`./actions/\`: Atomic actions accessible globally via \`Spectra.*\`.
-- \`./fixtures/\`: JSON fixtures accessible globally via \`Fixture.*\`.
-- \`./global-hooks/\`: Global suite lifecycle hooks.
-- \`./.testspectra/\`: Auto-generated ambient typings and local runtime cache.
-
-## Execution
-\`\`\`bash
-# Run web test suite
-pnpm test
-
-# Run Android / iOS
-pnpm spectra run --target android
-pnpm spectra run --target ios
-
-# Type check
-pnpm type-check
-\`\`\`
-`;
-    fs.writeFileSync(path.join(cwd, 'ARCHITECTURE.md'), standaloneArchDoc, 'utf-8');
+    generateArchitectureDoc(cwd);
     // Safely update root README.md (do not overwrite existing content)
     const standaloneReadmePath = path.join(cwd, 'README.md');
     const standaloneArchSection = `\n## E2E Testing Architecture (TestSpectra)\n\nDetailed test architecture and folder map are documented in:  \n👉 **[ARCHITECTURE.md](./ARCHITECTURE.md)**\n\n- **Run tests**: \`pnpm test\`\n- **Type-check**: \`pnpm type-check\`\n`;

package/dist/commands/install.js

@@ -17,6 +17,9 @@ export async function installCommand(item, options = {}) {
     if (item) {
         args.push(item);
     }
+    if (options.force) {
+        args.push('--force');
+    }
     return new Promise((resolve) => {
         let child;
         if (binPath === 'cargo') {
@@ -34,6 +37,7 @@ export async function installCommand(item, options = {}) {
                 cwd: workspaceRoot,
                 env: runnerEnv,
                 stdio: 'inherit',
+                windowsHide: true,
             });
         }
         else {
@@ -41,6 +45,7 @@ export async function installCommand(item, options = {}) {
                 cwd,
                 env: runnerEnv,
                 stdio: 'inherit',
+                windowsHide: true,
             });
         }
         child.on('close', (code) => {

package/dist/commands/license.js

@@ -14,6 +14,7 @@ export async function licenseCommand(action = 'status', key, options = {}) {
         const child = spawn(binPath, args, {
             stdio: 'inherit',
             env: process.env,
+            windowsHide: true,
         });
         child.on('close', (code) => {
             if (code === 0) {

package/dist/commands/run.d.ts

@@ -1,6 +1,8 @@
 export interface RunCommandOptions {
     spec?: string;
     target?: 'web' | 'android' | 'ios' | 'common' | 'mobile';
+    host?: string;
+    baseUrl?: string;
     device?: string;
     devices?: string;
     allDevices?: boolean;

package/dist/commands/run.js

@@ -6,6 +6,7 @@ import { Reporter } from '../runner/reporter.js';
 import { TypeGenerator } from '../types/generator.js';
 import { DemoServer } from '../utils/demo-server.js';
 import { DemoApiServer } from '../utils/api-server.js';
+import { DevServerManager } from '../utils/dev-server-manager.js';
 function renderSummaryCard(options) {
     const width = 64;
     const borderColor = options.isPassed ? '\x1b[38;2;52;211;153m' : '\x1b[38;2;248;113;113m';
@@ -157,9 +158,29 @@ export async function runCommand(specPaths, options = {}) {
         }
     }
     const config = await ConfigLoader.loadConfig(cwd);
+    if (options.baseUrl) {
+        config.webConfig.baseUrl = options.baseUrl;
+    }
+    else if (options.host) {
+        if (config.webConfig.hosts && config.webConfig.hosts[options.host]) {
+            config.webConfig.baseUrl = config.webConfig.hosts[options.host];
+            console.log(`\x1b[36m[TestSpectra]\x1b[0m 🎯 Active Host target: \x1b[33m${options.host}\x1b[0m (\x1b[32m${config.webConfig.baseUrl}\x1b[0m)`);
+        }
+        else {
+            console.warn(`\x1b[33m[TestSpectra] Warning: Target host "${options.host}" is not defined in spectra.config.ts (webConfig.hosts). Falling back to ${config.webConfig.baseUrl}\x1b[0m`);
+        }
+    }
     let demoServer = null;
     let apiServer = null;
+    const devServerManager = new DevServerManager();
     try {
+        const configuredDevServers = [
+            ...(config.webConfig.devServers || []),
+            ...(config.webConfig.devServer ? [config.webConfig.devServer] : []),
+        ];
+        if (configuredDevServers.length > 0 && !options.demo) {
+            await devServerManager.startAll(configuredDevServers, options.host, cwd);
+        }
         if (options.demo) {
             demoServer = new DemoServer(5173);
             try {
@@ -343,6 +364,7 @@ export async function runCommand(specPaths, options = {}) {
         process.exit(1);
     }
     finally {
+        await devServerManager.stopAll();
         if (demoServer) {
             await demoServer.stop();
         }

package/dist/commands/test.d.ts

@@ -1,5 +1,6 @@
 export interface TestCommandOptions {
     cwd?: string;
+    runner?: 'spectra' | 'vitest';
     headed?: boolean;
     headless?: boolean;
     stepDelay?: string | number;
@@ -8,6 +9,18 @@ export interface TestCommandOptions {
     output?: string;
     concurrency?: string | number;
 }
+/**
+ * Guarantees the `.testspectra` solution-tsconfig scaffolding exists before Vitest starts.
+ *
+ * The bundled Vitest browser runner transpiles raw TypeScript specs/page-objects Just-In-Time.
+ * When it does, `vite:esbuild` walks the nearest `tsconfig.json` and tries to read every entry in
+ * its `references` — including `./.testspectra/tsconfig.json`. That directory is gitignored, so on
+ * a clean clone / fresh CI checkout the reference points at a file that does not exist, esbuild
+ * throws `ENOENT`, Vite answers HTTP 500, and every suite dies with "Failed to fetch dynamically
+ * imported module" before a single assertion runs. Regenerating the scaffolding up front (same
+ * output as `spectra sync-types`) keeps the reference resolvable.
+ */
+export declare function ensureTestSpectraScaffolding(cwd: string): void;
 /**
  * `spectra test` — delegates to `@testspectra/react`'s bundled Vitest browser-mode runner for
  * component testing. Deliberately separate from `spectra run` (E2E via core/orchestrator): see

package/dist/commands/test.js

@@ -1,9 +1,30 @@
+import fs from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
 import * as p from '@clack/prompts';
+import { ConfigLoader } from '../config/loader.js';
 import { renderSummaryView } from '../reporter/summary-view.js';
 import { Reporter } from '../runner/reporter.js';
+import { RustCoreBridge } from '../runner/bridge.js';
+import { TypeGenerator } from '../generator/type-generator.js';
 import { runSystemChecks } from './doctor.js';
+/**
+ * Guarantees the `.testspectra` solution-tsconfig scaffolding exists before Vitest starts.
+ *
+ * The bundled Vitest browser runner transpiles raw TypeScript specs/page-objects Just-In-Time.
+ * When it does, `vite:esbuild` walks the nearest `tsconfig.json` and tries to read every entry in
+ * its `references` — including `./.testspectra/tsconfig.json`. That directory is gitignored, so on
+ * a clean clone / fresh CI checkout the reference points at a file that does not exist, esbuild
+ * throws `ENOENT`, Vite answers HTTP 500, and every suite dies with "Failed to fetch dynamically
+ * imported module" before a single assertion runs. Regenerating the scaffolding up front (same
+ * output as `spectra sync-types`) keeps the reference resolvable.
+ */
+export function ensureTestSpectraScaffolding(cwd) {
+    const masterConfigPath = path.join(cwd, '.testspectra', 'tsconfig.json');
+    if (fs.existsSync(masterConfigPath))
+        return;
+    TypeGenerator.generateAll(cwd);
+}
 /**
  * Finds the Chrome-for-Testing binary that `spectra doctor` already installs/manages for the
  * E2E CDP driver (`core/driver-cdp`) — same install, same binary. `@testspectra/react` must not
@@ -14,8 +35,10 @@ import { runSystemChecks } from './doctor.js';
  */
 async function resolveBrowserExecutable(cwd) {
     try {
-        const { dependencies } = await runSystemChecks(cwd);
-        const chrome = dependencies.find((d) => d.category === 'web' && (d.name.includes('Chrome') || d.name.includes('Chromium')));
+        // `--only chrome` runs exactly one check — no adb/bun/git spawns, no Matchers lookup — since
+        // this call exists solely to locate the managed browser binary.
+        const { dependencies } = await runSystemChecks(cwd, { only: 'chrome' });
+        const chrome = dependencies.find((d) => d.category === 'web' && d.name.includes('Chrome'));
         return chrome?.installed && chrome.location ? chrome.location : null;
     }
     catch {
@@ -30,6 +53,11 @@ async function resolveBrowserExecutable(cwd) {
  */
 export async function testCommand(options = {}) {
     const cwd = options.cwd ?? process.cwd();
+    // User-facing phase log. Deliberately describes TestSpectra's own stages only — never the
+    // bundled runtime/toolchain underneath — so the CLI surface stays implementation-agnostic.
+    const logPhase = (message) => p.log.step(chalk.dim(message));
+    logPhase('Preparing component test workspace…');
+    ensureTestSpectraScaffolding(cwd);
     let reactPkg;
     try {
         reactPkg = await import('@testspectra/react');
@@ -41,6 +69,7 @@ export async function testCommand(options = {}) {
         process.exit(1);
         return;
     }
+    logPhase('Resolving managed test browser…');
     const browserExecutablePath = await resolveBrowserExecutable(cwd);
     if (!browserExecutablePath) {
         p.log.error(chalk.red('✖ TestSpectra-managed Chrome for Testing was not found.'));
@@ -64,6 +93,21 @@ export async function testCommand(options = {}) {
     else if (options.headless !== undefined) {
         headless = options.headless;
     }
+    // Fallback to spectra.config.ts if options were not explicitly provided on CLI
+    try {
+        const config = await ConfigLoader.loadConfig(cwd);
+        if (stepDelayMs === undefined && config?.webConfig?.stepDelay !== undefined) {
+            const parsed = parseInt(String(config.webConfig.stepDelay), 10);
+            if (!isNaN(parsed) && parsed >= 0)
+                stepDelayMs = parsed;
+        }
+        if (!options.headed && options.headless === undefined && config?.webConfig?.headless !== undefined) {
+            headless = String(config.webConfig.headless) !== 'false' && Boolean(config.webConfig.headless);
+        }
+    }
+    catch {
+        /* ignore config load failures */
+    }
     const concurrency = options.concurrency !== undefined ? parseInt(String(options.concurrency), 10) : undefined;
     const outputFile = options.output ? path.resolve(cwd, options.output) : undefined;
     // Reuses the exact same semantic terminal reporter `spectra run` drives (see
@@ -72,31 +116,81 @@ export async function testCommand(options = {}) {
     // / setup.ts), so the same Reporter class parses them with zero changes on either side.
     const reporter = new Reporter();
     const runStartedAt = Date.now();
-    const ok = await reactPkg.runComponentTests({
-        cwd,
-        headless,
-        stepDelayMs,
-        spec: options.spec,
-        outputFile,
-        concurrency: concurrency !== undefined && !isNaN(concurrency) ? concurrency : undefined,
-        browserExecutablePath,
-        onLine: (line) => {
-            if (!line.startsWith('[TESTSPECTRA_'))
-                return;
-            reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'INFO', message: line });
-            if (!reporter.isInteractiveMode()) {
-                console.log(line);
-            }
-        },
-    });
+    let ok = false;
+    if (options.runner === 'vitest') {
+        logPhase('Starting component test runner (Vitest Browser Mode)…');
+        ok = await reactPkg.runComponentTests({
+            runner: 'vitest',
+            cwd,
+            headless,
+            stepDelayMs,
+            spec: options.spec,
+            outputFile,
+            concurrency: concurrency !== undefined && !isNaN(concurrency) ? concurrency : undefined,
+            browserExecutablePath,
+            onLine: (line) => {
+                const cleanLine = line.replace(/\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g, '').trim();
+                if (!cleanLine)
+                    return;
+                if (cleanLine.startsWith('[TESTSPECTRA_')) {
+                    reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'INFO', message: cleanLine });
+                    if (!reporter.isInteractiveMode()) {
+                        console.log(cleanLine);
+                    }
+                    return;
+                }
+                if (reactPkg.isVitestNoise?.(cleanLine)) {
+                    return;
+                }
+                const sanitized = reactPkg.sanitizeErrorMessage?.(cleanLine) ?? cleanLine;
+                reporter.addLog({ timestamp: new Date().toLocaleTimeString(), level: 'ERROR', message: sanitized });
+                if (!reporter.isInteractiveMode()) {
+                    console.error(chalk.red(sanitized));
+                }
+            },
+        });
+    }
+    else {
+        logPhase('Starting component test runner (Spectra Native CDP Engine)…');
+        const bundleServer = await reactPkg.startBundleServer({
+            testRoot: cwd,
+            stepDelayMs: stepDelayMs ?? 0,
+        });
+        try {
+            const home = process.env.HOME || process.env.USERPROFILE || '';
+            const globalAppDataPath = path.join(home, '.testspectra');
+            const appDataPath = globalAppDataPath;
+            const runResult = await RustCoreBridge.run({
+                baseDir: cwd,
+                appDataPath,
+                platform: 'component',
+                config: {
+                    bundleServerUrl: bundleServer.url,
+                    webConfig: {
+                        headless,
+                        stepDelay: stepDelayMs,
+                        browserExecutablePath,
+                    },
+                },
+                specs: options.spec ? [options.spec] : undefined,
+                concurrency: concurrency !== undefined && !isNaN(concurrency) ? concurrency : undefined,
+                outputJsonPath: outputFile,
+            }, reporter);
+            ok = runResult.status.toLowerCase() === 'passed';
+        }
+        finally {
+            bundleServer.stop();
+        }
+    }
     const durationMs = Date.now() - runStartedAt;
     const result = reporter.generateResult(ok ? 'passed' : 'failed', `${(durationMs / 1000).toFixed(1)}s`);
-    const totalTests = result.passedCount + result.failedCount;
+    const failedCount = !ok && result.failedCount === 0 ? 1 : result.failedCount;
+    const totalTests = result.passedCount + failedCount;
     renderSummaryView({
         totalSuites: totalTests,
         totalTests,
         passedCount: result.passedCount,
-        failedCount: result.failedCount,
+        failedCount,
         durationMs,
         reportLocation: outputFile ? path.relative(cwd, outputFile) : '(use -o/--output to save a report)',
     });

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,12 @@
+export interface PackageUpdate {
+    pkg: string;
+    current: string | null;
+    latest: string | null;
+    needsUpdate: boolean;
+}
+export declare function upgradeCommand(requestedPackages?: string[], options?: {
+    check?: boolean;
+    packagesOnly?: boolean;
+    driversOnly?: boolean;
+    json?: boolean;
+}): Promise<void>;