craft-native 0.0.237 → 0.0.241

package/dist/android/src/index.js

@@ -1,9 +1,51 @@
 // @bun
 // ../android/src/index.ts
-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";
+import { cpSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync as rmSync2, statSync, writeFileSync } from "fs";
+import { dirname as dirname2, extname, isAbsolute as isAbsolute2, join as join3, relative, resolve as resolve2, sep } from "path";
 var {$ } = globalThis.Bun;
 
+// ../android/src/native-map.ts
+function androidMapHost(provider = "google") {
+  if (provider === "google")
+    return {
+      template: "CraftNativeMapGoogle.kt.template",
+      imports: `import com.google.android.gms.maps.CameraUpdateFactory
+import com.google.android.gms.maps.GoogleMap
+import com.google.android.gms.maps.MapView
+import com.google.android.gms.maps.OnMapReadyCallback
+import com.google.android.gms.maps.model.BitmapDescriptorFactory
+import com.google.android.gms.maps.model.LatLng
+import com.google.android.gms.maps.model.LatLngBounds
+import com.google.android.gms.maps.model.Marker
+import com.google.android.gms.maps.model.MarkerOptions
+import com.google.android.gms.maps.model.Polyline
+import com.google.android.gms.maps.model.PolylineOptions`,
+      dependency: "com.google.android.gms:play-services-maps:18.2.0"
+    };
+  if (provider === "maplibre")
+    return {
+      template: "CraftNativeMapLibre.kt.template",
+      imports: `import org.maplibre.android.MapLibre
+import org.maplibre.android.camera.CameraPosition
+import org.maplibre.android.camera.CameraUpdateFactory
+import org.maplibre.android.geometry.LatLng
+import org.maplibre.android.geometry.LatLngBounds
+import org.maplibre.android.location.LocationComponentActivationOptions
+import org.maplibre.android.maps.MapLibreMap
+import org.maplibre.android.maps.MapView
+import org.maplibre.android.maps.OnMapReadyCallback
+import org.maplibre.android.maps.Style
+import org.maplibre.android.style.expressions.Expression
+import org.maplibre.android.style.layers.CircleLayer
+import org.maplibre.android.style.layers.LineLayer
+import org.maplibre.android.style.layers.SymbolLayer
+import org.maplibre.android.style.layers.PropertyFactory.*
+import org.maplibre.android.style.sources.GeoJsonSource`,
+      dependency: "org.maplibre.gl:android-sdk:13.7.1"
+    };
+  throw new Error(`Unknown Android native map provider: ${provider}. Expected google or maplibre.`);
+}
+
 // ../android/src/promise-runtime.ts
 var ANDROID_PROMISE_RUNTIME = `
 if (window.__craftRejectPendingPromises) {
@@ -132,10 +174,192 @@ tasks.register('runFixture', JavaExec) {
     await rm(directory, { recursive: true, force: true });
   }
 }
+// ../android/src/emulator.ts
+import { appendFileSync, closeSync, mkdirSync, mkdtempSync, openSync, rmSync } from "fs";
+import { availableParallelism, cpus, tmpdir as tmpdir2, totalmem } from "os";
+import { basename, isAbsolute, join as join2, resolve } from "path";
+async function createAndroidEmulator(options) {
+  if (!["darwin", "linux"].includes(process.platform))
+    throw new Error("Android emulator sessions require macOS or Linux");
+  if (!["hardware", "software"].includes(options.acceleration))
+    throw new Error("Select hardware or software Android emulation explicitly");
+  if (![options.sdkmanager, options.avdmanager].every(isAbsolute))
+    throw new Error("Select absolute Android command-line tool paths");
+  const abi = process.arch === "arm64" ? "arm64-v8a" : process.arch === "x64" ? "x86_64" : undefined;
+  if (!abi || !/^system-images;android-\d+;[^;\s]+;[^;\s]+$/.test(options.image) || !options.image.endsWith(`;${abi}`))
+    throw new Error("The Android system image must match the host architecture");
+  if (options.acceleration === "software" && process.arch !== "x64")
+    throw new Error("Android software emulation requires an x86_64 host and system image");
+  const bootTimeoutMs = options.bootTimeoutMs ?? 600000;
+  const maximumBootTimeoutMs = options.acceleration === "software" ? 1200000 : 600000;
+  if (!Number.isSafeInteger(bootTimeoutMs) || bootTimeoutMs < 1000 || bootTimeoutMs > maximumBootTimeoutMs)
+    throw new Error(`Android bootTimeoutMs must be an integer between 1000 and ${maximumBootTimeoutMs} milliseconds`);
+  const port = options.port ?? 5558;
+  if (!Number.isInteger(port) || port < 5554 || port > 5682 || port % 2 !== 0)
+    throw new Error("Android console ports must be even and between 5554 and 5682");
+  const sdk = resolve(options.sdkRoot);
+  const artifacts = resolve(options.artifactsDirectory);
+  const temporary = options.temporaryDirectory ?? tmpdir2();
+  mkdirSync(artifacts, { recursive: true });
+  mkdirSync(temporary, { recursive: true });
+  const owned = mkdtempSync(join2(temporary, "craft-android-emulator-"));
+  const name = basename(owned);
+  const serial = `emulator-${port}`;
+  const env = {
+    ...process.env,
+    ...options.env,
+    ANDROID_HOME: sdk,
+    ANDROID_SDK_ROOT: sdk,
+    ANDROID_SDK_HOME: owned,
+    ANDROID_USER_HOME: join2(owned, ".android"),
+    ANDROID_EMULATOR_HOME: join2(owned, ".android"),
+    ANDROID_AVD_HOME: join2(owned, "avd"),
+    ANDROID_SERIAL: serial,
+    AVDMANAGER_OPTS: `'-Dcom.android.sdkmanager.toolsdir=${join2(sdk, "cmdline-tools/latest")}'`
+  };
+  const adb = join2(sdk, "platform-tools/adb");
+  const executable = join2(sdk, "emulator/emulator");
+  let child;
+  let log;
+  let created = false;
+  let sequence = 0;
+  let disposal;
+  let bootStartedAt = 0;
+  let cpuStart = 0;
+  let idleStart = 0;
+  let identity;
+  async function recordBootResult(status, endedAt = Date.now()) {
+    if (!identity)
+      return;
+    const cpuEnd = cpus();
+    const totalDeltaMs = cpuEnd.reduce((total, cpu) => total + Object.values(cpu.times).reduce((sum, value) => sum + value, 0), 0) - cpuStart;
+    const idleDeltaMs = cpuEnd.reduce((total, cpu) => total + cpu.times.idle, 0) - idleStart;
+    await Bun.write(join2(artifacts, "android-emulator.json"), JSON.stringify({
+      ...identity,
+      status,
+      [status === "booted" ? "bootedAt" : "failedAt"]: new Date(endedAt).toISOString(),
+      bootElapsedMs: endedAt - bootStartedAt,
+      hostCpuInterval: { totalDeltaMs, idleDeltaMs, busyDeltaMs: totalDeltaMs - idleDeltaMs }
+    }, null, 2) + `
+`);
+  }
+  async function run(args, input, timeout = 900000, allowFailure = false) {
+    const startedAt = new Date().toISOString();
+    const command = Bun.spawn(args, { env, stdin: input === undefined ? "ignore" : new TextEncoder().encode(input), stdout: "pipe", stderr: "pipe", signal: AbortSignal.timeout(timeout) });
+    const [code, stdout, stderr] = await Promise.all([command.exited, new Response(command.stdout).text(), new Response(command.stderr).text()]);
+    appendFileSync(join2(artifacts, "device-commands.jsonl"), JSON.stringify({ sequence: ++sequence, startedAt, finishedAt: new Date().toISOString(), args, code, stdout, stderr }) + `
+`);
+    if (code !== 0 && !allowFailure)
+      throw new Error(`${basename(args[0])} failed with exit ${code}; inspect ${artifacts}`);
+    return { code, stdout };
+  }
+  const dispose = () => disposal ??= (async () => {
+    try {
+      if (child && child.exitCode === null) {
+        child.kill("SIGTERM");
+        await Promise.race([child.exited, Bun.sleep(1e4)]);
+        if (child.exitCode === null)
+          child.kill("SIGKILL");
+        await child.exited;
+      }
+      if (created)
+        await run([options.avdmanager, "delete", "avd", "--name", name], undefined, 30000);
+    } finally {
+      if (log !== undefined)
+        closeSync(log);
+      rmSync(owned, { recursive: true, force: true });
+    }
+  })();
+  try {
+    mkdirSync(env.ANDROID_AVD_HOME, { recursive: true });
+    mkdirSync(env.ANDROID_USER_HOME, { recursive: true });
+    if (options.acceptLicenses)
+      await run([options.sdkmanager, `--sdk_root=${sdk}`, "--licenses"], `y
+`.repeat(100));
+    await run([options.sdkmanager, `--sdk_root=${sdk}`, "platform-tools", "emulator"], options.acceptLicenses ? `y
+`.repeat(100) : undefined);
+    const acceleration = await run([executable, "-accel-check"], undefined, 30000, true);
+    if (options.acceleration === "hardware" && acceleration.code !== 0)
+      throw new Error(`Android hardware acceleration is unavailable; inspect ${artifacts}`);
+    await run([options.sdkmanager, `--sdk_root=${sdk}`, options.image], options.acceptLicenses ? `y
+`.repeat(100) : undefined);
+    const devices = (await run([adb, "devices"], undefined, 1e4)).stdout;
+    if (devices.split(`
+`).some((line) => line.startsWith(`${serial}	`)))
+      throw new Error(`${serial} is already in use`);
+    await run([options.avdmanager, "create", "avd", "--name", name, "--package", options.image, "--device", "pixel_6"], `no
+`);
+    created = true;
+    log = openSync(join2(artifacts, "emulator.log"), "w");
+    bootStartedAt = Date.now();
+    const hostCpus = cpus();
+    cpuStart = hostCpus.reduce((total, cpu) => total + Object.values(cpu.times).reduce((sum, value) => sum + value, 0), 0);
+    idleStart = hostCpus.reduce((total, cpu) => total + cpu.times.idle, 0);
+    child = Bun.spawn([executable, "-avd", name, "-port", String(port), "-no-window", "-no-snapshot", "-no-audio", "-no-boot-anim", "-gpu", "software", "-memory", "2048", "-cores", "2", "-accel", options.acceleration === "software" ? "off" : "on"], { env, stdout: log, stderr: log });
+    identity = {
+      image: options.image,
+      acceleration: options.acceleration,
+      accelerationProbeExitCode: acceleration.code,
+      bootTimeoutMs,
+      bootStartedAt: new Date(bootStartedAt).toISOString(),
+      host: { cpuModel: hostCpus[0]?.model, logicalCpus: hostCpus.length, availableParallelism: availableParallelism(), memoryBytes: totalmem() },
+      virtualCpus: 2,
+      memoryMb: 2048,
+      serial,
+      avdDirectory: env.ANDROID_AVD_HOME,
+      emulatorPid: child.pid
+    };
+    await Bun.write(join2(artifacts, "android-emulator.json"), JSON.stringify(identity, null, 2) + `
+`);
+    const deadline = bootStartedAt + bootTimeoutMs;
+    const probeTimeout = () => Math.max(1, Math.min(1e4, deadline - Date.now()));
+    while (Date.now() < deadline && child.exitCode === null) {
+      let booted = false;
+      const connection = await run([adb, "devices"], undefined, probeTimeout(), true);
+      if (connection.code === 0 && connection.stdout.includes(`${serial}	device`)) {
+        const completion = await run([adb, "-s", serial, "shell", "getprop", "sys.boot_completed"], undefined, probeTimeout(), true);
+        if (completion.code === 0 && completion.stdout.trim() === "1") {
+          const settings = await run([adb, "-s", serial, "shell", "settings", "get", "global", "animator_duration_scale"], undefined, probeTimeout(), true);
+          const packages = await run([adb, "-s", serial, "shell", "pm", "path", "android"], undefined, probeTimeout(), true);
+          const systemUi = await run([adb, "-s", serial, "shell", "pidof", "com.android.systemui"], undefined, probeTimeout(), true);
+          const events = await run([adb, "-s", serial, "logcat", "-b", "events", "-d", "-t", "1"], undefined, probeTimeout(), true);
+          booted = settings.code === 0 && packages.code === 0 && systemUi.code === 0 && events.code === 0 && /^package:\/\S+/m.test(packages.stdout) && /^\d+(?:\s+\d+)*$/.test(systemUi.stdout.trim());
+        }
+      }
+      const checkedAt = Date.now();
+      if (booted && checkedAt <= deadline) {
+        await recordBootResult("booted", checkedAt);
+        return { serial, adb, env, dispose };
+      }
+      await Bun.sleep(Math.min(2000, Math.max(0, deadline - Date.now())));
+    }
+    throw new Error(`The owned Android emulator did not boot within ${bootTimeoutMs}ms; inspect ${artifacts}`);
+  } catch (error) {
+    if (child) {
+      try {
+        await recordBootResult("failed");
+      } catch (diagnostic) {
+        console.error(`Could not retain emulator boot timing: ${diagnostic}`);
+      }
+      for (const args of [["logcat", "-d", "-b", "all"], ["shell", "getprop"], ["shell", "dumpsys", "activity", "processes"]]) {
+        try {
+          await run([adb, "-s", serial, ...args], undefined, 1e4, true);
+        } catch {}
+      }
+    }
+    try {
+      await dispose();
+    } catch (cleanup) {
+      throw new AggregateError([error, cleanup], "Android emulator setup and cleanup failed");
+    }
+    throw error;
+  }
+}
 
 // ../android/src/index.ts
+var nativeMapProviders = ["google", "maplibre"];
 function syncNativeFonts(fonts, output) {
-  const destination = join2(output, "app/src/main/assets/NativeFonts");
+  const destination = join3(output, "app/src/main/assets/NativeFonts");
   const names = new Set;
   const files = Object.entries(fonts ?? {}).map(([family, entry]) => {
     if (!/^[A-Za-z0-9][A-Za-z0-9_.-]*$/.test(family))
@@ -143,7 +367,7 @@ function syncNativeFonts(fonts, output) {
     if (names.has(family.toLowerCase()))
       throw new Error(`Duplicate native font name: ${family}`);
     names.add(family.toLowerCase());
-    if ([entry.src, entry.license].some((file) => file && resolve(file).startsWith(resolve(destination) + sep)))
+    if ([entry.src, entry.license].some((file) => file && resolve2(file).startsWith(resolve2(destination) + sep)))
       throw new Error("Native font sources must be outside the generated NativeFonts directory");
     const extension = extname(entry.src).toLowerCase();
     if (![".ttf", ".otf"].includes(extension) || !existsSync(entry.src) || !statSync(entry.src).isFile())
@@ -152,23 +376,23 @@ function syncNativeFonts(fonts, output) {
       throw new Error(`Native font license not found: ${entry.license}`);
     return { family, ...entry, filename: `${family}${extension}` };
   });
-  rmSync(destination, { recursive: true, force: true });
+  rmSync2(destination, { recursive: true, force: true });
   if (!files.length)
     return [];
-  mkdirSync(destination, { recursive: true });
+  mkdirSync2(destination, { recursive: true });
   for (const file of files) {
-    cpSync(file.src, join2(destination, file.filename));
+    cpSync(file.src, join3(destination, file.filename));
     if (file.license)
-      cpSync(file.license, join2(destination, `${file.family}.LICENSE.txt`));
+      cpSync(file.license, join3(destination, `${file.family}.LICENSE.txt`));
   }
   return files.map((file) => `NativeFonts/${file.filename}`);
 }
-var TEMPLATES_DIR = join2(dirname2(import.meta.dir), "templates");
+var TEMPLATES_DIR = join3(dirname2(import.meta.dir), "templates");
 function resolveCraftAndroidVersion(startDir = import.meta.dir) {
-  let directory = resolve(startDir);
+  let directory = resolve2(startDir);
   while (true) {
     try {
-      const pkg = JSON.parse(readFileSync2(join2(directory, "package.json"), "utf8"));
+      const pkg = JSON.parse(readFileSync2(join3(directory, "package.json"), "utf8"));
       if ((pkg.name === "@craft-native/android" || pkg.name === "craft-native") && typeof pkg.version === "string" && pkg.version)
         return pkg.version;
     } catch {}
@@ -305,7 +529,7 @@ function requireRegularFile(path, label) {
 }
 function containsPath(parent, candidate) {
   const relativePath = relative(parent, candidate);
-  return relativePath === "" || relativePath !== ".." && !relativePath.startsWith(`..${sep}`) && !isAbsolute(relativePath);
+  return relativePath === "" || relativePath !== ".." && !relativePath.startsWith(`..${sep}`) && !isAbsolute2(relativePath);
 }
 function validateGoogleServicesFile(path, packageName) {
   requireRegularFile(path, "Google services file");
@@ -368,6 +592,7 @@ function normalizeAndroidNetworkConfig(config) {
   config.trustedOrigins = [...new Set(trustedOrigins)];
 }
 function validateAndroidConfig(config) {
+  androidMapHost(config.mapProvider);
   if (!config.appName.trim())
     throw new Error("Android app name must not be empty");
   if (config.renderer !== undefined && config.renderer !== "web" && config.renderer !== "native") {
@@ -498,36 +723,37 @@ function validateNativeRouteConfig(config) {
   }
 }
 function writeAndroidConfig(output, config) {
-  writeFileSync(join2(output, "craft.config.json"), JSON.stringify(config, null, 2));
+  writeFileSync(join3(output, "craft.config.json"), JSON.stringify(config, null, 2));
   const runtimeConfig = { ...config };
   delete runtimeConfig.appIconPath;
+  delete runtimeConfig.notificationIconPath;
   delete runtimeConfig.googleServicesFile;
-  writeFileSync(join2(output, "app/src/main/assets/craft.config.json"), JSON.stringify(runtimeConfig, null, 2));
+  writeFileSync(join3(output, "app/src/main/assets/craft.config.json"), JSON.stringify(runtimeConfig, null, 2));
 }
 function syncAndroidWebAssets(source, output) {
-  const sourcePath = resolve(source);
+  const sourcePath = resolve2(source);
   if (!existsSync(sourcePath))
     throw new Error(`Web asset path not found: ${source}`);
   const sourceStat = statSync(sourcePath);
   if (!sourceStat.isDirectory() && !sourceStat.isFile()) {
     throw new Error(`Web asset path must be a file or directory: ${source}`);
   }
-  const assetsDir = resolve(output, "app/src/main/assets");
+  const assetsDir = resolve2(output, "app/src/main/assets");
   if (containsPath(sourcePath, assetsDir) || containsPath(assetsDir, sourcePath)) {
     throw new Error(`Web asset source must not overlap generated asset directory: ${source}`);
   }
   if (sourceStat.isDirectory()) {
-    requireRegularFile(join2(sourcePath, "index.html"), "Web asset directory entry point");
+    requireRegularFile(join3(sourcePath, "index.html"), "Web asset directory entry point");
   }
-  const configPath = join2(assetsDir, "craft.config.json");
+  const configPath = join3(assetsDir, "craft.config.json");
   const config = existsSync(configPath) ? readFileSync2(configPath) : undefined;
-  rmSync(assetsDir, { recursive: true, force: true });
-  mkdirSync(assetsDir, { recursive: true });
+  rmSync2(assetsDir, { recursive: true, force: true });
+  mkdirSync2(assetsDir, { recursive: true });
   if (sourceStat.isDirectory())
     cpSync(sourcePath, assetsDir, { recursive: true });
   else
-    cpSync(sourcePath, join2(assetsDir, "index.html"));
-  if (!existsSync(join2(assetsDir, "index.html")))
+    cpSync(sourcePath, join3(assetsDir, "index.html"));
+  if (!existsSync(join3(assetsDir, "index.html")))
     throw new Error(`Web asset directory must contain index.html: ${source}`);
   if (config)
     writeFileSync(configPath, config);
@@ -571,10 +797,10 @@ function renderAndroidPermissions(config) {
 `);
 }
 function writeNativeShellSources(output, packagePath, packageName, config) {
-  const javaDir = join2(output, "app/src/main/java", packagePath);
+  const javaDir = join3(output, "app/src/main/java", packagePath);
   const write = (template, file, replace = (source) => source) => {
-    const source = readFileSync2(join2(TEMPLATES_DIR, template), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, packageName);
-    writeFileSync(join2(javaDir, file), replace(source));
+    const source = readFileSync2(join3(TEMPLATES_DIR, template), "utf-8").replace(/\{\{PACKAGE_NAME\}\}/g, packageName);
+    writeFileSync(join3(javaDir, file), replace(source));
   };
   write("CraftBluetooth.kt.template", "CraftBluetooth.kt");
   write("CraftNativeShell.kt.template", "CraftNativeShell.kt");
@@ -596,9 +822,9 @@ function writeNativeShellSources(output, packagePath, packageName, config) {
   if (config.enablePushNotifications)
     write("CraftNativeMessagingService.kt.template", "CraftNativeMessagingService.kt");
   else
-    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"?>
+    rmSync2(join3(javaDir, "CraftNativeMessagingService.kt"), { force: true });
+  mkdirSync2(join3(output, "app/src/main/res/xml"), { recursive: true });
+  writeFileSync(join3(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/" />
@@ -621,7 +847,9 @@ function renderNativeShellManifest(config) {
             <intent-filter>
                 <action android:name="com.google.firebase.MESSAGING_EVENT" />
             </intent-filter>
-        </service>`);
+        </service>
+        <meta-data android:name="com.google.firebase.messaging.default_notification_icon" android:resource="@drawable/craft_notification_icon" />${config.notificationColor ? `
+        <meta-data android:name="com.google.firebase.messaging.default_notification_color" android:resource="@color/craft_notification_color" />` : ""}`);
   }
   if (config.enableHealthConnect) {
     parts.push(`        <activity-alias
@@ -677,7 +905,7 @@ function resolveRuntimeDir(override) {
   return dir;
 }
 function installRuntime(output, runtimeDir) {
-  const found = RUNTIME_ABIS.map((abi) => ({ abi, source: join2(runtimeDir, abi, "libcraft.so") })).filter((entry) => existsSync(entry.source));
+  const found = RUNTIME_ABIS.map((abi) => ({ abi, source: join3(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.");
   }
@@ -685,12 +913,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 = join2(output, "app/src/main/jniLibs");
-  rmSync(dest, { force: true, recursive: true });
+  const dest = join3(output, "app/src/main/jniLibs");
+  rmSync2(dest, { force: true, recursive: true });
   for (const { abi, source } of found) {
-    const abiDir = join2(dest, abi);
-    mkdirSync(abiDir, { recursive: true });
-    cpSync(source, join2(abiDir, "libcraft.so"));
+    const abiDir = join3(dest, abi);
+    mkdirSync2(abiDir, { recursive: true });
+    cpSync(source, join3(abiDir, "libcraft.so"));
   }
   return true;
 }
@@ -731,48 +959,60 @@ async function init(options) {
   if (config.appIconPath && ![".gif", ".jpg", ".png", ".webp"].includes(appIconExtension ?? "")) {
     throw new Error(`Unsupported Android app icon format: ${appIconExtension || "(none)"}`);
   }
+  if (config.notificationIconPath)
+    requireRegularFile(config.notificationIconPath, "Notification icon");
+  const notificationIconExtension = config.notificationIconPath ? extname(config.notificationIconPath).toLowerCase() : undefined;
+  if (config.notificationIconPath && ![".png", ".xml"].includes(notificationIconExtension ?? "")) {
+    throw new Error(`Unsupported Android notification icon format: ${notificationIconExtension || "(none)"} (use a vector drawable .xml or a white-on-transparent .png)`);
+  }
+  if (config.notificationIconPath && notificationIconExtension === ".xml" && !/<vector[\s>]/.test(readFileSync2(config.notificationIconPath, "utf8"))) {
+    throw new Error("Notification icon .xml must be an Android vector drawable (<vector>)");
+  }
+  if (config.notificationColor !== undefined && !/^#[0-9a-f]{6}$/i.test(config.notificationColor)) {
+    throw new Error(`notificationColor must be #RRGGBB, not ${String(config.notificationColor)}`);
+  }
   const dirs = [
     output,
-    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")
+    join3(output, "app/src/main/java", packagePath),
+    join3(output, "app/src/main/res/layout"),
+    join3(output, "app/src/main/res/values"),
+    join3(output, "app/src/main/res/values-night"),
+    join3(output, "app/src/main/res/drawable"),
+    join3(output, "app/src/main/assets"),
+    join3(output, "gradle/wrapper")
   ];
   if (existsSync(output) && !statSync(output).isDirectory()) {
     throw new Error(`Android project output must be a directory: ${output}`);
   }
   for (const dir of dirs) {
     if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
+      mkdirSync2(dir, { recursive: true });
     }
   }
   writeAndroidConfig(output, config);
   const hasGoogleServices = Boolean(config.googleServicesFile);
   if (config.googleServicesFile) {
-    cpSync(config.googleServicesFile, join2(output, "app/google-services.json"));
+    cpSync(config.googleServicesFile, join3(output, "app/google-services.json"));
   }
-  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(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));
+  const mainActivityTemplate = readFileSync2(join3(TEMPLATES_DIR, config.renderer === "native" ? "MainActivityNative.kt.template" : "MainActivity.kt.template"), "utf-8");
+  const mainActivity = mainActivityTemplate.replace(/\{\{NATIVE_MAP_IMPORTS\}\}/g, () => androidMapHost(config.mapProvider).imports).replace(/\{\{NATIVE_MAP_HOST\}\}/g, () => readFileSync2(join3(TEMPLATES_DIR, androidMapHost(config.mapProvider).template), "utf8")).replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{APP_NAME\}\}/g, name);
+  writeFileSync(join3(output, "app/src/main/java", packagePath, "MainActivity.kt"), mainActivity);
+  writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftAppLinks.kt"), readFileSync2(join3(TEMPLATES_DIR, "CraftAppLinks.kt.template"), "utf8").replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftCrashReporter.kt"), readFileSync2(join3(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 = 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));
+    const mutationTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftNativeMutation.kt.template"), "utf-8");
+    const flatListTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftNativeFlatList.kt.template"), "utf-8");
+    const refreshableFlatListTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftNativeRefreshableFlatList.kt.template"), "utf-8");
+    const capabilityTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftNativeCapabilities.kt.template"), "utf-8");
+    const notificationTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftNativeNotificationReceiver.kt.template"), "utf-8");
+    writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftNativeMutation.kt"), mutationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftNativeFlatList.kt"), flatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftNativeRefreshableFlatList.kt"), refreshableFlatListTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftNativeCapabilities.kt"), capabilityTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+    writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftNativeNotificationReceiver.kt"), notificationTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
     writeNativeShellSources(output, packagePath, finalPackageName, config);
   }
