@craft-native/ios 0.0.156 → 0.0.160

package/README.md

@@ -112,10 +112,15 @@ In Xcode:
 
 ### Experimental WebView-free screen
 
+Native screens also support `ImageBackground`, which loads an image behind
+ordinary native children while preserving the shared flex layout contract.
+`KeyboardAvoidingView` also responds to the native keyboard with `padding`,
+`position`, or `height` behavior.
+
 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`, `TextInput`, `Picker`, `Switch`, `Slider`, `ActivityIndicator`, `Image`, `Video`, `ScrollView`, and recycling `FlatList` nodes as UIKit controls. `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. `Picker` renders `<select>`/`<option>` values with `onValueChange` or `onChange`; `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`, `Video`, `ScrollView`, and recycling `FlatList` nodes as UIKit controls. `Icon` uses SF Symbols with the shared symbol/name contract and accessibility metadata. `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
@@ -274,7 +279,8 @@ The web view also: shows `alert`, `confirm` and `prompt` as system alerts;
 opens `target=_blank` and `window.open` for the app's own origins in place and
 anything else in `SFSafariViewController`; grants `getUserMedia` to the app's
 own origin without WebKit's extra prompt; dismisses the keyboard with a drag;
-allows picture in picture; ends its user agent with `Craft/<version>
+allows picture in picture; ends its user agent with the builder package's
+resolved `Craft/<version>
 <AppName>/<version>`; brings a page whose content process died back under the
 splash, on the page it was showing, at most three times a minute before
 showing the offline page; and saves its `interactionState` when the app goes to
