@react-native/core-cli-utils 0.75.0-nightly-20240425-2876fae8d → 0.75.0-nightly-20240426-9c4ee6df0

package/dist/index.d.ts

@@ -9,11 +9,4 @@
  * @oncall react_native
  */
 
-declare const $$EXPORT_DEFAULT_DECLARATION$$: {
-  android: any;
-  apple: any;
-  clean: any;
-  version: any;
-};
-export default $$EXPORT_DEFAULT_DECLARATION$$;
-export type { Task } from "./private/types";
+export * from "./index.flow.js";

package/dist/index.flow.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 { tasks as _android } from "./private/android.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 declare const android: typeof _android;
+export declare const apple: typeof _apple;
+export declare const clean: typeof _clean;
+export declare const version: typeof _version;
+export type { Task } from "./private/types";

package/dist/index.flow.js

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.version = exports.clean = exports.apple = exports.android = void 0;
+var _android2 = require("./private/android.js");
+var _apple2 = require("./private/apple.js");
+var _clean2 = require("./private/clean.js");
+var _version = _interopRequireWildcard(require("./public/version.js"));
+function _getRequireWildcardCache(nodeInterop) {
+  if (typeof WeakMap !== "function") return null;
+  var cacheBabelInterop = new WeakMap();
+  var cacheNodeInterop = new WeakMap();
+  return (_getRequireWildcardCache = function (nodeInterop) {
+    return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+  })(nodeInterop);
+}
+function _interopRequireWildcard(obj, nodeInterop) {
+  if (!nodeInterop && obj && obj.__esModule) {
+    return obj;
+  }
+  if (obj === null || (typeof obj !== "object" && typeof obj !== "function")) {
+    return { default: obj };
+  }
+  var cache = _getRequireWildcardCache(nodeInterop);
+  if (cache && cache.has(obj)) {
+    return cache.get(obj);
+  }
+  var newObj = {};
+  var hasPropertyDescriptor =
+    Object.defineProperty && Object.getOwnPropertyDescriptor;
+  for (var key in obj) {
+    if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+      var desc = hasPropertyDescriptor
+        ? Object.getOwnPropertyDescriptor(obj, key)
+        : null;
+      if (desc && (desc.get || desc.set)) {
+        Object.defineProperty(newObj, key, desc);
+      } else {
+        newObj[key] = obj[key];
+      }
+    }
+  }
+  newObj.default = obj;
+  if (cache) {
+    cache.set(obj, newObj);
+  }
+  return newObj;
+}
+/**
+ * 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
+ */
+
+// @babel/register doesn't like export {foo} from './bar'; statements,
+// so we have to jump through hoops here.
+
+const android = _android2.tasks;
+exports.android = android;
+const apple = _apple2.tasks;
+exports.apple = apple;
+const clean = _clean2.tasks;
+exports.clean = clean;
+const version = _version;
+exports.version = version;

package/dist/index.flow.js.flow

