@phreshos/react 0.1.28 → 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-endpoint-state.d.ts

@@ -1,6 +1,6 @@
 import type { Endpoint } from "@phreshos/core";
 export type EndpointState = Readonly<{
-    exists: boolean;
+    running: boolean;
 }>;
 /** Explicitly reads and follows one Endpoint address while mounted. */
 export default function useEndpointState(endpoint: Endpoint): EndpointState | undefined;

package/dist/use-endpoint-state.js

@@ -2,9 +2,9 @@ import { useMemo, useSyncExternalStore } from "react";
 import LiveState, { combineCleanups } from "./live-state.js";
 /** Explicitly reads and follows one Endpoint address while mounted. */
 export default function useEndpointState(endpoint) {
-    const state = useMemo(() => new LiveState(async () => ({ exists: await endpoint.exists() }), reduce => combineCleanups(endpoint.lifecycle.subscribe("start", () => reduce(current => setExists(current, true))), endpoint.lifecycle.subscribe("stop", () => reduce(current => setExists(current, false))))), [endpoint]);
+    const state = useMemo(() => new LiveState(async () => ({ running: await endpoint.running() }), reduce => combineCleanups(endpoint.lifecycle.subscribe("start", () => reduce(current => setRunning(current, true))), endpoint.lifecycle.subscribe("stop", () => reduce(current => setRunning(current, false))))), [endpoint]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }
-function setExists(state, exists) {
-    return state.exists === exists ? state : { exists };
+function setRunning(state, running) {
+    return state.running === running ? state : { running };
 }

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-service-state.d.ts

@@ -1,7 +1,7 @@
 import type { Service } from "@phreshos/core";
-/** Live existence of one configured Endpoint service. */
+/** Live availability of one stable Service address. */
 export type ServiceState = Readonly<{
-    exists: boolean;
+    available: boolean;
 }>;
 /** Explicitly reads and follows one service while this hook is mounted. */
 export default function useServiceState(service: Service): ServiceState | undefined;

package/dist/use-service-state.js

@@ -2,9 +2,9 @@ import { useMemo, useSyncExternalStore } from "react";
 import LiveState, { combineCleanups } from "./live-state.js";
 /** Explicitly reads and follows one service while this hook is mounted. */
 export default function useServiceState(service) {
-    const state = useMemo(() => new LiveState(async () => ({ exists: await service.exists() }), reduce => combineCleanups(service.lifecycle.subscribe("start", () => reduce(current => setExists(current, true))), service.lifecycle.subscribe("stop", () => reduce(current => setExists(current, false))))), [service]);
+    const state = useMemo(() => new LiveState(async () => ({ available: await service.available() }), reduce => combineCleanups(service.lifecycle.subscribe("available", () => reduce(current => setAvailable(current, true))), service.lifecycle.subscribe("unavailable", () => reduce(current => setAvailable(current, false))))), [service]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }
-function setExists(state, exists) {
-    return state.exists === exists ? state : { exists };
+function setAvailable(state, available) {
+    return state.available === available ? state : { available };
 }

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,9 +3,11 @@ 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, 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.surface(),
+            window.transaction(),
             window.position(),
             window.size(),
             window.minimized(),
@@ -13,7 +15,7 @@ export default function useWindowState(window) {
             window.front(),
             window.layer()
         ]);
-        return { title, header, 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("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.28",
+    "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.53",
+        "@phreshos/core": "^0.1.58",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.53",
+        "@phreshos/core": "^0.1.58",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",