@react-native/core-cli-utils 0.75.0-main

package/README.md

@@ -0,0 +1,52 @@
+# @react-native/core-cli-utils
+
+![npm package](https://img.shields.io/npm/v/@react-native/core-cli-utils?color=brightgreen&label=npm%20package)
+
+A collection of utilites to help Frameworks build their React Native CLI tooling. This is not intended to be used directly use users of React Native.
+
+## Usage
+
+```js
+import { Command } from 'commander';
+import cli from '@react-native/core-cli-utils';
+import debug from 'debug';
+
+const android = new Command('android');
+
+const frameworkFindsAndroidSrcDir = "...";
+const tasks = cli.clean.android(frameworkFindsAndroidSrcDir);
+const log = debug('fancy-framework:android');
+
+android
+    .command('clean')
+    .description(cli.clean.android)
+    .action(async () => {
+        const log = debug('fancy-framework:android:clean');
+        log(`🧹 let me clean your Android caches`);
+        // Add other caches your framework needs besides the normal React Native caches
+        // here.
+        for (const task of tasks) {
+            try {
+                log(`\t ${task.label}`);
+                // See: https://github.com/sindresorhus/execa#lines
+                const {stdout} = await task.action({ lines: true })
+                log(stdout.join('\n\tGradle: '));
+            } catch (e) {
+                log(`\t ⚠️ whoops: ${e.message}`);
+            }
+        }
+    });
+```
+
+And you'd be using it like this:
+
+```bash
+$ ./fancy-framework android clean
+🧹 let me clean your Android caches
+    Gradle: // a bunch of gradle output
+    Gradle: ....
+```
+
+## Contributing
+
+Changes to this package can be made locally and linked against your app. Please see the [Contributing guide](https://reactnative.dev/contributing/overview#contributing-code).

package/dist/index.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";
+declare const $$EXPORT_DEFAULT_DECLARATION$$: {
+  android: android;
+  apple: apple;
+  clean: clean;
+};
+export default $$EXPORT_DEFAULT_DECLARATION$$;

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+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");
+/**
+ * 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
+ */
+/* eslint sort-keys : "error" */
+var _default = {
+  android: _android.tasks,
+  apple: _apple.tasks,
+  clean: _clean.tasks,
+};
+exports.default = _default;

package/dist/index.js.flow

@@ -0,0 +1,17 @@
+/**
+ * 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 { tasks as android } from "./private/android.js";
+import { tasks as apple } from "./private/apple.js";
+import { tasks as clean } from "./private/clean.js";
+
+/* eslint sort-keys : "error" */
+declare export default { android: android, apple: apple, clean: clean };

package/dist/private/android.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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 execa from "execa";
+type AndroidBuildMode = "debug" | "release";
+type AndroidBuild = {
+  sourceDir: string;
+  appName: string;
+  mode: AndroidBuildMode;
+  gradleArgs?: Array<string>;
+};
+type GradleReturn = ReturnType<typeof execa>;
+/**
+ * Assembles an Android app using Gradle
+ */
+export declare const assemble: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: ReadonlyArray<string>
+) => GradleReturn;
+/**
+ * Assembles and tests an Android app using Gradle
+ */
+export declare const build: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: ReadonlyArray<string>
+) => GradleReturn;
+/**
+ * Installs an Android app using Gradle
+ */
+export declare const install: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: ReadonlyArray<string>
+) => GradleReturn;
+/**
+ * Runs a custom Gradle task if your frameworks needs aren't handled by assemble, build or install.
+ */
+export declare const customTask: (
+  cwd: string,
+  customTaskName: string,
+  ...args: ReadonlyArray<string>
+) => GradleReturn;
+type AndroidTasks = {
+  assemble: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
+  build: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
+  install: (options: AndroidBuild, ...args: ReadonlyArray<string>) => Task[];
+};
+export declare const tasks: AndroidTasks;

