@swiftbrowser/native 0.18.0 → 0.18.2

package/dist/speech.js

@@ -0,0 +1,243 @@
+/**
+ * The Web Speech API over the host: `speechSynthesis` and
+ * `SpeechSynthesisUtterance` on `AVSpeechSynthesizer` (the bridge's
+ * `speak(id, json)` and `speechControl(action)`, events at
+ * `__sbSpeechEvent(id, json)`), and `SpeechRecognition` on
+ * `SFSpeechRecognizer` (`recognize(id, action, json)`, events at
+ * `__sbRecognition(id, json)`; the app's Info.plist names
+ * `NSSpeechRecognitionUsageDescription` and `NSMicrophoneUsageDescription`).
+ * The shapes apps use: an utterance's `text`, `lang`, `rate`, `pitch`,
+ * `volume` and its `start`, `end`, `error`, `pause`, `resume` and `boundary`
+ * events; a recognition's `lang`, `continuous`, `interimResults`, `start()`,
+ * `stop()`, `abort()` and its `start`, `result` (with `results[i][0].transcript`
+ * and `isFinal`), `error` (`error`: `not-allowed`, `audio-capture`,
+ * `no-speech`, `network`, `aborted`) and `end` events.
+ */
+/** Handlers and listeners by event type, as the DOM's targets have them. */
+class Target {
+    handlers;
+    listeners = new Map();
+    constructor(handlers) {
+        this.handlers = handlers;
+    }
+    add(type, listener) {
+        if (typeof listener !== 'function')
+            return;
+        this.listeners.set(type, (this.listeners.get(type) ?? new Set()).add(listener));
+    }
+    remove(type, listener) {
+        this.listeners.get(type)?.delete(listener);
+    }
+    fire(event) {
+        const handler = this.handlers[`on${event.type}`];
+        if (typeof handler === 'function')
+            handler(event);
+        for (const listener of [...(this.listeners.get(event.type) ?? [])])
+            listener(event);
+    }
+}
+export class SpeechSynthesisUtterance {
+    text;
+    lang = '';
+    voice = null;
+    volume = 1;
+    rate = 1;
+    pitch = 1;
+    onstart = null;
+    onend = null;
+    onerror = null;
+    onpause = null;
+    onresume = null;
+    onboundary = null;
+    onmark = null;
+    /** @internal */
+    target = new Target(this);
+    constructor(text = '') {
+        this.text = String(text);
+    }
+    addEventListener(type, listener) {
+        this.target.add(type, listener);
+    }
+    removeEventListener(type, listener) {
+        this.target.remove(type, listener);
+    }
+}
+export function createSpeechSynthesis(native) {
+    /** The utterances handed to the host, by id, in order: the first is speaking once it started. */
+    const queue = new Map();
+    let nextId = 1;
+    let speakingId = null;
+    let paused = false;
+    const started = new Map();
+    const event = (type, utterance, id, extra = {}) => ({
+        type,
+        utterance,
+        charIndex: 0,
+        charLength: 0,
+        elapsedTime: (native.now() - (started.get(id) ?? native.now())) / 1000,
+        name: '',
+        ...extra,
+    });
+    const synthesis = {
+        get speaking() {
+            return speakingId !== null;
+        },
+        get pending() {
+            return queue.size > (speakingId === null ? 0 : 1);
+        },
+        get paused() {
+            return paused;
+        },
+        onvoiceschanged: null,
+        speak(utterance) {
+            if (!(utterance instanceof SpeechSynthesisUtterance))
+                throw new TypeError('speechSynthesis.speak: not a SpeechSynthesisUtterance');
+            const id = nextId++;
+            queue.set(id, utterance);
+            native.speak(id, JSON.stringify({ text: utterance.text, lang: utterance.lang || null, voice: utterance.voice?.name ?? null, rate: utterance.rate, pitch: utterance.pitch, volume: utterance.volume }));
+        },
+        cancel() {
+            native.speechControl('cancel');
+            // The host answers each with `cancel`; the queue empties as they come.
+        },
+        pause() {
+            native.speechControl('pause');
+        },
+        resume() {
+            native.speechControl('resume');
+        },
+        getVoices() {
+            return [];
+        },
+        addEventListener() { },
+        removeEventListener() { },
+    };
+    return {
+        speechSynthesis: synthesis,
+        receive(id, json) {
+            const utterance = queue.get(id);
+            if (!utterance)
+                return;
+            const e = JSON.parse(json);
+            switch (e.type) {
+                case 'start':
+                    speakingId = id;
+                    paused = false;
+                    started.set(id, native.now());
+                    utterance.target.fire(event('start', utterance, id));
+                    break;
+                case 'boundary':
+                    utterance.target.fire(event('boundary', utterance, id, { name: 'word', charIndex: e.charIndex ?? 0, charLength: e.charLength ?? 0 }));
+                    break;
+                case 'pause':
+                    paused = true;
+                    utterance.target.fire(event('pause', utterance, id, { charIndex: e.charIndex ?? 0 }));
+                    break;
+                case 'resume':
+                    paused = false;
+                    utterance.target.fire(event('resume', utterance, id, { charIndex: e.charIndex ?? 0 }));
+                    break;
+                case 'end':
+                case 'cancel':
+                case 'error': {
+                    queue.delete(id);
+                    if (speakingId === id)
+                        speakingId = null;
+                    if (queue.size === 0)
+                        paused = false;
+                    const done = e.type === 'end' ? event('end', utterance, id) : event('error', utterance, id, { error: e.type === 'cancel' ? 'canceled' : (e.message ?? 'synthesis-failed') });
+                    started.delete(id);
+                    utterance.target.fire(done);
+                    break;
+                }
+            }
+        },
+    };
+}
+const recognitions = new Map();
+let recognitionBridge = null;
+let nextRecognition = 1;
+export class SpeechRecognition {
+    lang = '';
+    continuous = false;
+    interimResults = false;
+    maxAlternatives = 1;
+    onstart = null;
+    onaudiostart = null;
+    onresult = null;
+    onerror = null;
+    onend = null;
+    onaudioend = null;
+    onnomatch = null;
+    target = new Target(this);
+    id = null;
+    /** The final results so far in this session, then the interim one (if any) last. */
+    results = [];
+    static install(bridge) {
+        recognitionBridge = bridge;
+    }
+    start() {
+        if (!recognitionBridge)
+            throw new Error('SpeechRecognition: no host');
+        if (this.id !== null)
+            throw Object.assign(new Error('SpeechRecognition: already started'), { name: 'InvalidStateError' });
+        this.id = nextRecognition++;
+        this.results = [];
+        recognitions.set(this.id, this);
+        recognitionBridge.recognize(this.id, 'start', JSON.stringify({ lang: this.lang || null, continuous: this.continuous, interimResults: this.interimResults }));
+    }
+    /** Stops listening; what was heard is still delivered, then `end`. */
+    stop() {
+        if (this.id === null)
+            return;
+        recognitionBridge?.recognize(this.id, 'stop', '{}');
+    }
+    /** Stops listening and keeps nothing more. */
+    abort() {
+        if (this.id === null)
+            return;
+        recognitionBridge?.recognize(this.id, 'abort', '{}');
+    }
+    addEventListener(type, listener) {
+        this.target.add(type, listener);
+    }
+    removeEventListener(type, listener) {
+        this.target.remove(type, listener);
+    }
+    /** `__sbRecognition(id, json)`. */
+    static receive(id, json) {
+        recognitions.get(id)?.handle(JSON.parse(json));
+    }
+    event(type, extra = {}) {
+        return { type, resultIndex: 0, results: this.results, ...extra };
+    }
+    handle(e) {
+        switch (e.type) {
+            case 'start':
+                this.target.fire(this.event('start'));
+                this.target.fire(this.event('audiostart'));
+                break;
+            case 'result': {
+                const alternative = { transcript: e.transcript ?? '', confidence: e.confidence ?? 0 };
+                const result = { isFinal: e.isFinal === true, length: 1, 0: alternative, item: () => alternative };
+                // An interim result replaces the last interim one; a final one takes its place for good.
+                const last = this.results[this.results.length - 1];
+                const index = last && !last.isFinal ? this.results.length - 1 : this.results.length;
+                this.results = [...this.results.slice(0, index), result];
+                this.target.fire(this.event('result', { resultIndex: index }));
+                break;
+            }
+            case 'error':
+                this.target.fire(this.event('error', { error: e.error ?? 'aborted', message: e.message ?? '' }));
+                break;
+            case 'end':
+                if (this.id !== null)
+                    recognitions.delete(this.id);
+                this.id = null;
+                this.target.fire(this.event('audioend'));
+                this.target.fire(this.event('end'));
+                break;
+        }
+    }
+}
+//# sourceMappingURL=speech.js.map

