@swiftbrowser/native 0.17.7 → 0.17.8

package/dist/hostRequests.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The host requests `@swiftbrowser/react` sends to the browser environment
+ * (`ShareLink`, `fileImporter`, the clipboard, a color chooser: the web
+ * renderer's `performHostRequest` with its `browserEnvironment`), answered by
+ * the native app instead: the bridge's `hostRequest(id, kind, json)` performs
+ * one with UIKit (a share sheet, the photo or document picker, the
+ * pasteboard, the color picker, `ASWebAuthenticationSession`), answering
+ * `__sbHostResponse(id, { value } | { error })`. `installHostEnvironment`
+ * fills the environment's gaps with these, leaving what the page has (the
+ * round trip runs in a browser with a share sheet of its own).
+ *
+ * `webAuthenticate` is the sign-in window apps open for OAuth: the system's
+ * sheet, resolving with the callback URL.
+ */
+import type { NativeBridge } from './bridge';
+export type HostRequestBridge = Required<Pick<NativeBridge, 'hostRequest'>>;
+/** A file as it crosses the bridge: its name, MIME type and bytes (base64). */
+export interface BridgedFile {
+    name: string;
+    type: string;
+    data: string;
+}
+export interface WebAuthenticateOptions {
+    /** The scheme of the callback URL the sign-in ends with (`myapp` for `myapp://auth`); universal links need none. */
+    callbackScheme?: string;
+    /** Whether the session shares no cookies with the system browser. */
+    ephemeral?: boolean;
+}
+/** Points the requests at the bridge (the runtime, once per install). */
+export declare function installHostRequests(native: HostRequestBridge): void;
+/** The bridge's `__sbHostResponse(id, result)`. */
+export declare function receiveHostResponse(id: number, result: string | {
+    value?: unknown;
+    error?: string;
+}): void;
+/** Performs one request of `kind` with `params`; resolves with the host's value. */
+export declare function hostRequest<T = unknown>(kind: string, params: Record<string, unknown>): Promise<T>;
+/** Forgets the bridge and the waiting requests, for tests. */
+export declare function resetHostRequests(): void;
+/**
+ * Opens the system's sign-in sheet at `url` and resolves with the callback
+ * URL it ends with; rejects with an `AbortError` when the viewer closes it.
+ */
+export declare function webAuthenticate(url: string, options?: WebAuthenticateOptions): Promise<string>;
+/** The environment fields the host answers, shaped as the web renderer's `HostRequestEnvironment`. */
+export declare function nativeHostEnvironment(): Record<string, unknown>;
+/** Fills what `environment` lacks with the host's answers; what the page has stays. */
+export declare function installHostEnvironment(environment: Record<string, unknown>): void;
+//# sourceMappingURL=hostRequests.d.ts.map

package/dist/hostRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostRequests.d.ts","sourceRoot":"","sources":["../src/hostRequests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;AAE5E,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,oHAAoH;IACpH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAEnE;AAED,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB1G;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUlG;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAWD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxG;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B/D;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKjF"}

package/dist/hostRequests.js

@@ -0,0 +1,134 @@
+/**
+ * The host requests `@swiftbrowser/react` sends to the browser environment
+ * (`ShareLink`, `fileImporter`, the clipboard, a color chooser: the web
+ * renderer's `performHostRequest` with its `browserEnvironment`), answered by
+ * the native app instead: the bridge's `hostRequest(id, kind, json)` performs
+ * one with UIKit (a share sheet, the photo or document picker, the
+ * pasteboard, the color picker, `ASWebAuthenticationSession`), answering
+ * `__sbHostResponse(id, { value } | { error })`. `installHostEnvironment`
+ * fills the environment's gaps with these, leaving what the page has (the
+ * round trip runs in a browser with a share sheet of its own).
+ *
+ * `webAuthenticate` is the sign-in window apps open for OAuth: the system's
+ * sheet, resolving with the callback URL.
+ */
+import { objectURL, SimpleBlob, SimpleFile } from './blob';
+import { base64Decode, base64Encode } from './encoding';
+let bridge = null;
+let nextId = 1;
+const pending = new Map();
+/** Points the requests at the bridge (the runtime, once per install). */
+export function installHostRequests(native) {
+    bridge = native;
+}
+/** The bridge's `__sbHostResponse(id, result)`. */
+export function receiveHostResponse(id, result) {
+    const waiting = pending.get(id);
+    if (!waiting)
+        return;
+    pending.delete(id);
+    let parsed;
+    try {
+        parsed = typeof result === 'string' ? JSON.parse(result) : result;
+    }
+    catch {
+        waiting.reject(new Error('host: malformed response'));
+        return;
+    }
+    if (typeof parsed.error === 'string') {
+        const error = new Error(parsed.error);
+        if (parsed.error.startsWith('cancelled'))
+            error.name = 'AbortError';
+        waiting.reject(error);
+    }
+    else {
+        waiting.resolve(parsed.value);
+    }
+}
+/** Performs one request of `kind` with `params`; resolves with the host's value. */
+export function hostRequest(kind, params) {
+    return new Promise((resolve, reject) => {
+        if (!bridge) {
+            reject(new Error(`unsupported: no native host for ${kind}`));
+            return;
+        }
+        const id = nextId++;
+        pending.set(id, { resolve: resolve, reject });
+        bridge.hostRequest(id, kind, JSON.stringify(params));
+    });
+}
+/** Forgets the bridge and the waiting requests, for tests. */
+export function resetHostRequests() {
+    bridge = null;
+    pending.clear();
+    nextId = 1;
+}
+async function bridgedFile(file) {
+    return { name: file.name ?? 'file', type: file.type, data: base64Encode(file.bytes()) };
+}
+function filesOf(value) {
+    const files = value?.files ?? [];
+    return files.map((file) => new SimpleFile([base64Decode(file.data)], file.name, { type: file.type }));
+}
+/**
+ * Opens the system's sign-in sheet at `url` and resolves with the callback
+ * URL it ends with; rejects with an `AbortError` when the viewer closes it.
+ */
+export async function webAuthenticate(url, options = {}) {
+    const params = { action: 'start', url };
+    if (options.callbackScheme)
+        params['callbackScheme'] = options.callbackScheme;
+    if (options.ephemeral !== undefined)
+        params['ephemeral'] = options.ephemeral;
+    const result = await hostRequest('webAuth', params);
+    if (typeof result?.url !== 'string')
+        throw new Error('webAuth: the sign-in ended without a URL');
+    return result.url;
+}
+/** The environment fields the host answers, shaped as the web renderer's `HostRequestEnvironment`. */
+export function nativeHostEnvironment() {
+    return {
+        share: async (data) => {
+            const params = {};
+            if (data.title)
+                params['title'] = data.title;
+            if (data.text)
+                params['text'] = data.text;
+            if (data.url)
+                params['url'] = data.url;
+            if (data.files?.length)
+                params['files'] = await Promise.all(data.files.map(bridgedFile));
+            const result = await hostRequest('share', params);
+            if (result?.outcome === 'cancelled') {
+                const error = new Error('cancelled: the viewer closed the share sheet');
+                error.name = 'AbortError';
+                throw error;
+            }
+        },
+        canShare: () => true,
+        download: (blob, filename) => {
+            void hostRequest('share', { files: [{ name: filename, type: blob.type, data: base64Encode(blob.bytes()) }] }).catch(() => undefined);
+        },
+        pickFiles: async (options) => filesOf(await hostRequest('pickFiles', { accept: options.accept, multiple: options.multiple })),
+        objectURL: (file) => objectURL(file),
+        clipboard: {
+            writeText: (text) => hostRequest('clipboard', { action: 'write', text }).then(() => undefined),
+            writeImage: async (png) => {
+                const file = await png;
+                await hostRequest('clipboard', { action: 'write', files: [{ name: 'image.png', type: file.type || 'image/png', data: base64Encode(file.bytes()) }] });
+            },
+            readText: async () => (await hostRequest('clipboard', { action: 'readText' }))?.text ?? '',
+        },
+        pickColor: async (color) => (await hostRequest('pickColor', { color }))?.color ?? null,
+    };
+}
+/** Fills what `environment` lacks with the host's answers; what the page has stays. */
+export function installHostEnvironment(environment) {
+    if (!bridge)
+        return;
+    for (const [key, value] of Object.entries(nativeHostEnvironment())) {
+        if (environment[key] === undefined)
+            environment[key] = value;
+    }
+}
+//# sourceMappingURL=hostRequests.js.map

package/dist/hostRequests.js.map

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

package/dist/index.d.ts

@@ -16,8 +16,15 @@ export { installRuntime, type InstallOptions } from './runtime';
 export { nativeBridge, launchArguments, type NativeBridge, type NativeFetchRequest, type NativeFetchResult, type WorkerEngine } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