package/dist/private/android.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.tasks =
+  exports.install =
+  exports.customTask =
+  exports.build =
+  exports.assemble =
+    void 0;
+var _utils = require("./utils");
+var _execa = _interopRequireDefault(require("execa"));
+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
+ */
+
+async function gradle(cwd, ...args) {
+  const gradlew = _utils.isWindows ? "gradlew.bat" : "./gradlew";
+  // $FlowFixMe[incompatible-return] Mismatch between flow and TypeScript types
+  return (0, _execa.default)(gradlew, args, {
+    cwd,
+    stdio: "inherit",
+  });
+}
+
+//
+// Gradle Task wrappers
+//
+
+/**
+ * Assembles an Android app using Gradle
+ */
+const assemble = (cwd, appName, mode, ...args) =>
+  gradle(cwd, `${appName}:assemble${(0, _utils.toPascalCase)(mode)}`, ...args);
+
+/**
+ * Assembles and tests an Android app using Gradle
+ */
+exports.assemble = assemble;
+const build = (cwd, appName, mode, ...args) =>
+  gradle(cwd, `${appName}:build${(0, _utils.toPascalCase)(mode)}`, ...args);
+
+/**
+ * Installs an Android app using Gradle
+ */
+exports.build = build;
+const install = (cwd, appName, mode, ...args) =>
+  gradle(cwd, `${appName}:install${(0, _utils.toPascalCase)(mode)}`, ...args);
+
+/**
+ * Runs a custom Gradle task if your frameworks needs aren't handled by assemble, build or install.
+ */
+exports.install = install;
+const customTask = (cwd, customTaskName, ...args) =>
+  gradle(cwd, customTaskName, ...args);
+
+//
+// Android Tasks
+//
+exports.customTask = customTask;
+const tasks = {
+  assemble: (options, ...gradleArgs) => [
+    (0, _utils.task)("Assemble Android App", () =>
+      assemble(options.sourceDir, options.appName, options.mode, ...gradleArgs)
+    ),
+  ],
+  build: (options, ...gradleArgs) => [
+    (0, _utils.task)("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.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
+  // CLI's code:
+  // https://github.com/react-native-community/cli/blob/54d48a4e08a1aef334ae6168788e0157a666b4f5/packages/cli-platform-android/src/commands/runAndroid/index.ts#L272C1-L290C2
+};
+exports.tasks = tasks;

package/dist/private/android.js.flow

@@ -0,0 +1,80 @@
+/**
+ * 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 execa from "execa";
+
+type AndroidBuildMode = "debug" | "release";
+
+type AndroidBuild = {
+  sourceDir: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  gradleArgs?: Array<string>,
+};
+
+type GradleReturn = ReturnType<typeof execa>;
+
+//
+// Gradle Task wrappers
+//
+
+/**
+ * Assembles an Android app using Gradle
+ */
+declare export const assemble: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: $ReadOnlyArray<string>
+) => GradleReturn;
+
+/**
+ * Assembles and tests an Android app using Gradle
+ */
+declare export const build: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: $ReadOnlyArray<string>
+) => GradleReturn;
+
+/**
+ * Installs an Android app using Gradle
+ */
+declare export const install: (
+  cwd: string,
+  appName: string,
+  mode: AndroidBuildMode,
+  ...args: $ReadOnlyArray<string>
+) => GradleReturn;
+
+/**
+ * Runs a custom Gradle task if your frameworks needs aren't handled by assemble, build or install.
+ */
+declare export const customTask: (
+  cwd: string,
+  customTaskName: string,
+  ...args: $ReadOnlyArray<string>
+) => GradleReturn;
+
+//
+// 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[],
+};
+
+declare export const tasks: AndroidTasks;

package/dist/private/apple.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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";
+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 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: AppleBuildTasks;

