expo-desktop 0.1.3 → 0.1.5

package/{src/add-app/command.ts → build/add-app/command.js}

@@ -1,6 +1,5 @@
 import { exit } from "node:process";
-
 export function addExpoDesktopToExistingExpoApp() {
-  console.log("Not yet implemented.");
-  return exit(1);
+    console.log("Not yet implemented.");
+    return exit(1);
 }

package/build/cli.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { default as kleur } from "kleur";
+import { dim, grey } from "kleur/colors";
+import packageJson from "../package.json" with { type: "json" };
+const main = defineCommand({
+    meta: {
+        name: "expo-desktop",
+        version: packageJson.version,
+        description: "Best-effort desktop support for Expo",
+    },
+    subCommands: {
+        "create-app": defineCommand({
+            meta: { name: "create-app", description: "Create a new Expo Desktop project" },
+            args: {
+                "filesafe-name": {
+                    type: "string",
+                    description: `The ${kleur.bold("filesafe name")} for the app in alphanumeric format ${grey("(Example: 'MyApp123')")}`,
+                    valueHint: "name",
+                },
+                "display-name": {
+                    type: "string",
+                    description: `The ${kleur.bold("display name")} for the app ${grey("(Examples: 'My App 123', '俺のアプリ')")}`,
+                    valueHint: "name",
+                },
+                rdns: {
+                    type: "string",
+                    description: `The ${kleur.bold("reverse DNS")} for the app ${grey("(Example: 'com.example.my-app-123')")}`,
+                    valueHint: "name",
+                },
+                version: {
+                    type: "string",
+                    description: `The ${kleur.bold("minor version")} of React Native to align on ${grey("(Examples: '0.80', 'latest')")}`,
+                    valueHint: "version",
+                },
+            },
+            async run({ args }) {
+                (await import("./create-app/command.js")).newExpoDesktopProject(args);
+            },
+        }),
+        prebuild: defineCommand({
+            meta: { name: "prebuild", description: "Prebuild an Expo Desktop project" },
+            args: {
+                clean: {
+                    type: "boolean",
+                    description: "Delete the native folders and regenerate them before applying changes",
+                },
+                "no-install": {
+                    type: "boolean",
+                    description: "Skip installing npm packages and CocoaPods",
+                },
+                npm: {
+                    type: "boolean",
+                    description: `Use npm to install dependencies. ${dim("(Default when package-lock.json exists)")}`,
+                },
+                yarn: {
+                    type: "boolean",
+                    description: `Use yarn to install dependencies. ${dim("(Default when yarn.lock exists)")}`,
+                },
+                bun: {
+                    type: "boolean",
+                    description: `Use bun to install dependencies. ${dim("(Default when bun.lock exists)")}`,
+                },
+                pnpm: {
+                    type: "boolean",
+                    description: `Use pnpm to install dependencies. ${dim("(Default when pnpm-lock.yaml exists)")}`,
+                },
+                template: {
+                    type: "string",
+                    description: "Project template to clone from. File path pointing to a local tar file, npm package or a github repo",
+                    valueHint: "template",
+                },
+                platform: {
+                    type: "string",
+                    description: `Platforms to sync: macos, windows, desktop ${dim("(Default: desktop)")}`,
+                    valueHint: "desktop|macos|windows",
+                    alias: "p",
+                },
+            },
+            async run({ args }) {
+                (await import("./prebuild/command.js")).prebuild(args);
+            },
+        }),
+    },
+});
+await runMain(main);

package/build/common/app-config.js

