@react-native-harness/cli 1.0.0-alpha.11 → 1.0.0-alpha.13

package/README.md

@@ -1,7 +1,26 @@
-# cli
+![harness-banner](https://react-native-harness.dev/harness-banner.jpg)
 
-This library was generated with [Nx](https://nx.dev).
+### Command Line Interface for React Native Harness
 
-## Building
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
+[![PRs Welcome][prs-welcome-badge]][prs-welcome]
 
-Run `nx build cli` to build the library.
+Command-line interface that orchestrates test execution across iOS simulators and Android emulators, managing the entire testing workflow from bundling to result reporting.
+
+## Made with ❤️ at Callstack
+
+`@react-native-harness/cli` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. [Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
+
+Like the project? ⚛️ [Join the team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
+
+[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=react-native-harness&utm_term=readme-with-love
+[license-badge]: https://img.shields.io/npm/l/@react-native-harness/cli?style=for-the-badge
+[license]: https://github.com/callstackincubator/react-native-harness/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@react-native-harness/cli?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@react-native-harness/cli
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: ../../CONTRIBUTING.md
+[chat-badge]: https://img.shields.io/discord/426714625279524876.svg?style=for-the-badge
+[chat]: https://discord.gg/xgGt7KAjxv

package/dist/commands/test.d.ts

@@ -1,2 +1,3 @@
-export declare const testCommand: (runnerName?: string, pattern?: string) => Promise<void>;
+import { type TestFilterOptions } from '../discovery/index.js';
+export declare const testCommand: (runnerName?: string, options?: TestFilterOptions) => Promise<void>;
 //# sourceMappingURL=test.d.ts.map

package/dist/commands/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AA4KA,eAAO,MAAM,WAAW,GACtB,aAAa,MAAM,EACnB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CA0Cd,CAAC"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AA6J/B,eAAO,MAAM,WAAW,GACtB,aAAa,MAAM,EACnB,UAAS,iBAAsB,KAC9B,OAAO,CAAC,IAAI,CA0Cd,CAAC"}

package/dist/commands/test.js

@@ -1,11 +1,11 @@
 import { getBridgeServer, } from '@react-native-harness/bridge/server';
 import { getConfig, } from '@react-native-harness/config';
 import { getPlatformAdapter } from '../platforms/platform-registry.js';
-import { Glob } from 'glob';
-import { intro, logger, outro, spinner, progress, } from '@react-native-harness/tools';
+import { intro, logger, outro, spinner } from '@react-native-harness/tools';
 import { BridgeTimeoutError } from '../errors/errors.js';
 import { assert } from '../utils.js';
 import { EnvironmentInitializationError, NoRunnerSpecifiedError, RpcClientError, RunnerNotFoundError, } from '../errors/errors.js';
+import { discoverTestFiles, } from '../discovery/index.js';
 const setupEnvironment = async (context) => {
     const startSpinner = spinner();
     const platform = context.runner.platform;
@@ -33,28 +33,24 @@ const setupEnvironment = async (context) => {
     }
     startSpinner.stop(`"${context.runner.name}" (${platform}) runner started`);
 };
-const findTestFiles = async (context, pattern) => {
+const findTestFiles = async (context, options = {}) => {
     const discoverSpinner = spinner();
     discoverSpinner.start('Discovering tests');
-    const globPattern = pattern || context.config.include;
-    const glob = new Glob(globPattern, {
-        cwd: context.projectRoot,
-    });
-    context.testFiles = await glob.walk();
+    context.testFiles = await discoverTestFiles(context.projectRoot, context.config.include, options);
     discoverSpinner.stop(`Found ${context.testFiles.length} test files`);
 };
-const runTests = async (context) => {
+const runTests = async (context, options = {}) => {
     const { bridge, environment, testFiles } = context;
     assert(bridge != null, 'Bridge not initialized');
     assert(environment != null, 'Environment not initialized');
     assert(testFiles != null, 'Test files not initialized');
-    let runSpinner = progress({ style: 'block' });
+    let runSpinner = spinner();
     runSpinner.start('Running tests');
     let shouldRestart = false;
     for (const testFile of testFiles) {
         if (shouldRestart) {
-            runSpinner = progress({ style: 'block' });
-            runSpinner.message(`Restarting environment for next test file`);
+            runSpinner = spinner();
+            runSpinner.start(`Restarting environment for next test file`);
             await new Promise((resolve) => {
                 bridge.once('ready', resolve);
                 environment.restart();
@@ -65,10 +61,16 @@ const runTests = async (context) => {
         if (!client) {
             throw new RpcClientError('No RPC client available', 3001, 'No clients connected');
         }
-        const result = await client.runTests(testFile);
+        // Pass only testNamePattern to runtime (file filtering already done)
+        const executionOptions = {
+            testNamePattern: options.testNamePattern,
+        };
+        const result = await client.runTests(testFile, executionOptions);
         context.results = [...(context.results ?? []), ...result.suites];
         shouldRestart = true;
+        runSpinner.stop(`Test file ${testFile} completed`);
     }
+    runSpinner.stop('Tests completed');
 };
 const cleanUp = async (context) => {
     if (context.bridge) {
@@ -97,7 +99,7 @@ const hasFailedTests = (results) => {
     }
     return false;
 };
-export const testCommand = async (runnerName, pattern) => {
+export const testCommand = async (runnerName, options = {}) => {
     intro('React Native Test Harness');
     const { config, projectRoot } = await getConfig(process.cwd());
     const selectedRunnerName = runnerName ?? config.defaultRunner;
@@ -117,8 +119,8 @@ export const testCommand = async (runnerName, pattern) => {
     };
     try {
         await setupEnvironment(context);
-        await findTestFiles(context, pattern);
-        await runTests(context);
+        await findTestFiles(context, options);
+        await runTests(context, options);
         assert(context.results != null, 'Results not initialized');
         config.reporter?.report(context.results);
     }

package/dist/discovery/index.d.ts

@@ -0,0 +1,3 @@
+export { discoverTestFiles } from './testDiscovery.js';
+export type { TestFilterOptions } from './testDiscovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1 @@
+export { discoverTestFiles } from './testDiscovery.js';

package/dist/discovery/testDiscovery.d.ts

@@ -0,0 +1,11 @@
+export type TestFilterOptions = {
+    testNamePattern?: string;
+    testPathPattern?: string;
+    testPathIgnorePatterns?: string[];
+    testMatch?: string[];
+};
+/**
+ * Discovers test files based on patterns and filtering options
+ */
+export declare const discoverTestFiles: (projectRoot: string, configInclude: string | string[], options?: TestFilterOptions) => Promise<string[]>;
+//# sourceMappingURL=testDiscovery.d.ts.map

package/dist/discovery/testDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/testDiscovery.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,MAAM,EACnB,eAAe,MAAM,GAAG,MAAM,EAAE,EAChC,UAAS,iBAAsB,KAC9B,OAAO,CAAC,MAAM,EAAE,CAiClB,CAAC"}

package/dist/discovery/testDiscovery.js

@@ -0,0 +1,29 @@
+import { Glob } from 'glob';
+/**
+ * Discovers test files based on patterns and filtering options
+ */
+export const discoverTestFiles = async (projectRoot, configInclude, options = {}) => {
+    // Priority: testMatch > configInclude
+    const patterns = options.testMatch || configInclude;
+    const patternArray = Array.isArray(patterns) ? patterns : [patterns];
+    // Glob discovery
+    const allFiles = [];
+    for (const pattern of patternArray) {
+        const glob = new Glob(pattern, { cwd: projectRoot, nodir: true });
+        const files = await glob.walk();
+        allFiles.push(...files);
+    }
+    // Remove duplicates
+    let uniqueFiles = [...new Set(allFiles)];
+    // Apply testPathPattern filtering
+    if (options.testPathPattern) {
+        const regex = new RegExp(options.testPathPattern);
+        uniqueFiles = uniqueFiles.filter((file) => regex.test(file));
+    }
+    // Apply testPathIgnorePatterns filtering
+    if (options.testPathIgnorePatterns?.length) {
+        const ignoreRegexes = options.testPathIgnorePatterns.map((p) => new RegExp(p));
+        uniqueFiles = uniqueFiles.filter((file) => !ignoreRegexes.some((regex) => regex.test(file)));
+    }
+    return uniqueFiles;
+};

package/dist/errors/errorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/errorHandler.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,IAkL5C,CAAC"}
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/errors/errorHandler.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,IA8L5C,CAAC"}

package/dist/errors/errorHandler.js

@@ -104,16 +104,26 @@ export const handleError = (error) => {
     }
     else if (error instanceof AppNotInstalledError) {
         console.error(`\n❌ App Not Installed`);
-        console.error(`\nThe app "${error.bundleId}" is not installed on ${error.platform === 'ios' ? 'simulator' : 'emulator'} "${error.deviceName}".`);
+        const deviceType = error.platform === 'ios'
+            ? 'simulator'
+            : error.platform === 'android'
+                ? 'emulator'
+                : 'virtual device';
+        console.error(`\nThe app "${error.bundleId}" is not installed on ${deviceType} "${error.deviceName}".`);
         console.error(`\nTo resolve this issue:`);
         if (error.platform === 'ios') {
             console.error(`  • Build and install the app: npx react-native run-ios --simulator="${error.deviceName}"`);
             console.error(`  • Or install from Xcode: Open ios/*.xcworkspace and run the project`);
         }
-        else {
+        else if (error.platform === 'android') {
             console.error(`  • Build and install the app: npx react-native run-android`);
             console.error(`  • Or build manually: ./gradlew assembleDebug && adb install android/app/build/outputs/apk/debug/app-debug.apk`);
         }
+        else if (error.platform === 'vega') {
+            console.error(`  • Build the Vega app: npm run build:app`);
+            console.error(`  • Install the app: kepler device install-app -p <path-to-vpkg> --device "${error.deviceName}"`);
+            console.error(`  • Or use the combined command: kepler run-kepler <path-to-vpkg> "${error.bundleId}" -d "${error.deviceName}"`);
+        }
         console.error(`\nPlease install the app and try running the tests again.`);
     }
     else if (error instanceof BundlingFailedError) {

package/dist/errors/errors.d.ts

@@ -35,8 +35,8 @@ export declare class BridgeTimeoutError extends Error {
 export declare class AppNotInstalledError extends Error {
     readonly deviceName: string;
     readonly bundleId: string;
-    readonly platform: 'ios' | 'android';
-    constructor(deviceName: string, bundleId: string, platform: 'ios' | 'android');
+    readonly platform: 'ios' | 'android' | 'vega';
+    constructor(deviceName: string, bundleId: string, platform: 'ios' | 'android' | 'vega');
 }
 export declare class BundlingFailedError extends Error {
     readonly modulePath: string;

package/dist/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,gBAAgB,EAAE,gBAAgB,EAAE;IAKhD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE;IAMpE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAErD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM;IAUlB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAEzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM;IAenB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAS3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAFhB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAOnC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,KAAK,GAAG,SAAS;gBAF3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,GAAG,SAAS;CAS9C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBADd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,gBAAgB,EAAE,gBAAgB,EAAE;IAKhD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE;IAMpE,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA+B,SAAQ,KAAK;gBAErD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM;IAUlB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAEzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM;IAenB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAS3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;gBAFhB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;CAOnC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,UAAU,EAAE,MAAM;aAClB,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM;gBAFpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM;CAcvD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,UAAU,EAAE,MAAM;aAClB,MAAM,EAAE,MAAM;gBADd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM;CAKjC"}

package/dist/errors/errors.js

@@ -74,7 +74,12 @@ export class AppNotInstalledError extends Error {
     bundleId;
     platform;
     constructor(deviceName, bundleId, platform) {
-        super(`App "${bundleId}" is not installed on ${platform === 'ios' ? 'simulator' : 'emulator'} "${deviceName}"`);
+        const deviceType = platform === 'ios'
+            ? 'simulator'
+            : platform === 'android'
+                ? 'emulator'
+                : 'virtual device';
+        super(`App "${bundleId}" is not installed on ${deviceType} "${deviceName}"`);
         this.deviceName = deviceName;
         this.bundleId = bundleId;
         this.platform = platform;

package/dist/index.js

@@ -10,19 +10,35 @@ const __dirname = dirname(__filename);
 const packageJsonPath = join(__dirname, '../package.json');
 const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
 const program = new Command();
-logger.setVerbose(true);
 program
     .name('react-native-harness')
     .description('React Native Test Harness - A comprehensive testing framework for React Native applications')
-    .version(packageJson.version);
+    .version(packageJson.version)
+    .option('-v, --verbose', 'Enable verbose logging')
+    .hook('preAction', (thisCommand) => {
+    // Handle global verbose option
+    const opts = thisCommand.optsWithGlobals();
+    if (opts.verbose) {
+        logger.setVerbose(true);
+    }
+});
 program
     .command('test')
     .description('Run tests using the specified runner')
     .argument('[runner]', 'test runner name (uses defaultRunner from config if not specified)')
     .argument('[pattern]', 'glob pattern to match test files (uses config.include if not specified)')
-    .action(async (runner, pattern) => {
+    .option('-t, --testNamePattern <pattern>', 'Run only tests with names matching regex pattern')
+    .option('--testPathPattern <pattern>', 'Run only test files with paths matching regex pattern')
+    .option('--testPathIgnorePatterns <patterns...>', 'Ignore test files matching these patterns')
+    .option('--testMatch <patterns...>', 'Override config.include with these glob patterns')
+    .action(async (runner, pattern, options) => {
     try {
-        await testCommand(runner, pattern);
+        // Convert CLI pattern argument to testMatch option
+        const mergedOptions = {
+            ...options,
+            testMatch: pattern ? [pattern] : options.testMatch,
+        };
+        await testCommand(runner, mergedOptions);
     }
     catch (error) {
         handleError(error);

package/dist/platforms/android/index.js

@@ -41,7 +41,7 @@ const androidPlatformAdapter = {
         logger.debug('App running');
         return {
             restart: async () => {
-                await runApp(runner.deviceId, runner.bundleId, runner.activityName);
+                await runApp(deviceId, runner.bundleId, runner.activityName);
             },
             dispose: async () => {
                 await killApp(deviceId, runner.bundleId);

package/dist/platforms/platform-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-registry.d.ts","sourceRoot":"","sources":["../../src/platforms/platform-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAWxD,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,KACnB,OAAO,CAAC,eAAe,CAUzB,CAAC"}
+{"version":3,"file":"platform-registry.d.ts","sourceRoot":"","sources":["../../src/platforms/platform-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAaxD,eAAO,MAAM,kBAAkB,GAC7B,cAAc,MAAM,KACnB,OAAO,CAAC,eAAe,CAUzB,CAAC"}

package/dist/platforms/platform-registry.js

@@ -1,10 +1,12 @@
 import androidPlatformAdapter from './android/index.js';
 import iosPlatformAdapter from './ios/index.js';
 import webPlatformAdapter from './web/index.js';
+import vegaPlatformAdapter from './vega/index.js';
 const platformAdapters = {
     android: androidPlatformAdapter,
     ios: iosPlatformAdapter,
     web: webPlatformAdapter,
+    vega: vegaPlatformAdapter,
 };
 export const getPlatformAdapter = async (platformName) => {
     if (!(platformName in platformAdapters)) {

package/dist/platforms/vega/build.d.ts

@@ -0,0 +1,23 @@
+export type VegaBuildTarget = 'sim_tv_x86_64' | 'sim_tv_aarch64';
+export type VegaBuildType = 'Debug' | 'Release';
+/**
+ * Build Vega app and produce .vpkg file
+ */
+export declare const buildVegaApp: (buildType?: VegaBuildType, target?: VegaBuildTarget) => Promise<void>;
+/**
+ * Clean build artifacts
+ */
+export declare const cleanBuild: () => Promise<void>;
+/**
+ * Get the expected .vpkg file path based on build configuration
+ */
+export declare const getVpkgPath: (appName: string, buildType?: VegaBuildType, target?: VegaBuildTarget) => string;
+/**
+ * Launch an already installed app on specified Vega virtual device
+ */
+export declare const runApp: (deviceId: string, bundleId: string) => Promise<void>;
+/**
+ * Kill/terminate app on specified Vega virtual device
+ */
+export declare const killApp: (deviceId: string, bundleId: string) => Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/platforms/vega/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/platforms/vega/build.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,gBAAgB,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,YAAW,aAAyB,EACpC,SAAS,eAAe,KACvB,OAAO,CAAC,IAAI,CAYd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAE/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,SAAS,MAAM,EACf,YAAW,aAAyB,EACpC,SAAQ,eAAiC,KACxC,MAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,GACjB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CASd,CAAC"}

package/dist/platforms/vega/build.js

@@ -0,0 +1,55 @@
+import path from 'node:path';
+import { spawn } from '@react-native-harness/tools';
+/**
+ * Build Vega app and produce .vpkg file
+ */
+export const buildVegaApp = async (buildType = 'Release', target) => {
+    const args = ['run', 'build:app'];
+    if (buildType) {
+        args.push('-b', buildType);
+    }
+    if (target) {
+        args.push('-t', target);
+    }
+    await spawn('npm', args);
+};
+/**
+ * Clean build artifacts
+ */
+export const cleanBuild = async () => {
+    await spawn('kepler', ['clean']);
+};
+/**
+ * Get the expected .vpkg file path based on build configuration
+ */
+export const getVpkgPath = (appName, buildType = 'Release', target = 'sim_tv_x86_64') => {
+    const buildTypeStr = buildType.toLowerCase();
+    const vpkgFileName = `${appName}_${target}.vpkg`;
+    return path.join(process.cwd(), 'build', `${target}-${buildTypeStr}`, vpkgFileName);
+};
+/**
+ * Launch an already installed app on specified Vega virtual device
+ */
+export const runApp = async (deviceId, bundleId) => {
+    await spawn('kepler', [
+        'device',
+        'launch-app',
+        '--device',
+        deviceId,
+        '--appName',
+        bundleId,
+    ]);
+};
+/**
+ * Kill/terminate app on specified Vega virtual device
+ */
+export const killApp = async (deviceId, bundleId) => {
+    await spawn('kepler', [
+        'device',
+        'terminate-app',
+        '--device',
+        deviceId,
+        '--appName',
+        bundleId,
+    ]);
+};

package/dist/platforms/vega/device.d.ts

@@ -0,0 +1,57 @@
+export type VegaVirtualDeviceStatus = 'running' | 'stopped';
+/**
+ * List all available Vega virtual devices
+ * Returns array of device identifiers that can be used with kepler commands
+ */
+export declare const listVegaDevices: () => Promise<string[]>;
+/**
+ * Check if a specific Vega virtual device is connected/available
+ */
+export declare const isVegaDeviceConnected: (deviceId: string) => Promise<boolean>;
+/**
+ * Check if an app is installed on the specified Vega virtual device
+ */
+export declare const isAppInstalled: (deviceId: string, bundleId: string) => Promise<boolean>;
+/**
+ * Check if an app is currently running on the specified Vega virtual device
+ */
+export declare const isAppRunning: (deviceId: string, bundleId: string) => Promise<boolean>;
+/**
+ * Install app on specified Vega virtual device using .vpkg file
+ */
+export declare const installApp: (deviceId: string, vpkgPath: string) => Promise<void>;
+/**
+ * Terminate app on specified Vega virtual device
+ */
+export declare const terminateApp: (deviceId: string, bundleId: string) => Promise<void>;
+/**
+ * Uninstall app from specified Vega virtual device
+ */
+export declare const uninstallApp: (deviceId: string, bundleId: string) => Promise<void>;
+/**
+ * Start port forwarding for debugging on specified Vega virtual device
+ */
+export declare const startPortForwarding: (deviceId: string, port: number, forward?: boolean) => Promise<void>;
+/**
+ * Stop port forwarding on specified Vega virtual device
+ */
+export declare const stopPortForwarding: (deviceId: string, port: number, forward?: boolean) => Promise<void>;
+/**
+ * Get status of a specific Vega virtual device
+ * Note: Vega CLI might manage virtual devices globally, so this checks if the device is available
+ */
+export declare const getVegaDeviceStatus: (deviceId: string) => Promise<VegaVirtualDeviceStatus>;
+/**
+ * Start Vega Virtual Device
+ * Note: Vega might manage virtual devices globally, this starts the virtual device system
+ */
+export declare const startVirtualDevice: () => Promise<void>;
+/**
+ * Stop Vega Virtual Device
+ */
+export declare const stopVirtualDevice: () => Promise<void>;
+/**
+ * Combined install and run command for specified Vega virtual device (Vega-specific convenience method)
+ */
+export declare const runKepler: (deviceId: string, vpkgPath: string, bundleId: string) => Promise<void>;
+//# sourceMappingURL=device.d.ts.map

package/dist/platforms/vega/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/platforms/vega/device.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,MAAM,EAAE,CAwBxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAYjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAcjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,OAAO,CAcjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CASd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,UAAS,OAAc,KACtB,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,MAAM,MAAM,EACZ,UAAS,OAAc,KACtB,OAAO,CAAC,IAAI,CAWd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,KACf,OAAO,CAAC,uBAAuB,CAkBjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,IAAI,CAqBvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAEtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,IAAI,CAEd,CAAC"}