package/dist/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../src/speech.ts"],"names":[],"mappings":"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"}

package/dist/wakeLock.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `navigator.wakeLock` (the Screen Wake Lock API) over the host's idle timer
+ * (`wakeLock(active)` on the bridge: `UIApplication.isIdleTimerDisabled`, a
+ * power assertion on macOS). `request('screen')` resolves with a
+ * `WakeLockSentinel`; the screen stays awake while any sentinel is held and
+ * `release()` lets it go. Unlike a page's, which the browser releases when
+ * the document hides, a native sentinel stays held in the background: the
+ * system owns the screen there, and the lock holds again when the app returns.
+ */
+import type { NativeBridge } from './bridge';
+type ReleaseListener = (event: {
+    type: 'release';
+    target: WakeLockSentinel;
+}) => void;
+export declare class WakeLockSentinel {
+    private readonly onRelease;
+    readonly type: "screen";
+    released: boolean;
+    onrelease: ReleaseListener | null;
+    private readonly listeners;
+    /** @internal */
+    constructor(onRelease: (sentinel: WakeLockSentinel) => void);
+    release(): Promise<void>;
+    addEventListener(type: string, listener: ReleaseListener): void;
+    removeEventListener(type: string, listener: ReleaseListener): void;
+}
+export interface WakeLock {
+    request(type?: string): Promise<WakeLockSentinel>;
+}
+export declare function createWakeLock(native: NativeBridge): WakeLock;
+export {};
+//# sourceMappingURL=wakeLock.d.ts.map

