craft-native 0.0.162 → 0.0.164

package/dist/api/mobile.d.ts

@@ -937,6 +937,142 @@ export declare const heartRate: {
     /** Bluetooth, scanning or the connection changed. */
     onState: (callback: (state: HeartRateState) => void) => (() => void);
 };
+/**
+ * Structured workouts scheduled onto the paired Apple Watch (iOS 17+, an app
+ * built with `enableScheduledWorkouts`): each appears in the watch's Workout
+ * app on its day, with its steps, goals and alerts. Plain JSON in SI units.
+ * In a browser, on Android and in a build without the capability
+ * `isSupported()` answers false and every other call rejects with
+ * `unsupported` (code `UNSUPPORTED`).
+ */
+export type ScheduledWorkoutsAuthorization = 'authorized' | 'denied' | 'notDetermined' | 'restricted' | 'unsupported';
+export type AppleWorkoutGoal = {
+    type: 'open';
+} | {
+    type: 'time';
+    seconds: number;
+} | {
+    type: 'distance';
+    meters: number;
+} | {
+    type: 'energy';
+    kilocalories: number;
+};
+export type AppleWorkoutAlert = 
+/** Beats per minute. */
+{
+    type: 'heartRate';
+    min: number;
+    max: number;
+} | {
+    type: 'heartRateZone';
+    zone: number;
+}
+/** Watts. */
+ | {
+    type: 'power';
+    min: number;
+    max: number;
+} | {
+    type: 'powerZone';
+    zone: number;
+}
+/** Metres per second (the current speed); a pace range is sent as speed. */
+ | {
+    type: 'speed';
+    min: number;
+    max: number;
+}
+/** Steps or revolutions per minute. */
+ | {
+    type: 'cadence';
+    min: number;
+    max: number;
+};
+export interface AppleWorkoutStep {
+    goal: AppleWorkoutGoal;
+    /** Dropped (the step kept) when WorkoutKit refuses it for the activity. */
+    alert?: AppleWorkoutAlert;
+    /** Shown on the watch from iOS 18; ignored on 17. At most 64 characters. */
+    displayName?: string;
+}
+export interface AppleIntervalBlock {
+    /** 1 or more. */
+    iterations: number;
+    steps: Array<{
+        purpose: 'work' | 'recovery';
+        step: AppleWorkoutStep;
+    }>;
+}
+export interface AppleCustomWorkout {
+    /** An HKWorkoutActivityType case name: 'running', 'cycling', 'swimming', 'traditionalStrengthTraining'... */
+    activity: string;
+    location: 'indoor' | 'outdoor' | 'unknown';
+    /** Swimming only: a pool swim is scheduled indoor, open water outdoor, when `location` is 'unknown'. */
+    swimmingLocation?: 'pool' | 'openWater';
+    /** Accepted for the record; WorkoutKit takes no pool length (the watch asks when the swim starts). */
+    poolLengthMeters?: number;
+    displayName: string;
+    warmup?: AppleWorkoutStep;
+    cooldown?: AppleWorkoutStep;
+    blocks: AppleIntervalBlock[];
+}
+export interface AppleWorkoutPlan {
+    /** A UUID; the plan's identity on the watch. */
+    id: string;
+    /** The local calendar day, 'YYYY-MM-DD'. */
+    date: string;
+    /** Local time of day, 07:00 when not given. */
+    hour?: number;
+    minute?: number;
+    workout: AppleCustomWorkout;
+}
+/** A plan on the watch's schedule. */
+export interface ScheduledWorkout {
+    /** Lowercase UUID. */
+    id: string;
+    date: string;
+    hour?: number;
+    minute?: number;
+    /** The person has done it. */
+    complete: boolean;
+}
+export interface ScheduleWorkoutResult {
+    id: string;
+    /** Alerts WorkoutKit refused and left out, each by where it was ("block 1 step 2: power alert..."). */
+    droppedAlerts?: string[];
+}
+export type ScheduledWorkoutsMethod = 'isSupported' | 'authorization' | 'requestAuthorization' | 'list' | 'schedule' | 'remove' | 'removeAll';
+/** The rejection every call but isSupported() gets where nothing can schedule. */
+export declare function scheduledWorkoutsUnsupported(): Error;
+/** A row of `list()`, or null for one that is not a scheduled plan. */
+export declare function normalizeScheduledWorkout(value: unknown): ScheduledWorkout | null;
+export declare const scheduledWorkouts: {
+    /** Whether this app build has the bridge at all (not whether this phone can schedule: `isSupported()`). */
+    isAvailable(): boolean;
+    /** Whether this app build answers `method`; an older build may lack one. */
+    supports(method: ScheduledWorkoutsMethod): boolean;
+    /** iOS 17 or later and WorkoutKit can schedule here; false everywhere else, never rejects. */
+    isSupported(): Promise<boolean>;
+    /** What the person allowed, without asking. */
+    authorization: () => Promise<ScheduledWorkoutsAuthorization>;
+    /** iOS's prompt the first time; its remembered answer after that. Call it from the person's tap. */
+    requestAuthorization: () => Promise<ScheduledWorkoutsAuthorization>;
+    /** Every plan on the watch's schedule. */
+    list: () => Promise<ScheduledWorkout[]>;
+    /**
+     * Put a plan on the watch's schedule (again on another day moves it).
+     * Rejects with a message naming what WorkoutKit refused: an activity or a
+     * goal it cannot schedule (an alert it refuses is dropped instead, listed in
+     * `droppedAlerts`), more plans than the watch holds (LIMIT_REACHED), or a
+     * schedule nothing kept, such as no paired watch (NOT_SCHEDULED).
+     */
+    schedule: (plan: AppleWorkoutPlan) => Promise<ScheduleWorkoutResult>;
+    /** Take a plan off every day it is scheduled; true when there was one. */
+    remove: (id: string) => Promise<boolean>;
+    /** Clear the schedule; how many plans it held. */
+    removeAll: () => Promise<number>;
+};
 export declare const deepLinks: {
     getInitialURL(): Promise<string | null>;
     /**
@@ -1239,12 +1375,14 @@ export declare const pushNotifications: {
     onReceive(callback: (data: Record<string, unknown>) => void): () => void;
 };
 export type HealthDataType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts' | 'restingHeartRate' | 'heartRateVariability' | 'bodyMass' | 'sleep'
-/** Food logged by any app, per day: kcal eaten, then grams of protein, carbohydrate and fat. Read only. */
+/** Food logged by any app, per day: kcal eaten, then grams of protein, carbohydrate and fat. */
  | 'dietaryEnergy' | 'dietaryProtein' | 'dietaryCarbohydrates' | 'dietaryFat'
 /** Mindful minutes (meditation, breathing): read with getMindfulSessions, written with saveMindfulSession. */
  | 'mindful';
 /** The types with one value per day. `sleep` is hours asleep, counted on the day you woke. */
 export type HealthDailyType = Exclude<HealthDataType, 'workouts' | 'mindful'>;
+/** Quantity types that can be written with `health.saveData()`. */
+export type HealthQuantityType = Exclude<HealthDataType, 'workouts' | 'sleep' | 'mindful'>;
 export interface HealthAuthorizationOptions {
     /** `false` asks to read only. Default: also allowed to save workouts. */
     write?: boolean;
@@ -1257,6 +1395,10 @@ export interface HealthDataResult {
     value: number;
     unit: string;
 }
+export interface HealthDataSaveResult {
+    /** HealthKit's UUID for the saved quantity sample. */
+    id: string;
+}
 export type HealthWorkoutType = 'running' | 'walking' | 'hiking' | 'cycling';
 export interface HealthWorkoutLocation {
     latitude: number;
@@ -1394,7 +1536,7 @@ export interface HealthMindfulSample {
     deviceName?: string;
 }
 /** The health reads and writes a host may or may not have, depending on the app build it runs in. */
-export type HealthReadMethod = 'getWorkouts' | 'getDailyStatistics' | 'getHeartRateSamples' | 'getSleepIntervals' | 'saveMindfulSession' | 'getMindfulSessions';
+export type HealthReadMethod = 'getWorkouts' | 'getDailyStatistics' | 'getHeartRateSamples' | 'getSleepIntervals' | 'saveData' | 'saveMindfulSession' | 'getMindfulSessions';
 export declare const health: {
     /**
      * Whether this app build answers `method`. An app installed before a read
@@ -1408,6 +1550,8 @@ export declare const health: {
      */
     requestAuthorization(types: HealthDataType[], options?: HealthAuthorizationOptions): Promise<boolean>;
     getData(type: HealthDataType, options?: HealthDataOptions): Promise<HealthDataResult>;
+    /** Save one quantity sample, such as a meal's dietary energy or macros. iOS only for now. */
+    saveData(type: HealthQuantityType, value: number, options?: HealthDataOptions): Promise<HealthDataSaveResult>;
     saveWorkout(workout: HealthWorkout): Promise<HealthWorkoutResult>;
     /** Workouts in Apple Health, newest first. iOS only for now. */
     getWorkouts(options?: HealthWorkoutQuery): Promise<HealthWorkoutSample[]>;
@@ -1474,6 +1618,7 @@ declare const mobile: {
     speech: typeof speech;
     music: typeof music;
     heartRate: typeof heartRate;
+    scheduledWorkouts: typeof scheduledWorkouts;
     deepLinks: typeof deepLinks;
     network: typeof network;
     appReview: typeof appReview;

package/dist/cli.js

@@ -3303,7 +3303,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.162";
+var version = "0.0.164";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];

package/dist/index.cjs

@@ -310,7 +310,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.162";
+var version = "0.0.164";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/index.js

@@ -58,7 +58,7 @@ function craftBinaryNotFoundMessage(triedPath) {
 `);
 }
 // package.json
-var version = "0.0.162";
+var version = "0.0.164";
 
 // src/sdk-version.ts
 var SDK_VERSION = version;

package/dist/ios/src/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/ios/src/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/dist/ios/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/dist/ios/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/dist/ios/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) {