@@ -385,6 +391,8 @@ await health.requestAuthorization(['workouts', 'heartRate', 'sleep'], { write: f
 const workouts = await health.getWorkouts({ startDate: Date.now() - 30 * 86400000 })
 // One value per local day: sums, averages, the latest weight, hours asleep.
 const hrv = await health.getDailyStatistics('heartRateVariability', { startDate: Date.now() - 30 * 86400000 })
+// What a food log wrote (MyFitnessPal, Lose It!...): kcal, then grams of protein, carbohydrate and fat, summed per day.
+const eaten = await health.getDailyStatistics('dietaryEnergy', { startDate: Date.now() - 7 * 86400000 })
 // Every heart-rate reading in a range (bpm, start/end, source and device), oldest first.
 const readings = await health.getHeartRateSamples({ startDate: Date.now() - 86400000 })
 // The night as Apple Health recorded it: in bed, awake, and each asleep stage.

package/dist/cli.js

@@ -15,13 +15,22 @@ var templates = join(dirname(import.meta.dir), "templates/testing");
 
 // src/index.ts
 var TEMPLATES_DIR = join2(dirname2(import.meta.dir), "templates");
-var CRAFT_VERSION = (() => {
-  try {
-    return JSON.parse(readFileSync(join2(dirname2(import.meta.dir), "package.json"), "utf8")).version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
+function resolveCraftVersion(startDir = import.meta.dir) {
+  let directory = resolve(startDir);
+  while (true) {
+    try {
+      const packageJSON = JSON.parse(readFileSync(join2(directory, "package.json"), "utf8"));
+      if (packageJSON.name === "@craft-native/ios" && typeof packageJSON.version === "string" && packageJSON.version.length > 0)
+        return packageJSON.version;
+    } catch {}
+    const parent = dirname2(directory);
+    if (parent === directory)
+      break;
+    directory = parent;
   }
-})();
+  return "0.0.0";
+}
+var CRAFT_VERSION = resolveCraftVersion();
 function normalizeNativePath(raw) {
   if (typeof raw !== "string")
     return null;

package/dist/index.d.ts

@@ -3,6 +3,8 @@
  *
  * Generates native iOS apps from web content using WKWebView.
  */
+/** 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 {
     appName: string;

package/dist/index.js

@@ -66,9 +66,11 @@ function serializeSimulatorSteps(steps) {
       throw new Error("Simulator identifiers must be nonempty single tokens");
     return value;
   };
-  return steps.map((step) => {
+  const line = (step) => {
     let arg = "";
-    if ("seconds" in step && !("text" in step))
+    if ("step" in step)
+      arg = `${token(step.id)} ${line(step.step)}`;
+    else if ("seconds" in step && !("text" in step))
       arg = String(number(step.seconds));
     else if ("milliseconds" in step)
       arg = String(number(step.milliseconds));
@@ -100,8 +102,9 @@ function serializeSimulatorSteps(steps) {
     if (/[\r\n]/.test(arg))
       throw new Error("Simulator arguments cannot contain newlines");
     return `${step.command}${arg ? ` ${arg}` : ""}`;
-  }).join(`
-`) + `
+  };
+  return `${steps.map(line).join(`
+`)}
 `;
 }
 function createNativeMutationValidator() {
@@ -141,13 +144,22 @@ function createNativeMutationValidator() {
 
 // src/index.ts
 var TEMPLATES_DIR = join2(dirname2(import.meta.dir), "templates");
-var CRAFT_VERSION = (() => {
-  try {
-    return JSON.parse(readFileSync2(join2(dirname2(import.meta.dir), "package.json"), "utf8")).version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
+function resolveCraftVersion(startDir = import.meta.dir) {
+  let directory = resolve(startDir);
+  while (true) {
+    try {
+      const packageJSON = JSON.parse(readFileSync2(join2(directory, "package.json"), "utf8"));
+      if (packageJSON.name === "@craft-native/ios" && typeof packageJSON.version === "string" && packageJSON.version.length > 0)
+        return packageJSON.version;
+    } catch {}
+    const parent = dirname2(directory);
+    if (parent === directory)
+      break;
+    directory = parent;
   }
-})();
+  return "0.0.0";
+}
+var CRAFT_VERSION = resolveCraftVersion();
 function normalizeNativePath(raw) {
   if (typeof raw !== "string")
     return null;
@@ -1274,6 +1286,7 @@ export {
   run,
   restoreShell,
   resolveRuntimeDir,
+  resolveCraftVersion,
   resolveAppearance,
   renderWatchEntitlements,
   renderUsageDescriptions,

package/dist/testing.d.ts

@@ -36,7 +36,7 @@ export type SimulatorStep = {
     index: number;
     text: string;
 } | {
-    command: 'typeid';
+    command: 'typeid' | 'labelid';
     id: string;
     text: string;
 } | {
@@ -52,6 +52,12 @@ export type SimulatorStep = {
 } | {
     command: 'openurl';
     url: string;
+}
+/** Runs `step` only when the element with this identifier is there (a screen shown the first time). */
+ | {
+    command: 'ifid';
+    id: string;
+    step: SimulatorStep;
 };
 /** Typed journeys use the same wire protocol as existing line-based scripts. */
 export declare function serializeSimulatorSteps(steps: readonly SimulatorStep[]): string;

package/package.json

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

package/templates/CraftHealth.swift

@@ -106,6 +106,12 @@ final class CraftHealth {
                 if let sleepType = HKObjectType.categoryType(forIdentifier: .sleepAnalysis) {
                     readTypes.insert(sleepType)
                 }
+            case "dietaryEnergy", "dietaryProtein", "dietaryCarbohydrates", "dietaryFat":
+                // What a food log (MyFitnessPal, Lose It!, Cronometer...)
+                // writes to Apple Health: read only, never written back.
+                if let dietaryType = Self.healthQuantity(type)?.type {
+                    readTypes.insert(dietaryType)
+                }
             default:
                 break
             }
@@ -261,6 +267,11 @@ final class CraftHealth {
         case "restingHeartRate": return (HKQuantityType.quantityType(forIdentifier: .restingHeartRate), bpm, .discreteAverage)
         case "heartRateVariability": return (HKQuantityType.quantityType(forIdentifier: .heartRateVariabilitySDNN), .secondUnit(with: .milli), .discreteAverage)
         case "bodyMass": return (HKQuantityType.quantityType(forIdentifier: .bodyMass), .gramUnit(with: .kilo), .mostRecent)
+        // A day's food, summed over every meal any app logged: kcal and grams.
+        case "dietaryEnergy": return (HKQuantityType.quantityType(forIdentifier: .dietaryEnergyConsumed), .kilocalorie(), .cumulativeSum)
+        case "dietaryProtein": return (HKQuantityType.quantityType(forIdentifier: .dietaryProtein), .gram(), .cumulativeSum)
+        case "dietaryCarbohydrates": return (HKQuantityType.quantityType(forIdentifier: .dietaryCarbohydrates), .gram(), .cumulativeSum)
+        case "dietaryFat": return (HKQuantityType.quantityType(forIdentifier: .dietaryFatTotal), .gram(), .cumulativeSum)
         default: return nil
         }
     }

package/templates/CraftHybrid.swift

@@ -1457,6 +1457,19 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
         return popRecognizers(of: nav).contains { $0 === recognizer }
     }
 
+    private func nativeScreenContainsHorizontalScroll(_ screen: CraftNativeScreenController) -> Bool {
+        guard let root = screen.viewIfLoaded else { return false }
+        func visit(_ view: UIView) -> Bool {
+            if let scroll = view as? UIScrollView,
+               scroll.isScrollEnabled,
+               scroll.alwaysBounceHorizontal || scroll.contentSize.width > scroll.bounds.width + 1 {
+                return true
+            }
+            return view.subviews.contains(where: visit)
+        }
+        return visit(root)
+    }
+
     /// The edge swipe goes ahead of the web view's own gestures, which
     /// otherwise hold every touch over the page until the page has answered it.
     func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
@@ -1470,6 +1483,12 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
     func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
         guard let nav = visibleStack, isPopRecognizer(gestureRecognizer),
               nav.viewControllers.count > 1, nav.transitionCoordinator == nil else { return false }
+        if let native = nav.topViewController as? CraftNativeScreenController,
+           gestureRecognizer !== nav.interactivePopGestureRecognizer,
+           nativeScreenContainsHorizontalScroll(native) {
+            let moved = (gestureRecognizer as? UIPanGestureRecognizer)?.translation(in: nav.view).x ?? 0
+            if gestureRecognizer.location(in: nav.view).x - moved > 32 { return false }
+        }
         guard let slot = nav.topViewController as? CraftHybridWebSlot else { return true }
         // Over the page, only from its left edge: a swipe across the page is
         // the page's (a carousel, a slider).