craft-native 0.0.272 → 0.0.278

package/dist/android/src/index.js

@@ -338,7 +338,7 @@ async function createAndroidEmulator(options) {
           const events = await run([adb, "-s", serial, "logcat", "-b", "events", "-d", "-t", "1"], undefined, probeTimeout(), true);
           const home = await run([adb, "-s", serial, "shell", "cmd", "package", "resolve-activity", "--brief", "-a", "android.intent.action.MAIN", "-c", "android.intent.category.HOME"], undefined, probeTimeout(), true);
           const homeActivity = home.stdout.trim().split(/\r?\n/).at(-1) ?? "";
-          const temporaryHome = homeActivity.startsWith("com.android.sdksetup/") || /^com\.android\.settings\/(?:\.|com\.android\.settings\.)FallbackHome$/.test(homeActivity) || /^android\/.*(?:Resolver|Chooser)Activity$/.test(homeActivity);
+          const temporaryHome = homeActivity.startsWith("com.android.sdksetup/") || homeActivity.startsWith("com.google.android.googlesdksetup/") || /^com\.android\.settings\/(?:\.|com\.android\.settings\.)FallbackHome$/.test(homeActivity) || /^android\/.*(?:Resolver|Chooser)Activity$/.test(homeActivity);
           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()) && (!requiresPlayStore || playStore?.code === 0 && /^package:\/\S+/m.test(playStore.stdout)) && home.code === 0 && /^[\w.]+\/[\w.$]+$/.test(homeActivity) && !temporaryHome;
         }
       }

package/dist/android/templates/CraftNativeMapLibre.kt.template

@@ -16,6 +16,8 @@ internal class CraftNativeMapView(context: Context) : FrameLayout(context), OnMa
     private var pendingChildren = JSONArray()
     private var styleKey: String? = null
     private var styleVersion = 0
+    /** The prefix of a style key that is a vector style's URL, not raster style JSON. */
+    private val vectorStylePrefix = "uri:"
     private var readyStyle: Style? = null
     private var initialCameraKey: String? = null
     private var reportedRegion: LatLngBounds? = null
@@ -146,7 +148,10 @@ internal class CraftNativeMapView(context: Context) : FrameLayout(context), OnMa
             styleKey = nextStyle
             readyStyle = null
             val version = ++styleVersion
