@rnx-kit/cli 0.14.4 → 0.14.6

package/lib/typescript/project-cache.js

@@ -1,4 +1,27 @@
 "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;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -8,8 +31,8 @@ const tools_node_1 = require("@rnx-kit/tools-node");
 const platform_1 = require("@rnx-kit/tools-react-native/platform");
 const typescript_react_native_resolver_1 = require("@rnx-kit/typescript-react-native-resolver");
 const typescript_service_1 = require("@rnx-kit/typescript-service");
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const typescript_1 = __importDefault(require("typescript"));
 /**
  * Create an empty cache for holding TypeScript projects.
@@ -30,15 +53,15 @@ function createProjectCache(print) {
             }
         }
         // Search the file system for the root of source file's package.
-        const root = (0, tools_node_1.findPackageDir)(path_1.default.dirname(sourceFile));
+        const root = (0, tools_node_1.findPackageDir)(path.dirname(sourceFile));
         if (!root) {
             throw new Error(`Cannot find project root for source file '${sourceFile}'`);
         }
         return root;
     }
     function readTSConfig(root) {
-        const configFileName = path_1.default.join(root, "tsconfig.json");
-        if (!fs_1.default.existsSync(configFileName)) {
+        const configFileName = path.join(root, "tsconfig.json");
+        if (!fs.existsSync(configFileName)) {
             // Allow for packages that aren't TypeScript.
             //
             // Example: Users who enable bundling with all the config defaults will

package/lib/typescript/project-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-cache.js","sourceRoot":"","sources":["../../src/typescript/project-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-cache.js","sourceRoot":"","sources":["../../src/typescript/project-cache.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnx-kit/cli",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "Command-line interface for working with kit packages in your repo",
   "homepage": "https://github.com/microsoft/rnx-kit/tree/main/packages/cli",
   "license": "MIT",
@@ -19,14 +19,14 @@
     "test": "rnx-kit-scripts test"
   },
   "dependencies": {
-    "@rnx-kit/config": "^0.5.0",
+    "@rnx-kit/config": "^0.5.2",
     "@rnx-kit/console": "^1.0.11",
     "@rnx-kit/dep-check": "^1.12.23",
     "@rnx-kit/metro-plugin-cyclic-dependencies-detector": "^1.0.21",
     "@rnx-kit/metro-plugin-duplicates-checker": "^2.0.0",
     "@rnx-kit/metro-serializer": "^1.0.11",
     "@rnx-kit/metro-serializer-esbuild": "^0.1.0",
-    "@rnx-kit/metro-service": "^3.0.0",
+    "@rnx-kit/metro-service": "^3.0.2",
     "@rnx-kit/third-party-notices": "^1.2.13",
     "@rnx-kit/tools-language": "^1.3.0",
     "@rnx-kit/tools-node": "^1.2.7",

package/react-native.config.js

@@ -1,12 +1,12 @@
-const { parsePlatform } = require("@rnx-kit/tools-react-native/platform");
 const path = require("path");
 const {
   parseBoolean,
-  parseTransformProfile,
-  rnxBundle,
+  parseInt,
+  rnxBundleCommand,
   rnxCopyAssetsCommand,
   rnxStart,
   rnxDepCheckCommand,
+  rnxRamBundleCommand,
   rnxTestCommand,
   rnxWriteThirdPartyNotices,
   rnxClean,
@@ -14,99 +14,8 @@ const {
 
 module.exports = {
   commands: [
-    {
-      name: "rnx-bundle",
-      description:
-        "Bundle your rnx-kit package for offline use. See https://aka.ms/rnx-kit.",
-      func: rnxBundle,
-      options: [
-        {
-          name: "--id [id]",
-          description:
-            "Target bundle definition. This is only needed when the rnx-kit configuration has multiple bundle definitions.",
-        },
-        {
-          name: "--entry-file [path]",
-          description:
-            "Path to the root JavaScript or TypeScript file, either absolute or relative to the package.",
-        },
-        {
-          name: "--platform [ios|android|windows|win32|macos]",
-          description:
-            "Target platform. When not given, all platforms in the rnx-kit configuration are bundled.",
-          parse: parsePlatform,
-        },
-        {
-          name: "--dev [boolean]",
-          description:
-            "If false, warnings are disabled and the bundle is minified.",
-          default: true,
-          parse: parseBoolean,
-        },
-        {
-          name: "--minify [boolean]",
-          description:
-            "Controls whether or not the bundle is minified. Disabling minification is useful for test builds.",
-          parse: parseBoolean,
-        },
-        {
-          name: "--bundle-output [string]",
-          description:
-            "Path to the output bundle file, either absolute or relative to the package.",
-        },
-        {
-          name: "--bundle-encoding [utf8|utf16le|ascii]",
-          description:
-            "Character encoding to use when writing the bundle file.",
-          default: "utf8",
-        },
-        {
-          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.",
-          parse: parseInt,
-        },
-        {
-          name: "--sourcemap-output [string]",
-          description:
-            "Path where the bundle source map is written, either absolute or relative to the package.",
-        },
-        {
-          name: "--sourcemap-sources-root [string]",
-          description:
-            "Path to use when relativizing file entries in the bundle source map.",
-        },
-        {
-          name: "--sourcemap-use-absolute-path",
-          description: "Report SourceMapURL using its full path",
-        },
-        {
-          name: "--assets-dest [path]",
-          description:
-            "Path where bundle assets like images are written, either absolute or relative to the package. If not given, assets are ignored.",
-        },
-        {
-          name: "--tree-shake [boolean]",
-          description:
-            "Enable tree shaking to remove unused code and reduce the bundle size.",
-          parse: parseBoolean,
-        },
-        {
-          name: "--unstable-transform-profile [string]",
-          description:
-            "Experimental, transform JS for a specific JS engine. Currently supported: hermes, hermes-canary, default",
-          parse: parseTransformProfile,
-        },
-        {
-          name: "--reset-cache",
-          description: "Reset the Metro cache.",
-        },
-        {
-          name: "--config [string]",
-          description: "Path to the Metro configuration file.",
-        },
-      ],
-    },
+    rnxBundleCommand,
+    rnxRamBundleCommand,
     {
       name: "rnx-start",
       func: rnxStart,

package/src/bundle/cliOptions.ts

@@ -0,0 +1,82 @@
+import { parsePlatform } from "@rnx-kit/tools-react-native/platform";
+import { parseBoolean, parseTransformProfile } from "../parsers";
+
+export const commonBundleCommandOptions = [
+  {
+    name: "--id [id]",
+    description:
+      "Target bundle definition. This is only needed when the rnx-kit configuration has multiple bundle definitions.",
+  },
+  {
+    name: "--entry-file [path]",
+    description:
+      "Path to the root JavaScript or TypeScript file, either absolute or relative to the package.",
+  },
+  {
+    name: "--platform [ios|android|windows|win32|macos]",
+    description:
+      "Target platform. When not given, all platforms in the rnx-kit configuration are bundled.",
+    parse: parsePlatform,
+  },
+  {
+    name: "--dev [boolean]",
+    description: "If false, warnings are disabled and the bundle is minified.",
+    default: true,
+    parse: parseBoolean,
+  },
+  {
+    name: "--minify [boolean]",
+    description:
+      "Controls whether or not the bundle is minified. Disabling minification is useful for test builds.",
+    parse: parseBoolean,
+  },
+  {
+    name: "--bundle-output [string]",
+    description:
+      "Path to the output bundle file, either absolute or relative to the package.",
+  },
+  {
+    name: "--bundle-encoding [utf8|utf16le|ascii]",
+    description: "Character encoding to use when writing the bundle file.",
+    default: "utf8",
+  },
+  {
+    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.",
+    parse: parseInt,
+  },
+  {
+    name: "--sourcemap-output [string]",
+    description:
+      "Path where the bundle source map is written, either absolute or relative to the package.",
+  },
+  {
+    name: "--sourcemap-sources-root [string]",
+    description:
+      "Path to use when relativizing file entries in the bundle source map.",
+  },
+  {
+    name: "--sourcemap-use-absolute-path",
+    description: "Report SourceMapURL using its full path",
+  },
+  {
+    name: "--assets-dest [path]",
+    description:
+      "Path where bundle assets like images are written, either absolute or relative to the package. If not given, assets are ignored.",
+  },
+  {
+    name: "--unstable-transform-profile [string]",
+    description:
+      "Experimental, transform JS for a specific JS engine. Currently supported: hermes, hermes-canary, default",
+    parse: parseTransformProfile,
+  },
+  {
+    name: "--reset-cache",
+    description: "Reset the Metro cache.",
+  },
+  {
+    name: "--config [string]",
+    description: "Path to the Metro configuration file.",
+  },
+];

package/src/bundle/kit-config.ts

@@ -4,8 +4,8 @@ import {
   getKitConfig,
 } from "@rnx-kit/config";
 import type { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
+import { getDefaultBundlerPlugins } from "./defaultPlugins";
 import type { CliPlatformBundleConfig } from "./types";
-import { getDefaultBundlerPlugins } from "../bundler-plugin-defaults";
 
 /**
  * Get the list of target platforms for bundling.
@@ -49,7 +49,7 @@ function getDefaultBundleParameters(platform: string) {
  *
  * @param id Optional identity of the target bundle definition to return
  * @param overridePlatform Override platform, typically from the command-line. When given, this overrides the list of target platforms.
- * @returns Arrary of platform-specific bundle configurations
+ * @returns Array of platform-specific bundle configurations
  */
 export function getCliPlatformBundleConfigs(
   id?: string,

package/src/bundle/metro.ts

@@ -1,8 +1,9 @@
 import { info } from "@rnx-kit/console";
-import { bundle, BundleArgs as MetroBundleArgs } from "@rnx-kit/metro-service";
+import type { BundleArgs as MetroBundleArgs } from "@rnx-kit/metro-service";
+import { bundle } from "@rnx-kit/metro-service";
 import { createDirectory } from "@rnx-kit/tools-node/fs";
 import type { ConfigT } from "metro-config";
-import path from "path";
+import * as path from "path";
 import { customizeMetroConfig } from "../metro-config";
 import type { CliPlatformBundleConfig } from "./types";
 
@@ -16,22 +17,18 @@ import type { CliPlatformBundleConfig } from "./types";
  *            Further, optimizations like constant folding are disabled.
  *            When `false`, warnings are disabled and the bundle is minified by default.
  * @param minify Optionally choose whether or not the bundle is minified. When not set, minification is controlled by the `dev` property.
+ * @param output Output bundle format; defaults to plain JS
  */
 export async function metroBundle(
   metroConfig: ConfigT,
   bundleConfig: CliPlatformBundleConfig,
   dev: boolean,
-  minify?: boolean
+  minify?: boolean,
+  output = bundle
 ): Promise<void> {
   info(`Bundling ${bundleConfig.platform}...`);
 
-  customizeMetroConfig(
-    metroConfig,
-    bundleConfig.detectCyclicDependencies,
-    bundleConfig.detectDuplicateDependencies,
-    bundleConfig.typescriptValidation,
-    bundleConfig.treeShake
-  );
+  customizeMetroConfig(metroConfig, bundleConfig);
 
   const metroBundleArgs: MetroBundleArgs = {
     ...bundleConfig,
@@ -46,5 +43,5 @@ export async function metroBundle(
   metroBundleArgs.assetsDest && createDirectory(metroBundleArgs.assetsDest);
 
   // create the bundle
-  await bundle(metroBundleArgs, metroConfig);
+  await output(metroBundleArgs, metroConfig);
 }

package/src/bundle/overrides.ts

@@ -1,41 +1,47 @@
-import type { TransformProfile } from "metro-babel-transformer";
-import type { BundleArgs } from "@rnx-kit/metro-service";
 import { pickValues } from "@rnx-kit/tools-language/properties";
 import type { CliPlatformBundleConfig } from "./types";
 
-export type BundleConfigOverrides = {
-  entryFile?: string;
-  bundleOutput?: string;
-  bundleEncoding?: BundleArgs["bundleEncoding"];
-  sourcemapOutput?: string;
-  sourcemapSourcesRoot?: string;
-  sourcemapUseAbsolutePath?: boolean;
-  assetsDest?: string;
-  treeShake?: boolean;
-  unstableTransformProfile?: TransformProfile;
-};
+type BundleConfigOverrides = Partial<
+  Pick<
+    CliPlatformBundleConfig,
+    | "entryFile"
+    | "bundleOutput"
+    | "bundleEncoding"
+    | "sourcemapOutput"
+    | "sourcemapSourcesRoot"
+    | "sourcemapUseAbsolutePath"
+    | "assetsDest"
+    | "treeShake"
+    | "unstableTransformProfile"
+    | "indexedRamBundle"
+  >
+>;
+
+export const overridableCommonBundleOptions: readonly (keyof BundleConfigOverrides)[] =
+  [
+    "assetsDest",
+    "bundleEncoding",
+    "bundleOutput",
+    "entryFile",
+    "sourcemapOutput",
+    "sourcemapSourcesRoot",
+    "sourcemapUseAbsolutePath",
+    "unstableTransformProfile",
+  ];
 
 /**
  * Apply overrides, if any, to each rnx-kit bundle configuration. Overrides are applied in-place.
  *
  * @param overrides Optional overrides to apply
  * @param configs Array of platform-specific bundle configurations. This is modified if any overrides are applied.
+ * @param keys Config keys to pick from {@link overrides}
  */
 export function applyBundleConfigOverrides(
   overrides: BundleConfigOverrides,
-  configs: CliPlatformBundleConfig[]
+  configs: CliPlatformBundleConfig[],
+  keys: (keyof BundleConfigOverrides)[]
 ): void {
-  const overridesToApply = pickValues(overrides, [
-    "entryFile",
-    "bundleOutput",
-    "bundleEncoding",
-    "sourcemapOutput",
-    "sourcemapSourcesRoot",
-    "sourcemapUseAbsolutePath",
-    "assetsDest",
-    "treeShake",
-    "unstableTransformProfile",
-  ]);
+  const overridesToApply = pickValues(overrides, keys);
   if (overridesToApply) {
     for (const config of configs) {
       Object.assign(config, overridesToApply);

package/src/bundle/types.ts

@@ -1,7 +1,26 @@
 import type { TransformProfile } from "metro-babel-transformer";
 import type { BundleParameters } from "@rnx-kit/config";
+import type { BundleArgs } from "@rnx-kit/metro-service";
 import type { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
 
+export type CLICommonBundleOptions = {
+  id?: string;
+  entryFile?: string;
+  platform?: AllPlatforms;
+  dev: boolean;
+  minify?: boolean;
+  bundleOutput?: string;
+  bundleEncoding?: BundleArgs["bundleEncoding"];
+  maxWorkers?: number;
+  sourcemapOutput?: string;
+  sourcemapSourcesRoot?: string;
+  sourcemapUseAbsolutePath?: boolean;
+  assetsDest?: string;
+  unstableTransformProfile?: TransformProfile;
+  resetCache?: boolean;
+  config?: string;
+};
+
 export type CliPlatformBundleConfig = BundleParameters &
   Required<
     Pick<

package/src/bundle.ts

@@ -1,28 +1,17 @@
-import type { TransformProfile } from "metro-babel-transformer";
 import type { Config as CLIConfig } from "@react-native-community/cli-types";
-import { BundleArgs, loadMetroConfig } from "@rnx-kit/metro-service";
-import type { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
+import { loadMetroConfig } from "@rnx-kit/metro-service";
+import { commonBundleCommandOptions } from "./bundle/cliOptions";
 import { getCliPlatformBundleConfigs } from "./bundle/kit-config";
 import { metroBundle } from "./bundle/metro";
-import { applyBundleConfigOverrides } from "./bundle/overrides";
+import {
+  applyBundleConfigOverrides,
+  overridableCommonBundleOptions,
+} from "./bundle/overrides";
+import type { CLICommonBundleOptions } from "./bundle/types";
+import { parseBoolean } from "./parsers";
 
-export type CLIBundleOptions = {
-  id?: string;
-  entryFile?: string;
-  platform?: AllPlatforms;
-  dev: boolean;
-  minify?: boolean;
-  bundleOutput?: string;
-  bundleEncoding?: BundleArgs["bundleEncoding"];
-  maxWorkers?: number;
-  sourcemapOutput?: string;
-  sourcemapSourcesRoot?: string;
-  sourcemapUseAbsolutePath?: boolean;
-  assetsDest?: string;
+type CLIBundleOptions = CLICommonBundleOptions & {
   treeShake?: boolean;
-  unstableTransformProfile?: TransformProfile;
-  resetCache?: boolean;
-  config?: string;
 };
 
 export async function rnxBundle(
@@ -37,7 +26,10 @@ export async function rnxBundle(
     cliOptions.platform
   );
 
-  applyBundleConfigOverrides(cliOptions, bundleConfigs);
+  applyBundleConfigOverrides(cliOptions, bundleConfigs, [
+    ...overridableCommonBundleOptions,
+    "treeShake",
+  ]);
 
   for (const bundleConfig of bundleConfigs) {
     await metroBundle(
@@ -47,6 +39,20 @@ export async function rnxBundle(
       cliOptions.minify
     );
   }
-
-  return Promise.resolve();
 }
+
+export const rnxBundleCommand = {
+  name: "rnx-bundle",
+  description:
+    "Bundle your rnx-kit package for offline use. See https://aka.ms/rnx-kit.",
+  func: rnxBundle,
+  options: [
+    ...commonBundleCommandOptions,
+    {
+      name: "--tree-shake [boolean]",
+      description:
+        "Enable tree shaking to remove unused code and reduce the bundle size.",
+      parse: parseBoolean,
+    },
+  ],
+};

package/src/index.ts

@@ -1,8 +1,9 @@
-export { rnxBundle } from "./bundle";
+export { rnxBundle, rnxBundleCommand } from "./bundle";
+export { rnxClean } from "./clean";
 export { copyProjectAssets, rnxCopyAssetsCommand } from "./copy-assets";
 export { rnxDepCheck, rnxDepCheckCommand } from "./dep-check";
+export { parseBoolean, parseInt, parseTransformProfile } from "./parsers";
+export { rnxRamBundle, rnxRamBundleCommand } from "./ram-bundle";
 export { rnxStart } from "./start";
 export { rnxTest, rnxTestCommand } from "./test";
 export { rnxWriteThirdPartyNotices } from "./write-third-party-notices";
-export { parseBoolean, parseTransformProfile } from "./parsers";
-export { rnxClean } from "./clean";

package/src/metro-config.ts

@@ -1,24 +1,20 @@
-import type { TypeScriptValidationOptions } from "@rnx-kit/config";
-import {
-  CyclicDependencies,
-  PluginOptions as CyclicDetectorOptions,
-} from "@rnx-kit/metro-plugin-cyclic-dependencies-detector";
-import {
-  DuplicateDependencies,
-  Options as DuplicateDetectorOptions,
-} from "@rnx-kit/metro-plugin-duplicates-checker";
-import { MetroPlugin, MetroSerializer } from "@rnx-kit/metro-serializer";
+import type {
+  BundlerPlugins,
+  TypeScriptValidationOptions,
+} from "@rnx-kit/config";
+import { CyclicDependencies } from "@rnx-kit/metro-plugin-cyclic-dependencies-detector";
+import { DuplicateDependencies } from "@rnx-kit/metro-plugin-duplicates-checker";
+import type { MetroPlugin } from "@rnx-kit/metro-serializer";
+import { MetroSerializer } from "@rnx-kit/metro-serializer";
 import {
   esbuildTransformerConfig,
   MetroSerializer as MetroSerializerEsbuild,
 } from "@rnx-kit/metro-serializer-esbuild";
-import { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
-import { Project } from "@rnx-kit/typescript-service";
-
-import { createProjectCache } from "./typescript/project-cache";
-
+import type { AllPlatforms } from "@rnx-kit/tools-react-native/platform";
+import type { Project } from "@rnx-kit/typescript-service";
 import type { DeltaResult, Graph } from "metro";
 import type { InputConfigT, SerializerConfigT } from "metro-config";
+import { createProjectCache } from "./typescript/project-cache";
 
 /**
  * Create a hook function to be registered with Metro during serialization.
@@ -116,18 +112,17 @@ const emptySerializerHook = (_graph: Graph, _delta: DeltaResult): void => {
  * Customize the Metro configuration.
  *
  * @param metroConfigReadonly Metro configuration
- * @param detectCyclicDependencies When true, cyclic dependency checking is enabled with a default set of options. Otherwise the object allows for fine-grained control over the detection process.
- * @param detectDuplicateDependencies When true, duplicate dependency checking is enabled with a default set of options. Otherwise, the object allows for fine-grained control over the detection process.
- * @param typescriptValidation When true, TypeScript type-checking is enabled with a default set of options. Otherwise, the object allows for fine-grained control over the type-checking process.
- * @param treeShake When true, tree shaking is enabled.
+ * @param bundlerPlugins Plugins used to further customize Metro configuration
  * @param print Optional function to use when printing status messages to the Metro console
  */
 export function customizeMetroConfig(
   metroConfigReadonly: InputConfigT,
-  detectCyclicDependencies: boolean | CyclicDetectorOptions,
-  detectDuplicateDependencies: boolean | DuplicateDetectorOptions,
-  typescriptValidation: boolean | TypeScriptValidationOptions,
-  treeShake: boolean,
+  {
+    detectCyclicDependencies,
+    detectDuplicateDependencies,
+    treeShake,
+    typescriptValidation,
+  }: BundlerPlugins,
   print?: (message: string) => void
 ): void {
   //  We will be making changes to the Metro configuration. Coerce from a

package/src/parsers.ts

@@ -12,6 +12,10 @@ export function parseBoolean(val: string): boolean {
   );
 }
 
+export function parseInt(value: string): number {
+  return global.parseInt(value, 10);
+}
+
 export function parseTransformProfile(val: string): TransformProfile {
   const allowedProfiles: TransformProfile[] = [
     "hermes-stable",