@craft-native/ios 0.0.175 → 0.0.177

package/README.md

@@ -74,6 +74,11 @@ views when rows are materialized or recycled.
 bun add craft-native
 ```
 
+## Native map input contract
+
+Map coordinates are finite and range-checked at the native boundary; invalid
+points and pole-crossing regions are ignored on iOS just as on Android.
+
 ## Quick Start
 
 ### 1. Initialize Project
@@ -124,7 +129,7 @@ authorization or requiring local notifications to be enabled.
 Keyboard frame changes update the native controller's additional safe area, so
 focused inputs and responsive `onLayout` measurements move with the keyboard.
 
-The opt-in `native` renderer hosts compiled `.stx` screens in JavaScriptCore and renders their `View`, `SafeAreaView`, `Text`, `Button`, `Link`, `Checkbox`, `TextInput`, `Picker`, `DatePicker`, `Switch`, `Slider`, `ActivityIndicator`, `Icon`, `Image`, `Video`, `Map`, `ScrollView`, `SectionList`, and recycling `FlatList` nodes as UIKit controls. `Map` uses MapKit for trail polylines and marker taps; its overlays carry flat latitude/longitude `geometry` arrays and can fit the visible region to their bounds. `Icon` uses SF Symbols with the shared symbol/name contract and accessibility metadata. `SectionList` uses the same native scroll host for ordinary `.stx` slot children; grouped section data should use `FlatList` until the section-data protocol is available. `FlatList` uses `UICollectionView` with stable keyed rows, incremental diffs, grids, horizontal and inverted layouts, list chrome, and end-reached pagination. Native views support `onLayout` callbacks with point-based frame measurements that refresh after safe-area or orientation changes. Flex items support `flex`, `flexGrow`, `flexShrink`, and numeric `flexBasis` for main-axis space distribution. Native screens also expose the versioned capability bridge: JSON storage and SQLite survive relaunch, lifecycle and deep-link events are scoped to the top route, and local notifications use `UNUserNotificationCenter`. Enable each capability in `craft.config.json`; disabled calls preserve Craft's `CAPABILITY_DISABLED` rejection code and every request has deterministic timeout/cancellation behavior. The default remains `web`; existing iOS apps are unchanged. `Checkbox` supports controlled `checked`/`value`, indeterminate state, and boolean `onValueChange`; `Picker` renders `<select>`/`<option>` values with `onValueChange` or `onChange`; `DatePicker` emits local date/time values plus ISO and millisecond timestamps; `Switch` supports state-aware `trackColor`, `thumbColor`, and iOS `ios_backgroundColor`; `Slider` supports track/thumb tint props and `step` snapping; `Image` reports load lifecycle events and structured failures; `Video` uses an `AVPlayerViewController` attached to the native screen for URI playback, native controls, and route-safe teardown. The portable component, capability, list, style, image-source, event, accessibility, and reconciliation behavior is specified in the [Native STX guide](../../docs/guides/native-stx.md).
+The opt-in `native` renderer hosts compiled `.stx` screens in JavaScriptCore and renders their `View`, `SafeAreaView`, `Text`, `Button`, `Link`, `Checkbox`, `TextInput`, `Picker`, `DatePicker`, `Switch`, `Slider`, `ActivityIndicator`, `Icon`, `Image`, `ImageBackground`, `Video`, `Map`, `Svg`, `G`, `SvgText`, `ScrollView`, `SectionList`, and recycling `FlatList` nodes as UIKit controls. `Map` uses MapKit for trail polylines and marker taps; its overlays carry flat latitude/longitude `geometry` arrays and can fit the visible region to their bounds. `Svg` is a DOM-free drawing surface; grouped `G` and `SvgText` nodes are painted inside it. `Icon` uses SF Symbols with the shared symbol/name contract and accessibility metadata. `SectionList` uses the same native scroll host for ordinary `.stx` slot children; grouped section data should use `FlatList` until the section-data protocol is available. `FlatList` uses `UICollectionView` with stable keyed rows, incremental diffs, grids, horizontal and inverted layouts, list chrome, and end-reached pagination. Native views support `onLayout` callbacks with point-based frame measurements that refresh after safe-area or orientation changes. Flex items support `flex`, `flexGrow`, `flexShrink`, and numeric `flexBasis` for main-axis space distribution. Native screens also expose the versioned capability bridge: JSON storage and SQLite survive relaunch, lifecycle and deep-link events are scoped to the top route, and local notifications use `UNUserNotificationCenter`. Enable each capability in `craft.config.json`; disabled calls preserve Craft's `CAPABILITY_DISABLED` rejection code and every request has deterministic timeout/cancellation behavior. The default remains `web`; existing iOS apps are unchanged. `Checkbox` supports controlled `checked`/`value`, indeterminate state, and boolean `onValueChange`; `Picker` renders `<select>`/`<option>` values with `onValueChange` or `onChange`; `DatePicker` emits local date/time values plus ISO and millisecond timestamps; `Switch` supports state-aware `trackColor`, `thumbColor`, and iOS `ios_backgroundColor`; `Slider` supports track/thumb tint props and `step` snapping; `Image` reports load lifecycle events and structured failures; `Video` uses an `AVPlayerViewController` attached to the native screen for URI playback, native controls, and route-safe teardown. The portable component, capability, list, style, image-source, event, accessibility, and reconciliation behavior is specified in the [Native STX guide](../../docs/guides/native-stx.md).
 
 ```bash
 craft ios init NativeDemo --renderer native --output ./ios-native
