@phreshos/react 0.1.1 → 0.1.3

package/README.md

@@ -24,9 +24,10 @@ It provides two kinds of adapter:
   `usePointerPosition()` expose those values synchronously after resolution.
 - `useSubscribe()` and `useObserve()` own persistent ordinary-event
   registrations for one mounted React consumer.
-- `useProgramState(program)`, `useProcessState(process)`, and
-  `useWindowState(window)` explicitly compose existing reads with future live
-  events for one mounted consumer. They add no state operation to another SDK.
+- `useProgramState(program)`, `useProcessState(process)`,
+  `useServiceState(service)`, and `useWindowState(window)` explicitly compose
+  existing reads with future live events for one mounted consumer. They add no
+  state operation to another SDK.
 - `useObserveAsks()` adapts an Endpoint traffic surface's question observation,
   while `useObserveAnswers()` adapts a Server traffic surface's answer
   observation.
@@ -48,10 +49,17 @@ useProgramState(program)
 useProcessState(process)
 // { exited, serverExists, clientExists } | undefined
 
+useServiceState(service)
+// { disabled } | undefined
+
 useWindowState(window)
 // WindowState | undefined
 ```
 
+`WindowState` contains the observable Window properties only. The command-only
+`window.surface` capability is intentionally absent: Program code may replace
+or remove its target but cannot read or subscribe to it.
+
 `undefined` means only that the initial explicit reads are pending. Each hook
 opens its live subscriptions before those reads, then applies any intervening
 events so an older result cannot overwrite newer state. If an initial read

package/dist/main.d.ts

@@ -6,6 +6,7 @@ export { default as useScale } from "./use-scale.js";
 export { default as useColor } from "./use-color.js";
 export { default as useProgramState, type ProgramState } from "./use-program-state.js";
 export { default as useProcessState, type ProcessState } from "./use-process-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 useObserveAsks, type AskObservable } from "./use-observe-asks.js";
 export { default as useObserveAnswers, type AnswerObservable } from "./use-observe-answers.js";

package/dist/main.js

@@ -6,6 +6,7 @@ export { default as useScale } from "./use-scale.js";
 export { default as useColor } from "./use-color.js";
 export { default as useProgramState } from "./use-program-state.js";
 export { default as useProcessState } from "./use-process-state.js";
+export { default as useServiceState } from "./use-service-state.js";
 export { default as useWindowState } from "./use-window-state.js";
 export { default as useObserveAsks } from "./use-observe-asks.js";
 export { default as useObserveAnswers } from "./use-observe-answers.js";

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

@@ -0,0 +1,7 @@
+import type { ServiceHandler } from "@phreshos/client";
+/** Live availability of one exact service identity. */
+export type ServiceState = Readonly<{
+    disabled: boolean;
+}>;
+/** Explicitly reads and follows one service while this hook is mounted. */
+export default function useServiceState(service: ServiceHandler): ServiceState | undefined;

package/dist/use-service-state.js

@@ -0,0 +1,10 @@
+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 () => ({ disabled: await service.disabled() }), reduce => combineCleanups(service.subscribe("enable", () => reduce(current => setDisabled(current, false))), service.subscribe("disable", () => reduce(current => setDisabled(current, true))))), [service]);
+    return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+}
+function setDisabled(state, disabled) {
+    return state.disabled === disabled ? state : { disabled };
+}

package/dist/use-window-state.js

@@ -3,17 +3,16 @@ 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, position, size, minimized, front, layer, location, surface] = await Promise.all([
+        const [title, position, size, minimized, front, layer, location] = await Promise.all([
             window.title(),
             window.position(),
             window.size(),
             window.minimized(),
             window.front(),
             window.layer(),
-            window.location(),
-            window.surface.snapshot()
+            window.location()
         ]);
-        return { title, position, size, minimized, front, layer, location, surface };
-    }, 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("changeTitle", title => reduce(current => ({ ...current, title }))), window.subscribe("front", front => reduce(current => ({ ...current, front }))), window.surface.subscribe("change", surface => reduce(current => ({ ...current, surface }))))), [window]);
+        return { title, position, size, minimized, front, layer, location };
+    }, 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("changeTitle", title => reduce(current => ({ ...current, title }))), 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.1",
+  "version": "0.1.3",
   "description": "React adapters for the Client SDK.",
   "type": "module",
   "main": "dist/main.js",
@@ -47,13 +47,13 @@
     "prepack": "node --run test && node --run build"
   },
   "peerDependencies": {
-    "@phreshos/client": "^0.1.1",
-    "@phreshos/core": "^0.1.1",
+    "@phreshos/client": "^0.1.3",
+    "@phreshos/core": "^0.1.3",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/client": "^0.1.1",
-    "@phreshos/core": "^0.1.1",
+    "@phreshos/client": "^0.1.3",
+    "@phreshos/core": "^0.1.3",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",