@phreshos/client 0.1.53 → 0.1.54

package/dist/desktop/viewport.d.ts

@@ -1,9 +1,15 @@
-import type { DesktopViewportEvents, DesktopViewportSource } from "@phreshos/core";
+import type { DesktopOffset, DesktopViewportEvents, WritableDesktopViewportSource } from "@phreshos/core";
 import Events from "../events.js";
-/** Read-only access to the Desktop viewport containing this Client Endpoint. */
-export default class ClientViewport extends Events<DesktopViewportEvents, never> implements DesktopViewportSource {
+/** The Desktop viewport containing this Client Endpoint: its size, where it looks on the plane, and moving that view. */
+export default class ClientViewport extends Events<DesktopViewportEvents, never> implements WritableDesktopViewportSource {
     constructor();
-    snapshot(): Promise<Readonly<{
-        size: import("@phreshos/core").DesktopSize;
+    size(): Promise<Readonly<{
+        width: number;
+        height: number;
     }>>;
+    offset(): Promise<Readonly<{
+        x: number;
+        y: number;
+    }>>;
+    move(offset: DesktopOffset): Promise<void>;
 }

package/dist/desktop/viewport.js

@@ -1,33 +1,57 @@
 import Events from "../events.js";
 import wire from "../wire.js";
-/** Read-only access to the Desktop viewport containing this Client Endpoint. */
+/** The Desktop viewport containing this Client Endpoint: its size, where it looks on the plane, and moving that view. */
 export default class ClientViewport extends Events {
     constructor() {
         super((event, listener, impossible) => wire.on("host-desktop-viewport", event, value => {
-            const snapshot = createSnapshot(value);
-            if (snapshot)
-                listener(snapshot);
+            const parsed = parse(event, value);
+            if (parsed)
+                listener(parsed);
         }, null, impossible), observer => wire.onAll("host-desktop-viewport", (event, value) => {
-            const snapshot = createSnapshot(value);
-            if (typeof event === "string" && snapshot)
-                observer(event, snapshot);
+            const parsed = typeof event === "string" ? parse(event, value) : null;
+            if (typeof event === "string" && parsed)
+                observer(event, parsed);
         }));
     }
-    async snapshot() {
-        const answer = await wire.request(["desktopViewport"]);
-        const snapshot = createSnapshot(answer[0]);
-        if (!snapshot)
-            throw new Error("The System returned an invalid Desktop viewport");
-        return snapshot;
+    async size() {
+        const size = createSize((await state()).size);
+        if (!size)
+            throw new Error("The System returned an invalid Desktop size");
+        return size;
     }
+    async offset() {
+        const offset = createOffset((await state()).offset);
+        if (!offset)
+            throw new Error("The System returned an invalid Desktop offset");
+        return offset;
+    }
+    async move(offset) {
+        const target = createOffset(offset);
+        if (!target)
+            throw new Error("A Desktop offset needs finite x and y");
+        await wire.request(["moveDesktopViewport", target]);
+    }
+}
+async function state() {
+    const answer = await wire.request(["desktopViewport"]);
+    return record(answer[0]) ? answer[0] : {};
 }
-function createSnapshot(value) {
-    if (!record(value) || !record(value.size))
+function parse(event, value) {
+    if (event === "resize")
+        return createSize(value);
+    if (event === "move")
+        return createOffset(value);
+    return null;
+}
+function createSize(value) {
+    if (!record(value) || !finite(value.width) || !finite(value.height))
         return null;
-    const { width, height } = value.size;
-    if (!finite(width) || !finite(height))
+    return Object.freeze({ width: value.width, height: value.height });
+}
+function createOffset(value) {
+    if (!record(value) || !finite(value.x) || !finite(value.y))
         return null;
-    return Object.freeze({ size: Object.freeze({ width, height }) });
+    return Object.freeze({ x: value.x, y: value.y });
 }
 function record(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,13 +46,13 @@
     "test": "vitest run --project default"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.63"
+    "@phreshos/core": "^0.1.64"
   },
   "dependencies": {
     "@the-link/messagepack": "^0.1.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.63",
+    "@phreshos/core": "^0.1.64",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }