basalt-core 0.0.0-rc5

package/dist/cli/init.js

@@ -0,0 +1,442 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `npx basalt-core init`, which adds a desktop to an app that exists.
+ *
+ * It does not create an app. `create-expo-app` does that, and the division is
+ * the same one `run-linux` already assumes: this platform is something you add
+ * to a React Native app, not a way to start one.
+ *
+ * ## Why a bin rather than a CLI command
+ *
+ * The run commands are React Native CLI commands, registered from the host
+ * packages, because the CLI has to be able to find them. This one cannot be:
+ * before it runs, the package is not a dependency yet, so there is no config
+ * for the CLI to read. `npx basalt-core init` works from nothing, which
+ * is the point -- one command, in an app that has never heard of this platform.
+ *
+ * ## Idempotent, and refusing beats half-configuring
+ *
+ * Every step reports one of three things: it was already right, it was changed,
+ * or it could not be done and why. Running twice is safe and says so. An app
+ * this cannot recognise is refused before anything is written, because a
+ * half-configured app fails later and further from the cause than one that was
+ * turned away -- and the failure it produces names a Metro or Babel internal
+ * rather than the step that was skipped.
+ *
+ * @format
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOST_PACKAGES = exports.DEV_DEPENDENCIES = void 0;
+exports.desktopsFor = desktopsFor;
+exports.init = init;
+exports.main = main;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const steps_1 = require("./steps");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { DESKTOP_PLATFORMS } = require('../metro-config');
+// The dev dependencies an app needs to bundle for a desktop. Both are React
+// Native's own: the Metro config this platform wraps, and the CLI that carries
+// the run commands. An Expo app has neither, because `expo` is its CLI.
+exports.DEV_DEPENDENCIES = [
+    '@react-native/metro-config',
+    '@react-native-community/cli',
+];
+const PACKAGE_NAME = 'basalt-core';
+/**
+ * The host packages, one per desktop, and all three by default.
+ *
+ * Each carries its own `run-<desktop>` command -- React Native's CLI reads a
+ * `react-native.config.js` out of every dependency, and the commands live
+ * beside the host they need rather than in core, so an app with only the
+ * AppKit package never sees a command it could not have used. Which means an
+ * app that installed core alone has no desktop commands at all, and `init`'s
+ * own closing line tells the person to run one.
+ *
+ * All three rather than the one this machine runs, because `package.json` is
+ * committed: which desktops an app builds for is a property of the project and
+ * not of whoever set it up. Narrowing by the current platform would configure
+ * an app on a Mac that failed on a contributor's Linux box, reporting an
+ * unrecognised command -- which reads as a broken install rather than as a
+ * decision somebody made.
+ *
+ * The cost of the other two is source that is never compiled: the build only
+ * configures the host for the platform it is running on. An app that wants
+ * fewer says so in app.json; see DESKTOPS_KEY.
+ */
+exports.HOST_PACKAGES = {
+    linux: 'basalt-gtk',
+    macos: 'basalt-appkit',
+    windows: 'basalt-win32',
+};
+/**
+ * Where an app narrows that list: `"basalt": {"desktops": ["macos"]}`.
+ *
+ * app.json rather than package.json, and under the `basalt` key that is
+ * already this platform's escape hatch there -- `cli/packageApp.ts` reads
+ * `basalt.identifier` and `basalt.scheme` from the same place.
+ *
+ * Not Expo's own `platforms` field: a bare React Native app does not have one,
+ * and it is Expo's to define rather than this platform's to borrow.
+ */
+const DESKTOPS_KEY = 'desktops';
+/**
+ * Reads a JSON file, or returns null when it is absent or unparseable.
+ *
+ * Unparseable and absent are deliberately the same answer here: both mean "this
+ * is not something to edit", and the caller says so with the path.
+ */
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Is this a React Native app at all?
+ *
+ * `react-native` in any dependency field, or `expo` -- an Expo app has React
+ * Native transitively and may not name it. Anything else is refused.
+ */
+function describeProject(root) {
+    const manifest = path.join(root, 'package.json');
+    if (!fs.existsSync(manifest)) {
+        return { ok: false, reason: `no package.json in ${root}` };
+    }
+    const json = readJson(manifest);
+    if (json == null) {
+        return { ok: false, reason: `${manifest} is not readable JSON` };
+    }
+    const all = {
+        ...(json.dependencies || {}),
+        ...(json.devDependencies || {}),
+        ...(json.peerDependencies || {}),
+    };
+    if (all['react-native'] == null && all.expo == null) {
+        return {
+            ok: false,
+            reason: `${manifest} lists neither react-native nor expo. This adds a desktop ` +
+                'to an app that exists; create one with `npx create-expo-app` first.',
+        };
+    }
+    return { ok: true, manifest, json, expo: all.expo != null };
+}
+/**
+ * The Metro config to edit, or null with the reason.
+ *
+ * Only the two filenames Metro itself looks for. A project using
+ * `metro.config.ts` is a real case and not one this writes into blindly: the
+ * wrapper is a require() call, and a TypeScript config may be doing something
+ * this cannot preserve.
+ */
+function findMetroConfig(root) {
+    for (const name of ['metro.config.js', 'metro.config.cjs']) {
+        const file = path.join(root, name);
+        if (fs.existsSync(file)) {
+            return { file };
+        }
+    }
+    for (const name of ['metro.config.ts', 'metro.config.mjs']) {
+        if (fs.existsSync(path.join(root, name))) {
+            return {
+                file: null,
+                reason: `found ${name}, which this cannot edit safely. Add ` +
+                    `\`withDesktopPlatforms\` from \`${PACKAGE_NAME}/metro-config\` by hand.`,
+            };
+        }
+    }
+    // Absent rather than unreadable, which the caller writes one for.
+    return { file: null, reason: 'no metro.config.js', missing: true };
+}
+/**
+ * The desktops this app builds for: every one, unless app.json narrows it.
+ *
+ * An unknown name is refused rather than ignored. A typo -- "mac", "win" --
+ * would otherwise quietly install one package fewer and fail much later, at
+ * the command that is missing, which is the failure this whole step exists to
+ * prevent.
+ */
+function desktopsFor(root) {
+    const all = Object.keys(exports.HOST_PACKAGES);
+    const appJson = readJson(path.join(root, 'app.json'));
+    const named = appJson?.basalt?.[DESKTOPS_KEY];
+    if (named == null) {
+        return { desktops: all };
+    }
+    if (!Array.isArray(named) || named.some(entry => typeof entry !== 'string')) {
+        return {
+            desktops: all,
+            reason: `app.json's "basalt.${DESKTOPS_KEY}" is not a list of names; using all of them`,
+        };
+    }
+    const unknown = named.filter(entry => !(entry in exports.HOST_PACKAGES));
+    if (unknown.length > 0) {
+        return {
+            desktops: all,
+            reason: `app.json's "basalt.${DESKTOPS_KEY}" names ${unknown.join(', ')}, which ` +
+                `${unknown.length === 1 ? 'is not a desktop' : 'are not desktops'} this ` +
+                `platform has. Expected any of ${all.join(', ')}; using all of them`,
+        };
+    }
+    return { desktops: named };
+}
+/** Adds this package, the host packages, and the two dev dependencies. */
+function addDependencies(project, version, desktops, write) {
+    const json = project.json;
+    const changes = [];
+    json.dependencies = json.dependencies || {};
+    if (json.dependencies[PACKAGE_NAME] == null) {
+        json.dependencies[PACKAGE_NAME] = version;
+        changes.push(PACKAGE_NAME);
+    }
+    // The same version as core: they share a C++ ABI with the host, and
+    // docs/DECISIONS.md says they version together until that stops being true.
+    for (const desktop of desktops) {
+        const host = exports.HOST_PACKAGES[desktop];
+        if (host != null && json.dependencies[host] == null) {
+            json.dependencies[host] = version;
+            changes.push(host);
+        }
+    }
+    json.devDependencies = json.devDependencies || {};
+    for (const name of exports.DEV_DEPENDENCIES) {
+        // Not if it is already a dependency of any kind: an app that has it in
+        // `dependencies` made that choice, and moving it is not this command's
+        // business.
+        const present = json.devDependencies[name] != null || (json.dependencies || {})[name] != null;
+        if (!present) {
+            json.devDependencies[name] = '*';
+            changes.push(name);
+        }
+    }
+    if (changes.length === 0) {
+        return (0, steps_1.step)(steps_1.DONE, 'dependencies are already present');
+    }
+    // Phrased for what actually happened. `doctor` runs this same function with
+    // writing off, and a report that said "added" when nothing was added would
+    // be the one thing a read-only command must never do.
+    return write
+        ? (0, steps_1.step)(steps_1.CHANGED, `added ${changes.join(', ')} -- run your package manager to install`)
+        : (0, steps_1.step)(steps_1.CHANGED, `would add ${changes.join(', ')}`);
+}
+/** Adds a script per desktop, leaving any the app already defined alone. */
+function addScripts(project, write) {
+    const json = project.json;
+    json.scripts = json.scripts || {};
+    const added = [];
+    for (const platform of DESKTOP_PLATFORMS) {
+        const name = platform;
+        if (json.scripts[name] == null) {
+            json.scripts[name] = `react-native run-${platform}`;
+            added.push(name);
+        }
+    }
+    if (added.length === 0) {
+        return (0, steps_1.step)(steps_1.DONE, 'scripts are already present');
+    }
+    return (0, steps_1.step)(steps_1.CHANGED, write ? `added scripts: ${added.join(', ')}` : `would add scripts: ${added.join(', ')}`);
+}
+/**
+ * Writes a Metro config for an app that has none.
+ *
+ * A stock `create-expo-app --template blank` has no `metro.config.js` at all:
+ * Expo's default is implicit, and an app only grows the file when it has
+ * something to say. That is the common case rather than an edge one, and
+ * blocking on it left the command reporting by hand the single step it exists
+ * to do -- which is what `release.yml` had been working around with a heredoc
+ * of exactly these three lines.
+ *
+ * Which default to start from is the app's own: `expo/metro-config` reads
+ * app.json and the Expo plugins, and a bare React Native app has neither.
+ */
+function writeMetroConfig(root, expo) {
+    const file = path.join(root, 'metro.config.js');
+    const defaults = expo ? 'expo/metro-config' : '@react-native/metro-config';
+    const contents = `const {getDefaultConfig} = require('${defaults}');\n` +
+        `const {withDesktopPlatforms} = require('${PACKAGE_NAME}/metro-config');\n` +
+        '\n' +
+        'module.exports = withDesktopPlatforms(getDefaultConfig(__dirname));\n';
+    fs.writeFileSync(file, contents);
+    return (0, steps_1.step)(steps_1.CHANGED, `wrote metro.config.js, on ${defaults}`);
+}
+/** Whether the app's Metro config is already wrapped, changing nothing. */
+function inspectMetroConfig(file) {
+    const name = path.basename(file);
+    const before = fs.readFileSync(file, 'utf8');
+    if (before.includes('withDesktopPlatforms')) {
+        return (0, steps_1.step)(steps_1.DONE, `${name} already wraps the config`);
+    }
+    if (!/^module\.exports\s*=\s*([\s\S]+?);$/m.test(before)) {
+        return (0, steps_1.step)(steps_1.BLOCKED, `could not find a \`module.exports =\` in ${name}. Wrap its export in ` +
+            '`withDesktopPlatforms(...)` by hand.');
+    }
+    return (0, steps_1.step)(steps_1.CHANGED, `${name} would be wrapped in withDesktopPlatforms`);
+}
+/**
+ * Wraps the app's Metro config, preserving what is there.
+ *
+ * Textual rather than by parsing: a Metro config is a small file people edit,
+ * and rewriting it through an AST would reformat the whole thing to change one
+ * line. What that costs is certainty, so anything not recognised is refused
+ * rather than guessed at.
+ */
+function wrapMetroConfig(file) {
+    const before = fs.readFileSync(file, 'utf8');
+    if (before.includes('withDesktopPlatforms')) {
+        return (0, steps_1.step)(steps_1.DONE, `${path.basename(file)} already wraps the config`);
+    }
+    const requireLine = `const {withDesktopPlatforms} = require('${PACKAGE_NAME}/metro-config');\n`;
+    // `module.exports = <something>;` on one line, which is what both the Expo
+    // and the bare template produce.
+    // Non-greedy up to the semicolon, and deliberately not swallowing what
+    // follows it: `\s*$` would eat the file's trailing newline, and a command
+    // that reformats the end of a file it was asked to edit one line of is a
+    // command people stop trusting.
+    const assignment = /^module\.exports\s*=\s*([\s\S]+?);$/m;
+    const match = before.match(assignment);
+    if (match == null) {
+        return (0, steps_1.step)(steps_1.BLOCKED, `could not find a \`module.exports =\` in ${path.basename(file)}. Wrap ` +
+            'its export in `withDesktopPlatforms(...)` by hand.');
+    }
+    const wrapped = before.replace(assignment, `module.exports = withDesktopPlatforms(${match[1].trim()});`);
+    // After the last require at the top, so the file still reads top to bottom.
+    const requires = [...wrapped.matchAll(/^(?:const|let|var)\s.*require\(.*\);\s*$/gm)];
+    const after = requires.length > 0
+        ? wrapped.slice(0, requires[requires.length - 1].index + requires[requires.length - 1][0].length) +
+            '\n' +
+            requireLine +
+            wrapped.slice(requires[requires.length - 1].index + requires[requires.length - 1][0].length)
+        : requireLine + wrapped;
+    fs.writeFileSync(file, after);
+    return (0, steps_1.step)(steps_1.CHANGED, `wrapped ${path.basename(file)} in withDesktopPlatforms`);
+}
+/**
+ * This package's own version, for the dependency `init` adds.
+ *
+ * Found by walking up rather than by a fixed number of `..`: this file runs
+ * from `dist/cli/` once built and from `cli/` in a checkout, so any hardcoded
+ * depth is wrong in one of the two -- which is exactly the bug that shipped the
+ * first time, as a dependency pinned to `*`.
+ */
+function ownVersion() {
+    let dir = __dirname;
+    for (let up = 0; up < 5; up++) {
+        const candidate = path.join(dir, 'package.json');
+        const json = readJson(candidate);
+        if (json?.name === PACKAGE_NAME) {
+            return json.version != null ? `^${json.version}` : '*';
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return '*';
+}
+function init(root = process.cwd(), { write = true } = {}) {
+    const project = describeProject(root);
+    if (!project.ok) {
+        return { ok: false, reason: project.reason, steps: [] };
+    }
+    const metro = findMetroConfig(root);
+    const steps = [];
+    const { desktops, reason } = desktopsFor(root);
+    if (reason != null) {
+        // Reported rather than refused: the app is configurable, and what is wrong
+        // is one field. Refusing would leave it configured for nothing.
+        steps.push(['desktops', (0, steps_1.step)(steps_1.BLOCKED, reason)]);
+    }
+    steps.push(['dependencies', addDependencies(project, ownVersion(), desktops, write)]);
+    steps.push(['scripts', addScripts(project, write)]);
+    if (metro.file == null && metro.missing) {
+        // No config at all, which is what a stock Expo app looks like: write one
+        // rather than refuse. A config that exists and cannot be edited is a
+        // different case and still refused below.
+        steps.push([
+            'metro config',
+            write ? writeMetroConfig(root, project.expo) : (0, steps_1.step)(steps_1.CHANGED, 'would write metro.config.js'),
+        ]);
+    }
+    else if (metro.file == null) {
+        steps.push(['metro config', (0, steps_1.step)(steps_1.BLOCKED, metro.reason ?? 'no metro config')]);
+    }
+    else if (write) {
+        steps.push(['metro config', wrapMetroConfig(metro.file)]);
+    }
+    else {
+        // The read-only form, which this branch did not have: with writing off it
+        // pushed no step at all, so `doctor` would have said nothing about the one
+        // file most likely to be wrong.
+        steps.push(['metro config', inspectMetroConfig(metro.file)]);
+    }
+    if (write) {
+        // Two spaces and a trailing newline, which is what npm itself writes, so an
+        // app's package.json does not churn in the next unrelated diff.
+        fs.writeFileSync(project.manifest, `${JSON.stringify(project.json, null, 2)}\n`);
+    }
+    return { ok: true, steps };
+}
+function main(argv) {
+    // `npx basalt-core init` is how the README and the proposal both
+    // spell this, and it is how react-native-windows and react-native-macos
+    // spell theirs -- so `init` is the verb, not the directory to configure.
+    // Without this the command resolved ./init, found no package.json there,
+    // and refused to configure the app it was standing in.
+    const args = argv[0] === 'init' ? argv.slice(1) : argv;
+    const root = args[0] != null && !args[0].startsWith('-') ? path.resolve(args[0]) : process.cwd();
+    const result = init(root);
+    if (!result.ok) {
+        process.stderr.write(`basalt-core init: ${result.reason}\n`);
+        return 1;
+    }
+    const { changed, blocked } = (0, steps_1.report)(result.steps, line => process.stdout.write(`${line}\n`));
+    if (blocked > 0) {
+        process.stdout.write('\nSome steps need doing by hand; see above.\n');
+        return 1;
+    }
+    process.stdout.write(changed === 0
+        ? '\nAlready configured. Nothing to do.\n'
+        : '\nInstall dependencies, then `npm run linux` (or macos, or windows).\n');
+    return 0;
+}
+if (require.main === module) {
+    process.exitCode = main(process.argv.slice(2));
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../cli/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/metro.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Starting Metro, or noticing that it is already running.
+ *
+ * Deliberately not a Metro API call. `run-android` and `run-ios` both shell out
+ * to `react-native start` in a detached process for the same reason: the
+ * packager outlives the run command, and an app is normally launched several
+ * times against one Metro.
+ *
+ * @format
+ */
+import type { ChildProcess } from 'node:child_process';
+/**
+ * What React Native's CLI hands a command. Only the two fields this file uses:
+ * the rest of the context is large, changes between versions, and typing what
+ * is not read would be claiming more than is known.
+ */
+export type MetroContext = {
+    root: string;
+    reactNativePath: string;
+};
+export type StartedMetro = {
+    child: ChildProcess;
+    logPath: string;
+};
+/**
+ * Whether something is already listening.
+ *
+ * Only that something is listening, not that it is Metro: a port in use by
+ * anything else is a problem the developer has to see, and starting a second
+ * Metro on top of it would hide it.
+ */
+export declare function isPortTaken(port: number, host?: string): Promise<boolean>;
+export declare function waitForPort(port: number, timeoutMs: number): Promise<boolean>;
+/**
+ * Starts Metro and returns once it is listening.
+ *
+ * Detached and unref'd, so quitting the app does not kill the packager and the
+ * next `run-linux` reuses it.
+ *
+ * Its output goes to a file rather than to this terminal, which looks like the
+ * unfriendly choice and is not. A detached child that inherits stdout holds the
+ * pipe open after this command exits, so anything reading `run-linux`'s output
+ * waits forever for a packager that is meant to outlive it. This repository's
+ * own CI hit the same shape and its workflow carries the same warning. The path
+ * is printed, and `--no-packager` with a packager of your own is the answer if
+ * you want it on screen.
+ */
+export declare function startMetro(context: MetroContext, port: number): Promise<StartedMetro>;
+//# sourceMappingURL=metro.d.ts.map

package/dist/cli/metro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro.d.ts","sourceRoot":"","sources":["../../cli/metro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAMrD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAY9E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+C3F"}

package/dist/cli/metro.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Starting Metro, or noticing that it is already running.
+ *
+ * Deliberately not a Metro API call. `run-android` and `run-ios` both shell out
+ * to `react-native start` in a detached process for the same reason: the
+ * packager outlives the run command, and an app is normally launched several
+ * times against one Metro.
+ *
+ * @format
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPortTaken = isPortTaken;
+exports.waitForPort = waitForPort;
+exports.startMetro = startMetro;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const net = __importStar(require("node:net"));
+const path = __importStar(require("node:path"));
+/**
+ * Whether something is already listening.
+ *
+ * Only that something is listening, not that it is Metro: a port in use by
+ * anything else is a problem the developer has to see, and starting a second
+ * Metro on top of it would hide it.
+ */
+function isPortTaken(port, host = 'localhost') {
+    return new Promise(resolve => {
+        const socket = net.connect({ port, host });
+        const done = (taken) => {
+            socket.destroy();
+            resolve(taken);
+        };
+        socket.setTimeout(1500);
+        socket.once('connect', () => done(true));
+        socket.once('timeout', () => done(false));
+        socket.once('error', () => done(false));
+    });
+}
+async function waitForPort(port, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await isPortTaken(port)) {
+            return true;
+        }
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    return false;
+}
+/**
+ * Starts Metro and returns once it is listening.
+ *
+ * Detached and unref'd, so quitting the app does not kill the packager and the
+ * next `run-linux` reuses it.
+ *
+ * Its output goes to a file rather than to this terminal, which looks like the
+ * unfriendly choice and is not. A detached child that inherits stdout holds the
+ * pipe open after this command exits, so anything reading `run-linux`'s output
+ * waits forever for a packager that is meant to outlive it. This repository's
+ * own CI hit the same shape and its workflow carries the same warning. The path
+ * is printed, and `--no-packager` with a packager of your own is the answer if
+ * you want it on screen.
+ */
+async function startMetro(context, port) {
+    const cli = path.join(context.reactNativePath, 'cli.js');
+    const logDir = path.join(context.root, '.basalt');
+    fs.mkdirSync(logDir, { recursive: true });
+    const logPath = path.join(logDir, 'metro.log');
+    const log = fs.openSync(logPath, 'a');
+    const child = (0, node_child_process_1.spawn)(process.execPath, [cli, 'start', '--port', String(port)], {
+        cwd: context.root,
+        detached: true,
+        stdio: ['ignore', log, log],
+    });
+    child.unref();
+    fs.closeSync(log);
+    const exited = new Promise(resolve => {
+        child.once('exit', (code, signal) => resolve({ code, signal }));
+        child.once('error', (error) => resolve({ error }));
+    });
+    const outcome = await Promise.race([
+        waitForPort(port, 90000).then(listening => ({ listening })),
+        exited.then(exit => ({ exit })),
+    ]);
+    if (outcome.exit) {
+        const { code, signal, error } = outcome.exit;
+        const how = error
+            ? `could not be started (${error.message})`
+            : `exited before listening (${signal ?? `code ${code}`})`;
+        throw new Error(`Metro ${how}. The end of ${logPath}:\n\n${tail(logPath, 12)}`);
+    }
+    if (!outcome.listening) {
+        throw new Error(`Metro did not start listening on port ${port}; see ${logPath}`);
+    }
+    return { child, logPath };
+}
+/**
+ * The last lines of a file, without terminal colour codes, for an error
+ * message. Empty when it cannot be read: the message is still worth showing.
+ */
+function tail(file, lines) {
+    try {
+        return fs
+            .readFileSync(file, 'utf8')
+            .replace(/\x1b\[[0-9;]*[A-Za-z]/g, '')
+            .trimEnd()
+            .split(/\r?\n/)
+            .slice(-lines)
+            .join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=metro.js.map

package/dist/cli/metro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metro.js","sourceRoot":"","sources":["../../cli/metro.ts"],"names":[],"mappings":"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"}