+export { SimpleBlob, SimpleFile, SimpleFormData, encodeMultipart, objectURL } from './blob';
+export { NativeWebSocket, type NativeWebSocketEvent } from './webSocket';
+export { createSubtleCrypto } from './subtle';
+export { matchMedia, updateMediaEnvironment, type MediaEnvironment } from './matchMedia';
+export { hostRequest, webAuthenticate, nativeHostEnvironment, installHostEnvironment, type WebAuthenticateOptions, type BridgedFile } from './hostRequests';
+export { secureStorage, createSecureStorage, type SecureStorage } from './secureStorage';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
 export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName, type NativeWorkerOptions, type WorkerLike, type WorkerMessageEvent, type WorkerErrorEvent } from './worker';
 export { onOpenURL } from './openURL';
+export { onNotification, registerForPush, type NotificationEvent, type NativeNotificationOptions, type RegisterForPushOptions } from './notifications';
 export { createMediaSession, NativeMediaMetadata, type NativeMediaSession, type MediaMetadataInit, type MediaActionDetails, type MediaActionHandler, type MediaPositionState } from './mediaSession';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -16,8 +16,15 @@ export { installRuntime } from './runtime';
 export { nativeBridge, launchArguments } from './bridge';
 export { SimpleHeaders, SimpleRequest, SimpleResponse, SimpleAbortController, SimpleAbortSignal, createFetch } from './fetch';
 export { SimpleURL, SimpleURLSearchParams } from './url';
+export { SimpleBlob, SimpleFile, SimpleFormData, encodeMultipart, objectURL } from './blob';
+export { NativeWebSocket } from './webSocket';
+export { createSubtleCrypto } from './subtle';
+export { matchMedia, updateMediaEnvironment } from './matchMedia';
+export { hostRequest, webAuthenticate, nativeHostEnvironment, installHostEnvironment } from './hostRequests';
+export { secureStorage, createSecureStorage } from './secureStorage';
 export { SimpleTextEncoder, SimpleTextDecoder, base64Encode, base64Decode, utf8Encode, utf8Decode } from './encoding';
 export { createWorker, NativeWorker, encodeMessage, decodeMessage, workerName } from './worker';
 export { onOpenURL } from './openURL';
+export { onNotification, registerForPush } from './notifications';
 export { createMediaSession, NativeMediaMetadata } from './mediaSession';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAyF,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6F,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA8H,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,GAAG,EAAiC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAoB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAuB,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAyF,MAAM,UAAU,CAAC;AAChJ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9H,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,eAAe,EAA6B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAyB,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAiD,MAAM,gBAAgB,CAAC;AAC5J,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAsB,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAA6F,MAAM,UAAU,CAAC;AAC3L,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAuF,MAAM,iBAAiB,CAAC;AACvJ,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAA8H,MAAM,gBAAgB,CAAC"}