-  const craftBridgeTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftBridge.kt.template"), "utf-8");
+  const craftBridgeTemplate = readFileSync2(join3(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) {
@@ -792,17 +1032,17 @@ async function init(options) {
         }` : `evaluatePromiseJavascript(
             "window._craftPushReject && window._craftPushReject('Push notifications are disabled')"
         )`);
-  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(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>
+  writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftBridge.kt"), craftBridge);
+  const craftNative = readFileSync2(join3(TEMPLATES_DIR, "CraftNative.kt.template"), "utf-8");
+  const nativeDir = join3(output, "app/src/main/java/com/craft/runtime");
+  mkdirSync2(nativeDir, { recursive: true });
+  writeFileSync(join3(nativeDir, "CraftNative.kt"), craftNative);
+  const serviceTemplate = readFileSync2(join3(TEMPLATES_DIR, "LocationRecordingService.kt.template"), "utf-8");
+  writeFileSync(join3(nativeDir, "LocationRecordingService.kt"), serviceTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  const healthTemplate = readFileSync2(join3(TEMPLATES_DIR, config.enableHealthConnect ? "CraftHealthConnect.kt.template" : "CraftHealthConnectStub.kt.template"), "utf-8");
+  writeFileSync(join3(output, "app/src/main/java", packagePath, "CraftHealthConnect.kt"), healthTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  const manifestTemplate = readFileSync2(join3(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.mapProvider !== "maplibre" && 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>
                 <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
@@ -811,28 +1051,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(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")
+  writeFileSync(join3(output, "app/src/main/AndroidManifest.xml"), manifest);
+  const projectGradleTemplate = readFileSync2(join3(TEMPLATES_DIR, "build.gradle.kts.project.template"), "utf-8");
+  writeFileSync(join3(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(join3(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(/\{\{NATIVE_MAP_DEPENDENCY\}\}/g, config.renderer === "native" ? `    // Native STX Map overlays and trail routes
+    implementation("${androidMapHost(config.mapProvider).dependency}")` : "").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")
     // Native background refresh (WorkManager).
     implementation("androidx.work:work-runtime-ktx:2.9.1")` : "");
-  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");
+  writeFileSync(join3(output, "app/build.gradle.kts"), appGradle);
+  const proguardTemplate = readFileSync2(join3(TEMPLATES_DIR, "proguard-rules.pro.template"), "utf-8");
+  writeFileSync(join3(output, "app/proguard-rules.pro"), proguardTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName));
+  const settingsTemplate = readFileSync2(join3(TEMPLATES_DIR, "settings.gradle.kts.template"), "utf-8");
   const settings = settingsTemplate.replace(/\{\{APP_NAME\}\}/g, escapeKotlinString(generatedGradleProjectName(name)));
