@react-native/community-cli-plugin 0.73.0

package/dist/commands/bundle/bundle.js.flow

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+import type {Config} from '@react-native-community/cli-types';
+import type {CommandLineArgs} from './bundleCommandLineArgs';
+
+import buildBundle from './buildBundle';
+import bundleCommandLineArgs from './bundleCommandLineArgs';
+
+/**
+ * Builds the bundle starting to look for dependencies at the given entry path.
+ */
+export function bundleWithOutput(
+  _: Array<string>,
+  config: Config,
+  args: CommandLineArgs,
+  output: any, // untyped metro/src/shared/output/bundle or metro/src/shared/output/RamBundle
+): Promise<void> {
+  return buildBundle(args, config, output);
+}
+
+const bundleCommand = {
+  name: 'bundle',
+  description: 'Build the bundle for the provided JavaScript entry file.',
+  func: bundleWithOutput,
+  options: bundleCommandLineArgs,
+};
+
+export default bundleCommand;

package/dist/commands/bundle/bundleCommandLineArgs.js

@@ -0,0 +1,116 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _path = _interopRequireDefault(require("path"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+var _default = [
+  {
+    name: "--entry-file <path>",
+    description:
+      "Path to the root JS file, either absolute or relative to JS root",
+  },
+  {
+    name: "--platform <string>",
+    description: 'Either "ios" or "android"',
+    default: "ios",
+  },
+  {
+    name: "--transformer <string>",
+    description: "Specify a custom transformer to be used",
+  },
+  {
+    name: "--dev [boolean]",
+    description: "If false, warnings are disabled and the bundle is minified",
+    parse: (val) => val !== "false",
+    default: true,
+  },
+  {
+    name: "--minify [boolean]",
+    description:
+      "Allows overriding whether bundle is minified. This defaults to " +
+      "false if dev is true, and true if dev is false. Disabling minification " +
+      "can be useful for speeding up production builds for testing purposes.",
+    parse: (val) => val !== "false",
+  },
+  {
+    name: "--bundle-output <string>",
+    description:
+      "File name where to store the resulting bundle, ex. /tmp/groups.bundle",
+  },
+  {
+    name: "--bundle-encoding <string>",
+    description:
+      "Encoding the bundle should be written in (https://nodejs.org/api/buffer.html#buffer_buffer).",
+    default: "utf8",
+  },
+  {
+    name: "--max-workers <number>",
+    description:
+      "Specifies the maximum number of workers the worker-pool " +
+      "will spawn for transforming files. This defaults to the number of the " +
+      "cores available on your machine.",
+    parse: (workers) => Number(workers),
+  },
+  {
+    name: "--sourcemap-output <string>",
+    description:
+      "File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map",
+  },
+  {
+    name: "--sourcemap-sources-root <string>",
+    description:
+      "Path to make sourcemap's sources entries relative to, ex. /root/dir",
+  },
+  {
+    name: "--sourcemap-use-absolute-path",
+    description: "Report SourceMapURL using its full path",
+    default: false,
+  },
+  {
+    name: "--assets-dest <string>",
+    description:
+      "Directory name where to store assets referenced in the bundle",
+  },
+  {
+    name: "--unstable-transform-profile <string>",
+    description:
+      "Experimental, transform JS for a specific JS engine. Currently supported: hermes, hermes-canary, default",
+    default: "default",
+  },
+  {
+    name: "--asset-catalog-dest [string]",
+    description: "Path where to create an iOS Asset Catalog for images",
+  },
+  {
+    name: "--reset-cache",
+    description: "Removes cached files",
+    default: false,
+  },
+  {
+    name: "--read-global-cache",
+    description:
+      "Try to fetch transformed JS code from the global cache, if configured.",
+    default: false,
+  },
+  {
+    name: "--config <string>",
+    description: "Path to the CLI configuration file",
+    parse: (val) => _path.default.resolve(val),
+  },
+];
+exports.default = _default;

package/dist/commands/bundle/bundleCommandLineArgs.js.flow

@@ -0,0 +1,129 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+import path from 'path';
+
+export interface CommandLineArgs {
+  assetsDest?: string;
+  assetCatalogDest?: string;
+  entryFile: string;
+  resetCache: boolean;
+  resetGlobalCache: boolean;
+  transformer?: string;
+  minify?: boolean;
+  config?: string;
+  platform: string;
+  dev: boolean;
+  bundleOutput: string;
+  bundleEncoding?: 'utf8' | 'utf16le' | 'ascii';
+  maxWorkers?: number;
+  sourcemapOutput?: string;
+  sourcemapSourcesRoot?: string;
+  sourcemapUseAbsolutePath: boolean;
+  verbose: boolean;
+  unstableTransformProfile: string;
+}
+
+export default [
+  {
+    name: '--entry-file <path>',
+    description:
+      'Path to the root JS file, either absolute or relative to JS root',
+  },
+  {
+    name: '--platform <string>',
+    description: 'Either "ios" or "android"',
+    default: 'ios',
+  },
+  {
+    name: '--transformer <string>',
+    description: 'Specify a custom transformer to be used',
+  },
+  {
+    name: '--dev [boolean]',
+    description: 'If false, warnings are disabled and the bundle is minified',
+    parse: (val: string): boolean => val !== 'false',
+    default: true,
+  },
+  {
+    name: '--minify [boolean]',
+    description:
+      'Allows overriding whether bundle is minified. This defaults to ' +
+      'false if dev is true, and true if dev is false. Disabling minification ' +
+      'can be useful for speeding up production builds for testing purposes.',
+    parse: (val: string): boolean => val !== 'false',
+  },
+  {
+    name: '--bundle-output <string>',
+    description:
+      'File name where to store the resulting bundle, ex. /tmp/groups.bundle',
+  },
+  {
+    name: '--bundle-encoding <string>',
+    description:
+      'Encoding the bundle should be written in (https://nodejs.org/api/buffer.html#buffer_buffer).',
+    default: 'utf8',
+  },
+  {
+    name: '--max-workers <number>',
+    description:
+      'Specifies the maximum number of workers the worker-pool ' +
+      'will spawn for transforming files. This defaults to the number of the ' +
+      'cores available on your machine.',
+    parse: (workers: string): number => Number(workers),
+  },
+  {
+    name: '--sourcemap-output <string>',
+    description:
+      'File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map',
+  },
+  {
+    name: '--sourcemap-sources-root <string>',
+    description:
+      "Path to make sourcemap's sources entries relative to, ex. /root/dir",
+  },
+  {
+    name: '--sourcemap-use-absolute-path',
+    description: 'Report SourceMapURL using its full path',
+    default: false,
+  },
+  {
+    name: '--assets-dest <string>',
+    description:
+      'Directory name where to store assets referenced in the bundle',
+  },
+  {
+    name: '--unstable-transform-profile <string>',
+    description:
+      'Experimental, transform JS for a specific JS engine. Currently supported: hermes, hermes-canary, default',
+    default: 'default',
+  },
+  {
+    name: '--asset-catalog-dest [string]',
+    description: 'Path where to create an iOS Asset Catalog for images',
+  },
+  {
+    name: '--reset-cache',
+    description: 'Removes cached files',
+    default: false,
+  },
+  {
+    name: '--read-global-cache',
+    description:
+      'Try to fetch transformed JS code from the global cache, if configured.',
+    default: false,
+  },
+  {
+    name: '--config <string>',
+    description: 'Path to the CLI configuration file',
+    parse: (val: string): string => path.resolve(val),
+  },
+];

package/dist/commands/bundle/filterPlatformAssetScales.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+const ALLOWED_SCALES = {
+  ios: [1, 2, 3],
+};
+function filterPlatformAssetScales(platform, scales) {
+  const whitelist = ALLOWED_SCALES[platform];
+  if (!whitelist) {
+    return scales;
+  }
+  const result = scales.filter((scale) => whitelist.indexOf(scale) > -1);
+  if (result.length === 0 && scales.length > 0) {
+    // No matching scale found, but there are some available. Ideally we don't
+    // want to be in this situation and should throw, but for now as a fallback
+    // let's just use the closest larger image
+    const maxScale = whitelist[whitelist.length - 1];
+    for (const scale of scales) {
+      if (scale > maxScale) {
+        result.push(scale);
+        break;
+      }
+    }
+
+    // There is no larger scales available, use the largest we have
+    if (result.length === 0) {
+      result.push(scales[scales.length - 1]);
+    }
+  }
+  return result;
+}
+var _default = filterPlatformAssetScales;
+exports.default = _default;

package/dist/commands/bundle/filterPlatformAssetScales.js.flow

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+const ALLOWED_SCALES: {[key: string]: number[]} = {
+  ios: [1, 2, 3],
+};
+
+function filterPlatformAssetScales(
+  platform: string,
+  scales: $ReadOnlyArray<number>,
+): $ReadOnlyArray<number> {
+  const whitelist: number[] = ALLOWED_SCALES[platform];
+  if (!whitelist) {
+    return scales;
+  }
+  const result = scales.filter(scale => whitelist.indexOf(scale) > -1);
+  if (result.length === 0 && scales.length > 0) {
+    // No matching scale found, but there are some available. Ideally we don't
+    // want to be in this situation and should throw, but for now as a fallback
+    // let's just use the closest larger image
+    const maxScale = whitelist[whitelist.length - 1];
+    for (const scale of scales) {
+      if (scale > maxScale) {
+        result.push(scale);
+        break;
+      }
+    }
+
+    // There is no larger scales available, use the largest we have
+    if (result.length === 0) {
+      result.push(scales[scales.length - 1]);
+    }
+  }
+  return result;
+}
+
+export default filterPlatformAssetScales;

package/dist/commands/bundle/getAssetDestPathAndroid.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _path = _interopRequireDefault(require("path"));
+var _assetPathUtils = _interopRequireDefault(require("./assetPathUtils"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+function getAssetDestPathAndroid(asset, scale) {
+  const androidFolder = _assetPathUtils.default.getAndroidResourceFolderName(
+    asset,
+    scale
+  );
+  const fileName = _assetPathUtils.default.getResourceIdentifier(asset);
+  return _path.default.join(androidFolder, `${fileName}.${asset.type}`);
+}
+var _default = getAssetDestPathAndroid;
+exports.default = _default;

package/dist/commands/bundle/getAssetDestPathAndroid.js.flow

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+import type {PackagerAsset} from './assetPathUtils';
+
+import path from 'path';
+import assetPathUtils from './assetPathUtils';
+
+function getAssetDestPathAndroid(asset: PackagerAsset, scale: number): string {
+  const androidFolder = assetPathUtils.getAndroidResourceFolderName(
+    asset,
+    scale,
+  );
+  const fileName = assetPathUtils.getResourceIdentifier(asset);
+  return path.join(androidFolder, `${fileName}.${asset.type}`);
+}
+
+export default getAssetDestPathAndroid;

package/dist/commands/bundle/getAssetDestPathIOS.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _path = _interopRequireDefault(require("path"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+function getAssetDestPathIOS(asset, scale) {
+  const suffix = scale === 1 ? "" : `@${scale}x`;
+  const fileName = `${asset.name + suffix}.${asset.type}`;
+  return _path.default.join(
+    // Assets can have relative paths outside of the project root.
+    // Replace `../` with `_` to make sure they don't end up outside of
+    // the expected assets directory.
+    asset.httpServerLocation.substr(1).replace(/\.\.\//g, "_"),
+    fileName
+  );
+}
+var _default = getAssetDestPathIOS;
+exports.default = _default;

package/dist/commands/bundle/getAssetDestPathIOS.js.flow

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+import type {PackagerAsset} from './assetPathUtils';
+
+import path from 'path';
+
+function getAssetDestPathIOS(asset: PackagerAsset, scale: number): string {
+  const suffix = scale === 1 ? '' : `@${scale}x`;
+  const fileName = `${asset.name + suffix}.${asset.type}`;
+  return path.join(
+    // Assets can have relative paths outside of the project root.
+    // Replace `../` with `_` to make sure they don't end up outside of
+    // the expected assets directory.
+    asset.httpServerLocation.substr(1).replace(/\.\.\//g, '_'),
+    fileName,
+  );
+}
+
+export default getAssetDestPathIOS;

package/dist/commands/bundle/ramBundle.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+exports.ramBundle = ramBundle;
+var _RamBundle = _interopRequireDefault(
+  require("metro/src/shared/output/RamBundle")
+);
+var _bundle = require("./bundle");
+var _bundleCommandLineArgs = _interopRequireDefault(
+  require("./bundleCommandLineArgs")
+);
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+/**
+ * Builds the bundle starting to look for dependencies at the given entry path.
+ */
+function ramBundle(argv, config, args) {
+  return (0, _bundle.bundleWithOutput)(argv, config, args, _RamBundle.default);
+}
+var _default = {
+  name: "ram-bundle",
+  description:
+    "Build the RAM bundle for the provided JavaScript entry file. See https://reactnative.dev/docs/ram-bundles-inline-requires.",
+  func: ramBundle,
+  options: _bundleCommandLineArgs.default.concat({
+    name: "--indexed-ram-bundle",
+    description:
+      'Force the "Indexed RAM" bundle file format, even when building for android',
+    default: false,
+  }),
+};
+exports.default = _default;

package/dist/commands/bundle/ramBundle.js.flow

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow
+ * @format
+ * @oncall react_native
+ */
+
+import type {Config} from '@react-native-community/cli-types';
+import type {CommandLineArgs} from './bundleCommandLineArgs';
+
+import outputUnbundle from 'metro/src/shared/output/RamBundle';
+import {bundleWithOutput} from './bundle';
+import bundleCommandLineArgs from './bundleCommandLineArgs';
+
+/**
+ * Builds the bundle starting to look for dependencies at the given entry path.
+ */
+function ramBundle(
+  argv: Array<string>,
+  config: Config,
+  args: CommandLineArgs,
+): Promise<void> {
+  return bundleWithOutput(argv, config, args, outputUnbundle);
+}
+
+export default {
+  name: 'ram-bundle',
+  description:
+    'Build the RAM bundle for the provided JavaScript entry file. See https://reactnative.dev/docs/ram-bundles-inline-requires.',
+  func: ramBundle,
+  options: (bundleCommandLineArgs.concat({
+    name: '--indexed-ram-bundle',
+    description:
+      'Force the "Indexed RAM" bundle file format, even when building for android',
+    default: false,
+  }): Array<Object>),
+};
+
+export {ramBundle};