@craft-native/ios 0.0.164 → 0.0.167

package/README.md

@@ -153,6 +153,12 @@ reversing each line's main-axis children, matching Android's native host.
 
 For multiple native screens, configure named `.stx` routes and an initial screen in `native.config.json` (see [`fixtures/native-navigation`](./fixtures/native-navigation)). Compile without a positional file: `stx native compile --format bundle --output ./screen.js`. A screen can call `craft.navigation.push('details', { id: 7 })`, `.replace('home')`, or `.back()`; the destination reads `craft.route.params`. Craft uses a native navigation stack, so the back button and edge-swipe reveal the existing controller and retain its JavaScript and input state. `bun packages/ios/scripts/test-native-navigation.ts` compiles the fixture and runs its simulator test; the default WebView renderer is unchanged.
 
+Hybrid apps also get the shell's completed left/right tab swipe over the
+WebView. Disable that page-wide gesture with
+`craft.tabBar.set(tabs, { swipeEnabled: false })`; a native screen can still
+use `craft.navigation.setOptions({ tabSwipeEnabled: false })` for its own
+content.
+
 The optional Liquid Glass tab-bar styling is compiler-gated for Xcode 26/Swift 6.2 and later. Older SDKs compile the same tab bar with the material fallback, so generated projects remain buildable on Xcode 16.
 
 The iOS host overlays `craft.config.json` on its defaults. Missing or `null` capability flags stay disabled; explicitly set a flag to `true` to enable it. Both the Swift host and Zig bridge reject malformed values and fall back to all capabilities disabled.
@@ -424,6 +430,23 @@ await health.requestAuthorization(['mindful'], { write: true })
 await health.saveMindfulSession({ id: 'session-42', startDate: started, endDate: Date.now() })
 // Every app's mindful sessions, oldest first; ownApp marks the ones this app wrote.
 const mindful = await health.getMindfulSessions({ startDate: Date.now() - 7 * 86400000 })
+// Heart rate as Apple Health receives it, instead of polling getHeartRateSamples:
+// the samples since `since` (two minutes ago by default) first, then each new
+// batch, oldest first and each sample once, in getHeartRateSamples' shape.
+// Needs the 'heartRate' grant; one stream at a time.
+const stopListening = health.onHeartRate(samples => show(samples[samples.length - 1].bpm))
+await health.startHeartRateUpdates({ since: Date.now() - 60000 })
+// ...
+await health.stopHeartRateUpdates()
+stopListening()
+// HealthKit only has what the watch has synced. During a workout or a
+// Mindfulness session on the Apple Watch that is a reading every few seconds;
+// otherwise the watch measures every few minutes, and so do these. On a page
+// the batches are `craftHealthHeartRate` events ({ samples }); native screens
+// hear them too. In the simulator, the CraftFakeHealthHeartRate default
+// (`xcrun simctl spawn booted defaults write <bundle id> CraftFakeHealthHeartRate -bool YES`)
+// sends a made-up watch reading every 5 s instead: someone settling into slow
+// breathing, from about 72 toward 60 bpm.
 
 // Screen Capture
 const screenshotBase64 = await window.craft.takeScreenshot();
@@ -619,7 +642,9 @@ const { samples } = await window.craft.heartRate.stopRecording(); // [{ timestam
 // answers { available: false }.
 // The simulator has no Bluetooth: `simctl spawn <device> defaults write
 // <bundle id> CraftFakeHeartRateMonitor -bool YES` stands in a strap ("Simulated
-// HRM") whose readings are encoded and decoded as 0x2A37 payloads. Simulator builds only.
+// HRM") whose readings are encoded and decoded as 0x2A37 payloads, their RR
+// intervals varying beat to beat with a ten-second breath as a heart's do, so a
+// heart-rate variability worked out from them means something. Simulator builds only.
 
 // Apple Watch workouts (enableScheduledWorkouts, iOS 17+): WorkoutKit's
 // WorkoutScheduler puts a structured workout in the paired watch's Workout

package/dist/index.d.ts

@@ -477,6 +477,7 @@ export declare function installRuntime(output: string, runtimeDir: string): Prom
 export declare function productName(name: string): string;
 /** Restore package-owned Swift into an existing project, without changing its Xcode metadata or bundled screens. */
 export declare function restoreShell(output: string): void;
