@phreshos/client 0.1.1 → 0.1.2

package/README.md

@@ -114,16 +114,10 @@ Promises confirm that the current Client host accepted and applied the local
 draft; they do not enter server authority or emit Window events.
 
 An `under` or `over` Client may own one authoritative host-rendered Surface.
-The capability remains silent until Program code explicitly reads, changes, or
-subscribes to it:
+The capability is command-only: Program code may change or remove it, but
+cannot read or subscribe to its server-owned state:
 
 ```ts
-const initial = await window.surface.snapshot()
-
-const stop = window.surface.subscribe("change", surface => {
-  // Future replacements only; subscriptions do not replay `initial`.
-})
-
 await window.surface.set({
   opacity: 0.65,
   radius: "large",
@@ -133,14 +127,14 @@ await window.surface.set({
 await window.surface.remove()
 ```
 
-The server stores the target beside its Window and broadcasts complete future
-replacements. `set()` with no settings creates a sharp, fully opaque Surface.
+The server stores the target beside its Window and delivers it internally to
+the desktop. `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
-not replay a stored transaction when restoring an initial snapshot. The sharp
+does not replay a stored transaction when restoring desktop state. The sharp
 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

@@ -230,30 +230,11 @@ class WindowHandle extends Events {
     async changeTitle(title) { await wire.request(["changeTitle", await this.target(), title]); }
     async raise() { await wire.request(["raise", await this.target()]); }
 }
-class WindowSurfaceHandle extends Events {
+class WindowSurfaceHandle {
     target;
     constructor(target) {
-        super((event, listener, impossible) => {
-            if (event !== "change") {
-                impossible?.(new Error(`A Window Surface has no "${String(event)}" event`));
-                return () => undefined;
-            }
-            return deferred(target, subject => wire.on("host-end", "surface", (...values) => {
-                const message = unscoped(subject, values);
-                if (message)
-                    listener(message[0]);
-            }, subject, impossible), impossible);
-        }, observer => deferred(target, subject => wire.on("host-end", "surface", (...values) => {
-            const message = unscoped(subject, values);
-            if (message)
-                observer("change", message[0]);
-        }, subject)));
         this.target = target;
     }
-    async snapshot() {
-        const answer = await wire.request(["window", await this.target()]);
-        return answer[0].surface;
-    }
     async set(settings = {}) { await wire.request(["surfaceSet", await this.target(), settings]); }
     async remove() { await wire.request(["surfaceRemove", await this.target()]); }
 }

package/dist/main.d.ts

@@ -4,4 +4,4 @@ export { type HostSurface, type Surface, type SurfaceEvents } from "./surface.js
 export { current, type Current, type CurrentServer } from "./current.js";
 export { type Channel, type ChannelCapture, type ChannelEvents, type ChannelMessage } from "./channel.js";
 export { Client, Endpoint, Process, Program, Server, type Window, 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, Permissions, Position, ProgramArea, ProgramEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TimedPermissions, Timeoutable, Theme, ThemeEvents, ThemeProperties, Value, WritableTheme, WindowEvents, WindowLayer, WindowState, WindowSurface, WindowSurfaceEasing, WindowSurfaceEvents, WindowSurfaceSettings, WindowSurfaceTransaction } 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, Permissions, Position, ProgramArea, ProgramEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TimedPermissions, Timeoutable, Theme, ThemeEvents, ThemeProperties, Value, WritableTheme, WindowEvents, WindowLayer, WindowState, WindowSurface, WindowSurfaceEasing, WindowSurfaceSettings, WindowSurfaceTransaction } from "@phreshos/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,10 +46,10 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.1"
+    "@phreshos/core": "^0.1.2"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.1",
+    "@phreshos/core": "^0.1.2",
     "typescript": "^6.0.3"
   }
 }