@@ -0,0 +1,44 @@
+import { type } from "arktype";
+export const SemverMajorMinorOnly = type("/^(\\d+)\\.(\\d+)$/");
+export const Dns = type("/^[a-zA-Z][a-zA-Z0-9]*(?:\\.[a-zA-Z][a-zA-Z0-9]*)*$/");
+export const UnderscoredDns = type("/^[a-zA-Z]\\w*(?:\\.[a-zA-Z]\\w*)*$/");
+export const HyphenatedDns = type("/^[a-zA-Z][a-zA-Z0-9\\-]*(?:\\.[a-zA-Z][a-zA-Z0-9\\-]*)*$/");
+export const UnderscoredOrHyphenatedDns = type("/^[a-zA-Z][\\w\\-]*(?:\\.[a-zA-Z][\\w\\-]*)*$/");
+function defineAppConfig({ includeDescriptions }) {
+    const description = (text) => (includeDescriptions ? { description: text } : {});
+    return type({
+        ["react_native_version?"]: SemverMajorMinorOnly.configure(description("The `{major}.{minor}` version of `react-native` to align to, e.g. '0.82'. Defaults to the highest mutually supported across both `react-native-macos` and `react-native-windows`.")),
+        name: type({
+            alphanumeric: type("string.alphanumeric").configure(description("A **filesafe name** for the app consisting only of alphanumeric characters (A-z, and 0-9), e.g. 'MyApp123'. Will be used mainly for file names, e.g. 'MyApp123.xcodeproj'.")),
+            display_name: type("string").configure(description("The **display name** of your app, e.g. 'My App 123' or '俺のアプリ'. Accepts any string. Will be used as the app name on the iOS/Android home screen, in macOS Finder, and in Windows Explorer.")),
+            reverse_dns: UnderscoredOrHyphenatedDns.configure(description("The **reverse-Domain Name Specifier** for your app, e.g. 'com.example.my-app-123'. Accepts alphanumeric characters (A-z and 0-9), hyphens, and underscores. Will be used to fill in `android.package_namespace`, `android.application_id`, `windows.namespace`, `ios.bundle_identifier`, and `macos.bundle_identifier`. Hyphens and underscores will be sanitised as appropriate for these destinations, so don't worry which you use here.")),
+        }).configure(description("Different formats of the app name for use in different contexts.")),
+        ["android?"]: type({
+            ["application_id?"]: UnderscoredDns.configure(description("The **application ID** used on the Play Store, e.g. 'com.example.my_app_123'. Accepts only alphanumeric characters (A-z and 0-9), and underscores. Corresponds to `android.defaultConfig.applicationId` in `app/build.gradle`. Recommended to match `android.package_namespace`.")),
+            ["package_namespace?"]: UnderscoredDns.configure(description("The **package namespace**, e.g. 'com.example.my_app_123'. Accepts only alphanumeric characters (A-z and 0-9), and underscores. Corresponds to `android.namespace` in `app/build.gradle`. Recommended to match `android.application_id`.")),
+            ["root_project_name?"]: type("string").configure(description("The **display name** of your app, e.g. 'My App 123' or '俺のアプリ'. Accepts any string. Corresponds to `rootProject.name` in `settings.gradle`. Will be used as the app name on the Android home screen.")),
+        }).configure(description("Android-specific overrides for the default values (which are based on `name`).")),
+        ["ios?"]: type({
+            ["bundle_display_name?"]: type("string").configure(description("The **display name** of your app, e.g. 'My App 123' or '俺のアプリ'. Accepts any string. Corresponds to the `CFBundleDisplayName` key in the `Info.plist` file. Will be used as the app name on the iOS home screen.")),
+            ["bundle_identifier?"]: HyphenatedDns.configure(description("The **bundle identifier** of your app, e.g. 'com.example.my-app-123'. Accepts only alphanumeric characters (A-z and 0-9), and hyphens. Corresponds to the `PRODUCT_BUNDLE_IDENTIFIER` Xcode build variable, used to fill in the `CFBundleIdentifier` key in the `Info.plist` file.")),
+        }).configure(description("iOS-specific overrides for the default values (which are based on `name`).")),
+        ["macos?"]: type({
+            ["bundle_display_name?"]: type("string").configure(description("The **display name** of your app, e.g. 'My App 123' or '俺のアプリ'. Accepts any string. Corresponds to the `PRODUCT_BUNDLE_IDENTIFIER` Xcode build variable, used to fill in the `CFBundleDisplayName` key in the `Info.plist` file. Will be used as the app name in macOS Finder.")),
+            ["bundle_identifier?"]: HyphenatedDns.configure(description("The **bundle identifier** of your app, e.g. 'com.example.my-app-123'. Accepts only alphanumeric characters (A-z and 0-9), and hyphens. Corresponds to the `PRODUCT_BUNDLE_IDENTIFIER` Xcode build variable, used to fill in the `CFBundleIdentifier` key in the `Info.plist` file.")),
+        }).configure(description("macOS-specific overrides for the default values (which are based on `name`).")),
+        ["windows?"]: type({
+            ["display_name?"]: type("string").configure(description("The **display name** of your app, e.g. 'My App 123' or '俺のアプリ'. Accepts any string. Corresponds to the `ProjectName` value in the `.vcxproj` file. Will be used as the app name in Windows Explorer.")),
+            ["namespace?"]: Dns.configure(description("The WinRT and C++ **namespace**, e.g. 'com.example.myapp123'. Accepts only alphanumeric characters (A-z and 0-9). When used in C++, `.` characters are converted to `::`, e.g. 'com::example::myapp123'.")),
+            ["project_name?"]: type("string.alphanumeric").configure(description("A **filesafe name** for the app consisting only of alphanumeric characters (A-z, and 0-9), e.g. 'MyApp123'. Will be used mainly for file names, e.g. 'MyApp123.vcxproj'.")),
+        }).configure(description("Windows-specific overrides for the default values (which are based on `name`).")),
+    });
+}
+export const PartialAppConfig = defineAppConfig({ includeDescriptions: false });
+export const PartialAppConfigForJsonSchema = defineAppConfig({ includeDescriptions: true });
+const RequiredTopLevelAppConfig = type.keywords.Required(PartialAppConfig);
+export const AppConfig = type.merge(RequiredTopLevelAppConfig, {
+    android: RequiredTopLevelAppConfig.get("android").required(),
+    ios: RequiredTopLevelAppConfig.get("ios").required(),
+    macos: RequiredTopLevelAppConfig.get("macos").required(),
+    windows: RequiredTopLevelAppConfig.get("windows").required(),
+});

