@craft-native/ios 0.0.134 → 0.0.135

package/README.md

@@ -505,6 +505,13 @@ await window.craft.restorePurchases();
 window.craft.setKeepAwake(true);  // Prevent screen dimming
 window.craft.setKeepAwake(false); // Allow screen dimming
 
+// Screen brightness, 0 to 1: always available (no config flag). It is the
+// device's backlight, so put it back: `brightness` from 'craft-native/mobile'
+// remembers the person's level, restores it, and releases it while the app is
+// in the background.
+const level = await window.craft.getBrightness();   // 0.62
+await window.craft.setBrightness(0.1);              // resolves with what the screen reports
+
 // Speech: short spoken cues that duck the person's music instead of stopping
 // it, and play with the silent switch on. Always available (no config flag).
 // Resolves when the utterance ends: true if spoken, false if stopped or

package/package.json

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

package/templates/CraftApp.swift

@@ -2140,6 +2140,15 @@ struct CraftWebView: UIViewRepresentable {
                 } else {
                     rejectCallback(callbackId, error: "Keep awake is disabled", code: "CAPABILITY_DISABLED")
                 }
+            // MARK: - Screen Brightness
+            case "getBrightness":
+                getBrightness(callbackId: callbackId)
+            case "setBrightness":
+                if let level = (body["level"] as? NSNumber)?.doubleValue, level.isFinite {
+                    setBrightness(level, callbackId: callbackId)
+                } else {
+                    rejectCallback(callbackId, error: "setBrightness was called without the values it needs", code: "INVALID_ARGUMENT")
+                }
             // MARK: - Orientation Lock
             case "lockOrientation":
                 if config.enableOrientationLock {
@@ -3102,6 +3111,7 @@ struct CraftWebView: UIViewRepresentable {
                     orientationLock: \(config.enableOrientationLock),
                     deepLinks: \(config.enableDeepLinks),
                     flashlight: true,
+                    brightness: true,
                     speech: true,
                     network: true,
                     deviceInfo: true,
@@ -4041,6 +4051,25 @@ struct CraftWebView: UIViewRepresentable {
                     });
                 },
 
+                // Screen brightness, 0 to 1. Each resolves with the level the
+                // screen then reports.
+                getBrightness: function() {
+                    var self = this;
+                    var id = 'cb_' + (++this._callbackId);
+                    window.webkit.messageHandlers.craft.postMessage({action: 'getBrightness', callbackId: id});
+                    return new Promise(function(resolve, reject) {
+                        self._callbacks[id] = {resolve: resolve, reject: reject};
+                    });
+                },
+                setBrightness: function(level) {
+                    var self = this;
+                    var id = 'cb_' + (++this._callbackId);
+                    window.webkit.messageHandlers.craft.postMessage({action: 'setBrightness', level: level, callbackId: id});
+                    return new Promise(function(resolve, reject) {
+                        self._callbacks[id] = {resolve: resolve, reject: reject};
+                    });
+                },
+
                 // Speech synthesis. speak() settles when the utterance ends:
                 // true when it was spoken, false when something stopped it.
                 // No timeout, because a long sentence at a slow rate can
@@ -6236,6 +6265,25 @@ struct CraftWebView: UIViewRepresentable {
             }
         }
 
+        // MARK: - Screen Brightness
+        //
+        // The device's backlight, 0 to 1. It is system-wide, not the app's:
+        // a page that dims it reads it first and puts it back - when it is
+        // done, and when the app leaves the foreground (@stacksjs/mobile's
+        // screen API does both off the page's visibility).
+        private func getBrightness(callbackId: String?) {
+            DispatchQueue.main.async {
+                self.resolveCallback(callbackId, result: Double(UIScreen.main.brightness))
+            }
+        }
+
+        private func setBrightness(_ level: Double, callbackId: String?) {
+            DispatchQueue.main.async {
+                UIScreen.main.brightness = CGFloat(min(max(level, 0), 1))
+                self.resolveCallback(callbackId, result: Double(UIScreen.main.brightness))
+            }
+        }
+
         // MARK: - Speech Synthesis
         //
         // Native rather than the page's own `speechSynthesis`, which in a