@craft-native/ios 0.0.228 → 0.0.232

package/README.md

@@ -216,6 +216,29 @@ does not change placement semantics.
 Reverse flex directions also retain wrapped line order on the cross axis while
 reversing each line's main-axis children, matching Android's native host.
 
+For rapid or interrupted input, `touches` submits multiple touch paths in one
+native XCTest event record. Each point has `at` in seconds and either normalized
+`x`/`y` coordinates or a `tab` name resolved to its native button center before
+submission. For example, two taps 80 ms apart:
+
+```ts
+serializeSimulatorSteps([{ command: 'touches', paths: [
+  [{ tab: 'Today', at: 0 }, { tab: 'Today', at: 0.025 }],
+  [{ tab: 'Progress', at: 0.08 }, { tab: 'Progress', at: 0.105 }],
+] }])
+```
+
+Unlike separate coordinate taps, the event record preserves timing between
+paths without waiting for app quiescence. Save the scheduled paths and verify
+the resulting selection and native content. Timing schedules are not FPS
+measurements. The Objective-C bridge belongs only to the test target and uses
+runtime-checked private XCTest event APIs; unsupported toolchains fail the
+journey rather than silently switching to synchronized input. Nothing is linked
+into the installed app. CI also delivers a 24-tap schedule to an independent
+native receiver and verifies every callback and the final selection; source
+serialization and successful compilation alone do not establish delivery. Native input semantics follow the [event-record API
+used by XCTest automation](https://appium.github.io/appium-xcuitest-driver/latest/guides/input-events/).
+
 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 web-to-web pushes use the same shared WebView across stack entries. The maintained [`fixtures/hybrid-navigation`](./fixtures/hybrid-navigation) fixture samples the outgoing page during the UIKit transition and is run by CI with:
@@ -1165,3 +1188,18 @@ This will:
 ## License
 
 MIT
+
+### Custom native fonts
+
+Set `nativeFonts` to bundle TTF/OTF files and their licenses. Keys are the font's
+PostScript name (for example `Allura-Regular`); use that same name in a native
+Text node's `fontFamily` style. Paths are local files, resolved before packaging.
+
+```ts
+nativeFonts: {
+  'Allura-Regular': { src: '/app/fonts/Allura-Regular.ttf', license: '/app/fonts/OFL.txt' },
+}
+```
+
+The iOS project registers the files through `UIAppFonts`. Android loads bundled
+typefaces from assets. Both work offline; a missing file fails the build.

package/dist/cli.js

@@ -7,7 +7,7 @@ import { resolve as resolve2 } from "path";
 
 // src/index.ts
 import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync as readdirSync2, rmSync, statSync, writeFileSync } from "fs";
-import { dirname as dirname2, join as join3, resolve } from "path";
+import { dirname as dirname2, extname, join as join3, resolve, sep as sep2 } from "path";
 var {$ } = globalThis.Bun;
 
 // src/source-audit.ts
@@ -63,6 +63,35 @@ import { dirname, join as join2 } from "path";
 var templates = join2(dirname(import.meta.dir), "templates/testing");
 
 // src/index.ts