package/build/common/app-json.js

@@ -0,0 +1,32 @@
+import { type } from "arktype";
+export const ExpoConfig = type({
+    "name?": "string",
+    "slug?": "string",
+    "platforms?": type('"android" | "ios" | "web" | "macos" | "windows"').array(),
+    "version?": "string",
+    "ios?": type({
+        "bundleIdentifier?": "string",
+    }),
+    "macos?": type({
+        "bundleIdentifier?": "string",
+    }),
+    // "windows?": type({
+    //   "projectName?": "string",
+    //   "displayName?": "string",
+    //   "namespace?": "string",
+    // }),
+    "android?": type({
+        "package?": "string",
+    }),
+    "plugins?": type(type(["string", "...", "unknown[]"]).or("string")).array(),
+});
+export const AppJson = type({
+    "expo?": ExpoConfig,
+});
+export const PackageJson = type({
+    "name?": "string",
+    "scripts?": "Record<string, string>",
+    "dependencies?": "Record<string, string>",
+    "devDependencies?": "Record<string, string>",
+    "peerDependencies?": "Record<string, string>",
+});

package/build/common/apply-config-plugins.js

@@ -0,0 +1,48 @@
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import { withInternal } from "./with-internal.js";
+const require = createRequire(import.meta.url);
+const { getPrebuildConfigAsync } = require("expo-desktop-prebuild-config");
+const { compileModsAsync } = require("expo-desktop-config-plugins");
+/**
+ * Applies config plugins.
+ * @see https://github.com/microsoft/react-native-test-app/blob/trunk/packages/app/scripts/config-plugins/apply.mjs
+ */
+export async function applyConfigPlugins(options) {
+    const { projectRoot } = options;
+    // To avoid making expo-desktop depend on Expo SDK 54 when we might be running
+    // on an Expo 55 project, we import Expo deps from the project itself.
+    let expoConfigModule;
+    try {
+        expoConfigModule = require(path.dirname(require.resolve("@expo/config/package.json", { paths: [projectRoot] })));
+    }
+    catch (cause) {
+        throw new Error(`Error importing "@expo/config" relative to projectRoot "${projectRoot}". Make sure to install node modules before running any prebuilds, and make sure that the project depends on the package named "expo".`, { cause });
+    }
+    const { getConfig } = expoConfigModule;
+    let expoConfigPluginsModule;
+    try {
+        expoConfigPluginsModule = require(path.dirname(require.resolve("@expo/config-plugins/package.json", { paths: [projectRoot] })));
+    }
+    catch (cause) {
+        throw new Error(`Error importing "@expo/config-plugins" relative to projectRoot "${projectRoot}". Make sure to install node modules before running any prebuilds, and make sure that the project depends on the package named "expo".`, { cause });
+    }
+    const { withPlugins } = expoConfigPluginsModule;
+    // (1) Filter out platforms that aren't in the app.json.
+    // https://github.com/expo/expo/blob/8dd645080f52927e2a8bf406167da7241a1d46d8/packages/%40expo/cli/src/prebuild/prebuildAsync.ts#L74
+    let { exp: expoConfig } = getConfig(projectRoot);
+    const { platforms, plugins } = expoConfig;
+    if (platforms?.length) {
+        const finalPlatforms = options.platforms.filter((platform) => platforms.includes(platform));
+        if (finalPlatforms.length > 0) {
+            options.platforms = finalPlatforms;
+        }
+        else {
+            const requestedPlatforms = options.platforms.join(", ");
+            console.warn(`⚠️  Requested prebuild for "${requestedPlatforms}", but only "${platforms.join(", ")}" is present in app config ("expo.platforms" entry). Continuing with "${requestedPlatforms}".`);
+        }
+    }
+    const prebuildConfig = await getPrebuildConfigAsync(projectRoot, options);
+    expoConfig = prebuildConfig.exp;
+    return compileModsAsync(withPlugins(withInternal(expoConfig, options), plugins), options);
+}

