@swiftbrowser/react 0.18.0 → 0.18.2

package/README.md

@@ -400,6 +400,75 @@ titles when regular and the first column when compact.
 />
 ```
 
+### Scene phase
+
+`useScenePhase()` is `@Environment(\.scenePhase)`: `active` while the app is
+in front and takes input, `inactive` while it shows but does not, and
+`background` while it is not shown. A page follows the document's visibility
+(hidden is `background`) and the window's focus (`mount` and `SwiftUIView`
+watch them); the native app follows its scene. Refresh what time moved on
+when it turns `active`: timers may not have run in the background.
+
+```tsx
+const phase = useScenePhase();
+useEffect(() => {
+  if (phase === 'active') setToday(dayKey(new Date()));
+}, [phase]);
+```
+
+### Wake lock
+
+`useWakeLock(active)` keeps the screen awake while `active` (a recording
+under way, a recipe being followed), through the Screen Wake Lock API: the
+browser's on a page, the runtime's `navigator.wakeLock` over the idle timer
+in a native app. It returns whether a lock is held, and takes the lock
+again when the browser let it go as the document hid and it shows again.
+Where there is no `navigator.wakeLock`, nothing happens.
+
+```tsx
+useWakeLock(recorder.status !== 'idle');
+```
+
+### Location
+
+`useGeolocation(options)` is the viewer's position through the Geolocation
+API: the browser's on a page, the runtime's `navigator.geolocation` over
+`CLLocationManager` in a native app (the app's Info.plist names
+`NSLocationWhenInUseUsageDescription`). Nothing is asked until `request()`
+(the first ask prompts the viewer) unless `immediate` is set; `watch` keeps
+following the position until `stop()` or the view goes. The state carries
+`available`, `status` (`idle`, `locating`, `located`, `denied`, `failed`),
+the latest `position` (`latitude`, `longitude`, `accuracy`, `altitude`,
+`heading`, `speed`, `timestamp`) and `error`.
+
+```tsx
+const location = useGeolocation({ enableHighAccuracy: true });
+<Button title="Use My Location" action={location.request} />
+{location.position && <Text>{`${location.position.latitude}, ${location.position.longitude}`}</Text>}
+```
+
+### Speech
+
+`useSpeechSynthesis()` reads text aloud through the Web Speech API (the
+browser's voices on a page, `AVSpeechSynthesizer` in a native app):
+`speak(text, { lang, rate, pitch, volume })` queues an utterance, `cancel()`
+stops and empties the queue, `pause()` and `resume()` hold it, and
+`speaking` and `paused` follow; what a view was reading stops when it goes.
+`useSpeechRecognition({ lang, continuous, interimResults })` turns the
+viewer's speech into text (the browser's recognizer, `SFSpeechRecognizer`
+natively; the app's Info.plist names `NSSpeechRecognitionUsageDescription`
+and `NSMicrophoneUsageDescription`): `start()` listens, `transcript` is the
+final words of the session so far and `interim` what is being heard,
+`stop()` lets the last words arrive and `abort()` does not; `error` names
+`not-allowed`, `audio-capture`, `no-speech` or `network`. Both read
+`available` where the environment lacks the API, and the Showcase's Books
+reads a chapter aloud and its Notes takes dictation with them.
+
+```tsx
+const speech = useSpeechSynthesis();
+<Button title={speech.speaking ? 'Stop' : 'Read Aloud'} action={() => (speech.speaking ? speech.cancel() : speech.speak(chapterText))} />
+```
+
 ### Scrolling
 
 `List`, `LazyVStack` and `LazyHStack` build a long `ForEach` a batch of
@@ -427,7 +496,9 @@ Name a coordinate space with `coordinateSpace="page"` on the `ScrollView`
 `proxy.frame({ named: 'page' })`, updated as the page scrolls.
 `onGeometryChange={{ of: (proxy) => proxy.size, action: setSize }}` is
 `.onGeometryChange(for:of:action:)`: the action hears the transform's
-answer when it changes, after the render, without a reader or a child
+answer when it changes, after the render and before anything is painted
+(state it sets lays out in the same frame, so a view sized from its own
+measurement settles at once), without a reader or a child
 that reports in an effect.
 
 `onScrollGeometryChange` on a `ScrollView` is `.onScrollGeometryChange`:
@@ -558,6 +629,39 @@ chooser calls `onCancellation`:
                   onCompletion: ([file]) => upload(file) }} />
 ```
 
