@swiftbrowser/react 0.26.2 → 0.26.3

package/dist/mount.d.ts

@@ -3,9 +3,10 @@
  * (the root container, element id 0, inside the device frame or full screen)
  * drawing a SwiftUI root. The page keeps the device chrome (theme, text size)
  * and tells both sides through `setEnvironment`; the size class follows the
- * root's width and the scene phase the document's visibility and focus.
+ * root's width, the scene phase the document's visibility and focus, and the
+ * platform (docs/notes/macos.md) the browser, unless the page says.
  */
-import { type ColorScheme, type DynamicTypeSize } from '@swiftbrowser/web/src/protocol';
+import { type ColorScheme, type DynamicTypeSize, type Platform } from '@swiftbrowser/web/src/protocol';
 import type { AssetCatalog } from '@swiftbrowser/web/src/assets';
 import { Renderer } from '@swiftbrowser/web/src/renderer';
 import type { ReactNode } from 'react';
@@ -13,6 +14,14 @@ import { type SwiftUIRoot } from './host/root';
 export interface MountOptions {
     colorScheme?: ColorScheme;
     dynamicTypeSize?: DynamicTypeSize;
+    /**
+     * The platform the app is drawn as (docs/notes/macos.md): `ios` or
+     * `macos`, or `auto` (the default), which is macOS in a browser with a
+     * fine pointer that can hover (a desktop) showing the root at 700 CSS px
+     * or more, and iOS otherwise. A preview page's device picker
+     * (`installDeviceFrame`) sets it afterwards from the device chosen.
+     */
+    platform?: Platform | 'auto';
     /** Device mode: the real safe-area insets (frame mode has the iPhone's). */
     safeArea?: {
         top: number;
@@ -56,11 +65,27 @@ export interface MountOptions {
 export interface Mounted {
     root: SwiftUIRoot;
     renderer: Renderer;
+    /** The device environment, for the renderer and the tree both (the page's theme toggle, a device picker's platform). */
     setEnvironment(environment: {
         colorScheme?: ColorScheme;
         dynamicTypeSize?: DynamicTypeSize;
+        platform?: Platform;
     }): void;
+    /** The renderer's (`installDeviceFrame` drives these). */
+    setSafeArea(insets: {
+        top: number;
+        leading: number;
+        bottom: number;
+        trailing: number;
+    } | null): void;
+    viewportChanged(): void;
     unmount(): void;
 }
+/**
+ * The platform `auto` decides for a root `width` CSS px wide: macOS with a
+ * fine pointer that hovers (a desktop browser) at the regular width, iOS
+ * otherwise. Width alone is no signal: a narrow desktop window is not a phone.
+ */
+export declare function decidePlatform(width: number, media?: (query: string) => boolean): Platform;
 export declare function mount(screen: HTMLElement, element: ReactNode, options?: MountOptions): Mounted;
 //# sourceMappingURL=mount.d.ts.map

package/dist/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAIjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrF,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,CAAC,WAAW,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAC;QAAC,eAAe,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC;IACpG,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAgFlG"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAIjE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrF,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,wHAAwH;IACxH,cAAc,CAAC,WAAW,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAC;QAAC,eAAe,CAAC,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;IACzH,0DAA0D;IAC1D,WAAW,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IACrG,eAAe,IAAI,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAsB,GAAG,QAAQ,CAExG;AAMD,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAwFlG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swiftbrowser/react",
-  "version": "0.26.2",
+  "version": "0.26.3",
   "type": "module",
   "description": "SwiftUI's components for React: a react-reconciler host that emits SwiftBrowser render ops into the @swiftbrowser/web renderer, so a pure React/TypeScript web app gets the same iOS UI as a SwiftUI app in the browser.",
   "repository": {
@@ -29,7 +29,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@swiftbrowser/web": "0.26.2"
+    "@swiftbrowser/web": "0.26.3"
   },
   "peerDependencies": {
     "react": "^19.0.0",