package/build/common/arktype.js

@@ -0,0 +1,12 @@
+import { green, grey, yellow } from "kleur/colors";
+export function makePrettySummary({ byPath }) {
+    const summary = new Array();
+    for (const [path, error] of Object.entries(byPath)) {
+        const actualIndex = error.problem.lastIndexOf(" (was ");
+        const problem = actualIndex === -1
+            ? error.problem
+            : `${error.problem.startsWith("must be matched by ") ? `must be matched by ${green(error.problem.slice("must be matched by ".length, actualIndex))}` : error.problem.slice(0, actualIndex)}${grey(error.problem.slice(actualIndex))}`;
+        summary.push(`${yellow(path)} ${problem}`);
+    }
+    return summary;
+}

package/build/common/child-process.js

@@ -0,0 +1,141 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { env } from "node:process";
+import readline from "node:readline";
+/**
+ * Clack {@link Task} that runs a subprocess; piped stdout/stderr lines are sent
+ * through the task `message` callback (not `log.message`). Lines are also kept in
+ * an interleaved buffer; on failure they are written under {@link debugLogDir} or
+ * {@link SpawnOptions.cwd} or the current working directory.
+ */
+export function promisifiedSpawnTask({ title, command, args, options = {}, debugLogDir, }) {
+    return {
+        title,
+        task: (message) => runPromisifiedSpawn({
+            command,
+            args,
+            options,
+            logLine: message,
+            ...(debugLogDir !== undefined ? { debugLogDir } : {}),
+        }),
+    };
+}
+function runPromisifiedSpawn({ command, args, options, logLine, debugLogDir, }) {
+    const stdioEffective = effectiveStdioForSpawnCapture(options.stdio) ?? options.stdio;
+    const spawnOptions = {
+        ...options,
+        stdio: stdioEffective,
+        env: envWithForcedColorIfPiped({ ...options, stdio: stdioEffective }),
+    };
+    const cp = spawn(command, args, spawnOptions);
+    /** Interleaved stdout/stderr lines in arrival order (tagged for readability). */
+    const lineBuffer = [];
+    const pushLine = (stream, line) => {
+        lineBuffer.push(`${stream}\t${line}`);
+        logLine(line);
+    };
+    const { stdout, stderr } = cp;
+    const outMode = Array.isArray(spawnOptions.stdio) ? spawnOptions.stdio.at(1) : spawnOptions.stdio;
+    const errMode = Array.isArray(spawnOptions.stdio) ? spawnOptions.stdio.at(2) : spawnOptions.stdio;
+    if (stdout && outMode !== "inherit" && outMode !== "ignore") {
+        readline.createInterface({ input: stdout }).on("line", (line) => pushLine("stdout", line));
+    }
+    if (stderr && errMode !== "inherit" && errMode !== "ignore") {
+        readline.createInterface({ input: stderr }).on("line", (line) => pushLine("stderr", line));
+    }
+    let cpError = null;
+    cp.on("error", (error) => {
+        if (!cpError) {
+            cpError = error;
+        }
+    });
+    const { promise, resolve, reject } = Promise.withResolvers();
+    cp.on("close", (code, signal) => {
+        void (async () => {
+            if (!cpError && code === 0) {
+                resolve();
+                return;
+            }
+            const logDir = resolveDebugLogDir(spawnOptions, debugLogDir);
+            const fileName = `expo-desktop-spawn-debug-${Date.now()}.log`;
+            const absPath = path.join(logDir, fileName);
+            const header = [
+                "# Captured by expo-desktop when a subprocess failed",
+                `command: ${shellQuote(command)} ${args.map(shellQuote).join(" ")}`,
+                `cwd (spawn): ${spawnOptions.cwd !== undefined ? String(spawnOptions.cwd) : "(default)"}`,
+                `debug log directory: ${logDir}`,
+                `exit code: ${code === null ? "null" : code}`,
+                `signal: ${signal === null ? "null" : signal}`,
+                "---",
+                "",
+            ].join("\n");
+            let wrotePath;
+            try {
+                await fs.mkdir(logDir, { recursive: true });
+                const body = lineBuffer.length > 0
+                    ? lineBuffer.join("\n")
+                    : "(no stdout/stderr lines were captured; streams may have been inherited or ignored.)";
+                await fs.writeFile(absPath, `${header}${body}\n`, "utf-8");
+                wrotePath = absPath;
+            }
+            catch (writeErr) {
+                reject(new Error(`Exited with code ${code} (signal: ${signal}). Failed to write debug log to ${absPath}: ${writeErr instanceof Error ? writeErr.message : String(writeErr)}${cpError ? ` (${cpError.message})` : ""}`, cpError ? { cause: cpError } : writeErr instanceof Error ? { cause: writeErr } : {}));
+                return;
+            }
+            reject(new Error(`Exited with code ${code} (signal: ${signal}). Captured subprocess output was saved for debugging:\n  ${wrotePath}` +
+                (cpError ? `\nUnderlying error: ${cpError.message}` : ""), cpError ? { cause: cpError } : {}));
+        })();
+    });
+    return promise;
+}
+function shellQuote(arg) {
+    if (/^[\w@%+=:,./-]+$/i.test(arg)) {
+        return arg;
+    }
+    return `'${arg.replaceAll("'", `'\\''`)}'`;
+}
+function resolveDebugLogDir(options, debugLogDir) {
+    if (debugLogDir !== undefined) {
+        return path.resolve(process.cwd(), debugLogDir);
+    }
+    if (options.cwd !== undefined) {
+        return path.resolve(process.cwd(), String(options.cwd));
+    }
+    return process.cwd();
+}
+/**
+ * When stdout and stderr are both inherited from the parent, switch them to pipes
+ * so we can buffer lines while still forwarding each line through {@link logLine}.
+ */
+function effectiveStdioForSpawnCapture(stdio) {
+    if (stdio === "inherit") {
+        return ["inherit", "pipe", "pipe"];
+    }
+    if (Array.isArray(stdio) && stdio[1] === "inherit" && stdio[2] === "inherit") {
+        const head = stdio.slice(0, 1);
+        const tail = stdio.slice(3);
+        return [...head, "pipe", "pipe", ...tail];
+    }
+    return stdio;
+}
+/**
+ * When stdio is piped, the child sees non-TTY streams and most color libraries
+ * disable ANSI.
+ */
+function envWithForcedColorIfPiped(options) {
+    const stdio = options?.stdio;
+    const stdoutMode = Array.isArray(stdio) ? stdio.at(1) : stdio;
+    const stderrMode = Array.isArray(stdio) ? stdio.at(2) : stdio;
+    const capturesOutput = stdoutMode !== "inherit" || stderrMode !== "inherit";
+    const base = { ...env, ...options?.env };
+    if (!capturesOutput || base.NO_COLOR !== undefined) {
+        return base;
+    }
+    if (base.FORCE_COLOR !== undefined && base.FORCE_COLOR !== "") {
+        return base;
+    }
+    return { ...base, FORCE_COLOR: "1" };
+}
+/** Gitignore glob for spawn debug logs. */
+export const SPAWN_DEBUG_LOG_GLOB = "expo-desktop-spawn-debug*.log";

package/build/common/clack.js

@@ -0,0 +1,9 @@
+import { log } from "@clack/prompts";
+import kleur from "kleur";
+export function title(text, opts) {
+    const { spacing, ...rest } = opts ?? {};
+    log.info(kleur.bold(kleur.inverse(`  ${text}  `)), { withGuide: false, ...rest });
+    if (opts?.spacing) {
+        log.message("", { withGuide: false, spacing: Math.max(0, opts.spacing - 1) });
+    }
+}

package/build/common/define-config.js

@@ -0,0 +1,42 @@
+import { type } from "arktype";
+import { AppConfig, PartialAppConfig } from "./app-config.js";
+import { makePrettySummary } from "./arktype.js";
+export function defineAppConfig(config) {
+    const partial = PartialAppConfig(config);
+    if (partial instanceof type.errors) {
+        // console.log(`Invalid config:\n${makePrettySummary(partial).join("\n")}`);
+        throw new Error(`Invalid config:\n${makePrettySummary(partial).join("\n")}`);
+    }
+    const { name: { alphanumeric, display_name, reverse_dns }, } = partial;
+    const full = AppConfig({
+        ...partial,
+        // TODO: Dynamically grab latest minor version
+        react_native_version: "0.82",
+        android: {
+            application_id: reverse_dns.replaceAll("-", "_"),
+            package_namespace: reverse_dns.replaceAll("-", "_"),
+            root_project_name: display_name,
+            ...partial.android,
+        },
+        ios: {
+            bundle_display_name: display_name,
+            bundle_identifier: reverse_dns.replaceAll("_", "-"),
+            ...partial.ios,
+        },
+        macos: {
+            bundle_display_name: display_name,
+            bundle_identifier: reverse_dns.replaceAll("_", "-"),
+            ...partial.macos,
+        },
+        windows: {
+            display_name: display_name,
+            namespace: reverse_dns.replaceAll(/[\-_]/g, ""),
+            project_name: alphanumeric,
+            ...partial.windows,
+        },
+    });
+    if (full instanceof type.errors) {
+        throw new Error(`Invalid config:\n${makePrettySummary(full).join("\n")}`);
+    }
+    return full;
+}

package/build/common/npm.js

@@ -0,0 +1,143 @@
+import { type } from "arktype";
+import { makePrettySummary } from "./arktype.js";
+export async function getPackageInfo(packageName) {
+    const res = await fetch(`https://registry.npmjs.org/${packageName}`);
+    const data = await res.json();
+    const response = NpmResponse(data);
+    if (response instanceof type.errors) {
+        // console.log(`Invalid config:\n${makePrettySummary(partial).join("\n")}`);
+        throw new Error(`Invalid config:\n${makePrettySummary(response).join("\n")}`);
+    }
+    return response;
+}
+export function filterVersions({ npmInfo, distTag, fromMajor, fromMinor, fromPatch, includePrereleases, }) {
+    const map = {};
+    const { "dist-tags": distTags, versions } = npmInfo;
+    if (distTag) {
+        const version = distTags[distTag];
+        const match = semverMatcher.exec(version);
+        if (match) {
+            const [fullMatch, major, minor, patch, prerelease, _buildmetadata] = match;
+            const majorInt = parseInt(major);
+            const minorInt = parseInt(minor);
+            const patchInt = parseInt(patch);
+            if (!map[majorInt][minorInt][patchInt]) {
+                map[majorInt][minorInt][patchInt] = {
+                    prereleases: [],
+                };
+            }
+            if (!!prerelease) {
+                map[majorInt][minorInt][patchInt].prereleases.push(fullMatch);
+            }
+            else {
+                map[majorInt][minorInt][patchInt].release = fullMatch;
+            }
+        }
+        return { filtered: [version], map };
+    }
+    const filtered = new Array();
+    for (const version of versions) {
+        const match = semverMatcher.exec(version);
+        if (!match) {
+            continue;
+        }
+        const [fullMatch, major, minor, patch, prerelease, _buildmetadata] = match;
+        const majorInt = parseInt(major);
+        const minorInt = parseInt(minor);
+        const patchInt = parseInt(patch);
+        if (typeof fromMajor === "number" && majorInt < fromMajor) {
+            continue;
+        }
+        if (typeof fromMinor === "number" && minorInt < fromMinor) {
+            continue;
+        }
+        if (typeof fromPatch === "number" && patchInt < fromPatch) {
+            continue;
+        }
+        if (!includePrereleases && !!prerelease) {
+            continue;
+        }
+        filtered.push(fullMatch);
+        if (!map[majorInt]) {
+            map[majorInt] = {};
+        }
+        if (!map[majorInt][minorInt]) {
+            map[majorInt][minorInt] = {};
+        }
+        if (!map[majorInt][minorInt][patchInt]) {
+            map[majorInt][minorInt][patchInt] = {
+                prereleases: [],
+            };
+        }
+        if (!!prerelease) {
+            map[majorInt][minorInt][patchInt].prereleases.push(fullMatch);
+        }
+        else {
+            map[majorInt][minorInt][patchInt].release = fullMatch;
+        }
+    }
+    return { filtered, map };
+}
+export function getHighestStableMinors(map) {
+    const minorMap = {};
+    for (const major in map) {
+        const majorInt = parseInt(major);
+        if (!minorMap[majorInt]) {
+            minorMap[majorInt] = {};
+        }
+        for (const minor in map[major]) {
+            const minorInt = parseInt(minor);
+            for (const patch in map[major][minor]) {
+                const patchInt = parseInt(patch);
+                if (!map[major][minor][patch].release) {
+                    continue;
+                }
+                const current = minorMap[majorInt][minorInt];
+                if (!current) {
+                    minorMap[majorInt][minorInt] = map[major][minor][patch].release;
+                    continue;
+                }
+                const currentMatch = semverMatcher.exec(current);
+                if (!currentMatch) {
+                    continue;
+                }
+                const [, , , currentPatch] = currentMatch;
+                if (patchInt <= parseInt(currentPatch)) {
+                    continue;
+                }
+                minorMap[majorInt][minorInt] = `${major}.${minor}.${patch}`;
+            }
+        }
+    }
+    return minorMap;
+}
+const NpmResponse = type({
+    name: "string",
+    "dist-tags": "Record<string, string.semver>",
+    versions: type("Record<string, Record<string, unknown>>").pipe((record) => Object.keys(record)),
+    // Other potentially useful fields that we'll avoid needlessly validating for
+    // now:
+    // time: "Record<string, string.date.iso>",
+});
+/**
+ * Exposing the underlying pattern used by string.semver.
+ * @see https://semver.org/
+ */
+export const semverMatcher = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][\dA-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][\dA-Za-z-]*))*))?(?:\+([\dA-Za-z-]+(?:\.[\dA-Za-z-]+)*))?$/;
+export function packageManagerExec(packageManager) {
+    const args = new Array();
+    let command;
+    switch (packageManager) {
+        case "bun":
+            command = "bunx";
+            break;
+        case "npm":
+            command = "npm";
+            args.push("dlx");
+            break;
+        case "pnpm":
+            command = "pnpm";
+            args.push("dlx");
+    }
+    return { args, command };
+}

package/build/common/with-internal.js

@@ -0,0 +1,13 @@
+/**
+ * @see https://github.com/microsoft/react-native-test-app/blob/0951cf5a3727c01d2ef25540eb796eb56b14ae04/packages/app/scripts/config-plugins/plugins/withInternal.mjs#L9
+ */
+export const withInternal = (config, internals) => {
+    // @ts-ignore TODO
+    config._internal = {
+        isDebug: false,
+        // @ts-ignore TODO
+        ...config._internal,
+        ...internals,
+    };
+    return config;
+};