+`fileExporter` is the other way: the document goes where the viewer chooses,
+a save dialog where the browser has one (Chromium's File System Access API),
+a download elsewhere, and the Files app in a native app. The document is
+text, bytes or a `Blob`, named by `defaultFilename` (the type's extension
+added when it has none); `onCompletion` gets where it went (`saved` or
+`downloaded`), and a dismissed dialog calls `onCancellation`. The Showcase's
+Pages exports a document as text and Numbers a sheet as CSV with it.
+
+```tsx
+<VStack fileExporter={{ isPresented: [exporting, setExporting], document: csv, contentType: 'text/csv', defaultFilename: `${title}.csv` }}>
+  <Button title="Export as CSV" action={() => setExporting(true)} />
+</VStack>
+```
+
+### Sign in with Apple
+
+`SignInWithAppleButton` is SwiftUI's button (`label`: `signIn`, `signUp` or
+`continue`; `style`: `black`, `white` or `whiteOutline`); `onCompletion` gets
+the credential (`user`, the stable identifier; `email` and `fullName`, shared
+the first time only; `identityToken` and `authorizationCode` for your server)
+or the error (`cancelled: …` when the viewer dismissed the sheet).
+`signInWithApple({ scopes, nonce, state })` is the same without the button,
+`appleCredentialState(user)` asks what the credential is now (`unknown` on a
+page), and `canSignInWithApple()` says whether it works here. Natively the
+system sheet answers, in an app with the entitlement (`swiftbrowser native
+init --sign-in-with-apple`). On a page Apple's JS does, once the app named
+the Services ID and return URL it registered with Apple for the domain:
+
+```tsx
+configureSignInWithApple({ clientId: 'com.example.app.web', redirectURI: 'https://example.com/app/' });
+<SignInWithAppleButton onCompletion={({ credential, error }) => credential && signedIn(credential)} padding={16} />
+```
+
 ### Gestures
 
 `onTapGesture`, `dragGesture`, `magnifyGesture`, `rotateGesture` and
@@ -577,7 +681,10 @@ without the item's own space moving along. `onTapGesture={{ count: 2, action
 the double tap is inside), the single tap waits for the double-tap interval
 to pass, as on iOS. `contentShape="rectangle"` makes the whole frame take
 taps and gestures, which, as in SwiftUI, only what a view draws does
-otherwise: a 44 pt box around a 14 pt handle, a clear slide.
+otherwise: a 44 pt box around a 14 pt handle, a clear slide. `onTouches={(touches, phase) => …}` is a SwiftBrowser
+addition for chords and glissandi: every pointer down on the view, in its
+coordinates, with `began`, `changed`, `ended` or `cancelled`; the view owns
+its pointers, so nothing above it scrolls or swipes with them.
 
 ### Mouse, keyboard and effects
 
@@ -666,7 +773,8 @@ Native app they are the app's sandbox. Paths are `file:` URLs, made with
 `url(directory, path)`. The calls are Swift's, asynchronous on both sides
 since the page's storage is: `contents`, `text`, `write` (bytes, a Blob or
 text; the directory must exist), `contentsOfDirectory`, `createDirectory`
