@swiftbrowser/react 0.17.7 → 0.18.0

package/README.md

@@ -34,6 +34,25 @@ worker resolves from its sources.
 
 ## Getting started
 
+### A new app
+
+One command lays out an app that runs the same code on iOS and the web:
+
+```sh
+npx @swiftbrowser/cli native init MyApp
+cd MyApp && npm install
+npm run dev:web      # the app as a web page, at http://localhost:5175/
+npm run build        # ios/app.js, the bundle MyApp.xcodeproj runs natively
+```
+
+The app is `src/App.tsx`, beside `ios/` (the Xcode target's folder: the
+App file, the asset catalog and the bundle), `web/` and `MyApp.xcodeproj`,
+as React Native lays its shells out. `src/index.tsx` is the iOS entry (`run(<App />)`
+in a [SwiftBrowser Native](https://github.com/noya-app/SwiftBrowser/blob/main/Native/README.md)
+app, where the views are real SwiftUI) and `web/main.tsx` the web entry
+(`mount(...)` in a Vite page, where this package's renderer draws them);
+neither holds app code. The rest of this section is what those entries do.
+
 ### A whole page
 
 The simplest app is a page whose root is a SwiftUI tree. The page provides
@@ -168,7 +187,7 @@ identically. A modifier that must apply twice goes in `modifiers={[…]}`, an
 ordered list. A layered style is an array: `foregroundStyle={['white',
 'indigo']}` is `.foregroundStyle(.white, .indigo)`, whose second style a
 `symbolRenderingMode="palette"` symbol draws its disc in. The environment
-modifiers (`buttonStyle`, `controlSize`, `pickerStyle`, `labelsHidden`,
+modifiers (`buttonStyle`, `controlSize`, `pickerStyle`, `toggleStyle`, `labelsHidden`,
 `symbolRenderingMode`) are React contexts the views below read, and
 `navigationTitle`, `toolbar`, `toolbarRole`, `searchable`, `sheet`, `alert`,
 `presentationDetents` and `preferredColorScheme` attach to the enclosing
@@ -203,6 +222,52 @@ When the renderer sends an event (a tap, a switch, a selection), the
 handler's state updates render synchronously and the renderer gets the next
 pass inside the event, the way the Swift core answers one.
 
+`TextEditor` also edits `AttributedText`, SwiftUI's `AttributedString` in
+`TextEditor(text:selection:)`: runs of `{ text, bold, italic, underline,
+strikethrough, foregroundColor, backgroundColor, font }` (`backgroundColor`
+a highlight behind the run, `font` its own `{ size, weight, design }` over
+the editor's). What the viewer types takes the
+attributes of what it replaced, else of the character before it, and the
+formatting the native editor's own edit menu applies (iOS 26's Bold,
+Italic, Underline) comes back into the text. A `selection` binding, on a
+plain or an attributed editor, gets the viewer's selection in UTF-16
+offsets, so a Bold button can set `AttributedText.settingAttributes(text,
+start, end, { bold: true })` on it; a selection the app sets moves the
+caret (when the app focuses the editor, if it is not focused).
+`.scrollDisabled` makes an editor as tall as its lines, for one in a
+scrolling page:
+
+```tsx
+const [text, setText] = useState<AttributedText>([{ text: 'Hello ' }, { text: 'world', bold: true }]);
+const [selection, setSelection] = useState<TextSelection>({ start: 0, end: 0 });
+<TextEditor text={[text, setText]} selection={[selection, setSelection]} scrollDisabled />
+```
+
+`TextField` and `TextEditor` take `onDeleteBackward`, which SwiftUI has no
+modifier for: Backspace with nothing selected and the caret at the start of
+the text (an empty field included) deletes nothing and runs it, so a
+paragraph editor can merge the paragraph into the one before it.
+
+`measureText(text, font, width)` is the size a `Text` of `text` in `font`
+(a text style name or `system(size, weight, design)`) takes wrapped to
+`width` points: `{ width, height, lines }`, answered synchronously by the
+renderer's typography on the web and by the host's text system natively
+(`canMeasureText()` says whether something answers yet), for an app that
+paginates or sizes from its text.
+
+A field's `focused` is `.focused($isFocused)`: a boolean binding the field
+follows and sets. With `focusedValue` it is `.focused($field, equals:)`:
+one binding of the focused field's value (null for none) shared by the
+fields, each naming its own. What a handler for `onSubmit` sets wins over
+the keyboard's dismissal (the same field again keeps it, another takes it),
+and a field that takes the focus is scrolled into view:
+
+```tsx
+const [field, setField] = useState<'username' | 'password' | null>('username');
+<TextField placeholder="Username" text={[name, setName]} focused={[field, setField]} focusedValue="username" onSubmit={() => setField('password')} />
+<SecureField placeholder="Password" text={[password, setPassword]} focused={[field, setField]} focusedValue="password" onSubmit={signIn} />
+```
+
 ### Navigation and presentation
 
 `NavigationStack` holds the pushed values (or takes a `path` binding).
@@ -212,7 +277,11 @@ directly. A pushed screen's title takes the display mode of the screen below
 it unless it sets its own (large below a large title), as on iOS. `TabView`
 holds `Tab`s, each with a `systemImage` or an asset catalog `image` (a custom
 symbol) for its bar item. `.sheet` and `.alert` are modifiers whose
-content and actions render as root-level elements while presented;
+content and actions render as root-level elements while presented (an
+alert's `actions` take a `TextField` beside the `Button`s, drawn in the
+card above them: `alert={{ title: 'Rename', isPresented, actions: <><TextField
+text={[name, setName]} /><Button title="Cancel" role="cancel" /><Button
+title="Rename" action={rename} /></> }}`);
 `presentationDetents` inside a sheet sets its detents. `useDismiss()` inside
 a pushed screen or a sheet pops or dismisses it.
 
@@ -269,6 +338,10 @@ swapped item (`{playing ? <ToolbarItem>…stop…</ToolbarItem> :
 `placement="largeTitle"` (iOS 26) puts a view in the large title row in
 place of the title's text, a logo beside the screen's name say; it scrolls
 away with the content and the bar shows `navigationTitle` once it has.
+`placement="keyboard"` is the bar above the keyboard while a text input of
+the screen is being edited (a formatting bar, a Done button), its items in
+a row from the leading edge, a `Spacer` pushing the rest to the trailing
+edge; it is hidden while nothing in the screen is being edited.
 
 ```tsx
 <List
@@ -352,13 +425,37 @@ view scrolls under, or leaves it.
 Name a coordinate space with `coordinateSpace="page"` on the `ScrollView`
 (or any view), and a `GeometryReader` inside reads its frame there with
 `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
+that reports in an effect.
+
+`onScrollGeometryChange` on a `ScrollView` is `.onScrollGeometryChange`:
+a function hears the scroll view's `ScrollGeometry` (`contentOffset`,
+`contentSize`, `containerSize`, `contentInsets`, `visibleRect`) on every
+change, once per frame as it scrolls; `{ of, action }` calls `action(value,
+oldValue)` only when `of(geometry)` answers differently, so an app that
+watches the content size alone is not rendered per frame. A
+`scrollPosition` binding set to a point (`{ x, y }`, an axis left out
+keeping its offset) scrolls there, as `ScrollPosition.scrollTo(x:y:)`
+does, smoothly inside `withAnimation`; so does `proxy.scrollTo({ x, y })`
+for the scroll views inside a reader. The binding reads back as ids, never
+as a point. `pinnedViews={['sectionHeaders']}` on a `LazyVStack`,
+`LazyHStack`, `LazyVGrid` or `LazyHGrid` keeps each `Section`'s header at
+the scroll view's edge while its section passes (`'sectionFooters'` too);
+a string header pins as a text. The Showcase's Numbers lays a
+spreadsheet's frozen letters, numbers and header cells over a
+`ScrollView axes="both"` this way, moved by the offset it reports.
 
 `scrollTransition` draws effects as a view leaves the visible area of its
 scroll view and comes back. The closure gets the effect to build on and the
 phase (`topLeading`, `identity` or `bottomTrailing`, with `value` -1, 0 or
-1). By default the effect follows the scrolling, drawn partway while the
-view is partly out; `configuration: 'animated'` switches phases with an
-animation instead. `containerRelativeFrame` sizes a view against the scroll
+1); it runs once per phase, and the renderer draws the three effects as the
+view scrolls (natively, SwiftUI's own `.scrollTransition`), so they follow
+the finger without a round trip to the app. By default the effect follows
+the scrolling, drawn partway while the view is partly out;
+`configuration: 'animated'` switches phases with an animation instead.
+`scrollIndicators="hidden"` hides a scroll view's indicators (a pager's). `containerRelativeFrame` sizes a view against the scroll
 view's visible area, so a carousel of cards is:
 
 ```tsx
@@ -397,7 +494,8 @@ systemName="star.fill" /> }`) come back from `resolveSymbol` and draw with
 `drawSymbol` at a point, under the context's transform and opacity; they are
 real views laid over the canvas, so they draw above its other commands. `useAVPlayer(url)` is an `AVPlayer` (play, pause, seek,
 mute, volume, rate) that `VideoPlayer` shows in the page's `<video>`; the
-position is read or observed without re-rendering. A player shown by no
+position is read or observed without re-rendering, four times a second or
+as often as `{ report: 1 / 60 }` asks (a scrubber moving with the sound). A player shown by no
 view plays nothing, so an audio app (a playlist, a podcast) puts an
 `<AudioPlayer player={…} />` somewhere that stays mounted: the player at
 no size, out of the way of taps, playing on wherever the screens go.
@@ -409,6 +507,23 @@ has too (`@swiftbrowser/native`, "Now playing"). `Slider`'s `onEditingChanged` s
 ends, so a scrubber bound to the position can stop following it while the
 thumb is held.
 
+`useAudioRecorder()` records from the microphone as `AVAudioRecorder` does:
+`record()` asks for the microphone and starts, `pause()`, `resume()`,
+`stop()` (resolving with the recording's `url` and `duration`) and
+`cancel()`; while recording, `time` counts the seconds and `levels` holds
+the input's level at each tick (0…1, twenty a second), for a waveform. A
+refused microphone sets `error` (`permission: …`). A recording is a file in
+the app's `Documents/Recordings` (`fileManager`, below), on both sides: the
+page records with `MediaRecorder` into its IndexedDB home, the native app
+AAC with `AVAudioRecorder` into its sandbox, and `discard(url)` deletes the
+file. The URL plays with `useAVPlayer`. `trim(url, keep)` makes a new
+recording out of the parts of one in `keep` (`[{ start, end }]` in seconds,
+in order: one range trims to it, two around a range delete it), resolving
+with the new recording and leaving the original for the app to discard; the
+page cuts with the Web Audio API and writes WAV, the native app exports AAC
+with `AVAssetExportSession`. (A page that keeps no files answers `data:`
+URLs instead.)
+
 An image is inert, as a SwiftUI image is. `<AsyncImage url={…}
 webInteractions />` gives a remote picture the browser's own image
 interactions back: a long press's Save / Share / Copy on iOS, dragging it
@@ -443,6 +558,27 @@ chooser calls `onCancellation`:
                   onCompletion: ([file]) => upload(file) }} />
 ```
 
+### Gestures
+
+`onTapGesture`, `dragGesture`, `magnifyGesture`, `rotateGesture` and
+`onLongPressGesture` are the gestures as modifiers, and they compose as
+SwiftUI's do: the innermost gesture whose motion matches wins, so a draggable
+item inside a tappable canvas keeps its drag. `simultaneousGesture={{
+dragGesture: { … } }}` runs a gesture beside the others instead (it begins
+when its own `minimumDistance` is met and ends when the pointer lifts,
+whoever owns the pointer), and `highPriorityGesture={{ … }}` asks one before
+the gestures of the views inside it; both take the gesture as the modifier
+it would otherwise be. A drag's `location` and `startLocation` are in the
+view's own space unless the gesture names another: `coordinateSpace:
+'global'`, or `{ named: 'canvas' }` for a space an ancestor set with
+`coordinateSpace="canvas"`, which is what moves an item under the finger
+without the item's own space moving along. `onTapGesture={{ count: 2, action
+}}` is a double tap; with a single tap on the same view (in `modifiers`, so
+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.
+
 ### Mouse, keyboard and effects
 
 A web app may have a mouse and a keyboard, so the modifiers SwiftUI keeps
@@ -465,10 +601,97 @@ countsDown } }` fixes the direction); the whole text rolls, not each digit.
 `opacity` and `interpolate` crossfade. `sensoryFeedback` vibrates where the
 device can.
 
+### Undo
+
+`useUndoManager()` is `@Environment(\.undoManager)`: the window's manager,
+with `NSUndoManager`'s rules. After a change, `registerUndo(name, undo)`
+registers what takes it back; run by `undo()`, the closure registers its own
+inverse the same way, which lands on the redo stack because the manager is
+undoing. A new registration drops what could be redone. `canUndo`,
+`canRedo`, `undoActionName` and `redoActionName` re-render the view as they
+change, so a toolbar's buttons follow the stack. Registrations in one event
+undo as one (`groupsByEvent`); `beginGrouping(name)`/`endGrouping()`, or
+`group(name, () => …)`, make several events one step; a registration with a
+`key` joins the group before it when it has the same key, so a run of
+keystrokes into one field (`key: \`text:${id}\``) undoes at once, until an
+undo or a change with another key. `removeAllActions(target)` forgets what a
+`target` registered (a document that closed); `levelsOfUndo` caps the stack.
+
+```tsx
+const undo = useUndoManager();
+const rename = (title: string) => {
+  const before = doc.title;
+  undo.registerUndo('Rename', () => rename(before)); // run as an undo, this registers the redo
+  setDoc({ ...doc, title });
+};
+<Button title="Undo" action={() => undo.undo()} disabled={!undo.canUndo} />
+```
+
+The stack lives in JavaScript, since its closures do and `canUndo` must
+change in the pass that registered them, and the system is told what it
+can do and sends its undo and redo to it: on a page, ⌘Z and ⇧⌘Z (Ctrl-Z,
+Ctrl-Shift-Z and Ctrl-Y off Apple platforms) while no text input has the
+focus (a focused field keeps the browser's own undo of its text); in a
+SwiftBrowser Native app, the window's `UndoManager` mirrors the stack, so
+the shake, the three-finger swipe, a keyboard's ⌘Z and the Edit menu reach
+it. `UndoManagerContext` gives an island a manager of its own.
+
+### App storage
+
+`useAppStorage(key, default)` is `@AppStorage`: a value kept under a key
+in the app's storage as JSON (`localStorage`: the browser's on a page, the
+device's in a SwiftBrowser Native app), read back at the next launch, and
+shared by every view that reads the key, so a write through any of them
+re-renders them all. It returns the value and a setter with `useState`'s
+shape; the default (a value, or a function making one) stands in while
+nothing is stored, and setting `undefined` removes the key. `decode`
+migrates what an older version saved; `onError` hears of a write the
+storage refused (a page's storage is full), which the app still keeps for
+the session; `store` swaps the storage for anything with `localStorage`'s
+shape.
+
+```tsx
+const [settings, setSettings] = useAppStorage('settings', { theme: 'system', size: 1 });
+<Picker title="Theme" selection={settings.theme} onChange={(theme) => setSettings({ ...settings, theme })}>…</Picker>
+```
+
+### Files
+
+`fileManager` is `FileManager.default`, with `URL.documentsDirectory` and
+its siblings: the app's own files, kept across launches. On a page they
+live in the app's IndexedDB database (the same iOS-like home a Swift app
+has there: `/data/Documents`, `/data/Library/Application Support`,
+`/data/Library/Caches`, and `/tmp` for the session); in a SwiftBrowser
+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`,
+`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`).
+
+```tsx
+const recordings = fileManager.url(fileManager.documentsDirectory, 'Recordings');
+await fileManager.createDirectory(recordings);
+const memo = fileManager.url(recordings, `${id}.m4a`);
+await fileManager.write(memo, blob);
+<AudioPlayer url={memo} /> // a VideoPlayer, AudioPlayer or Image loads a file: URL itself
+```
+
+A `VideoPlayer`, `AudioPlayer` or `Image` given a `file:` URL loads the file
+(on a page through an object URL of its bytes, which `loadURL` also
+answers; natively the URL as it is). `mount`'s `app` option names the
+database on a page (`sb-files:<app>`).
+
 ### Animation
 
 `withAnimation(animation, () => …)` animates the pass a state change makes,
 and the `animation` modifier a view's changes when a value changes.
+`withAnimation(animation, body, completion)` runs the completion once the
+pass has finished animating (`{ completionCriteria: 'removed' }` before
+the body waits for every effect to be gone); a body that renders nothing
+runs it at once.
 `PhaseAnimator` moves its content through phases, each change animated;
 `KeyframeAnimator` plays tracks of keyframes (`linear`, `cubic`, `spring`,
 `move`) and renders its content with the values each frame.
@@ -480,7 +703,8 @@ with their values in `x` and `y`: categories, numbers or dates. The
 component builds the scales and ticks the Swift Charts module builds
 (bands, nice numeric domains that include zero, calendar strides), groups
 lines and areas by series, colors `foregroundStyleBy` series from the chart
-palette with a legend, and places `annotation`s. `yAxisFormat` writes
+palette with a legend, puts bars of one `x` side by side by their
+`positionBy` (`.position(by:)`), and places `annotation`s. `yAxisFormat` writes
 the numeric axis's labels (`.chartYAxis { AxisMarks(format:) }`), as in
 `yAxisFormat={(v) => `$${v}`}`.
 
@@ -596,11 +820,14 @@ read with a hook). Props, callbacks and external stores need no bridging.
 ## What is covered
 
 - **Layout**: stacks, `LazyVStack`, `LazyHStack`, `Spacer`, `Divider`,
-  `ScrollView` (with `contentMargins` and scroll edge effects),
+  `ScrollView` (with `contentMargins`, scroll edge effects,
+  `onScrollGeometryChange` and a `scrollPosition` by id or point),
   `ScrollViewReader`, `Group`, `ForEach` (with `onDelete` and `onMove`),
-  `Grid`, `LazyVGrid`, `LazyHGrid`, `ViewThatFits`, `GeometryReader` (its
+  `Grid`, `LazyVGrid`, `LazyHGrid` (with `pinnedViews`), `ViewThatFits`,
+  `GeometryReader` (its
   size, its frame on screen or in a `coordinateSpace` named on an ancestor,
-  the visible bounds of its scroll view, and its safe-area insets), custom
+  the visible bounds of its scroll view, and its safe-area insets),
+  `onGeometryChange`, custom
   `Layout` (with `layoutValue`s, priorities, view spacing, explicit
   alignment guides and a cache), `containerRelativeFrame`, `safeAreaInset`.
 - **Content**: `Text` (with `Text + Text` runs, inline images, italic,
@@ -621,11 +848,13 @@ read with a hook). Props, callbacks and external stores need no bridging.
   links, a `path` binding, nested stacks flattened), `NavigationSplitView`,
   `TabView`/`Tab`, toolbars, search fields, sheets with detents, popovers
   (as sheets), alerts and dialogs, inspectors.
-- **Interaction**: `onTapGesture`, `dragGesture`, `magnifyGesture`,
-  `rotateGesture`, `onLongPressGesture`,
-  `contextMenu`, `draggable` and `dropDestination` (in the app, and text or
+- **Interaction**: `onTapGesture` (with `count`), `dragGesture` (with
+  `coordinateSpace`), `magnifyGesture`, `rotateGesture`,
+  `onLongPressGesture`, `simultaneousGesture`, `highPriorityGesture`,
+  `contentShape`, `contextMenu`, `draggable` and `dropDestination` (in the app, and text or
   files from outside the page), `onHover`, `help`, `pointerStyle`,
-  `keyboardShortcut`, `onKeyPress`, `sensoryFeedback`.
+  `keyboardShortcut`, `onKeyPress`, `sensoryFeedback`, `useUndoManager`,
+  `useAppStorage`, `fileManager`.
 - **Animation and effects**: `withAnimation`, `animation`, transitions,
   `PhaseAnimator`, `KeyframeAnimator`, `matchedGeometryEffect`,
   `symbolEffect`, `contentTransition`, `visualEffect`, `scrollTransition`,

package/dist/appStorage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `useAppStorage(key, default)`: SwiftUI's `@AppStorage`. A value kept under a
+ * key in the app's storage (`localStorage`: the browser's on a page, the
+ * device's in a SwiftBrowser Native app) as JSON, read back at the next
+ * launch, and shared by every view that reads the key: a write through any of
+ * them re-renders them all. The default stands in while nothing is stored,
+ * and setting `undefined` removes the key, as assigning nil does.
+ *
+ * The hook is the key's writer: it keeps what it read and re-reads storage
+ * only when another tab writes the key (the window's `storage` event). A
+ * write that storage refuses (a page's storage is full) still takes effect
+ * in the app, for the session, and is reported to `onError`.
+ */
+/** Where the values go: `localStorage`'s shape. */
+export interface AppStorageStore {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface AppStorageOptions<T> {
+    /** The storage; `localStorage` by default (memory where a page has none, or refuses it). */
+    store?: AppStorageStore;
+    /**
+     * What a stored value becomes on load: a migration from what an older
+     * version of the app saved. A throw falls back to the default. The readers
+     * of a key share one; the last to mount decides.
+     */
+    decode?: (stored: unknown) => T;
+    /** A write storage refused (out of room). The value is kept in memory regardless. */
+    onError?: (error: unknown) => void;
+}
+/** The new value, or a function of the current one, as `useState`'s setter takes. */
+export type AppStorageSetter<T> = (value: T | ((current: T) => T)) => void;
+/** The store `useAppStorage` uses when none is given. */
+export declare const appStorage: AppStorageStore;
+/**
+ * The value stored under `key`, or `defaultValue` (a value, or a function
+ * making one, as `useState` takes) while there is none, and its setter. The
+ * value must survive JSON: plain objects, arrays, strings, numbers,
+ * booleans, null.
+ */
+export declare function useAppStorage<T>(key: string, defaultValue: T | (() => T), options?: AppStorageOptions<T>): [T, AppStorageSetter<T>];
+//# sourceMappingURL=appStorage.d.ts.map

package/dist/appStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appStorage.d.ts","sourceRoot":"","sources":["../src/appStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,4FAA4F;IAC5F,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC;IAChC,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;AA0F3E,yDAAyD;AACzD,eAAO,MAAM,UAAU,EAAE,eAA8C,CAAC;AA2BxE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAE,iBAAiB,CAAC,CAAC,CAAM,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAoCvI"}

package/dist/attributedText.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Attributed text, SwiftUI's `AttributedString` as the rich `TextEditor`
+ * edits it (`TextEditor(text: $attributed, selection: $selection)`, iOS 26):
+ * runs of text, each with its own weight, slant, lines and color. Plain
+ * objects, so the text saves as JSON; the functions here are what an edit
+ * in the editor does to it.
+ */
+import type { FontDesign, FontWeight, TextRun } from '@swiftbrowser/web/src/protocol';
+import { type ColorValue } from './values';
+/** A run's own font over the editor's (`AttributedString`'s `font`): `Font.system(size:weight:design:)`'s parts, each optional. */
+export interface RunFont {
+    size?: number;
+    weight?: FontWeight;
+    design?: FontDesign;
+}
+export interface AttributedRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    /** The run's color, over the editor's foreground. */
+    foregroundColor?: ColorValue;
+    /** A color behind the run's glyphs (`backgroundColor`): a find highlight, say. */
+    backgroundColor?: ColorValue;
+    /** The run's size, weight or design over the editor's font (`bold` is the weight `bold` when the font names none). */
+    font?: RunFont;
+}
+export type AttributedText = readonly AttributedRun[];
+/** A range of an editor's text in UTF-16 offsets (JavaScript's string indices); `start === end` is the caret. */
+export interface TextSelection {
+    start: number;
+    end: number;
+}
+/** A run's attributes without its text. */
+export type TextAttributes = Omit<AttributedRun, 'text'>;
+/** The same text with no empty runs and no two alike side by side. */
+declare function normalized(text: AttributedText): AttributedText;
+/** The runs between two offsets, cut where they fall. */
+declare function slice(text: AttributedText, start: number, end?: number): AttributedText;
+/** The attributes of the character at `offset` (the last one's past the end; none in an empty text). */
+declare function attributesAt(text: AttributedText, offset: number): TextAttributes;
+/**
+ * `text` changed to read `next`, as a keystroke, a paste or a deletion in
+ * the editor changes it: the start and end that did not change keep their
+ * runs, and what was typed takes the attributes of what it replaced, else
+ * of the character before it (the first character's, typed at the start).
+ */
+declare function replacingCharacters(text: AttributedText, next: string): AttributedText;
+/** `text` with `change` over the characters between `start` and `end`. */
+declare function settingAttributes(text: AttributedText, start: number, end: number, change: TextAttributes): AttributedText;
+/** Whether every character between `start` and `end` has `key` on (false for an empty range). */
+declare function every(text: AttributedText, start: number, end: number, key: 'bold' | 'italic' | 'underline' | 'strikethrough'): boolean;
+/** The functions over attributed text, as `AttributedString`'s methods. */
+export declare const AttributedText: {
+    plain: (text: AttributedText) => string;
+    normalized: typeof normalized;
+    slice: typeof slice;
+    attributesAt: typeof attributesAt;
+    replacingCharacters: typeof replacingCharacters;
+    settingAttributes: typeof settingAttributes;
+    every: typeof every;
+    /** A text of one run. */
+    of: (text: string, attributes?: TextAttributes) => AttributedText;
+};
+/**
+ * The text the protocol's runs stand for (a `runs` event: the native
+ * editor's own Bold, Italic or Underline over the text), `protocolRuns`
+ * read back: a bold weight is `bold`, a line is on, a color is the run's,
+ * and a run's size, design and other weight are its `font`.
+ */
+export declare function fromProtocolRuns(runs: readonly TextRun[]): AttributedText;
+/** The protocol's runs for a text: a run's font over the editor's (bold is the weight `bold`), its lines and colors. */
+export declare function protocolRuns(text: AttributedText): TextRun[];
+export {};
+//# sourceMappingURL=attributedText.d.ts.map

package/dist/attributedText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributedText.d.ts","sourceRoot":"","sources":["../src/attributedText.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,mIAAmI;AACnI,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,sHAAsH;IACtH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,aAAa,EAAE,CAAC;AAEtD,iHAAiH;AACjH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAiCzD,sEAAsE;AACtE,iBAAS,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CASxD;AAED,yDAAyD;AACzD,iBAAS,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAW,GAAG,cAAc,CAUlF;AAED,wGAAwG;AACxG,iBAAS,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAO1E;AAED;;;;;GAKG;AACH,iBAAS,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAY/E;AAED,0EAA0E;AAC1E,iBAAS,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,cAAc,CAGnH;AAED,iGAAiG;AACjG,iBAAS,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO,CAGhI;AAED,2EAA2E;AAC3E,eAAO,MAAM,cAAc;kBAnGN,cAAc,KAAG,MAAM;;;;;;;IA2G1C,yBAAyB;eACd,MAAM,eAAc,cAAc,KAAQ,cAAc;CACpE,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,CAqBzE;AAED,wHAAwH;AACxH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,EAAE,CAa5D"}

package/dist/audioRecorder.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `useAudioRecorder()`: the microphone, as an iOS app records with
+ * `AVAudioRecorder`. `record()` asks for the microphone and starts; while it
+ * records the hook meters the input (`levels`, one 0…1 level per tick, for a
+ * waveform) and counts `time`; `stop()` resolves with the recording's URL
+ * (a `data:` URL on a page, a file natively) to play with `useAVPlayer`;
+ * `trim()` makes a new recording out of parts of one. The page records with
+ * `MediaRecorder` and cuts with the Web Audio API (Web/src/audioRecorder.ts);
+ * the native app answers with `AVAudioRecorder` and `AVAssetExportSession`
+ * (AudioRecorderBridge.swift).
+ */
+import type { AudioRange, AudioRecording } from '@swiftbrowser/web/src/audioRecorder';
+export type { AudioRange, AudioRecording };
+export type AudioRecorderStatus = 'idle' | 'starting' | 'recording' | 'paused' | 'stopping';
+export interface AudioRecorder {
+    /** Whether this page or app can record at all. */
+    available: boolean;
+    status: AudioRecorderStatus;
+    /** Seconds recorded so far (it holds while paused). */
+    time: number;
+    /** The input's level at each tick of this recording (0 silent … 1 loud), oldest first. */
+    levels: readonly number[];
+    /** Why the last call failed (`permission: …` when the microphone was refused), or null. */
+    error: string | null;
+    record(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    /** Ends the recording and resolves with it, or null when there was none. */
+    stop(): Promise<AudioRecording | null>;
+    /** Ends the recording and keeps nothing. */
+    cancel(): Promise<void>;
+    /** Deletes a recording `stop` made before (its file, natively), when the app deletes it. */
+    discard(url: string): Promise<void>;
+    /**
+     * A new recording made of the parts of `url` in `keep` (seconds, in
+     * order, concatenated): `[{ start, end }]` trims to that range, two parts
+     * around a range delete it. Resolves with the new recording (a `data:` URL
+     * on a page, a new file natively); the original is left as it was (the app
+     * discards it when it no longer wants it). Rejects with `unsupported: …`
+     * where the host cannot cut audio.
+     */
+    trim(url: string, keep: readonly {
+        start: number;
+        end: number;
+    }[]): Promise<AudioRecording>;
+}
+export interface AudioRecorderOptions {
+    /** Milliseconds between meter readings (50: twenty a second). */
+    meterInterval?: number;
+}
+export declare function useAudioRecorder(options?: AudioRecorderOptions): AudioRecorder;
+//# sourceMappingURL=audioRecorder.d.ts.map

package/dist/audioRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioRecorder.d.ts","sourceRoot":"","sources":["../src/audioRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAItF,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,4EAA4E;IAC5E,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACvC,4CAA4C;IAC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,4FAA4F;IAC5F,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAuHlF"}

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA6B,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWhF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAE,SAAS,OAAO,CAAC,OAAO,CAAC,EAAO,EAC1C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CASpC"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA6B,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAahF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAE,SAAS,OAAO,CAAC,OAAO,CAAC,EAAO,EAC1C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CASpC"}

package/dist/components/charts.d.ts

@@ -32,6 +32,11 @@ export interface BarMarkProps extends MarkCommon {
     cornerRadius?: number;
     /** `width: .fixed(points)` */
     width?: number;
+    /**
+     * `.position(by:)`: bars at the same `x` side by side, one slot of the
+     * band per value (in first-seen order across the chart's bars).
+     */
+    positionBy?: string;
 }
 export interface LineMarkProps extends MarkCommon {
     x: ChartValue;

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

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

package/dist/components/containers.d.ts

@@ -7,6 +7,7 @@ import type { GaugeStyle, HStackAlignment, VStackAlignment } from '@swiftbrowser
 import { type ReactNode } from 'react';
 import { type BindingValue } from '../binding';
 import { type ViewModifiers } from '../modifiers';
+import { type PinnedViews } from './stacks';
 export interface GaugeProps extends ViewModifiers {
     value: number;
     /** `in: 0...1` */
@@ -30,6 +31,8 @@ export interface LazyVStackProps extends ViewModifiers {
     spacing?: number | null;
     /** `.scrollTargetLayout()`: the children are the scroll view's snap points. */
     scrollTargetLayout?: boolean;
+    /** `pinnedViews: [.sectionHeaders]`: each `Section`'s header stays at the top while its rows scroll by. */
+    pinnedViews?: PinnedViews;
     children?: ReactNode;
 }
 /** `LazyVStack`: a `VStack` whose long `ForEach`es build their rows as they scroll into view. */
@@ -38,6 +41,8 @@ export interface LazyHStackProps extends ViewModifiers {
     alignment?: HStackAlignment;
     spacing?: number | null;
     scrollTargetLayout?: boolean;
+    /** `pinnedViews: [.sectionHeaders]`: each `Section`'s header stays at the leading edge while its cells scroll by. */
+    pinnedViews?: PinnedViews;
     children?: ReactNode;
 }
 export declare function LazyHStack(props: LazyHStackProps): ReactNode;

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

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