@@ -0,0 +1,24 @@
+/**
+ * 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 _apple } from "./private/apple.js";
+import { tasks as _clean } from "./private/clean.js";
+import * as _version from "./public/version.js";
+
+declare export const android: typeof _android;
+declare export const apple: typeof _apple;
+declare export const clean: typeof _clean;
+declare export const version: typeof _version;
+
+export type { Task } from "./private/types";

package/dist/index.js

@@ -3,51 +3,17 @@
 Object.defineProperty(exports, "__esModule", {
   value: true,
 });
-exports.default = void 0;
-var _android = require("./private/android.js");
-var _apple = require("./private/apple.js");
-var _clean = require("./private/clean.js");
-var version = _interopRequireWildcard(require("./public/version.js"));
-function _getRequireWildcardCache(nodeInterop) {
-  if (typeof WeakMap !== "function") return null;
-  var cacheBabelInterop = new WeakMap();
-  var cacheNodeInterop = new WeakMap();
-  return (_getRequireWildcardCache = function (nodeInterop) {
-    return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
-  })(nodeInterop);
-}
-function _interopRequireWildcard(obj, nodeInterop) {
-  if (!nodeInterop && obj && obj.__esModule) {
-    return obj;
-  }
-  if (obj === null || (typeof obj !== "object" && typeof obj !== "function")) {
-    return { default: obj };
-  }
-  var cache = _getRequireWildcardCache(nodeInterop);
-  if (cache && cache.has(obj)) {
-    return cache.get(obj);
-  }
-  var newObj = {};
-  var hasPropertyDescriptor =
-    Object.defineProperty && Object.getOwnPropertyDescriptor;
-  for (var key in obj) {
-    if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
-      var desc = hasPropertyDescriptor
-        ? Object.getOwnPropertyDescriptor(obj, key)
-        : null;
-      if (desc && (desc.get || desc.set)) {
-        Object.defineProperty(newObj, key, desc);
-      } else {
-        newObj[key] = obj[key];
-      }
-    }
-  }
-  newObj.default = obj;
-  if (cache) {
-    cache.set(obj, newObj);
-  }
-  return newObj;
-}
+var _indexFlow = require("./index.flow.js");
+Object.keys(_indexFlow).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _indexFlow[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _indexFlow[key];
+    },
+  });
+});
 /**
  * Copyright (c) Meta Platforms, Inc. and affiliates.
  *
@@ -58,13 +24,9 @@ function _interopRequireWildcard(obj, nodeInterop) {
  * @format
  * @oncall react_native
  */
-/* eslint sort-keys : "error" */
-var _default = {
-  // Platforms
-  android: typeof _android.tasks,
-  apple: typeof _apple.tasks,
-  clean: typeof _clean.tasks,
-  // Meta
-  version: typeof version,
-};
-exports.default = _default;
+
+const path = require("path");
+
+/*::
+export type * from './index.flow.js';
+*/

package/dist/index.js.flow

@@ -4,17 +4,9 @@
  * 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
+ * @flow
  * @format
  * @oncall react_native
  */
 
-/* eslint sort-keys : "error" */
-declare export default {
-  android: $FlowFixMe,
-  apple: $FlowFixMe,
-  clean: $FlowFixMe,
-  version: $FlowFixMe,
-};
-
-export type { Task } from "./private/types";
+export * from "./index.flow.js";

package/dist/private/android.d.ts

@@ -10,7 +10,7 @@
  */
 
 import type { Task } from "./types";
