@phreshos/react 0.1.30 → 0.1.32

package/dist/context-provider.d.ts

@@ -10,6 +10,8 @@ export default function ContextProvider({ children, context, fallback }: Context
 }> | null>> | null;
 /** Returns the complete Client Context supplied by the nearest provider. */
 export declare function useContext(): ClientContext;
+/** Read the current Context when present; explicit-handle hooks also work without it. */
+export declare function useProvidedContext(): ClientContext | null;
 /** Returns the current Program once it resolves. */
 export declare function useProgram<Handle extends Program = Program>(): Handle;
 /** Returns the current Process once it resolves. */

package/dist/context-provider.js

@@ -18,6 +18,10 @@ export default function ContextProvider({ children, context, fallback = null })
 export function useContext() {
     return useValue().context;
 }
+/** Read the current Context when present; explicit-handle hooks also work without it. */
+export function useProvidedContext() {
+    return useReactContext(CurrentContext)?.context ?? null;
+}
 /** Returns the current Program once it resolves. */
 export function useProgram() {
     return useResolved(useValue().program);

package/dist/main.d.ts

@@ -9,6 +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 useClientMemory } from "./use-client-memory.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,6 +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 useClientMemory } from "./use-client-memory.js";
 export { default as useSubscribeAsks } from "./use-subscribe-asks.js";
 export { default as useSubscribeAnswers } from "./use-subscribe-answers.js";

package/dist/use-client-memory.d.ts

@@ -0,0 +1,7 @@
+import type { ClientMemory, JsonValue } from "@phreshos/core";
+type Widen<Value extends JsonValue> = Value extends string ? string : Value extends number ? number : Value extends boolean ? boolean : Value;
+type MemoryResult<Value extends JsonValue> = readonly [Value | undefined, (next: Value | ((current: Value | undefined) => Value)) => Promise<void>];
+/** Reads the current Client's memory, or an explicitly supplied Client memory handle. */
+export default function useClientMemory<Value extends JsonValue>(key: string, initial: Value): MemoryResult<Widen<Value>>;
+export default function useClientMemory<Value extends JsonValue>(memory: ClientMemory, key: string, initial: Value): MemoryResult<Widen<Value>>;
+export {};

package/dist/use-client-memory.js

@@ -0,0 +1,21 @@
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+import { useProvidedContext } from "./context-provider.js";
+import LiveState from "./live-state.js";
+export default function useClientMemory(memoryOrKey, keyOrInitial, explicitInitial) {
+    const context = useProvidedContext();
+    const memory = typeof memoryOrKey === "string" ? context?.memory : memoryOrKey;
+    if (!memory)
+        throw new Error("useClientMemory(key, initial) requires ContextProvider");
+    const key = typeof memoryOrKey === "string" ? memoryOrKey : keyOrInitial;
+    const initial = typeof memoryOrKey === "string" ? keyOrInitial : explicitInitial;
+    // Initial seeds the key, but does not restart its subscription when it changes.
+    const state = useMemo(() => new LiveState(async () => ({ value: await memory.update(key, current => current === undefined ? initial : current) }), reduce => memory.subscribe(key, value => reduce(() => ({ value })))), [memory, key]);
+    const snapshot = useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
+    const set = useCallback(async (next) => {
+        if (typeof next === "function")
+            await memory.update(key, next);
+        else
+            await memory.set(key, next);
+    }, [memory, key]);
+    return [snapshot?.value, set];
+}

package/dist/use-window-state.js

@@ -3,11 +3,9 @@ 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, surface, transaction, position, size, minimized, maximized, front, layer] = await Promise.all([
+        const [title, header, position, size, minimized, maximized, front, layer] = await Promise.all([
             window.title(),
             window.header(),
-            window.surface(),
-            window.transaction(),
             window.position(),
             window.size(),
             window.minimized(),
@@ -15,7 +13,7 @@ export default function useWindowState(window) {
             window.front(),
             window.layer()
         ]);
-        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 { 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 useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-    "version": "0.1.30",
+  "version": "0.1.32",
   "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.58",
+        "@phreshos/core": "^0.1.62",
     "react": "^19.2.0"
   },
   "devDependencies": {
-        "@phreshos/core": "^0.1.58",
+        "@phreshos/core": "^0.1.62",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",

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

@@ -1,3 +0,0 @@
-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

@@ -1,30 +0,0 @@
-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 };
-}