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

package/dist/private/apple.js

@@ -0,0 +1,148 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.tasks = void 0;
+var _utils = require("./utils");
+var _execa = _interopRequireDefault(require("execa"));
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+function checkPodfileInSyncWithManifest(lockfilePath, manifestLockfilePath) {
+  try {
+    const expected = _fs.default.readFileSync(lockfilePath, "utf8");
+    const found = _fs.default.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;
+const tasks = {
+  bootstrap: (options) => ({
+    validate: (0, _utils.task)(
+      FIRST,
+      "Check Cocoapods and bundle are available",
+      () => {
+        (0, _utils.assertDependencies)(
+          (0, _utils.isOnPath)("pod", "CocoaPods"),
+          (0, _utils.isOnPath)("bundle", "Bundler to manage Ruby's gems")
+        );
+      }
+    ),
+    installRubyGems: (0, _utils.task)(SECOND, "Install Ruby Gems", () =>
+      (0, _execa.default)("bundle", ["install"], {
+        cwd: options.cwd,
+      })
+    ),
+    installDependencies: (0, _utils.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 (0, _execa.default)("bundle", ["exec", "pod", "install"], {
+          cwd: options.cwd,
+          env,
+        });
+      }
+    ),
+  }),
+  build: (options, ...args) => ({
+    validate: (0, _utils.task)(
+      FIRST,
+      "Check you've run xcode-select --install for xcodebuild",
+      () => {
+        (0, _utils.assertDependencies)(
+          (0, _utils.isOnPath)("xcodebuild", "Xcode Commandline Tools")
+        );
+      }
+    ),
+    hasPodsInstalled: (0, _utils.task)(
+      FIRST,
+      "Check Pods are installed",
+      () => {
+        for (const file of ["Podfile.lock", "Pods"]) {
+          try {
+            _fs.default.accessSync(
+              _path.default.join(options.cwd, file),
+              _fs.default.constants.F_OK | _fs.default.constants.R_OK
+            );
+          } catch (e) {
+            throw new Error("Please run: yarn run boostrap ios: " + e.message);
+          }
+        }
+        checkPodfileInSyncWithManifest(
+          _path.default.join(options.cwd, "Podfile.lock"),
+          _path.default.join(options.cwd, "Pods/Manifest.lock")
+        );
+      }
+    ),
+    build: (0, _utils.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) {
+        switch (options.destination) {
+          case "simulator":
+            _args.push("-sdk", "iphonesimulator");
+            break;
+          case "device":
+          default:
+            _args.push("-destination", options.destination);
+            break;
+        }
+      }
+      _args.push(...args);
+      return (0, _execa.default)("xcodebuild", _args, {
+        cwd: options.cwd,
+        env: options.env,
+      });
+    }),
+  }),
+  ios: {
+    install: (options) => ({
+      validate: (0, _utils.task)(
+        FIRST,
+        "Check you've run xcode-select --install for xcrun",
+        () => {
+          (0, _utils.assertDependencies)(
+            (0, _utils.isOnPath)("xcrun", "An Xcode Commandline tool: xcrun")
+          );
+        }
+      ),
+      install: (0, _utils.task)(SECOND, "Install the app on a simulator", () =>
+        (0, _execa.default)(
+          "xcrun",
+          ["simctl", "install", options.device, options.appPath],
+          {
+            cwd: options.cwd,
+            env: options.env,
+          }
+        )
+      ),
+    }),
+  },
+};
+exports.tasks = tasks;

package/dist/private/apple.js.flow

@@ -0,0 +1,71 @@
+/**
+ * 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";
+
+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, ... },
+};
+
+/* eslint sort-keys: "off" */
+declare export const tasks: {
+  bootstrap: (options: AppleBootstrapOption) => {
+    validate: Task<void>,
+    installRubyGems: Task<ExecaPromise>,
+    installDependencies: Task<ExecaPromise>,
+  },
+  build: (
+    options: AppleBuildOptions,
+    ...args: $ReadOnlyArray<string>
+  ) => {
+    validate: Task<void>,
+    hasPodsInstalled: Task<void>,
+    build: Task<ExecaPromise>,
+  },
+  ios: {
+    install: (options: AppleInstallApp) => {
+      validate: Task<void>,
+      install: Task<ExecaPromise>,
+    },
+  },
+};