@@ -159,8 +164,9 @@ the [Native STX guide](../../docs/guides/native-stx.md). On macOS,
 `bun packages/ios/scripts/test-native-render.ts` runs the renderer's unit and
 simulator UI tests.
 
-The iOS host uses the shared layout ABI when it is available and retains a
-local fallback for older runtimes. Both paths implement wrapped-line and grid
+The iOS host uses the shared tree-layout ABI for eligible definite-size,
+non-grid, non-wrapped containers and retains a local fallback for older
+runtimes or unsupported styles. Both paths implement wrapped-line and grid
 `alignContent`, including `space-evenly`, so a missing optional shared symbol
 does not change placement semantics.
 Reverse flex directions also retain wrapped line order on the cross axis while

package/dist/cli.js

@@ -515,7 +515,9 @@ function renderFeatureSettings(config) {
 }
 function renderPrivacyManifest(config) {
   const privacy = config.privacy ?? {};
-  const collected = privacy.collectedDataTypes ?? [];
+  const collected = [...privacy.collectedDataTypes ?? []];
+  if (config.crashReporting?.key && !collected.some((item) => item.type === "NSPrivacyCollectedDataTypeCrashData"))
+    collected.push({ type: "NSPrivacyCollectedDataTypeCrashData", linked: true, tracking: false, purposes: ["NSPrivacyCollectedDataTypePurposeAppFunctionality"] });
   const accessed = privacy.accessedApiTypes ?? [];
   const collectedXml = collected.map((item) => `        <dict>
             <key>NSPrivacyCollectedDataType</key>
@@ -877,6 +879,7 @@ function writeShell(output, config) {
   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"));
+  writeFileSync(join3(output, "Sources", "CraftCrashReporter.swift"), readFileSync(join3(TEMPLATES_DIR, "CraftCrashReporter.swift"), "utf-8").replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION));
   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`],
@@ -951,6 +954,7 @@ async function init(options) {
       - Shared
     settings:
       INFOPLIST_FILE: WidgetExtension/Info.plist
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.liveactivity
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES
@@ -966,6 +970,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchApp/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchApp/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp
       SWIFT_VERSION: "5.0"
       SKIP_INSTALL: YES
@@ -980,6 +985,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchExtension/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchExtension/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp.watchkitextension
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES

package/dist/index.d.ts

@@ -239,6 +239,25 @@ export interface CraftConfig {
      * `craft.secureStorage.getSync('auth.token')`. Turns on secure storage.
      */
     shareStorage?: Record<string, string>;
+    /**
+     * Crash and error reporting to bughq (CraftCrashReporter.swift): crashes
+     * and hangs (signal handlers, NSException, MetricKit), uncaught JavaScript
+     * errors in native screens and the app script, and what the page sends
+     * through `craft.crashReporter`. Queued on disk and sent when online.
+     */
+    crashReporting?: CraftCrashReporting;
+}
+export interface CraftCrashReporting {
+    /** The bughq project's public ingest key. Ships in the app; it is not a secret. */
+    key: string;
+    /** The bughq host. Default https://bughq.org. */
+    host?: string;
+    /** Default `production`. */
+    environment?: string;
+    /** The release every event names. Default `<version>+<build>`, e.g. `1.0.0+41`. */
+    release?: string;
+    /** One session per launch, for crash-free sessions per release. Default on. */
+    sessions?: boolean;
 }
 export interface CraftTab {
     /** The tab's root path; comes back to the page in `craftTabSelect`. */

package/dist/index.js

@@ -643,7 +643,9 @@ function renderFeatureSettings(config) {
 }
 function renderPrivacyManifest(config) {
   const privacy = config.privacy ?? {};
-  const collected = privacy.collectedDataTypes ?? [];
+  const collected = [...privacy.collectedDataTypes ?? []];
+  if (config.crashReporting?.key && !collected.some((item) => item.type === "NSPrivacyCollectedDataTypeCrashData"))
+    collected.push({ type: "NSPrivacyCollectedDataTypeCrashData", linked: true, tracking: false, purposes: ["NSPrivacyCollectedDataTypePurposeAppFunctionality"] });
   const accessed = privacy.accessedApiTypes ?? [];
   const collectedXml = collected.map((item) => `        <dict>
             <key>NSPrivacyCollectedDataType</key>
@@ -1009,6 +1011,7 @@ function writeShell(output, config) {
   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"));
+  writeFileSync2(join3(output, "Sources", "CraftCrashReporter.swift"), readFileSync2(join3(TEMPLATES_DIR, "CraftCrashReporter.swift"), "utf-8").replace(/\{\{CRAFT_VERSION\}\}/g, CRAFT_VERSION));
   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`],
@@ -1083,6 +1086,7 @@ async function init(options) {
       - Shared
     settings:
       INFOPLIST_FILE: WidgetExtension/Info.plist
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.liveactivity
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES
@@ -1098,6 +1102,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchApp/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchApp/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp
       SWIFT_VERSION: "5.0"
       SKIP_INSTALL: YES
@@ -1112,6 +1117,7 @@ async function init(options) {
     settings:
       INFOPLIST_FILE: WatchExtension/Info.plist
       CODE_SIGN_ENTITLEMENTS: WatchExtension/Watch.entitlements
+      PRODUCT_NAME: "$(TARGET_NAME)"
       PRODUCT_BUNDLE_IDENTIFIER: ${finalBundleId}.watchkitapp.watchkitextension
       SWIFT_VERSION: "5.0"
       APPLICATION_EXTENSION_API_ONLY: YES

package/dist/testing.d.ts

@@ -24,6 +24,11 @@ export type SimulatorStep = {
 } | {
     command: 'swipe';
     direction: 'up' | 'down' | 'left' | 'right';
+}
+/** The system back-swipe: a drag in from the left edge (or the right). */
+ | {
+    command: 'edge';
+    direction: 'left' | 'right';
 } | {
     command: 'tabbar';
     state: 'shown' | 'hidden';

package/package.json

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

package/templates/CraftApp.swift

@@ -194,8 +194,10 @@ struct CraftRecoveryBudget {
 
 final class CraftAppDelegate: NSObject, UIApplicationDelegate, UNUserNotificationCenterDelegate {
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
-        UNUserNotificationCenter.current().delegate = self
         let config = CraftConfig.bundled()
+        // First, so a crash anywhere in the rest of launch is reported too.
+        CraftCrashReporter.shared.start(config)
+        UNUserNotificationCenter.current().delegate = self
         // Before launch finishes, which is the only time iOS accepts it.
         CraftBackgroundWork.shared.registerRefresh(config)
         // The shell, the app script and an all-native app's services now,
@@ -1297,6 +1299,9 @@ struct CraftConfig: Codable {
     /// The bundle route of the app script: a screen-less script that runs for
     /// the app's whole life and hears the app's events (CraftHybrid.swift).
     var nativeApp: String? = nil
+    /// Crash and error reporting to bughq (CraftCrashReporter.swift). Off
+    /// unless the config names a project key.
+    var crashReporting: CrashReporting? = nil
 
     struct Tab: Codable {
         var id: String
@@ -1311,6 +1316,18 @@ struct CraftConfig: Codable {
         /// The soonest iOS may run it again, in minutes (15 if unset).
         var minimumIntervalMinutes: Double? = nil
     }
+
+    struct CrashReporting: Codable {
+        /// The bughq project's public ingest key.
+        var key: String
+        /// The bughq host; https://bughq.org if unset.
+        var host: String? = nil
+        var environment: String? = nil
+        /// The release events name; `<version>+<build>` if unset.
+        var release: String? = nil
+        /// A session per launch, for crash-free sessions. On unless false.
+        var sessions: Bool? = nil
+    }
 }
 
 extension CraftConfig {
@@ -3458,6 +3475,7 @@ struct CraftWebView: UIViewRepresentable {
                     heartRate: \(config.enableHeartRate),
                     scheduledWorkouts: \(config.enableScheduledWorkouts),
                     speech: true,
+                    crashReporter: \(CraftCrashReporter.shared.enabled),
                     network: true,
                     deviceInfo: true,
                     badge: true,
@@ -4451,6 +4469,38 @@ struct CraftWebView: UIViewRepresentable {
                     }
                 },
 
+                // Crash and error reporting (CraftCrashReporter.swift). The
+                // page's error SDK hands its events here, so they share the
+                // app's on-disk outbox (sent when online), its session and the
+                // device's own context. Each resolves at once: the work is a
+                // file write, and the send happens later.
+                crashReporter: {
+                    _post: function(message) {
+                        var self = window.craft;
+                        var id = 'cb_' + (++self._callbackId);
+                        message.callbackId = id;
+                        window.webkit.messageHandlers.craft.postMessage(message);
+                        return new Promise(function(resolve, reject) {
+                            self._callbacks[id] = {resolve: resolve, reject: reject};
+                        });
+                    },
+                    capture: function(event) {
+                        return this._post({action: 'crashReporterCapture', event: event || {}});
+                    },
+                    setUser: function(id) {
+                        return this._post({action: 'crashReporterSetUser', id: id == null ? null : String(id)});
+                    },
+                    addBreadcrumb: function(breadcrumb) {
+                        return this._post({action: 'crashReporterAddBreadcrumb', breadcrumb: breadcrumb || {}});
+                    },
+                    flush: function() {
+                        return this._post({action: 'crashReporterFlush'});
+                    },
+                    context: function() {
+                        return this._post({action: 'crashReporterContext'});
+                    }
+                },
+
                 // Orientation Lock
                 lockOrientation: function(orientation) {
                     var self = this;