package/dist/private/apple.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.tasks = void 0;
+var _utils = require("./utils");
+var _execa = _interopRequireDefault(require("execa"));
+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
+ */
+
+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,
+        });
+      }
+      return await (0, _execa.default)("bundle", ["exec", "pod", "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")
+      );
+      const _args = [
+        options.isWorkspace ? "-workspace" : "-project",
+        options.name,
+        "-scheme",
+        options.scheme,
+      ];
+      if (options.destination != null) {
+        _args.push("-destination", options.destination);
+      }
+      _args.push(...args);
+      return (0, _execa.default)("xcodebuild", _args, {
+        cwd: options.cwd,
+        env: options.env,
+      });
+    }),
+  ],
+  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)(
+          "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,51 @@
+/**
+ * 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";
+
+type AppleBuildMode = "Debug" | "Release";
+
+type AppleBuildOptions = {
+  isWorkspace: boolean,
+  name: string,
+  mode: AppleBuildMode,
+  scheme: string,
+  destination?: string, // Device or Simulator or UUID
+} & AppleOptions;
+
+type AppleBootstrapOption = {
+  bundleInstall: boolean,
+  // Enabled by default
+  newArchitecture: boolean,
+} & AppleOptions;
+
+type AppleInstallApp = {
+  device: string,
+  appPath: string,
+} & AppleOptions;
+
+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[],
+  },
+};
+
+declare export const tasks: AppleBuildTasks;

package/dist/private/clean.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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";
+type CleanTasks = {
+  android: (androidSrcDir: null | undefined | string) => Task[];
+  metro: () => Task[];
+  npm: (projectRootDir: string, verifyCache?: boolean) => Task[];
+  bun: (projectRootDir: string) => Task[];
+  watchman: (projectRootDir: string) => Task[];
+  yarn: (projectRootDir: string) => Task[];
+  cocoapods?: (projectRootDir: string) => Task[];
+};
+/**
+ * Removes the contents of a directory matching a given pattern, but keeps the directory.
+ * @private
+ */
+export declare function deleteDirectoryContents(
+  directory: string,
+  filePattern: RegExp
+): Task["action"];
+/**
+ * Removes a directory recursively.
+ * @private
+ */
+export declare function deleteDirectory(directory: string): Task["action"];
+/**
+ * Deletes the contents of the tmp directory matching a given pattern.
+ * @private
+ */
+export declare function deleteTmpDirectoryContents(
+  filepattern: RegExp
+): ReturnType<typeof deleteDirectoryContents>;
+export declare const tasks: CleanTasks;

package/dist/private/clean.js

@@ -0,0 +1,201 @@
+"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 };
+}
+/**
+ * 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 rmrf = (pathname) => {
+  if (!(0, _fs.existsSync)(pathname)) {
+    return;
+  }
+  (0, _fs.rm)(pathname, {
+    maxRetries: 3,
+    recursive: true,
+    force: true,
+  });
+};
+
+/**
+ * Removes the contents of a directory matching a given pattern, but keeps the directory.
+ * @private
+ */
+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));
+    }
+  };
+}
+
+/**
+ * Removes a directory recursively.
+ * @private
+ */
+function deleteDirectory(directory) {
+  return async function cleanDirectoryAction() {
+    rmrf(directory);
+  };
+}
+
+/**
+ * Deletes the contents of the tmp directory matching a given pattern.
+ * @private
+ */
+function deleteTmpDirectoryContents(filepattern) {
+  return deleteDirectoryContents(_os.default.tmpdir(), filepattern);
+}
+
+// The tasks that cleanup various build artefacts.
+const tasks = {
+  /**
+   * Cleans up the Android Gradle cache
+   */
+  android: (androidSrcDir) => [
+    (0, _utils.task)("🧹 Clean Gradle cache", async function gradle(opts) {
+      const gradlew = _path.default.join(
+        androidSrcDir ?? "android",
+        _utils.isWindows ? "gradlew.bat" : "gradlew"
+      );
+      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,
+      });
+    }),
+  ],
+  /**
+   * Agressively cleans up all Metro caches.
+   */
+  metro: () => [
+    (0, _utils.task)(
+      "🧹 Clean Metro cache",
+      deleteTmpDirectoryContents(/^metro-.+/)
+    ),
+    (0, _utils.task)(
+      "🧹 Clean Haste cache",
+      deleteTmpDirectoryContents(/^haste-map-.+/)
+    ),
+    (0, _utils.task)(
+      "🧹 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;
+  },
+  /**
+   * Cleans up the Bun cache.
+   */
+  bun: (projectRootDir) => [
+    (0, _utils.task)("🧹 Clean Bun cache", (opts) =>
+      (0, _execa.default)("bun", ["pm", "cache", "rm"], {
+        cwd: projectRootDir,
+        ...opts,
+      })
+    ),
+  ],
+  /**
+   * Stops Watchman and clears its cache
+   */
+  watchman: (projectRootDir) => [
+    (0, _utils.task)("✋ Stop Watchman", (opts) =>
+      (0, _execa.default)(
+        _utils.isWindows ? "tskill" : "killall",
+        ["watchman"],
+        {
+          cwd: projectRootDir,
+          ...opts,
+        }
+      )
+    ),
+    (0, _utils.task)("🧹 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) =>
+      (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) => [
+    // 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,
+        });
+      }
+    ),
+  ];
+}
+
+//
+// Internal CLI
+//