package/dist/private/clean.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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
+ */
+
+import type { Task } from "./types";
+import type { ExecaPromise, Options as ExecaOptions } from "execa";
+/**
+ * Removes the contents of a directory matching a given pattern, but keeps the directory.
+ * @private
+ */
+export declare function deleteDirectoryContents(
+  directory: string,
+  filePattern: RegExp
+): () => Promise<void>;
+/**
+ * Removes a directory recursively.
+ * @private
+ */
+export declare function deleteDirectory(directory: string): () => Promise<void>;
+/**
+ * Deletes the contents of the tmp directory matching a given pattern.
+ * @private
+ */
+export declare function deleteTmpDirectoryContents(
+  filepattern: RegExp
+): () => Promise<void>;
+type CocoaPodsClean = { clean: Task<ExecaPromise> };
+type AndroidClean = { validate: Task<void>; run: Task<ExecaPromise> };
+type MetroClean = {
+  metro: Task<Promise<void>>;
+  haste: Task<Promise<void>>;
+  react_native: Task<Promise<void>>;
+};
+type NpmClean = {
+  node_modules: Task<Promise<void>>;
+  verify_cache: Task<ExecaPromise>;
+};
+type WatchmanClean = { stop: Task<ExecaPromise>; cache: Task<ExecaPromise> };
+type YarnClean = { clean: Task<ExecaPromise> };
+type CleanTasks = {
+  android: (
+    andoirdSrcDir: null | undefined | string,
+    opts?: ExecaOptions
+  ) => AndroidClean;
+  cocoapods: CocoaPodsClean;
+  metro: () => MetroClean;
+  npm: (projectRootDir: string) => NpmClean;
+  watchman: (projectRootDir: string) => WatchmanClean;
+  yarn: (projectRootDir: string) => YarnClean;
+  cocoapods?: (projectRootDir: string) => CocoaPodsClean;
+};
+export declare const tasks: CleanTasks;