package/dist/matchMedia.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `matchMedia` for the native app: `(prefers-color-scheme: dark)` and
+ * `light` follow the color scheme the host sends with the environment
+ * (run.ts hands it over), `(prefers-reduced-motion: reduce)` the host's
+ * accessibility setting when it sends one; every other query matches
+ * nothing. Listeners hear a change when the environment does.
+ */
+export interface MediaQueryListLike {
+    readonly media: string;
+    readonly matches: boolean;
+    onchange: ((event: {
+        matches: boolean;
+        media: string;
+    }) => void) | null;
+    addEventListener(type: 'change', listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    removeEventListener(type: 'change', listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    /** The older names. */
+    addListener(listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+    removeListener(listener: (event: {
+        matches: boolean;
+        media: string;
+    }) => void): void;
+}
+export interface MediaEnvironment {
+    colorScheme?: 'light' | 'dark';
+    reducedMotion?: boolean;
+}
+/** The runtime's `matchMedia(query)`. */
+export declare function matchMedia(query: string): MediaQueryListLike;
+/** What the host sent with the environment; lists whose answer changed tell their listeners. */
+export declare function updateMediaEnvironment(next: MediaEnvironment): void;
+/** Forgets the environment and the lists, for tests. */
+export declare function resetMediaEnvironment(): void;
+//# sourceMappingURL=matchMedia.d.ts.map

package/dist/matchMedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchMedia.d.ts","sourceRoot":"","sources":["../src/matchMedia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACxE,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACvG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1G,uBAAuB;IACvB,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAClF,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAgBD,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAoB5D;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAUnE;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/dist/matchMedia.js

@@ -0,0 +1,63 @@
+/**
+ * `matchMedia` for the native app: `(prefers-color-scheme: dark)` and
+ * `light` follow the color scheme the host sends with the environment
+ * (run.ts hands it over), `(prefers-reduced-motion: reduce)` the host's
+ * accessibility setting when it sends one; every other query matches
+ * nothing. Listeners hear a change when the environment does.
+ */
+let environment = {};
+const lists = new Set();
+function evaluate(query) {
+    const normalized = query.trim().toLowerCase().replace(/\s+/g, '');
+    if (normalized === '(prefers-color-scheme:dark)')
+        return environment.colorScheme === 'dark';
+    if (normalized === '(prefers-color-scheme:light)')
+        return environment.colorScheme !== 'dark';
+    if (normalized === '(prefers-reduced-motion:reduce)')
+        return environment.reducedMotion === true;
+    if (normalized === '(prefers-reduced-motion:no-preference)')
+        return environment.reducedMotion !== true;
+    return false;
+}
+/** The runtime's `matchMedia(query)`. */
+export function matchMedia(query) {
+    const media = String(query);
+    const state = { media, matches: evaluate(media), listeners: new Set(), onchange: null };
+    lists.add(state);
+    return {
+        media,
+        get matches() {
+            return state.matches;
+        },
+        get onchange() {
+            return state.onchange;
+        },
+        set onchange(listener) {
+            state.onchange = listener;
+        },
+        addEventListener: (_type, listener) => void state.listeners.add(listener),
+        removeEventListener: (_type, listener) => void state.listeners.delete(listener),
+        addListener: (listener) => void state.listeners.add(listener),
+        removeListener: (listener) => void state.listeners.delete(listener),
+    };
+}
+/** What the host sent with the environment; lists whose answer changed tell their listeners. */
+export function updateMediaEnvironment(next) {
+    environment = { ...environment, ...next };
+    for (const state of lists) {
+        const matches = evaluate(state.media);
+        if (matches === state.matches)
+            continue;
+        state.matches = matches;
+        const event = { matches, media: state.media };
+        state.onchange?.(event);
+        for (const listener of state.listeners)
+            listener(event);
+    }
+}
+/** Forgets the environment and the lists, for tests. */
+export function resetMediaEnvironment() {
+    environment = {};
+    lists.clear();
+}
+//# sourceMappingURL=matchMedia.js.map

package/dist/matchMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchMedia.js","sourceRoot":"","sources":["../src/matchMedia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,IAAI,WAAW,GAAqB,EAAE,CAAC;AACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4F,CAAC;AAElH,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,UAAU,KAAK,6BAA6B;QAAE,OAAO,WAAW,CAAC,WAAW,KAAK,MAAM,CAAC;IAC5F,IAAI,UAAU,KAAK,8BAA8B;QAAE,OAAO,WAAW,CAAC,WAAW,KAAK,MAAM,CAAC;IAC7F,IAAI,UAAU,KAAK,iCAAiC;QAAE,OAAO,WAAW,CAAC,aAAa,KAAK,IAAI,CAAC;IAChG,IAAI,UAAU,KAAK,wCAAwC;QAAE,OAAO,WAAW,CAAC,aAAa,KAAK,IAAI,CAAC;IACvG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,GAAG,EAAY,EAAE,QAAQ,EAAE,IAAuB,EAAE,CAAC;IACrH,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,IAAI,OAAO;YACT,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ;YACnB,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC5B,CAAC;QACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzE,mBAAmB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC/E,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC7D,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,KAAK,CAAC,OAAO;YAAE,SAAS;QACxC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QACxB,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9C,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,qBAAqB;IACnC,WAAW,GAAG,EAAE,CAAC;IACjB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/notifications.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Notifications in the native app: the browser's `Notification` (the
+ * permission, local notifications and their clicks) and `navigator.setAppBadge`
+ * over the host's UserNotifications (Native/Sources/SwiftBrowserNative/Host/NotificationBridge.swift),
+ * and remote notifications: `registerForPush` resolves with the device token
+ * (APNs, as hex) and `onNotification` delivers what the viewer opened and what
+ * arrived while the app is open.
+ *
+ * ```ts
+ * const token = await registerForPush();
+ * await fetch('/api/devices', { method: 'POST', body: JSON.stringify({ token }) });
+ * useEffect(() => onNotification((n) => { if (n.event === 'opened') show(n.data.postId); }), []);
+ * ```
+ *
+ * In the page (the round trip, or any browser) the host has no bridge for
+ * these: `Notification` is the browser's own, and `registerForPush` subscribes
+ * to Web Push through the site's service worker (`sw.js`, which the web
+ * renderer ships: docs/ops-protocol.md, "Push notifications") with the
+ * `applicationServerKey` given, resolving with the subscription's JSON as
+ * the token; the worker's messages become `onNotification` events. A server
+ * sends to both with one payload: APNs' (`aps.alert`, `aps.badge`), which
+ * the worker reads too.
+ */
+import type { NativeBridge } from './bridge';
+export type NotificationPermissionState = 'default' | 'granted' | 'denied';
+/** What the viewer did with a notification, or one that arrived while the app is open. */
+export interface NotificationEvent {
+    event: 'opened' | 'received';
+    /** Whether it came from the push service. */
+    remote: boolean;
+    /** The notification's identifier (`tag`, or the push payload's `id`). */
+    id: string;
+    title: string;
+    body: string;
+    /** A push's payload, or what `new Notification(title, { data })` gave. */
+    data: Record<string, unknown>;
+    /** `opened`: the action the viewer chose, empty for the notification itself. */
+    action?: string;
+}
+export interface NativeNotificationOptions {
+    body?: string;
+    /** The notification's identifier: a later one with the same tag replaces it. */
+    tag?: string;
+    data?: unknown;
+    silent?: boolean;
+    /** The app badge to set with it. */
+    badge?: number;
+}
+export interface RegisterForPushOptions {
+    /** The Web Push application server key (the server's VAPID public key, base64url), for the page. */
+    applicationServerKey?: string;
+}
+type Listener = (notification: NotificationEvent) => void;
+/** The bridge functions notifications need. */
+export type NotificationBridge = Pick<NativeBridge, 'notificationsReady' | 'notificationPermission' | 'notificationShow' | 'notificationClose' | 'setBadge' | 'pushRegister'>;
+export interface NotificationGlobals {
+    Notification: NativeNotificationClass;
+    __sbNotificationPermission: (id: number, permission: NotificationPermissionState) => void;
+    __sbPushRegistered: (id: number, result: {
+        token?: string;
+        error?: string;
+    }) => void;
+    __sbNotification: (json: string) => void;
+    /** `navigator.setAppBadge` and `clearAppBadge`. */
+    setAppBadge: (count?: number) => Promise<void>;
+    clearAppBadge: () => Promise<void>;
+    /** The native `registerForPush`. */
+    registerForPush: (options?: RegisterForPushOptions) => Promise<string>;
+}
+export interface NativeNotificationClass {
+    new (title: string, options?: NativeNotificationOptions): NativeNotificationInstance;
+    readonly permission: NotificationPermissionState;
+    requestPermission(): Promise<NotificationPermissionState>;
+}
+export interface NativeNotificationInstance {
+    readonly title: string;
+    readonly body: string;
+    readonly tag: string;
+    readonly data: unknown;
+    onclick: ((event: {
+        notification: NativeNotificationInstance;
+        action: string;
+    }) => void) | null;
+    close(): void;
+}
+/**
+ * Listens for notifications the viewer opened and ones that arrived while
+ * the app is open; returns what stops listening. Events before any listener
+ * (a tap that launched the app) wait for the first one.
+ */
+export declare function onNotification(listener: Listener): () => void;
+/** The runtime's `__sbNotification(json)`, and what the page's worker messages become. */
+export declare function receiveNotification(event: NotificationEvent): void;
+/**
+ * Registers for remote notifications and resolves with the device token:
+ * APNs' as hex in the native app, the Web Push subscription's JSON in the
+ * page (which needs `applicationServerKey`). Rejects with the reason the
+ * system or the browser refused.
+ */
+export declare function registerForPush(options?: RegisterForPushOptions): Promise<string>;
+/** Resets the listeners and the delivery source, for tests. */
+export declare function resetNotifications(): void;
+/** The globals for a host with the notification bridge. */
+export declare function createNotificationGlobals(native: NotificationBridge): NotificationGlobals;
+/** The event a service worker message carries (Web/src/notifications.ts), or null. */
+export declare function notificationEventOf(data: unknown): NotificationEvent | null;
+export {};
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

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