-import execa from "execa";
+import type { ExecaPromise } from "execa";
 type AndroidBuildMode = "debug" | "release";
 type AndroidBuild = {
   sourceDir: string;
@@ -18,7 +18,6 @@ type AndroidBuild = {
   mode: AndroidBuildMode;
   gradleArgs?: Array<string>;
 };
-type GradleReturn = ReturnType<typeof execa>;
 /**
  * Assembles an Android app using Gradle
  */
@@ -27,7 +26,7 @@ export declare const assemble: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: ReadonlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 /**
  * Assembles and tests an Android app using Gradle
  */
@@ -36,7 +35,7 @@ export declare const build: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: ReadonlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 /**
  * Installs an Android app using Gradle
  */
@@ -45,7 +44,7 @@ export declare const install: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: ReadonlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 /**
  * Runs a custom Gradle task if your frameworks needs aren't handled by assemble, build or install.
  */
@@ -53,10 +52,19 @@ export declare const customTask: (
   cwd: string,
   customTaskName: string,
   ...args: ReadonlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 type AndroidTasks = {
-  assemble: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
-  build: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
-  install: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
+  assemble: (
+    options: AndroidBuild,
+    ...args: ReadonlyArray<string>
+  ) => { run: Task<ExecaPromise> };
+  build: (
+    options: AndroidBuild,
+    ...args: ReadonlyArray<string>
+  ) => { run: Task<ExecaPromise> };
+  install: (
+    options: AndroidBuild,
+    ...args: ReadonlyArray<string>
+  ) => { run: Task<ExecaPromise> };
 };
 export declare const tasks: AndroidTasks;

package/dist/private/android.js

@@ -64,33 +64,35 @@ const install = (cwd, appName, mode, ...args) =>
 exports.install = install;
 const customTask = (cwd, customTaskName, ...args) =>
   gradle(cwd, customTaskName, ...args);
+exports.customTask = customTask;
+const FIRST = 1;
 
 //
 // Android Tasks
 //
-exports.customTask = customTask;
+
 const tasks = {
-  assemble: (options, ...gradleArgs) => [
-    (0, _utils.task)("Assemble Android App", () =>
+  assemble: (options, ...gradleArgs) => ({
+    run: (0, _utils.task)(FIRST, "Assemble Android App", () =>
       assemble(options.sourceDir, options.appName, options.mode, ...gradleArgs)
     ),
-  ],
-  build: (options, ...gradleArgs) => [
-    (0, _utils.task)("Assembles and tests Android App", () =>
+  }),
+  build: (options, ...gradleArgs) => ({
+    run: (0, _utils.task)(FIRST, "Assembles and tests Android App", () =>
       build(options.sourceDir, options.appName, options.mode, ...gradleArgs)
     ),
-  ],
+  }),
   /**
    * Useful extra gradle arguments:
    *
    * -PreactNativeDevServerPort=8081 sets the port for the installed app to point towards a Metro
    *                                 server on (for example) 8081.
    */
-  install: (options, ...gradleArgs) => [
-    (0, _utils.task)("Installs the assembled Android App", () =>
+  install: (options, ...gradleArgs) => ({
+    run: (0, _utils.task)(FIRST, "Installs the assembled Android App", () =>
       install(options.sourceDir, options.appName, options.mode, ...gradleArgs)
     ),
-  ],
+  }),
 
   // 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

package/dist/private/android.js.flow

@@ -10,8 +10,7 @@
  */
 
 import type { Task } from "./types";
-
-import execa from "execa";
+import type { ExecaPromise } from "execa";
 
 type AndroidBuildMode = "debug" | "release";
 
@@ -22,8 +21,6 @@ type AndroidBuild = {
   gradleArgs?: Array<string>,
 };
 
-type GradleReturn = ReturnType<typeof execa>;
-
 //
 // Gradle Task wrappers
 //
@@ -36,7 +33,7 @@ declare export const assemble: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: $ReadOnlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 
 /**
  * Assembles and tests an Android app using Gradle
@@ -46,7 +43,7 @@ declare export const build: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: $ReadOnlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 
 /**
  * Installs an Android app using Gradle
@@ -56,7 +53,7 @@ declare export const install: (
   appName: string,
   mode: AndroidBuildMode,
   ...args: $ReadOnlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 
 /**
  * Runs a custom Gradle task if your frameworks needs aren't handled by assemble, build or install.
@@ -65,16 +62,24 @@ declare export const customTask: (
   cwd: string,
   customTaskName: string,
   ...args: $ReadOnlyArray<string>
-) => GradleReturn;
+) => ExecaPromise;
 
 //
 // Android Tasks
 //
-
 type AndroidTasks = {
-  assemble: (options: AndroidBuild, ...args: $ReadOnlyArray<string>) => Task[],
-  build: (options: AndroidBuild, ...args: $ReadOnlyArray<string>) => Task[],
-  install: (options: AndroidBuild, ...args: $ReadOnlyArray<string>) => Task[],
+  assemble: (
+    options: AndroidBuild,
+    ...args: $ReadOnlyArray<string>
+  ) => { run: Task<ExecaPromise> },
+  build: (
+    options: AndroidBuild,
+    ...args: $ReadOnlyArray<string>
+  ) => { run: Task<ExecaPromise> },
+  install: (
+    options: AndroidBuild,
+    ...args: $ReadOnlyArray<string>
+  ) => { run: Task<ExecaPromise> },
 };
 
 declare export const tasks: AndroidTasks;

package/dist/private/apple.d.ts

@@ -10,23 +10,45 @@
  */
 
 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?: string;
-} & AppleOptions;
-type AppleBootstrapOption = {
-  bundleInstall: boolean;
-  newArchitecture: boolean;
-} & AppleOptions;
-type AppleInstallApp = { device: string; appPath: string } & AppleOptions;
+type AppleBuildOptions =
+  /**
+   * > 23 |   ...AppleOptions,
+   *      |   ^^^^^^^^^^^^^^^ Unsupported feature: Translating "object types with spreads in the middle or at the end" is currently not supported.
+   **/
+  any;
+type AppleBootstrapOption =
+  /**
+   * > 29 |   ...AppleOptions,
+   *      |   ^^^^^^^^^^^^^^^ Unsupported feature: Translating "object types with spreads in the middle or at the end" is currently not supported.
+   **/
+  any;
+type AppleInstallApp =
+  /**
+   * > 37 |   ...AppleOptions,
+   *      |   ^^^^^^^^^^^^^^^ Unsupported feature: Translating "object types with spreads in the middle or at the end" is currently not supported.
+   **/
+  any;
 type AppleOptions = { cwd: string; env?: { [key: string]: string | void } };
-type AppleBuildTasks = {
-  bootstrap: (options: AppleBootstrapOption) => Task[];
-  build: (options: AppleBuildOptions, ...args: ReadonlyArray<string>) => Task[];
-  ios: { install: (options: AppleInstallApp) => Task[] };
+export declare 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>;
+    };
+  };
 };
-export declare const tasks: AppleBuildTasks;

package/dist/private/apple.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 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 };
 }
@@ -20,37 +22,79 @@ function _interopRequireDefault(obj) {
  * @oncall react_native
  */
 
+const FIRST = 1,
+  SECOND = 2,
+  THIRD = 3;
+
+/* eslint sort-keys: "off" */
 const tasks = {
-  bootstrap: (options) => [
-    (0, _utils.task)("Install CocoaPods dependencies", async () => {
-      (0, _utils.assertDependencies)(
-        (0, _utils.isOnPath)("pod", "CocoaPods"),
-        (0, _utils.isOnPath)("bundle", "Bundler to manage Ruby's gems")
-      );
-      if (options.bundleInstall) {
-        await (0, _execa.default)("bundle", ["exec", "install"], {
-          cwd: options.cwd,
-        });
+  // 1. Setup your environment for building the iOS apps
+  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")
+        );
       }
-      return await (0, _execa.default)("bundle", ["exec", "pod", "install"], {
+    ),
+    installRubyGems: (0, _utils.task)(SECOND, "Install Ruby Gems", () =>
+      (0, _execa.default)("bundle", ["install"], {
         cwd: options.cwd,
-        env: {
-          RCT_NEW_ARCH_ENABLED: options.newArchitecture ? "1" : "0",
-        },
-      });
-    }),
-  ],
-  build: (options, ...args) => [
-    (0, _utils.task)("build an app artifact", () => {
-      (0, _utils.assertDependencies)(
-        (0, _utils.isOnPath)("xcodebuild", "Xcode Commandline Tools")
-      );
+      })
+    ),
+    installDependencies: (0, _utils.task)(
+      THIRD,
+      "Install CocoaPods dependencies",
+      () =>
+        (0, _execa.default)("bundle", ["exec", "pod", "install"], {
+          cwd: options.cwd,
+          env: {
+            RCT_NEW_ARCH_ENABLED: options.newArchitecture ? "1" : "0",
+          },
+        })
+    ),
+  }),
+  // 2. Build the iOS app using a setup environment
+  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
+              ) /* eslint-disable-next-line no-bitwise */,
+              _fs.default.constants.F_OK | _fs.default.constants.R_OK
+            );
+          } catch {
+            throw new Error("Please run: yarn run boostrap ios");
+          }
+        }
+      }
+    ),
+    build: (0, _utils.task)(SECOND, "build an app artifact", () => {
       const _args = [
         options.isWorkspace ? "-workspace" : "-project",
         options.name,
-        "-scheme",
-        options.scheme,
       ];
+      if (options.scheme != null) {
+        _args.push("-scheme", options.scheme);
+      }
       if (options.destination != null) {
         _args.push("-destination", options.destination);
       }
@@ -60,23 +104,30 @@ const tasks = {
         env: options.env,
       });
     }),