-  writeFileSync(join2(output, "settings.gradle.kts"), settings);
+  writeFileSync(join3(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(join2(output, "gradle.properties"), gradleProperties);
-  writeFileSync(join2(output, "local.properties"), `# SDK location will be set by Android Studio
+  writeFileSync(join3(output, "gradle.properties"), gradleProperties);
+  writeFileSync(join3(output, "local.properties"), `# SDK location will be set by Android Studio
 `);
   const gradleWrapperProps = `distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
@@ -842,23 +1082,25 @@ validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
 `;
-  writeFileSync(join2(output, "gradle/wrapper/gradle-wrapper.properties"), gradleWrapperProps);
+  writeFileSync(join3(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(join2(output, "app/src/main/res/values/strings.xml"), stringsXml);
+  writeFileSync(join3(output, "app/src/main/res/values/strings.xml"), stringsXml);
   const colorsXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
     <color name="primary">#1a1a2e</color>
     <color name="primary_dark">#16162b</color>
     <color name="accent">#4ade80</color>
     <color name="background">${config.backgroundColor}</color>
+    <!-- Transparent is NotificationCompat's COLOR_DEFAULT: the system picks. -->
+    <color name="craft_notification_color">${config.notificationColor ?? "#00000000"}</color>
 </resources>
 `;
-  writeFileSync(join2(output, "app/src/main/res/values/colors.xml"), colorsXml);
-  const darkColorsPath = join2(output, "app/src/main/res/values-night/colors.xml");
+  writeFileSync(join3(output, "app/src/main/res/values/colors.xml"), colorsXml);
+  const darkColorsPath = join3(output, "app/src/main/res/values-night/colors.xml");
   if (config.backgroundColorDark) {
     writeFileSync(darkColorsPath, `<?xml version="1.0" encoding="utf-8"?>
 <resources>
@@ -866,7 +1108,7 @@ zipStorePath=wrapper/dists
 </resources>
 `);
   } else {
-    rmSync(darkColorsPath, { force: true });
+    rmSync2(darkColorsPath, { force: true });
   }
   const appIconXml = `<?xml version="1.0" encoding="utf-8"?>
 <vector xmlns:android="http://schemas.android.com/apk/res/android"
@@ -879,9 +1121,24 @@ zipStorePath=wrapper/dists
 </vector>
 `;
   if (config.appIconPath) {
-    cpSync(config.appIconPath, join2(output, `app/src/main/res/drawable/craft_app_icon${appIconExtension}`));
+    cpSync(config.appIconPath, join3(output, `app/src/main/res/drawable/craft_app_icon${appIconExtension}`));
+  } else {
+    writeFileSync(join3(output, "app/src/main/res/drawable/craft_app_icon.xml"), appIconXml);
+  }
+  for (const extension of [".png", ".xml"])
+    rmSync2(join3(output, `app/src/main/res/drawable/craft_notification_icon${extension}`), { force: true });
+  if (config.notificationIconPath) {
+    cpSync(config.notificationIconPath, join3(output, `app/src/main/res/drawable/craft_notification_icon${notificationIconExtension}`));
   } else {
-    writeFileSync(join2(output, "app/src/main/res/drawable/craft_app_icon.xml"), appIconXml);
+    writeFileSync(join3(output, "app/src/main/res/drawable/craft_notification_icon.xml"), `<?xml version="1.0" encoding="utf-8"?>
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="108"
+    android:viewportHeight="108">
+    <path android:fillColor="#FFFFFFFF" android:pathData="M18,78L42,42l12,18l12,-12l24,30z" />
+</vector>
+`);
   }
   const themesXml = `<?xml version="1.0" encoding="utf-8"?>
 <resources>
@@ -892,7 +1149,7 @@ zipStorePath=wrapper/dists
     </style>
 </resources>
 `;
-  writeFileSync(join2(output, "app/src/main/res/values/themes.xml"), themesXml);
+  writeFileSync(join3(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"
@@ -912,7 +1169,7 @@ zipStorePath=wrapper/dists
 
 </androidx.coordinatorlayout.widget.CoordinatorLayout>
 `;
-  writeFileSync(join2(output, "app/src/main/res/layout/activity_main.xml"), activityMainXml);
+  writeFileSync(join3(output, "app/src/main/res/layout/activity_main.xml"), activityMainXml);
   syncNativeFonts(config.nativeFonts, output);
   const placeholderHtml = `<!DOCTYPE html>
 <html>
@@ -951,7 +1208,7 @@ zipStorePath=wrapper/dists
   </script>
 </body>
 </html>`;
-  writeFileSync(join2(output, "app/src/main/assets/index.html"), placeholderHtml);
+  writeFileSync(join3(output, "app/src/main/assets/index.html"), placeholderHtml);
   const runtimeDir = resolveRuntimeDir(options.runtimeDir);
   if (runtimeDir) {
     installRuntime(output, runtimeDir);
@@ -975,7 +1232,7 @@ async function build(options) {
   const { htmlPath, nativeBundlePath, devServer, output, release, bundle, compile = true } = options;
   console.log(`
 \uD83D\uDCE6 Building Craft Android project...`);
-  const configPath = join2(output, "craft.config.json");
+  const configPath = join3(output, "craft.config.json");
   if (!existsSync(configPath)) {
     throw new Error(`No craft.config.json found in ${output}. Run 'craft android init' first.`);
   }
@@ -985,13 +1242,13 @@ async function build(options) {
   if (config.renderer === "native") {
     if (htmlPath || devServer)
       throw new Error("A native Android screen cannot use --html-path or --dev-server.");
-    const destination = join2(output, "app/src/main/assets/native-screen.js");
-    if (nativeBundlePath && resolve(nativeBundlePath) !== resolve(destination))
+    const destination = join3(output, "app/src/main/assets/native-screen.js");
+    if (nativeBundlePath && resolve2(nativeBundlePath) !== resolve2(destination))
       cpSync(nativeBundlePath, destination);
-    const icons = join2(output, "app/src/main/assets/craft-icons.json");
+    const icons = join3(output, "app/src/main/assets/craft-icons.json");
     if (options.iconsPath) {
       requireRegularFile(options.iconsPath, "Icon table");
-      if (resolve(options.iconsPath) !== resolve(icons))
+      if (resolve2(options.iconsPath) !== resolve2(icons))
         cpSync(options.iconsPath, icons);
     }
     if (!existsSync(destination)) {
@@ -1000,7 +1257,7 @@ async function build(options) {
   } else if (nativeBundlePath) {
     throw new Error('--native-bundle requires renderer: "native" in craft.config.json.');
   }
-  if (existsSync(join2(output, "app/src/main/jniLibs"))) {
+  if (existsSync(join3(output, "app/src/main/jniLibs"))) {
     const runtimeDir = resolveRuntimeDir(options.runtimeDir);
     if (runtimeDir) {
       installRuntime(output, runtimeDir);
@@ -1028,7 +1285,7 @@ async function build(options) {
   syncNativeFonts(config.nativeFonts, output);
   if (!compile)
     return;
-  const gradlewPath = join2(output, "gradlew");
+  const gradlewPath = join3(output, "gradlew");
   if (!existsSync(gradlewPath)) {
     console.log("   Generating Gradle wrapper...");
     try {
@@ -1075,13 +1332,13 @@ async function run(options) {
   await build({ output });
   console.log("\uD83D\uDCF1 Installing and running on device...");
   try {
-    const apkPath = join2(output, "app/build/outputs/apk/debug/app-debug.apk");
+    const apkPath = join3(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(readFileSync2(join2(output, "craft.config.json"), "utf-8"));
+    const config = JSON.parse(readFileSync2(join3(output, "craft.config.json"), "utf-8"));
     const launchCmd = `${config.packageName}/.MainActivity`;
     if (device) {
       await $`adb -s ${device} shell am start -n ${launchCmd}`;
@@ -1105,9 +1362,11 @@ export {
   renderAndroidPermissions,
   renderAndroidDeepLinks,
   open,
+  nativeMapProviders,
   installRuntime,
   init,
   healthConnectPermissions,
+  createAndroidEmulator,
   build,
   HEALTH_CONNECT_PERMISSIONS,
   ANDROID_MIN_SDK