@phreshos/client 0.1.18 → 0.1.19

package/README.md

@@ -180,25 +180,21 @@ two independent operations and can expose an intermediate state remotely.
 An `under` or `over` representation may request one local host-rendered Surface:
 
 ```ts
-await current.window.local.surface.set({
-  opacity: 0.65,
-  radius: "large"
-}, { duration: 240, easing: "ease-out", wait: true })
+await current.window.local.surface.set({ duration: 240, easing: "ease-out", wait: true })
 
-await current.window.local.surface.remove()
+await current.window.local.surface.remove({ duration: 180, easing: "ease-in" })
 ```
 
 The desktop holds local state only for the lifetime of that iframe
 representation. Reloading or destroying it resets the representation from
 authoritative truth, while other desktops remain unaffected. Program code may
-synchronize desired settings through its Server and explicitly apply them
-again. `set()` with no settings creates a sharp, fully opaque Surface.
-Opacity is a finite number from `0` through `1`; zero retains the Surface node.
-Radius accepts a nonnegative pixel number, a Theme-derived `ScaleLevel`, or
-`"full"`. Only `remove()` restores exact `null` and immediately removes the
-node. The optional transaction uses milliseconds and a stable named or cubic
-Bézier easing; the desktop performs the motion, honors reduced motion, and does
-does not restore anything when a new iframe representation begins. The sharp
+synchronize desired presence through its Server and explicitly apply it
+again. `set()` and `remove()` accept only a required `VisibilityTransition`;
+Programs cannot configure the host Surface's material, opacity, or radius.
+The transition uses milliseconds and a stable named or cubic Bézier easing;
+the desktop performs the motion, honors reduced motion, and removes the Surface
+only after its exit transition completes. `wait: true` makes the request settle
+with that transition. A new iframe representation restores nothing. The
 container follows the iframe geometry while the independently rounded Surface
 neither clips nor masks Client content. `window` and `wallpaper` layers reject
 the capability.

package/dist/domain.js

@@ -308,10 +308,12 @@ class LocalWindowSurfaceHandle {
     constructor(target) {
         this.target = target;
     }
-    async set(settings = {}, transaction) {
-        await wire.request(["windowLocalSurfaceSet", await this.target(), settings, transaction]);
+    async set(transition) {
+        await wire.request(["windowLocalSurfaceSet", await this.target(), transition]);
+    }
+    async remove(transition) {
+        await wire.request(["windowLocalSurfaceRemove", await this.target(), transition]);
     }
-    async remove() { await wire.request(["windowLocalSurfaceRemove", await this.target()]); }
 }
 function deferredScoped(route, target, convert) {
     return [

package/dist/main.d.ts

@@ -5,4 +5,4 @@ export { current, type Current, type CurrentServer } from "./current.js";
 export { type Channel, type ChannelCapture, type ChannelEvents, type ChannelMessage } from "./channel.js";
 export { ClientServiceHandler, ServerServiceHandler, ServiceHandler, type ClientServiceChannel, type ServerServiceChannel, type ServiceChannel, type ServiceKey, type ServiceLifecycleEvents } from "@phreshos/core";
 export { Client, Endpoint, Process, Program, Server, type Window, type ProgramProcess, type AnswerCapture, type AnswerMessage, type AnswerObserver, type AskCapture, type AskMessage, type AskObserver, type ClientTraffic, type EndpointTraffic, type ServerTraffic, type TrafficCapture, type TrafficEvents, type TrafficMessage } from "./domain.js";
-export type { Askable, Capture, Captures, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, PermissionDecision, Permission, Position, Storage, ProgramEvents, ProgramProcessEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TimedPermission, Timeoutable, Theme, ThemeEvents, ThemeProperties, Value, WritableTheme, WindowEvents, WindowGeometry, WindowLayer, WindowState, Easing, LocalWindow, LocalWindowSurface, SurfaceSettings, Transaction } from "@phreshos/core";
+export type { Askable, Capture, Captures, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, PermissionDecision, Permission, Position, Storage, ProgramEvents, ProgramProcessEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TimedPermission, Timeoutable, Theme, ThemeEvents, ThemeProperties, Value, WritableTheme, WindowEvents, WindowGeometry, WindowLayer, WindowState, Easing, LocalWindow, LocalWindowSurface, VisibilityTransition, Transaction } from "@phreshos/core";

package/dist/wire.js

@@ -12,7 +12,6 @@ class Wire {
     impossible = new Map();
     identityPromise = null;
     constructor() {
-        this.send("boundary", "document", crypto.randomUUID());
         window.addEventListener("message", event => {
             if (event.source !== this.parent || !Array.isArray(event.data))
                 return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -47,13 +47,13 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.14"
+    "@phreshos/core": "^0.1.15"
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.14",
+    "@phreshos/core": "^0.1.15",
     "typescript": "^6.0.3"
   }
 }