-  ],
+  }),
+  // 3. Install the built app on a simulator or device
   ios: {
-    install: (options) => [
-      (0, _utils.task)("Install the app on a simulator", () => {
-        (0, _utils.assertDependencies)(
-          (0, _utils.isOnPath)("xcrun", "An Xcode Commandline tool: xcrun")
-        );
-        return (0, _execa.default)(
+    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

@@ -10,6 +10,7 @@
  */
 
 import type { Task } from "./types";
+import type { ExecaPromise } from "execa";
 
 type AppleBuildMode = "Debug" | "Release";
 
@@ -17,35 +18,51 @@ type AppleBuildOptions = {
   isWorkspace: boolean,
   name: string,
   mode: AppleBuildMode,
-  scheme: string,
+  scheme?: string,
   destination?: string, // Device or Simulator or UUID
-} & AppleOptions;
+  ...AppleOptions,
+};
 
 type AppleBootstrapOption = {
-  bundleInstall: boolean,
   // Enabled by default
   newArchitecture: boolean,
-} & AppleOptions;
+  ...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,
-} & AppleOptions;
+  ...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, ... },
 };
 
-type AppleBuildTasks = {
-  bootstrap: (options: AppleBootstrapOption) => Task[],
+/* 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>
-  ) => Task[],
+  ) => {
+    validate: Task<void>,
+    hasPodsInstalled: Task<void>,
+    build: Task<ExecaPromise>,
+  },
   ios: {
-    install: (options: AppleInstallApp) => Task[],
+    install: (options: AppleInstallApp) => {
+      validate: Task<void>,
+      install: Task<ExecaPromise>,
+    },
   },
 };
-
-declare export const tasks: AppleBuildTasks;

package/dist/private/clean.d.ts

@@ -10,14 +10,7 @@
  */
 
 import type { Task } from "./types";
-type CleanTasks = {
-  android: (androidSrcDir: null | undefined | string) => Task[];
-  cocoapods?: (projectRootDir: string) => Task[];
-  metro: () => Task[];
-  npm: (projectRootDir: string, verifyCache?: boolean) => Task[];
-  watchman: (projectRootDir: string) => Task[];
-  yarn: (projectRootDir: string) => Task[];
-};
+import type { ExecaPromise, Options as ExecaOptions } from "execa";
 /**
  * Removes the contents of a directory matching a given pattern, but keeps the directory.
  * @private
@@ -25,17 +18,42 @@ type CleanTasks = {
 export declare function deleteDirectoryContents(
   directory: string,
   filePattern: RegExp
-): Task["action"];
+): () => Promise<void>;
 /**
  * Removes a directory recursively.
  * @private
  */
-export declare function deleteDirectory(directory: string): Task["action"];
+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
-): ReturnType<typeof deleteDirectoryContents>;
+): () => 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

