@phreshos/react 0.1.29 → 0.1.30

package/dist/main.d.ts

@@ -9,5 +9,6 @@ export { default as useSessionState, type SessionState } from "./use-session-sta
 export { default as useEndpointState, type EndpointState } from "./use-endpoint-state.js";
 export { default as useServiceState, type ServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";
+export { default as useWindowPresentationState } from "./use-window-presentation-state.js";
 export { default as useSubscribeAsks, type AskSubscribable } from "./use-subscribe-asks.js";
 export { default as useSubscribeAnswers, type AnswerSubscribable } from "./use-subscribe-answers.js";

package/dist/main.js

@@ -9,5 +9,6 @@ export { default as useSessionState } from "./use-session-state.js";
 export { default as useEndpointState } from "./use-endpoint-state.js";
 export { default as useServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";
+export { default as useWindowPresentationState } from "./use-window-presentation-state.js";
 export { default as useSubscribeAsks } from "./use-subscribe-asks.js";
 export { default as useSubscribeAnswers } from "./use-subscribe-answers.js";

package/dist/use-program-state.d.ts

@@ -2,6 +2,7 @@ import type { Process, Program } from "@phreshos/core";
 /** Mutable runtime state derived from one Program's reads and live events. */
 export type ProgramState = Readonly<{
     installed: boolean;
+    pinned: boolean;
     processes: readonly Process[];
 }>;
 /** Explicitly reads and follows one Program while this hook is mounted. */

package/dist/use-program-state.js

@@ -3,12 +3,13 @@ import LiveState, { combineCleanups } from "./live-state.js";
 /** Explicitly reads and follows one Program while this hook is mounted. */
 export default function useProgramState(program) {
     const state = useMemo(() => new LiveState(async () => {
-        const [installed, processes] = await Promise.all([
+        const [installed, pinned, processes] = await Promise.all([
             program.installed(),
+            program.pinned(),
             program.processes()
         ]);
-        return { installed, processes };
-    }, reduce => combineCleanups(program.subscribe("processCreate", process => reduce(current => addProcess(current, process))), program.subscribe("processExit", ({ process }) => reduce(current => removeProcess(current, process))), program.subscribe("uninstall", () => reduce(current => current.installed ? { ...current, installed: false } : current)))), [program]);
+        return { installed, pinned, processes };
+    }, reduce => combineCleanups(program.subscribe("processCreate", process => reduce(current => addProcess(current, process))), program.subscribe("processExit", ({ process }) => reduce(current => removeProcess(current, process))), program.subscribe("uninstall", () => reduce(current => current.installed ? { ...current, installed: false } : current)), program.subscribe("pinned", pinned => reduce(current => current.pinned === pinned ? current : { ...current, pinned })))), [program]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }
 function addProcess(state, process) {

package/dist/use-window-presentation-state.d.ts

@@ -0,0 +1,3 @@
+import type { WindowPresentation, WindowPresentationState } from "@phreshos/core";
+/** Reads and follows the values one Desktop relies on to represent a Window. */
+export default function useWindowPresentationState(presentation: WindowPresentation): WindowPresentationState | undefined;

package/dist/use-window-presentation-state.js

@@ -0,0 +1,30 @@
+import { useMemo, useSyncExternalStore } from "react";
+import LiveState, { combineCleanups } from "./live-state.js";
+/** Reads and follows the values one Desktop relies on to represent a Window. */
+export default function useWindowPresentationState(presentation) {
+    const state = useMemo(() => new LiveState(() => readPresentation(presentation), reduce => combineCleanups(presentation.subscribe("move", position => reduce(current => change(current, "position", position))), presentation.subscribe("resize", size => reduce(current => change(current, "size", size))), presentation.subscribe("minimize", minimized => reduce(current => change(current, "minimized", minimized))), presentation.subscribe("maximize", maximized => reduce(current => change(current, "maximized", maximized))), presentation.subscribe("changeTitle", title => reduce(current => change(current, "title", title))), presentation.subscribe("changeHeader", header => reduce(current => change(current, "header", header))), presentation.subscribe("changeSurface", surface => reduce(current => change(current, "surface", surface))), presentation.subscribe("front", front => reduce(current => change(current, "front", front))))), [presentation]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
+async function readPresentation(presentation) {
+    const layer = await presentation.layer();
+    if (layer === "wallpaper")
+        return { layer };
+    const [surface, position, size, minimized, maximized, front] = await Promise.all([
+        presentation.surface(),
+        presentation.position(),
+        presentation.size(),
+        presentation.minimized(),
+        presentation.maximized(),
+        presentation.front()
+    ]);
+    if (layer === "under" || layer === "over" || layer === "shell") {
+        return { layer, surface, position, size, minimized, maximized, front };
+    }
+    const [title, header] = await Promise.all([presentation.title(), presentation.header()]);
+    return { layer, title, header, surface, position, size, minimized, maximized, front };
+}
+function change(state, property, value) {
+    if (!(property in state))
+        return state;
+    return { ...state, [property]: value };
+}

package/dist/use-window-state.js

@@ -3,10 +3,10 @@ import LiveState, { combineCleanups } from "./live-state.js";
 /** Explicitly reads and follows one live Client Window while mounted. */
 export default function useWindowState(window) {
     const state = useMemo(() => new LiveState(async () => {
-        const [title, header, frame, transaction, position, size, minimized, maximized, front, layer] = await Promise.all([
+        const [title, header, surface, transaction, position, size, minimized, maximized, front, layer] = await Promise.all([
             window.title(),
             window.header(),
-            window.frame(),
+            window.surface(),
             window.transaction(),
             window.position(),
             window.size(),
@@ -15,7 +15,7 @@ export default function useWindowState(window) {
             window.front(),
             window.layer()
         ]);
-        return { title, header, frame, transaction, position, size, minimized, maximized, front, layer };
-    }, reduce => combineCleanups(window.subscribe("move", position => reduce(current => ({ ...current, position }))), window.subscribe("resize", size => reduce(current => ({ ...current, size }))), window.subscribe("minimize", minimized => reduce(current => ({ ...current, minimized }))), window.subscribe("maximize", maximized => reduce(current => ({ ...current, maximized }))), window.subscribe("changeTitle", title => reduce(current => ({ ...current, title }))), window.subscribe("changeHeader", header => reduce(current => ({ ...current, header }))), window.subscribe("changeFrame", frame => reduce(current => ({ ...current, frame }))), window.subscribe("changeTransaction", transaction => reduce(current => ({ ...current, transaction }))), window.subscribe("front", front => reduce(current => ({ ...current, front }))))), [window]);
+        return { title, header, surface, transaction, position, size, minimized, maximized, front, layer };
+    }, reduce => combineCleanups(window.subscribe("move", position => reduce(current => ({ ...current, position }))), window.subscribe("resize", size => reduce(current => ({ ...current, size }))), window.subscribe("minimize", minimized => reduce(current => ({ ...current, minimized }))), window.subscribe("maximize", maximized => reduce(current => ({ ...current, maximized }))), window.subscribe("changeTitle", title => reduce(current => ({ ...current, title }))), window.subscribe("changeHeader", header => reduce(current => ({ ...current, header }))), window.subscribe("changeSurface", surface => reduce(current => ({ ...current, surface }))), window.subscribe("changeTransaction", transaction => reduce(current => ({ ...current, transaction }))), window.subscribe("front", front => reduce(current => ({ ...current, front }))))), [window]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-  "version": "0.1.29",
+    "version": "0.1.30",
   "description": "Runtime-neutral React adapters for PhreshOS contracts.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,11 +46,11 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.55",
+        "@phreshos/core": "^0.1.58",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.55",
+        "@phreshos/core": "^0.1.58",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",