@react-native/core-cli-utils 0.76.0-nightly-20240715-2eb7bcb8d → 0.76.0-nightly-20240720-3a5eb1973

package/{src/public/version.flow.js → dist/public/version.js.flow}

@@ -27,27 +27,20 @@
 //
 // For react-native@0.75.0 you have to have a version of XCode >= 12
 
-export const android = {
-  ANDROID_NDK: '>= 23.x',
-  ANDROID_SDK: '>= 33.x',
+declare export const android: {
+  ANDROID_NDK: ">= 23.x",
+  ANDROID_SDK: ">= 33.x",
 };
 
-export const apple = {
-  COCOAPODS: '>= 1.10.0',
-  XCODE: '>= 12.x',
-};
+declare export const apple: { COCOAPODS: ">= 1.10.0", XCODE: ">= 12.x" };
 
-export const common = {
-  BUN: '>= 1.0.0',
-  JAVA: '>= 17 <= 20',
-  NODE_JS: '>= 18',
-  NPM: '>= 4.x',
-  RUBY: '>= 2.6.10',
-  YARN: '>= 1.10.x',
+declare export const common: {
+  BUN: ">= 1.0.0",
+  JAVA: ">= 17 <= 20",
+  NODE_JS: ">= 18",
+  NPM: ">= 4.x",
+  RUBY: ">= 2.6.10",
+  YARN: ">= 1.10.x",
 };
 
-export const all = {
-  ...apple,
-  ...android,
-  ...common,
-};
+declare export const all: { ...apple, ...android, ...common };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native/core-cli-utils",
-  "version": "0.76.0-nightly-20240715-2eb7bcb8d",
+  "version": "0.76.0-nightly-20240720-3a5eb1973",
   "description": "React Native CLI library for Frameworks to build on",
   "license": "MIT",
   "main": "./dist/index.flow.js",
@@ -24,7 +24,7 @@
     "node": ">=18"
   },
   "files": [
-    "src"
+    "dist"
   ],
   "dependencies": {},
   "devDependencies": {}

package/src/index.flow.js

@@ -1,26 +0,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.
- *
- * @flow strict-local
- * @format
- * @oncall react_native
- */
-
-// @babel/register doesn't like export {foo} from './bar'; statements,
-// so we have to jump through hoops here.
-import {tasks as _android} from './private/android.js';
-import {tasks as _app} from './private/app.js';
-import {tasks as _apple} from './private/apple.js';
-import {tasks as _clean} from './private/clean.js';
-import * as _version from './public/version.js';
-
-export const android = _android;
-export const app = _app;
-export const apple = _apple;
-export const clean = _clean;
-export const version = _version;
-
-export type {Task} from './private/types';

package/src/index.js

@@ -1,20 +0,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.
- *
- * @flow strict-local
- * @format
- * @oncall react_native
- */
-
-/*::
-export type * from './index.flow';
-*/
-
-if (process.env.BUILD_EXCLUDE_BABEL_REGISTER == null) {
-  require('../../../scripts/build/babel-register').registerForMonorepo();
-}
-
-module.exports = require('./index.flow');

package/src/private/android.js

@@ -1,121 +0,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.
- *
- * @flow strict-local
- * @format
- * @oncall react_native
- */
-
-import type {Task} from './types';
-import type {ExecaPromise} from 'execa';
-
-import {isWindows, task} from './utils';
-import execa from 'execa';
-
-type AndroidBuildMode = 'Debug' | 'Release';
-
-type Path = string;
-type Args = $ReadOnlyArray<string>;
-
-type Config = {
-  cwd: Path,
-  hermes?: boolean,
-  mode: AndroidBuildMode,
-  name: string,
-  newArchitecture?: boolean,
-  sdk?: Path,
-};
-
-function gradle(
-  taskName: string,
-  args: Args,
-  options: {cwd: string, env?: {[k: string]: string | void}},
-): ExecaPromise {
-  const gradlew = isWindows ? 'gradlew.bat' : './gradlew';
-  return execa(gradlew, [taskName, ...args], {
-    cwd: options.cwd,
-    env: options.env,
-  });
-}
-
-function androidSdkPath(sdk?: string): string {
-  return sdk ?? process.env.ANDROID_HOME ?? process.env.ANDROID_SDK ?? '';
-}
-
-function boolToStr(value: boolean): string {
-  return value ? 'true' : 'false';
-}
-
-const FIRST = 1;
-
-//
-// Android Tasks
-//
-export const tasks = (
-  config: Config,
-): ({
-  assemble: (...gradleArgs: Args) => {
-    run: Task<ExecaPromise>,
-  },
-  build: (...gradleArgs: Args) => {
-    run: Task<ExecaPromise>,
-  },
-  install: (...gradleArgs: Args) => {
-    run: Task<ExecaPromise>,
-  },
-}) => ({
-  assemble: (...gradleArgs: Args) => ({
-    run: task(FIRST, 'Assemble Android App', () => {
-      const args = [];
-      if (config.hermes != null) {
-        args.push(`-PhermesEnabled=${boolToStr(config.hermes)}`);
-      }
-      if (config.newArchitecture != null) {
-        args.push(`-PnewArchEnabled=${boolToStr(config.newArchitecture)}`);
-      }
-      args.push(...gradleArgs);
-      return gradle(`${config.name}:assemble${config.mode}`, gradleArgs, {
-        cwd: config.cwd,
-        env: {ANDROID_HOME: androidSdkPath(config.sdk)},
-      });
-    }),
-  }),
-  build: (...gradleArgs: Args) => ({
-    run: task(FIRST, 'Assembles and tests Android App', () => {
-      const args = [];
-      if (config.hermes != null) {
-        args.push(`-PhermesEnabled=${boolToStr(config.hermes)}`);
-      }
-      if (config.newArchitecture != null) {
-        args.push(`-PnewArchEnabled=${boolToStr(config.newArchitecture)}`);
-      }
-      args.push(...gradleArgs);
-      return gradle(`${config.name}:bundle${config.mode}`, args, {
-        cwd: config.cwd,
-        env: {ANDROID_HOME: androidSdkPath(config.sdk)},
-      });
-    }),
-  }),
-  /**
-   * Useful extra gradle arguments:
-   *
-   * -PreactNativeDevServerPort=8081 sets the port for the installed app to point towards a Metro
-   *                                 server on (for example) 8081.
-   */
-  install: (...gradleArgs: Args) => ({
-    run: task(FIRST, 'Installs the assembled Android App', () =>
-      gradle(`${config.name}:install${config.mode}`, gradleArgs, {
-        cwd: config.cwd,
-        env: {ANDROID_HOME: androidSdkPath(config.sdk)},
-      }),
-    ),
-  }),
-
-  // We are not supporting launching the app and setting up the tunnel for metro <-> app, this is
-  // a framework concern. For an example of how one could do this, please look at the community
-  // CLI's code:
-  // https://github.com/react-native-community/cli/blob/54d48a4e08a1aef334ae6168788e0157a666b4f5/packages/cli-platform-android/src/commands/runAndroid/index.ts#L272C1-L290C2
-});

package/src/private/app.js

@@ -1,250 +0,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.
- *
- * @flow strict-local
- * @format
- * @oncall react_native
- */
-
-import type {Task} from './types';
-import type {ExecaPromise} from 'execa';
-
-import {task} from './utils';
-import debug from 'debug';
-import execa from 'execa';
-import fs from 'fs';
-import path from 'path';
-
-const log = debug('core-cli-utils');
-
-type BundlerOptions = {
-  // Metro's config: https://metrobundler.dev/docs/configuration/
-  config?: string,
-  // Typically index.{ios,android}.js
-  entryFile: string,
-  +platform: 'ios' | 'android' | string,
-  dev: boolean,
-  // Metro built main bundle
-  outputJsBundle: string,
-  minify: boolean,
-  optimize: boolean,
-  // Generate a source map file
-  outputSourceMap: string,
-  // Where to pass the final bundle. Typically this is the App's resource
-  // folder, however this is app specific. React Native will need to know where
-  // this is to bootstrap your application.  See:
-  // - Android: https://reactnative.dev/docs/integration-with-existing-apps?language=kotlin#creating-a-release-build-in-android-studio
-  // - iOS: https://reactnative.dev/docs/integration-with-existing-apps?language=swift#2-event-handler
-  outputBundle: string,
-  cwd: string,
-
-  jsvm: 'hermes' | 'jsc',
-  hermes?: HermesConfig,
-
-  ...Bundler,
-};
-
-type HermesConfig = {
-  // Path where hermes is is installed
-  // iOS: Pods/hermes-engine
-  path: string,
-  // iOS: <hermes.path>/destroot/bin/hermesc
-  hermesc: string,
-};
-
-type BundlerWatch = {
-  +mode: 'watch',
-  callback?: (metro: ExecaPromise) => void,
-};
-
-type BundlerBuild = {
-  +mode: 'bundle',
-};
-
-type Bundler = BundlerWatch | BundlerBuild;
-
-const FIRST = 1,
-  SECOND = 2,
-  THIRD = 3,
-  FOURTH = 4;
-
-function getNodePackagePath(packageName: string): string {
-  // $FlowIgnore[prop-missing] type definition is incomplete
-  return require.resolve(packageName, {cwd: [process.cwd(), ...module.paths]});
-}
-
-function metro(...args: $ReadOnlyArray<string>): ExecaPromise {
-  const metroPath = getNodePackagePath(path.join('metro', 'src', 'cli.js'));
-  log(`🚇 ${metroPath} ${args.join(' ')} `);
-  return execa('node', [metroPath, ...args]);
-}
-
-export const tasks = {
-  bundle: (
-    options: BundlerOptions,
-    ...args: $ReadOnlyArray<string>
-  ): Bundle => {
-    const steps: Bundle = {
-      /* eslint-disable sort-keys */
-      validate: task(FIRST, 'Check if Metro is available', () => {
-        try {
-          require('metro');
-        } catch {
-          throw new Error('Metro is not available');
-        }
-      }),
-      javascript: task(SECOND, 'Metro watching for changes', () =>
-        metro('serve', ...args),
-      ),
-    };
-
-    return options.mode === 'bundle'
-      ? Object.assign(steps, bundleApp(options, ...args))
-      : steps;
-  },
-};
-
-type Bundle = {
-  validate?: Task<void>,
-  javascript: Task<ExecaPromise>,
-  sourcemap?: Task<void>,
-  validateHermesc?: Task<ExecaPromise>,
-  convert?: Task<ExecaPromise>,
-  compose?: Task<ExecaPromise>,
-};
-
-const bundleApp = (
-  options: BundlerOptions,
-  ...metroArgs: $ReadOnlyArray<string>
-) => {
-  if (options.outputJsBundle === options.outputBundle) {
-    throw new Error('outputJsBundle and outputBundle cannot be the same.');
-  }
-  // When using Hermes, Metro should generate the JS bundle to an intermediate file
-  // to then be converted to bytecode in the outputBundle. Otherwise just write to
-  // the outputBundle directly.
-  let output =
-    options.jsvm === 'hermes' ? options.outputJsBundle : options.outputBundle;
-
-  // TODO: Fix this by not using Metro CLI, which appends a .js extension
-  if (output === options.outputJsBundle && !output.endsWith('.js')) {
-    log(
-      `Appending .js to outputBundle (because metro cli does it if it's missing): ${output}`,
-    );
-    output += '.js';
-  }
-
-  const isSourceMaps = options.outputSourceMap != null;
-  const bundle: Bundle = {
-    javascript: task(SECOND, 'Metro generating an .jsbundle', () => {
-      const args = [
-        '--platform',
-        options.platform,
-        '--dev',
-        options.dev ? 'true' : 'false',
-        '--reset-cache',
-        '--out',
-        output,
-      ];
-      if (options.jsvm === 'hermes' && !options.dev) {
-        // Hermes doesn't require JS minification
-        args.push('--minify', 'false');
-      } else {
-        args.push('--minify', options.minify ? 'true' : 'false');
-      }
-      if (isSourceMaps) {
-        args.push('--source-map');
-      }
-      return metro('build', options.entryFile, ...args, ...metroArgs);
-    }),
-  };
-
-  if (options.jsvm === 'jsc') {
-    return bundle;
-  }
-
-  if (options.hermes?.path == null || options.hermes?.hermesc == null) {
-    throw new Error('If jsvm == "hermes", hermes config must be provided.');
-  }
-
-  const hermes: HermesConfig = options.hermes;
-
-  const isHermesInstalled: boolean = fs.existsSync(hermes.path);
-  if (!isHermesInstalled) {
-    throw new Error(
-      'Hermes Pod must be installed before bundling.\n' +
-        'Did you forget to bootstrap?',
-    );
-  }
-
-  const hermesc: string = path.join(hermes.path, hermes.hermesc);
-
-  /*
-   * Hermes only tasks:
-   */
-  let composeSourceMaps;
-  if (isSourceMaps) {
-    bundle.sourcemap = task(
-      FIRST,
-      'Check if SourceMap script available',
-      () => {
-        composeSourceMaps = getNodePackagePath(
-          'react-native/scripts/compose-source-maps.js',
-        );
-      },
-    );
-  }
-
-  bundle.validateHermesc = task(FIRST, 'Check if Hermesc is available', () =>
-    execa(hermesc, ['--version']),
-  );
-
-  bundle.convert = task(
-    THIRD,
-    'Hermesc converting .jsbundle → bytecode',
-    () => {
-      const args = [
-        '-emit-binary',
-        '-max-diagnostic-width=80',
-        options.dev === true ? '-Og' : '-O',
-      ];
-      if (isSourceMaps) {
-        args.push('-output-source-map');
-      }
-      args.push(`-out=${options.outputBundle}`, output);
-      return execa(hermesc, args, {cwd: options.cwd});
-    },
-  );
-
-  bundle.compose = task(FOURTH, 'Compose Hermes and Metro source maps', () => {
-    if (composeSourceMaps == null) {
-      throw new Error(
-        'Unable to find the compose-source-map.js script in react-native',
-      );
-    }
-    const metroSourceMap = output.replace(/(\.js)?$/, '.map');
-    const hermesSourceMap = options.outputBundle + '.map';
-    const compose = execa(
-      'node',
-      [
-        composeSourceMaps,
-        metroSourceMap,
-        hermesSourceMap,
-        `-o ${options.outputSourceMap}`,
-      ],
-      {
-        cwd: options.cwd,
-      },
-    );
-    compose.finally(() => {
-      fs.rmSync(metroSourceMap, {force: true});
-      fs.rmSync(hermesSourceMap, {force: true});
-    });
-    return compose;
-  });
-
-  return bundle;
-};

package/src/private/apple.js

@@ -1,196 +0,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.
- *
- * @flow strict-local
- * @format
- * @oncall react_native
- */
-
-import type {Task} from './types';
-import type {ExecaPromise} from 'execa';
-
-import {assertDependencies, isOnPath, task} from './utils';
-import execa from 'execa';
-import fs from 'fs';
-import path from 'path';
-
-type AppleBuildMode = 'Debug' | 'Release';
-
-type AppleBuildOptions = {
-  isWorkspace: boolean,
-  name: string,
-  mode: AppleBuildMode,
-  scheme?: string,
-  destination: 'device' | 'simulator' | string,
-  ...AppleOptions,
-};
-
-type AppleBootstrapOption = {
-  // Enabled by default
-  hermes: boolean,
-  newArchitecture: boolean,
-  frameworks?: 'static' | 'dynamic',
-  ...AppleOptions,
-};
-
-type AppleInstallApp = {
-  // Install the app on a simulator or device, typically this is the description from
-  // `xcrun simctl list devices`
-  device: string,
-  appPath: string,
-  bundleId: string,
-  ...AppleOptions,
-};
-
-type AppleOptions = {
-  // The directory where the Xcode project is located
-  cwd: string,
-  // The environment variables to pass to the build command
-  env?: {[key: string]: string | void, ...},
-};
-
-function checkPodfileInSyncWithManifest(
-  lockfilePath: string,
-  manifestLockfilePath: string,
-) {
-  try {
-    const expected = fs.readFileSync(lockfilePath, 'utf8');
-    const found = fs.readFileSync(manifestLockfilePath, 'utf8');
-    if (expected !== found) {
-      throw new Error(
-        'Please run: yarn bootstrap ios, Podfile.lock and Pods/Manifest.lock are out of sync',
-      );
-    }
-  } catch (e) {
-    throw new Error('Please run: yarn run boostrap ios: ' + e.message);
-  }
-}
-
-const FIRST = 1,
-  SECOND = 2,
-  THIRD = 3;
-
-/* eslint sort-keys: "off" */
-export const tasks = {
-  // 1. Setup your environment for building the iOS apps
-  bootstrap: (
-    options: AppleBootstrapOption,
-  ): {
-    validate: Task<void>,
-    installRubyGems: Task<ExecaPromise>,
-    installDependencies: Task<ExecaPromise>,
-  } => ({
-    validate: task(FIRST, 'Check Cocoapods and bundle are available', () => {
-      assertDependencies(
-        isOnPath('pod', 'CocoaPods'),
-        isOnPath('bundle', "Bundler to manage Ruby's gems"),
-      );
-    }),
-    installRubyGems: task(SECOND, 'Install Ruby Gems', () =>
-      execa('bundle', ['install'], {
-        cwd: options.cwd,
-      }),
-    ),
-    installDependencies: task(THIRD, 'Install CocoaPods dependencies', () => {
-      const env = {
-        RCT_NEW_ARCH_ENABLED: options.newArchitecture ? '1' : '0',
-        USE_FRAMEWORKS: options.frameworks,
-        USE_HERMES: options.hermes ? '1' : '0',
-      };
-      if (options.frameworks == null) {
-        delete env.USE_FRAMEWORKS;
-      }
-      return execa('bundle', ['exec', 'pod', 'install'], {
-        cwd: options.cwd,
-        env,
-      });
-    }),
-  }),
-
-  // 2. Build the iOS app using a setup environment
-  build: (
-    options: AppleBuildOptions,
-    ...args: $ReadOnlyArray<string>
-  ): {
-    validate: Task<void>,
-    hasPodsInstalled: Task<void>,
-    build: Task<ExecaPromise>,
-  } => ({
-    validate: task(
-      FIRST,
-      "Check you've run xcode-select --install for xcodebuild",
-      () => {
-        assertDependencies(isOnPath('xcodebuild', 'Xcode Commandline Tools'));
-      },
-    ),
-    hasPodsInstalled: task(FIRST, 'Check Pods are installed', () => {
-      for (const file of ['Podfile.lock', 'Pods']) {
-        try {
-          fs.accessSync(
-            path.join(options.cwd, file),
-            /* eslint-disable-next-line no-bitwise */
-            fs.constants.F_OK | fs.constants.R_OK,
-          );
-        } catch (e) {
-          throw new Error('Please run: yarn run boostrap ios: ' + e.message);
-        }
-      }
-      checkPodfileInSyncWithManifest(
-        path.join(options.cwd, 'Podfile.lock'),
-        path.join(options.cwd, 'Pods/Manifest.lock'),
-      );
-    }),
-    build: task(SECOND, 'build an app artifact', () => {
-      const _args = [
-        options.isWorkspace ? '-workspace' : '-project',
-        options.name,
-        '-configuration',
-        options.mode,
-      ];
-      if (options.scheme != null) {
-        _args.push('-scheme', options.scheme);
-      }
-      if (options.destination != null) {
-        // The user doesn't want a generic target, they know better.
-        switch (options.destination) {
-          case 'simulator':
-            _args.push('-sdk', 'iphonesimulator');
-            break;
-          case 'device':
-          default:
-            _args.push('-destination', options.destination);
-            break;
-        }
-      }
-
-      _args.push(...args);
-      return execa('xcodebuild', _args, {cwd: options.cwd, env: options.env});
-    }),
-  }),
-
-  // 3. Install the built app on a simulator or device
-  ios: {
-    install: (
-      options: AppleInstallApp,
-    ): {validate: Task<void>, install: Task<ExecaPromise>} => ({
-      validate: task(
-        FIRST,
-        "Check you've run xcode-select --install for xcrun",
-        () => {
-          assertDependencies(
-            isOnPath('xcrun', 'An Xcode Commandline tool: xcrun'),
-          );
-        },
-      ),
-      install: task(SECOND, 'Install the app on a simulator', () =>
-        execa('xcrun', ['simctl', 'install', options.device, options.appPath], {
-          cwd: options.cwd,
-          env: options.env,
-        }),
-      ),
-    }),
-  },
-};