package/dist/wakeLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeLock.d.ts","sourceRoot":"","sources":["../src/wakeLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,KAAK,IAAI,CAAC;AAEtF,qBAAa,gBAAgB;IAMf,OAAO,CAAC,QAAQ,CAAC,SAAS;IALtC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,UAAS;IACjB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,gBAAgB;gBACa,SAAS,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI;IAE5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI/D,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;CAGnE;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAiB7D"}

package/dist/wakeLock.js

@@ -0,0 +1,60 @@
+/**
+ * `navigator.wakeLock` (the Screen Wake Lock API) over the host's idle timer
+ * (`wakeLock(active)` on the bridge: `UIApplication.isIdleTimerDisabled`, a
+ * power assertion on macOS). `request('screen')` resolves with a
+ * `WakeLockSentinel`; the screen stays awake while any sentinel is held and
+ * `release()` lets it go. Unlike a page's, which the browser releases when
+ * the document hides, a native sentinel stays held in the background: the
+ * system owns the screen there, and the lock holds again when the app returns.
+ */
+export class WakeLockSentinel {
+    onRelease;
+    type = 'screen';
+    released = false;
+    onrelease = null;
+    listeners = new Set();
+    /** @internal */
+    constructor(onRelease) {
+        this.onRelease = onRelease;
+    }
+    release() {
+        if (this.released)
+            return Promise.resolve();
+        this.released = true;
+        this.onRelease(this);
+        const event = { type: 'release', target: this };
+        this.onrelease?.(event);
+        for (const listener of [...this.listeners])
+            listener(event);
+        return Promise.resolve();
+    }
+    addEventListener(type, listener) {
+        if (type === 'release' && typeof listener === 'function')
+            this.listeners.add(listener);
+    }
+    removeEventListener(type, listener) {
+        if (type === 'release')
+            this.listeners.delete(listener);
+    }
+}
+export function createWakeLock(native) {
+    const held = new Set();
+    const release = (sentinel) => {
+        held.delete(sentinel);
+        if (held.size === 0)
+            native.wakeLock(false);
+    };
+    return {
+        request(type = 'screen') {
+            if (type !== 'screen') {
+                return Promise.reject(Object.assign(new TypeError(`wakeLock.request: '${String(type)}' is not a wake lock type ('screen')`), { name: 'TypeError' }));
+            }
+            const sentinel = new WakeLockSentinel(release);
+            if (held.size === 0)
+                native.wakeLock(true);
+            held.add(sentinel);
+            return Promise.resolve(sentinel);
+        },
+    };
+}
+//# sourceMappingURL=wakeLock.js.map