@@ -26,6 +26,8 @@ function _interopRequireDefault(obj) {
  * @oncall react_native
  */
 
+const FIRST = 1,
+  SECOND = 2;
 const rmrf = (pathname) => {
   if (!(0, _fs.existsSync)(pathname)) {
     return;
@@ -70,74 +72,77 @@ function deleteDirectory(directory) {
 function deleteTmpDirectoryContents(filepattern) {
   return deleteDirectoryContents(_os.default.tmpdir(), filepattern);
 }
-
+const platformGradlew = _utils.isWindows ? "gradlew.bat" : "gradlew";
 // The tasks that cleanup various build artefacts.
+/* eslint sort-keys: "off" */
 const tasks = {
   /**
    * Cleans up the Android Gradle cache
    */
-  android: (androidSrcDir) => [
-    (0, _utils.task)("🧹 Clean Gradle cache", async function gradle(opts) {
+  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",
-        _utils.isWindows ? "gradlew.bat" : "gradlew"
+        platformGradlew
       );
-      if (!(0, _fs.existsSync)(gradlew)) {
-        return;
-      }
       const script = _path.default.basename(gradlew);
       const cwd = _path.default.dirname(gradlew);
-      await (0,
-      _execa.default)(_utils.isWindows ? script : `./${script}`, ["clean"], {
-        cwd,
-        ...opts,
-      });
+      return (0, _execa.default)(
+        _utils.isWindows ? script : "./" + script,
+        ["clean"],
+        {
+          cwd,
+          ...opts,
+        }
+      );
     }),
-  ],
+  }),
   /**
-   * Agressively cleans up all Metro caches.
+   * Aggressively cleans up all Metro caches.
    */
-  metro: () => [
-    (0, _utils.task)(
+  metro: () => ({
+    metro: (0, _utils.task)(
+      FIRST,
       "🧹 Clean Metro cache",
       deleteTmpDirectoryContents(/^metro-.+/)
     ),
-    (0, _utils.task)(
+    haste: (0, _utils.task)(
+      FIRST,
       "🧹 Clean Haste cache",
       deleteTmpDirectoryContents(/^haste-map-.+/)
     ),
-    (0, _utils.task)(
+    react_native: (0, _utils.task)(
+      FIRST,
       "🧹 Clean React Native cache",
       deleteTmpDirectoryContents(/^react-.+/)
     ),
-  ],
+  }),
   /**
    * Cleans up the `node_modules` folder and optionally garbage collects the npm cache.
    */
-  npm: (projectRootDir, verifyCache = false) => {
-    const _tasks = [
-      (0, _utils.task)(
-        "🧹 Clean node_modules",
-        deleteDirectory(_path.default.join(projectRootDir, "node_modules"))
-      ),
-    ];
-    if (verifyCache) {
-      _tasks.push(
-        (0, _utils.task)("🔬 Verify npm cache", (opts) =>
-          (0, _execa.default)("npm", ["cache", "verify"], {
-            cwd: projectRootDir,
-            ...opts,
-          })
-        )
-      );
-    }
-    return _tasks;
-  },
+  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,
+      })
+    ),
+  }),
   /**
    * Stops Watchman and clears its cache
    */