package/dist/private/clean.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.deleteDirectory = deleteDirectory;
+exports.deleteDirectoryContents = deleteDirectoryContents;
+exports.deleteTmpDirectoryContents = deleteTmpDirectoryContents;
+exports.tasks = void 0;
+var _utils = require("./utils");
+var _execa = _interopRequireDefault(require("execa"));
+var _fs = require("fs");
+var _os = _interopRequireDefault(require("os"));
+var _path = _interopRequireDefault(require("path"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+const FIRST = 1,
+  SECOND = 2;
+const rmrf = (pathname) => {
+  if (!(0, _fs.existsSync)(pathname)) {
+    return;
+  }
+  (0, _fs.rm)(pathname, {
+    force: true,
+    maxRetries: 3,
+    recursive: true,
+  });
+};
+function deleteDirectoryContents(directory, filePattern) {
+  return async function deleteDirectoryContentsAction() {
+    const base = _path.default.dirname(directory);
+    const files = (0, _fs.readdirSync)(base).filter((filename) =>
+      filePattern.test(filename)
+    );
+    for (const filename of files) {
+      rmrf(_path.default.join(base, filename));
+    }
+  };
+}
+function deleteDirectory(directory) {
+  return async function cleanDirectoryAction() {
+    rmrf(directory);
+  };
+}
+function deleteTmpDirectoryContents(filepattern) {
+  return deleteDirectoryContents(_os.default.tmpdir(), filepattern);
+}
+const platformGradlew = _utils.isWindows ? "gradlew.bat" : "gradlew";
+const tasks = {
+  android: (androidSrcDir, opts) => ({
+    validate: (0, _utils.task)(FIRST, "Check gradlew is available", () => {
+      (0, _utils.assertDependencies)(
+        (0, _utils.isOnPath)(platformGradlew, "Gradle wrapper")
+      );
+    }),
+    run: (0, _utils.task)(SECOND, "🧹 Clean Gradle cache", () => {
+      const gradlew = _path.default.join(
+        androidSrcDir ?? "android",
+        platformGradlew
+      );
+      const script = _path.default.basename(gradlew);
+      const cwd = _path.default.dirname(gradlew);
+      return (0, _execa.default)(
+        _utils.isWindows ? script : "./" + script,
+        ["clean"],
+        {
+          cwd,
+          ...opts,
+        }
+      );
+    }),
+  }),
+  metro: () => ({
+    metro: (0, _utils.task)(
+      FIRST,
+      "🧹 Clean Metro cache",
+      deleteTmpDirectoryContents(/^metro-.+/)
+    ),
+    haste: (0, _utils.task)(
+      FIRST,
+      "🧹 Clean Haste cache",
+      deleteTmpDirectoryContents(/^haste-map-.+/)
+    ),
+    react_native: (0, _utils.task)(
+      FIRST,
+      "🧹 Clean React Native cache",
+      deleteTmpDirectoryContents(/^react-.+/)
+    ),
+  }),
+  npm: (projectRootDir) => ({
+    node_modules: (0, _utils.task)(
+      FIRST,
+      "🧹 Clean node_modules",
+      deleteDirectory(_path.default.join(projectRootDir, "node_modules"))
+    ),
+    verify_cache: (0, _utils.task)(SECOND, "🔬 Verify npm cache", (opts) =>
+      (0, _execa.default)("npm", ["cache", "verify"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
+    ),
+  }),
+  watchman: (projectRootDir) => ({
+    stop: (0, _utils.task)(FIRST, "✋ Stop Watchman", (opts) =>
+      (0, _execa.default)(
+        _utils.isWindows ? "tskill" : "killall",
+        ["watchman"],
+        {
+          cwd: projectRootDir,
+          ...opts,
+        }
+      )
+    ),
+    cache: (0, _utils.task)(SECOND, "🧹 Delete Watchman cache", (opts) =>
+      (0, _execa.default)("watchman", ["watch-del-all"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
+    ),
+  }),
+  yarn: (projectRootDir) => ({
+    clean: (0, _utils.task)(FIRST, "🧹 Clean Yarn cache", (opts) =>
+      (0, _execa.default)("yarn", ["cache", "clean"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
+    ),
+  }),
+};
+exports.tasks = tasks;
+if (_utils.isMacOS) {
+  tasks.cocoapods = (projectRootDir) => ({
+    clean: (0, _utils.task)(FIRST, "🧹 Clean CocoaPods pod cache", (opts) =>
+      (0, _execa.default)("bundle", ["exec", "pod", "deintegrate"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
+    ),
+  });
+}

package/dist/private/clean.js.flow

@@ -0,0 +1,77 @@
+/**
+ * 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, Options as ExecaOptions } from "execa";
+
+/**
+ * Removes the contents of a directory matching a given pattern, but keeps the directory.
+ * @private
+ */
+declare export function deleteDirectoryContents(
+  directory: string,
+  filePattern: RegExp
+): () => Promise<void>;
+
+/**
+ * Removes a directory recursively.
+ * @private
+ */
+declare export function deleteDirectory(directory: string): () => Promise<void>;
+
+/**
+ * Deletes the contents of the tmp directory matching a given pattern.
+ * @private
+ */
+declare export function deleteTmpDirectoryContents(
+  filepattern: RegExp
+): () => Promise<void>;
+
+type CocoaPodsClean = {
+  clean: Task<ExecaPromise>,
+};
+type AndroidClean = {
+  validate: Task<void>,
+  run: Task<ExecaPromise>,
+};
+type MetroClean = {
+  metro: Task<Promise<void>>,
+  haste: Task<Promise<void>>,
+  react_native: Task<Promise<void>>,
+};
+
+type NpmClean = {
+  node_modules: Task<Promise<void>>,
+  verify_cache: Task<ExecaPromise>,
+};
+
+type WatchmanClean = {
+  stop: Task<ExecaPromise>,
+  cache: Task<ExecaPromise>,
+};
+
+type YarnClean = {
+  clean: Task<ExecaPromise>,
+};
+
+type CleanTasks = {
+  android: (andoirdSrcDir: ?string, opts?: ExecaOptions) => AndroidClean,
+  cocoapods: CocoaPodsClean,
+  metro: () => MetroClean,
+  npm: (projectRootDir: string) => NpmClean,
+  watchman: (projectRootDir: string) => WatchmanClean,
+  yarn: (projectRootDir: string) => YarnClean,
+  cocoapods?: (projectRootDir: string) => CocoaPodsClean,
+};
+
+// The tasks that cleanup various build artefacts.
+/* eslint sort-keys: "off" */
+declare export const tasks: CleanTasks;

package/dist/private/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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
+ */
+
+export type Task<R = unknown> = {
+  order: number;
+  label: string;
+  action: () => R;
+};

package/dist/private/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/private/utils.d.ts

@@ -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.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type { Task } from "./types";
+export declare function task<R>(
+  order: number,
+  label: string,
+  action: Task<R>["action"]
+): Task<R>;
+export declare const isWindows: any;
+export declare const isMacOS: any;
+export declare const toPascalCase: (label: string) => string;
+type PathCheckResult = { found: boolean; dep: string; description: string };
+export declare function isOnPath(
+  dep: string,
+  description: string
+): PathCheckResult;
+export declare function assertDependencies(
+  ...deps: ReadonlyArray<ReturnType<typeof isOnPath>>
+): void;

package/dist/private/utils.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.assertDependencies = assertDependencies;
+exports.isMacOS = void 0;
+exports.isOnPath = isOnPath;
+exports.isWindows = void 0;
+exports.task = task;
+exports.toPascalCase = void 0;
+var _execa = _interopRequireDefault(require("execa"));
+var _os = _interopRequireDefault(require("os"));
+function _interopRequireDefault(obj) {
+  return obj && obj.__esModule ? obj : { default: obj };
+}
+function task(order, label, action) {
+  return {
+    action,
+    label,
+    order,
+  };
+}
+const isWindows = _os.default.platform() === "win32";
+exports.isWindows = isWindows;
+const isMacOS = _os.default.platform() === "darwin";
+exports.isMacOS = isMacOS;
+const toPascalCase = (label) =>
+  label.length === 0 ? "" : label[0].toUpperCase() + label.slice(1);
+exports.toPascalCase = toPascalCase;
+function isOnPath(dep, description) {
+  const cmd = isWindows ? ["where", [dep]] : ["command", ["-v", dep]];
+  try {
+    return {
+      dep,
+      description,
+      found: _execa.default.sync(...cmd).exitCode === 0,
+    };
+  } catch {
+    return {
+      dep,
+      description,
+      found: false,
+    };
+  }
+}
+function assertDependencies(...deps) {
+  for (const { found, dep, description } of deps) {
+    if (!found) {
+      throw new Error(`"${dep}" not found, ${description}`);
+    }
+  }
+}

package/dist/private/utils.js.flow

@@ -0,0 +1,38 @@
+/**
+ * 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";
+
+declare export function task<R>(
+  order: number,
+  label: string,
+  action: Task<R>["action"]
+): Task<R>;
+
+declare export const isWindows: $FlowFixMe;
+declare export const isMacOS: $FlowFixMe;
+
+declare export const toPascalCase: (label: string) => string;
+
+type PathCheckResult = {
+  found: boolean,
+  dep: string,
+  description: string,
+};
+
+declare export function isOnPath(
+  dep: string,
+  description: string
+): PathCheckResult;
+
+declare export function assertDependencies(
+  ...deps: $ReadOnlyArray<ReturnType<typeof isOnPath>>
+): void;

package/dist/public/version.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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
+ */
+
+export declare const android: {
+  ANDROID_NDK: ">= 23.x";
+  ANDROID_SDK: ">= 33.x";
+};
+export declare const apple: { COCOAPODS: ">= 1.10.0"; XCODE: ">= 12.x" };
+export declare const common: {
+  BUN: ">= 1.0.0";
+  JAVA: ">= 17 <= 20";
+  NODE_JS: ">= 18";
+  NPM: ">= 4.x";
+  RUBY: ">= 2.6.10";
+  YARN: ">= 1.10.x";
+};
+export declare const all: Omit<apple, keyof (android | common | {})> &
+  Omit<android, keyof (common | {})> &
+  Omit<common, keyof ({})> & {};

package/dist/public/version.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.common = exports.apple = exports.android = exports.all = void 0;
+const android = {
+  ANDROID_NDK: ">= 23.x",
+  ANDROID_SDK: ">= 33.x",
+};
+exports.android = android;
+const apple = {
+  COCOAPODS: ">= 1.10.0",
+  XCODE: ">= 12.x",
+};
+exports.apple = apple;
+const common = {
+  BUN: ">= 1.0.0",
+  JAVA: ">= 17 <= 20",
+  NODE_JS: ">= 18",
+  NPM: ">= 4.x",
+  RUBY: ">= 2.6.10",
+  YARN: ">= 1.10.x",
+};
+exports.common = common;
+const all = {
+  ...apple,
+  ...android,
+  ...common,
+};
+exports.all = all;