-(with its parents), `fileExists`, `attributesOfItem`, `moveItem`,
+(with its parents), `fileExists`, `attributesOfItem` (size, the modification
+and creation times, the MIME type the extension names), `moveItem`,
 `copyItem`, `removeItem`. Failures say what went wrong first: `notFound:`,
 `exists:`, `isDirectory:`, `notDirectory:`, `unsupported:` (a URL outside
 the app's directories, or a page that keeps no files: `available`).
@@ -684,6 +792,26 @@ A `VideoPlayer`, `AudioPlayer` or `Image` given a `file:` URL loads the file
 answers; natively the URL as it is). `mount`'s `app` option names the
 database on a page (`sb-files:<app>`).
 
+`iCloudDirectory()` is the app's folder in iCloud Drive, where the native
+app has the iCloud entitlement (`swiftbrowser native init --icloud`) and the
+viewer iCloud Drive: files there follow the viewer to their other devices
+and show in the Files app, a file another device wrote is downloaded when
+read, and `watch(listener)` reports the URLs that changed (what this app
+wrote too, so two readers of a file agree). It is null on a page and in an
+app without the entitlement, so an app keeps its documents in
+`iCloudDirectory() ?? documentsDirectory` and is the same code everywhere.
+`useFileStorage(url, default)` keeps a value as a JSON file the way
+`useAppStorage` keeps one under a key, reading it again when it changes:
+
+```tsx
+const [folder, setFolder] = useState<string | null>(null);
+useEffect(() => { void fileManager.iCloudDirectory().then((cloud) => setFolder(cloud ?? fileManager.documentsDirectory)); }, []);
+const [memos, setMemos, status] = useFileStorage<Memo[]>(folder && fileManager.url(folder, 'memos.json'), []);
+```
+
+The Showcase's Voice Memos keeps its recordings and their index this way,
+so a memo recorded on one device plays on the next.
+
 ### Animation
 
 `withAnimation(animation, () => …)` animates the pass a state change makes,
@@ -771,7 +899,8 @@ SwiftUI row shows the count, and the row grows with the text.
   selection, scrolling inside the host and native controls work; the row
   around it still swipes when the pan starts outside the host.
 - **Hooks.** The content can use this package's hooks: `useDismiss()` from a
-  sheet or a pushed screen, `useNavigation()` to push, `useColorScheme()`.
+  sheet or a pushed screen, `useNavigation()` to push, `useColorScheme()`,
+  `useScenePhase()`.
 
 A host is a React root of its own, so it needs the `react-dom` peer
 dependency, and React context does not cross into it by itself; see below.