-            nativeMap.setStyle(Style.Builder().fromJson(nextStyle)) { loaded ->
+            // A vector style (the standard basemap) loads from its URL; the
+            // raster ones are composed here as style JSON.
+            val builder = if (nextStyle.startsWith(vectorStylePrefix)) Style.Builder().fromUri(nextStyle.removePrefix(vectorStylePrefix)) else Style.Builder().fromJson(nextStyle)
+            nativeMap.setStyle(builder) { loaded ->
                 if (!destroyed && version == styleVersion) {
                     readyStyle = loaded
                     installOverlays(loaded)
@@ -183,6 +188,20 @@ internal class CraftNativeMapView(context: Context) : FrameLayout(context), OnMa
     }
 
     private fun basemapStyle(): String {
+        // `basemap`: the named presets, drawn as well as each can be here.
+        // Standard is OpenFreeMap's vector style - sharp at any density, no
+        // key - where it was raster tiles from tile.openstreetmap.org, whose
+        // policy does not allow an app's traffic. Outdoors is topography with
+        // contours; satellite and hybrid are Esri imagery.
+        when (pendingProps.optString("basemap", "").lowercase()) {
+            "standard" -> {
+                attribution.text = "OpenFreeMap © OpenMapTiles · Data © OpenStreetMap contributors"
+                return vectorStylePrefix + "https://tiles.openfreemap.org/styles/liberty"
+            }
+            "outdoors" -> return rasterStyle("https://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/{z}/{y}/{x}", "Topography: Esri, USGS, NOAA, OpenStreetMap contributors", labels = false)
+            "satellite" -> return rasterStyle("https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}", "Imagery © Esri, Maxar, Earthstar Geographics, and the GIS User Community", labels = false)
+            "hybrid" -> return rasterStyle("https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}", "Imagery © Esri, Maxar, Earthstar Geographics, and the GIS User Community", labels = true)
+        }
         val custom = pendingProps.optJSONObject("tileOverlay")
         val template = custom?.optString("urlTemplate").orEmpty()
         val credit = custom?.optString("attribution").orEmpty()
@@ -212,6 +231,18 @@ internal class CraftNativeMapView(context: Context) : FrameLayout(context), OnMa
         return JSONObject().put("version", 8).put("sources", sources).put("layers", layers).toString()
     }
 
+    private fun rasterStyle(url: String, credit: String, labels: Boolean): String {
+        val sources = JSONObject().put("basemap", rasterSource(url, credit))
+        val layers = JSONArray().put(JSONObject().put("id", "basemap").put("type", "raster").put("source", "basemap"))
+        attribution.text = credit
+        if (labels) {
+            sources.put("labels", rasterSource("https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer/tile/{z}/{y}/{x}", "Labels © Esri"))
+            layers.put(JSONObject().put("id", "labels").put("type", "raster").put("source", "labels"))
+            attribution.text = "$credit · Labels © Esri"
+        }
+        return JSONObject().put("version", 8).put("sources", sources).put("layers", layers).toString()
+    }
+
     private fun rasterSource(url: String, credit: String): JSONObject = JSONObject()
         .put("type", "raster").put("tiles", JSONArray().put(url)).put("tileSize", 256).put("maxzoom", 19).put("attribution", credit)
 

package/dist/android/templates/CraftNativeMutation.kt.template

@@ -119,6 +119,10 @@ class CraftNativeMutationDocument {
                         // be reconciled so the host can move its existing view.
                         requiresFullRender = true
                     }
+                    "replaceChildren" -> {
+                        val parentId = replaceChildren(operation, candidateNodes)
+                        if (parentId !in affectedNodeIds) affectedNodeIds.add(parentId)
+                    }
                     "removeNode" -> {
                         val parent = candidateNodes[operation.optString("id")]?.parent
                         if (parent == null) requiresFullRender = true
@@ -257,6 +261,37 @@ class CraftNativeMutationDocument {
         return previousParentId
     }
 
+    /** Replaces a container's ordered child snapshot in one atomic mutation. */
+    private fun replaceChildren(operation: JSONObject, nodes: MutableMap<String, Node>): String {
+        val parentId = requiredId(operation, "parentId", "replaceChildren")
+        val parent = nodes[parentId] ?: fail("UNKNOWN_PARENT", "node $parentId does not exist")
+        if (!acceptsChildren(parent.type)) fail("INVALID_PARENT", "node $parentId cannot contain child nodes")
+        val values = operation.optJSONArray("children")
+            ?: fail("INVALID_CHILDREN", "replaceChildren.children must be an array")
+        val childIds = mutableListOf<String>()
+        for (index in 0 until values.length()) {
+            val childId = values.opt(index) as? String
+            if (childId.isNullOrBlank()) {
+                fail("INVALID_CHILDREN", "replaceChildren.children must contain non-empty ids")
+            }
+            if (childId in childIds) fail("DUPLICATE_CHILD", "child $childId appears more than once")
+            val child = nodes[childId] ?: fail("UNKNOWN_NODE", "node $childId does not exist")
+            if (childId == parentId || parentId in descendants(childId, nodes)) {
+                fail("CYCLE", "attaching node $childId would create a cycle")
+            }
+            if (child.parent != null && child.parent != parentId) {
+                fail("NODE_ATTACHED", "node $childId already has a parent")
+            }
+            childIds.add(childId)
+        }
+        parent.children.filterNot { it in childIds }.forEach { childId ->
+            (descendants(childId, nodes) + childId).forEach { nodes.remove(it) }
+        }
+        parent.children = childIds
+        childIds.forEach { nodes[it]?.parent = parentId }
+        return parentId
+    }
+
     private fun removeNode(
         operation: JSONObject,
         nodes: MutableMap<String, Node>,

package/dist/api/index.d.ts

@@ -17,8 +17,8 @@ export type { HttpClientOptions, RequestOptions, HttpResponse, WebSocketOptions
 export { crypto, uuid, randomString, hmac, timingSafeEqual, hashPassword, verifyPassword } from './crypto.js';
 export { env, getPlatform, isDesktop, isMobile, isCraft, getSystemInfo, exec, spawn, ChildProcess, cwd, homeDir, tempDir, exit, argv, open } from './process.js';
 export type { Platform, SystemInfo, ExecOptions, ExecResult, SpawnOptions } from './process.js';
-export { device, haptics, permissions, camera, biometrics, secureStorage, storage, location, share, lifecycle, notifications, notifications as notification } from './mobile.js';
-export type { DeviceInfo, DeviceCapabilities, HapticStyle, HapticNotificationType, PermissionType, PermissionStatus, CameraOptions as MobileCameraOptions, PhotoResult, BiometricType, Location, LocationOptions, ShareOptions, AppState, NotificationOptions as MobileNotificationOptions } from './mobile.js';
+export { device, haptics, permissions, camera, files, biometrics, secureStorage, storage, location, share, lifecycle, notifications, notifications as notification } from './mobile.js';
+export type { DeviceInfo, DeviceCapabilities, HapticStyle, HapticNotificationType, PermissionType, PermissionStatus, CameraOptions as MobileCameraOptions, PhotoResult, FileInfo, PickFileOptions, BiometricType, Location, LocationOptions, ShareOptions, AppState, NotificationOptions as MobileNotificationOptions } from './mobile.js';
 export { carplay, appClips, liveActivities, sharePlay, storeKit, appIntents, tipKit, focusFilters } from './ios-advanced.js';
 export type { CarPlayTemplateType, CarPlayListItem, CarPlayGridItem, CarPlayTemplate, AppClipInvocation, LiveActivityContentState, LiveActivityAttributes, LiveActivityConfig, LiveActivityHandle, SharePlaySessionState, SharePlayParticipant, SharePlayActivity, ProductType, Product, Transaction, IntentParameterType, IntentParameter, AppIntent, TipDisplayFrequency, Tip, FocusStatus, FocusFilter } from './ios-advanced.js';
 export { materialYou, photoPicker, workManager, foregroundService, predictiveBack, appLanguage, widgets as androidWidgets, playBilling } from './android-advanced.js';

package/dist/api/mobile.d.ts

@@ -314,6 +314,30 @@ export interface PhotoResult {
     /** MIME type */
     mimeType: string;
 }
+/** A file copied into the app-owned native file area. */
+export interface FileInfo {
+    /** App-owned path suitable for `fetch` FormData and sharing. */
+    path: string;
+    /** Original (sanitized) file name. */
+    name: string;
+    /** Preferred MIME type, or `application/octet-stream` when unknown. */
+    type: string;
+    /** Number of bytes in the copied file. */
+    size: number;
+}
+/** General document picker options. */
+export interface PickFileOptions {
+    /** MIME types, UTIs, or filename extensions (for example `pdf` or `public.data`). */
+    contentTypes?: string[];
+    /** Maximum number of documents; native hosts clamp this to 1–20. */
+    maxSelections?: number;
+    /** Maximum size of each document in bytes; native hosts default to 512 MiB. */
+    maxBytes?: number;
+}
+/** General document picker API. */
+export declare const files: {
+    pickFile(options?: PickFileOptions): Promise<FileInfo[]>;
+};
 /**
  * Camera and image picker API.
  *
@@ -1835,6 +1859,7 @@ declare const mobile: {
     haptics: typeof haptics;
     permissions: typeof permissions;
     camera: typeof camera;
+    files: typeof files;
     biometrics: typeof biometrics;
     secureStorage: typeof secureStorage;
     location: typeof location;

package/dist/cli.js

@@ -141,7 +141,7 @@ import {
   writeFileSync as writeFileSync3
 } from "fs";
 import { homedir } from "os";
-import { basename, join as join2 } from "path";
+import { basename, join as join2, resolve } from "path";
 import { deflateRawSync } from "zlib";
 function crc32(data) {
   let c = 4294967295;
@@ -244,7 +244,7 @@ async function packageMacOS(config, outDir) {
   const opts = config.macos || {};
   const hardenedRuntime = !opts.appStore;
   const appBundlePath = join2(outDir, `${name}.app`);
-  const appBundle = createMacOSAppBundle({
+  const appBundle = opts.appBundlePath ? copyMacOSAppBundle(opts.appBundlePath, appBundlePath) : createMacOSAppBundle({
     name,
     version,
     bundleId,
@@ -327,19 +327,21 @@ async function packageMacOS(config, outDir) {
 async function notarizeIfRequested(opts, artifactPath, format) {
   if (!opts.notarize)
     return [];
-  if (!opts.appleId || !opts.applePassword || !opts.teamId) {
+  if (!opts.notaryKeychainProfile && !opts.notaryApiKey && (!opts.appleId || !opts.applePassword || !opts.teamId)) {
     return [{
       success: false,
       platform: "macos",
       format: `${format} (notarize)`,
-      error: "Notarization requires macos.appleId, macos.applePassword and macos.teamId"
+      error: "Notarization requires a keychain profile, API key, or Apple ID/password/team ID"
     }];
   }
   const submitted = await runTool("xcrun", notarytoolArguments({
     artifactPath,
     appleId: opts.appleId,
     applePassword: opts.applePassword,
-    teamId: opts.teamId
+    teamId: opts.teamId,
+    keychainProfile: opts.notaryKeychainProfile,
+    apiKey: opts.notaryApiKey
   }));
   if (!submitted.success)
     return [{ success: false, platform: "macos", format: `${format} (notarize)`, error: submitted.error }];
@@ -571,6 +573,13 @@ function productbuildArguments(opts) {
   ];
 }
 function notarytoolArguments(opts) {
+  const base = ["notarytool", "submit", opts.artifactPath, "--wait"];
+  if (opts.keychainProfile)
+    return [...base, "--keychain-profile", opts.keychainProfile];
+  if (opts.apiKey)
+    return [...base, "--key", opts.apiKey.path, "--key-id", opts.apiKey.keyId, "--issuer", opts.apiKey.issuer];
+  if (!opts.appleId || !opts.applePassword || !opts.teamId)
+    throw new Error("Notarization credentials are incomplete");
   return [
     "notarytool",
     "submit",
@@ -584,6 +593,20 @@ function notarytoolArguments(opts) {
     "--wait"
   ];
 }
+function copyMacOSAppBundle(source, destination) {
+  try {
+    const info = join2(source, "Contents", "Info.plist");
+    if (!existsSync4(info) || !existsSync4(join2(source, "Contents", "MacOS")))
+      throw new Error(`Invalid prebuilt macOS application: ${source}`);
+    if (resolve(source) !== resolve(destination)) {
+      rmSync2(destination, { recursive: true, force: true });
+      cpSync(source, destination, { recursive: true });
+    }
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
 function createMacOSAppBundle(opts) {
   try {
     const { name, binaryPath, iconPath, provisioningProfile, additionalExecutables, outputPath } = opts;
@@ -2842,7 +2865,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.272";
+var version = "0.0.278";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -118,6 +118,7 @@ __export(exports_src, {
   extractBundle: () => extractBundle,
   extractBundleFromDmg: () => extractBundleFromDmg,
   extractBundleFromZip: () => extractBundleFromZip,
+  files: () => files,
   focus: () => focus,
   focusFilters: () => focusFilters,
   foregroundService: () => foregroundService,
@@ -373,7 +374,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.272";
+var version = "0.0.278";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -611,7 +612,7 @@ async function packageMacOS(config, outDir) {
   const opts = config.macos || {};
   const hardenedRuntime = !opts.appStore;
   const appBundlePath = import_path.join(outDir, `${name}.app`);
-  const appBundle = createMacOSAppBundle({
+  const appBundle = opts.appBundlePath ? copyMacOSAppBundle(opts.appBundlePath, appBundlePath) : createMacOSAppBundle({
     name,
     version,
     bundleId,
@@ -694,19 +695,21 @@ async function packageMacOS(config, outDir) {
 async function notarizeIfRequested(opts, artifactPath, format) {
   if (!opts.notarize)
     return [];
-  if (!opts.appleId || !opts.applePassword || !opts.teamId) {
+  if (!opts.notaryKeychainProfile && !opts.notaryApiKey && (!opts.appleId || !opts.applePassword || !opts.teamId)) {
     return [{
       success: false,
       platform: "macos",
       format: `${format} (notarize)`,
-      error: "Notarization requires macos.appleId, macos.applePassword and macos.teamId"
+      error: "Notarization requires a keychain profile, API key, or Apple ID/password/team ID"
     }];
   }
   const submitted = await runTool("xcrun", notarytoolArguments({
     artifactPath,
     appleId: opts.appleId,
     applePassword: opts.applePassword,
-    teamId: opts.teamId
+    teamId: opts.teamId,
+    keychainProfile: opts.notaryKeychainProfile,
+    apiKey: opts.notaryApiKey
   }));
   if (!submitted.success)
     return [{ success: false, platform: "macos", format: `${format} (notarize)`, error: submitted.error }];
@@ -939,6 +942,13 @@ function productbuildArguments(opts) {
   ];
 }
 function notarytoolArguments(opts) {
+  const base = ["notarytool", "submit", opts.artifactPath, "--wait"];
+  if (opts.keychainProfile)
+    return [...base, "--keychain-profile", opts.keychainProfile];
+  if (opts.apiKey)
+    return [...base, "--key", opts.apiKey.path, "--key-id", opts.apiKey.keyId, "--issuer", opts.apiKey.issuer];
+  if (!opts.appleId || !opts.applePassword || !opts.teamId)
+    throw new Error("Notarization credentials are incomplete");
   return [
     "notarytool",
     "submit",
@@ -952,6 +962,20 @@ function notarytoolArguments(opts) {
     "--wait"
   ];
 }
+function copyMacOSAppBundle(source, destination) {
+  try {
+    const info = import_path.join(source, "Contents", "Info.plist");
+    if (!import_fs.existsSync(info) || !import_fs.existsSync(import_path.join(source, "Contents", "MacOS")))
+      throw new Error(`Invalid prebuilt macOS application: ${source}`);
+    if (import_path.resolve(source) !== import_path.resolve(destination)) {
+      import_fs.rmSync(destination, { recursive: true, force: true });
+      import_fs.cpSync(source, destination, { recursive: true });
+    }
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
 function createMacOSAppBundle(opts) {
   try {
     const { name, binaryPath, iconPath, provisioningProfile, additionalExecutables, outputPath } = opts;
@@ -5106,6 +5130,55 @@ var permissions = {
     }
   }
 };
+var files = {
+  async pickFile(options = {}) {
+    const craft = getCraftMobile();
+    if (typeof window !== "undefined" && craft?.files) {
+      return craft.files.pickFile(options);
+    }
+    if (typeof document === "undefined") {
+      throw new Error("File picker not available. Must run in Craft or a browser.");
+    }
+    return new Promise((resolve, reject) => {
+      const input = document.createElement("input");
+      input.type = "file";
+      if (options.contentTypes?.length)
+        input.accept = options.contentTypes.join(",");
+      const requested = Number(options.maxSelections);
+      const maxSelections = Number.isFinite(requested) && requested > 0 ? Math.min(20, Math.floor(requested)) : 1;
+      input.multiple = maxSelections > 1;
+      input.style.display = "none";
+      let settled = false;
+      const finish = (result) => {
+        if (settled)
+          return;
+        settled = true;
+        input.remove();
+        result();
+      };
+      input.addEventListener("cancel", () => finish(() => resolve([])), { once: true });
+      input.onchange = () => {
+        const chosen = Array.from(input.files ?? []).slice(0, maxSelections);
+        const limit = Number(options.maxBytes);
+        if (Number.isFinite(limit) && limit > 0) {
+          const oversized = chosen.find((file) => file.size > limit);
+          if (oversized) {
+            finish(() => reject(Object.assign(new Error("The selected file is too large"), { code: "FILE_TOO_LARGE" })));
+            return;
+          }
+        }
+        finish(() => resolve(chosen.map((file) => ({
+          path: URL.createObjectURL(file),
+          name: file.name,
+          type: file.type || "application/octet-stream",
+          size: file.size
+        }))));
+      };
+      document.body.append(input);
+      input.click();
+    });
+  }
+};
 var camera = {
   async takePicture(options = {}) {
     const craft = getCraftMobile();

package/dist/index.js

@@ -117,7 +117,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.272";
+var version = "0.0.278";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;
@@ -252,7 +252,7 @@ import {
   writeFileSync as writeFileSync2
 } from "fs";
 import { homedir } from "os";
-import { basename, join as join2 } from "path";
+import { basename, join as join2, resolve } from "path";
 import { deflateRawSync } from "zlib";
 var DEFAULT_DEB_DEPENDENCIES = ["libgtk-3-0", "libwebkit2gtk-4.1-37", "libnotify-bin"];
 var CRC32_TABLE = (() => {
@@ -366,7 +366,7 @@ async function packageMacOS(config, outDir) {
   const opts = config.macos || {};
   const hardenedRuntime = !opts.appStore;
   const appBundlePath = join2(outDir, `${name}.app`);
-  const appBundle = createMacOSAppBundle({
+  const appBundle = opts.appBundlePath ? copyMacOSAppBundle(opts.appBundlePath, appBundlePath) : createMacOSAppBundle({
     name,
     version,
     bundleId,
@@ -449,19 +449,21 @@ async function packageMacOS(config, outDir) {
 async function notarizeIfRequested(opts, artifactPath, format) {
   if (!opts.notarize)
     return [];
-  if (!opts.appleId || !opts.applePassword || !opts.teamId) {
+  if (!opts.notaryKeychainProfile && !opts.notaryApiKey && (!opts.appleId || !opts.applePassword || !opts.teamId)) {
     return [{
       success: false,
       platform: "macos",
       format: `${format} (notarize)`,
-      error: "Notarization requires macos.appleId, macos.applePassword and macos.teamId"
+      error: "Notarization requires a keychain profile, API key, or Apple ID/password/team ID"
     }];
   }
   const submitted = await runTool("xcrun", notarytoolArguments({
     artifactPath,
     appleId: opts.appleId,
     applePassword: opts.applePassword,
-    teamId: opts.teamId
+    teamId: opts.teamId,
+    keychainProfile: opts.notaryKeychainProfile,
+    apiKey: opts.notaryApiKey
   }));
   if (!submitted.success)
     return [{ success: false, platform: "macos", format: `${format} (notarize)`, error: submitted.error }];
@@ -694,6 +696,13 @@ function productbuildArguments(opts) {
   ];
 }
 function notarytoolArguments(opts) {
+  const base = ["notarytool", "submit", opts.artifactPath, "--wait"];
+  if (opts.keychainProfile)
+    return [...base, "--keychain-profile", opts.keychainProfile];
+  if (opts.apiKey)
+    return [...base, "--key", opts.apiKey.path, "--key-id", opts.apiKey.keyId, "--issuer", opts.apiKey.issuer];
+  if (!opts.appleId || !opts.applePassword || !opts.teamId)
+    throw new Error("Notarization credentials are incomplete");
   return [
     "notarytool",
     "submit",
@@ -707,6 +716,20 @@ function notarytoolArguments(opts) {
     "--wait"
   ];
 }
+function copyMacOSAppBundle(source, destination) {
+  try {
+    const info = join2(source, "Contents", "Info.plist");
+    if (!existsSync3(info) || !existsSync3(join2(source, "Contents", "MacOS")))
+      throw new Error(`Invalid prebuilt macOS application: ${source}`);
+    if (resolve(source) !== resolve(destination)) {
+      rmSync2(destination, { recursive: true, force: true });
+      cpSync(source, destination, { recursive: true });
+    }
+    return { success: true };
+  } catch (error) {
+    return { success: false, error: error.message };
+  }
+}
 function createMacOSAppBundle(opts) {
   try {
     const { name, binaryPath, iconPath, provisioningProfile, additionalExecutables, outputPath } = opts;
@@ -4861,6 +4884,55 @@ var permissions = {
     }
   }
 };
+var files = {
+  async pickFile(options = {}) {
+    const craft = getCraftMobile();
+    if (typeof window !== "undefined" && craft?.files) {
+      return craft.files.pickFile(options);
+    }
+    if (typeof document === "undefined") {
+      throw new Error("File picker not available. Must run in Craft or a browser.");
+    }
+    return new Promise((resolve, reject) => {
+      const input = document.createElement("input");
+      input.type = "file";
+      if (options.contentTypes?.length)
+        input.accept = options.contentTypes.join(",");
+      const requested = Number(options.maxSelections);
+      const maxSelections = Number.isFinite(requested) && requested > 0 ? Math.min(20, Math.floor(requested)) : 1;
+      input.multiple = maxSelections > 1;
+      input.style.display = "none";
+      let settled = false;
+      const finish = (result) => {
+        if (settled)
+          return;
+        settled = true;
+        input.remove();
+        result();
+      };
+      input.addEventListener("cancel", () => finish(() => resolve([])), { once: true });
+      input.onchange = () => {
+        const chosen = Array.from(input.files ?? []).slice(0, maxSelections);
+        const limit = Number(options.maxBytes);
+        if (Number.isFinite(limit) && limit > 0) {
+          const oversized = chosen.find((file) => file.size > limit);
+          if (oversized) {
+            finish(() => reject(Object.assign(new Error("The selected file is too large"), { code: "FILE_TOO_LARGE" })));
+            return;
+          }
+        }
+        finish(() => resolve(chosen.map((file) => ({
+          path: URL.createObjectURL(file),
+          name: file.name,
+          type: file.type || "application/octet-stream",
+          size: file.size
+        }))));
+      };
+      document.body.append(input);
+      input.click();
+    });
+  }
+};
 var camera = {
   async takePicture(options = {}) {
     const craft = getCraftMobile();
@@ -11403,6 +11475,7 @@ export {
   extractBundle,
   extractBundleFromDmg,
   extractBundleFromZip,
+  files,
   focus,
   focusFilters,
   foregroundService,

package/dist/ios/src/index.js

@@ -776,12 +776,15 @@ function renderWatchEntitlements(config) {
     <array>
 ${plistArray(config.appGroups)}
     </array>
+` : "";
+  const healthKit = config.enableHealthKit ? `    <key>com.apple.developer.healthkit</key>
+    <true/>
 ` : "";
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-${appGroups}</dict>
+${appGroups}${healthKit}</dict>
 </plist>
 `;
 }
@@ -1195,7 +1198,7 @@ function writeShell(output, config) {
     if (!enabled)
       continue;
     mkdirSync2(join3(output, folder), { recursive: true });
-    const source = readFileSync2(join3(TEMPLATES_DIR, template), "utf8").replace(/\{\{APP_NAME\}\}/g, name);
+    const source = readFileSync2(join3(TEMPLATES_DIR, template), "utf8").replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{HEALTH_KIT_ENABLED\}\}/g, config.enableHealthKit ? "true" : "false");
     writeFileSync2(join3(output, folder, filename), source);
   }
 }
@@ -1328,7 +1331,8 @@ ${nativeDependencies.join(`
     const watchInfo = readFileSync2(join3(TEMPLATES_DIR, "WatchApp.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
     writeFileSync2(join3(output, "WatchApp", "Info.plist"), watchInfo);
     writeFileSync2(join3(output, "WatchApp", "Watch.entitlements"), renderWatchEntitlements(config));
-    const watchExtensionInfo = readFileSync2(join3(TEMPLATES_DIR, "WatchExtension.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
+    const watchExtensionInfo = readFileSync2(join3(TEMPLATES_DIR, "WatchExtension.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{HEALTH_USAGE_DESCRIPTIONS\}\}/g, config.enableHealthKit ? `${plistString("NSHealthShareUsageDescription", `${displayName} reads health data you choose to share.`)}
+${plistString("NSHealthUpdateUsageDescription", `${displayName} writes health data only with your permission.`)}` : "");
     writeFileSync2(join3(output, "WatchExtension", "Info.plist"), watchExtensionInfo);
     writeFileSync2(join3(output, "WatchExtension", "Watch.entitlements"), renderWatchEntitlements(config));
   }

package/dist/ios/templates/CraftHybrid.swift

@@ -357,6 +357,7 @@ final class CraftHybrid: NSObject {
         isConfigured = true
         self.config = config
         CraftNativeScriptThread.isBackground = config.nativeScriptThread == "background"
+        if CraftNativeScriptThread.isBackground { CraftNativeBundle.prewarm() }
         hasWeb = config.renderer != "native"
         siteURL = config.devServerURL.flatMap(URL.init(string:)).flatMap { url in
             ["http", "https"].contains((url.scheme ?? "").lowercased()) ? url : nil
@@ -2295,13 +2296,15 @@ final class CraftFramePacing: NSObject {
         }
     }
 
-    /// One main-thread block, timed: a screen mount, a bundle evaluation.
+    /// One block, timed: a screen mount, a bundle evaluation. Labelled by the
+    /// thread it ran on, since a screen's script now runs off the main thread
+    /// and a bundle's time there costs no frames.
     @discardableResult
     func measure<T>(_ name: String, _ work: () -> T) -> T {
         guard enabled else { return work() }
         let started = CACurrentMediaTime()
         let result = work()
-        write(String(format: "%@ main=%.1fms", name, (CACurrentMediaTime() - started) * 1000))
+        write(String(format: "%@ %@=%.1fms", name, Thread.isMainThread ? "main" : "script", (CACurrentMediaTime() - started) * 1000))
         return result
     }
 

package/dist/ios/templates/CraftNativeActions.swift

@@ -253,6 +253,12 @@ enum CraftNativeActions {
                 CraftNativeFiles.pickVideo(options) { complete(requestToken, $0, completion) }
             }
             return
+        case ("Files", "pickFile"):
+            let options = args.first as? [String: Any] ?? [:]
+            DispatchQueue.main.async {
+                CraftNativeFiles.pickFile(options) { complete(requestToken, $0, completion) }
+            }
+            return
         case ("Files", "download"):
             download(requestToken: requestToken, args: args, completion: completion)
             return