+function syncNativeFonts(fonts, output) {
+  const destination = join3(output, "NativeFonts");
+  const names = new Set;
+  const files = Object.entries(fonts ?? {}).map(([family, entry]) => {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_.-]*$/.test(family))
+      throw new Error(`Invalid native font PostScript name: ${family}`);
+    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) + sep2)))
+      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())
+      throw new Error(`Native font ${family} must reference an existing TTF or OTF file: ${entry.src}`);
+    if (entry.license && (!existsSync(entry.license) || !statSync(entry.license).isFile()))
+      throw new Error(`Native font license not found: ${entry.license}`);
+    return { family, ...entry, filename: `${family}${extension}` };
+  });
+  rmSync(destination, { recursive: true, force: true });
+  if (!files.length)
+    return [];
+  mkdirSync(destination, { recursive: true });
+  for (const file of files) {
+    cpSync(file.src, join3(destination, file.filename));
+    if (file.license)
+      cpSync(file.license, join3(destination, `${file.family}.LICENSE.txt`));
+  }
+  return files.map((file) => `NativeFonts/${file.filename}`);
+}
 var TEMPLATES_DIR = join3(dirname2(import.meta.dir), "templates");
 function resolveCraftVersion(startDir = import.meta.dir) {
   let directory = resolve(startDir);
@@ -932,8 +961,12 @@ async function init(options) {
     config.enableSecureStorage = true;
   writeFileSync(join3(output, "craft.config.json"), JSON.stringify(config, null, 2));
   writeShell(output, config);
+  const nativeFontFiles = syncNativeFonts(config.nativeFonts, output);
   const infoPlistTemplate = readFileSync(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>
+  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(/\{\{NATIVE_FONTS\}\}/g, nativeFontFiles.length ? `    <key>UIAppFonts</key>
+    <array>
+${plistArray(nativeFontFiles, 2)}
+    </array>` : "").replace(/\{\{NON_EXEMPT_ENCRYPTION\}\}/g, config.usesNonExemptEncryption ? "true" : "false").replace(/\{\{LIVE_ACTIVITY_SUPPORT\}\}/g, config.enableLiveActivities ? `    <key>NSSupportsLiveActivities</key>
     <true/>
     <key>NSSupportsLiveActivitiesFrequentUpdates</key>
     <true/>` : "");
@@ -1000,7 +1033,9 @@ async function init(options) {
   } else {
     rmSync(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:
+  const projectYml = projectYmlTemplate.replace(/\{\{NATIVE_FONT_RESOURCES\}\}/g, nativeFontFiles.length ? `      - path: NativeFonts
+        type: folder
+        buildPhase: resources` : "").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(`
 `));

package/dist/index.d.ts

@@ -3,10 +3,17 @@
  *
  * Generates native iOS apps from web content using WKWebView.
  */
+/** Package custom fonts and their licenses; removed fonts cannot linger in the app. */
+export declare function syncNativeFonts(fonts: CraftConfig['nativeFonts'], output: string): string[];
 /** This package's version, which the app names in its user agent (`Craft/<version>`). */
 export declare function resolveCraftVersion(startDir?: string): string;
 export type CraftAppearance = 'light' | 'dark' | 'system';
 export interface CraftConfig {
+    /** Bundled font files keyed by their PostScript font name, used as native fontFamily. */
+    nativeFonts?: Record<string, {
+        src: string;
+        license?: string;
+    }>;
     appName: string;
     bundleId: string;
     /** Opt in to UIKit + JavaScriptCore instead of the default WebView. */
@@ -563,4 +570,4 @@ export declare function bootSimulator(device: SimulatorDevice): Promise<void>;
 export declare function showSimulator(): Promise<void>;
 export declare function run(options: RunOptions): Promise<void>;
 export { createNativeMutationValidator, initSimulatorDriver, serializeSimulatorSteps } from './testing.js';
-export type { NativeMutationValidator, NativeValidationResult, SimulatorDriverOptions, SimulatorStep } from './testing.js';
+export type { NativeMutationValidator, NativeValidationResult, SimulatorDriverOptions, SimulatorStep, TimedTouchPoint } from './testing.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 // @bun
 // src/index.ts
 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";
+import { dirname as dirname2, extname, join as join3, resolve, sep as sep2 } from "path";
 var {$ } = globalThis.Bun;
 
 // src/source-audit.ts
@@ -90,6 +90,8 @@ function initSimulatorDriver(options) {
   for (const [source, destination] of [
     ["HostApp.swift", "Host/HostApp.swift"],
     ["DriverTests.swift.template", "UITests/DriverTests.swift"],
+    ["CraftTimedInput.h", "UITests/CraftTimedInput.h"],
+    ["CraftTimedInput.m", "UITests/CraftTimedInput.m"],
     ["project.yml.template", "project.yml"]
   ]) {
     const path = join2(output, destination);
@@ -127,7 +129,23 @@ function serializeSimulatorSteps(steps) {
   };
   const line = (step) => {
     let arg = "";
-    if ("step" in step)
+    if ("paths" in step) {
+      if (!step.paths.length || step.paths.length > 64)
+        throw new Error("Expected 1\u201364 touch paths");
+      for (const path of step.paths) {
+        if (path.length < 2 || path.length > 64)
+          throw new Error("Expected 2\u201364 points per touch");
+        let previous = -1;
+        for (const point of path) {
+          if ("tab" in point ? !point.tab.trim() || /[\r\n]/.test(point.tab) : number(point.x) > 1 || number(point.y) > 1)
+            throw new Error("Touch targets must be tab names or normalized coordinates");
+          if (number(point.at) > 12 || point.at <= previous)
+            throw new Error("Touch coordinates must be normalized and times strictly increase within 12 seconds");
+          previous = point.at;
+        }
+      }
+      arg = JSON.stringify(step.paths);
+    } else if ("step" in step)
       arg = `${token(step.id)} ${line(step.step)}`;
     else if ("seconds" in step && !("text" in step))
       arg = String(number(step.seconds));
@@ -215,6 +233,35 @@ function createNativeMutationValidator() {
 }
 
 // src/index.ts
+function syncNativeFonts(fonts, output) {
+  const destination = join3(output, "NativeFonts");
+  const names = new Set;
+  const files = Object.entries(fonts ?? {}).map(([family, entry]) => {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_.-]*$/.test(family))
+      throw new Error(`Invalid native font PostScript name: ${family}`);
+    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) + sep2)))
+      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())
+      throw new Error(`Native font ${family} must reference an existing TTF or OTF file: ${entry.src}`);
+    if (entry.license && (!existsSync(entry.license) || !statSync(entry.license).isFile()))
+      throw new Error(`Native font license not found: ${entry.license}`);
+    return { family, ...entry, filename: `${family}${extension}` };
+  });
+  rmSync2(destination, { recursive: true, force: true });
+  if (!files.length)
+    return [];
+  mkdirSync2(destination, { recursive: true });
+  for (const file of files) {
+    cpSync(file.src, join3(destination, file.filename));
+    if (file.license)
+      cpSync(file.license, join3(destination, `${file.family}.LICENSE.txt`));
+  }
+  return files.map((file) => `NativeFonts/${file.filename}`);
+}
 var TEMPLATES_DIR = join3(dirname2(import.meta.dir), "templates");
 function resolveCraftVersion(startDir = import.meta.dir) {
   let directory = resolve(startDir);
@@ -1088,8 +1135,12 @@ async function init(options) {
     config.enableSecureStorage = true;
   writeFileSync2(join3(output, "craft.config.json"), JSON.stringify(config, null, 2));
   writeShell(output, config);
+  const nativeFontFiles = syncNativeFonts(config.nativeFonts, output);
   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>
+  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(/\{\{NATIVE_FONTS\}\}/g, nativeFontFiles.length ? `    <key>UIAppFonts</key>
+    <array>
+${plistArray(nativeFontFiles, 2)}
+    </array>` : "").replace(/\{\{NON_EXEMPT_ENCRYPTION\}\}/g, config.usesNonExemptEncryption ? "true" : "false").replace(/\{\{LIVE_ACTIVITY_SUPPORT\}\}/g, config.enableLiveActivities ? `    <key>NSSupportsLiveActivities</key>
     <true/>
     <key>NSSupportsLiveActivitiesFrequentUpdates</key>
     <true/>` : "");
@@ -1156,7 +1207,9 @@ async function init(options) {
   } else {
     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:
+  const projectYml = projectYmlTemplate.replace(/\{\{NATIVE_FONT_RESOURCES\}\}/g, nativeFontFiles.length ? `      - path: NativeFonts
+        type: folder
+        buildPhase: resources` : "").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(`
 `));
@@ -1387,6 +1440,7 @@ async function run(options) {
 export {
   usesNativeBundle,
   syncWebAssets,
+  syncNativeFonts,
   showSimulator,
   serializeSimulatorSteps,
   run,

package/dist/testing.d.ts

@@ -12,6 +12,14 @@ export interface SimulatorDriverOptions {
 }
 /** Generate the reusable XCUITest shell from package templates. No app-owned Swift. */
 export declare function initSimulatorDriver(options: SimulatorDriverOptions): void;
+export type TimedTouchPoint = {
+    x: number;
+    y: number;
+    at: number;
+} | {
+    tab: string;
+    at: number;
+};
 export type SimulatorStep = {
     command: 'launch' | 'activate' | 'terminate' | 'home' | 'back' | 'return' | 'unlabelled' | 'notifications';
 } | {
@@ -46,6 +54,11 @@ export type SimulatorStep = {
     command: 'tapxy';
     x: number;
     y: number;
+}
+/** One native event record, without quiescence between paths. Times are seconds. */
+ | {
+    command: 'touches';
+    paths: TimedTouchPoint[][];
 } | {
     command: 'field';
     index: number;

package/package.json

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

package/templates/CraftNativeScreen.swift

@@ -6837,17 +6837,21 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     ) {
         let id = ObjectIdentifier(textView)
         textView.delegate = self
-        textView.textColor = color(style["color"]) ?? .label
-        textView.font = textFont(style, default: .systemFont(ofSize: 16))
-        textView.textAlignment = textAlignment(style["textAlign"])
-        textView.tintColor = color(props["selectionColor"])
-        textView.keyboardType = keyboardType(props["keyboardType"])
-        textView.returnKeyType = returnKeyType(props["returnKeyType"])
-        textView.autocorrectionType = props["autoCorrect"] as? Bool == false ? .no : .default
-        textView.autocapitalizationType = capitalizationType(props["autoCapitalize"])
-        textView.isSecureTextEntry = props["secureTextEntry"] as? Bool == true
+        // UIKit owns marked text until the keyboard commits it. Reapplying
+        // typography or input traits during composition can commit that draft.
+        if textView.markedTextRange == nil {
+            textView.textColor = color(style["color"]) ?? .label
+            textView.font = textFont(style, default: .systemFont(ofSize: 16))
+            textView.textAlignment = textAlignment(style["textAlign"])
+            textView.tintColor = color(props["selectionColor"])
+            textView.keyboardType = keyboardType(props["keyboardType"])
+            textView.returnKeyType = returnKeyType(props["returnKeyType"])
+            textView.autocorrectionType = props["autoCorrect"] as? Bool == false ? .no : .default
+            textView.autocapitalizationType = capitalizationType(props["autoCapitalize"])
+            textView.isSecureTextEntry = props["secureTextEntry"] as? Bool == true
+            applyAutofill(to: textView, props: props)
+        }
         textView.isEditable = props["editable"] as? Bool != false
-        applyAutofill(to: textView, props: props)
         // The style's padding is where the text starts, as in a web textarea.
         let padding = paddingInsets(style)
         if let craftTextView = textView as? CraftNativeTextView {
@@ -6875,12 +6879,17 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             craftTextView.placeholderFont = textView.font
         }
         updateTextView(textView, value: (props["value"] as? String) ?? defaultValue)
-        let selectedRange = textView.selectedRange
-        let attributes = inputTextAttributes(style, font: textView.font ?? .systemFont(ofSize: 16), alignment: textView.textAlignment)
-        textView.typingAttributes = attributes
-        if !textView.text.isEmpty {
-            textView.attributedText = NSAttributedString(string: textView.text, attributes: attributes)
-            textView.selectedRange = selectedRange
+        if textView.markedTextRange == nil {
+            let attributes = inputTextAttributes(style, font: textView.font ?? .systemFont(ofSize: 16), alignment: textView.textAlignment)
+            let styled = NSAttributedString(string: textView.text ?? "", attributes: attributes)
+            if !textView.text.isEmpty, textView.attributedText?.isEqual(to: styled) != true {
+                let selectedRange = textView.selectedRange
+                textView.attributedText = styled
+                textView.selectedRange = selectedRange
+            }
+            if !(textView.typingAttributes as NSDictionary).isEqual(attributes as NSDictionary) {
+                textView.typingAttributes = attributes
+            }
         }
         (textView as? CraftNativeTextView)?.refreshPlaceholder()
         updateHandler(nonEmptyHandler(events["onChange"]) ?? nonEmptyHandler(events["onChangeText"]), for: textView)

package/templates/Info.plist.template

@@ -26,6 +26,7 @@
     <true/>
     <key>ITSAppUsesNonExemptEncryption</key>
     <{{NON_EXEMPT_ENCRYPTION}}/>
+{{NATIVE_FONTS}}
     <key>UILaunchScreen</key>
     <dict>
 {{LAUNCH_SCREEN}}

package/templates/project.yml.template

@@ -27,6 +27,7 @@ targets:
       - path: craft.config.json
         optional: true
         buildPhase: resources
+{{NATIVE_FONT_RESOURCES}}
       - path: Assets.xcassets
         buildPhase: resources
       - path: PrivacyInfo.xcprivacy

package/templates/testing/CraftTimedInput.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+#import <CoreGraphics/CoreGraphics.h>
+
+NS_ASSUME_NONNULL_BEGIN
+/// Test-runner-only native events. Never linked into a shipped application.
+@interface CraftTimedInput : NSObject
++ (BOOL)synthesizePaths:(NSArray<NSArray<NSDictionary<NSString *, NSNumber *> *> *> *)paths
+                 frame:(CGRect)frame
+                 error:(NSError * _Nullable * _Nullable)error NS_SWIFT_NAME(synthesize(paths:frame:));
+@end
+NS_ASSUME_NONNULL_END

package/templates/testing/CraftTimedInput.m

@@ -0,0 +1,75 @@
+#import "CraftTimedInput.h"
+#import <UIKit/UIKit.h>
+#import <math.h>
+
+// XCTest's own touch-record API is private. Look up classes and check every
+// selector at runtime; unsupported Xcode versions fail rather than skipping or
+// falling back to serialized taps. These declarations create no class linkage.
+@interface NSObject (CraftTestingTouchRecords)
+- (id)initForTouchAtPoint:(CGPoint)point offset:(double)offset;
+- (void)moveToPoint:(CGPoint)point atOffset:(double)offset;
+- (void)liftUpAtOffset:(double)offset;
+- (id)initWithName:(NSString *)name interfaceOrientation:(NSInteger)orientation;
+- (void)addPointerEventPath:(id)path;
+- (BOOL)synthesizeWithError:(NSError **)error;
+@end
+
+@implementation CraftTimedInput
++ (BOOL)fail:(NSString *)message error:(NSError **)error {
+    if (error) *error = [NSError errorWithDomain:@"CraftTimedInput" code:1
+                                      userInfo:@{NSLocalizedDescriptionKey: message}];
+    return NO;
+}
+
++ (BOOL)synthesizePaths:(NSArray *)paths frame:(CGRect)frame error:(NSError **)error {
+    if (![paths isKindOfClass:NSArray.class] || paths.count == 0 || paths.count > 64
+        || CGRectIsEmpty(frame) || !isfinite(frame.size.width) || !isfinite(frame.size.height))
+        return [self fail:@"Expected 1–64 timed touch paths and a visible app frame" error:error];
+    // Validate the entire record before any native event is submitted.
+    for (id path in paths) {
+        if (![path isKindOfClass:NSArray.class] || [path count] < 2 || [path count] > 64)
+            return [self fail:@"Each touch needs 2–64 points" error:error];
+        double previous = -1;
+        for (id point in path) {
+            if (![point isKindOfClass:NSDictionary.class]) return [self fail:@"Invalid touch point" error:error];
+            for (NSString *key in @[@"x", @"y", @"at"]) {
+                id value = point[key];
+                if (![value isKindOfClass:NSNumber.class] || !isfinite([value doubleValue]))
+                    return [self fail:@"Touch coordinates and times must be finite numbers" error:error];
+            }
+            double x = [point[@"x"] doubleValue], y = [point[@"y"] doubleValue], at = [point[@"at"] doubleValue];
+            if (x < 0 || x > 1 || y < 0 || y > 1 || at < 0 || at > 12 || at <= previous)
+                return [self fail:@"Touch coordinates must be normalized; times must increase within 12 seconds" error:error];
+            previous = at;
+        }
+    }
+    Class recordClass = NSClassFromString(@"XCSynthesizedEventRecord");
+    Class pathClass = NSClassFromString(@"XCPointerEventPath");
+    for (NSString *name in @[@"initWithName:interfaceOrientation:", @"addPointerEventPath:", @"synthesizeWithError:"])
+        if (![recordClass instancesRespondToSelector:NSSelectorFromString(name)])
+            return [self fail:@"XCTest does not support timed native event records" error:error];
+    for (NSString *name in @[@"initForTouchAtPoint:offset:", @"moveToPoint:atOffset:", @"liftUpAtOffset:"])
+        if (![pathClass instancesRespondToSelector:NSSelectorFromString(name)])
+            return [self fail:@"XCTest does not support timed native touch paths" error:error];
+    id record = [[recordClass alloc] initWithName:@"Craft timed native input" interfaceOrientation:UIInterfaceOrientationPortrait];
+    if (!record) return [self fail:@"XCTest refused a native event record" error:error];
+    for (NSArray *points in paths) {
+        NSDictionary *first = points.firstObject;
+        CGPoint start = CGPointMake(frame.origin.x + [first[@"x"] doubleValue] * frame.size.width,
+                                    frame.origin.y + [first[@"y"] doubleValue] * frame.size.height);
+        id path = [[pathClass alloc] initForTouchAtPoint:start offset:[first[@"at"] doubleValue]];
+        if (!path) return [self fail:@"XCTest refused a native touch path" error:error];
+        for (NSUInteger index = 1; index < points.count; index++) {
+            NSDictionary *point = points[index];
+            CGPoint location = CGPointMake(frame.origin.x + [point[@"x"] doubleValue] * frame.size.width,
+                                           frame.origin.y + [point[@"y"] doubleValue] * frame.size.height);
+            [path moveToPoint:location atOffset:[point[@"at"] doubleValue]];
+        }
+        [path liftUpAtOffset:[points.lastObject[@"at"] doubleValue]];
+        [record addPointerEventPath:path];
+    }
+    // One dispatch retains the native offsets between different fingers/taps.
+    // Individual XCUICoordinate.tap() calls would wait for app quiescence.
+    return [record synthesizeWithError:error];
+}
+@end

package/templates/testing/DriverTests.swift.template

@@ -1,4 +1,5 @@
 import XCTest
+import Darwin
 
 /// Drives the installed app from a script the Mac serves (netswitch.ts
 /// `/script`), one command a line:
@@ -20,6 +21,7 @@ import XCTest
 ///   tap <text>            first hittable element whose label contains text
 ///   tapif <text>          tap it when it is on screen, else carry on (the big timer's "Show the controls")
 ///   tapid <identifier>
+///   touches <JSON>       timed normalized touch paths in one native dispatch
 ///   tapxy <x> <y>         normalised 0…1 of the screen
 ///   tapexact <label>      a button whose label is exactly this
 ///   back                  the navigation bar's back button, else an edge swipe
@@ -288,6 +290,52 @@ final class DriverTests: XCTestCase {
             let target = identified(arg)
             if target.waitForExistence(timeout: 10) { press(target); note("tapid \(arg): ok") }
             else { XCTFail("Element not found"); note("FAIL tapid \(arg): NOT FOUND") }
+        case "touches":
+            do {
+                guard let data = arg.data(using: .utf8),
+                      let rawPaths = try JSONSerialization.jsonObject(with: data) as? [[[String: Any]]] else {
+                    check(false, "touches requires JSON arrays of x/y/at or tab/at points")
+                    return
+                }
+                let frame = app.frame
+                var tabLocations: [String: CGPoint] = [:]
+                var paths: [[[String: NSNumber]]] = []
+                for rawPath in rawPaths {
+                    var path: [[String: NSNumber]] = []
+                    for rawPoint in rawPath {
+                        var point = rawPoint
+                        if let name = point.removeValue(forKey: "tab") as? String {
+                            if tabLocations[name] == nil {
+                                guard let button = tabButton(name), frame.width > 0, frame.height > 0 else {
+                                    check(false, "Timed native input cannot find tab \(name)")
+                                    return
+                                }
+                                let rect = button.frame
+                                tabLocations[name] = CGPoint(x: (rect.midX - frame.minX) / frame.width,
+                                                             y: (rect.midY - frame.minY) / frame.height)
+                            }
+                            point["x"] = tabLocations[name]!.x
+                            point["y"] = tabLocations[name]!.y
+                        }
+                        guard let numbers = point as? [String: NSNumber] else {
+                            check(false, "Timed touch points must contain numeric coordinates and times")
+                            return
+                        }
+                        path.append(numbers)
+                    }
+                    paths.append(path)
+                }
+                let scheduled = try JSONSerialization.data(withJSONObject: paths, options: [.sortedKeys])
+                let started = ProcessInfo.processInfo.systemUptime
+                if (paths.flatMap { $0 }.compactMap { $0["at"]?.doubleValue }.max() ?? 0) >= 2 {
+                    note("BEGIN held timed native input")
+                    fflush(nil)
+                }
+                try CraftTimedInput.synthesize(paths: paths, frame: frame)
+                let elapsed = ProcessInfo.processInfo.systemUptime - started
+                post("/save?name=timed-input-\(Int(started * 1000)).json", scheduled)
+                check(true, "timed native input: \(paths.count) paths, \(elapsed)s wall time")
+            } catch { check(false, "timed native input: \(error)") }
         case "tapxy":
             let xy = arg.split(separator: " ").compactMap { Double($0) }
             if xy.count == 2 && xy.allSatisfy({ $0 >= 0 && $0 <= 1 }) {

package/templates/testing/project.yml.template

@@ -19,6 +19,7 @@ targets:
     platform: iOS
     sources: [UITests]
     settings:
+      SWIFT_OBJC_BRIDGING_HEADER: UITests/CraftTimedInput.h
       TEST_TARGET_NAME: {{PROJECT_NAME}}Host
       PRODUCT_BUNDLE_IDENTIFIER: {{BUNDLE_PREFIX}}.uitests
       GENERATE_INFOPLIST_FILE: YES