@phreshos/server 0.1.4 → 0.1.5

package/README.md

@@ -76,13 +76,10 @@ retained handle. Server and Client handles remain stable for their Process
 lifetime. Each Client permanently owns one synchronous `window` capability,
 whose operations address that Client's current live presentation state.
 
-An `under` or `over` Client Window may own an authoritative host Surface through
-`client.window.surface`. It is command-only: `set()` or `remove()` changes the
-server-owned value, while Program endpoints cannot read or subscribe to it.
-Radius may be a
-nonnegative pixel number, `"full"`, or a semantic `ScaleLevel` resolved by the
-desktop against its current Theme. Ordinary `window` and system `wallpaper`
-layers reject Surface mutations.
+Surface presentation is deliberately absent from the Server SDK. It belongs to
+one live iframe representation and is requested through the Client's
+`current.window.surface`; a Server may coordinate Program state, but it neither
+owns nor controls the resulting desktop material.
 
 The package provides two contextual runtime entry points:
 

package/dist/domain.js

@@ -249,11 +249,9 @@ class ClientHandle extends ClientBase {
 }
 class WindowHandle extends Events {
     target;
-    surface;
     constructor(target) {
         super(...deferredScoped("host-end", target, (_event, values) => values[0]));
         this.target = target;
-        this.surface = new WindowSurfaceHandle(target);
     }
     async state() {
         const answer = await wire.request(["window", await this.target()]);
@@ -268,18 +266,11 @@ class WindowHandle extends Events {
     async location() { return (await this.state()).location; }
     async move(position) { await wire.request(["move", await this.target(), position]); }
     async resize(size) { await wire.request(["resize", await this.target(), size]); }
+    async setGeometry(geometry) { await wire.request(["setGeometry", await this.target(), geometry]); }
     async minimize(minimized = true) { await wire.request(["minimize", await this.target(), minimized]); }
     async changeTitle(title) { await wire.request(["changeTitle", await this.target(), title]); }
     async raise() { await wire.request(["raise", await this.target()]); }
 }
-class WindowSurfaceHandle {
-    target;
-    constructor(target) {
-        this.target = target;
-    }
-    async set(settings = {}) { await wire.request(["surfaceSet", await this.target(), settings]); }
-    async remove() { await wire.request(["surfaceRemove", await this.target()]); }
-}
 function deferredScoped(route, target, convert) {
     return [
         (event, listener, impossible) => {
@@ -303,7 +294,7 @@ function deferredScoped(route, target, convert) {
     ];
 }
 function windowEvent(event) {
-    return event === "move" || event === "resize" || event === "minimize" || event === "changeTitle" || event === "front";
+    return event === "move" || event === "resize" || event === "geometry" || event === "minimize" || event === "changeTitle" || event === "front";
 }
 function deferred(target, register, impossible) {
     let active = true;

package/dist/main.d.ts

@@ -4,4 +4,4 @@ export { type Answerer, type Channel } from "./channel.js";
 export { type ProgramStartup } from "./startup.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 ProgramArea } from "./domain.js";
-export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ChannelCapture, ChannelEvents, ChannelMessage, ClientTraffic, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EndpointTraffic, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, Position, ProgramEvents, ProgramPermissions, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, ServerTraffic, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Theme, ThemeEvents, ThemeProperties, WallpaperLaunch, FileWallpaper, DesktopWallpaper, WritableTheme, WindowEvents, WindowLayer, WindowState, WindowSurface, WindowSurfaceEasing, WindowSurfaceSettings, WindowSurfaceTransaction } from "@phreshos/core";
+export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ChannelCapture, ChannelEvents, ChannelMessage, ClientTraffic, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EndpointTraffic, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, Position, ProgramEvents, ProgramPermissions, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, ServerTraffic, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Theme, ThemeEvents, ThemeProperties, WallpaperLaunch, FileWallpaper, DesktopWallpaper, WritableTheme, WindowEvents, WindowGeometry, WindowLayer, WindowState } from "@phreshos/core";

package/package.json

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