package/dist/wakeLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wakeLock.js","sourceRoot":"","sources":["../src/wakeLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,OAAO,gBAAgB;IAME;IALpB,IAAI,GAAG,QAAiB,CAAC;IAClC,QAAQ,GAAG,KAAK,CAAC;IACjB,SAAS,GAA2B,IAAI,CAAC;IACxB,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxD,gBAAgB;IAChB,YAA6B,SAA+C;QAA/C,cAAS,GAAT,SAAS,CAAsC;IAAG,CAAC;IAEhF,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,SAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,QAAyB;QACtD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,UAAU;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzF,CAAC;IAED,mBAAmB,CAAC,IAAY,EAAE,QAAyB;QACzD,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACF;AAMD,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,QAA0B,EAAQ,EAAE;QACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,OAAO;QACL,OAAO,CAAC,IAAI,GAAG,QAAQ;YACrB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YACvJ,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;gBAAE,MAAM,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftbrowser/native",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "type": "module",
   "description": "Run a @swiftbrowser/react app natively: the runtime a JavaScriptCore-hosted app needs (timers, console, fetch and the other web globals over the SwiftBrowser Native bridge), the `run` entry that renders into the native SwiftUI renderer, and the bundler that builds app.js for the Xcode target.",
   "repository": {
@@ -59,8 +59,8 @@
   },
   "dependencies": {
     "@babel/core": "^7.29.7",
-    "@swiftbrowser/react": "0.18.0",
-    "@swiftbrowser/web": "0.18.0",
+    "@swiftbrowser/react": "0.18.2",
+    "@swiftbrowser/web": "0.18.2",
     "esbuild": "^0.28.2",
     "react-refresh": "^0.17.0"
   },

package/src/bridge.ts