+export { assertNoApplicationSwiftSources, findApplicationSwiftSources } from './source-audit.js';
 export declare function init(options: InitOptions): Promise<void>;
 /**
  * Build web assets and generate Xcode project

package/dist/index.js

@@ -1,15 +1,63 @@
 // @bun
 // src/index.ts
-import { cpSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, readdirSync, rmSync as rmSync2, statSync, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, join as join2, resolve } from "path";
+import { cpSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, readdirSync as readdirSync2, rmSync as rmSync2, statSync, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join3, resolve } from "path";
 var {$ } = globalThis.Bun;
 
+// src/source-audit.ts
+import { readdirSync } from "fs";
+import { join, relative, sep } from "path";
+var defaultIgnoredPaths = [
+  ".git",
+  "node_modules",
+  "dist",
+  "build",
+  "storage/framework/mobile"
+];
+function normalisePath(path) {
+  return path.split(sep).join("/");
+}
+function isIgnored(path, ignoredPaths) {
+  const normalised = normalisePath(path);
+  return ignoredPaths.some((ignored) => {
+    const prefix = normalisePath(ignored).replace(/\/+$/, "");
+    return normalised === prefix || normalised.startsWith(`${prefix}/`);
+  });
+}
+function visit(root, current, ignoredPaths, found) {
+  for (const entry of readdirSync(current, { withFileTypes: true })) {
+    const absolute = join(current, entry.name);
+    const relativePath = relative(root, absolute);
+    if (isIgnored(relativePath, ignoredPaths))
+      continue;
+    if (entry.isDirectory()) {
+      visit(root, absolute, ignoredPaths, found);
+      continue;
+    }
+    if (entry.isFile() && entry.name.endsWith(".swift"))
+      found.push(normalisePath(relativePath));
+  }
+}
+function findApplicationSwiftSources(root, options = {}) {
+  const ignoredPaths = [...defaultIgnoredPaths, ...options.ignoredPaths ?? []];
+  const found = [];
+  visit(root, root, ignoredPaths, found);
+  return found.sort();
+}
+function assertNoApplicationSwiftSources(root, options = {}) {
+  const sources = findApplicationSwiftSources(root, options);
+  if (sources.length > 0) {
+    throw new Error(`Application-owned Swift sources found:
+${sources.map((path) => `- ${path}`).join(`
+`)}`);
+  }
+}
 // src/testing.ts
 import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { tmpdir } from "os";
-import { dirname, join } from "path";
+import { dirname, join as join2 } from "path";
 import { spawnSync } from "child_process";
-var templates = join(dirname(import.meta.dir), "templates/testing");
+var templates = join2(dirname(import.meta.dir), "templates/testing");
 function bundleIdentifier(value) {
   if (!/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(value))
     throw new Error(`Invalid bundle identifier: ${value}`);
@@ -44,9 +92,9 @@ function initSimulatorDriver(options) {
     ["DriverTests.swift.template", "UITests/DriverTests.swift"],
     ["project.yml.template", "project.yml"]
   ]) {
-    const path = join(output, destination);
+    const path = join2(output, destination);
     mkdirSync(dirname(path), { recursive: true });
-    const content = readFileSync(join(templates, source), "utf8").replace(/\{\{([A-Z_]+)\}\}/g, (_, key) => replacements[key]);
+    const content = readFileSync(join2(templates, source), "utf8").replace(/\{\{([A-Z_]+)\}\}/g, (_, key) => replacements[key]);
     let previous;
     try {
       previous = readFileSync(path, "utf8");
@@ -108,11 +156,11 @@ function serializeSimulatorSteps(steps) {
 `;
 }
 function createNativeMutationValidator() {
-  const output = mkdtempSync(join(tmpdir(), "craft-native-mutation-"));
-  const binary = join(output, "validate");
+  const output = mkdtempSync(join2(tmpdir(), "craft-native-mutation-"));
+  const binary = join2(output, "validate");
   try {
-    writeFileSync(join(output, "main.swift"), readFileSync(join(templates, "MutationValidator.swift")));
-    const build = Bun.spawnSync(["swiftc", join(templates, "../CraftNativeMutation.swift"), join(output, "main.swift"), "-o", binary]);
+    writeFileSync(join2(output, "main.swift"), readFileSync(join2(templates, "MutationValidator.swift")));
+    const build = Bun.spawnSync(["swiftc", join2(templates, "../CraftNativeMutation.swift"), join2(output, "main.swift"), "-o", binary]);
     if (build.exitCode !== 0)
       throw new Error(build.stderr.toString());
   } catch (error) {
@@ -124,9 +172,9 @@ function createNativeMutationValidator() {
     validate(messages) {
       if (disposed)
         throw new Error("The native mutation validator has been disposed");
-      const input = join(output, "messages.json");
+      const input = join2(output, "messages.json");
       writeFileSync(input, JSON.stringify(messages));
-      const report = join(output, "result.txt");
+      const report = join2(output, "result.txt");
       rmSync(report, { force: true });
       const result = spawnSync(binary, [input, report], { encoding: "utf8" });
       let stdout = result.stdout ?? "";
@@ -143,12 +191,12 @@ function createNativeMutationValidator() {
 }
 
 // src/index.ts
-var TEMPLATES_DIR = join2(dirname2(import.meta.dir), "templates");
+var TEMPLATES_DIR = join3(dirname2(import.meta.dir), "templates");
 function resolveCraftVersion(startDir = import.meta.dir) {
   let directory = resolve(startDir);
   while (true) {
     try {
-      const packageJSON = JSON.parse(readFileSync2(join2(directory, "package.json"), "utf8"));
+      const packageJSON = JSON.parse(readFileSync2(join3(directory, "package.json"), "utf8"));
       if (packageJSON.name === "@craft-native/ios" && typeof packageJSON.version === "string" && packageJSON.version.length > 0)
         return packageJSON.version;
     } catch {}
@@ -300,7 +348,7 @@ function hybridConfigProblems(config) {
 function installNativeBundle(source, output) {
   if (!existsSync(source))
     throw new Error(`Native bundle not found: ${source}`);
-  const destination = join2(output, "dist", "native-screen.js");
+  const destination = join3(output, "dist", "native-screen.js");
   mkdirSync2(dirname2(destination), { recursive: true });
   if (resolve(source) !== resolve(destination))
     cpSync(source, destination);
@@ -676,20 +724,20 @@ function writeOpaqueIcon(source, target) {
   }
 }
 function renderAssetCatalog(output, config) {
-  const catalog = join2(output, "Assets.xcassets");
-  const appIcon = join2(catalog, "AppIcon.appiconset");
-  const launchBackground = join2(catalog, "LaunchBackground.colorset");
+  const catalog = join3(output, "Assets.xcassets");
+  const appIcon = join3(catalog, "AppIcon.appiconset");
+  const launchBackground = join3(catalog, "LaunchBackground.colorset");
   mkdirSync2(appIcon, { recursive: true });
   mkdirSync2(launchBackground, { recursive: true });
-  writeFileSync2(join2(catalog, "Contents.json"), `${JSON.stringify({ info: { author: "xcode", version: 1 } }, null, 2)}
+  writeFileSync2(join3(catalog, "Contents.json"), `${JSON.stringify({ info: { author: "xcode", version: 1 } }, null, 2)}
 `);
   const iconFilename = config.appIconPath ? "AppIcon-1024.png" : undefined;
   if (config.appIconPath) {
     if (!existsSync(config.appIconPath))
       throw new Error(`App icon not found: ${config.appIconPath}`);
-    writeOpaqueIcon(config.appIconPath, join2(appIcon, iconFilename));
+    writeOpaqueIcon(config.appIconPath, join3(appIcon, iconFilename));
   }
-  writeFileSync2(join2(appIcon, "Contents.json"), `${JSON.stringify({
+  writeFileSync2(join3(appIcon, "Contents.json"), `${JSON.stringify({
     images: iconFilename ? [{
       filename: iconFilename,
       idiom: "universal",
@@ -716,7 +764,7 @@ function renderAssetCatalog(output, config) {
       idiom: "universal"
     });
   }
-  writeFileSync2(join2(launchBackground, "Contents.json"), `${JSON.stringify({
+  writeFileSync2(join3(launchBackground, "Contents.json"), `${JSON.stringify({
     colors,
     info: { author: "xcode", version: 1 }
   }, null, 2)}
@@ -725,7 +773,7 @@ function renderAssetCatalog(output, config) {
 }
 var LAUNCH_LOGO = "LaunchLogo";
 function renderLaunchLogo(catalog, config) {
-  const imageset = join2(catalog, `${LAUNCH_LOGO}.imageset`);
+  const imageset = join3(catalog, `${LAUNCH_LOGO}.imageset`);
   rmSync2(imageset, { recursive: true, force: true });
   if (!config.splashImagePath)
     return;
@@ -741,14 +789,14 @@ function renderLaunchLogo(catalog, config) {
     if (extension === "svg" || extension === "pdf")
       vector = true;
     const filename = `${LAUNCH_LOGO}${dark ? "-dark" : ""}.${extension}`;
-    cpSync(source, join2(imageset, filename));
+    cpSync(source, join3(imageset, filename));
     images.push({
       ...dark ? { appearances: [{ appearance: "luminosity", value: "dark" }] } : {},
       filename,
       idiom: "universal"
     });
   }
-  writeFileSync2(join2(imageset, "Contents.json"), `${JSON.stringify({
+  writeFileSync2(join3(imageset, "Contents.json"), `${JSON.stringify({
     images,
     info: { author: "xcode", version: 1 },
     ...vector ? { properties: { "preserves-vector-representation": true } } : {}
@@ -862,15 +910,15 @@ function syncWebAssets(source, output) {
   const sourcePath = resolve(source);
   if (!existsSync(sourcePath))
     throw new Error(`Web asset path not found: ${source}`);
-  const distDir = join2(output, "dist");
+  const distDir = join3(output, "dist");
   rmSync2(distDir, { recursive: true, force: true });
   mkdirSync2(distDir, { recursive: true });
   if (statSync(sourcePath).isDirectory()) {
     cpSync(sourcePath, distDir, { recursive: true });
   } else {
-    cpSync(sourcePath, join2(distDir, "index.html"));
+    cpSync(sourcePath, join3(distDir, "index.html"));
   }
-  if (!existsSync(join2(distDir, "index.html"))) {
+  if (!existsSync(join3(distDir, "index.html"))) {
     throw new Error(`Web asset directory must contain index.html: ${source}`);
   }
 }
@@ -892,32 +940,32 @@ var RUNTIME_ARCHIVES = {
 };
 async function installRuntime(output, runtimeDir) {
   const resolved = Object.entries(RUNTIME_ARCHIVES).map(([sdk, archives]) => {
-    const present = archives.filter((a) => existsSync(join2(runtimeDir, a)));
+    const present = archives.filter((a) => existsSync(join3(runtimeDir, a)));
     if (present.length === 0) {
       throw new Error(`${runtimeDir} has none of ${archives.join(", ")}. ` + `Run \`zig build build-ios-all\` in packages/zig and point at its zig-out/lib.`);
     }
     return { sdk, archives, present };
   });
-  const dest = join2(output, "Runtime");
+  const dest = join3(output, "Runtime");
   rmSync2(dest, { recursive: true, force: true });
   for (const { sdk, archives, present } of resolved) {
-    const sdkDir = join2(dest, sdk);
+    const sdkDir = join3(dest, sdk);
     mkdirSync2(sdkDir, { recursive: true });
-    const target = join2(sdkDir, "libcraft-ios.a");
+    const target = join3(sdkDir, "libcraft-ios.a");
     if (present.length === 1) {
       const missing = archives.filter((a) => !present.includes(a));
       if (missing.length > 0) {
         console.warn(`   \u26A0 ${sdk}: only ${present[0]} was found; ${missing.join(", ")} is missing. ` + `The generated project will not link on the other architecture.`);
       }
-      cpSync(join2(runtimeDir, present[0]), target);
+      cpSync(join3(runtimeDir, present[0]), target);
     } else {
-      await $`lipo -create ${present.map((a) => join2(runtimeDir, a))} -output ${target}`.quiet();
+      await $`lipo -create ${present.map((a) => join3(runtimeDir, a))} -output ${target}`.quiet();
     }
   }
   return true;
 }
 async function refreshRuntime(output, override) {
-  if (!existsSync(join2(output, "Runtime")))
+  if (!existsSync(join3(output, "Runtime")))
     return;
   const dir = resolveRuntimeDir(override);
   if (!dir) {
@@ -935,41 +983,41 @@ function productName(name) {
   return /^\d/.test(joined) ? `App${joined}` : joined;
 }
 function restoreShell(output) {
-  const config = JSON.parse(readFileSync2(join2(output, "craft.config.json"), "utf8"));
+  const config = JSON.parse(readFileSync2(join3(output, "craft.config.json"), "utf8"));
   writeShell(output, config);
 }
 function writeShell(output, config) {
   if (!config.appName || !/^[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/.test(config.bundleId))
     throw new Error("The iOS shell needs an appName and a valid bundleId in craft.config.json.");
   const name = productName(config.appName);
-  mkdirSync2(join2(output, "Sources"), { recursive: true });
-  mkdirSync2(join2(output, "Shared"), { recursive: true });
-  const swiftTemplate = readFileSync2(join2(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
+  mkdirSync2(join3(output, "Sources"), { recursive: true });
+  mkdirSync2(join3(output, "Shared"), { recursive: true });
+  const swiftTemplate = readFileSync2(join3(TEMPLATES_DIR, "CraftApp.swift"), "utf-8");
   const swiftSource = swiftTemplate.replace(/CraftApp/g, `${name}App`).replace(/\{\{BUNDLE_ID\}\}/g, config.bundleId).replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION);
-  writeFileSync2(join2(output, "Sources", `${name}App.swift`), swiftSource);
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeScreen.swift"), join2(output, "Sources", "CraftNativeScreen.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeFlatList.swift"), join2(output, "Sources", "CraftNativeFlatList.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeActions.swift"), join2(output, "Sources", "CraftNativeActions.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftHealth.swift"), join2(output, "Sources", "CraftHealth.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftMusic.swift"), join2(output, "Sources", "CraftMusic.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftHeartRate.swift"), join2(output, "Sources", "CraftHeartRate.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftScheduledWorkouts.swift"), join2(output, "Sources", "CraftScheduledWorkouts.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeMutation.swift"), join2(output, "Sources", "CraftNativeMutation.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeUI.swift"), join2(output, "Sources", "CraftNativeUI.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeServices.swift"), join2(output, "Sources", "CraftNativeServices.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftNativeFiles.swift"), join2(output, "Sources", "CraftNativeFiles.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftWebAudio.swift"), join2(output, "Sources", "CraftWebAudio.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftHybrid.swift"), join2(output, "Sources", "CraftHybrid.swift"));
-  cpSync(join2(TEMPLATES_DIR, "CraftActivityAttributes.swift"), join2(output, "Shared", "CraftActivityAttributes.swift"));
+  writeFileSync2(join3(output, "Sources", `${name}App.swift`), swiftSource);
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeScreen.swift"), join3(output, "Sources", "CraftNativeScreen.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeFlatList.swift"), join3(output, "Sources", "CraftNativeFlatList.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeActions.swift"), join3(output, "Sources", "CraftNativeActions.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftHealth.swift"), join3(output, "Sources", "CraftHealth.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftMusic.swift"), join3(output, "Sources", "CraftMusic.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftHeartRate.swift"), join3(output, "Sources", "CraftHeartRate.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftScheduledWorkouts.swift"), join3(output, "Sources", "CraftScheduledWorkouts.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeMutation.swift"), join3(output, "Sources", "CraftNativeMutation.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeUI.swift"), join3(output, "Sources", "CraftNativeUI.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeServices.swift"), join3(output, "Sources", "CraftNativeServices.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftNativeFiles.swift"), join3(output, "Sources", "CraftNativeFiles.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftWebAudio.swift"), join3(output, "Sources", "CraftWebAudio.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftHybrid.swift"), join3(output, "Sources", "CraftHybrid.swift"));
+  cpSync(join3(TEMPLATES_DIR, "CraftActivityAttributes.swift"), join3(output, "Shared", "CraftActivityAttributes.swift"));
   for (const [enabled, folder, template, filename] of [
     [config.enableLiveActivities, "WidgetExtension", "CraftLiveActivityWidget.swift.template", `${name}LiveActivity.swift`],
     [config.enableWatchApp, "WatchExtension", "CraftWatchApp.swift.template", `${name}WatchApp.swift`]
   ]) {
     if (!enabled)
       continue;
-    mkdirSync2(join2(output, folder), { recursive: true });
-    const source = readFileSync2(join2(TEMPLATES_DIR, template), "utf8").replace(/\{\{APP_NAME\}\}/g, name);
-    writeFileSync2(join2(output, folder, filename), source);
+    mkdirSync2(join3(output, folder), { recursive: true });
+    const source = readFileSync2(join3(TEMPLATES_DIR, template), "utf8").replace(/\{\{APP_NAME\}\}/g, name);
+    writeFileSync2(join3(output, folder, filename), source);
   }
 }
 async function init(options) {
@@ -979,9 +1027,9 @@ async function init(options) {
 \u26A1 Initializing Craft iOS project: ${displayName}`);
   console.log(`   Output: ${output}
 `);
-  const dirs = [output, join2(output, "Sources"), join2(output, "Shared"), join2(output, "dist")];
+  const dirs = [output, join3(output, "Sources"), join3(output, "Shared"), join3(output, "dist")];
   if (options.config?.enableWatchApp)
-    dirs.push(join2(output, "WatchApp"), join2(output, "WatchExtension"));
+    dirs.push(join3(output, "WatchApp"), join3(output, "WatchExtension"));
   for (const dir of dirs) {
     if (!existsSync(dir)) {
       mkdirSync2(dir, { recursive: true });
@@ -1008,15 +1056,15 @@ async function init(options) {
 `));
   if (Object.keys(config.shareStorage ?? {}).length)
     config.enableSecureStorage = true;
-  writeFileSync2(join2(output, "craft.config.json"), JSON.stringify(config, null, 2));
+  writeFileSync2(join3(output, "craft.config.json"), JSON.stringify(config, null, 2));
   writeShell(output, config);
-  const infoPlistTemplate = readFileSync2(join2(TEMPLATES_DIR, "Info.plist.template"), "utf-8");
+  const infoPlistTemplate = readFileSync2(join3(TEMPLATES_DIR, "Info.plist.template"), "utf-8");
   const infoPlist = infoPlistTemplate.replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{VERSION\}\}/g, config.version || "1.0.0").replace(/\{\{BUILD_NUMBER\}\}/g, config.buildNumber || "1").replace(/\{\{UI_STYLE\}\}/g, renderAppearance(config).interfaceStyle).replace(/\{\{STATUS_BAR_STYLE\}\}/g, renderAppearance(config).statusBarStyle).replace(/\{\{ORIENTATIONS\}\}/g, renderOrientations(config)).replace(/\{\{USAGE_DESCRIPTIONS\}\}/g, renderUsageDescriptions(config)).replace(/\{\{URL_TYPES\}\}/g, renderUrlTypes(config)).replace(/\{\{APP_BOUND_DOMAINS\}\}/g, renderAppBoundDomains(config)).replace(/\{\{BACKGROUND_MODES\}\}/g, renderBackgroundModes(config)).replace(/\{\{BACKGROUND_TASK_IDENTIFIERS\}\}/g, renderBackgroundTaskIdentifiers(config)).replace(/\{\{LAUNCH_SCREEN\}\}/g, renderLaunchScreen(config)).replace(/\{\{NON_EXEMPT_ENCRYPTION\}\}/g, config.usesNonExemptEncryption ? "true" : "false").replace(/\{\{LIVE_ACTIVITY_SUPPORT\}\}/g, config.enableLiveActivities ? `    <key>NSSupportsLiveActivities</key>
     <true/>
     <key>NSSupportsLiveActivitiesFrequentUpdates</key>
     <true/>` : "");
-  writeFileSync2(join2(output, "Info.plist"), infoPlist);
-  const projectYmlTemplate = readFileSync2(join2(TEMPLATES_DIR, "project.yml.template"), "utf-8");
+  writeFileSync2(join3(output, "Info.plist"), infoPlist);
+  const projectYmlTemplate = readFileSync2(join3(TEMPLATES_DIR, "project.yml.template"), "utf-8");
   const nativeDependencies = [];
   if (config.enableLiveActivities)
     nativeDependencies.push(`      - target: ${name}LiveActivity`);
@@ -1073,30 +1121,30 @@ async function init(options) {
   if (hasRuntime) {
     console.log("   Linked the Zig runtime from", runtimeDir);
   } else {
-    rmSync2(join2(output, "Runtime"), { recursive: true, force: true });
+    rmSync2(join3(output, "Runtime"), { recursive: true, force: true });
   }
   const projectYml = projectYmlTemplate.replace(/\{\{CRAFT_RUNTIME_SETTINGS\}\}/g, hasRuntime ? renderRuntimeSettings() : "").replace(/\{\{FEATURE_SETTINGS\}\}/g, renderFeatureSettings(config)).replace(/\{\{APP_NAME\}\}/g, name).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId).replace(/\{\{BUNDLE_ID_PREFIX\}\}/g, bundleIdPrefix).replace(/\{\{VERSION\}\}/g, config.version || "1.0.0").replace(/\{\{BUILD_NUMBER\}\}/g, config.buildNumber || "1").replace(/\{\{IOS_VERSION\}\}/g, config.iosVersion || "15.0").replace(/\{\{DEVICE_FAMILIES\}\}/g, renderDeviceFamilies(config)).replace(/\{\{TEAM_ID\}\}/g, teamId || "").replace(/\{\{NATIVE_DEPENDENCIES\}\}/g, nativeDependencies.length ? `    dependencies:
 ${nativeDependencies.join(`
 `)}` : "").replace(/\{\{NATIVE_TARGETS\}\}/g, nativeTargets.join(`
 `));
-  writeFileSync2(join2(output, "project.yml"), projectYml);
-  writeFileSync2(join2(output, "Craft.entitlements"), renderEntitlements(config));
-  writeFileSync2(join2(output, "PrivacyInfo.xcprivacy"), renderPrivacyManifest(config));
+  writeFileSync2(join3(output, "project.yml"), projectYml);
+  writeFileSync2(join3(output, "Craft.entitlements"), renderEntitlements(config));
+  writeFileSync2(join3(output, "PrivacyInfo.xcprivacy"), renderPrivacyManifest(config));
   renderAssetCatalog(output, config);
   if (config.enableLiveActivities) {
-    mkdirSync2(join2(output, "WidgetExtension"), { recursive: true });
-    const widgetInfo = readFileSync2(join2(TEMPLATES_DIR, "WidgetExtension.Info.plist"), "utf8");
-    writeFileSync2(join2(output, "WidgetExtension", "Info.plist"), widgetInfo);
+    mkdirSync2(join3(output, "WidgetExtension"), { recursive: true });
+    const widgetInfo = readFileSync2(join3(TEMPLATES_DIR, "WidgetExtension.Info.plist"), "utf8");
+    writeFileSync2(join3(output, "WidgetExtension", "Info.plist"), widgetInfo);
   }
   if (config.enableWatchApp) {
-    const watchInfo = readFileSync2(join2(TEMPLATES_DIR, "WatchApp.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
-    writeFileSync2(join2(output, "WatchApp", "Info.plist"), watchInfo);
-    writeFileSync2(join2(output, "WatchApp", "Watch.entitlements"), renderWatchEntitlements(config));
-    const watchExtensionInfo = readFileSync2(join2(TEMPLATES_DIR, "WatchExtension.Info.plist.template"), "utf8").replace(/\{\{APP_NAME\}\}/g, xmlEscape(displayName)).replace(/\{\{BUNDLE_ID\}\}/g, finalBundleId);
-    writeFileSync2(join2(output, "WatchExtension", "Info.plist"), watchExtensionInfo);
-    writeFileSync2(join2(output, "WatchExtension", "Watch.entitlements"), renderWatchEntitlements(config));
+    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);
+    writeFileSync2(join3(output, "WatchExtension", "Info.plist"), watchExtensionInfo);
+    writeFileSync2(join3(output, "WatchExtension", "Watch.entitlements"), renderWatchEntitlements(config));
   }
-  writeFileSync2(join2(output, "dist", "index.html"), renderOfflinePage(config));
+  writeFileSync2(join3(output, "dist", "index.html"), renderOfflinePage(config));
   if (usesNativeBundle(config)) {
     if (config.nativeBundle)
       installNativeBundle(config.nativeBundle, output);
@@ -1123,7 +1171,7 @@ async function build(options) {
   const { htmlPath, nativeBundlePath, devServer, output, generateProject = true } = options;
   console.log(`
 \uD83D\uDCE6 Building Craft iOS 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 ios init' first.`);
   }
@@ -1138,7 +1186,7 @@ async function build(options) {
     const bundle = nativeBundlePath ?? config.nativeBundle;
     if (bundle)
       installNativeBundle(bundle, output);
-    if (!existsSync(join2(output, "dist", "native-screen.js"))) {
+    if (!existsSync(join3(output, "dist", "native-screen.js"))) {
       throw new Error("Native iOS mode needs dist/native-screen.js. Compile a .stx screen with `stx native compile` first.");
     }
   } else if (nativeBundlePath && !isHybrid(config)) {
@@ -1164,7 +1212,7 @@ async function build(options) {
     if (bundle) {
       installNativeBundle(bundle, output);
       console.log(`   Native screens: ${bundle} \u2192 dist/native-screen.js`);
-    } else if (!existsSync(join2(output, "dist", "native-screen.js"))) {
+    } else if (!existsSync(join3(output, "dist", "native-screen.js"))) {
       console.warn("   \u26A0 nativeScreens is set but there is no native bundle: every path opens in the web view.");
     }
   }
@@ -1189,12 +1237,12 @@ async function build(options) {
 }
 async function open(options) {
   const { output } = options;
-  const files = readdirSync(output);
+  const files = readdirSync2(output);
   const xcodeproj = files.find((f) => f.endsWith(".xcodeproj"));
   if (!xcodeproj) {
     throw new Error(`No Xcode project found in ${output}. Run 'craft ios build' first.`);
   }
-  const projectPath = join2(output, xcodeproj);
+  const projectPath = join3(output, xcodeproj);
   console.log(`\uD83D\uDE80 Opening ${xcodeproj}...`);
   await $`open ${projectPath}`;
 }
@@ -1235,7 +1283,7 @@ async function showSimulator() {
   const selected = await $`xcode-select -p`.quiet().nothrow();
   const developer = selected.exitCode === 0 ? selected.stdout.toString().trim() : "";
   if (developer) {
-    const app = join2(developer, "Applications", "Simulator.app");
+    const app = join3(developer, "Applications", "Simulator.app");
     if (existsSync(app)) {
       await $`open ${app}`.quiet().nothrow();
       return;
@@ -1246,14 +1294,14 @@ async function showSimulator() {
 async function run(options) {
   const { simulator, output } = options;
   await build({ output });
-  const files = readdirSync(output);
+  const files = readdirSync2(output);
   const xcodeproj = files.find((f) => f.endsWith(".xcodeproj"));
   if (!xcodeproj) {
     throw new Error(`No Xcode project found in ${output}`);
   }
-  const projectPath = join2(output, xcodeproj);
+  const projectPath = join3(output, xcodeproj);
   const appName = xcodeproj.replace(".xcodeproj", "");
-  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-ios init' first.`);
   const config = JSON.parse(readFileSync2(configPath, "utf-8"));
@@ -1266,8 +1314,8 @@ async function run(options) {
     console.log(`   Device: ${device.name} (${device.runtime})`);
     try {
       await bootSimulator(device);
-      const derivedData = join2(output, "build");
-      const product = join2(derivedData, "Build", "Products", "Debug-iphonesimulator", `${appName}.app`);
+      const derivedData = join3(output, "build");
+      const product = join3(derivedData, "Build", "Products", "Debug-iphonesimulator", `${appName}.app`);
       await $`xcodebuild -project ${projectPath} -scheme ${appName} -configuration Debug -destination ${`id=${device.udid}`} -derivedDataPath ${derivedData} build`;
       if (!existsSync(product)) {
         throw new Error(`xcodebuild reported success but ${product} does not exist. ` + "The scheme may build a different product name than the project.");
@@ -1330,10 +1378,12 @@ export {
   init,
   hybridConfigProblems,
   hasNativeRoutes,
+  findApplicationSwiftSources,
   createNativeMutationValidator,
   build,
   bootSimulator,
   backgroundRefreshIdentifier,
   associatedDomainEntries,
+  assertNoApplicationSwiftSources,
   LAUNCH_LOGO
 };

package/dist/source-audit.d.ts

@@ -0,0 +1,8 @@
+export interface SwiftSourceAuditOptions {
+    /** Paths, relative to `root`, that are generated or otherwise owned by Craft. */
+    ignoredPaths?: readonly string[];
+}
+/** Return Swift files owned by an application rather than Craft's generated shell. */
+export declare function findApplicationSwiftSources(root: string, options?: SwiftSourceAuditOptions): string[];
+/** Fail a build when an application has started maintaining its own Swift source. */
+export declare function assertNoApplicationSwiftSources(root: string, options?: SwiftSourceAuditOptions): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.164",
+  "version": "0.0.167",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",