stim 1.19.0 → 1.20.0

package/dist/{server-expo-n3tUi3Em.mjs → server-expo-CsYu2aKL.mjs}

@@ -1,19 +1,94 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { K as resolveProjectSettings } from "./settings-Bbztm4oV.mjs";
 import { n as stripAnsi, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { v as resolvePackageJson } from "./project-B5eQ1USs.mjs";
-import { O as projectMetroSharedCache } from "./settings-CxgngUZk.mjs";
-import { a as metroStoreRoot, c as supervisorError, i as metroStoreConfirmedRoot, n as expoMetroConfigPath, o as registerMetroStore, r as expoMetroStoreEnv } from "./metro-store-BAHFcJm6.mjs";
-import { r as createNdjsonWriter } from "./ndjson-LGZAMsqa.mjs";
+import { S as resolvePackageJson } from "./project-B8_duAzW.mjs";
+import { r as createNdjsonWriter } from "./ndjson-GOnbyvso.mjs";
+import { a as expoMetroStoreEnv, c as registerMetroStore, f as resolveMetroSharedCache, i as expoMetroConfigPath, n as supervisorError, o as metroStoreConfirmedRoot, s as metroStoreRoot } from "./errors-DzkMYh8Q.mjs";
 import { accessSync, constants, existsSync, readFileSync } from "node:fs";
-import { dirname, join, parse } from "node:path";
+import { dirname, join } from "node:path";
 import { LOG_ROTATE_BYTES } from "@stim-cli/core";
-//#region src/supervisor/server-expo.ts
+//#region src/supervisor/child-server.ts
 function delay(ms) {
 	return new Promise((resolve) => {
 		const timer = setTimeout(resolve, ms);
 		if (typeof timer.unref === "function") timer.unref();
 	});
 }
+function superviseChildServer({ mode, child, log, toRecord, signal, alive = null, killTimeoutMs, onRecord = null }) {
+	let lastMsg = null;
+	let lastAt = 0;
+	const emit = (stream) => (chunk) => {
+		const record = toRecord(chunk, stream);
+		if (!record) return;
+		if (typeof record.requestId === "string") {
+			log.write(record);
+			onRecord?.(record);
+			return;
+		}
+		const now = Date.now();
+		if (record.msg === lastMsg && now - lastAt < 1e3) return;
+		lastMsg = typeof record.msg === "string" ? record.msg : null;
+		lastAt = now;
+		log.write(record);
+		onRecord?.(record);
+	};
+	const outReader = createLineReader(emit("stdout"));
+	const errReader = createLineReader(emit("stderr"));
+	child.stdout?.setEncoding?.("utf-8");
+	child.stderr?.setEncoding?.("utf-8");
+	child.stdout?.on("data", (chunk) => outReader.push(chunk));
+	child.stderr?.on("data", (chunk) => errReader.push(chunk));
+	let exited = false;
+	let exitInfo = null;
+	const listeners = [];
+	child.on("exit", (code, sig) => {
+		exited = true;
+		exitInfo = {
+			code,
+			signal: sig
+		};
+		outReader.flush();
+		errReader.flush();
+		for (const cb of listeners) cb(exitInfo);
+	});
+	child.on("error", (err) => {
+		if (exited) return;
+		exited = true;
+		exitInfo = {
+			code: null,
+			signal: null,
+			error: err
+		};
+		for (const cb of listeners) cb(exitInfo);
+	});
+	return {
+		mode,
+		serverPid: child.pid ?? null,
+		child,
+		onExit(cb) {
+			if (exited) {
+				cb(exitInfo);
+				return;
+			}
+			listeners.push(cb);
+		},
+		async close() {
+			const running = () => alive ? alive() : !exited && Boolean(child.pid);
+			const gone = async () => {
+				const deadline = Date.now() + killTimeoutMs;
+				while (running() && Date.now() < deadline) await delay(25);
+				return !running();
+			};
+			if (!running() || !signal("SIGTERM")) return;
+			if (!await gone()) {
+				signal("SIGKILL");
+				await gone();
+			}
+		}
+	};
+}
+//#endregion
+//#region src/supervisor/server-expo.ts
 function resolveExpoBin(root) {
 	const fromPackage = expoBinFromPackage(resolvePackageJson(root, "expo"));
 	if (fromPackage) return {
@@ -56,15 +131,19 @@ function expoBinFromPackage(packageJsonPath, binName = "expo") {
 	return isExecutableFile(file) ? file : null;
 }
 function findBinUpward(startDir, name, { exists = existsSync } = {}) {
+	const stop = repositoryRoot(startDir, exists) ?? startDir;
 	let dir = startDir;
-	const stop = parse(startDir).root;
 	while (true) {
 		const candidate = join(dir, "node_modules", ".bin", name);
 		if (exists(candidate)) return candidate;
 		if (dir === stop) return null;
-		const parent = dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
+		dir = dirname(dir);
+	}
+}
+function repositoryRoot(startDir, exists) {
+	for (let dir = startDir;; dir = dirname(dir)) {
+		if (exists(join(dir, ".git"))) return dir;
+		if (dirname(dir) === dir) return null;
 	}
 }
 function isExecutableFile(file) {
@@ -114,7 +193,7 @@ function cleanLine(line) {
 	const parts = stripAnsi(line).split("\r");
 	return (parts[parts.length - 1] ?? "").trimEnd();
 }
-function recordFromLine(line, { stream = "stdout" } = {}) {
+function recordFromLine(line, { stream = "stdout", source = "expo" } = {}) {
 	const msg = cleanLine(line);
 	if (!msg.trim()) return null;
 	if (stream === "stderr" && msg.startsWith("stim-bundle-response: ")) try {
@@ -133,7 +212,7 @@ function recordFromLine(line, { stream = "stdout" } = {}) {
 		level: inferLevel(msg),
 		msg,
 		raw: true,
-		event: stream === "stderr" ? "expo_stderr" : "expo_stdout"
+		event: `${source}_${stream === "stderr" ? "stderr" : "stdout"}`
 	};
 	if (isBundleMarker(msg)) record.marker = true;
 	return record;
@@ -153,8 +232,8 @@ function parseExpoWaitingOnUrl(line) {
 	if (HTTP_SCHEME_RE.test(url)) return url;
 	return URL_SCHEME_RE.test(url) ? url.replace(/^[^:]+:/, "https:") : url;
 }
-function resolveMetroStoreInjection(root, { log, env }) {
-	const sharedCache = projectMetroSharedCache(root);
+function resolveMetroStoreInjection(root, { log, env, settings }) {
+	const sharedCache = resolveMetroSharedCache(settings);
 	if (!sharedCache) log.write({
 		src: "metro",
 		level: "debug",
@@ -198,7 +277,7 @@ function resolveMetroStoreInjection(root, { log, env }) {
 	});
 	return additions;
 }
-async function startExpoServer({ root, port, logsDir, writer = null, spawnFn = null, killTimeoutMs = 5e3, tunnel = false, resetCache = false, onTunnelUrl = null, platform = process.platform }) {
+async function startExpoServer({ root, port, logsDir, writer = null, spawnFn = null, killTimeoutMs = 5e3, tunnel = false, resetCache = false, onTunnelUrl = null, platform = process.platform, settings }) {
 	const resolved = resolveExpoBin(root);
 	if (!resolved) {
 		const refusal = expoBinRefusal(root);
@@ -216,7 +295,8 @@ async function startExpoServer({ root, port, logsDir, writer = null, spawnFn = n
 	];
 	const storeEnv = resolveMetroStoreInjection(root, {
 		log,
-		env: process.env
+		env: process.env,
+		settings: settings ?? resolveProjectSettings(root).settings
 	});
 	const [command, commandArgs] = platform === "win32" && resolved.source === "package" ? [process.execPath, [bin, ...args]] : [bin, args];
 	const child = spawn(command, commandArgs, {
@@ -235,78 +315,23 @@ async function startExpoServer({ root, port, logsDir, writer = null, spawnFn = n
 			...tunnel ? { EXPO_UNSTABLE_TUNNEL_V2: "1" } : {}
 		}
 	});
-	let lastMsg = null;
-	let lastAt = 0;
 	let tunnelUrlSeen = false;
-	const emit = (stream) => (chunk) => {
-		const record = recordFromLine(chunk, { stream });
-		if (!record) return;
-		const now = Date.now();
-		if (record.msg === lastMsg && now - lastAt < 1e3) return;
-		lastMsg = typeof record.msg === "string" ? record.msg : null;
-		lastAt = now;
-		log.write(record);
-		if (tunnel && !tunnelUrlSeen && onTunnelUrl && typeof record.msg === "string") {
+	return superviseChildServer({
+		mode: "expo-child",
+		child,
+		log,
+		toRecord: (chunk, stream) => recordFromLine(chunk, { stream }),
+		signal: (sig) => child.kill(sig),
+		killTimeoutMs,
+		onRecord: (record) => {
+			if (!tunnel || tunnelUrlSeen || !onTunnelUrl || typeof record.msg !== "string") return;
 			const url = parseExpoWaitingOnUrl(record.msg);
 			if (url) {
 				tunnelUrlSeen = true;
 				onTunnelUrl(url);
 			}
 		}
-	};
-	const outReader = createLineReader(emit("stdout"));
-	const errReader = createLineReader(emit("stderr"));
-	child.stdout?.setEncoding?.("utf-8");
-	child.stderr?.setEncoding?.("utf-8");
-	child.stdout?.on("data", (chunk) => outReader.push(chunk));
-	child.stderr?.on("data", (chunk) => errReader.push(chunk));
-	let exited = false;
-	let exitInfo = null;
-	const listeners = [];
-	child.on("exit", (code, signal) => {
-		exited = true;
-		exitInfo = {
-			code,
-			signal
-		};
-		outReader.flush();
-		errReader.flush();
-		for (const cb of listeners) cb(exitInfo);
-	});
-	child.on("error", (err) => {
-		if (exited) return;
-		exited = true;
-		exitInfo = {
-			code: null,
-			signal: null,
-			error: err
-		};
-		for (const cb of listeners) cb(exitInfo);
 	});
-	return {
-		mode: "expo-child",
-		serverPid: child.pid ?? null,
-		child,
-		onExit(cb) {
-			if (exited) {
-				cb(exitInfo);
-				return;
-			}
-			listeners.push(cb);
-		},
-		async close() {
-			if (exited || !child.pid) return;
-			const dead = new Promise((resolve) => {
-				child.once("exit", () => resolve());
-			});
-			if (!child.kill("SIGTERM")) return;
-			await Promise.race([dead, delay(killTimeoutMs)]);
-			if (!exited) {
-				child.kill("SIGKILL");
-				await Promise.race([dead, delay(killTimeoutMs)]);
-			}
-		}
-	};
 }
 //#endregion
-export { expoProxyEnv as a, inferLevel as c, parseExpoWaitingOnUrl as d, recordFromLine as f, expoBinRefusal as i, isBundleMarker as l, expoBinFromPackage as n, expoSdkMajor as o, startExpoServer as p, expoBinPath as r, findBinUpward as s, cleanLine as t, isDevClientNavigationNotice as u };
+export { expoProxyEnv as a, inferLevel as c, parseExpoWaitingOnUrl as d, recordFromLine as f, expoBinRefusal as i, isBundleMarker as l, superviseChildServer as m, expoBinFromPackage as n, expoSdkMajor as o, startExpoServer as p, expoBinPath as r, findBinUpward as s, cleanLine as t, isDevClientNavigationNotice as u };

package/dist/server-expo-DV43vep4.mjs

@@ -0,0 +1,2 @@
+import { p as startExpoServer } from "./server-expo-CsYu2aKL.mjs";
+export { startExpoServer };

package/dist/{settings-CxgngUZk.mjs → settings-Bbztm4oV.mjs}

@@ -1,110 +1,12 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
-import { _ as loadConfig$1, d as getConfigDir, f as getConfigPath$1, h as getRepoSettings, m as getProjectSettings } from "./config-DC5jEtd1.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { _ as loadConfig$1, d as getConfigDir, f as getConfigPath$1, h as getRepoSettings, m as getProjectSettings } from "./config-D0LhTY3S.mjs";
 import { accessSync, chmodSync, constants, lstatSync, mkdirSync, mkdtempSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, relative as relative$1, resolve as resolve$1, sep as sep$1 } from "path";
-import { ANDROID_COMPILER_CACHE_CHOICES, ANDROID_PCH_CHOICES, REMOTE_DEVICE_BACKENDS, SETTINGS, SETTING_GROUPS, TUNNEL_MODES, WEB_VIEWPORTS, acceptsShape, coerceSettingText, expectedShape, isLayeredSetting, settingDefinition, settingValueError } from "@stim-cli/core/state";
-import { tmpdir } from "node:os";
+import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, normalize, relative as relative$1, resolve as resolve$1, sep as sep$1 } from "path";
+import { REMOTE_DEVICE_BACKENDS, SETTINGS, SETTING_GROUPS, TUNNEL_MODES, WEB_VIEWPORTS, acceptsShape, coerceSettingText, expectedShape, isLayeredSetting, settingDefinition, settingValueError } from "@stim-cli/core/state";
 import { chmodSync as chmodSync$1, existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, statSync as statSync$1, utimesSync as utimesSync$1 } from "fs";
 import { buildCacheRoot } from "@stim-cli/core";
-import { createHash } from "node:crypto";
-//#region src/optimizations.ts
-function compilerCacheFallbackMessage({ fallback, compilerCache, file = null }) {
-	const origin = fallback.fromEnvironment ? "the environment" : file;
-	const backend = compilerCache === "none" ? "Android builds use no compiler cache, because optimizations.android.compilerCache is \"none\"." : "Android builds fall back to ccache when it is available.";
-	return `${fallback.key}${origin ? ` in ${origin}` : ""} ${fallback.reason}. ${backend}`;
-}
-function optimizationBuildProfile(platform, options) {
-	const selected = platform === "ios" ? {
-		...options.ios,
-		swiftCompilationCache: options.ios.swiftCompilationCache ?? false
-	} : { pch: options.android.pch };
-	const defaults = platform === "ios" ? {
-		compilationCache: true,
-		swiftCompilationCache: false,
-		prefixMapping: true
-	} : { pch: "auto" };
-	if (JSON.stringify(selected) === JSON.stringify(defaults)) return void 0;
-	return `opt-${createHash("sha256").update(JSON.stringify(selected)).digest("hex").slice(0, 16)}`;
-}
-function resolveOptimizations(settings = {}, env = process.env) {
-	function choice(path, choices, fallback) {
-		const raw = optimizationValue(settings, path);
-		if (raw === void 0) return fallback;
-		if (typeof raw !== "string" || !choices.includes(raw)) throw new Error(`Invalid optimizations.${path}. Expected ${choices.join(", ")}.`);
-		return raw;
-	}
-	const compiler = choice("android.compilerCache", ANDROID_COMPILER_CACHE_CHOICES, "auto");
-	const fromEnvironment = Boolean(env.STIM_ANDROID_CAS_TOOLCHAIN);
-	const manifest = env.STIM_ANDROID_CAS_TOOLCHAIN || optimizationValue(settings, "android.casToolchain");
-	let fallback = null;
-	let toolchain = null;
-	if (manifest !== void 0) {
-		if (typeof manifest === "string" && isAbsolute(manifest) && !/[\r\n\0]/.test(manifest)) toolchain = manifest;
-		else fallback = {
-			key: fromEnvironment ? "STIM_ANDROID_CAS_TOOLCHAIN" : "optimizations.android.casToolchain",
-			reason: `is ${JSON.stringify(manifest)}, which is not an absolute path to a toolchain JSON manifest`,
-			fromEnvironment,
-			manifest: null
-		};
-	}
-	let compilerCache = compiler === "auto" ? toolchain ? "cas" : "ccache" : compiler;
-	if (compilerCache === "cas" && !toolchain) {
-		fallback ??= {
-			key: "optimizations.android.compilerCache",
-			reason: "is \"cas\", but no optimizations.android.casToolchain or STIM_ANDROID_CAS_TOOLCHAIN names the toolchain manifest",
-			fromEnvironment: false,
-			manifest: null
-		};
-		compilerCache = "ccache";
-	}
-	return {
-		buildCache: optimizationBoolean(settings, "buildCache"),
-		remoteBuildCache: optimizationBoolean(settings, "remoteBuildCache"),
-		releaseBundleSwap: optimizationBoolean(settings, "releaseBundleSwap"),
-		metroSharedCache: optimizationBoolean(settings, "metroSharedCache"),
-		metroWarmup: optimizationBoolean(settings, "metroWarmup"),
-		ios: {
-			compilationCache: optimizationBoolean(settings, "ios.compilationCache"),
-			swiftCompilationCache: optimizationValue(settings, "ios.swiftCompilationCache") === void 0 ? null : optimizationBoolean(settings, "ios.swiftCompilationCache"),
-			prefixMapping: optimizationBoolean(settings, "ios.prefixMapping")
-		},
-		android: {
-			compilerCache,
-			casToolchain: toolchain,
-			compilerCacheFallback: fallback,
-			pch: choice("android.pch", ANDROID_PCH_CHOICES, "auto"),
-			gradleBuildCache: optimizationBoolean(settings, "android.gradleBuildCache"),
-			targetAbiOnly: optimizationBoolean(settings, "android.targetAbiOnly")
-		}
-	};
-}
-function artifactCachePolicy(options, reuse, release) {
-	return {
-		read: reuse && options.buildCache && (!release || options.releaseBundleSwap),
-		write: options.buildCache,
-		remote: options.buildCache && options.remoteBuildCache
-	};
-}
-function optimizationValue(settings, path) {
-	let node = settings;
-	for (const key of ["optimizations", ...path.split(".")]) {
-		if (node === void 0) return void 0;
-		if (!node || typeof node !== "object" || Array.isArray(node)) throw new Error("Invalid optimizations setting. Expected nested objects.");
-		node = node[key];
-	}
-	return node;
-}
-function optimizationBoolean(settings, path, fallback = true) {
-	const raw = optimizationValue(settings, path);
-	if (raw === void 0) return fallback;
-	if (typeof raw !== "boolean") throw new Error(`Invalid optimizations.${path}. Expected true or false.`);
-	return raw;
-}
-function resolveMetroSharedCache(settings) {
-	return optimizationBoolean(settings, "metroSharedCache");
-}
-//#endregion
+import { tmpdir } from "node:os";
 //#region src/temporary.ts
 function existingPath(path) {
 	const missing = [];
@@ -904,8 +806,11 @@ function mergeSettingsLayers(layers) {
 	const out = {};
 	for (const layer of layers) {
 		if (!isPlainObject(layer)) continue;
-		for (const [key, value] of Object.entries(layer)) if (isPlainObject(value) && isPlainObject(out[key])) out[key] = mergeSettingsLayers([out[key], value]);
-		else if (!(key in out)) out[key] = value;
+		for (const [key, value] of Object.entries(layer)) {
+			if (key === "__proto__") continue;
+			if (isPlainObject(value) && isPlainObject(out[key])) out[key] = mergeSettingsLayers([out[key], value]);
+			else if (!(key in out)) out[key] = value;
+		}
 	}
 	return out;
 }
@@ -933,7 +838,7 @@ function settingShapeErrors(settings) {
 		if (SETTINGS_WITH_RESOLVE_TIME_FALLBACK.has(setting.key)) continue;
 		const value = settingValueAt(settings, setting.key);
 		if (value === void 0) continue;
-		const expected = setting.key === "ios.remote" || setting.key === "android.remote" || setting.type.kind === "number" && !BOUNDS_CHECKED_WHEN_USED.has(setting.key) ? settingValueError(setting, value) : acceptsShape(setting, value) ? null : expectedShape(setting.type);
+		const expected = setting.key === "ios.remote" || setting.key === "android.remote" || setting.key === "android.deviceProfile" || setting.type.kind === "number" && !BOUNDS_CHECKED_WHEN_USED.has(setting.key) ? settingValueError(setting, value) : acceptsShape(setting, value) ? null : expectedShape(setting.type);
 		if (expected) errors.push(`Invalid ${setting.key} setting ${JSON.stringify(value)}. Expected ${expected}.`);
 	}
 	return errors;
@@ -1087,6 +992,12 @@ function pathEscapesRoot(root, path) {
 	const child = relative$1(root, path);
 	return child === ".." || child.startsWith(`..${sep$1}`) || isAbsolute$1(child);
 }
+function realpathInside(root, path) {
+	const base = realpathSync$1(root);
+	const real = realpathSync$1(resolve$1(base, path));
+	if (pathEscapesRoot(base, real)) throw new Error(`it resolves outside ${base}`);
+	return real;
+}
 function androidAvdConfigSetting(settings, settingsRoot) {
 	if (!isPlainObject(settings) || !isPlainObject(settings.android)) return {};
 	const android = settings.android;
@@ -1126,6 +1037,132 @@ function androidAvdConfigSettingError(settings, projectPath) {
 		return String(error?.message || error);
 	}
 }
+function iosProjectDirSetting(settings, appRoot) {
+	const value = iosString(settings, "projectPath");
+	if (value === void 0 || typeof value === "string" && normalize(value).replace(/[\\/]+$/, "") === "ios") return {
+		dir: join$1(appRoot, "ios"),
+		relative: "ios",
+		custom: false
+	};
+	if (typeof value !== "string" || !value.trim() || value !== value.trim() || /[\r\n\0]/.test(value) || isAbsolute$1(value)) throw new Error("Invalid ios.projectPath setting. Expected a directory path relative to the app directory.");
+	try {
+		const root = realpathSync$1(appRoot);
+		const candidate = resolve$1(root, value);
+		if (pathEscapesRoot(root, candidate)) throw new Error("path escapes the app directory");
+		const dir = realpathSync$1(candidate);
+		if (pathEscapesRoot(root, dir)) throw new Error("symlink target escapes the app directory");
+		if (!statSync$1(dir).isDirectory()) throw new Error("path is not a directory");
+		if (!readdirSync$1(dir).some((name) => name.endsWith(".xcworkspace") || name.endsWith(".xcodeproj"))) throw new Error("it holds no .xcworkspace or .xcodeproj");
+		return {
+			dir,
+			relative: relative$1(root, dir) || ".",
+			custom: true
+		};
+	} catch (error) {
+		throw new Error(`Could not use ios.projectPath ${value}: ${String(error?.message || error)}`, { cause: error });
+	}
+}
+function iosProjectDirSettingError(settings, appRoot) {
+	try {
+		iosProjectDirSetting(settings, appRoot);
+		return null;
+	} catch (error) {
+		return String(error?.message || error);
+	}
+}
+const INVALID_IOS_PROJECT_DIR = "\0invalid ios.projectPath";
+const DEFAULT_ANDROID_GRADLE_ROOT = "android";
+const DEFAULT_ANDROID_MODULE = ":app";
+const ANDROID_MODULE = /^(:(?!\.\.?(?::|$))[A-Za-z0-9._-]+)+$/;
+function androidString(settings, key) {
+	if (!isPlainObject(settings) || !isPlainObject(settings.android)) return void 0;
+	return settings.android[key];
+}
+function hasGradleScript(dir, name) {
+	return existsSync$1(join$1(dir, `${name}.gradle`)) || existsSync$1(join$1(dir, `${name}.gradle.kts`));
+}
+function androidLayoutSetting(settings, appRoot, bound) {
+	const rootValue = androidString(settings, "gradleRoot");
+	const moduleValue = androidString(settings, "module");
+	if (!(rootValue !== void 0 && rootValue !== "android" || moduleValue !== void 0 && moduleValue !== ":app")) {
+		const gradleRoot = join$1(appRoot, DEFAULT_ANDROID_GRADLE_ROOT);
+		return {
+			gradleRoot,
+			gradleRootRelative: DEFAULT_ANDROID_GRADLE_ROOT,
+			module: DEFAULT_ANDROID_MODULE,
+			moduleDir: join$1(gradleRoot, "app"),
+			custom: false
+		};
+	}
+	const rawRoot = rootValue ?? "android";
+	if (typeof rawRoot !== "string" || !rawRoot.trim() || rawRoot !== rawRoot.trim() || /[\r\n\0]/.test(rawRoot) || isAbsolute$1(rawRoot)) throw new Error("Invalid android.gradleRoot setting. Expected a directory path relative to the app directory.");
+	const module = moduleValue ?? ":app";
+	if (typeof module !== "string" || !ANDROID_MODULE.test(module)) throw new Error(`Invalid android.module setting ${JSON.stringify(module)}. Expected a Gradle project path such as :app.`);
+	try {
+		const app = realpathSync$1(appRoot);
+		const limit = realpathSync$1(bound);
+		const gradleRoot = realpathSync$1(resolve$1(app, rawRoot));
+		if (pathEscapesRoot(limit, gradleRoot)) throw new Error(`it resolves outside ${limit}`);
+		if (!statSync$1(gradleRoot).isDirectory()) throw new Error("it is not a directory");
+		if (!hasGradleScript(gradleRoot, "settings")) throw new Error("it holds no settings.gradle or settings.gradle.kts");
+		const mapped = join$1(gradleRoot, ...module.split(":").filter(Boolean));
+		if (!hasGradleScript(mapped, "build")) throw new Error(`module ${module} has no build.gradle or build.gradle.kts at ${mapped}`);
+		const moduleDir = realpathSync$1(mapped);
+		if (pathEscapesRoot(limit, moduleDir)) throw new Error(`module ${module} resolves outside ${limit}`);
+		return {
+			gradleRoot,
+			gradleRootRelative: relative$1(app, gradleRoot).split(sep$1).join("/") || ".",
+			module,
+			moduleDir,
+			custom: true
+		};
+	} catch (error) {
+		throw new Error(`Could not use android.gradleRoot ${rawRoot}: ${String(error?.message || error)}`, { cause: error });
+	}
+}
+function androidLayoutSettingError(settings, appRoot, bound) {
+	try {
+		androidLayoutSetting(settings, appRoot, bound);
+		return null;
+	} catch (error) {
+		return String(error?.message || error);
+	}
+}
+const INVALID_ANDROID_GRADLE_ROOT = "\0invalid android.gradleRoot";
+function defaultAndroidLayout(appRoot) {
+	return androidLayoutSetting({}, appRoot, appRoot);
+}
+function resolveAndroidLayout(settings, root, bound) {
+	if (settings === null) return defaultAndroidLayout(root);
+	try {
+		return androidLayoutSetting(settings, root, bound);
+	} catch {
+		const gradleRoot = join$1(root, INVALID_ANDROID_GRADLE_ROOT);
+		return {
+			gradleRoot,
+			gradleRootRelative: INVALID_ANDROID_GRADLE_ROOT,
+			module: DEFAULT_ANDROID_MODULE,
+			moduleDir: join$1(gradleRoot, "app"),
+			custom: true
+		};
+	}
+}
+function resolveIosProjectDir(settings, root) {
+	if (settings === null) return {
+		dir: join$1(root, "ios"),
+		relative: "ios",
+		custom: false
+	};
+	try {
+		return iosProjectDirSetting(settings, root);
+	} catch {
+		return {
+			dir: join$1(root, INVALID_IOS_PROJECT_DIR),
+			relative: INVALID_IOS_PROJECT_DIR,
+			custom: true
+		};
+	}
+}
 function iosSimSlimProfileSetting(settings, settingsRoot) {
 	if (!isPlainObject(settings) || !isPlainObject(settings.ios) || !("simslimProfile" in settings.ios)) return null;
 	const value = settings.ios.simslimProfile;
@@ -1276,18 +1313,38 @@ function settingFile(context, dottedKey) {
 function resolveSettings(context) {
 	return mergeSettingsLayers(settingsLayers(context).map((layer) => layer.settings));
 }
-function settingsForProject(root) {
-	return resolveSettings({
+function projectSettingsContext(root, git = {
+	gitCommonDir,
+	repoRoot
+}) {
+	return {
 		projectPath: root,
-		gitCommonDir: gitCommonDir(root),
-		repoRoot: repoRoot(root) ?? root
-	});
+		gitCommonDir: git.gitCommonDir(root),
+		repoRoot: git.repoRoot(root)
+	};
+}
+function resolveProjectSettings(root) {
+	const context = projectSettingsContext(root);
+	return {
+		context,
+		settings: resolveSettings(context)
+	};
 }
-function projectOptimizations(root) {
-	return resolveOptimizations(settingsForProject(root));
+const METRO_COMMAND_PORT = "{port}";
+function metroCommandSetting(settings) {
+	const value = settingValueAt(settings, "metro.command");
+	if (!Array.isArray(value) || !value.every((arg) => typeof arg === "string")) return null;
+	return typeof value[0] === "string" && value[0].trim() !== "" ? value : null;
+}
+function metroCommandSettingError(settings) {
+	if (settingValueAt(settings, "metro.command") === void 0) return null;
+	const command = metroCommandSetting(settings);
+	if (!command) return "metro.command must be a non-empty array of strings whose first entry is the program to run.";
+	if (!command.some((arg) => arg.includes("{port}"))) return `metro.command must pass ${METRO_COMMAND_PORT} so the dev server listens on this workspace's reserved port.`;
+	return null;
 }
-function projectMetroSharedCache(root) {
-	return resolveMetroSharedCache(settingsForProject(root));
+function runnableMetroCommand(settings) {
+	return metroCommandSettingError(settings) ? null : metroCommandSetting(settings);
 }
 function cacheBlock(layer) {
 	if (!isPlainObject(layer) || !isPlainObject(layer.cache)) return null;
@@ -1374,16 +1431,9 @@ function deviceIdleShutdownMinutesSetting(settings) {
 function deviceReclaimIdleMinutesSetting(settings) {
 	return minutesSetting(settings, "devices", "reclaimIdleMinutes");
 }
-function projectMaintenancePinned(root) {
-	try {
-		const value = settingValueAt(settingsForProject(root), "maintenance.keep");
-		return value !== void 0 && value !== false;
-	} catch {
-		return true;
-	}
-}
-function projectDeviceReclaimIdleMinutes(root) {
-	return deviceReclaimIdleMinutesSetting(settingsForProject(root));
+function maintenanceKeepSetting(settings) {
+	const value = settingValueAt(settings, "maintenance.keep");
+	return value !== void 0 && value !== false;
 }
 function tunnelModeSetting(settings) {
 	const block = settings.metro;
@@ -1393,15 +1443,15 @@ function tunnelModeSetting(settings) {
 }
 function metroTunnelSettingError(settings) {
 	const block = settings.metro;
-	if (!isPlainObject(block) || !("ngrokUrl" in block)) return null;
+	if (!isPlainObject(block) || block.ngrokUrl === void 0) return null;
 	if (block.tunnel !== "ngrok") return "metro.ngrokUrl requires metro.tunnel to be \"ngrok\".";
 	if (normalizedHttpsUrl(block.ngrokUrl) === null) return "metro.ngrokUrl must be a valid HTTPS URL.";
 	return null;
 }
-function metroPortSetting(projectPath, env = process.env) {
+function metroPortSetting(settings, env = process.env) {
 	const setting = settingDefinition("metro.port");
 	const fromEnv = env.STIM_METRO_PORT?.trim();
-	const value = fromEnv ? coerceSettingText(setting, fromEnv) : settingValueAt(settingsForProject(projectPath), "metro.port");
+	const value = fromEnv ? coerceSettingText(setting, fromEnv) : settingValueAt(settings, "metro.port");
 	if (value === void 0) return {
 		port: null,
 		error: null
@@ -1450,4 +1500,4 @@ function webSettings(settings) {
 	};
 }
 //#endregion
-export { depsOutOfSync as $, publicUrlSetting as A, settingShapeErrors as B, metroWarmupUrlSetting as C, removeTemporaryEntry as Ct, projectMaintenancePinned as D, optimizationBuildProfile as Dt, projectDeviceReclaimIdleMinutes as E, compilerCacheFallbackMessage as Et, resolveCacheProviderConfig as F, webSettings as G, settingsLayers as H, resolveSettings as I, planMetroReach as J, PUBLIC_METRO_ENV as K, settingFile as L, remoteAndroidSetting as M, remoteEasFallbackSetting as N, projectMetroSharedCache as O, resolveOptimizations as Ot, remoteIosSetting as P, deleteBranch as Q, settingOrigin as R, metroTunnelSettingError as S, makeTemporaryDirectory as St, parseIosRemote as T, artifactCachePolicy as Tt, tunnelModeSetting as U, settingValueAt as V, unknownSettingKeys as W, branchExists as X, resolveTailscaleBinary as Y, cloneIgnoredEntries as Z, iosSigningIdentitySha1SettingError as _, restoreFile as _t, androidAvdConfigSetting as a, hasRemote as at, metroIdleStopMinutesSetting as b, warmWorktreePaths as bt, androidDataPartitionSizeGbSetting as c, linkedWorktreesOnDisk as ct, deviceIdleShutdownMinutesSetting as d, podsOutOfSync as dt, dirtyFingerprintFiles as et, iosLanHostSetting as f, readWorktreeExclude as ft, iosSigningIdentitySha1Setting as g, resolveSourceCheckout as gt, iosSigningIdentitySettingError as h, resolveFullRef as ht, SETTING_SHAPE_REMEDY as i, hasPopulatedSubmodules as it, readCommittedSettings as j, projectOptimizations as k, androidDataPartitionSizeGbSettingError as l, listWorktrees as lt, iosSigningIdentitySetting as m, repoRoot as mt, PATH_SETTINGS as n, gitCommonDir as nt, androidAvdConfigSettingError as o, hasUncommittedWork as ot, iosLanHostSettingError as p, removeWorktree as pt, detectProviders as q, SETTINGS_WITH_RESOLVE_TIME_FALLBACK as r, gitCommonDirOnDisk as rt, androidDataPartitionSizeBytes as s, isPodInstallChurn as st, ANDROID_AVD_CONFIG_HELP as t, dirtyPaths as tt, cacheProviderSettingError as u, locallyKnownUpstream as ut, iosSimSlimProfileSetting as v, sourceCheckoutOf as vt, ngrokUrlSetting as w, temporaryRoot as wt, metroPortSetting as x, filesystemDevice as xt, mergeSettingsLayers as y, unpushedCommits as yt, settingOriginScope as z };
+export { settingValueAt as $, metroIdleStopMinutesSetting as A, sourceCheckoutOf as At, remoteAndroidSetting as B, iosSigningIdentitySha1Setting as C, podsOutOfSync as Ct, mergeSettingsLayers as D, resolveFullRef as Dt, maintenanceKeepSetting as E, repoRoot as Et, parseIosRemote as F, removeTemporaryEntry as Ft, resolveIosProjectDir as G, remoteIosSetting as H, projectSettingsContext as I, temporaryRoot as It, runnableMetroCommand as J, resolveProjectSettings as K, publicUrlSetting as L, metroTunnelSettingError as M, warmWorktreePaths as Mt, metroWarmupUrlSetting as N, filesystemDevice as Nt, metroCommandSetting as O, resolveSourceCheckout as Ot, ngrokUrlSetting as P, makeTemporaryDirectory as Pt, settingShapeErrors as Q, readCommittedSettings as R, iosSigningIdentitySettingError as S, locallyKnownUpstream as St, iosSimSlimProfileSetting as T, removeWorktree as Tt, resolveAndroidLayout as U, remoteEasFallbackSetting as V, resolveCacheProviderConfig as W, settingOrigin as X, settingFile as Y, settingOriginScope as Z, iosLanHostSetting as _, hasRemote as _t, SETTING_SHAPE_REMEDY as a, detectProviders as at, iosProjectDirSettingError as b, linkedWorktreesOnDisk as bt, androidDataPartitionSizeBytes as c, branchExists as ct, androidLayoutSetting as d, depsOutOfSync as dt, settingsLayers as et, androidLayoutSettingError as f, dirtyFingerprintFiles as ft, deviceReclaimIdleMinutesSetting as g, hasPopulatedSubmodules as gt, deviceIdleShutdownMinutesSetting as h, gitCommonDirOnDisk as ht, SETTINGS_WITH_RESOLVE_TIME_FALLBACK as i, PUBLIC_METRO_ENV as it, metroPortSetting as j, unpushedCommits as jt, metroCommandSettingError as k, restoreFile as kt, androidDataPartitionSizeGbSetting as l, cloneIgnoredEntries as lt, defaultAndroidLayout as m, gitCommonDir as mt, METRO_COMMAND_PORT as n, unknownSettingKeys as nt, androidAvdConfigSetting as o, planMetroReach as ot, cacheProviderSettingError as p, dirtyPaths as pt, resolveSettings as q, PATH_SETTINGS as r, webSettings as rt, androidAvdConfigSettingError as s, resolveTailscaleBinary as st, ANDROID_AVD_CONFIG_HELP as t, tunnelModeSetting as tt, androidDataPartitionSizeGbSettingError as u, deleteBranch as ut, iosLanHostSettingError as v, hasUncommittedWork as vt, iosSigningIdentitySha1SettingError as w, readWorktreeExclude as wt, iosSigningIdentitySetting as x, listWorktrees as xt, iosProjectDirSetting as y, isPodInstallChurn as yt, realpathInside as z };