-  watchman: (projectRootDir) => [
-    (0, _utils.task)("✋ Stop Watchman", (opts) =>
+  watchman: (projectRootDir) => ({
+    stop: (0, _utils.task)(FIRST, "✋ Stop Watchman", (opts) =>
       (0, _execa.default)(
         _utils.isWindows ? "tskill" : "killall",
         ["watchman"],
@@ -147,44 +152,37 @@ const tasks = {
         }
       )
     ),
-    (0, _utils.task)("🧹 Delete Watchman cache", (opts) =>
+    cache: (0, _utils.task)(SECOND, "🧹 Delete Watchman cache", (opts) =>
       (0, _execa.default)("watchman", ["watch-del-all"], {
         cwd: projectRootDir,
         ...opts,
       })
     ),
-  ],
+  }),
   /**
    * Cleans up the Yarn cache
    */
-  yarn: (projectRootDir) => [
-    (0, _utils.task)("🧹 Clean Yarn cache", (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) {
   /**
    * Cleans up the local and global CocoaPods cache
    */
-  tasks.cocoapods = (projectRootDir) => [
+  tasks.cocoapods = (projectRootDir) => ({
     // TODO: add project root
-    (0, _utils.task)(
-      "🧹 Clean CocoaPods pod cache",
-      function removePodCache(opts) {
-        return (0, _execa.default)("bundle", ["exec", "pod", "deintegrate"], {
-          cwd: projectRootDir,
-          ...opts,
-        });
-      }
+    clean: (0, _utils.task)(FIRST, "🧹 Clean CocoaPods pod cache", (opts) =>
+      (0, _execa.default)("bundle", ["exec", "pod", "deintegrate"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
     ),
-  ];
+  });
 }
-
-//
-// Internal CLI
-//

package/dist/private/clean.js.flow

@@ -10,14 +10,7 @@
  */
 
 import type { Task } from "./types";
-type CleanTasks = {
-  android: (androidSrcDir: ?string) => Task[],
-  cocoapods?: (projectRootDir: string) => Task[],
-  metro: () => Task[],
-  npm: (projectRootDir: string, verifyCache?: boolean) => Task[],
-  watchman: (projectRootDir: string) => Task[],
-  yarn: (projectRootDir: string) => Task[],
-};
+import type { ExecaPromise, Options as ExecaOptions } from "execa";
 
 /**
  * Removes the contents of a directory matching a given pattern, but keeps the directory.
@@ -26,13 +19,13 @@ type CleanTasks = {
 declare export function deleteDirectoryContents(
   directory: string,
   filePattern: RegExp
-): Task["action"];
+): () => Promise<void>;
 
 /**
  * Removes a directory recursively.
  * @private
  */
-declare export function deleteDirectory(directory: string): Task["action"];
+declare export function deleteDirectory(directory: string): () => Promise<void>;
 
 /**
  * Deletes the contents of the tmp directory matching a given pattern.
@@ -40,7 +33,45 @@ declare export function deleteDirectory(directory: string): Task["action"];
  */
 declare export function deleteTmpDirectoryContents(
   filepattern: RegExp
-): ReturnType<typeof deleteDirectoryContents>;
+): () => 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

@@ -9,4 +9,8 @@
  * @oncall react_native
  */
 
-export type Task = { label: string; action: () => Promise<unknown> };
+export type Task<R = unknown> = {
+  order: number;
+  label: string;
+  action: () => R;
+};

package/dist/private/types.js.flow

@@ -9,7 +9,8 @@
  * @oncall react_native
  */
 
-export type Task = {
+export type Task<R = mixed> = {
+  order: number,
   label: string,
-  action: () => Promise<mixed>,
+  action: () => R,
 };

package/dist/private/utils.d.ts

@@ -10,7 +10,11 @@
  */
 
 import type { Task } from "./types";
-export declare function task(label: string, action: Task["action"]): Task;
+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;

package/dist/private/utils.js

@@ -25,10 +25,11 @@ function _interopRequireDefault(obj) {
  * @oncall react_native
  */
 
-function task(label, action) {
+function task(order, label, action) {
   return {
     action,
     label,
+    order,
   };
 }
 const isWindows = _os.default.platform() === "win32";
@@ -39,12 +40,20 @@ const toPascalCase = (label) =>
   label.length === 0 ? "" : label[0].toUpperCase() + label.slice(1);
 exports.toPascalCase = toPascalCase;
 function isOnPath(dep, description) {
-  const result = _execa.default.sync(isWindows ? "where" : "which", [dep]);
-  return {
-    dep,
-    description,
-    found: result.exitCode === 0,
-  };
+  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) {

package/dist/private/utils.js.flow

@@ -11,7 +11,11 @@
 
 import type { Task } from "./types";
 
-declare export function task(label: string, action: Task["action"]): Task;
+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;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@react-native/core-cli-utils",
-  "version": "0.75.0-nightly-20240425-2876fae8d",
+  "version": "0.75.0-nightly-20240426-9c4ee6df0",
   "description": "React Native CLI library for Frameworks to build on",
-  "main": "index.js",
+  "main": "./src/index.js",
   "license": "MIT",
   "repository": {
     "type": "git",