@@ -5,7 +5,9 @@
  * package defines (`__sbTimerFired`, `__sbFetchResult`, `__sbImageProbed`,
  * `__sbWorkerMessage`, `__sbOpenURL`, `__sbMediaSessionCommand`,
  * `__sbNotificationPermission`, `__sbPushRegistered`, `__sbNotification`,
- * `__sbWebSocketEvent`, `__sbHostResponse`, `__sbUndoCommand`).
+ * `__sbWebSocketEvent`, `__sbHostResponse`, `__sbUndoCommand`, `__sbOnline`,
+ * `__sbGeolocation`, `__sbSpeechEvent`, `__sbRecognition`,
+ * `__sbFilesChanged`, `__sbNativeEvent`).
  */
 export interface NativeBridge {
   /** Applies a render pass's ops (a JSON array). Returns an error message, or nothing. */
@@ -79,14 +81,80 @@ export interface NativeBridge {
   /** `navigator.vibrate`: a haptic (`impact`, `selection`, `success`, `warning`, `error`). Hosts before 0.20 lack it. */
   haptic?(kind: string): void;
 
+  /**
+   * `navigator.onLine` (reachability.ts): whether the network path is
+   * satisfied, from `NWPathMonitor`; a change arrives at `__sbOnline(bool)`,
+   * which fires the `online` and `offline` events. Hosts before 0.19 lack it
+   * (and Linux and the round trip, which have no Network framework), and
+   * then the app is always online.
+   */
+  online?(): boolean;
+
+  /**
+   * `navigator.wakeLock` (wakeLock.ts): keep the screen awake while `active`
+   * (`UIApplication.isIdleTimerDisabled`; a power assertion on macOS). Called
+   * when the first sentinel is taken and when the last is released. Hosts
+   * before 0.19 lack it, and then there is no `navigator.wakeLock`, as in a
+   * browser without the API.
+   */
+  wakeLock?(active: boolean): void;
+
+  // Speech (speech.ts). Hosts before 0.19 lack them, and then there is no `speechSynthesis` or `SpeechRecognition`.
+  /**
+   * `speechSynthesis.speak`: utterance `id`, `{ text, lang, voice, rate, pitch,
+   * volume }` as JSON, queued on `AVSpeechSynthesizer`; its events arrive at
+   * `__sbSpeechEvent(id, json)`: `{ type: 'start' | 'end' | 'cancel' | 'pause'
+   * | 'resume' | 'boundary' | 'error', charIndex?, charLength?, message? }`.
+   */
+  speak?(id: number, json: string): void;
+  /** `speechSynthesis.cancel`, `pause` and `resume`, for every utterance queued. */
+  speechControl?(action: 'cancel' | 'pause' | 'resume'): void;
+  /**
+   * `SpeechRecognition`: `start` listens to the microphone through
+   * `SFSpeechRecognizer` with `{ lang, continuous, interimResults }`, `stop`
+   * ends the audio and lets the last result come, `abort` ends it all; the
+   * events arrive at `__sbRecognition(id, json)`: `{ type: 'start' }`,
+   * `{ type: 'result', transcript, isFinal, confidence }`, `{ type: 'error',
+   * error, message }` and `{ type: 'end' }`. The first start asks for speech
+   * recognition and the microphone (`NSSpeechRecognitionUsageDescription`,
+   * `NSMicrophoneUsageDescription`).
+   */
+  recognize?(id: number, action: 'start' | 'stop' | 'abort', json: string): void;
+
+  /**
+   * `navigator.geolocation` (geolocation.ts) over `CLLocationManager`:
+   * `current` asks for one fix, `watch` for every fix until `clear`, with
+   * the options `{ enableHighAccuracy, timeout, maximumAge }` as JSON. Each
+   * fix, or the failure, arrives at `__sbGeolocation(id, json)`: `{ position:
+   * { latitude, longitude, accuracy, altitude, altitudeAccuracy, heading,
+   * speed, timestamp } }` or `{ error: { code, message } }` (1 denied, 2
+   * unavailable). The first ask prompts the viewer (the app's Info.plist
+   * names `NSLocationWhenInUseUsageDescription`). Hosts before 0.19 lack it,
+   * and then there is no `navigator.geolocation`.
+   */
+  geolocation?(id: number, action: 'current' | 'watch' | 'clear', json: string): void;
+
   /**
    * A host request of the web renderer's kinds (hostRequests.ts): `share`,
-   * `pickFiles`, `clipboard`, `pickColor` and `webAuth`, with the request's
+   * `pickFiles`, `exportFiles`, `clipboard`, `pickColor`, `webAuth`, `appleSignIn` and `files`, with the request's
    * params as JSON; the answer arrives at `__sbHostResponse(id, { value } | { error })`.
+   * Once `files` resolved iCloud Drive's container (`action: 'iCloud'`), the
+   * URLs another device changes there arrive at `__sbFilesChanged(json)`.
    * Hosts before 0.20 lack it.
    */
   hostRequest?(id: number, kind: string, json: string): void;
 
+  /**
+   * The escape hatch's functions (nativeFunctions.ts): the names the Swift
+   * app registered with `NativeFunctions`, and a sync one run inline with its
+   * params as JSON, answering `{ value } | { error }` as JSON. The async ones
+   * go through `hostRequest` as `app:<name>`; what Swift sends with
+   * `NativeFunctions.send` arrives at `__sbNativeEvent(name, json)`. Hosts
+   * before 0.20 lack them.
+   */
+  nativeFunctions?(): string[];
+  callNativeSync?(name: string, json: string): string;
+
   /**
    * The app's undo manager's state (undo.ts): `{ canUndo, canRedo,
    * undoActionName, redoActionName }` as JSON, which the host mirrors on the

package/src/geolocation.ts

@@ -0,0 +1,160 @@
+/**
+ * `navigator.geolocation` over the host's location manager (`geolocation(id,
+ * action, json)` on the bridge, `CLLocationManager` on the Swift side):
+ * `getCurrentPosition` asks once (`current`), `watchPosition` keeps asking
+ * (`watch`) until `clearWatch` (`clear`). Each answer arrives at
+ * `__sbGeolocation(id, json)` as `{ position: { latitude, longitude,
+ * accuracy, altitude?, altitudeAccuracy?, heading?, speed?, timestamp } }` or
+ * `{ error: { code, message } }` with the API's codes (1 permission denied, 2
+ * position unavailable, 3 timeout). The first ask prompts the viewer; the
+ * app's Info.plist names `NSLocationWhenInUseUsageDescription`. `timeout`
+ * runs here, on the runtime's timers; `maximumAge` is left to the host, which
+ * answers with its freshest fix.
+ */
+
+import type { NativeBridge } from './bridge';
+
+export interface GeolocationCoordinates {
+  latitude: number;
+  longitude: number;
+  accuracy: number;
+  altitude: number | null;
+  altitudeAccuracy: number | null;
+  heading: number | null;
+  speed: number | null;
+}
+
+export interface GeolocationPosition {
+  coords: GeolocationCoordinates;
+  /** Milliseconds since the epoch. */
+  timestamp: number;
+}
+
+export class GeolocationPositionError extends Error {
+  static readonly PERMISSION_DENIED = 1;
+  static readonly POSITION_UNAVAILABLE = 2;
+  static readonly TIMEOUT = 3;
+  readonly PERMISSION_DENIED = 1;
+  readonly POSITION_UNAVAILABLE = 2;
+  readonly TIMEOUT = 3;
+  constructor(
+    readonly code: number,
+    message: string,
+  ) {
+    super(message);
+    this.name = 'GeolocationPositionError';
+  }
+}
+
+export interface PositionOptions {
+  enableHighAccuracy?: boolean;
+  timeout?: number;
+  maximumAge?: number;
+}
+
+type Success = (position: GeolocationPosition) => void;
+type Failure = (error: GeolocationPositionError) => void;
+
+/** The host's answer for request `id`. */
+export interface NativeGeolocationResult {
+  position?: {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude?: number | null;
+    altitudeAccuracy?: number | null;
+    heading?: number | null;
+    speed?: number | null;
+    timestamp: number;
+  };
+  error?: { code?: number; message?: string };
+}
+
+export interface Geolocation {
+  getCurrentPosition(success: Success, failure?: Failure | null, options?: PositionOptions): void;
+  watchPosition(success: Success, failure?: Failure | null, options?: PositionOptions): number;
+  clearWatch(id: number): void;
+}
+
+interface Pending {
+  watch: boolean;
+  success: Success;
+  failure: Failure | null;
+  timer: unknown;
+}
+
+type Timers = { setTimeout?: (fn: () => void, ms: number) => unknown; clearTimeout?: (id: unknown) => void };
+
+export function createGeolocation(native: NativeBridge, target: Record<string, unknown>): { geolocation: Geolocation; receive(id: number, json: string): void } {
+  const pending = new Map<number, Pending>();
+  let nextId = 1;
+  const timers = target as Timers;
+
+  const finish = (id: number): void => {
+    const entry = pending.get(id);
+    if (!entry) return;
+    pending.delete(id);
+    if (entry.timer !== null && typeof timers.clearTimeout === 'function') timers.clearTimeout(entry.timer);
+  };
+  const ask = (watch: boolean, success: Success, failure: Failure | null | undefined, options: PositionOptions | undefined): number => {
+    if (typeof success !== 'function') throw new TypeError('geolocation: the success callback is not a function');
+    const id = nextId++;
+    const entry: Pending = { watch, success, failure: typeof failure === 'function' ? failure : null, timer: null };
+    pending.set(id, entry);
+    const timeout = options?.timeout;
+    if (typeof timeout === 'number' && timeout >= 0 && timeout !== Infinity && typeof timers.setTimeout === 'function') {
+      entry.timer = timers.setTimeout(() => {
+        // A watch times out once per fix that does not come; its wait starts over with the next answer.
+        if (!watch) {
+          finish(id);
+          native.geolocation!(id, 'clear', '{}');
+        } else entry.timer = null;
+        entry.failure?.(new GeolocationPositionError(GeolocationPositionError.TIMEOUT, 'geolocation: timed out'));
+      }, timeout);
+    }
+    native.geolocation!(id, watch ? 'watch' : 'current', JSON.stringify({ enableHighAccuracy: options?.enableHighAccuracy === true, timeout: timeout ?? null, maximumAge: options?.maximumAge ?? 0 }));
+    return id;
+  };
+
+  return {
+    geolocation: {
+      getCurrentPosition(success, failure, options) {
+        ask(false, success, failure, options);
+      },
+      watchPosition(success, failure, options) {
+        return ask(true, success, failure, options);
+      },
+      clearWatch(id) {
+        if (!pending.has(Number(id))) return;
+        finish(Number(id));
+        native.geolocation!(Number(id), 'clear', '{}');
+      },
+    },
+    receive(id, json) {
+      const entry = pending.get(id);
+      if (!entry) return;
+      const result = JSON.parse(json) as NativeGeolocationResult;
+      if (!entry.watch) finish(id);
+      if (result.position) {
+        const p = result.position;
+        entry.success({
+          coords: {
+            latitude: p.latitude,
+            longitude: p.longitude,
+            accuracy: p.accuracy,
+            altitude: p.altitude ?? null,
+            altitudeAccuracy: p.altitudeAccuracy ?? null,
+            heading: p.heading ?? null,
+            speed: p.speed ?? null,
+          },
+          timestamp: p.timestamp,
+        });
+      } else {
+        const code = result.error?.code ?? GeolocationPositionError.POSITION_UNAVAILABLE;
+        // A denial ends a watch too: the host will not answer again.
+        if (entry.watch && code === GeolocationPositionError.PERMISSION_DENIED) finish(id);
+        entry.failure?.(new GeolocationPositionError(code, result.error?.message ?? 'geolocation: the position is unavailable'));
+      }
+    },
+  };
+}