craft-native 0.0.202 → 0.0.203

package/dist/android/src/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Generates native Android apps from web content using WebView.
  */
+export { runKotlinFixture } from './testing.js';
 /** Oldest Android API level supported by the generated Kotlin runtime. */
 export declare const ANDROID_MIN_SDK = 26;
 export interface CraftAndroidConfig {

package/dist/android/src/index.js

@@ -1,7 +1,7 @@
 // @bun
 // ../android/src/index.ts
-import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
-import { dirname, extname, isAbsolute, join, relative, resolve, sep } from "path";
+import { cpSync, existsSync, mkdirSync, readFileSync as readFileSync2, rmSync, statSync, writeFileSync } from "fs";
+import { dirname as dirname2, extname, isAbsolute, join as join2, relative, resolve, sep } from "path";
 var {$ } = globalThis.Bun;
 
 // ../android/src/promise-runtime.ts
@@ -77,17 +77,73 @@ function renderAndroidPromiseRuntime(indent = "") {
 `);
 }
 
+// ../android/src/testing.ts
+import { readFileSync } from "fs";
+import { mkdtemp, rm, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { dirname, join } from "path";
+async function runKotlinFixture(source) {
+  const gradle = Bun.which("gradle");
+  if (!gradle)
+    throw new Error("Gradle is required to run native Kotlin fixtures");
+  const template = readFileSync(join(dirname(import.meta.dir), "templates/build.gradle.kts.project.template"), "utf8");
+  const version = template.match(/id\("org.jetbrains.kotlin.android"\) version "([\d.]+)"/)?.[1];
+  if (!version)
+    throw new Error("The Android builder Kotlin version is missing");
+  const directory = await mkdtemp(join(tmpdir(), "craft-kotlin-fixture-"));
+  try {
+    await writeFile(join(directory, "Fixture.kt"), source);
+    await writeFile(join(directory, "settings.gradle"), `rootProject.name = 'craft-kotlin-fixture'
+`);
+    await writeFile(join(directory, "gradle.properties"), `org.gradle.jvmargs=-Xmx512m
+`);
+    await writeFile(join(directory, "build.gradle"), `
+repositories { mavenCentral() }
+configurations {
+    kotlinCompiler
+    kotlinRuntime
+}
+dependencies {
+    kotlinCompiler 'org.jetbrains.kotlin:kotlin-compiler-embeddable:${version}'
+    kotlinRuntime 'org.jetbrains.kotlin:kotlin-stdlib:${version}'
+}
+tasks.register('compileFixture', JavaExec) {
+    classpath = configurations.kotlinCompiler
+    mainClass = 'org.jetbrains.kotlin.cli.jvm.K2JVMCompiler'
+    args '-no-stdlib', '-no-reflect', '-classpath', configurations.kotlinRuntime.asPath,
+         '-d', layout.buildDirectory.dir('classes').get().asFile.absolutePath,
+         file('Fixture.kt').absolutePath
+}
+tasks.register('runFixture', JavaExec) {
+    dependsOn 'compileFixture'
+    classpath = files(layout.buildDirectory.dir('classes')) + configurations.kotlinRuntime
+    mainClass = 'FixtureKt'
+}
+`);
+    const child = Bun.spawn([gradle, "--no-daemon", "--console=plain", "--max-workers=2", "runFixture"], {
+      cwd: directory,
+      stdout: "inherit",
+      stderr: "inherit"
+    });
+    const code = await child.exited;
+    if (code !== 0)
+      throw new Error(`Native Kotlin fixture failed with exit code ${code}`);
+  } finally {
+    await rm(directory, { recursive: true, force: true });
+  }
+}
+
 // ../android/src/index.ts
-var TEMPLATES_DIR = join(dirname(import.meta.dir), "templates");
+var TEMPLATES_DIR = join2(dirname2(import.meta.dir), "templates");
 function resolveCraftAndroidVersion(startDir = import.meta.dir) {
   let directory = resolve(startDir);
   while (true) {
     try {
-      const pkg = JSON.parse(readFileSync(join(directory, "package.json"), "utf8"));
+      const pkg = JSON.parse(readFileSync2(join2(directory, "package.json"), "utf8"));
       if ((pkg.name === "@craft-native/android" || pkg.name === "craft-native") && typeof pkg.version === "string" && pkg.version)
         return pkg.version;
     } catch {}
-    const parent = dirname(directory);
+    const parent = dirname2(directory);
     if (parent === directory)
       return "0.0.0";
     directory = parent;
@@ -226,7 +282,7 @@ function validateGoogleServicesFile(path, packageName) {
   requireRegularFile(path, "Google services file");
   let document;
   try {
-    document = JSON.parse(readFileSync(path, "utf8"));
+    document = JSON.parse(readFileSync2(path, "utf8"));
   } catch (error) {
     throw new Error(`Google services file must contain valid JSON: ${path}`, { cause: error });
   }
@@ -325,11 +381,11 @@ function validateAndroidConfig(config) {
   }
 }
 function writeAndroidConfig(output, config) {
-  writeFileSync(join(output, "craft.config.json"), JSON.stringify(config, null, 2));
+  writeFileSync(join2(output, "craft.config.json"), JSON.stringify(config, null, 2));
   const runtimeConfig = { ...config };
   delete runtimeConfig.appIconPath;
   delete runtimeConfig.googleServicesFile;
-  writeFileSync(join(output, "app/src/main/assets/craft.config.json"), JSON.stringify(runtimeConfig, null, 2));
+  writeFileSync(join2(output, "app/src/main/assets/craft.config.json"), JSON.stringify(runtimeConfig, null, 2));
 }
 function syncAndroidWebAssets(source, output) {
   const sourcePath = resolve(source);
@@ -344,17 +400,17 @@ function syncAndroidWebAssets(source, output) {
     throw new Error(`Web asset source must not overlap generated asset directory: ${source}`);
   }
   if (sourceStat.isDirectory()) {
-    requireRegularFile(join(sourcePath, "index.html"), "Web asset directory entry point");
+    requireRegularFile(join2(sourcePath, "index.html"), "Web asset directory entry point");
   }
-  const configPath = join(assetsDir, "craft.config.json");
-  const config = existsSync(configPath) ? readFileSync(configPath) : undefined;
+  const configPath = join2(assetsDir, "craft.config.json");
+  const config = existsSync(configPath) ? readFileSync2(configPath) : undefined;
   rmSync(assetsDir, { recursive: true, force: true });
   mkdirSync(assetsDir, { recursive: true });
   if (sourceStat.isDirectory())
     cpSync(sourcePath, assetsDir, { recursive: true });
   else
-    cpSync(sourcePath, join(assetsDir, "index.html"));
-  if (!existsSync(join(assetsDir, "index.html")))
+    cpSync(sourcePath, join2(assetsDir, "index.html"));
+  if (!existsSync(join2(assetsDir, "index.html")))
     throw new Error(`Web asset directory must contain index.html: ${source}`);
   if (config)
     writeFileSync(configPath, config);
@@ -398,10 +454,10 @@ function renderAndroidPermissions(config) {
 `);
 }
 function writeNativeShellSources(output, packagePath, packageName, config) {
-  const javaDir = join(output, "app/src/main/java", packagePath);
+  const javaDir = join2(output, "app/src/main/java", packagePath);
   const write = (template, file, replace = (source) => source) => {
-    const source = readFileSync(join(TEMPLATES_DIR, template), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, packageName);
-    writeFileSync(join(javaDir, file), replace(source));
+    const source = readFileSync2(join2(TEMPLATES_DIR, template), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, packageName);
+    writeFileSync(join2(javaDir, file), replace(source));
   };
   write("CraftBluetooth.kt.template", "CraftBluetooth.kt");
   write("CraftNativeShell.kt.template", "CraftNativeShell.kt");
@@ -422,9 +478,9 @@ function writeNativeShellSources(output, packagePath, packageName, config) {
   if (config.enablePushNotifications)
     write("CraftNativeMessagingService.kt.template", "CraftNativeMessagingService.kt");
   else
-    rmSync(join(javaDir, "CraftNativeMessagingService.kt"), { force: true });
-  mkdirSync(join(output, "app/src/main/res/xml"), { recursive: true });
-  writeFileSync(join(output, "app/src/main/res/xml/craft_file_paths.xml"), `<?xml version="1.0" encoding="utf-8"?>
+    rmSync(join2(javaDir, "CraftNativeMessagingService.kt"), { force: true });
+  mkdirSync(join2(output, "app/src/main/res/xml"), { recursive: true });
+  writeFileSync(join2(output, "app/src/main/res/xml/craft_file_paths.xml"), `<?xml version="1.0" encoding="utf-8"?>
 <paths>
     <cache-path name="craft-files" path="craft-files/" />
     <files-path name="craft-media" path="craft-media/" />
@@ -503,7 +559,7 @@ function resolveRuntimeDir(override) {
   return dir;
 }
 function installRuntime(output, runtimeDir) {
-  const found = RUNTIME_ABIS.map((abi) => ({ abi, source: join(runtimeDir, abi, "libcraft.so") })).filter((entry) => existsSync(entry.source));
+  const found = RUNTIME_ABIS.map((abi) => ({ abi, source: join2(runtimeDir, abi, "libcraft.so") })).filter((entry) => existsSync(entry.source));
   if (found.length === 0) {
     throw new Error(`${runtimeDir} has no <abi>/libcraft.so for any of ${RUNTIME_ABIS.join(", ")}. ` + "Run `zig build build-android-all -Doptimize=ReleaseSafe` in packages/zig and point at its zig-out/android.");
   }
@@ -511,12 +567,12 @@ function installRuntime(output, runtimeDir) {
     const missing = RUNTIME_ABIS.filter((abi) => !found.some((entry) => entry.abi === abi));
     console.warn(`   \u26A0 only ${found.map((entry) => entry.abi).join(", ")} was found; ${missing.join(", ")} is missing. ` + "The app will fall back to the Kotlin shim on those devices.");
   }
-  const dest = join(output, "app/src/main/jniLibs");
+  const dest = join2(output, "app/src/main/jniLibs");
   rmSync(dest, { force: true, recursive: true });
   for (const { abi, source } of found) {
-    const abiDir = join(dest, abi);
+    const abiDir = join2(dest, abi);
     mkdirSync(abiDir, { recursive: true });
-    cpSync(source, join(abiDir, "libcraft.so"));
+    cpSync(source, join2(abiDir, "libcraft.so"));
   }
   return true;
 }
@@ -558,13 +614,13 @@ async function init(options) {
   }
   const dirs = [
     output,
-    join(output, "app/src/main/java", packagePath),
-    join(output, "app/src/main/res/layout"),
-    join(output, "app/src/main/res/values"),
-    join(output, "app/src/main/res/values-night"),
-    join(output, "app/src/main/res/drawable"),
-    join(output, "app/src/main/assets"),
-    join(output, "gradle/wrapper")
+    join2(output, "app/src/main/java", packagePath),
+    join2(output, "app/src/main/res/layout"),
+    join2(output, "app/src/main/res/values"),
+    join2(output, "app/src/main/res/values-night"),
+    join2(output, "app/src/main/res/drawable"),
+    join2(output, "app/src/main/assets"),
+    join2(output, "gradle/wrapper")
   ];
   if (existsSync(output) && !statSync(output).isDirectory()) {
     throw new Error(`Android project output must be a directory: ${output}`);
@@ -577,27 +633,27 @@ async function init(options) {
   writeAndroidConfig(output, config);
   const hasGoogleServices = Boolean(config.googleServicesFile);
   if (config.googleServicesFile) {
-    cpSync(config.googleServicesFile, join(output, "app/google-services.json"));
+    cpSync(config.googleServicesFile, join2(output, "app/google-services.json"));
   }
-  const mainActivityTemplate = readFileSync(join(TEMPLATES_DIR, config.renderer === "native" ? "MainActivityNative.kt.template" : "MainActivity.kt.template"), "utf-8");
+  const mainActivityTemplate = readFileSync2(join2(TEMPLATES_DIR, config.renderer === "native" ? "MainActivityNative.kt.template" : "MainActivity.kt.template"), "utf-8");
   const mainActivity = mainActivityTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name);
-  writeFileSync(join(output, "app/src/main/java", packagePath, "MainActivity.kt"), mainActivity);
-  writeFileSync(join(output, "app/src/main/java", packagePath, "CraftAppLinks.kt"), readFileSync(join(TEMPLATES_DIR, "CraftAppLinks.kt.template"), "utf8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-  writeFileSync(join(output, "app/src/main/java", packagePath, "CraftCrashReporter.kt"), readFileSync(join(TEMPLATES_DIR, "CraftCrashReporter.kt.template"), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_ANDROID_VERSION));
+  writeFileSync(join2(output, "app/src/main/java", packagePath, "MainActivity.kt"), mainActivity);
+  writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftAppLinks.kt"), readFileSync2(join2(TEMPLATES_DIR, "CraftAppLinks.kt.template"), "utf8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftCrashReporter.kt"), readFileSync2(join2(TEMPLATES_DIR, "CraftCrashReporter.kt.template"), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_ANDROID_VERSION));
   if (config.renderer === "native") {
-    const mutationTemplate = readFileSync(join(TEMPLATES_DIR, "CraftNativeMutation.kt.template"), "utf-8");
-    const flatListTemplate = readFileSync(join(TEMPLATES_DIR, "CraftNativeFlatList.kt.template"), "utf-8");
-    const refreshableFlatListTemplate = readFileSync(join(TEMPLATES_DIR, "CraftNativeRefreshableFlatList.kt.template"), "utf-8");
-    const capabilityTemplate = readFileSync(join(TEMPLATES_DIR, "CraftNativeCapabilities.kt.template"), "utf-8");
-    const notificationTemplate = readFileSync(join(TEMPLATES_DIR, "CraftNativeNotificationReceiver.kt.template"), "utf-8");
-    writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeMutation.kt"), mutationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-    writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeFlatList.kt"), flatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-    writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeRefreshableFlatList.kt"), refreshableFlatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-    writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeCapabilities.kt"), capabilityTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-    writeFileSync(join(output, "app/src/main/java", packagePath, "CraftNativeNotificationReceiver.kt"), notificationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    const mutationTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftNativeMutation.kt.template"), "utf-8");
+    const flatListTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftNativeFlatList.kt.template"), "utf-8");
+    const refreshableFlatListTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftNativeRefreshableFlatList.kt.template"), "utf-8");
+    const capabilityTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftNativeCapabilities.kt.template"), "utf-8");
+    const notificationTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftNativeNotificationReceiver.kt.template"), "utf-8");
+    writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftNativeMutation.kt"), mutationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftNativeFlatList.kt"), flatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftNativeRefreshableFlatList.kt"), refreshableFlatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftNativeCapabilities.kt"), capabilityTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftNativeNotificationReceiver.kt"), notificationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
     writeNativeShellSources(output, packagePath, finalPackageName, config);
   }
-  const craftBridgeTemplate = readFileSync(join(TEMPLATES_DIR, "CraftBridge.kt.template"), "utf-8");
+  const craftBridgeTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftBridge.kt.template"), "utf-8");
   const craftBridge = craftBridgeTemplate.replace(/\{\{PROMISE_RUNTIME\}\}/g, () => renderAndroidPromiseRuntime("            ")).replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{ENABLE_SPEECH\}\}/g, String(Boolean(config.enableSpeechRecognition))).replace(/\{\{ENABLE_HAPTICS\}\}/g, String(Boolean(config.enableHaptics))).replace(/\{\{ENABLE_SHARE\}\}/g, String(Boolean(config.enableShare))).replace(/\{\{ENABLE_CAMERA\}\}/g, String(Boolean(config.enableCamera))).replace(/\{\{ENABLE_BIOMETRIC\}\}/g, String(Boolean(config.enableBiometric))).replace(/\{\{ENABLE_PUSH\}\}/g, String(Boolean(config.enablePushNotifications))).replace(/\{\{ENABLE_SECURE_STORAGE\}\}/g, String(Boolean(config.enableSecureStorage))).replace(/\{\{ENABLE_GEOLOCATION\}\}/g, String(Boolean(config.enableGeolocation))).replace(/\{\{ENABLE_BACKGROUND_LOCATION\}\}/g, String(Boolean(config.enableBackgroundLocation))).replace(/\{\{ENABLE_KEEP_AWAKE\}\}/g, String(Boolean(config.enableKeepAwake))).replace(/\{\{ENABLE_DEEP_LINKS\}\}/g, String(Boolean(config.enableDeepLinks))).replace(/\{\{ENABLE_HEALTH_CONNECT\}\}/g, String(Boolean(config.enableHealthConnect))).replace(/\{\{FIREBASE_IMPORT\}\}/g, config.enablePushNotifications ? "import com.google.firebase.messaging.FirebaseMessaging" : "").replace(/\{\{REGISTER_PUSH_IMPLEMENTATION\}\}/g, config.enablePushNotifications ? `activity.runOnUiThread {
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU
                 && ContextCompat.checkSelfPermission(activity, Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
@@ -617,16 +673,16 @@ async function init(options) {
         }` : `evaluatePromiseJavascript(
             "window._craftPushReject && window._craftPushReject('Push notifications are disabled')"
         )`);
-  writeFileSync(join(output, "app/src/main/java", packagePath, "CraftBridge.kt"), craftBridge);
-  const craftNative = readFileSync(join(TEMPLATES_DIR, "CraftNative.kt.template"), "utf-8");
-  const nativeDir = join(output, "app/src/main/java/com/craft/runtime");
+  writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftBridge.kt"), craftBridge);
+  const craftNative = readFileSync2(join2(TEMPLATES_DIR, "CraftNative.kt.template"), "utf-8");
+  const nativeDir = join2(output, "app/src/main/java/com/craft/runtime");
   mkdirSync(nativeDir, { recursive: true });
-  writeFileSync(join(nativeDir, "CraftNative.kt"), craftNative);
-  const serviceTemplate = readFileSync(join(TEMPLATES_DIR, "LocationRecordingService.kt.template"), "utf-8");
-  writeFileSync(join(nativeDir, "LocationRecordingService.kt"), serviceTemplate);
-  const healthTemplate = readFileSync(join(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
-  writeFileSync(join(output, "app/src/main/java", packagePath, "CraftHealthConnect.kt"), healthTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-  const manifestTemplate = readFileSync(join(TEMPLATES_DIR, "AndroidManifest.xml.template"), "utf-8");
+  writeFileSync(join2(nativeDir, "CraftNative.kt"), craftNative);
+  const serviceTemplate = readFileSync2(join2(TEMPLATES_DIR, "LocationRecordingService.kt.template"), "utf-8");
+  writeFileSync(join2(nativeDir, "LocationRecordingService.kt"), serviceTemplate);
+  const healthTemplate = readFileSync2(join2(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
+  writeFileSync(join2(output, "app/src/main/java", packagePath, "CraftHealthConnect.kt"), healthTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  const manifestTemplate = readFileSync2(join2(TEMPLATES_DIR, "AndroidManifest.xml.template"), "utf-8");
   const manifest = manifestTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{PERMISSIONS\}\}/g, renderAndroidPermissions(config)).replace(/\{\{USES_CLEARTEXT\}\}/g, config.devServerURL?.startsWith("http://") || config.enableLocalNetwork ? "true" : "false").replace(/\{\{DEEP_LINK_INTENT_FILTERS\}\}/g, renderAndroidDeepLinks(config)).replace(/\{\{BACKGROUND_SERVICE\}\}/g, config.enableBackgroundLocation ? '        <service android:name="com.craft.runtime.LocationRecordingService" android:exported="false" android:foregroundServiceType="location" android:stopWithTask="false" />' : "").replace(/\{\{NATIVE_NOTIFICATION_RECEIVER\}\}/g, config.renderer === "native" ? renderNativeShellManifest(config) : "").replace(/\{\{CRASH_REPORTER_PROVIDER\}\}/g, `        <provider android:name=".CraftCrashReporterInit" android:authorities="\${applicationId}.craft-crash" android:exported="false" android:initOrder="1000" />`).replace(/\{\{GOOGLE_MAPS_API_KEY\}\}/g, config.mapsApiKey ? `        <meta-data android:name="com.google.android.geo.API_KEY" android:value="${escapeXml(config.mapsApiKey)}" />` : "").replace(/\{\{HEALTH_CONNECT_QUERIES\}\}/g, config.enableHealthConnect ? `    <queries>
         <package android:name="com.google.android.apps.healthdata" />
     </queries>` : "").replace(/\{\{HEALTH_CONNECT_RATIONALE\}\}/g, config.enableHealthConnect ? `            <intent-filter>
@@ -636,29 +692,28 @@ async function init(options) {
                 <action android:name="android.intent.action.VIEW_PERMISSION_USAGE" />
                 <category android:name="android.intent.category.HEALTH_PERMISSIONS" />
             </intent-filter>`}` : "");
-  writeFileSync(join(output, "app/src/main/AndroidManifest.xml"), manifest);
-  const projectGradleTemplate = readFileSync(join(TEMPLATES_DIR, "build.gradle.kts.project.template"), "utf-8");
-  writeFileSync(join(output, "build.gradle.kts"), projectGradleTemplate.replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services") version "4.4.2" apply false' : ""));
-  const appGradleTemplate = readFileSync(join(TEMPLATES_DIR, "build.gradle.kts.app.template"), "utf-8");
+  writeFileSync(join2(output, "app/src/main/AndroidManifest.xml"), manifest);
+  const projectGradleTemplate = readFileSync2(join2(TEMPLATES_DIR, "build.gradle.kts.project.template"), "utf-8");
+  writeFileSync(join2(output, "build.gradle.kts"), projectGradleTemplate.replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services") version "4.4.2" apply false' : ""));
+  const appGradleTemplate = readFileSync2(join2(TEMPLATES_DIR, "build.gradle.kts.app.template"), "utf-8");
   const appGradle = appGradleTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{VERSION_NAME\}\}/g, escapeKotlinString(config.version || "1.0.0")).replace(/\{\{VERSION_CODE\}\}/g, String(config.versionCode || 1)).replace(/\{\{MIN_SDK\}\}/g, String(config.minSdk ?? ANDROID_MIN_SDK)).replace(/\{\{COMPILE_SDK\}\}/g, String(config.compileSdk || 36)).replace(/\{\{TARGET_SDK\}\}/g, String(config.targetSdk || 35)).replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services")' : "").replace(/\{\{FIREBASE_MESSAGING_DEPENDENCY\}\}/g, config.enablePushNotifications ? '    implementation("com.google.firebase:firebase-messaging:24.1.0")' : "").replace(/\{\{REFRESH_LAYOUT_DEPENDENCY\}\}/g, config.renderer === "native" ? '    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")' : "").replace(/\{\{GOOGLE_MAPS_DEPENDENCY\}\}/g, config.renderer === "native" ? `    // Native STX Map overlays and trail routes
     implementation("com.google.android.gms:play-services-maps:18.2.0")` : "").replace(/\{\{HEALTH_CONNECT_DEPENDENCIES\}\}/g, config.enableHealthConnect ? `    implementation("androidx.health.connect:connect-client:1.1.0")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")` : "").replace(/\{\{JAVASCRIPT_ENGINE_DEPENDENCY\}\}/g, config.renderer === "native" ? `    implementation("androidx.javascriptengine:javascriptengine:1.1.0")
-    // The in-app browser (Custom Tabs) and background refresh (WorkManager).
-    implementation("androidx.browser:browser:1.8.0")
+    // Native background refresh (WorkManager).
     implementation("androidx.work:work-runtime-ktx:2.9.1")` : "");
-  writeFileSync(join(output, "app/build.gradle.kts"), appGradle);
-  const proguardTemplate = readFileSync(join(TEMPLATES_DIR, "proguard-rules.pro.template"), "utf-8");
-  writeFileSync(join(output, "app/proguard-rules.pro"), proguardTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
-  const settingsTemplate = readFileSync(join(TEMPLATES_DIR, "settings.gradle.kts.template"), "utf-8");
+  writeFileSync(join2(output, "app/build.gradle.kts"), appGradle);
+  const proguardTemplate = readFileSync2(join2(TEMPLATES_DIR, "proguard-rules.pro.template"), "utf-8");
+  writeFileSync(join2(output, "app/proguard-rules.pro"), proguardTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  const settingsTemplate = readFileSync2(join2(TEMPLATES_DIR, "settings.gradle.kts.template"), "utf-8");
   const settings = settingsTemplate.replace(/\{\{APP_NAME\}\}/g, escapeKotlinString(generatedGradleProjectName(name)));
-  writeFileSync(join(output, "settings.gradle.kts"), settings);
+  writeFileSync(join2(output, "settings.gradle.kts"), settings);
   const gradleProperties = `org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
 android.useAndroidX=true
 kotlin.code.style=official
 android.nonTransitiveRClass=true
 `;
-  writeFileSync(join(output, "gradle.properties"), gradleProperties);
-  writeFileSync(join(output, "local.properties"), `# SDK location will be set by Android Studio
+  writeFileSync(join2(output, "gradle.properties"), gradleProperties);
+  writeFileSync(join2(output, "local.properties"), `# SDK location will be set by Android Studio
 `);
   const gradleWrapperProps = `distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
@@ -668,13 +723,13 @@ validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
 `;
-  writeFileSync(join(output, "gradle/wrapper/gradle-wrapper.properties"), gradleWrapperProps);
+  writeFileSync(join2(output, "gradle/wrapper/gradle-wrapper.properties"), gradleWrapperProps);
   const stringsXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="app_name">${escapeXml(name)}</string>
 </resources>
 `;
-  writeFileSync(join(output, "app/src/main/res/values/strings.xml"), stringsXml);
+  writeFileSync(join2(output, "app/src/main/res/values/strings.xml"), stringsXml);
   const colorsXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <color name="primary">#1a1a2e</color>
@@ -683,8 +738,8 @@ zipStorePath=wrapper/dists
     <color name="background">${config.backgroundColor}</color>
 </resources>
 `;
-  writeFileSync(join(output, "app/src/main/res/values/colors.xml"), colorsXml);
-  const darkColorsPath = join(output, "app/src/main/res/values-night/colors.xml");
+  writeFileSync(join2(output, "app/src/main/res/values/colors.xml"), colorsXml);
+  const darkColorsPath = join2(output, "app/src/main/res/values-night/colors.xml");
   if (config.backgroundColorDark) {
     writeFileSync(darkColorsPath, `<?xml version="1.0" encoding="utf-8"?>
 <resources>
@@ -705,9 +760,9 @@ zipStorePath=wrapper/dists
 </vector>
 `;
   if (config.appIconPath) {
-    cpSync(config.appIconPath, join(output, `app/src/main/res/drawable/craft_app_icon${appIconExtension}`));
+    cpSync(config.appIconPath, join2(output, `app/src/main/res/drawable/craft_app_icon${appIconExtension}`));
   } else {
-    writeFileSync(join(output, "app/src/main/res/drawable/craft_app_icon.xml"), appIconXml);
+    writeFileSync(join2(output, "app/src/main/res/drawable/craft_app_icon.xml"), appIconXml);
   }
   const themesXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
@@ -718,7 +773,7 @@ zipStorePath=wrapper/dists
     </style>
 </resources>
 `;
-  writeFileSync(join(output, "app/src/main/res/values/themes.xml"), themesXml);
+  writeFileSync(join2(output, "app/src/main/res/values/themes.xml"), themesXml);
   const activityMainXml = config.renderer === "native" ? `<?xml version="1.0" encoding="utf-8"?>
 <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:id="@+id/native_root"
@@ -738,7 +793,7 @@ zipStorePath=wrapper/dists
 
 </androidx.coordinatorlayout.widget.CoordinatorLayout>
 `;
-  writeFileSync(join(output, "app/src/main/res/layout/activity_main.xml"), activityMainXml);
+  writeFileSync(join2(output, "app/src/main/res/layout/activity_main.xml"), activityMainXml);
   const placeholderHtml = `<!DOCTYPE html>
 <html>
 <head>
@@ -776,7 +831,7 @@ zipStorePath=wrapper/dists
   </script>
 </body>
 </html>`;
-  writeFileSync(join(output, "app/src/main/assets/index.html"), placeholderHtml);
+  writeFileSync(join2(output, "app/src/main/assets/index.html"), placeholderHtml);
   const runtimeDir = resolveRuntimeDir(options.runtimeDir);
   if (runtimeDir) {
     installRuntime(output, runtimeDir);
@@ -800,19 +855,19 @@ async function build(options) {
   const { htmlPath, nativeBundlePath, devServer, output, release, bundle, compile = true } = options;
   console.log(`
 \uD83D\uDCE6 Building Craft Android project...`);
-  const configPath = join(output, "craft.config.json");
+  const configPath = join2(output, "craft.config.json");
   if (!existsSync(configPath)) {
     throw new Error(`No craft.config.json found in ${output}. Run 'craft android init' first.`);
   }
-  const config = JSON.parse(readFileSync(configPath, "utf-8"));
+  const config = JSON.parse(readFileSync2(configPath, "utf-8"));
   validateAndroidConfig(config);
   if (config.renderer === "native") {
     if (htmlPath || devServer)
       throw new Error("A native Android screen cannot use --html-path or --dev-server.");
-    const destination = join(output, "app/src/main/assets/native-screen.js");
+    const destination = join2(output, "app/src/main/assets/native-screen.js");
     if (nativeBundlePath && resolve(nativeBundlePath) !== resolve(destination))
       cpSync(nativeBundlePath, destination);
-    const icons = join(output, "app/src/main/assets/craft-icons.json");
+    const icons = join2(output, "app/src/main/assets/craft-icons.json");
     if (options.iconsPath) {
       requireRegularFile(options.iconsPath, "Icon table");
       if (resolve(options.iconsPath) !== resolve(icons))
@@ -824,7 +879,7 @@ async function build(options) {
   } else if (nativeBundlePath) {
     throw new Error('--native-bundle requires renderer: "native" in craft.config.json.');
   }
-  if (existsSync(join(output, "app/src/main/jniLibs"))) {
+  if (existsSync(join2(output, "app/src/main/jniLibs"))) {
     const runtimeDir = resolveRuntimeDir(options.runtimeDir);
     if (runtimeDir) {
       installRuntime(output, runtimeDir);
@@ -851,7 +906,7 @@ async function build(options) {
   }
   if (!compile)
     return;
-  const gradlewPath = join(output, "gradlew");
+  const gradlewPath = join2(output, "gradlew");
   if (!existsSync(gradlewPath)) {
     console.log("   Generating Gradle wrapper...");
     try {
@@ -898,13 +953,13 @@ async function run(options) {
   await build({ output });
   console.log("\uD83D\uDCF1 Installing and running on device...");
   try {
-    const apkPath = join(output, "app/build/outputs/apk/debug/app-debug.apk");
+    const apkPath = join2(output, "app/build/outputs/apk/debug/app-debug.apk");
     if (device) {
       await $`adb -s ${device} install -r ${apkPath}`;
     } else {
       await $`adb install -r ${apkPath}`;
     }
-    const config = JSON.parse(readFileSync(join(output, "craft.config.json"), "utf-8"));
+    const config = JSON.parse(readFileSync2(join2(output, "craft.config.json"), "utf-8"));
     const launchCmd = `${config.packageName}/.MainActivity`;
     if (device) {
       await $`adb -s ${device} shell am start -n ${launchCmd}`;
@@ -921,6 +976,7 @@ async function run(options) {
 }
 export {
   syncAndroidWebAssets,
+  runKotlinFixture,
   run,
   resolveRuntimeDir,
   renderAndroidPermissions,

package/dist/android/src/testing.d.ts

@@ -0,0 +1,2 @@
+/** Uses the Android builder's Kotlin version, including its transitive compiler dependencies. */
+export declare function runKotlinFixture(source: string): Promise<void>;