@rnx-kit/cli 0.16.28 → 0.16.30

package/lib/helpers/externals.d.ts

@@ -0,0 +1,4 @@
+import type { CliServerApi, CoreDevMiddleware } from "../serve/types";
+export declare function requireExternal(module: "@react-native-community/cli-server-api", projectRoot: string, reactNativePath: string): CliServerApi;
+export declare function requireExternal(module: "@react-native/dev-middleware", projectRoot: string, reactNativePath: string): CoreDevMiddleware;
+//# sourceMappingURL=externals.d.ts.map

package/lib/{serve/external.js → helpers/externals.js}

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireExternal = void 0;
+exports.requireExternal = requireExternal;
 const package_1 = require("@rnx-kit/tools-node/package");
-function friendlyRequire(...modules) {
+const context_1 = require("@rnx-kit/tools-react-native/context");
+function friendlyRequire(modules, startDir) {
     try {
-        const modulePath = (0, package_1.resolveDependencyChain)(modules);
+        const modulePath = (0, package_1.resolveDependencyChain)(modules, startDir);
         return require(modulePath);
     }
     catch (_) {
@@ -16,15 +17,15 @@ function friendlyRequire(...modules) {
             "file a bug at https://github.com/microsoft/rnx-kit/issues.");
     }
 }
-function requireExternal(module) {
+function requireExternal(module, projectRoot, reactNativePath) {
     switch (module) {
-        case "@react-native-community/cli-clean":
-            return friendlyRequire("react-native", "@react-native-community/cli", "@react-native-community/cli-clean");
         case "@react-native-community/cli-server-api":
-            return friendlyRequire("react-native", "@react-native-community/cli", "@react-native-community/cli-server-api");
+            return friendlyRequire([
+                "@react-native-community/cli",
+                "@react-native-community/cli-server-api",
+            ], (0, context_1.resolveCommunityCLI)(projectRoot, reactNativePath));
         case "@react-native/dev-middleware":
-            return friendlyRequire("react-native", "@react-native/community-cli-plugin", "@react-native/dev-middleware");
+            return friendlyRequire(["@react-native/community-cli-plugin", "@react-native/dev-middleware"], reactNativePath);
     }
 }
-exports.requireExternal = requireExternal;
-//# sourceMappingURL=external.js.map
+//# sourceMappingURL=externals.js.map

package/lib/helpers/filesystem.d.ts

@@ -0,0 +1,3 @@
+import * as nodefs from "fs";
+export declare function ensureDir(p: string, fs?: typeof nodefs): void;
+//# sourceMappingURL=filesystem.d.ts.map

package/lib/helpers/filesystem.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDir = ensureDir;
+const nodefs = __importStar(require("fs"));
+function ensureDir(p, fs = nodefs) {
+    fs.mkdirSync(p, { recursive: true, mode: 0o755 });
+}
+//# sourceMappingURL=filesystem.js.map

package/lib/{metro-config.js → helpers/metro-config.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.customizeMetroConfig = void 0;
+exports.customizeMetroConfig = customizeMetroConfig;
 const console_1 = require("@rnx-kit/console");
 const metro_plugin_cyclic_dependencies_detector_1 = require("@rnx-kit/metro-plugin-cyclic-dependencies-detector");
 const metro_plugin_duplicates_checker_1 = require("@rnx-kit/metro-plugin-duplicates-checker");
 const metro_plugin_typescript_1 = require("@rnx-kit/metro-plugin-typescript");
 const metro_serializer_1 = require("@rnx-kit/metro-serializer");
 const metro_serializer_esbuild_1 = require("@rnx-kit/metro-serializer-esbuild");
-const defaultPlugins_1 = require("./bundle/defaultPlugins");
+const defaultPlugins_1 = require("../bundle/defaultPlugins");
 function resolvePlugin(name) {
     try {
         return require.resolve(name);
@@ -159,5 +159,4 @@ function customizeMetroConfig(metroConfigReadonly, extraParams, print) {
             break;
     }
 }
-exports.customizeMetroConfig = customizeMetroConfig;
 //# sourceMappingURL=metro-config.js.map

package/lib/{parsers.d.ts → helpers/parsers.d.ts}

@@ -3,5 +3,5 @@ export declare function asBoolean(value: string): boolean;
 export declare function asNumber(value: string): number;
 export declare function asResolvedPath(value: string): string;
 export declare function asStringArray(value: string): string[];
-export declare function parseTransformProfile(val: string): TransformProfile;
+export declare function asTransformProfile(val: string): TransformProfile;
 //# sourceMappingURL=parsers.d.ts.map

package/lib/{parsers.js → helpers/parsers.js}

@@ -23,7 +23,11 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseTransformProfile = exports.asStringArray = exports.asResolvedPath = exports.asNumber = exports.asBoolean = void 0;
+exports.asBoolean = asBoolean;
+exports.asNumber = asNumber;
+exports.asResolvedPath = asResolvedPath;
+exports.asStringArray = asStringArray;
+exports.asTransformProfile = asTransformProfile;
 const path = __importStar(require("path"));
 function asBoolean(value) {
     switch (value) {
@@ -32,35 +36,32 @@ function asBoolean(value) {
         case "true":
             return true;
         default:
-            throw new Error("Invalid boolean value '" + value + "' — must be true or false");
+            throw new Error(`Expected 'true' or 'false; got '${value}'`);
     }
 }
-exports.asBoolean = asBoolean;
 function asNumber(value) {
     return Number(value);
 }
-exports.asNumber = asNumber;
 function asResolvedPath(value) {
     return path.resolve(value);
 }
-exports.asResolvedPath = asResolvedPath;
 function asStringArray(value) {
     return value.split(",");
 }
-exports.asStringArray = asStringArray;
-function parseTransformProfile(val) {
-    const allowedProfiles = [
-        "hermes-stable",
-        "hermes-canary",
-        "default",
-    ];
-    if (val in allowedProfiles) {
-        return val;
+function asTransformProfile(val) {
+    switch (val) {
+        case "hermes-stable":
+        case "hermes-canary":
+        case "default":
+            return val;
+        default: {
+            const profiles = [
+                "hermes-stable",
+                "hermes-canary",
+                "default",
+            ];
+            throw new Error(`Expected '${profiles.join("', '")}'; got ${val}`);
+        }
     }
-    throw new Error("Invalid transform profile '" +
-        val +
-        "' -- must be one of " +
-        allowedProfiles.join(", "));
 }
-exports.parseTransformProfile = parseTransformProfile;
 //# sourceMappingURL=parsers.js.map

package/lib/index.d.ts

@@ -25,11 +25,11 @@ export declare const reactNativeConfig: {
             name: string;
             description: string;
             default: boolean;
-            parse: typeof import("./parsers").asBoolean;
+            parse: typeof import("./helpers/parsers").asBoolean;
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asBoolean;
+            parse: typeof import("./helpers/parsers").asBoolean;
             default?: undefined;
         } | {
             name: string;
@@ -39,12 +39,12 @@ export declare const reactNativeConfig: {
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asNumber;
+            parse: typeof import("./helpers/parsers").asNumber;
             default?: undefined;
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").parseTransformProfile;
+            parse: typeof import("./helpers/parsers").asTransformProfile;
             default?: undefined;
         })[];
     } | {
@@ -60,7 +60,7 @@ export declare const reactNativeConfig: {
             name: string;
             description: string;
             default: string;
-            parse: typeof import("./parsers").asResolvedPath;
+            parse: typeof import("./helpers/parsers").asResolvedPath;
         } | {
             name: string;
             description: string;
@@ -105,11 +105,11 @@ export declare const reactNativeConfig: {
             name: string;
             description: string;
             default: boolean;
-            parse: typeof import("./parsers").asBoolean;
+            parse: typeof import("./helpers/parsers").asBoolean;
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asBoolean;
+            parse: typeof import("./helpers/parsers").asBoolean;
             default?: undefined;
         } | {
             name: string;
@@ -119,12 +119,12 @@ export declare const reactNativeConfig: {
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asNumber;
+            parse: typeof import("./helpers/parsers").asNumber;
             default?: undefined;
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").parseTransformProfile;
+            parse: typeof import("./helpers/parsers").asTransformProfile;
             default?: undefined;
         })[];
     } | {
@@ -134,7 +134,7 @@ export declare const reactNativeConfig: {
         options: ({
             name: string;
             description: string;
-            parse: typeof import("./parsers").asNumber;
+            parse: typeof import("./helpers/parsers").asNumber;
             default: number;
         } | {
             name: string;
@@ -144,7 +144,7 @@ export declare const reactNativeConfig: {
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asResolvedPath;
+            parse: typeof import("./helpers/parsers").asResolvedPath;
             default?: undefined;
         } | {
             name: string;
@@ -154,7 +154,7 @@ export declare const reactNativeConfig: {
         } | {
             name: string;
             description: string;
-            parse: typeof import("./parsers").asNumber;
+            parse: typeof import("./helpers/parsers").asNumber;
             default?: undefined;
         } | {
             name: string;
@@ -168,9 +168,9 @@ export declare const reactNativeConfig: {
         func: typeof import("./test").rnxTest;
         options: {
             name: string;
-            description?: string | undefined;
-            parse?: ((val: string) => unknown) | undefined;
-            default?: string | number | boolean | ((config: import("@react-native-community/cli-types").Config) => string | number | boolean) | undefined;
+            description?: string;
+            parse?: (val: string) => unknown;
+            default?: string | boolean | number | ((config: import("@react-native-community/cli-types").Config) => string | boolean | number);
         }[];
     } | {
         name: string;
@@ -191,7 +191,6 @@ export { rnxAlignDeps, rnxAlignDepsCommand } from "./align-deps";
 export { rnxBundle, rnxBundleCommand } from "./bundle";
 export { rnxClean, rnxCleanCommand } from "./clean";
 export { copyProjectAssets, rnxCopyAssetsCommand } from "./copy-assets";
-export { asBoolean, asNumber, parseTransformProfile } from "./parsers";
 export { rnxRamBundle, rnxRamBundleCommand } from "./ram-bundle";
 export { rnxStart, rnxStartCommand } from "./start";
 export { rnxTest, rnxTestCommand } from "./test";

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rnxWriteThirdPartyNoticesCommand = exports.rnxWriteThirdPartyNotices = exports.rnxTestCommand = exports.rnxTest = exports.rnxStartCommand = exports.rnxStart = exports.rnxRamBundleCommand = exports.rnxRamBundle = exports.parseTransformProfile = exports.asNumber = exports.asBoolean = exports.rnxCopyAssetsCommand = exports.copyProjectAssets = exports.rnxCleanCommand = exports.rnxClean = exports.rnxBundleCommand = exports.rnxBundle = exports.rnxAlignDepsCommand = exports.rnxAlignDeps = exports.reactNativeConfig = void 0;
+exports.rnxWriteThirdPartyNoticesCommand = exports.rnxWriteThirdPartyNotices = exports.rnxTestCommand = exports.rnxTest = exports.rnxStartCommand = exports.rnxStart = exports.rnxRamBundleCommand = exports.rnxRamBundle = exports.rnxCopyAssetsCommand = exports.copyProjectAssets = exports.rnxCleanCommand = exports.rnxClean = exports.rnxBundleCommand = exports.rnxBundle = exports.rnxAlignDepsCommand = exports.rnxAlignDeps = exports.reactNativeConfig = void 0;
 const align_deps_1 = require("./align-deps");
 const bundle_1 = require("./bundle");
 const clean_1 = require("./clean");
@@ -33,10 +33,6 @@ Object.defineProperty(exports, "rnxCleanCommand", { enumerable: true, get: funct
 var copy_assets_2 = require("./copy-assets");
 Object.defineProperty(exports, "copyProjectAssets", { enumerable: true, get: function () { return copy_assets_2.copyProjectAssets; } });
 Object.defineProperty(exports, "rnxCopyAssetsCommand", { enumerable: true, get: function () { return copy_assets_2.rnxCopyAssetsCommand; } });
-var parsers_1 = require("./parsers");
-Object.defineProperty(exports, "asBoolean", { enumerable: true, get: function () { return parsers_1.asBoolean; } });
-Object.defineProperty(exports, "asNumber", { enumerable: true, get: function () { return parsers_1.asNumber; } });
-Object.defineProperty(exports, "parseTransformProfile", { enumerable: true, get: function () { return parsers_1.parseTransformProfile; } });
 var ram_bundle_2 = require("./ram-bundle");
 Object.defineProperty(exports, "rnxRamBundle", { enumerable: true, get: function () { return ram_bundle_2.rnxRamBundle; } });
 Object.defineProperty(exports, "rnxRamBundleCommand", { enumerable: true, get: function () { return ram_bundle_2.rnxRamBundleCommand; } });

package/lib/ram-bundle.d.ts

@@ -22,11 +22,11 @@ export declare const rnxRamBundleCommand: {
         name: string;
         description: string;
         default: boolean;
-        parse: typeof import("./parsers").asBoolean;
+        parse: typeof import("./helpers/parsers").asBoolean;
     } | {
         name: string;
         description: string;
-        parse: typeof import("./parsers").asBoolean;
+        parse: typeof import("./helpers/parsers").asBoolean;
         default?: undefined;
     } | {
         name: string;
@@ -36,12 +36,12 @@ export declare const rnxRamBundleCommand: {
     } | {
         name: string;
         description: string;
-        parse: typeof import("./parsers").asNumber;
+        parse: typeof import("./helpers/parsers").asNumber;
         default?: undefined;
     } | {
         name: string;
         description: string;
-        parse: typeof import("./parsers").parseTransformProfile;
+        parse: typeof import("./helpers/parsers").asTransformProfile;
         default?: undefined;
     })[];
 };

package/lib/ram-bundle.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rnxRamBundleCommand = exports.rnxRamBundle = void 0;
+exports.rnxRamBundleCommand = void 0;
+exports.rnxRamBundle = rnxRamBundle;
 const console_1 = require("@rnx-kit/console");
 const metro_service_1 = require("@rnx-kit/metro-service");
 const cliOptions_1 = require("./bundle/cliOptions");
@@ -31,16 +32,15 @@ async function rnxRamBundle(_argv, cliConfig, cliOptions) {
         await (0, metro_1.metroBundle)(metroConfig, bundleConfig, cliOptions.dev, cliOptions.minify, metro_service_1.ramBundle);
     }
 }
-exports.rnxRamBundle = rnxRamBundle;
 exports.rnxRamBundleCommand = {
     name: "rnx-ram-bundle",
-    description: "Bundle your rnx-kit package in the RAM bundle format for offline use. See https://aka.ms/rnx-kit.",
+    description: "[Deprecated] Bundle your JavaScript in the RAM bundle format for offline use",
     func: rnxRamBundle,
     options: [
         ...cliOptions_1.commonBundleCommandOptions,
         {
             name: "--indexed-ram-bundle",
-            description: 'Force the "Indexed RAM" bundle file format, even when targeting Android.',
+            description: 'Force the "Indexed RAM" bundle file format, even when targeting Android',
         },
     ],
 };

package/lib/serve/help.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeHelp = void 0;
+exports.makeHelp = makeHelp;
 const console_1 = require("@rnx-kit/console");
 function makeHelp(terminal, { hasDebugger }) {
     const openDebugger = hasDebugger
@@ -42,5 +42,4 @@ function makeHelp(terminal, { hasDebugger }) {
     const help = lines.join("\n");
     return () => terminal.log(help);
 }
-exports.makeHelp = makeHelp;
 //# sourceMappingURL=help.js.map

package/lib/serve/keyboard.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.attachKeyHandlers = void 0;
+exports.attachKeyHandlers = attachKeyHandlers;
 const console_1 = require("@rnx-kit/console");
 const node_fetch_1 = __importDefault(require("node-fetch"));
 const qrcode_1 = __importDefault(require("qrcode"));
@@ -60,5 +60,4 @@ function attachKeyHandlers({ devServerUrl, help, messageSocketEndpoint, terminal
     });
     readline_1.default.emitKeypressEvents(process.stdin);
 }
-exports.attachKeyHandlers = attachKeyHandlers;
 //# sourceMappingURL=keyboard.js.map

package/lib/serve/kit-config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getKitServerConfig = void 0;
+exports.getKitServerConfig = getKitServerConfig;
 const config_1 = require("@rnx-kit/config");
 const properties_1 = require("@rnx-kit/tools-language/properties");
 const defaultPlugins_1 = require("../bundle/defaultPlugins");
@@ -31,5 +31,4 @@ function getKitServerConfig(overrides) {
         ...(0, properties_1.pickValues)(overrides, ["projectRoot", "assetPlugins", "sourceExts"]),
     };
 }
-exports.getKitServerConfig = getKitServerConfig;
 //# sourceMappingURL=kit-config.js.map

package/lib/serve/types.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import type * as logger from "@rnx-kit/console";
 import type { Server as Middleware } from "connect";
 import type { Server as HttpServer } from "http";

package/lib/start.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from "@react-native-community/cli-types";
-import { asNumber, asResolvedPath } from "./parsers";
+import { asNumber, asResolvedPath } from "./helpers/parsers";
 import type { StartCommandArgs } from "./serve/types";
 export declare function rnxStart(_argv: string[], ctx: Config, args: StartCommandArgs): Promise<void>;
 export declare const rnxStartCommand: {

package/lib/start.js

@@ -23,13 +23,14 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rnxStartCommand = exports.rnxStart = void 0;
+exports.rnxStartCommand = void 0;
+exports.rnxStart = rnxStart;
 const logger = __importStar(require("@rnx-kit/console"));
 const metro_service_1 = require("@rnx-kit/metro-service");
 const path = __importStar(require("path"));
-const metro_config_1 = require("./metro-config");
-const parsers_1 = require("./parsers");
-const external_1 = require("./serve/external");
+const externals_1 = require("./helpers/externals");
+const metro_config_1 = require("./helpers/metro-config");
+const parsers_1 = require("./helpers/parsers");
 const help_1 = require("./serve/help");
 const keyboard_1 = require("./serve/keyboard");
 const kit_config_1 = require("./serve/kit-config");
@@ -39,7 +40,7 @@ function hasAttachToServerFunction(devServer) {
 async function rnxStart(_argv, ctx, args) {
     var _a;
     const serverConfig = (0, kit_config_1.getKitServerConfig)(args);
-    const { createDevServerMiddleware, indexPageMiddleware } = (0, external_1.requireExternal)("@react-native-community/cli-server-api");
+    const { createDevServerMiddleware, indexPageMiddleware } = (0, externals_1.requireExternal)("@react-native-community/cli-server-api", ctx.root, ctx.reactNativePath);
     // interactive mode requires raw access to stdin
     let interactive = args.interactive;
     if (interactive) {
@@ -89,7 +90,7 @@ async function rnxStart(_argv, ctx, args) {
     const coreDevMiddleware = (() => {
         try {
             // https://github.com/facebook/react-native/blob/7888338295476f4d4f00733309e54b8d22318e1e/packages/community-cli-plugin/src/commands/start/runServer.js#L115
-            const { createDevMiddleware } = (0, external_1.requireExternal)("@react-native/dev-middleware");
+            const { createDevMiddleware } = (0, externals_1.requireExternal)("@react-native/dev-middleware", ctx.root, ctx.reactNativePath);
             return createDevMiddleware({
                 projectRoot,
                 serverBaseUrl: devServerUrl,
@@ -185,80 +186,79 @@ async function rnxStart(_argv, ctx, args) {
         (0, keyboard_1.attachKeyHandlers)({ devServerUrl, help, messageSocketEndpoint, terminal });
     }
 }
-exports.rnxStart = rnxStart;
 exports.rnxStartCommand = {
     name: "rnx-start",
     func: rnxStart,
-    description: "Start a bundle-server to host your react-native experience during development",
+    description: "Start a React Native development server",
     options: [
         {
-            name: "--port [number]",
-            description: "Host port to use when listening for incoming server requests.",
+            name: "--port <number>",
+            description: "Host port to use when listening for incoming server requests",
             parse: parsers_1.asNumber,
             default: 8081,
         },
         {
-            name: "--host [string]",
-            description: "Host name or address to bind when listening for incoming server requests. When not given, requests from all addresses are accepted.",
+            name: "--host <string>",
+            description: "Host name or address to bind when listening for incoming server requests; when not specified, requests from all addresses are accepted",
             default: "",
         },
         {
-            name: "--projectRoot [path]",
-            description: "Path to the root of your react-native project. The bundle server uses this root path to resolve all web requests.",
+            name: "--project-root <path>",
+            description: "Path to the root of your react-native project; the bundle server uses this path to resolve all web requests",
             parse: parsers_1.asResolvedPath,
         },
         {
-            name: "--watchFolders [paths]",
-            description: "Additional folders which will be added to the file-watch list. Comma-separated. By default, Metro watches all project files.",
+            name: "--watch-folders <paths>",
+            description: "Additional folders which will be added to the watched files list, comma-separated; by default, Metro watches all project files",
             parse: (val) => (0, parsers_1.asStringArray)(val).map(parsers_1.asResolvedPath),
         },
         {
-            name: "--assetPlugins [list]",
-            description: "Additional asset plugins to be used by the Metro Babel transformer. Comma-separated list containing plugin module names or absolute paths to plugin packages.",
+            name: "--asset-plugins <list>",
+            description: "Additional asset plugins to be used by Metro's Babel transformer; comma-separated list containing plugin module names or absolute paths to plugin packages",
             parse: parsers_1.asStringArray,
         },
         {
-            name: "--sourceExts [list]",
-            description: "Additional source-file extensions to include when generating bundles. Comma-separated list, excluding the leading dot.",
+            name: "--source-exts <list>",
+            description: "Additional source file extensions to include when generating bundles; comma-separated list, excluding the leading dot",
             parse: parsers_1.asStringArray,
         },
         {
-            name: "--max-workers [number]",
-            description: "Specifies the maximum number of parallel worker threads to use for transforming files. This defaults to the number of cores available on your machine.",
+            name: "--max-workers <number>",
+            description: "Specifies the maximum number of parallel worker threads to use for transforming files; defaults to the number of cores available on your machine",
             parse: parsers_1.asNumber,
         },
         {
             name: "--reset-cache",
-            description: "Reset the Metro cache.",
+            description: "Reset the Metro cache",
         },
         {
-            name: "--custom-log-reporter-path [string]",
-            description: "Path to a JavaScript file which exports a Metro 'TerminalReporter' function. This replaces the default reporter, which writes all messages to the Metro console.",
+            name: "--custom-log-reporter-path <string>",
+            description: "Path to a JavaScript file which exports a Metro 'TerminalReporter' function; replaces the default reporter that writes all messages to the Metro console",
         },
         {
             name: "--https",
-            description: "Use a secure (https) web server. When not specified, an insecure (http) web server is used.",
+            description: "Use a secure (https) web server; when not specified, an insecure (http) web server is used",
         },
         {
-            name: "--key [path]",
-            description: "Path to a custom SSL private key file to use for secure (https) communication.",
+            name: "--key <path>",
+            description: "Path to a custom SSL private key file to use for secure (https) communication",
         },
         {
-            name: "--cert [path]",
-            description: "Path to a custom SSL certificate file to use for secure (https) communication.",
+            name: "--cert <path>",
+            description: "Path to a custom SSL certificate file to use for secure (https) communication",
         },
         {
-            name: "--config [string]",
-            description: "Path to the Metro configuration file.",
+            name: "--config <string>",
+            description: "Path to the Metro configuration file",
             parse: parsers_1.asResolvedPath,
         },
         {
             name: "--no-interactive",
-            description: "Disables interactive mode.",
+            description: "Disables interactive mode",
         },
         {
-            name: "--id [string]",
-            description: "Specify which bundle configuration to use if server configuration is missing.",
+            name: "--id <string>",
+            description: "Specify which bundle configuration to use if server configuration is missing",
         },
     ],
 };

package/lib/test.d.ts

@@ -1,6 +1,7 @@
 import type { Config as CLIConfig } from "@react-native-community/cli-types";
+import type { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
 type Args = {
-    platform: "android" | "ios" | "macos" | "windows" | "win32";
+    platform: AllPlatforms;
 };
 type Options = {
     name: string;

package/lib/test.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rnxTestCommand = exports.jestOptions = exports.rnxTest = void 0;
+exports.rnxTestCommand = void 0;
+exports.rnxTest = rnxTest;
+exports.jestOptions = jestOptions;
 const console_1 = require("@rnx-kit/console");
 const package_1 = require("@rnx-kit/tools-node/package");
 const platform_1 = require("@rnx-kit/tools-react-native/platform");
@@ -33,7 +35,6 @@ function rnxTest(_argv, { root }, { platform }) {
     process.env["RN_TARGET_PLATFORM"] = platform;
     runJest(argv);
 }
-exports.rnxTest = rnxTest;
 function jestOptions() {
     const options = (() => {
         const jestCliPath = (() => {
@@ -94,14 +95,13 @@ function jestOptions() {
         };
     });
 }
-exports.jestOptions = jestOptions;
 exports.rnxTestCommand = {
     name: COMMAND_NAME,
     description: "Test runner for React Native apps",
     func: rnxTest,
     options: [
         {
-            name: "--platform [android|ios|macos|windows|win32]",
+            name: "--platform <android|ios|macos|windows|win32>",
             description: "Platform to target",
             parse: platform_1.parsePlatform,
         },