stim 1.3.1 → 1.4.0

package/dist/xcode-D9tVItl-.mjs

@@ -0,0 +1,860 @@
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { r as register } from "./cache-manifest-D02TpYjA.mjs";
+import { d as sharedCompilationCache, m as workspaceDerivedData } from "./workspace-state-Do1e2mOH.mjs";
+import { t as createLineReader } from "./process-output-C7IlIzd7.mjs";
+import { a as formatElapsed, l as phaseLine } from "./command-output-BuIb_ZOI.mjs";
+import { U as resolveOptimizations } from "./settings-DwfltIXQ.mjs";
+import { t as cleanLine } from "./server-expo-D4P7iTvf.mjs";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
+import chalk from "chalk";
+//#region src/engine/bundler.ts
+const COCOAPODS_SPEC = /^ {4}cocoapods \(/m;
+function bundlerPin(root) {
+	const gemfile = join(root, "Gemfile");
+	const lockfile = join(root, "Gemfile.lock");
+	if (!existsSync(gemfile)) return null;
+	let lock;
+	try {
+		lock = readFileSync(lockfile, "utf-8");
+	} catch {
+		return null;
+	}
+	if (!COCOAPODS_SPEC.test(lock)) return null;
+	return {
+		gemfile,
+		lockfile
+	};
+}
+function podInstallCommand(root, ...args) {
+	const pod = [
+		"pod",
+		"install",
+		...args
+	].join(" ");
+	return bundlerPin(root) ? `bundle exec ${pod}` : pod;
+}
+const BUILD_FAILED = "** BUILD FAILED **";
+const POSITIONED = /^(\S[^\t]*?):(\d+):(?:(\d+):)?\s*(?:fatal\s+)?error:\s+(.+)$/;
+const UNPOSITIONED = /^(\S[^\t]*?)?\berror:\s+(.+)$/;
+const LD_ERROR = /^ld:\s+(?!warning:)(.+)$/;
+const UNDEFINED_HEADER = /^(?:ld:\s+)?Undefined symbols?(?:\s+for architecture\s+\S+)?:\s*$/;
+const UNDEFINED_SYMBOL = /^\s+"?([^",]+)"?,\s+referenced from:\s*$/;
+function undefinedSymbolMessage(symbol) {
+	return `Undefined symbol: ${symbol}`;
+}
+const PODS_OUT_OF_SYNC = /The sandbox is not in sync with the Podfile\.lock/;
+const SIGNING = [
+	/No profiles for '.*' were found/,
+	/requires a development team/i,
+	/[Cc]ode ?[Ss]igning [Ee]rror/,
+	/No signing certificate/i,
+	/code signing is required/i,
+	/errSecInternalComponent/,
+	/Provisioning profile .* doesn't (?:include|match)/i
+];
+const NO_SUCH_SCHEME = /does not contain a scheme named/;
+const CAS_CORRUPT = /not a IncludeTreeRoot node kind/;
+const DEVICE_SIGNING_REMEDY = "Set a team and a Development profile for the target's configuration in Xcode > Signing & Capabilities, then build once from Xcode to install the profile. Stim never passes -allowProvisioningUpdates, because registering a device or minting a profile changes your Apple Developer account.";
+const SIMULATOR_SIGNING_REMEDY = "Stim builds for the simulator here, which needs no signing. Check CODE_SIGNING_REQUIRED / DEVELOPMENT_TEAM in the target's configuration, or build for a phone with `stim ios --device`.";
+function remedyFor(message, root, sdk) {
+	if (CAS_CORRUPT.test(message)) return "The compilation cache holds a damaged object. Run `stim gc --delete --cache \"compilation cache\"` to empty that cache, then build again. The next build is a cold one.";
+	if (PODS_OUT_OF_SYNC.test(message)) return `Run \`${root ? podInstallCommand(root) : "pod install"}\` in ios/ (stim ios does this when Podfile.lock and Pods/Manifest.lock disagree), then build again.`;
+	if (NO_SUCH_SCHEME.test(message)) return "Run `xcodebuild -list` in ios/ to see the schemes this project defines, and share the app scheme so it is visible to the build.";
+	for (const pattern of SIGNING) if (pattern.test(message)) return sdk.startsWith("iphoneos") ? DEVICE_SIGNING_REMEDY : SIMULATOR_SIGNING_REMEDY;
+	return null;
+}
+function fileFromPrefix(prefix) {
+	const trimmed = String(prefix).trim().replace(/:$/, "");
+	if (!trimmed) return null;
+	const head = (trimmed.split(": ")[0] ?? "").trim();
+	if (!head.includes("/")) return null;
+	return head;
+}
+function makeDiagnostic({ file = null, line = null, column = null, message }, root, sdk) {
+	const text = String(message).trim();
+	const out = { message: text };
+	if (file) out.file = file;
+	if (line !== null && line !== void 0) out.line = line;
+	if (column !== null && column !== void 0) out.column = column;
+	out.message = text;
+	const remedy = remedyFor(text, root, sdk);
+	if (remedy) out.remedy = remedy;
+	return out;
+}
+function dedupeKey(d) {
+	return `${d.file || ""}|${d.line || ""}|${d.column || ""}|${d.message}`;
+}
+function extractXcodeDiagnostics(transcript, root = null, sdk = "iphonesimulator") {
+	if (typeof transcript !== "string" || transcript === "") return [];
+	const lines = transcript.split("\n");
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	const push = (d) => {
+		const key = dedupeKey(d);
+		if (seen.has(key)) return;
+		seen.add(key);
+		out.push(d);
+	};
+	for (let i = 0; i < lines.length; i += 1) {
+		const rawLine = lines[i];
+		if (rawLine === void 0) continue;
+		const raw = rawLine.replace(/\r$/, "");
+		if (raw.includes(BUILD_FAILED)) break;
+		if (UNDEFINED_HEADER.test(raw)) {
+			for (let j = i + 1; j < lines.length; j += 1) {
+				const symLine = lines[j];
+				if (symLine === void 0) continue;
+				const sym = UNDEFINED_SYMBOL.exec(symLine.replace(/\r$/, ""));
+				if (sym) {
+					const symbol = sym[1];
+					if (symbol !== void 0) push(makeDiagnostic({ message: undefinedSymbolMessage(symbol) }, root, sdk));
+					continue;
+				}
+				if (/^\s+\S/.test(symLine) && !/^\S/.test(symLine)) continue;
+				i = j - 1;
+				break;
+			}
+			continue;
+		}
+		const ld = LD_ERROR.exec(raw);
+		if (ld) {
+			push(makeDiagnostic({ message: `ld: ${ld[1]}` }, root, sdk));
+			continue;
+		}
+		const positioned = POSITIONED.exec(raw);
+		if (positioned) {
+			const posMsg = positioned[4];
+			if (posMsg === void 0) continue;
+			push(makeDiagnostic({
+				file: positioned[1],
+				line: Number(positioned[2]),
+				column: positioned[3] === void 0 ? null : Number(positioned[3]),
+				message: posMsg
+			}, root, sdk));
+			continue;
+		}
+		const plain = UNPOSITIONED.exec(raw);
+		if (plain) {
+			const plainMsg = plain[2];
+			if (plainMsg === void 0) continue;
+			push(makeDiagnostic({
+				file: fileFromPrefix(plain[1] || ""),
+				message: plainMsg
+			}, root, sdk));
+		}
+	}
+	return out;
+}
+function capDiagnostics(diagnostics, max = 10) {
+	const list = Array.isArray(diagnostics) ? diagnostics : [];
+	if (list.length <= max) return {
+		diagnostics: list.slice(),
+		truncated: 0
+	};
+	return {
+		diagnostics: list.slice(0, max),
+		truncated: list.length - max
+	};
+}
+function describeDiagnostic(diagnostic) {
+	if (!diagnostic || typeof diagnostic !== "object") return "";
+	const { file, line, column, message } = diagnostic;
+	if (!file) return String(message ?? "");
+	return `${file}${line ? column ? `:${line}:${column}` : `:${line}` : ""}: ${message}`;
+}
+//#endregion
+//#region src/engine/xcode.ts
+const IOS_DIR = "ios";
+const PREBUILD_REMEDY = "Generate it with `npx expo prebuild -p ios` (stim ios does this automatically for an Expo project with no ios/ directory), or commit the native project.";
+function buildFailure(message, remedy) {
+	return { error: {
+		code: "STIM_BUILD_FAILED",
+		message,
+		remedy
+	} };
+}
+function pickXcodeProject(entries) {
+	const names = (Array.isArray(entries) ? entries : []).filter((e) => typeof e === "string");
+	const workspaces = names.filter((e) => e.endsWith(".xcworkspace")).toSorted();
+	const projects = names.filter((e) => e.endsWith(".xcodeproj")).toSorted();
+	if (workspaces.length > 0) {
+		const projectNames = new Set(projects.map((p) => basename(p, ".xcodeproj")));
+		const file = workspaces.find((w) => projectNames.has(basename(w, ".xcworkspace"))) || workspaces[0];
+		if (file === void 0) return null;
+		return {
+			kind: "workspace",
+			flag: "-workspace",
+			file,
+			name: basename(file, ".xcworkspace")
+		};
+	}
+	if (projects.length > 0) {
+		const file = projects[0];
+		if (file === void 0) return null;
+		return {
+			kind: "project",
+			flag: "-project",
+			file,
+			name: basename(file, ".xcodeproj")
+		};
+	}
+	return null;
+}
+function discoverXcodeProject(root) {
+	const dir = join(root, IOS_DIR);
+	let entries;
+	try {
+		entries = readdirSync(dir);
+	} catch {
+		return buildFailure(`No ${IOS_DIR}/ directory in ${root}.`, PREBUILD_REMEDY);
+	}
+	const picked = pickXcodeProject(entries);
+	if (!picked) return buildFailure(`${dir} contains no .xcworkspace and no .xcodeproj.`, PREBUILD_REMEDY);
+	return {
+		...picked,
+		dir,
+		path: join(dir, picked.file)
+	};
+}
+function parseSchemeList(text) {
+	const empty = {
+		name: null,
+		schemes: []
+	};
+	if (typeof text !== "string") return empty;
+	const start = text.indexOf("{");
+	const end = text.lastIndexOf("}");
+	if (start < 0 || end <= start) return empty;
+	let data;
+	try {
+		data = JSON.parse(text.slice(start, end + 1));
+	} catch {
+		return empty;
+	}
+	if (!data || typeof data !== "object") return empty;
+	const record = data;
+	const container = record.workspace || record.project;
+	if (!container || typeof container !== "object") return empty;
+	const info = container;
+	const schemes = Array.isArray(info.schemes) ? info.schemes.filter((s) => typeof s === "string" && s.trim() !== "") : [];
+	return {
+		name: typeof info.name === "string" ? info.name : null,
+		schemes
+	};
+}
+const TEST_SCHEME = /(?:UI)?Tests$/;
+function pickScheme(schemes, containerName) {
+	const list = (Array.isArray(schemes) ? schemes : []).filter((s) => typeof s === "string" && s.trim() !== "");
+	if (list.length === 0) return null;
+	const name = typeof containerName === "string" ? containerName.trim() : "";
+	if (name) {
+		const exact = list.find((s) => s === name);
+		if (exact) return exact;
+		const insensitive = list.find((s) => s.toLowerCase() === name.toLowerCase());
+		if (insensitive) return insensitive;
+	}
+	const app = list.filter((s) => !TEST_SCHEME.test(s));
+	return app.length === 1 ? app[0] : null;
+}
+const LIST_TIMEOUT_MS = 18e4;
+function listSchemes(project, { exec = null } = {}) {
+	const executor = exec || getExecutor();
+	try {
+		return parseSchemeList(executor.runFile("xcodebuild", [
+			project.flag,
+			project.path,
+			"-list",
+			"-json"
+		], { timeoutMs: LIST_TIMEOUT_MS }));
+	} catch {
+		return null;
+	}
+}
+function resolveScheme(project, { exec = null, scheme: requested = null } = {}) {
+	const listing = listSchemes(project, { exec });
+	if (listing === null) return { error: {
+		code: "STIM_NO_SCHEME",
+		message: `Could not list schemes for ${project.path}.`,
+		remedy: `Run \`xcodebuild ${project.flag} ${project.path} -list\` to see what it reports.`
+	} };
+	if (requested !== null) {
+		if (listing.schemes.includes(requested)) return {
+			scheme: requested,
+			schemes: listing.schemes
+		};
+		return { error: {
+			code: "STIM_NO_SCHEME",
+			message: `No shared Xcode scheme named ${JSON.stringify(requested)} in ${project.path}. Available schemes: ${listing.schemes.join(", ") || "none"}.`,
+			remedy: "Pass an exact available name with --scheme, or share the intended app scheme in Xcode."
+		} };
+	}
+	let scheme = pickScheme(listing.schemes, listing.name || project.name);
+	if (!scheme && project.dir) try {
+		const app = JSON.parse(readFileSync(join(project.dir, "..", "app.json"), "utf8"));
+		scheme = pickScheme(listing.schemes, app?.name);
+	} catch {}
+	if (!scheme) {
+		const found = listing.schemes.length ? listing.schemes.join(", ") : "none";
+		return { error: {
+			code: "STIM_NO_SCHEME",
+			message: `Could not select an app scheme in ${project.path} (schemes: ${found}).`,
+			remedy: listing.schemes.length > 0 ? "Pass --scheme <name> to select the intended shared app scheme. Stim does not guess between unmatched schemes." : "Share the app scheme in Xcode (Product > Scheme > Manage Schemes, tick Shared) so xcodebuild can see it."
+		} };
+	}
+	return {
+		scheme,
+		schemes: listing.schemes
+	};
+}
+const PREFIX_MAP_TARGET = "/^src";
+function prefixMapping(workspaceRoot) {
+	return `${String(workspaceRoot).replace(/\/+$/, "")}=${PREFIX_MAP_TARGET}`;
+}
+function compilationPrefixMappings(workspaceRoot, derivedDataPath) {
+	const source = resolve(workspaceRoot);
+	const derived = resolve(derivedDataPath);
+	const mappings = [prefixMapping(source)];
+	const rel = relative(source, derived);
+	if (rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel)) mappings.push(`${derived}=/^derived-data`);
+	return mappings.join(" ");
+}
+function ccacheEnabled(podfileProperties) {
+	if (!podfileProperties || typeof podfileProperties !== "object") return false;
+	return podfileProperties["apple.ccacheEnabled"] === "true";
+}
+function readPodfileProperties(root) {
+	try {
+		const parsed = JSON.parse(readFileSync(join(root, IOS_DIR, "Podfile.properties.json"), "utf-8"));
+		return parsed && typeof parsed === "object" ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+function compilationCacheSettings({ workspaceRoot, derivedDataPath, casPath, xcodeMajor, ccache = false, optimizations = resolveOptimizations({}, {}).ios }) {
+	if (xcodeMajor === null || xcodeMajor === void 0) return [];
+	if (xcodeMajor < 26) return [];
+	if (ccache) return [];
+	return [
+		`COMPILATION_CACHE_ENABLE_CACHING=${optimizations.compilationCache ? "YES" : "NO"}`,
+		`COMPILATION_CACHE_CAS_PATH=${casPath}`,
+		`SWIFT_ENABLE_COMPILE_CACHE=${optimizations.compilationCache && optimizations.swiftCompilationCache ? "YES" : "NO"}`,
+		`CLANG_ENABLE_PREFIX_MAPPING=${optimizations.prefixMapping ? "YES" : "NO"}`,
+		`CLANG_OTHER_PREFIX_MAPPINGS=${optimizations.prefixMapping ? compilationPrefixMappings(workspaceRoot, derivedDataPath) : ""}`
+	];
+}
+function parseXcodeMajor(output) {
+	const m = /^Xcode\s+(\d+)/m.exec(String(output || ""));
+	if (!m) return null;
+	const digits = m[1];
+	if (digits === void 0) return null;
+	const major = parseInt(digits, 10);
+	return Number.isFinite(major) ? major : null;
+}
+function detectXcodeMajor(exec = null) {
+	return parseXcodeMajor((exec || getExecutor()).runQuiet("xcodebuild -version", { timeoutMs: 1e4 }));
+}
+function resolveCompilationCacheSettings({ root, derivedDataPath, exec = null, casPath = sharedCompilationCache(), optimizations = resolveOptimizations({}, {}).ios, onNote = (line) => console.error(line) }) {
+	const settings = compilationCacheSettings({
+		workspaceRoot: root,
+		derivedDataPath,
+		casPath,
+		xcodeMajor: detectXcodeMajor(exec),
+		ccache: ccacheEnabled(readPodfileProperties(root)),
+		optimizations
+	});
+	if (settings.length > 0 && optimizations.compilationCache) {
+		register({
+			dir: casPath,
+			name: "Xcode compilation cache",
+			prune: "atomic",
+			note: "shared Xcode compilation cache"
+		});
+		onNote(chalk.dim(phaseLine("cache", `compilation cache on (CAS at ${casPath})`)));
+	}
+	return settings;
+}
+function xcodebuildArgs({ project, scheme, udid = null, destination = null, configuration = "Debug", sdk = "iphonesimulator", derivedDataPath, extraArgs = [], buildSettings = [] }) {
+	return [
+		project.flag,
+		project.path,
+		"-scheme",
+		scheme,
+		"-configuration",
+		configuration,
+		"-sdk",
+		sdk,
+		"-destination",
+		destination || `id=${udid}`,
+		"-derivedDataPath",
+		derivedDataPath,
+		...extraArgs,
+		"build",
+		...buildSettings
+	];
+}
+function productsDir(derivedDataPath, { configuration = "Debug", sdk = "iphonesimulator" } = {}) {
+	return join(derivedDataPath, "Build", "Products", `${configuration}-${sdk}`);
+}
+function pickAppBundle(entries, preferredName = null) {
+	const apps = (Array.isArray(entries) ? entries : []).filter((e) => typeof e === "string" && e.endsWith(".app")).toSorted();
+	if (apps.length === 0) return null;
+	if (preferredName) {
+		const wanted = `${preferredName}.app`;
+		const exact = apps.find((a) => a === wanted);
+		if (exact) return exact;
+	}
+	return apps[0];
+}
+function findAppBundle(dir, preferredName = null) {
+	let entries;
+	try {
+		entries = readdirSync(dir);
+	} catch {
+		return null;
+	}
+	const app = pickAppBundle(entries, preferredName);
+	return app ? join(dir, app) : null;
+}
+function parseBundleId(plistJson) {
+	if (typeof plistJson !== "string") return null;
+	let data;
+	try {
+		data = JSON.parse(plistJson);
+	} catch {
+		return null;
+	}
+	if (!data || typeof data !== "object") return null;
+	const id = data.CFBundleIdentifier;
+	return typeof id === "string" && id.trim() !== "" ? id.trim() : null;
+}
+function readBundleId(appPath, { exec = null } = {}) {
+	const executor = exec || getExecutor();
+	try {
+		const id = parseBundleId(executor.runFile("plutil", [
+			"-convert",
+			"json",
+			"-o",
+			"-",
+			join(appPath, "Info.plist")
+		]));
+		if (id) return id;
+	} catch {}
+	try {
+		const value = executor.runFile("defaults", [
+			"read",
+			join(appPath, "Info"),
+			"CFBundleIdentifier"
+		]);
+		const trimmed = String(value).trim();
+		return trimmed === "" ? null : trimmed;
+	} catch {
+		return null;
+	}
+}
+function parseBundleExecutable(plistJson) {
+	if (typeof plistJson !== "string") return null;
+	let data;
+	try {
+		data = JSON.parse(plistJson);
+	} catch {
+		return null;
+	}
+	if (!data || typeof data !== "object") return null;
+	const name = data.CFBundleExecutable;
+	return typeof name === "string" && name.trim() !== "" ? name.trim() : null;
+}
+function readBundleExecutable(appPath, { exec = null } = {}) {
+	const executor = exec || getExecutor();
+	try {
+		const name = parseBundleExecutable(executor.runFile("plutil", [
+			"-convert",
+			"json",
+			"-o",
+			"-",
+			join(appPath, "Info.plist")
+		]));
+		if (name) return name;
+	} catch {}
+	try {
+		const value = executor.runFile("defaults", [
+			"read",
+			join(appPath, "Info"),
+			"CFBundleExecutable"
+		]);
+		const trimmed = String(value).trim();
+		return trimmed === "" ? null : trimmed;
+	} catch {
+		return null;
+	}
+}
+function tailLines(lines, count = 5) {
+	return (Array.isArray(lines) ? lines : []).filter((l) => typeof l === "string" && l.trim() !== "").slice(-count);
+}
+const HEARTBEAT_INTERVAL_MS = 3e4;
+const HEARTBEAT_ACTIVITY = {
+	build: "compiling",
+	deps: "installing",
+	pods: "installing"
+};
+function heartbeatLine(elapsedMs, label = "build", estimateMs = null) {
+	const activity = HEARTBEAT_ACTIVITY[label] ?? "running";
+	const elapsed = formatElapsed(elapsedMs);
+	const inside = estimateMs && estimateMs > 0 ? elapsedMs > estimateMs ? `${elapsed}, usually ~${formatElapsed(estimateMs)}` : `${elapsed} of ~${formatElapsed(estimateMs)}` : elapsed;
+	return phaseLine(label, `still ${activity} (${inside})`);
+}
+const defaultSchedule = (run, delayMs) => {
+	const timer = setTimeout(run, delayMs);
+	timer.unref?.();
+	return () => clearTimeout(timer);
+};
+function startBuildHeartbeat({ intervalMs, elapsed, emit, label = "build", estimateMs = null, schedule = defaultSchedule }) {
+	if (!(intervalMs > 0)) return () => {};
+	let stopped = false;
+	let lastBeat = 0;
+	let cancel = null;
+	function tick() {
+		if (stopped) return;
+		const ms = elapsed();
+		const beat = Math.floor(ms / intervalMs) * intervalMs;
+		if (beat > lastBeat) {
+			lastBeat = beat;
+			emit(heartbeatLine(beat, label, estimateMs));
+		}
+		cancel = schedule(tick, intervalMs - ms % intervalMs);
+	}
+	cancel = schedule(tick, intervalMs);
+	return () => {
+		stopped = true;
+		cancel?.();
+	};
+}
+function failedResult({ code, diagnostics, durationMs, exitCode = null, transcriptLines = 0, tail = [], compilationCache = COMPILATION_CACHE_UNAVAILABLE }) {
+	const capped = capDiagnostics(diagnostics);
+	return {
+		ok: false,
+		code,
+		diagnostics: capped.diagnostics,
+		truncated: capped.truncated,
+		durationMs,
+		exitCode,
+		transcriptLines,
+		tail,
+		compilationCache
+	};
+}
+const COMPILATION_CACHE_UNAVAILABLE = {
+	status: "unavailable",
+	hits: null,
+	cacheableTasks: null,
+	hitRatePercent: null
+};
+const COMPILATION_CACHE_NOT_RUN = {
+	status: "not-run",
+	hits: null,
+	cacheableTasks: null,
+	hitRatePercent: null
+};
+function parseCompilationCacheActivity(line) {
+	if (typeof line !== "string") return null;
+	const match = line.match(/(?:note:\s*)?(\d+) hits \/ (\d+) cacheable tasks \((\d+(?:\.\d+)?)%\)/);
+	if (!match) return null;
+	return {
+		status: "reported",
+		hits: Number(match[1]),
+		cacheableTasks: Number(match[2]),
+		hitRatePercent: Number(match[3])
+	};
+}
+function compilationCacheActivityLine(activity) {
+	if (activity.status === "reported") return `${activity.hits}/${activity.cacheableTasks} hits (${activity.hitRatePercent}%)`;
+	if (activity.status === "not-run") return "not run; artifact cache supplied the app";
+	return "unavailable; Xcode did not report reliable statistics";
+}
+async function buildIos({ root, udid = null, logWriter, project = null, scheme = null, configuration = "Debug", sdk = "iphonesimulator", destination = null, derivedDataPath = null, extraArgs = [], compilationCache = void 0, optimizations = resolveOptimizations({}, {}).ios, now = () => Date.now(), exec = null, heartbeatMs = HEARTBEAT_INTERVAL_MS, estimateMs = null, onHeartbeat = (line) => console.error(line), onNote = (line) => console.error(line) }) {
+	if (!root || typeof root !== "string") throw new TypeError("buildIos requires {root}");
+	if (!logWriter || typeof logWriter.write !== "function") throw new TypeError("buildIos requires {logWriter} with a write() method");
+	if (!udid && !destination) throw new TypeError("buildIos requires {udid} (or an explicit {destination})");
+	const executor = exec || getExecutor();
+	const dd = derivedDataPath || (scheme ? join(workspaceDerivedData(root), `scheme-${createHash("sha256").update(scheme).digest("hex")}`) : workspaceDerivedData(root));
+	const startedAt = now();
+	const elapsed = () => now() - startedAt;
+	const reportError = (message, remedy) => {
+		logWriter.write({
+			src: "build",
+			level: "error",
+			msg: message,
+			event: "build_diagnostic",
+			...remedy ? { remedy } : {}
+		});
+	};
+	let target = project;
+	if (!target) {
+		const discovered = discoverXcodeProject(root);
+		if (discovered.error) {
+			reportError(discovered.error.message, discovered.error.remedy);
+			return failedResult({
+				code: discovered.error.code,
+				diagnostics: [{
+					message: discovered.error.message,
+					remedy: discovered.error.remedy ?? void 0
+				}],
+				durationMs: elapsed()
+			});
+		}
+		target = discovered;
+	}
+	const resolvedTarget = target;
+	const selected = resolveScheme(resolvedTarget, {
+		exec: executor,
+		scheme
+	});
+	if (selected.error) {
+		reportError(selected.error.message, selected.error.remedy);
+		return failedResult({
+			code: selected.error.code,
+			diagnostics: [{
+				message: selected.error.message,
+				remedy: selected.error.remedy
+			}],
+			durationMs: elapsed()
+		});
+	}
+	const buildScheme = selected.scheme;
+	const buildSettings = compilationCache === void 0 ? resolveCompilationCacheSettings({
+		root,
+		derivedDataPath: dd,
+		exec: executor,
+		onNote,
+		optimizations
+	}) : compilationCache || [];
+	const args = xcodebuildArgs({
+		project: resolvedTarget,
+		scheme: buildScheme,
+		udid,
+		destination,
+		configuration,
+		sdk,
+		derivedDataPath: dd,
+		extraArgs,
+		buildSettings
+	});
+	logWriter.write({
+		src: "build",
+		level: "info",
+		msg: `xcodebuild ${args.join(" ")}`,
+		event: "build_start"
+	});
+	const transcript = [];
+	let compilationCacheActivity = COMPILATION_CACHE_UNAVAILABLE;
+	const onLine = (line) => {
+		const msg = cleanLine(line);
+		transcript.push(msg);
+		if (msg.trim() === "") return;
+		logWriter.write({
+			src: "build",
+			level: "debug",
+			msg
+		});
+		const activity = parseCompilationCacheActivity(msg);
+		if (activity) {
+			compilationCacheActivity = activity;
+			logWriter.write({
+				src: "build",
+				level: "info",
+				msg: compilationCacheActivityLine(activity),
+				event: "compilation_cache",
+				hits: activity.hits,
+				cacheableTasks: activity.cacheableTasks,
+				hitRatePercent: activity.hitRatePercent
+			});
+		}
+	};
+	let child;
+	try {
+		child = executor.spawn("xcodebuild", args, {
+			cwd: resolvedTarget.dir || root,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			],
+			detached: false,
+			env: {
+				...process.env,
+				NSUnbufferedIO: "YES",
+				FORCE_COLOR: "0"
+			}
+		});
+	} catch (err) {
+		const message = `Could not run xcodebuild: ${err.message}`;
+		const remedy = "Install Xcode and select it with `sudo xcode-select -s /Applications/Xcode.app`.";
+		reportError(message, remedy);
+		return failedResult({
+			code: "STIM_BUILD_FAILED",
+			diagnostics: [{
+				message,
+				remedy
+			}],
+			durationMs: elapsed()
+		});
+	}
+	const outReader = createLineReader(onLine);
+	const errReader = createLineReader(onLine);
+	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));
+	const stopHeartbeat = startBuildHeartbeat({
+		intervalMs: heartbeatMs,
+		elapsed,
+		emit: onHeartbeat,
+		estimateMs
+	});
+	const outcome = await new Promise((settlePromise) => {
+		let settled = false;
+		const finish = (value) => {
+			if (settled) return;
+			settled = true;
+			outReader.flush();
+			errReader.flush();
+			settlePromise(value);
+		};
+		child.on("close", (code, signal) => finish({
+			code,
+			signal
+		}));
+		child.on("error", (error) => finish({
+			code: null,
+			signal: null,
+			error
+		}));
+	});
+	stopHeartbeat();
+	const durationMs = elapsed();
+	const text = transcript.join("\n");
+	if (outcome.error) {
+		const message = `Could not run xcodebuild: ${outcome.error.message}`;
+		const remedy = "Install Xcode and select it with `sudo xcode-select -s /Applications/Xcode.app`.";
+		reportError(message, remedy);
+		return failedResult({
+			code: "STIM_BUILD_FAILED",
+			diagnostics: [{
+				message,
+				remedy
+			}],
+			durationMs,
+			transcriptLines: transcript.length,
+			tail: tailLines(transcript),
+			compilationCache: compilationCacheActivity
+		});
+	}
+	if (outcome.code !== 0) {
+		const diagnostics = extractXcodeDiagnostics(text, root, sdk);
+		const capped = capDiagnostics(diagnostics);
+		for (const d of capped.diagnostics) reportError(describeDiagnostic(d), d.remedy);
+		if (capped.diagnostics.length === 0) reportError(`xcodebuild exited ${outcome.code ?? `on ${outcome.signal}`} with no recognizable diagnostic; see the transcript above.`, null);
+		return failedResult({
+			code: "STIM_BUILD_FAILED",
+			diagnostics,
+			durationMs,
+			exitCode: outcome.code,
+			transcriptLines: transcript.length,
+			tail: tailLines(transcript),
+			compilationCache: compilationCacheActivity
+		});
+	}
+	const products = productsDir(dd, {
+		configuration,
+		sdk
+	});
+	let appPath = null;
+	if (scheme) try {
+		const targets = JSON.parse(executor.runFile("xcodebuild", [
+			resolvedTarget.flag,
+			resolvedTarget.path,
+			"-scheme",
+			buildScheme,
+			"-configuration",
+			configuration,
+			"-sdk",
+			sdk,
+			"-destination",
+			destination || `id=${udid}`,
+			"-derivedDataPath",
+			dd,
+			...extraArgs,
+			...buildSettings,
+			"-showBuildSettings",
+			"-json"
+		], { timeoutMs: 3e4 }));
+		const paths = /* @__PURE__ */ new Set();
+		for (const item of Array.isArray(targets) ? targets : []) {
+			const settings = item?.buildSettings;
+			if (settings?.PRODUCT_TYPE !== "com.apple.product-type.application" || settings.PLATFORM_NAME !== sdk) continue;
+			const dir = settings.TARGET_BUILD_DIR;
+			const name = settings.FULL_PRODUCT_NAME;
+			if (typeof dir !== "string" || !isAbsolute(dir) || typeof name !== "string" || basename(name) !== name || !name.endsWith(".app")) continue;
+			const path = join(dir, name);
+			if (statSync(path).isDirectory()) paths.add(path);
+		}
+		if (paths.size === 1) appPath = [...paths][0];
+	} catch {}
+	else appPath = findAppBundle(products, buildScheme);
+	if (!appPath) {
+		const message = scheme ? `xcodebuild succeeded, but the built app for scheme ${JSON.stringify(buildScheme)} could not be identified unambiguously from its build settings.` : `xcodebuild reported success but no .app is in ${products}.`;
+		const remedy = "Check that the scheme builds one application target for this platform, not a library, test bundle, or several apps.";
+		reportError(message, remedy);
+		return failedResult({
+			code: "STIM_BUILD_FAILED",
+			diagnostics: [{
+				message,
+				remedy
+			}],
+			durationMs,
+			exitCode: 0,
+			transcriptLines: transcript.length,
+			tail: tailLines(transcript),
+			compilationCache: compilationCacheActivity
+		});
+	}
+	const bundleId = readBundleId(appPath, { exec: executor });
+	if (!bundleId) {
+		const message = `No readable CFBundleIdentifier in ${join(appPath, "Info.plist")}.`;
+		const remedy = "Check PRODUCT_BUNDLE_IDENTIFIER in the target's Debug configuration.";
+		reportError(message, remedy);
+		return failedResult({
+			code: "STIM_BUILD_FAILED",
+			diagnostics: [{
+				message,
+				remedy
+			}],
+			durationMs,
+			exitCode: 0,
+			transcriptLines: transcript.length,
+			tail: tailLines(transcript),
+			compilationCache: compilationCacheActivity
+		});
+	}
+	logWriter.write({
+		src: "build",
+		level: "info",
+		msg: `BUILD SUCCEEDED ${appPath} (${bundleId}) in ${durationMs}ms`,
+		event: "build_done"
+	});
+	return {
+		ok: true,
+		appPath,
+		bundleId,
+		durationMs,
+		scheme: buildScheme,
+		project: resolvedTarget,
+		derivedDataPath: dd,
+		productsDir: products,
+		transcriptLines: transcript.length,
+		compilationCache: compilationCacheActivity
+	};
+}
+//#endregion
+export { compilationCacheActivityLine as a, readBundleExecutable as c, startBuildHeartbeat as d, tailLines as f, podInstallCommand as h, ccacheEnabled as i, readBundleId as l, bundlerPin as m, HEARTBEAT_INTERVAL_MS as n, detectXcodeMajor as o, describeDiagnostic as p, buildIos as r, discoverXcodeProject as s, COMPILATION_CACHE_NOT_RUN as t, resolveScheme as u };