@phreshos/client 0.1.8 → 0.1.10

package/README.md

@@ -128,10 +128,11 @@ The same rule applies to Client-visible traffic destinations.
 
 Client-visible Program handles can operate only within their own Program.
 They deliberately omit `install()` and `fork()`, and their storage areas never
-expose host filesystem paths. `current.window` is authoritative and
-subscribable. `current.localWindow` is the physical representation belonging to
-this iframe on this desktop. Its reads and updates are local, have no events,
-and cannot target another Client handle.
+expose host filesystem paths. Every Client-side Window handle exposes the same
+authoritative, subscribable Window capability and its `window.local` physical
+representation on this desktop. Local reads and updates have no events and do
+not change Server state. `current.window` is only convenient access to the
+executing Client's canonical Window; it has no additional authority.
 When both dimensions must change, `setGeometry({ position, size })` commits
 them through one authoritative request and produces one `geometry` event.
 Calling `move()` and `resize()` sequentially or through `Promise.all()` remains
@@ -140,12 +141,12 @@ 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.localWindow.surface.set({
+await current.window.local.surface.set({
   opacity: 0.65,
   radius: "large"
 }, { duration: 240, easing: "ease-out", wait: true })
 
-await current.localWindow.surface.remove()
+await current.window.local.surface.remove()
 ```
 
 The desktop holds local state only for the lifetime of that iframe

package/dist/current.d.ts

@@ -1,4 +1,3 @@
-import type { LocalWindow } from "@phreshos/core";
 import { type Channel } from "./channel.js";
 import { Client, Server, type Process, type Program, type Window } from "./domain.js";
 /** The current Process's canonical Server handle. */
@@ -9,8 +8,6 @@ export interface Current<Events extends object = {}> extends Channel<Events>, Pi
     readonly server: CurrentServer;
     /** Presentation capability of this current Client. */
     readonly window: Window;
-    /** Physical Window representation belonging only to this Client iframe. */
-    readonly localWindow: LocalWindow;
     /** The same permission capability exposed by the current Program. */
     readonly permissions: Program["permissions"];
     /** Returns the Process represented by this Client. */

package/dist/current.js

@@ -84,7 +84,6 @@ currentClient = new CurrentClientHandle(owner);
 class ClientCurrent {
     server = currentServer;
     window = currentClient.window;
-    localWindow = new LocalWindowHandle();
     permissions = currentProgramPermissions;
     constructor() {
         bindChannel(this, channel);
@@ -105,30 +104,6 @@ class ClientCurrent {
     async stop() { await wire.request(["stop-current"]); }
     service() { return endpointService(null, "client"); }
 }
-class LocalWindowHandle {
-    surface = new LocalWindowSurfaceHandle();
-    async state() {
-        const answer = await wire.request(["localWindow"]);
-        return answer[0];
-    }
-    async title() { return (await this.state()).title; }
-    async position() { return (await this.state()).position; }
-    async size() { return (await this.state()).size; }
-    async minimized() { return (await this.state()).minimized; }
-    async front() { return (await this.state()).front; }
-    async layer() { return (await this.state()).layer; }
-    async location() { return (await this.state()).location; }
-    async move(position, transaction) { await wire.request(["localWindowMove", position, transaction]); }
-    async resize(size, transaction) { await wire.request(["localWindowResize", size, transaction]); }
-    async setGeometry(geometry, transaction) { await wire.request(["localWindowGeometry", geometry, transaction]); }
-    async minimize(minimized = true) { await wire.request(["localWindowMinimize", minimized]); }
-    async changeTitle(title) { await wire.request(["localWindowTitle", title]); }
-    async raise() { await wire.request(["localWindowRaise"]); }
-}
-class LocalWindowSurfaceHandle {
-    async set(settings = {}, transaction) { await wire.request(["localWindowSurfaceSet", settings, transaction]); }
-    async remove() { await wire.request(["localWindowSurfaceRemove"]); }
-}
 function bindChannel(target, source) {
     Object.assign(target, {
         publish: source.publish.bind(source),

package/dist/domain.d.ts

@@ -1,4 +1,4 @@
-import { Client as CoreClient, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, Server as CoreServer, type AnswerCapture as CoreAnswerCapture, type AnswerMessage as CoreAnswerMessage, type AnswerObserver as CoreAnswerObserver, type AskCapture as CoreAskCapture, type AskMessage as CoreAskMessage, type AskObserver as CoreAskObserver, type Cleanup, type ClientTraffic as CoreClientTraffic, type ClientDeclaration, type EndpointTraffic as CoreEndpointTraffic, type EndpointDeclaration, type Exit, type Launch, type Permissions, type ServerTraffic as CoreServerTraffic, type TrafficMessage as CoreTrafficMessage, type TrafficCapture as CoreTrafficCapture, type TrafficEvents as CoreTrafficEvents, type Window as CoreWindow, type WindowState } from "@phreshos/core";
+import { Client as CoreClient, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, Server as CoreServer, type AnswerCapture as CoreAnswerCapture, type AnswerMessage as CoreAnswerMessage, type AnswerObserver as CoreAnswerObserver, type AskCapture as CoreAskCapture, type AskMessage as CoreAskMessage, type AskObserver as CoreAskObserver, type Cleanup, type ClientTraffic as CoreClientTraffic, type ClientDeclaration, type EndpointTraffic as CoreEndpointTraffic, type EndpointDeclaration, type Exit, type Launch, type LocalWindow, type Permissions, type ServerTraffic as CoreServerTraffic, type TrafficMessage as CoreTrafficMessage, type TrafficCapture as CoreTrafficCapture, type TrafficEvents as CoreTrafficEvents, type Window as CoreWindow, type WindowState } from "@phreshos/core";
 import Events from "./events.js";
 export interface HandleAddress {
     identity: string;
@@ -102,8 +102,11 @@ export type Client<Events extends object = {}> = Omit<CoreClient<Events>, "proce
     /** Returns the Process that owns this Client. */
     process(): Promise<Process>;
 };
-/** Authoritative Client-owned Window capability visible inside a Client boundary. */
-export type Window = CoreWindow;
+/** Authoritative Window state plus its representation on this desktop. */
+export type Window = CoreWindow & {
+    /** Physical representation of this Window on the current desktop. */
+    readonly local: LocalWindow;
+};
 export declare class TrafficHandle extends Events {
     protected readonly target: HandleAddress | null;
     protected readonly kind: "server" | "client";

package/dist/domain.js

@@ -206,9 +206,11 @@ class ClientHandle extends ClientBase {
 }
 class WindowHandle extends Events {
     target;
+    local;
     constructor(target) {
         super(...deferredScoped("host-end", target, (_event, values) => values[0]));
         this.target = target;
+        this.local = new LocalWindowHandle(target);
     }
     async state() {
         const answer = await wire.request(["window", await this.target()]);
@@ -228,6 +230,41 @@ 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 LocalWindowHandle {
+    target;
+    surface;
+    constructor(target) {
+        this.target = target;
+        this.surface = new LocalWindowSurfaceHandle(target);
+    }
+    async state() {
+        const answer = await wire.request(["windowLocal", await this.target()]);
+        return answer[0];
+    }
+    async title() { return (await this.state()).title; }
+    async position() { return (await this.state()).position; }
+    async size() { return (await this.state()).size; }
+    async minimized() { return (await this.state()).minimized; }
+    async front() { return (await this.state()).front; }
+    async layer() { return (await this.state()).layer; }
+    async location() { return (await this.state()).location; }
+    async move(position, transaction) { await wire.request(["windowLocalMove", await this.target(), position, transaction]); }
+    async resize(size, transaction) { await wire.request(["windowLocalResize", await this.target(), size, transaction]); }
+    async setGeometry(geometry, transaction) { await wire.request(["windowLocalGeometry", await this.target(), geometry, transaction]); }
+    async minimize(minimized = true) { await wire.request(["windowLocalMinimize", await this.target(), minimized]); }
+    async changeTitle(title) { await wire.request(["windowLocalTitle", await this.target(), title]); }
+    async raise() { await wire.request(["windowLocalRaise", await this.target()]); }
+}
+class LocalWindowSurfaceHandle {
+    target;
+    constructor(target) {
+        this.target = target;
+    }
+    async set(settings = {}, transaction) {
+        await wire.request(["windowLocalSurfaceSet", await this.target(), settings, transaction]);
+    }
+    async remove() { await wire.request(["windowLocalSurfaceRemove", await this.target()]); }
+}
 function deferredScoped(route, target, convert) {
     return [
         (event, listener, impossible) => {

package/dist/theme.d.ts

@@ -9,5 +9,6 @@ export default class ClientTheme extends Events {
         spacing: number;
         radius: number;
         glass: import("@phreshos/core").ThemeGlass;
+        surface: import("@phreshos/core").ThemeSurface;
     }>>;
 }

package/dist/theme.js

@@ -23,7 +23,11 @@ function isObject(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         return false;
     const theme = value;
+    const surface = theme.surface;
     return typeof theme.background === "string" && typeof theme.foreground === "string" && typeof theme.accent === "string"
         && typeof theme.spacing === "number" && typeof theme.radius === "number"
-        && typeof theme.glass === "object" && theme.glass !== null;
+        && typeof theme.glass === "object" && theme.glass !== null
+        && typeof surface === "object" && surface !== null && typeof surface.color === "string"
+        && typeof surface.grain === "number" && typeof surface.animation === "number"
+        && typeof surface.backdrop === "number" && typeof surface.opacity === "number";
 }

package/package.json

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