stim 1.21.0 → 1.22.0

package/dist/{native-android-JACyjTZs.mjs → native-android-CqgnOgsT.mjs}

@@ -1,28 +1,28 @@
-import { t as getExecutor } from "./exec-_UbtCQcG.mjs";
+import { t as getExecutor } from "./exec-DEoAhcze.mjs";
 import { d as workspaceDir, i as sharedBuildCache } from "./paths-DQtTgsBf.mjs";
-import { J as validateDeviceSlot, U as deviceSlotPlatforms, p as getProject } from "./config-CYcBF478.mjs";
-import { Gt as childEnvironment, tt as settingValueAt } from "./settings-CsJDEXgK.mjs";
-import { r as register } from "./cache-manifest-DkkqguoK.mjs";
-import { Y as statsProjectKey } from "./budget-Bs6SxxzO.mjs";
-import { d as runCancellationSignal } from "./native-run-DY_RLx3C.mjs";
-import { h as resolveBuild, n as buildCacheKey, o as entryDir, t as artifactIn } from "./build-cache-DmyR9Zzc.mjs";
-import { J as pickDefaultSystemImage, P as listInstalledSystemImages, R as ownedAvdDeviceProfile, T as findBuildTool, W as ownedAvdSystemImage, l as androidSystemImageAbi, o as androidHome, z as ownedAvdDirectory } from "./android-DUYkNF4u.mjs";
-import { o as resolveCcache } from "./ccache-BJRZ9pG3.mjs";
-import { r as androidToolchainAsync } from "./toolchain-Hp9sCpK4.mjs";
-import { n as fingerprintNativeInputs } from "./native-inputs-TRTTTRxt.mjs";
-import { a as nativeGradleTransfer, r as nativeGradleLocalSourceDigest, t as gradleOffloadInputs } from "./native-gradle-inputs-Bep9JcSF.mjs";
-import { d as buildGradle, l as androidSdkRefusal } from "./react-native-build-rhk4smwQ.mjs";
-import { a as explainBuildMiss, c as skippedMissReason } from "./prebuild-uD_ipCxF.mjs";
-import { c as resolveAndroidRunPlan } from "./result-DNiS-tTP.mjs";
-import { n as androidProcessRuntime } from "./launch-CD1yVc7U.mjs";
-import { n as planFlagRefusal, r as planPayload } from "./build-plan-CaFskB7_.mjs";
+import { H as deviceSlotPlatforms, p as getProject, q as validateDeviceSlot } from "./config-DlrsduwG.mjs";
+import { tt as settingValueAt } from "./settings-C7O8A6ZI.mjs";
+import { r as register } from "./cache-manifest-DSeQjt-Q.mjs";
+import { Y as statsProjectKey } from "./budget-Cvwn54qV.mjs";
+import { d as runCancellationSignal } from "./native-run-NwUuxbkg.mjs";
+import { h as resolveBuild, o as entryDir, t as artifactIn } from "./build-cache-Dv7RN200.mjs";
+import { B as ownedAvdDeviceProfile, E as findBuildTool, I as listInstalledSystemImages, K as ownedAvdSystemImage, V as ownedAvdDirectory, X as pickDefaultSystemImage, l as androidSystemImageAbi, o as androidHome } from "./android-C7sVmyI9.mjs";
+import { o as resolveCcache } from "./ccache-Btwc36-I.mjs";
+import { r as androidToolchainAsync } from "./toolchain-DpJMHq0n.mjs";
+import { a as nativeGradleTransfer, t as gradleOffloadInputs } from "./native-gradle-inputs-Dnh84Zbd.mjs";
+import { d as buildGradle, l as androidSdkRefusal } from "./react-native-build-Dvd8hC21.mjs";
+import { l as skippedMissReason, o as explainBuildMiss } from "./prebuild-D4JoEAEs.mjs";
+import { c as resolveAndroidRunPlan } from "./result-D2Ykz_iD.mjs";
+import { n as androidProcessRuntime } from "./launch-CCzXlc8r.mjs";
+import { n as planFlagRefusal, r as planPayload } from "./build-plan-DUC8Ka9y.mjs";
+import { a as nativeGradleWorkerArtifactIdentity, n as gradleArtifactInputs, r as nativeGradleArtifactSnapshot, t as NATIVE_GRADLE_CACHE_LIMIT } from "./native-gradle-artifact-inputs-DHFnmrVf.mjs";
 import { createHash } from "node:crypto";
 import { createReadStream, createWriteStream, existsSync, readFileSync, statSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { tmpdir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
 import { storeArtifactAsync } from "@stim-cli/core";
 import { fileURLToPath } from "node:url";
-import { mkdtemp, open, readFile, readdir, realpath, rm, stat, writeFile } from "node:fs/promises";
+import { mkdtemp, open, readFile, realpath, rm, stat, writeFile } from "node:fs/promises";
 import { pipeline } from "node:stream/promises";
 import { Readable } from "node:stream";
 //#region src/integrations/native-android-cache.ts
@@ -246,218 +246,6 @@ function nativeAndroidFileCache(files, sdk, abi, operation) {
 	};
 }
 //#endregion
-//#region src/integrations/native-gradle-artifact-inputs.ts
-const NATIVE_GRADLE_CACHE_LIMIT = "Native APK caching requires android.artifactInputs with complete: true and a complete declaration of repeatable pinned inputs. Gradle incremental and task-cache reuse remain available without it.";
-function gradleArtifactInputs(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(NATIVE_GRADLE_CACHE_LIMIT);
-	const localFiles = "localFiles" in value ? value.localFiles : [];
-	const environment = "environment" in value ? value.environment : [];
-	if (Object.keys(value).some((key) => ![
-		"complete",
-		"ignored",
-		"outputs",
-		"localFiles",
-		"environment"
-	].includes(key)) || !Array.isArray(localFiles) || !localFiles.every((path) => typeof path === "string" && path.length > 0 && !path.includes("\0")) || !Array.isArray(environment) || !environment.every((name) => typeof name === "string" && /^[A-Za-z_][A-Za-z0-9_]*$/.test(name))) throw new Error(NATIVE_GRADLE_CACHE_LIMIT);
-	let inventory;
-	try {
-		inventory = gradleOffloadInputs({
-			complete: "complete" in value ? value.complete : void 0,
-			ignored: "ignored" in value ? value.ignored : void 0,
-			outputs: "outputs" in value ? value.outputs : void 0
-		});
-	} catch (error) {
-		throw new Error(String(error).replaceAll("android.offloadInputs", "android.artifactInputs"), { cause: error });
-	}
-	return {
-		...inventory,
-		localFiles: [...new Set(localFiles)].toSorted(),
-		environment: [...new Set(environment)].toSorted()
-	};
-}
-async function optionalText(path, signal, encoding = "utf8") {
-	try {
-		return await readFile(path, {
-			encoding,
-			signal
-		});
-	} catch (error) {
-		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
-		throw error;
-	}
-}
-async function javaRelease(env, signal) {
-	let home = env.JAVA_HOME;
-	if (!home) {
-		const java = getExecutor().findExecutable("java");
-		if (java) {
-			const selected = dirname(dirname(await realpath(java)));
-			if ((await optionalText(join(selected, "release"), signal))?.includes("JAVA_VERSION=")) home = selected;
-		}
-	}
-	if (!home && process.platform === "darwin") {
-		const child = childEnvironment(env);
-		home = (await getExecutor().runFileAsync("/usr/libexec/java_home", [], {
-			timeoutMs: 1e4,
-			signal,
-			...child
-		})).trim();
-	}
-	if (!home || !(await optionalText(join(home, "release"), signal))?.includes("JAVA_VERSION=")) throw new Error("The Gradle wrapper JDK release identity is unavailable.");
-	return join(home, "release");
-}
-async function localPropertiesIdentity(properties, sdk, root, signal) {
-	const content = await optionalText(properties, signal, "latin1");
-	if (content === null) return null;
-	const retained = [];
-	let selected = null;
-	for (const [, line = "", ending = ""] of content.matchAll(/([^\r\n]*)(\r\n|\r|\n|$)/g)) {
-		if (/^[ \t\f]*$/.test(line) || /^[ \t\f]*[#!]/.test(line)) {
-			retained.push(line + ending);
-			continue;
-		}
-		if ((line.match(/\\+$/)?.[0].length ?? 0) % 2 !== 0) throw new Error("Native APK caching requires single-line local.properties values.");
-		const entry = /^[ \t\f]*([A-Za-z0-9_.-]+)(?:[ \t\f]*[:=][ \t\f]*|[ \t\f]+)(.*)$/.exec(line);
-		if (!entry) {
-			if (/^[ \t\f]*[A-Za-z0-9_.-]+[ \t\f]*$/.test(line) && line.trim() !== "sdk.dir") {
-				retained.push(line + ending);
-				continue;
-			}
-			throw new Error("Native APK caching requires plain, unescaped local.properties keys.");
-		}
-		if (entry[1] !== "sdk.dir") {
-			retained.push(line + ending);
-			continue;
-		}
-		const value = entry[2] ?? "";
-		if (!value || [...value].some((character) => character.charCodeAt(0) > 127)) throw new Error("Native APK caching cannot resolve the local.properties SDK.");
-		selected = value.replace(/\\u([a-fA-F\d]{4})|\\(.)/g, (full, hex, escaped) => {
-			if (hex) return String.fromCharCode(parseInt(hex, 16));
-			if (escaped === "u") throw new Error("Native APK caching cannot resolve the local.properties SDK.");
-			if (escaped === "t") return "	";
-			if (escaped === "r") return "\r";
-			if (escaped === "n") return "\n";
-			if (escaped === "f") return "\f";
-			return escaped ?? full;
-		});
-	}
-	if (selected !== null && await realpath(resolve(root, selected)) !== sdk) throw new Error("Native APK caching requires the local.properties SDK to match ANDROID_HOME.");
-	return retained.join("");
-}
-async function nativeGradleArtifactSnapshot(root, value, build, abi, env, signal) {
-	signal?.throwIfAborted();
-	const declaration = gradleArtifactInputs(value);
-	const localFiles = declaration.localFiles.map((file) => resolve(root, file));
-	for (const path of localFiles) {
-		const info = await stat(path).catch((error) => {
-			if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
-			throw error;
-		});
-		if (info && !info.isFile()) throw new Error("android.artifactInputs.localFiles must name exact regular files.");
-	}
-	const { complete, ignored, outputs } = declaration;
-	const properties = join(root, "local.properties");
-	const source = await nativeGradleLocalSourceDigest(root, {
-		complete,
-		ignored,
-		outputs
-	}, [properties, ...localFiles], signal);
-	const sdkDirectory = await realpath(androidHome(env));
-	const home = env.HOME ?? env.USERPROFILE ?? homedir();
-	const gradleHome = env.GRADLE_USER_HOME ?? join(home, ".gradle");
-	const inputs = [{
-		name: "jdk-release",
-		path: await javaRelease(env, signal),
-		optional: false
-	}, ...[
-		"gradle.properties",
-		"init.gradle",
-		"init.gradle.kts",
-		"init.d"
-	].map((name) => ({
-		name: `gradle-user/${name}`,
-		path: join(gradleHome, name),
-		optional: true
-	}))];
-	for (const group of [
-		"build-tools",
-		"platforms",
-		"ndk",
-		"cmake"
-	]) {
-		const directory = join(sdkDirectory, group);
-		const versions = await readdir(directory).catch((error) => {
-			if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
-			throw error;
-		});
-		for (const version of versions.toSorted()) {
-			if (!(await stat(join(directory, version))).isDirectory()) continue;
-			const path = join(directory, version, "source.properties");
-			if (await optionalText(path, signal) !== null) inputs.push({
-				name: `sdk/${group}/${version}`,
-				path,
-				optional: false
-			});
-		}
-	}
-	if (!inputs.some((input) => input.name.startsWith("sdk/build-tools/"))) throw new Error("Android SDK build-tools version metadata is unavailable.");
-	const preferences = [
-		join(home, ".android"),
-		...env.ANDROID_USER_HOME ? [env.ANDROID_USER_HOME] : [],
-		...[
-			"ANDROID_PREFS_ROOT",
-			"ANDROID_SDK_HOME",
-			"TEST_TMPDIR"
-		].flatMap((name) => env[name] ? [join(env[name], ".android")] : [])
-	];
-	for (const [index, directory] of [...new Set(preferences)].entries()) inputs.push({
-		name: `debug-keystore/${index}`,
-		path: join(directory, "debug.keystore"),
-		optional: true
-	});
-	for (const [index, path] of localFiles.entries()) inputs.push({
-		name: `local/${index}`,
-		path,
-		optional: true
-	});
-	const environment = Object.fromEntries([.../* @__PURE__ */ new Set([
-		...declaration.environment,
-		"JAVA_OPTS",
-		"JAVA_TOOL_OPTIONS",
-		"_JAVA_OPTIONS",
-		"GRADLE_OPTS"
-	])].toSorted().map((name) => [name, env[name] ?? null]));
-	const localProperties = await localPropertiesIdentity(properties, sdkDirectory, root, signal);
-	const local = await fingerprintNativeInputs(inputs, {
-		parameters: {
-			declaration,
-			environment,
-			localProperties: createHash("sha256").update(JSON.stringify(localProperties)).digest("hex")
-		},
-		signal
-	});
-	const hash = createHash("sha256").update("stim-native-gradle-artifact-v1\0").update(JSON.stringify({
-		source,
-		local: local.hash,
-		platform: process.platform,
-		arch: process.arch,
-		variant: build.variant ?? "debug",
-		compilerCache: build.compilerCache,
-		gradleBuildCache: build.gradleBuildCache,
-		pch: build.pch,
-		cas: build.cas,
-		abi
-	})).digest("hex");
-	return {
-		hash,
-		key: buildCacheKey("android", hash, {
-			variant: build.variant ?? "debug",
-			...abi ? { abi } : {}
-		}),
-		sdkDirectory
-	};
-}
-//#endregion
 //#region src/integrations/native-android-plan.ts
 async function planNativeAndroid(root, options, resolved, operation) {
 	if (options.easProfile !== void 0) return { refusal: planFlagRefusal("--eas-profile") };
@@ -467,10 +255,11 @@ async function planNativeAndroid(root, options, resolved, operation) {
 		const { env, signal } = operation;
 		const declared = settingValueAt(settings, "android.artifactInputs");
 		gradleArtifactInputs(declared);
-		const planned = resolveAndroidRunPlan({
+		const planned = await resolveAndroidRunPlan({
 			settings,
 			settingsContext: context,
 			env,
+			signal,
 			slot,
 			variant: options.variant ?? null,
 			systemImage: options.systemImage ?? null,
@@ -558,7 +347,7 @@ async function planNativeAndroid(root, options, resolved, operation) {
 }
 //#endregion
 //#region src/integrations/native-android.ts
-const CACHE_LIMIT = `${NATIVE_GRADLE_CACHE_LIMIT} Offload requires a separate complete android.offloadInputs declaration and remains uncached.`;
+const CACHE_LIMIT = `${NATIVE_GRADLE_CACHE_LIMIT} Offload requires a separate complete android.offloadInputs declaration.`;
 const MODEL_LIMIT = "Native Android requires AGP with androidComponents, one application module and configuration-on-demand disabled. Gradle resolves the exact variant and APK outputs during the build.";
 function refusal(reason) {
 	return {
@@ -625,7 +414,7 @@ function nativeAndroidProject(root) {
 				prepared: { metroPort: null }
 			};
 		}),
-		artifact: ({ operation, cacheArtifacts, writer, buildPlan, target, out, estimates, settings }) => {
+		artifact: ({ operation, artifactScope, writer, buildPlan, target, out, estimates, settings }) => {
 			const variant = buildPlan.variant ?? "debug";
 			const inputs = settingValueAt(settings, "android.offloadInputs");
 			const artifactInputs = settingValueAt(settings, "android.artifactInputs");
@@ -634,9 +423,19 @@ function nativeAndroidProject(root) {
 			let compiledPackage = null;
 			let compiledSdk = null;
 			const signal = runCancellationSignal(operation) ?? operation?.signal;
-			const read = () => {
+			const read = async () => {
 				if (!operation) throw new Error("Native APK caching requires an operation context.");
-				return nativeGradleArtifactSnapshot(root, artifactInputs, buildPlan, target.abi, operation.env, signal);
+				const identity = await nativeGradleArtifactSnapshot(root, artifactInputs, buildPlan, target.abi, operation.env, signal);
+				if (!artifactScope) return identity;
+				const scoped = {
+					...identity,
+					...nativeGradleWorkerArtifactIdentity(identity.hash, artifactScope.key, variant, target.abi)
+				};
+				artifactScope.record?.({
+					hash: scoped.hash,
+					key: scoped.key
+				}, identity.receipt);
+				return scoped;
 			};
 			let transfer = null;
 			const modelFile = join(workspaceDir(root), "gradle-build", `native-apk-${encodeURIComponent(variant)}.json`);
@@ -647,7 +446,6 @@ function nativeAndroidProject(root) {
 					return nativeAndroidFileCache(provider.files, snapshot.sdkDirectory, target.abi, operation);
 				},
 				identity: async () => {
-					if (cacheArtifacts === false) return { cacheIneligible: "Native Gradle worker artifacts have no reusable APK identity." };
 					try {
 						snapshot = await read();
 						cacheRefusal = null;
@@ -708,7 +506,7 @@ function nativeAndroidProject(root) {
 					diff: null
 				}),
 				untrackedLine: () => null,
-				legacyCache: null,
+				expoCache: null,
 				offload: {
 					supportsUncachedArtifacts: true,
 					uncachedArtifacts: true,
@@ -741,7 +539,8 @@ function nativeAndroidProject(root) {
 							isExpo: false,
 							native: {
 								provider: "gradle",
-								transfer
+								transfer,
+								cache: buildPlan.cache
 							},
 							android: {
 								variant,
@@ -757,7 +556,7 @@ function nativeAndroidProject(root) {
 				compile: async () => {
 					const script = ["../shim/native-android.gradle", "../../shim/native-android.gradle"].map((path) => fileURLToPath(new URL(path, import.meta.url))).find(existsSync);
 					if (!script) throw new Error("Stim installation is missing shim/native-android.gradle.");
-					return await buildGradle({
+					const result = await buildGradle({
 						root,
 						logWriter: writer,
 						variant,
@@ -796,6 +595,8 @@ function nativeAndroidProject(root) {
 						pch: buildPlan.pch,
 						compilerCacheDisabled: buildPlan.compilerCache === "none"
 					});
+					if (result.ok) await artifactScope?.validate();
+					return result;
 				}
 			};
 		}
@@ -806,7 +607,7 @@ function nativeAndroidDoctor(root) {
 		let cache = CACHE_LIMIT;
 		try {
 			gradleArtifactInputs(settingValueAt(settings, "android.artifactInputs"));
-			cache = "Local native APK caching uses the project-declared complete inputs. Build workers remain uncached and need their separate android.offloadInputs declaration.";
+			cache = "Native APK caching uses complete inputs in the local or worker context. Build workers also need their separate android.offloadInputs declaration.";
 		} catch {}
 		const sdkPath = androidHome();
 		const sdk = androidSdkRefusal({

package/dist/native-gradle-artifact-inputs-DHFnmrVf.mjs

@@ -0,0 +1,270 @@
+import { t as getExecutor } from "./exec-DEoAhcze.mjs";
+import { r as childEnvironment } from "./operation-exec-BW0em61G.mjs";
+import { n as buildCacheKey } from "./build-cache-Dv7RN200.mjs";
+import { o as androidHome } from "./android-C7sVmyI9.mjs";
+import { n as fingerprintNativeInputs } from "./native-inputs-TRTTTRxt.mjs";
+import { r as nativeGradleLocalSourceDigest, t as gradleOffloadInputs } from "./native-gradle-inputs-Dnh84Zbd.mjs";
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { readFile, readdir, realpath, stat } from "node:fs/promises";
+//#region src/integrations/native-gradle-artifact-inputs.ts
+const NATIVE_GRADLE_CACHE_LIMIT = "Native APK caching requires android.artifactInputs with complete: true and a complete declaration of repeatable pinned inputs. Gradle incremental and task-cache reuse remain available without it.";
+function nativeGradleWorkerScope(sourceDigest, inputs) {
+	return JSON.stringify([sourceDigest, {
+		complete: true,
+		ignored: inputs.ignored,
+		outputs: inputs.outputs
+	}]);
+}
+function nativeGradleWorkerArtifactIdentity(fingerprint, scope, variant, abi) {
+	const hash = createHash("sha256").update(JSON.stringify([
+		"stim-native-gradle-worker-v1",
+		fingerprint,
+		scope
+	])).digest("hex");
+	return {
+		hash,
+		key: buildCacheKey("android", hash, {
+			variant,
+			...abi ? { abi } : {}
+		})
+	};
+}
+function gradleArtifactInputs(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(NATIVE_GRADLE_CACHE_LIMIT);
+	const localFiles = "localFiles" in value ? value.localFiles : [];
+	const environment = "environment" in value ? value.environment : [];
+	if (Object.keys(value).some((key) => ![
+		"complete",
+		"ignored",
+		"outputs",
+		"localFiles",
+		"environment"
+	].includes(key)) || !Array.isArray(localFiles) || !localFiles.every((path) => typeof path === "string" && path.length > 0 && !path.includes("\0")) || !Array.isArray(environment) || !environment.every((name) => typeof name === "string" && /^[A-Za-z_][A-Za-z0-9_]*$/.test(name))) throw new Error(NATIVE_GRADLE_CACHE_LIMIT);
+	let inventory;
+	try {
+		inventory = gradleOffloadInputs({
+			complete: "complete" in value ? value.complete : void 0,
+			ignored: "ignored" in value ? value.ignored : void 0,
+			outputs: "outputs" in value ? value.outputs : void 0
+		});
+	} catch (error) {
+		throw new Error(String(error).replaceAll("android.offloadInputs", "android.artifactInputs"), { cause: error });
+	}
+	return {
+		...inventory,
+		localFiles: [...new Set(localFiles)].toSorted(),
+		environment: [...new Set(environment)].toSorted()
+	};
+}
+async function optionalText(path, signal, encoding = "utf8") {
+	try {
+		return await readFile(path, {
+			encoding,
+			signal
+		});
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
+		throw error;
+	}
+}
+async function javaRelease(env, signal) {
+	let home = env.JAVA_HOME;
+	if (!home) {
+		const java = getExecutor().findExecutable("java");
+		if (java) {
+			const selected = dirname(dirname(await realpath(java)));
+			if ((await optionalText(join(selected, "release"), signal))?.includes("JAVA_VERSION=")) home = selected;
+		}
+	}
+	if (!home && process.platform === "darwin") {
+		const child = childEnvironment(env);
+		home = (await getExecutor().runFileAsync("/usr/libexec/java_home", [], {
+			timeoutMs: 1e4,
+			signal,
+			...child
+		})).trim();
+	}
+	if (!home || !(await optionalText(join(home, "release"), signal))?.includes("JAVA_VERSION=")) throw new Error("The Gradle wrapper JDK release identity is unavailable.");
+	return join(home, "release");
+}
+async function localPropertiesIdentity(properties, sdk, root, signal) {
+	const content = await optionalText(properties, signal, "latin1");
+	if (content === null) return null;
+	const retained = [];
+	let selected = null;
+	for (const [, line = "", ending = ""] of content.matchAll(/([^\r\n]*)(\r\n|\r|\n|$)/g)) {
+		if (/^[ \t\f]*$/.test(line) || /^[ \t\f]*[#!]/.test(line)) {
+			retained.push(line + ending);
+			continue;
+		}
+		if ((line.match(/\\+$/)?.[0].length ?? 0) % 2 !== 0) throw new Error("Native APK caching requires single-line local.properties values.");
+		const entry = /^[ \t\f]*([A-Za-z0-9_.-]+)(?:[ \t\f]*[:=][ \t\f]*|[ \t\f]+)(.*)$/.exec(line);
+		if (!entry) {
+			if (/^[ \t\f]*[A-Za-z0-9_.-]+[ \t\f]*$/.test(line) && line.trim() !== "sdk.dir") {
+				retained.push(line + ending);
+				continue;
+			}
+			throw new Error("Native APK caching requires plain, unescaped local.properties keys.");
+		}
+		if (entry[1] !== "sdk.dir") {
+			retained.push(line + ending);
+			continue;
+		}
+		const value = entry[2] ?? "";
+		if (!value || [...value].some((character) => character.charCodeAt(0) > 127)) throw new Error("Native APK caching cannot resolve the local.properties SDK.");
+		selected = value.replace(/\\u([a-fA-F\d]{4})|\\(.)/g, (full, hex, escaped) => {
+			if (hex) return String.fromCharCode(parseInt(hex, 16));
+			if (escaped === "u") throw new Error("Native APK caching cannot resolve the local.properties SDK.");
+			if (escaped === "t") return "	";
+			if (escaped === "r") return "\r";
+			if (escaped === "n") return "\n";
+			if (escaped === "f") return "\f";
+			return escaped ?? full;
+		});
+	}
+	if (selected !== null && await realpath(resolve(root, selected)) !== sdk) throw new Error("Native APK caching requires the local.properties SDK to match ANDROID_HOME.");
+	return retained.join("");
+}
+async function nativeGradleArtifactSnapshot(root, value, build, abi, env, signal) {
+	signal?.throwIfAborted();
+	const declaration = gradleArtifactInputs(value);
+	const localFiles = declaration.localFiles.map((file) => resolve(root, file));
+	const properties = join(root, "local.properties");
+	const { complete, ignored, outputs } = declaration;
+	return nativeGradleArtifactSnapshotFromReceipt(root, {
+		source: await nativeGradleLocalSourceDigest(root, {
+			complete,
+			ignored,
+			outputs
+		}, [properties, ...localFiles], signal),
+		declaration,
+		build: {
+			variant: build.variant,
+			compilerCache: build.compilerCache,
+			gradleBuildCache: build.gradleBuildCache,
+			pch: build.pch,
+			cas: build.cas
+		},
+		abi
+	}, env, signal);
+}
+/** Revalidates private inputs; the caller must bind the receipt to a verified completed source snapshot. */
+async function nativeGradleArtifactSnapshotFromReceipt(root, receipt, env, signal) {
+	signal?.throwIfAborted();
+	const { build, abi } = receipt;
+	if (!/^[a-f0-9]{64}$/.test(receipt.source)) throw new Error("The completed Gradle source identity is invalid.");
+	const declaration = gradleArtifactInputs(receipt.declaration);
+	const localFiles = declaration.localFiles.map((file) => resolve(root, file));
+	for (const path of localFiles) {
+		const info = await stat(path).catch((error) => {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return null;
+			throw error;
+		});
+		if (info && !info.isFile()) throw new Error("android.artifactInputs.localFiles must name exact regular files.");
+	}
+	const properties = join(root, "local.properties");
+	const sdkDirectory = await realpath(androidHome(env));
+	const home = env.HOME ?? env.USERPROFILE ?? homedir();
+	const gradleHome = env.GRADLE_USER_HOME ?? join(home, ".gradle");
+	const inputs = [{
+		name: "jdk-release",
+		path: await javaRelease(env, signal),
+		optional: false
+	}, ...[
+		"gradle.properties",
+		"init.gradle",
+		"init.gradle.kts",
+		"init.d"
+	].map((name) => ({
+		name: `gradle-user/${name}`,
+		path: join(gradleHome, name),
+		optional: true
+	}))];
+	for (const group of [
+		"build-tools",
+		"platforms",
+		"ndk",
+		"cmake"
+	]) {
+		const directory = join(sdkDirectory, group);
+		const versions = await readdir(directory).catch((error) => {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
+			throw error;
+		});
+		for (const version of versions.toSorted()) {
+			if (!(await stat(join(directory, version))).isDirectory()) continue;
+			const path = join(directory, version, "source.properties");
+			if (await optionalText(path, signal) !== null) inputs.push({
+				name: `sdk/${group}/${version}`,
+				path,
+				optional: false
+			});
+		}
+	}
+	if (!inputs.some((input) => input.name.startsWith("sdk/build-tools/"))) throw new Error("Android SDK build-tools version metadata is unavailable.");
+	const preferences = [
+		join(home, ".android"),
+		...env.ANDROID_USER_HOME ? [env.ANDROID_USER_HOME] : [],
+		...[
+			"ANDROID_PREFS_ROOT",
+			"ANDROID_SDK_HOME",
+			"TEST_TMPDIR"
+		].flatMap((name) => env[name] ? [join(env[name], ".android")] : [])
+	];
+	for (const [index, directory] of [...new Set(preferences)].entries()) inputs.push({
+		name: `debug-keystore/${index}`,
+		path: join(directory, "debug.keystore"),
+		optional: true
+	});
+	for (const [index, path] of localFiles.entries()) inputs.push({
+		name: `local/${index}`,
+		path,
+		optional: true
+	});
+	const environment = Object.fromEntries([.../* @__PURE__ */ new Set([
+		...declaration.environment,
+		"JAVA_OPTS",
+		"JAVA_TOOL_OPTIONS",
+		"_JAVA_OPTIONS",
+		"GRADLE_OPTS"
+	])].toSorted().map((name) => [name, env[name] ?? null]));
+	const localProperties = await localPropertiesIdentity(properties, sdkDirectory, root, signal);
+	const local = await fingerprintNativeInputs(inputs, {
+		parameters: {
+			declaration,
+			environment,
+			localProperties: createHash("sha256").update(JSON.stringify(localProperties)).digest("hex")
+		},
+		signal
+	});
+	const hash = createHash("sha256").update("stim-native-gradle-artifact-v1\0").update(JSON.stringify({
+		source: receipt.source,
+		local: local.hash,
+		platform: process.platform,
+		arch: process.arch,
+		variant: build.variant ?? "debug",
+		compilerCache: build.compilerCache,
+		gradleBuildCache: build.gradleBuildCache,
+		pch: build.pch,
+		cas: build.cas,
+		abi
+	})).digest("hex");
+	return {
+		hash,
+		key: buildCacheKey("android", hash, {
+			variant: build.variant ?? "debug",
+			...abi ? { abi } : {}
+		}),
+		sdkDirectory,
+		receipt: {
+			source: receipt.source,
+			declaration,
+			build,
+			abi
+		}
+	};
+}
+//#endregion
+export { nativeGradleWorkerArtifactIdentity as a, nativeGradleArtifactSnapshotFromReceipt as i, gradleArtifactInputs as n, nativeGradleWorkerScope as o, nativeGradleArtifactSnapshot as r, NATIVE_GRADLE_CACHE_LIMIT as t };