packages/community-cli-plugin/src/commands/bundle/index.js - main - githubmirror/react-native

packages/community-cli-plugin/src/commands/bundle/index.js
173 строки5 KB
Alex Hunt
Remove commander dependency from main package (#57645)
24 июл 2026, 03:07
24 июл 2026, 03:070231514
/**
 * 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 strict-local
 * @format
 */

import type {Command as CommunityCommand} from '@react-native-community/cli-types';

import buildBundle from './buildBundle';
import {Command} from 'commander';
import path from 'node:path';

export type {BundleCommandArgs} from './buildBundle';

type CommandOption = Readonly<NonNullable<CommunityCommand['options']>[number]>;

type BundleCommandParser = {
  parser: Command,
  baseHelpInformation: string,
};

const bundleCommand: CommunityCommand = {
  name: 'bundle',
  description: 'Build the bundle for the provided JavaScript entry file.',
  func: buildBundle,
  options: [
    {
      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),
    },
    {
      name: '--resolver-option <string...>',
      description:
        'Custom resolver options of the form key=value. URL-encoded. May be specified multiple times.',
      parse: (val: string, previous: Array<string> = []): Array<string> =>
        previous.concat([val]),
    },
  ],
};

function addOptions(
  command: Command,
  options: ReadonlyArray<CommandOption>,
): void {
  for (const option of options) {
    const description = option.description ?? '';
    const defaultValue =
      typeof option.default === 'function' ? undefined : option.default;

    if (option.parse != null) {
      command.option(option.name, description, option.parse, defaultValue);
    } else if (
      typeof defaultValue === 'string' ||
      typeof defaultValue === 'boolean' ||
      Array.isArray(defaultValue)
    ) {
      command.option(option.name, description, defaultValue);
    } else {
      command.option(option.name, description);
    }
  }
}

export function unstable_createBundleCommandParser(
  additionalOptions: ReadonlyArray<CommandOption> = [],
): BundleCommandParser {
  const parser = new Command()
    .name(bundleCommand.name)
    .description(bundleCommand.description ?? '')
    .helpOption('--help', 'Display help for command')
    .allowUnknownOption();

  addOptions(parser, bundleCommand.options ?? []);
  const baseHelpInformation = parser.helpInformation();
  addOptions(parser, additionalOptions);

  return {parser, baseHelpInformation};
}

export default bundleCommand;