package/dist/private/clean.js.flow

@@ -0,0 +1,47 @@
+/**
+ * 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";
+type CleanTasks = {
+  android: (androidSrcDir: ?string) => Task[],
+  metro: () => Task[],
+  npm: (projectRootDir: string, verifyCache?: boolean) => Task[],
+  bun: (projectRootDir: string) => Task[],
+  watchman: (projectRootDir: string) => Task[],
+  yarn: (projectRootDir: string) => Task[],
+  cocoapods?: (projectRootDir: string) => Task[],
+};
+
+/**
+ * Removes the contents of a directory matching a given pattern, but keeps the directory.
+ * @private
+ */
+declare export function deleteDirectoryContents(
+  directory: string,
+  filePattern: RegExp
+): Task["action"];
+
+/**
+ * Removes a directory recursively.
+ * @private
+ */
+declare export function deleteDirectory(directory: string): Task["action"];
+
+/**
+ * Deletes the contents of the tmp directory matching a given pattern.
+ * @private
+ */
+declare export function deleteTmpDirectoryContents(
+  filepattern: RegExp
+): ReturnType<typeof deleteDirectoryContents>;
+
+// The tasks that cleanup various build artefacts.
+declare export const tasks: CleanTasks;

package/dist/private/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 = { label: string; action: () => Promise<unknown> };

package/dist/private/types.js

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

package/dist/private/types.js.flow

@@ -0,0 +1,15 @@
+/**
+ * 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 Task = {
+  label: string,
+  action: () => Promise<mixed>,
+};

package/dist/private/utils.d.ts

@@ -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.
+ *
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type { Task } from "./types";
+export declare function task(label: string, action: Task["action"]): Task;
+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,55 @@
+"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 };
+}
+/**
+ * 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 task(label, action) {
+  return {
+    label,
+    action,
+  };
+}
+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 result = _execa.default.sync(isWindows ? "where" : "which", [dep]);
+  return {
+    dep,
+    description,
+    found: result.exitCode === 0,
+  };
+}
+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,34 @@
+/**
+ * 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(label: string, action: Task["action"]): Task;
+
+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/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@react-native/core-cli-utils",
+  "version": "0.75.0-main",
+  "description": "React Native CLI library for Frameworks to build on",
+  "main": "index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/facebook/react-native.git",
+    "directory": "packages/core-cli-utils"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "homepage": "https://github.com/facebook/react-native/tree/HEAD/packages/core-cli-utils#readme",
+  "keywords": [
+    "cli-utils",
+    "react-native"
+  ],
+  "bugs": "https://github.com/facebook/react-native/issues",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {}
+}