package/dist/appleSignIn.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Sign in with Apple: `signInWithApple()` asks the viewer and resolves with
+ * the credential (`ASAuthorizationAppleIDCredential`'s fields: the stable
+ * `user`, the name and email shared the first time, the identity token and
+ * authorization code for the app's server), `appleCredentialState(user)` asks
+ * what the credential is now, and `SignInWithAppleButton` is SwiftUI's
+ * button, drawn from a button, the Apple logo and the label in the black,
+ * white or white-outline style. Natively the system sheet answers; on a page
+ * Apple's JS does, once the app named its Services ID and return URL with
+ * `configureSignInWithApple` (both registered with Apple for the domain), and
+ * without that the request fails `unsupported:`.
+ */
+import type { AppleCredentialState, AppleIDCredential } from '@swiftbrowser/web/src/hostRequests';
+import { configureSignInWithApple } from '@swiftbrowser/web/src/appleSignIn';
+import { type ReactNode } from 'react';
+import { type ViewModifiers } from './modifiers';
+export type { AppleCredentialState, AppleIDCredential };
+export { configureSignInWithApple };
+export interface SignInWithAppleOptions {
+    /** What to ask the viewer to share; both by default. Shared the first time only, as on iOS. */
+    scopes?: ('fullName' | 'email')[];
+    /** A nonce the identity token carries, for the app's server to check. */
+    nonce?: string;
+    /** Echoed back in the credential. */
+    state?: string;
+}
+/** Whether this page or app can sign in with Apple (natively always; on a page once configured). */
+export declare function canSignInWithApple(): boolean;
+export declare function signInWithApple(options?: SignInWithAppleOptions): Promise<AppleIDCredential>;
+/** `ASAuthorizationAppleIDProvider.credentialState(forUserID:)`; `unknown` where the host cannot ask (a page). */
+export declare function appleCredentialState(user: string): Promise<AppleCredentialState>;
+export type SignInWithAppleLabel = 'signIn' | 'signUp' | 'continue';
+export type SignInWithAppleStyle = 'black' | 'white' | 'whiteOutline';
+export interface SignInWithAppleButtonProps extends ViewModifiers {
+    /** `.signIn` ("Sign in with Apple"), `.signUp` or `.continue`. */
+    label?: SignInWithAppleLabel;
+    /** `.signInWithAppleButtonStyle`: `black` by default. */
+    style?: SignInWithAppleStyle;
+    /** What to ask for: `onRequest` on iOS. Both scopes by default. */
+    scopes?: ('fullName' | 'email')[];
+    nonce?: string;
+    state?: string;
+    /** The credential, or the error (`cancelled: …` when the viewer dismissed the sheet). */
+    onCompletion: (result: {
+        credential: AppleIDCredential;
+        error?: undefined;
+    } | {
+        credential?: undefined;
+        error: Error;
+    }) => void;
+}
+export declare function SignInWithAppleButton(props: SignInWithAppleButtonProps): ReactNode;
+//# sourceMappingURL=appleSignIn.d.ts.map

package/dist/appleSignIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appleSignIn.d.ts","sourceRoot":"","sources":["../src/appleSignIn.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAElG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAO7D,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;IAClC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAItG;AAED,kHAAkH;AAClH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAItF;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,CAAC;AAEtE,MAAM,WAAW,0BAA2B,SAAQ,aAAa;IAC/D,kEAAkE;IAClE,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,yDAAyD;IACzD,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,YAAY,EAAE,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG;QAAE,UAAU,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;CACjI;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,SAAS,CA0BlF"}

package/dist/components/geometry.d.ts

@@ -90,7 +90,12 @@ export interface GeometryChangeSpec<T> {
  * reports its size (and its frame on screen once the transform reads it,
  * kept current as the page scrolls) without changing its layout; the
  * action runs after the render that heard a change, as SwiftUI's does, so it
- * may set state. A function form is called with the proxy on every change.
+ * may set state. It runs in the commit (a layout effect), before anything is
+ * painted: state it sets renders and lays out synchronously, so a layout
+ * that depends on its own measurement settles within the frame, as a
+ * `GeometryReader`'s does in SwiftUI, instead of one round per frame with
+ * the page painting each. A function form is called with the proxy on
+ * every change.
  */
 export declare function GeometryChangeView({ handler, children }: {
     handler: GeometryChangeHandler;

package/dist/components/geometry.d.ts.map

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

package/dist/environment.d.ts

@@ -1,9 +1,9 @@
 /**
  * Environment values: what a modifier on a container passes to the views
  * below it (`.buttonStyle`, `.controlSize`…), and the device environment the
- * page sets (color scheme, Dynamic Type size).
+ * page sets (color scheme, Dynamic Type size, size class, scene phase).
  */
-import type { ButtonStyle, ColorScheme, DynamicTypeSize, PickerStyle, ToggleStyle } from '@swiftbrowser/web/src/protocol';
+import type { ButtonStyle, ColorScheme, DynamicTypeSize, PickerStyle, ScenePhase, ToggleStyle } from '@swiftbrowser/web/src/protocol';
 import { type ReactNode } from 'react';
 export type ControlSize = 'mini' | 'small' | 'regular' | 'large' | 'extraLarge';
 /** `.symbolRenderingMode(_:)`: `palette` draws a symbol's layers in the foreground styles' levels. */
@@ -52,7 +52,15 @@ export interface Environment {
     dynamicTypeSize: DynamicTypeSize;
     /** `compact` below 700 points of width (an iPhone), `regular` from it (an iPad, a desktop window). */
     horizontalSizeClass: HorizontalSizeClass;
+    /**
+     * `active` while the app is in front and takes input, `inactive` while it
+     * shows but does not (the app switcher, a system sheet over it, a page
+     * whose window lost focus), `background` while it is not shown (a hidden
+     * tab, an app the viewer left). `active` where nothing says otherwise.
+     */
+    scenePhase: ScenePhase;
 }
+export type { ScenePhase };
 export declare const EnvironmentContext: import("react").Context<Environment>;
 export declare function EnvironmentProvider({ value, children }: {
     value: Environment;
@@ -67,6 +75,12 @@ export declare const DismissContext: import("react").Context<(() => void) | null
 export declare function useDismiss(): () => void;
 /** `@Environment(\.horizontalSizeClass)` */
 export declare function useHorizontalSizeClass(): HorizontalSizeClass;
+/**
+ * `@Environment(\.scenePhase)`: `active`, `inactive` or `background`. A
+ * page follows the document's visibility and the window's focus; the native
+ * app follows its scene. Refresh what time moved on when it turns `active`.
+ */
+export declare function useScenePhase(): ScenePhase;
 /** `@Environment(\.redactionReasons)`: whether the views below are placeholders. */
 export declare function useRedacted(): boolean;
 //# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

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

package/dist/fileExporter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `.fileExporter(isPresented:document:contentType:defaultFilename:…)`: the
+ * document goes where the viewer chooses. A page shows a save dialog where
+ * the browser has one (the File System Access API) and downloads the file
+ * elsewhere; the native app shows the document picker (the Files app). Set
+ * `isPresented` from a button's action, as a dialog opens only within a tap.
+ * `onCompletion` gets where it went (`saved` or `downloaded`, with the
+ * host's URLs where it knows them); a dismissed dialog calls `onCancellation`.
+ */
+import { type ExportFilesResult } from '@swiftbrowser/web/src/hostRequests';
+import { type ReactNode } from 'react';
+import { type BindingValue } from './binding';
+export type { ExportFilesResult };
+/** What a `fileExporter` writes: text, bytes or a Blob; a `File` brings its own name and type. */
+export type ExportDocument = string | Uint8Array | ArrayBuffer | Blob;
+export interface FileExporterModifier {
+    isPresented: BindingValue<boolean>;
+    /** The document, or several; `null` presents nothing (the exporter closes at once). */
+    document: ExportDocument | ExportDocument[] | null;
+    /** The MIME type (`text/plain`), for a document that is not a typed Blob. */
+    contentType?: string;
+    /** The name offered (`Notes.txt`); the type's extension is added when the name has none. `Untitled` by default. */
+    defaultFilename?: string;
+    onCompletion?: (result: ExportFilesResult) => void;
+    onCancellation?: () => void;
+    onError?: (error: unknown) => void;
+}
+/** The file a document is exported as: named, typed, with the type's extension when the name has none. */
+export declare function exportFile(document: ExportDocument, contentType: string | undefined, defaultFilename: string | undefined, index?: number): File;
+export declare function FileExporterPresenter(spec: FileExporterModifier): ReactNode;
+//# sourceMappingURL=fileExporter.d.ts.map

package/dist/fileExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileExporter.d.ts","sourceRoot":"","sources":["../src/fileExporter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,uFAAuF;IACvF,QAAQ,EAAE,cAAc,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC;IACnD,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mHAAmH;IACnH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAgBD,0GAA0G;AAC1G,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,IAAI,CAS1I;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,CA+B3E"}

package/dist/fileManager.d.ts

@@ -40,7 +40,7 @@ export interface FileManager {
     createDirectory(url: string): Promise<void>;
     /** `fileExists(atPath:)`. */
     fileExists(url: string): Promise<boolean>;
-    /** `attributesOfItem(atPath:)`: the size, the modification time where known, and whether it is a directory; fails `notFound: …`. */
+    /** `attributesOfItem(atPath:)`: the size, the modification and creation times where known, whether it is a directory, and the MIME type its extension names; fails `notFound: …`. */
     attributesOfItem(url: string): Promise<FileAttributes>;
     /** `moveItem(at:to:)`: to a URL nothing is at, in a directory that exists. */
     moveItem(from: string, to: string): Promise<void>;
@@ -48,8 +48,23 @@ export interface FileManager {
     copyItem(from: string, to: string): Promise<void>;
     /** `removeItem(at:)`: a file, or a directory and all it holds. */
     removeItem(url: string): Promise<void>;
-    /** A URL the page can load the file at (an object URL of its bytes; natively the URL itself). */
+    /** A URL the page can load the file at (an object URL of its bytes; natively the URL itself, downloaded from iCloud Drive first). */
     loadURL(url: string): Promise<string>;
+    /**
+     * `FileManager.url(forUbiquityContainerIdentifier:)`, then `Documents`: the
+     * app's folder in iCloud Drive, where the app has the iCloud entitlement
+     * (`swiftbrowser native init --icloud`) and the viewer iCloud Drive. The
+     * files there follow the viewer to their other devices and show in the
+     * Files app. Null without it, and on a page. Reading a file another device
+     * wrote downloads it first.
+     */
+    iCloudDirectory(): Promise<string | null>;
+    /**
+     * Calls `listener` with the URLs that changed: what this app wrote, and
+     * natively what another device wrote to iCloud Drive. Returns a function
+     * that stops listening. `useFileStorage` reads a file again on it.
+     */
+    watch(listener: (urls: string[]) => void): () => void;
 }
 /** A file manager over the host `host` answers (the environment's, looked up at each call, for the default). */
 export declare function createFileManager(host: () => FilesHost | undefined): FileManager;

package/dist/fileManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileManager.d.ts","sourceRoot":"","sources":["../src/fileManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAI9F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,qDAAqD;IACrD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iFAAiF;IACjF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,+DAA+D;IAC/D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6BAA6B;IAC7B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,oIAAoI;IACpI,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,kEAAkE;IAClE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iGAAiG;IACjG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAmBD,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,CAwChF;AAED,sFAAsF;AACtF,eAAO,MAAM,WAAW,EAAE,WAA+D,CAAC"}
+{"version":3,"file":"fileManager.d.ts","sourceRoot":"","sources":["../src/fileManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAI9F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,qDAAqD;IACrD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,yFAAyF;IACzF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iFAAiF;IACjF,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,+DAA+D;IAC/D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6BAA6B;IAC7B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,qLAAqL;IACrL,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,kEAAkE;IAClE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,qIAAqI;IACrI,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC;;;;;;;OAOG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvD;AAmBD,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,CA0ChF;AAED,sFAAsF;AACtF,eAAO,MAAM,WAAW,EAAE,WAA+D,CAAC"}

package/dist/fileStorage.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `useFileStorage(url, default)`: a value kept as a JSON file through
+ * `fileManager`, the way `useAppStorage` keeps one under a key. The file is
+ * read when the URL is given (the default stands in until then, and where
+ * there is no file yet), written on each set, and read again when
+ * `fileManager.watch` says it changed: another view wrote it, or another
+ * device did, in iCloud Drive. A document app keeps its documents this way:
+ * put the file in `iCloudDirectory()` where there is one, in
+ * `documentsDirectory` elsewhere, and it is the same code on both.
+ */
+import { type FileManager } from './fileManager';
+export interface FileStorageOptions<T> {
+    /** What a stored value becomes on load: a migration from what an older version wrote. A throw falls back to the default. */
+    decode?: (stored: unknown) => T;
+    /** A read or write that failed (the file could not be downloaded, the storage is full). */
+    onError?: (error: unknown) => void;
+    /** The file manager; `fileManager` by default. */
+    manager?: FileManager;
+}
+/** The new value, or a function of the current one, as `useState`'s setter takes. */
+export type FileStorageSetter<T> = (value: T | ((current: T) => T)) => void;
+/** `loading` until the file was read (or found missing); `ready` after; `error` when the read failed (the default stands). */
+export type FileStorageStatus = 'loading' | 'ready' | 'error';
+export declare function useFileStorage<T>(url: string | null, defaultValue: T | (() => T), options?: FileStorageOptions<T>): [T, FileStorageSetter<T>, FileStorageStatus];
+//# sourceMappingURL=fileStorage.d.ts.map

package/dist/fileStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileStorage.d.ts","sourceRoot":"","sources":["../src/fileStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,4HAA4H;IAC5H,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC;IAChC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,kDAAkD;IAClD,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;AAE5E,8HAA8H;AAC9H,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAqFpK"}

package/dist/geolocation.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `useGeolocation(options)`: the viewer's position through the Geolocation
+ * API, which a page has from the browser and a native app from the runtime
+ * (`navigator.geolocation` over `CLLocationManager`; the app's Info.plist
+ * names `NSLocationWhenInUseUsageDescription`). Nothing is asked until
+ * `request()` (the first ask prompts the viewer), unless `immediate` is set;
+ * `watch` keeps following the position until the view goes.
+ */
+export interface GeolocationFix {
+    latitude: number;
+    longitude: number;
+    /** Meters. */
+    accuracy: number;
+    altitude: number | null;
+    heading: number | null;
+    speed: number | null;
+    /** Milliseconds since the epoch. */
+    timestamp: number;
+}
+export type GeolocationStatus = 'idle' | 'locating' | 'located' | 'denied' | 'failed';
+export interface GeolocationOptions {
+    /** Keep following the position (`watchPosition`) instead of asking once. */
+    watch?: boolean;
+    /** Ask as soon as the view appears. */
+    immediate?: boolean;
+    enableHighAccuracy?: boolean;
+    /** Milliseconds to wait for a fix. */
+    timeout?: number;
+    maximumAge?: number;
+}
+export interface GeolocationState {
+    /** Whether the environment has `navigator.geolocation`. */
+    available: boolean;
+    status: GeolocationStatus;
+    /** The latest fix, kept across a later failure. */
+    position: GeolocationFix | null;
+    error: string | null;
+    /** Asks (again); with `watch`, starts following. */
+    request(): void;
+    /** Stops a watch; the position stays. */
+    stop(): void;
+}
+export declare function useGeolocation(options?: GeolocationOptions): GeolocationState;
+//# sourceMappingURL=geolocation.d.ts.map

package/dist/geolocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.d.ts","sourceRoot":"","sources":["../src/geolocation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtF,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,OAAO,IAAI,IAAI,CAAC;IAChB,yCAAyC;IACzC,IAAI,IAAI,IAAI,CAAC;CACd;AAqBD,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,CA6DjF"}

package/dist/index.d.ts

@@ -9,13 +9,14 @@ export { SwiftUIView, type SwiftUIViewProps } from './island';
 export { useContextBridge } from './bridge';
 export type { Binding, BindingValue } from './binding';
 export { readBinding } from './binding';
-export { useColorScheme, useDynamicTypeSize, useHorizontalSizeClass, useRedacted, type HorizontalSizeClass, useDismiss, useViewEnvironment, type ControlSize, type SymbolRenderingMode, type KeyboardType, type TextContentType, type TextInputHints, type Environment, type ViewEnvironment, } from './environment';
+export { useColorScheme, useDynamicTypeSize, useHorizontalSizeClass, useScenePhase, useRedacted, type HorizontalSizeClass, type ScenePhase, useDismiss, useViewEnvironment, type ControlSize, type SymbolRenderingMode, type KeyboardType, type TextContentType, type TextInputHints, type Environment, type ViewEnvironment, } from './environment';
 export { useNavigation } from './navigation-context';
-export type { ViewModifiers, ForegroundLayers, BackgroundValue, SearchableModifier, ToolbarItemPlacementName, ToolbarRole, CoordinateSpaceValue, DragGestureModifier, DragValue, GestureValue, TapGestureModifier, MagnifyGestureModifier, RotateGestureModifier, PinchValue, SwipeActionsModifier, AlignmentGuideName, DropDestinationModifier, InspectorModifier, ContainerAxes, ContainerRelativeFrameValue, } from './modifiers';
+export type { ViewModifiers, ForegroundLayers, BackgroundValue, SearchableModifier, ToolbarItemPlacementName, ToolbarRole, CoordinateSpaceValue, DragGestureModifier, DragValue, GestureValue, TapGestureModifier, MagnifyGestureModifier, RotateGestureModifier, PinchValue, TouchPoint, TouchesPhase, TouchesHandler, SwipeActionsModifier, AlignmentGuideName, DropDestinationModifier, InspectorModifier, ContainerAxes, ContainerRelativeFrameValue, } from './modifiers';
 export { VisualEffect, type ScrollTransitionClosure, type ScrollTransitionPhase, type ScrollTransitionSpec, type VisualEffectClosure, } from './visualEffect';
 export type { ContentMarginsValue, ScrollEdgeEffectHiddenValue, ScrollEdgeEffectStyle, ScrollEdgeEffectStyleValue, ScrollEdges } from './scrollEnvironment';
 export type { SheetModifier, AlertModifier, DetentValue } from './presentation';
 export type { FileImporterModifier } from './fileImporter';
+export { exportFile, type ExportDocument, type ExportFilesResult, type FileExporterModifier } from './fileExporter';
 export * from './values';
 export { Path, type CGRect, type Point } from './path';
 export { AttributedText, type AttributedRun, type RunFont, type TextAttributes, type TextSelection } from './attributedText';
@@ -23,7 +24,12 @@ export { measureText, canMeasureText, installTextMeasurer, type TextMeasurement,
 export { ScrollViewReader, type ScrollPoint, type ScrollPositionBinding, type ScrollViewProxy, type ScrollPositionValue } from './scrollReader';
 export { useAudioRecorder, type AudioRange, type AudioRecorder, type AudioRecorderOptions, type AudioRecorderStatus, type AudioRecording } from './audioRecorder';
 export { useCoordinateSpaces } from './coordinateSpace';
+export { useWakeLock } from './wakeLock';
+export { SignInWithAppleButton, signInWithApple, appleCredentialState, canSignInWithApple, configureSignInWithApple, type AppleCredentialState, type AppleIDCredential, type SignInWithAppleButtonProps, type SignInWithAppleLabel, type SignInWithAppleOptions, type SignInWithAppleStyle, } from './appleSignIn';
+export { useGeolocation, type GeolocationFix, type GeolocationOptions, type GeolocationState, type GeolocationStatus } from './geolocation';
+export { useSpeechSynthesis, useSpeechRecognition, type SpeakOptions, type SpeechSynthesisState, type SpeechRecognitionOptions, type SpeechRecognitionState } from './speech';
 export { useAppStorage, appStorage, type AppStorageOptions, type AppStorageSetter, type AppStorageStore } from './appStorage';
+export { useFileStorage, type FileStorageOptions, type FileStorageSetter, type FileStorageStatus } from './fileStorage';
 export { fileManager, createFileManager, type FileAttributes, type FileContents, type FileDirectories, type FileManager } from './fileManager';
 export { UndoManager, UndoManagerContext, useUndoManager, type UndoHost, type UndoManagerOptions, type UndoOptions, type UndoState } from './undo';
 export * from './components/stacks';

package/dist/index.d.ts.map

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