stim 1.18.0 → 1.19.0

package/dist/{android-DC3ZLuw0.mjs → android-BdQC6zs1.mjs}

@@ -1,10 +1,10 @@
 import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { C as saveConfig, D as withConfigLock$1, H as projectDeviceSlots, I as assignSlotDevice, U as removeSlotDevice, _ as loadConfig$1, c as ensureConfig, d as getConfigDir, f as getConfigPath$1, z as deviceSlotPlatforms } from "./config-CgYMahz7.mjs";
-import { o as pidExists, u as signalProcessTree } from "./metro-Dh8T4Ytd.mjs";
-import { n as readCreatedDevices$1, r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-DKbeWsiK.mjs";
-import { n as settingDefault, r as stimDesktopInstalled, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-Behws_fi.mjs";
-import { s as androidDataPartitionSizeBytes } from "./settings-CQyMElEP.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { C as saveConfig, D as withConfigLock$1, H as projectDeviceSlots, I as assignSlotDevice, U as removeSlotDevice, _ as loadConfig$1, c as ensureConfig, d as getConfigDir, f as getConfigPath$1, z as deviceSlotPlatforms } from "./config-DC5jEtd1.mjs";
+import { s as androidDataPartitionSizeBytes } from "./settings-CxgngUZk.mjs";
+import { d as signalProcessTree, s as pidExists } from "./metro-DI2AjPF_.mjs";
+import { n as readCreatedDevices$1, r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-D0s26Hx5.mjs";
+import { n as settingDefault, r as stimDesktopInstalled, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-C65jk_q2.mjs";
 import { join } from "node:path";
 import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, resolve as resolve$1 } from "path";
 import { ANDROID_EMULATOR_APPS, getParkedMax, loadConfig, settingDefinition } from "@stim-cli/core/state";

package/dist/{android-BKA16DTf.mjs → android-BvV1gGdN.mjs}

@@ -1,4 +1,4 @@
-import { i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-CBtzyIgF.mjs";
-import { a as collectorLogFile, c as androidFacts, i as runAndroidOperation, l as lastBuildRecord, n as registerAndroid, o as killPreviousCollector, r as runAndroid, s as startCollector, t as androidCommand } from "./android-BvwuMUJ9.mjs";
-import { C as resolveSystemImage, _ as isReleaseVariant, c as androidSystemImageSetting, d as apkPackage, h as findAapt, i as NO_FINGERPRINT, l as androidVariantSetting, m as dumpApkManifest, p as displayPath, r as NO_DEVICE, s as androidDevClientScheme, u as apkDevClientFacts, v as noDeviceDiagnostic, w as resolveVariant, y as parseXmltree } from "./support-Bwvbrq5-.mjs";
+import { i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-Bt8ygHE7.mjs";
+import { a as collectorLogFile, c as androidFacts, i as runAndroidOperation, l as lastBuildRecord, n as registerAndroid, o as killPreviousCollector, r as runAndroid, s as startCollector, t as androidCommand } from "./android-BXc6BmEi.mjs";
+import { C as resolveSystemImage, _ as isReleaseVariant, c as androidSystemImageSetting, d as apkPackage, h as findAapt, i as NO_FINGERPRINT, l as androidVariantSetting, m as dumpApkManifest, p as displayPath, r as NO_DEVICE, s as androidDevClientScheme, u as apkDevClientFacts, v as noDeviceDiagnostic, w as resolveVariant, y as parseXmltree } from "./support-DsNaFg6D.mjs";
 export { NO_DEVICE, NO_FINGERPRINT, androidDevClientScheme, androidFacts, androidSystemImageSetting, androidVariantSetting, apkDevClientFacts, apkPackage, collectorLogFile, androidCommand as default, displayPath, dumpApkManifest, findAapt, formatDuration, isReleaseVariant, killPreviousCollector, lastBuildRecord, noDeviceDiagnostic, parseXmltree, phaseLine, registerAndroid, resolveSystemImage, resolveVariant, runAndroid, runAndroidOperation, shortHash, startCollector };

package/dist/{android-CBwCNicO.mjs → android-DE5g_5gv.mjs}

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { u as androidToolCwd } from "./android-DC3ZLuw0.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { u as androidToolCwd } from "./android-BdQC6zs1.mjs";
 //#region src/collector/android.ts
 const LEVEL_BY_LETTER = {
 	V: "debug",

package/dist/{android-cas-BBFyr9CA.mjs → android-cas-C87geAg-.mjs}

@@ -1,6 +1,6 @@
-import { d as getConfigDir } from "./config-CgYMahz7.mjs";
-import { u as ensureWorkspaceStorage, w as withDirLock$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { r as register } from "./cache-manifest-BI7ozfmH.mjs";
+import { d as getConfigDir } from "./config-DC5jEtd1.mjs";
+import { u as ensureWorkspaceStorage, w as withDirLock$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { r as register } from "./cache-manifest-DiwKSyv9.mjs";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { isJsonObject, readJsonFile } from "@stim-cli/core/state";

package/dist/android-cas-compiler.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { createHash, randomUUID } from "node:crypto";

package/dist/{api-D0VtFhqk.mjs → api-DIf_s86s.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { t as spawnEntry } from "./spawn-entry-Dcb7sDUz.mjs";
 import { realpathSync } from "node:fs";
 import { isAbsolute } from "node:path";
@@ -46,12 +46,10 @@ function createStim(options) {
 	};
 	return {
 		projectRoot,
-		run({ signal, ...request }) {
-			return invoke(context, {
-				operation: "run",
-				options: request
-			}, signal);
-		},
+		run: (({ signal, ...request }) => invoke(context, {
+			operation: "run",
+			options: request
+		}, signal)),
 		stop({ signal, ...request } = {}) {
 			return invoke(context, {
 				operation: "stop",

package/dist/api-run.mjs

@@ -1,11 +1,11 @@
-import { t as StimError } from "./api-D0VtFhqk.mjs";
-import { y as refuseRelativeStimPaths } from "./config-CgYMahz7.mjs";
-import { x as workspaceLogsDir$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { i as runAndroidOperation } from "./android-BvwuMUJ9.mjs";
-import { r as runIosOperation } from "./ios-CPdkoKaa.mjs";
-import { n as runMacos } from "./macos-DF6C7wUU.mjs";
-import { c as stopWorkspaceNow } from "./stop-BTjs3xbc.mjs";
-import { n as runWeb } from "./web-DTU0uiWj.mjs";
+import { t as StimError } from "./api-DIf_s86s.mjs";
+import { y as refuseRelativeStimPaths } from "./config-DC5jEtd1.mjs";
+import { x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { i as runAndroidOperation } from "./android-BXc6BmEi.mjs";
+import { r as runIosOperation } from "./ios-ITYno9rO.mjs";
+import { n as runMacos } from "./macos-ciyBdTY5.mjs";
+import { c as stopWorkspaceNow } from "./stop-zDlknFoz.mjs";
+import { t as runWeb } from "./web-DbbrPUn0.mjs";
 import { queryJsonLogs } from "@stim-cli/core/state";
 //#region src/api-run.ts
 async function dispatch({ projectRoot: root, ...request }) {

package/dist/api.d.mts

@@ -1,8 +1,9 @@
 import "./state-lKh8shBp.mjs";
-import { i as IosFacts, t as AndroidFacts } from "./build-facts-DcLv2HSd.mjs";
+import { i as IosFacts, t as AndroidFacts } from "./build-facts-B87vo-Im.mjs";
 import "./ndjson-Du3j0AQ9.mjs";
-import { MacosBuild, NdjsonRecord, WebBrowserState } from "@stim-cli/core/state";
+import { MacosBuild, NdjsonRecord, WebBrowserState, WebViewport } from "@stim-cli/core/state";
 import { Command } from "commander";
+import "@stim-cli/cache";
 import { ChildProcess } from "node:child_process";
 //#region src/engine/device-lease.d.ts
 type LeasePlatform = "ios" | "android";
@@ -181,6 +182,11 @@ interface StimDiagnostics {
 }
 interface StimClient {
   readonly projectRoot: string;
+  run<P extends StimPlatform>(options: StimRunOptions & {
+    platform: P;
+  }): Promise<Extract<StimRunResult, {
+    platform: P;
+  }>>;
   run(options: StimRunOptions): Promise<StimRunResult>;
   /** Stops this workspace, including resources created before a failed run. Use a fresh signal for cleanup. */
   stop(options?: StimStopOptions): Promise<StimStopResult>;

package/dist/api.mjs

@@ -1,2 +1,2 @@
-import { n as createStim, t as StimError } from "./api-D0VtFhqk.mjs";
+import { n as createStim, t as StimError } from "./api-DIf_s86s.mjs";
 export { StimError, createStim };

package/dist/{app-install-D-PUENug.mjs → app-install-CFI4ptUL.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { N as deviceHoldsApk, O as uninstallIosApp, P as deviceHoldsBundle, h as listUserApps, u as iosSimulatorFailureAdvice } from "./ios-B3SbOWdw.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-Bn7jWDB1.mjs";
+import { n as debugLog, t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { N as deviceHoldsApk, O as uninstallIosApp, P as deviceHoldsBundle, h as listUserApps, u as iosSimulatorFailureAdvice } from "./ios-BWbHFZVz.mjs";
+import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-CrW8aMb5.mjs";
 import { join } from "node:path";
 //#region src/engine/app-schemes.ts
 function schemesFromInfoPlist(plist) {
@@ -207,25 +207,45 @@ function parseLaunchedPid(text) {
 }
 function iosAppProcess(udid, bundleId, { exec = null } = {}) {
 	const e = exec || getExecutor();
-	let out = "";
+	const started = performance.now();
+	let pid;
+	let failure = {};
 	try {
-		out = e.runFile("xcrun", [
+		const out = e.runFile("xcrun", [
 			"simctl",
 			"spawn",
 			udid,
 			"launchctl",
 			"list"
 		], { timeoutMs: 2e3 });
-	} catch {
+		const label = `UIKitApplication:${bundleId}[`;
+		pid = null;
+		for (const line of out.split("\n")) {
+			if (!line.includes(label)) continue;
+			const candidate = Number(line.trim().split(/\s+/)[0]);
+			if (Number.isInteger(candidate) && candidate > 0) {
+				pid = candidate;
+				break;
+			}
+		}
+		return pid;
+	} catch (error) {
+		const { code, status } = error ?? {};
+		failure = {
+			...typeof code === "string" ? { code } : {},
+			...typeof status === "number" ? { exit: status } : {}
+		};
 		return;
+	} finally {
+		debugLog.log("ios.app-process", {
+			deviceId: udid,
+			bundleId,
+			state: pid === void 0 ? "unknown" : pid === null ? "absent" : "running",
+			...typeof pid === "number" ? { appPid: pid } : {},
+			ms: Math.round(performance.now() - started),
+			...failure
+		});
 	}
-	const label = `UIKitApplication:${bundleId}[`;
-	for (const line of out.split("\n")) {
-		if (!line.includes(label)) continue;
-		const pid = Number(line.trim().split(/\s+/)[0]);
-		if (Number.isInteger(pid) && pid > 0) return pid;
-	}
-	return null;
 }
 function launchedIosAppAfterNoHandle(error, udid, bundleId, exec) {
 	const stderr = String(error?.stderr ?? "");

package/dist/{web-DTU0uiWj.mjs → browser-web-CDhqQxhv.mjs}

@@ -1,27 +1,36 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { t as spawnEntry } from "./spawn-entry-Dcb7sDUz.mjs";
-import { f as refuseNoProject, l as phaseLine } from "./command-output-CBtzyIgF.mjs";
-import { E as upsertProject, p as getProject } from "./config-CgYMahz7.mjs";
-import { s as gitCommonDir, y as repoRoot } from "./worktree-CsKYexJM.mjs";
-import { i as detectIsExpo, l as isPackageResolvable, o as findCommandWorkspace } from "./project-C3ChRLZy.mjs";
-import { l as resolveProjectMetro } from "./metro-Dh8T4Ytd.mjs";
-import { i as recordWorkspaceUse, r as readWorkspaceState, v as workspaceDir, x as workspaceLogsDir } from "./workspace-state-C59dqG-Z.mjs";
-import { d as webLogFile, o as readWebRecord, p as webSupervisorLogFile, r as cdpEndpoint, s as updateWebRecord } from "./state-BG-aAk4k.mjs";
-import { T as teardownBrowserHeld, m as resolveSupervisorTarget } from "./workspaces-xXItD8Dj.mjs";
-import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Behws_fi.mjs";
-import { F as resolveSettings, W as webSettings, i as SETTING_SHAPE_REMEDY, x as metroPortSetting, z as settingShapeErrors } from "./settings-CQyMElEP.mjs";
-import { a as withWorkspaceProcessLock, i as reserveBrowserPort, n as getNamedPort } from "./named-ports-BFIz1Shz.mjs";
+import { l as phaseLine } from "./command-output-Bt8ygHE7.mjs";
+import { p as getProject } from "./config-DC5jEtd1.mjs";
+import { r as readWorkspaceState, v as workspaceDir, x as workspaceLogsDir } from "./workspace-state-CR9X86xJ.mjs";
+import { h as isPackageResolvable, p as detectIsExpo } from "./project-B5eQ1USs.mjs";
+import { G as webSettings, i as SETTING_SHAPE_REMEDY, x as metroPortSetting } from "./settings-CxgngUZk.mjs";
+import { u as resolveProjectMetro } from "./metro-DI2AjPF_.mjs";
+import { d as webLogFile, o as readWebRecord, p as webSupervisorLogFile, s as updateWebRecord } from "./state-D2KtnALG.mjs";
+import { E as teardownBrowserHeld, m as resolveSupervisorTarget } from "./workspaces-Djb2gfi9.mjs";
+import { a as withWorkspaceProcessLock, i as reserveBrowserPort, n as getNamedPort } from "./named-ports-B4iWH4E-.mjs";
 import { o as readNdjsonGenerations } from "./ndjson-LGZAMsqa.mjs";
-import { c as readMetroRecords } from "./launch-verify-hskNcWkZ.mjs";
-import { o as resolveWorkspaceMetroPort } from "./start-D-IeOyoK.mjs";
-import { n as windowsLauncherArgs } from "./detached-entry-BLfcgc4O.mjs";
-import { a as sleep, n as ensureWorkspaceStorageSafely } from "./native-runtime-D_603JiC.mjs";
-import { a as findChrome, t as CHROME_INSTALL_REMEDY } from "./chrome-DJnmnS5q.mjs";
+import { c as readMetroRecords } from "./launch-verify-DCveSE6d.mjs";
+import { o as resolveWorkspaceMetroPort } from "./start-DtxthMfI.mjs";
+import { n as windowsLauncherArgs } from "./detached-entry-pB_IPfV4.mjs";
+import { a as sleep } from "./native-runtime-BGxsbfny.mjs";
 import { n as sendToOwnedPage, t as liveWebRecord } from "./page-Bv9s2KwY.mjs";
+import { a as findChrome, t as CHROME_INSTALL_REMEDY } from "./chrome-BTUOo8p2.mjs";
 import { mkdirSync, openSync } from "node:fs";
 import chalk from "chalk";
 import { randomUUID } from "node:crypto";
 //#region src/web/launch.ts
+const PORT_PLACEHOLDER = /\{port:([^}]*)\}/g;
+/** Replaces each `{port:<label>}` in a `web.url` template; `metro` is the workspace's Metro port. */
+async function resolveWebUrl(template, { metroPort, namedPort }) {
+	let url = template;
+	for (const [placeholder, label] of template.matchAll(PORT_PLACEHOLDER)) {
+		const port = label === "metro" ? metroPort : await namedPort(label);
+		if (port === null) throw new Error(`${placeholder} needs a Metro port, and this workspace has none reserved.`);
+		url = url.replace(placeholder, String(port));
+	}
+	return url;
+}
 const VERIFY_WAIT_MS = 2e4;
 const LOADING_WAIT_MS = 6e4;
 const METRO_WEB_BUNDLE = /\bWeb\s+Bundl(?:ing|ed)\b/i;
@@ -128,12 +137,10 @@ function webLaunchRemedy(verdict, { url, template, usesMetro, serve }) {
 	return usesMetro ? METRO_BUILD(url) : nothingServed;
 }
 //#endregion
-//#region src/commands/web.ts
-const PORT_PLACEHOLDER = /\{port:([^}]*)\}/g;
+//#region src/web/runtime.ts
 const REGISTER_WAIT_MS = 3e4;
-const POLL_MS = 250;
-const printNote = (line) => console.error(line);
-function failure(code, message, remedy) {
+const POLL_MS$1 = 250;
+function failure$1(code, message, remedy) {
 	return {
 		ok: false,
 		error: {
@@ -143,16 +150,6 @@ function failure(code, message, remedy) {
 		}
 	};
 }
-/** Replaces each `{port:<label>}` in a `web.url` template; `metro` is the workspace's Metro port. */
-async function resolveWebUrl(template, { metroPort, namedPort }) {
-	let url = template;
-	for (const [placeholder, label] of template.matchAll(PORT_PLACEHOLDER)) {
-		const port = label === "metro" ? metroPort : await namedPort(label);
-		if (port === null) throw new Error(`${placeholder} needs a Metro port, and this workspace has none reserved.`);
-		url = url.replace(placeholder, String(port));
-	}
-	return url;
-}
 function sameLaunch(record, config) {
 	return record.chrome === config.chrome && record.headless === config.headless && record.viewport === config.viewport && record.ignoreCertificateErrors === config.ignoreCertificateErrors;
 }
@@ -216,77 +213,12 @@ async function waitForSupervisor(root, child, launchId) {
 		const record = readWebRecord(root);
 		if (record?.launchId === launchId && record.targetId) return record;
 		if (exited) return null;
-		await sleep(POLL_MS);
+		await sleep(POLL_MS$1);
 	}
 	return null;
 }
-async function verifyLaunch(root, since, expectBundle) {
-	const startedAt = Date.now();
-	for (;;) {
-		const verdict = webLaunchVerdict({
-			records: readNdjsonGenerations(webLogFile(root)),
-			metroRecords: expectBundle ? readMetroRecords(workspaceLogsDir(root)) : [],
-			since,
-			expectBundle,
-			elapsedMs: Date.now() - startedAt
-		});
-		if (verdict) return verdict;
-		await sleep(POLL_MS);
-	}
-}
-async function runWeb({ root, headed, note }) {
-	const startedAt = Date.now();
-	await ensureWorkspaceStorageSafely(root, { note });
-	if (!getProject(root)) upsertProject(root, {});
-	const settings = resolveSettings({
-		projectPath: root,
-		gitCommonDir: gitCommonDir(root),
-		repoRoot: repoRoot(root)
-	});
-	const [shapeError] = settingShapeErrors(settings);
-	if (shapeError) return failure("STIM_BAD_ARG", shapeError, SETTING_SHAPE_REMEDY);
-	const web = webSettings(settings);
-	const usesMetro = web.url === null || web.url.includes("{port:metro}");
-	const pin = usesMetro ? metroPortSetting(root) : null;
-	if (pin?.error) return failure("STIM_BAD_ARG", pin.error, SETTING_SHAPE_REMEDY);
-	const chrome = findChrome();
-	if (!chrome) return failure("STIM_WEB_NO_CHROME", "Google Chrome or Chromium is not installed.", CHROME_INSTALL_REMEDY);
-	if (web.url === null && !detectIsExpo(root)) return failure("STIM_WEB_NO_URL", "This is not an Expo app, so Stim does not know which page to open.", "Start your web dev server on a named port, then set the page: `stim settings set web.url 'http://localhost:{port:web}/' --scope workspace`. See `stim guide web`.");
-	if (web.url === null && !isPackageResolvable(root, "react-native-web")) return failure("STIM_WEB_DEPS_MISSING", "This Expo app cannot render on the web: react-native-web is not installed.", `Run \`${EXPO_WEB_DEPENDENCIES}\` and \`stim start\`, then run \`stim web\` again.`);
-	let metroPort = getProject(root)?.metroPort ?? null;
-	if (usesMetro && (pin?.port !== null || metroPort === null)) {
-		const result = await resolveWorkspaceMetroPort(root, note, "web");
-		if (typeof result !== "number") return failure(result.code, result.message, result.remedy);
-		metroPort = result;
-	}
-	const metro = usesMetro && metroPort !== null ? await resolveProjectMetro(metroPort, root) : null;
-	const supervisor = resolveSupervisorTarget({
-		state: readWorkspaceState(root)?.supervisor,
-		record: getProject(root)?.supervisor,
-		reservedPort: metroPort
-	});
-	const { serve, foreign } = webServePlan({
-		usesMetro,
-		metro,
-		supervisorHeld: supervisor.status !== "none" && supervisor.status !== "stale",
-		missingWebPackages: usesMetro && detectIsExpo(root) ? EXPO_WEB_PACKAGES.filter((name) => !isPackageResolvable(root, name)) : []
-	});
-	let url;
-	try {
-		url = await resolveWebUrl(web.url ?? "http://localhost:{port:metro}/", {
-			metroPort,
-			namedPort: (label) => getNamedPort(root, label)
-		});
-	} catch (error) {
-		return failure("STIM_BAD_ARG", `web.url: ${error.message}`, SETTING_SHAPE_REMEDY);
-	}
-	const config = {
-		chrome,
-		headless: !headed,
-		viewport: web.viewport,
-		ignoreCertificateErrors: web.ignoreCertificateErrors
-	};
-	const launch = await withWorkspaceProcessLock(workspaceDir(root), "web", async () => {
+async function launchOwnedBrowser({ url, config }, { root, note }) {
+	return withWorkspaceProcessLock(workspaceDir(root), "web", async () => {
 		const live = liveWebRecord(readWebRecord(root));
 		if (live && sameLaunch(live, config)) {
 			const since = Date.now();
@@ -308,7 +240,7 @@ async function runWeb({ root, headed, note }) {
 			}
 		}
 		const stopped = await teardownBrowserHeld(root);
-		if (stopped.status === "failed" || stopped.status === "skipped") return failure("STIM_WEB_BROWSER_HELD", `The previous owned Chrome could not be stopped: ${stopped.reason ?? "unknown reason"}.`, "Run `stim status` and `stim guide errors teardown`.");
+		if (stopped.status === "failed" || stopped.status === "skipped") return failure$1("STIM_WEB_BROWSER_HELD", `The previous owned Chrome could not be stopped: ${stopped.reason ?? "unknown reason"}.`, "Run `stim status` and `stim guide errors teardown`.");
 		const port = await reserveBrowserPort(root);
 		const since = Date.now();
 		note(chalk.dim(phaseLine("device", `starting ${config.headless ? "headless " : ""}Chrome on DevTools port ${port}`)));
@@ -319,7 +251,7 @@ async function runWeb({ root, headed, note }) {
 			config,
 			launchId
 		}), launchId);
-		if (!record) return failure("STIM_WEB_LAUNCH_FAILED", "The owned Chrome did not start.", `Read ${webSupervisorLogFile(root)} and \`stim logs --errors\`, then run \`stim web\` again.`);
+		if (!record) return failure$1("STIM_WEB_LAUNCH_FAILED", "The owned Chrome did not start.", `Read ${webSupervisorLogFile(root)} and \`stim logs --errors\`, then run \`stim web\` again.`);
 		return {
 			ok: true,
 			record,
@@ -330,80 +262,110 @@ async function runWeb({ root, headed, note }) {
 		external: true,
 		ownerPurpose: "stim web"
 	});
-	if (!launch.ok) return launch;
-	const measured = await verifyLaunch(root, launch.since, usesMetro);
-	const live = liveWebRecord(readWebRecord(root));
-	const record = live ?? launch.record;
-	const verdict = foreign ? {
-		launched: "unverified",
-		kind: "no-response",
-		reason: foreign.reason
-	} : measured;
-	const remedy = foreign ? foreign.remedy : webLaunchRemedy(verdict, {
-		url,
-		template: web.url,
-		usesMetro,
-		serve
-	});
+}
+//#endregion
+//#region src/integrations/browser-web.ts
+const POLL_MS = 250;
+function failure(code, message, remedy) {
 	return {
-		ok: true,
-		remedy: verdict.reason && remedy ? `${verdict.reason}. ${remedy}` : remedy,
-		facts: {
-			platform: "web",
-			browser: "chrome",
-			version: record.version ?? null,
-			running: live !== null,
-			pid: live?.chromeProcess?.pid ?? null,
-			supervisorPid: live?.pid ?? null,
-			url,
-			headless: record.headless,
-			viewport: record.viewport,
-			profile: record.profile,
-			cdpEndpoint: live ? cdpEndpoint(live.cdpPort) : null,
-			targetId: live?.targetId ?? null,
-			reused: launch.reused,
-			launched: verdict.launched,
-			metroPort: usesMetro ? metroPort : null,
-			logs: { dir: workspaceLogsDir(root) },
-			durationMs: Date.now() - startedAt
+		ok: false,
+		error: {
+			code,
+			message,
+			remedy
 		}
 	};
 }
-function webCommand(program) {
-	program.command("web").description("Open this workspace's page in a Stim-owned headless Chrome and capture its console, errors and failed requests in stim logs").option("--headed", "Show the Chrome window instead of running headless").option("--json", "Print the result as one JSON object; progress goes to stderr").action(async (opts) => {
-		const json = Boolean(opts.json);
-		const root = findCommandWorkspace(process.cwd());
-		if (!root) {
-			refuseNoProject({ json });
-			return;
-		}
-		recordWorkspaceUse(root);
-		const result = await runWeb({
-			root,
-			headed: Boolean(opts.headed),
-			note: printNote
-		});
-		if (!result.ok) {
-			printNote(chalk.red(phaseLine("error", `${result.error.code}: ${result.error.message}`)));
-			if (result.error.remedy) printNote(phaseLine("remedy", result.error.remedy));
-			if (json) console.log(JSON.stringify(result.error));
-			process.exitCode = 1;
-			return;
-		}
-		const { facts, remedy } = result;
-		if (remedy) printNote(chalk.yellow(phaseLine("launch", remedy)));
-		const links = workspaceLinks(root, { platform: "web" });
-		if (json) {
-			console.log(JSON.stringify(links ? {
-				...facts,
-				links
-			} : facts));
-			return;
+function browserWebProject(root) {
+	return { runtime: ({ settings, headed, note }) => ({
+		async prepare() {
+			const web = webSettings(settings);
+			const usesMetro = web.url === null || web.url.includes("{port:metro}");
+			const pin = usesMetro ? metroPortSetting(root) : null;
+			if (pin?.error) return failure("STIM_BAD_ARG", pin.error, SETTING_SHAPE_REMEDY);
+			const chrome = findChrome();
+			if (!chrome) return failure("STIM_WEB_NO_CHROME", "Google Chrome or Chromium is not installed.", CHROME_INSTALL_REMEDY);
+			if (web.url === null && !detectIsExpo(root)) return failure("STIM_WEB_NO_URL", "This is not an Expo app, so Stim does not know which page to open.", "Start your web dev server on a named port, then set the page: `stim settings set web.url 'http://localhost:{port:web}/' --scope workspace`. See `stim guide web`.");
+			if (web.url === null && !isPackageResolvable(root, "react-native-web")) return failure("STIM_WEB_DEPS_MISSING", "This Expo app cannot render on the web: react-native-web is not installed.", `Run \`${EXPO_WEB_DEPENDENCIES}\` and \`stim start\`, then run \`stim web\` again.`);
+			let metroPort = getProject(root)?.metroPort ?? null;
+			if (usesMetro && (pin?.port !== null || metroPort === null)) {
+				const result = await resolveWorkspaceMetroPort(root, note, "web");
+				if (typeof result !== "number") return failure(result.code, result.message, result.remedy);
+				metroPort = result;
+			}
+			const metro = usesMetro && metroPort !== null ? await resolveProjectMetro(metroPort, root) : null;
+			const supervisor = resolveSupervisorTarget({
+				state: readWorkspaceState(root)?.supervisor,
+				record: getProject(root)?.supervisor,
+				reservedPort: metroPort
+			});
+			const { serve, foreign } = webServePlan({
+				usesMetro,
+				metro,
+				supervisorHeld: supervisor.status !== "none" && supervisor.status !== "stale",
+				missingWebPackages: usesMetro && detectIsExpo(root) ? EXPO_WEB_PACKAGES.filter((name) => !isPackageResolvable(root, name)) : []
+			});
+			let url;
+			try {
+				url = await resolveWebUrl(web.url ?? "http://localhost:{port:metro}/", {
+					metroPort,
+					namedPort: (label) => getNamedPort(root, label)
+				});
+			} catch (error) {
+				return failure("STIM_BAD_ARG", `web.url: ${error.message}`, SETTING_SHAPE_REMEDY);
+			}
+			return {
+				ok: true,
+				prepared: {
+					url,
+					config: {
+						chrome,
+						headless: !headed,
+						viewport: web.viewport,
+						ignoreCertificateErrors: web.ignoreCertificateErrors
+					},
+					metroPort: usesMetro ? metroPort : null,
+					verification: {
+						template: web.url,
+						expectBundle: usesMetro,
+						serve,
+						foreign
+					}
+				}
+			};
+		},
+		launch: launchOwnedBrowser,
+		async verify({ url, verification: { template, expectBundle, serve, foreign } }, { since }) {
+			const startedAt = Date.now();
+			let measured;
+			for (;;) {
+				measured = webLaunchVerdict({
+					records: readNdjsonGenerations(webLogFile(root)),
+					metroRecords: expectBundle ? readMetroRecords(workspaceLogsDir(root)) : [],
+					since,
+					expectBundle,
+					elapsedMs: Date.now() - startedAt
+				});
+				if (measured) break;
+				await sleep(POLL_MS);
+			}
+			const verdict = foreign ? {
+				launched: "unverified",
+				kind: "no-response",
+				reason: foreign.reason
+			} : measured;
+			const remedy = foreign ? foreign.remedy : webLaunchRemedy(verdict, {
+				url,
+				template,
+				usesMetro: expectBundle,
+				serve
+			});
+			return {
+				verdict,
+				remedy: verdict.reason && remedy ? `${verdict.reason}. ${remedy}` : remedy
+			};
 		}
-		const launched = facts.launched === true ? chalk.green("loaded") : chalk.yellow(facts.launched === "bundling" ? "bundling" : "unverified");
-		console.log(facts.running ? `${facts.url} ${launched} in ${facts.version ?? "Chrome"} (pid ${facts.pid}, ${facts.headless ? "headless" : "headed"}, ${facts.viewport}). DevTools: ${facts.cdpEndpoint}. Logs: stim logs --errors.` : `${facts.url} ${launched}, and the owned Chrome is no longer running. Run stim logs --errors, then stim web again.`);
-		if (links) console.error(chalk.dim(workspaceLinkLine(links)));
-	});
+	}) };
 }
 //#endregion
-export { runWeb as n, webCommand as r, resolveWebUrl as t };
+export { browserWebProject };