@craft-native/ios 0.0.162 → 0.0.164

package/README.md

@@ -144,6 +144,13 @@ 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
+`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
+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.
 
 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.
@@ -186,6 +193,7 @@ Edit `craft.config.json` in your iOS project:
   "enableAppleMusic": false,
   "enableHeartRate": false,
   "enableBackgroundAudio": false,
+  "enableScheduledWorkouts": false,
   "enableScreenCapture": true,
   "iosVersion": "15.0",
   "teamId": ""
@@ -399,6 +407,10 @@ const workouts = await health.getWorkouts({ startDate: Date.now() - 30 * 8640000
 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 })
+// Food logs can write a quantity too; request write access first. The result
+// contains HealthKit's sample id, and the date range defaults to this instant.
+await health.requestAuthorization(['dietaryEnergy', 'dietaryProtein'], { write: true })
+const sample = await health.saveData('dietaryProtein', 28, { startDate: mealStart, endDate: mealEnd })
 // 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.
@@ -609,6 +621,47 @@ const { samples } = await window.craft.heartRate.stopRecording(); // [{ timestam
 // <bundle id> CraftFakeHeartRateMonitor -bool YES` stands in a strap ("Simulated
 // HRM") whose readings are encoded and decoded as 0x2A37 payloads. Simulator builds only.
 
+// Apple Watch workouts (enableScheduledWorkouts, iOS 17+): WorkoutKit's
+// WorkoutScheduler puts a structured workout in the paired watch's Workout
+// app on its day. Only an app with the flag compiles in and links WorkoutKit
+// (the CRAFT_SCHEDULED_WORKOUTS build condition); below iOS 17 it is weak-linked
+// and isSupported() answers false. A plan is plain JSON in SI units.
+if (await window.craft.scheduledWorkouts.isSupported()) {
+  await window.craft.scheduledWorkouts.requestAuthorization(); // iOS's prompt once; waits on the person
+  await window.craft.scheduledWorkouts.schedule({
+    id: '6f1c2b8e-5a7d-4c3e-9b1a-2d4e6f8a0b1c', // a UUID: WorkoutPlan's id
+    date: '2026-10-20', hour: 6, minute: 30,    // local; 07:00 without a time
+    workout: {
+      activity: 'running',                      // an HKWorkoutActivityType case name
+      location: 'outdoor',                      // indoor | outdoor | unknown
+      displayName: '4 x 1 km',
+      warmup: { goal: { type: 'time', seconds: 600 } },
+      blocks: [{ iterations: 4, steps: [
+        { purpose: 'work', step: { goal: { type: 'distance', meters: 1000 },
+          alert: { type: 'speed', min: 4.1, max: 4.4 }, displayName: '1 km hard' } }, // step names: iOS 18
+        { purpose: 'recovery', step: { goal: { type: 'time', seconds: 120 } } },
+      ] }],
+      cooldown: { goal: { type: 'open' } },
+    },
+  }); // { id, droppedAlerts? }
+  await window.craft.scheduledWorkouts.list();      // [{ id, date, hour, minute, complete }], ids lowercase
+  await window.craft.scheduledWorkouts.remove(id);  // every day it is on; true when there was one
+  await window.craft.scheduledWorkouts.removeAll(); // how many there were
+}
+// Goals: open, time (seconds), distance (meters), energy (kilocalories).
+// Alerts: heartRate / power / speed (m/s) / cadence { min, max }, heartRateZone /
+// powerZone { zone }. An activity or goal WorkoutKit refuses rejects, naming it
+// (UNSUPPORTED_GOAL, INVALID_ARGUMENT); a refused alert is dropped and named in
+// droppedAlerts. LIMIT_REACHED past WorkoutScheduler.maxAllowedScheduledWorkoutCount;
+// NOT_SCHEDULED when nothing kept the plan (no paired watch); NOT_AUTHORIZED
+// before access. Swimming: CustomWorkout has no swimming location or pool
+// length, so with location 'unknown' a 'pool' swim is indoor, 'openWater' outdoor.
+// Native screens call the same service as the ScheduledWorkouts module
+// (capability `scheduledWorkouts`); or use `scheduledWorkouts` from 'craft-native/mobile'.
+// A simulator never has a watch: `simctl spawn <device> defaults write <bundle id>
+// CraftFakeWorkoutScheduler -bool YES` keeps plans in the app instead (WorkoutKit
+// still builds and checks them). Simulator builds only.
+
 // Files on a native screen (capability `files`, always there): a photo from
 // the library (PHPickerViewController, no permission asked) or the camera
 // (`source: 'camera'`, capability `camera`, needs enableCamera), saved as an

package/dist/cli.js

@@ -220,6 +220,7 @@ var DEFAULT_CONFIG = {
   enableMLKit: false,
   enableAppleMusic: false,
   enableHeartRate: false,
+  enableScheduledWorkouts: false,
   iosVersion: "16.0",
   watchosVersion: "9.0",
   teamId: "",
@@ -454,6 +455,14 @@ function renderRuntimeSettings() {
   ].join(`
 `);
 }
+function renderFeatureSettings(config) {
+  const conditions = [];
+  if (config.enableScheduledWorkouts)
+    conditions.push("CRAFT_SCHEDULED_WORKOUTS");
+  if (!conditions.length)
+    return "";
+  return `      SWIFT_ACTIVE_COMPILATION_CONDITIONS: "$(inherited) ${conditions.join(" ")}"`;
+}
 function renderPrivacyManifest(config) {
   const privacy = config.privacy ?? {};
   const collected = privacy.collectedDataTypes ?? [];
@@ -811,6 +820,7 @@ function writeShell(output, config) {
   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"));
@@ -932,7 +942,7 @@ async function init(options) {
   } else {
     rmSync(join2(output, "Runtime"), { recursive: true, force: true });
   }
-  const projectYml = projectYmlTemplate.replace(/\{\{CRAFT_RUNTIME_SETTINGS\}\}/g, hasRuntime ? renderRuntimeSettings() : "").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(/\{\{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

@@ -88,6 +88,17 @@ export interface CraftConfig {
      * playback session).
      */
     enableBackgroundAudio?: boolean;
+    /**
+     * Schedule structured workouts onto the paired Apple Watch through
+     * `craft.scheduledWorkouts` (WorkoutKit's WorkoutScheduler, iOS 17+): each
+     * appears in the watch's Workout app on its day, with its steps, goals and
+     * alerts. Compiles CraftScheduledWorkouts.swift with the
+     * `CRAFT_SCHEDULED_WORKOUTS` condition, so an app without it never links
+     * WorkoutKit; below iOS 17 it is weak-linked and answers unsupported. iOS
+     * asks the person the first time the page calls
+     * `craft.scheduledWorkouts.requestAuthorization()`, never at launch.
+     */
+    enableScheduledWorkouts?: boolean;
     /**
      * Purpose strings in the app's own words, by Info.plist key
      * (`{ NSAppleMusicUsageDescription: 'Shows the song playing during a workout.' }`).
@@ -381,6 +392,13 @@ export declare function renderWatchEntitlements(config: CraftConfig): string;
  * reach everything the bridge actually uses.
  */
 export declare function renderRuntimeSettings(): string;
+/**
+ * Build settings a feature adds to the app target. WorkoutKit is compiled in
+ * only for `enableScheduledWorkouts`: CraftScheduledWorkouts.swift imports it
+ * behind the `CRAFT_SCHEDULED_WORKOUTS` condition, so an app that does not
+ * schedule workouts does not link it. `$(inherited)` keeps Debug's `DEBUG`.
+ */
+export declare function renderFeatureSettings(config: Pick<CraftConfig, 'enableScheduledWorkouts'>): string;
 export declare function renderPrivacyManifest(config: CraftConfig): string;
 /**
  * Whether a PNG carries an alpha channel, from its header: colour type 4

package/dist/index.js

@@ -349,6 +349,7 @@ var DEFAULT_CONFIG = {
   enableMLKit: false,
   enableAppleMusic: false,
   enableHeartRate: false,
+  enableScheduledWorkouts: false,
   iosVersion: "16.0",
   watchosVersion: "9.0",
   teamId: "",
@@ -583,6 +584,14 @@ function renderRuntimeSettings() {
   ].join(`
 `);
 }
+function renderFeatureSettings(config) {
+  const conditions = [];
+  if (config.enableScheduledWorkouts)
+    conditions.push("CRAFT_SCHEDULED_WORKOUTS");
+  if (!conditions.length)
+    return "";
+  return `      SWIFT_ACTIVE_COMPILATION_CONDITIONS: "$(inherited) ${conditions.join(" ")}"`;
+}
 function renderPrivacyManifest(config) {
   const privacy = config.privacy ?? {};
   const collected = privacy.collectedDataTypes ?? [];
@@ -944,6 +953,7 @@ function writeShell(output, config) {
   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"));
@@ -1065,7 +1075,7 @@ async function init(options) {
   } else {
     rmSync2(join2(output, "Runtime"), { recursive: true, force: true });
   }
-  const projectYml = projectYmlTemplate.replace(/\{\{CRAFT_RUNTIME_SETTINGS\}\}/g, hasRuntime ? renderRuntimeSettings() : "").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(/\{\{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(`
 `));
@@ -1298,6 +1308,7 @@ export {
   renderOrientations,
   renderOfflinePage,
   renderLaunchScreen,
+  renderFeatureSettings,
   renderEntitlements,
   renderDeviceFamilies,
   renderBackgroundTaskIdentifiers,

package/package.json

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

package/templates/CraftApp.swift

@@ -738,6 +738,18 @@ final class CraftChrome: ObservableObject {
         emit("craftTabSelect", ["id": tab.id])
     }
 
+    /// A completed horizontal swipe selects the adjacent tab. The shell owns
+    /// this path so it works over both native screens and the shared WebView.
+    /// The gesture recognizer yields before calling this for a screen-owned
+    /// horizontal scroll or custom pager.
+    func swipe(to id: String) {
+        guard id != selected, tabs.contains(where: { $0.id == id }) else { return }
+        withAnimation(Self.motion(.spring(response: 0.32, dampingFraction: 0.86))) { selected = id }
+        UISelectionFeedbackGenerator().selectionChanged()
+        guard CraftHybrid.shared.tabTapped(id, reselect: false) else { return }
+        emit("craftTabSelect", ["id": id])
+    }
+
     /// The animation, or none with Reduce Motion on: the selection jumps to
     /// its tab rather than springing there, as UIKit's own controls do.
     static func motion(_ animation: Animation) -> Animation? {
@@ -1212,6 +1224,9 @@ struct CraftConfig: Codable {
     /// A Bluetooth heart-rate strap (or a watch broadcasting its heart rate)
     /// through `craft.heartRate` (CraftHeartRate.swift).
     var enableHeartRate: Bool = false
+    /// Structured workouts scheduled onto the paired Apple Watch through
+    /// `craft.scheduledWorkouts` (CraftScheduledWorkouts.swift, WorkoutKit).
+    var enableScheduledWorkouts: Bool = false
     var devServerURL: String? = nil
     var trustedOrigins: [String] = []
     /// The longest the launch splash stays up when the page neither says it is
@@ -2335,6 +2350,22 @@ struct CraftWebView: UIViewRepresentable {
                         }
                     }
                 }
+            // MARK: - Scheduled workouts (CraftScheduledWorkouts.swift)
+            // Gated on enableScheduledWorkouts. One action for every method,
+            // as a native screen's ScheduledWorkouts module calls them;
+            // asking to schedule has its own, which waits on the person.
+            case "scheduledWorkouts", "scheduledWorkoutsRequestAuthorization":
+                if !config.enableScheduledWorkouts {
+                    rejectCallback(callbackId, error: "Scheduled workouts are disabled", code: "CAPABILITY_DISABLED")
+                } else {
+                    let method = action == "scheduledWorkouts" ? body["method"] as? String ?? "" : "requestAuthorization"
+                    CraftScheduledWorkouts.shared.perform(method: method, args: [body["options"] as? [String: Any] ?? [:]]) { [weak self] result in
+                        switch result {
+                        case .success(let value): self?.resolveCallback(callbackId, result: value)
+                        case .failure(let failure): self?.rejectCallback(callbackId, error: failure.message, code: failure.code)
+                        }
+                    }
+                }
             // MARK: - Orientation Lock
             case "lockOrientation":
                 if config.enableOrientationLock {
@@ -2495,6 +2526,21 @@ struct CraftWebView: UIViewRepresentable {
                 } else {
                     rejectCallback(callbackId, error: "HealthKit is disabled", code: "CAPABILITY_DISABLED")
                 }
+            case "saveHealthData":
+                if config.enableHealthKit {
+                    guard let dataType = body["type"] as? String,
+                          let value = (body["value"] as? NSNumber)?.doubleValue else {
+                        rejectCallback(callbackId, error: "saveHealthData was called without a type and numeric value", code: "INVALID_ARGUMENT")
+                        break
+                    }
+                    CraftHealth.shared.saveData(
+                        type: dataType,
+                        value: value,
+                        options: body
+                    ) { [weak self] in self?.answer(callbackId, $0) }
+                } else {
+                    rejectCallback(callbackId, error: "HealthKit is disabled", code: "CAPABILITY_DISABLED")
+                }
             case "saveHealthWorkout":
                 if config.enableHealthKit {
                     saveHealthWorkout(body: body, callbackId: callbackId)
@@ -3337,6 +3383,7 @@ struct CraftWebView: UIViewRepresentable {
                     brightness: true,
                     music: \(config.enableAppleMusic),
                     heartRate: \(config.enableHeartRate),
+                    scheduledWorkouts: \(config.enableScheduledWorkouts),
                     speech: true,
                     network: true,
                     deviceInfo: true,
@@ -4877,6 +4924,7 @@ struct CraftWebView: UIViewRepresentable {
                     requestHealthAuthorization: true,
                     musicRequestAuthorization: true,
                     heartRateRequestAuthorization: true,
+                    scheduledWorkoutsRequestAuthorization: true,
                     requestPermission: true,
                     signInWithApple: true,
                     dialogAlert: true,
@@ -5056,6 +5104,10 @@ struct CraftWebView: UIViewRepresentable {
                         options = options || {};
                         return craft._invoke('getHealthData', {type: type, startDate: options.startDate, endDate: options.endDate});
                     },
+                    saveData: function(type, value, options) {
+                        options = options || {};
+                        return craft._invoke('saveHealthData', {type: type, value: value, startDate: options.startDate, endDate: options.endDate});
+                    },
                     saveWorkout: function(workout) { return craft._invoke('saveHealthWorkout', workout || {}); },
                     getWorkouts: function(options) {
                         options = options || {};
@@ -5123,6 +5175,22 @@ struct CraftWebView: UIViewRepresentable {
                         readRecording: function(options) { return heartRate('readRecording', {since: options && typeof options.since === 'number' ? options.since : null}); }
                     };
                 })();
+                // Structured workouts on the paired Apple Watch (WorkoutKit,
+                // iOS 17+): each appears in its Workout app on its day.
+                // schedule(plan) answers {id} or rejects naming what WorkoutKit
+                // refused; list() answers [{id, date, hour, minute, complete}].
+                (function() {
+                    function scheduled(method, options) { return craft._invoke('scheduledWorkouts', {method: method, options: options || {}}); }
+                    craft.scheduledWorkouts = {
+                        isSupported: function() { return scheduled('isSupported'); },
+                        authorization: function() { return scheduled('authorization'); },
+                        requestAuthorization: function() { return craft._invoke('scheduledWorkoutsRequestAuthorization'); },
+                        list: function() { return scheduled('list'); },
+                        schedule: function(plan) { return scheduled('schedule', plan); },
+                        remove: function(id) { return scheduled('remove', {id: typeof id === 'string' ? id : id && id.id}); },
+                        removeAll: function() { return scheduled('removeAll'); }
+                    };
+                })();
                 craft.liveActivity = {
                     start: function(options) { return craft._invoke('startLiveActivity', options || {}); },
                     update: function(idOrState, state) {

package/templates/CraftHealth.swift

@@ -32,6 +32,13 @@ final class CraftHealth {
         case "getData":
             guard let type = args.first as? String else { return completion(.failure(CraftHealthError(message: "getData needs a type", code: "INVALID_ARGUMENT"))) }
             getData(type: type, startDate: options(1)["startDate"] as? Double, endDate: options(1)["endDate"] as? Double, completion: completion)
+        case "saveData":
+            guard let type = args.first as? String,
+                  args.count > 1,
+                  let value = (args[1] as? NSNumber)?.doubleValue else {
+                return completion(.failure(CraftHealthError(message: "saveData needs a type and numeric value", code: "INVALID_ARGUMENT")))
+            }
+            saveData(type: type, value: value, options: options(2), completion: completion)
         case "saveWorkout":
             saveWorkout(body: options(0), completion: completion)
         case "getWorkouts":
@@ -120,12 +127,15 @@ final class CraftHealth {
                 }
             case "dietaryEnergy", "dietaryProtein", "dietaryCarbohydrates", "dietaryFat":
                 // What a food log (MyFitnessPal, Lose It!, Cronometer...)
-                // writes to Apple Health: read only, never written back.
+                // writes to Apple Health. Request the write grant too unless
+                // the caller explicitly asked for a read-only authorization.
                 if let dietaryType = Self.healthQuantity(type)?.type {
                     readTypes.insert(dietaryType)
+                    if !readOnly { shareTypes.insert(dietaryType) }
                 }
             default:
-                break
+                completion(.failure(CraftHealthError(message: "Unknown health data type: \(type)", code: "INVALID_ARGUMENT")))
+                return
             }
         }
 
@@ -179,6 +189,42 @@ final class CraftHealth {
         healthStore.execute(query)
     }
 
+    /// Save one quantity sample, primarily a food-log entry. Dates are epoch
+    /// milliseconds; an omitted range records an instantaneous sample now.
+    func saveData(type: String, value: Double, options: [String: Any], completion: @escaping Completion) {
+        guard let healthStore = healthStore else {
+            completion(.failure(CraftHealthError(message: "HealthKit not available")))
+            return
+        }
+        guard value.isFinite, value >= 0 else {
+            completion(.failure(CraftHealthError(message: "saveData needs a finite, non-negative value", code: "INVALID_ARGUMENT")))
+            return
+        }
+        guard let spec = Self.healthQuantity(type), let qType = spec.type else {
+            completion(.failure(CraftHealthError(message: "Unknown health data type: \(type)", code: "INVALID_ARGUMENT")))
+            return
+        }
+        let startValue = options["startDate"] as? Double ?? Date().timeIntervalSince1970 * 1000
+        let endValue = options["endDate"] as? Double ?? startValue
+        guard startValue.isFinite, endValue.isFinite, endValue >= startValue else {
+            completion(.failure(CraftHealthError(message: "saveData needs a valid date range", code: "INVALID_ARGUMENT")))
+            return
+        }
+        let sample = HKQuantitySample(
+            type: qType,
+            quantity: HKQuantity(unit: spec.unit, doubleValue: value),
+            start: Date(timeIntervalSince1970: startValue / 1000),
+            end: Date(timeIntervalSince1970: endValue / 1000)
+        )
+        healthStore.save(sample) { success, error in
+            if success {
+                completion(.success(["id": sample.uuid.uuidString]))
+            } else {
+                completion(.failure(CraftHealthError(message: error?.localizedDescription ?? "Health data could not be saved")))
+            }
+        }
+    }
+
     func saveWorkout(body: [String: Any], completion: @escaping Completion) {
         guard let healthStore = healthStore else {
             completion(.failure(CraftHealthError(message: "HealthKit not available")))

package/templates/CraftHybrid.swift

@@ -1004,6 +1004,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
     private var openingWeb = false
     private var firstFrameLogged = false
     private var tabBarHeight: CGFloat = 0
+    private var tabSwipeRecognizers: [UISwipeGestureRecognizer] = []
 
     init(config: CraftConfig) {
         self.config = config
@@ -1033,6 +1034,7 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
         let tabs = hybrid.tabIds
         let start = CraftHybridRoutes.tab(owning: hybrid.startPath, among: tabs) ?? tabs.first ?? ""
         show(tab: start, rootPath: hybrid.startPath)
+        installTabSwipeGestures()
         if hybrid.hasWeb && hybrid.startsNative {
             DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { [weak self] in self?.attachWeb() }
         }
@@ -1043,6 +1045,42 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
 
     private var webAttached = false
 
+    private func installTabSwipeGestures() {
+        guard tabSwipeRecognizers.isEmpty else { return }
+        for direction in [UISwipeGestureRecognizer.Direction.left, .right] {
+            let recognizer = UISwipeGestureRecognizer(target: self, action: #selector(tabSwipeRecognized(_:)))
+            recognizer.direction = direction
+            recognizer.delegate = self
+            recognizer.cancelsTouchesInView = false
+            recognizer.delaysTouchesBegan = false
+            view.addGestureRecognizer(recognizer)
+            tabSwipeRecognizers.append(recognizer)
+        }
+    }
+
+    @objc private func tabSwipeRecognized(_ recognizer: UISwipeGestureRecognizer) {
+        let tabs = hybrid.tabIds
+        guard let index = tabs.firstIndex(of: currentTab), tabs.count > 1 else { return }
+        let next = recognizer.direction == .left ? index + 1 : index - 1
+        guard tabs.indices.contains(next) else { return }
+        CraftChrome.shared.swipe(to: tabs[next])
+    }
+
+    private func horizontalScrollAt(_ point: CGPoint, in root: UIView) -> Bool {
+        let local = root.convert(point, from: view)
+        guard root.bounds.contains(local), let hit = root.hitTest(local, with: nil) else { return false }
+        var candidate: UIView? = hit
+        while let current = candidate {
+            if let scroll = current as? UIScrollView,
+               scroll.isScrollEnabled,
+               scroll.alwaysBounceHorizontal || scroll.contentSize.width > scroll.bounds.width + 1 {
+                return true
+            }
+            candidate = current.superview
+        }
+        return false
+    }
+
     /// The web view joins the screen, behind the native screens, and loads.
     private func attachWeb() {
         guard let webHost, !webAttached else { return }
@@ -1481,8 +1519,19 @@ final class CraftHybridController: UIViewController, UINavigationControllerDeleg
     }
 
     func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
+        if tabSwipeRecognizers.contains(where: { $0 === gestureRecognizer }) {
+            guard hybrid.tabIds.count > 1, let top = visibleStack?.topViewController else { return false }
+            if let native = top as? CraftNativeScreenController,
+               !native.tabSwipeEnabled || !native.contentSwipeBack { return false }
+            return !horizontalScrollAt(gestureRecognizer.location(in: view), in: top.view)
+        }
         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,
+           !native.contentSwipeBack {
+            return false
+        }
         if let native = nav.topViewController as? CraftNativeScreenController,
            gestureRecognizer !== nav.interactivePopGestureRecognizer,
            nativeScreenContainsHorizontalScroll(native) {