@phreshos/react 0.1.20 → 0.1.22

package/README.md

@@ -26,7 +26,7 @@ their React lifecycle.
 | Bun | `bun add @phreshos/react` |
 | Yarn | `yarn add @phreshos/react` |
 
-`@phreshos/core` and React are peer dependencies.
+`@phreshos/core` and `react` are peer dependencies.
 
 ```tsx
 import {
@@ -55,6 +55,12 @@ bun run verify
 `verify` checks the contracts, tests the adapters, builds the package, and
 validates its published shape.
 
+`check` performs static checks, `build` creates distributable output, and `test`
+runs Vitest assertions from `tests/`. Run `build` before testing built artifacts.
+`verify` runs `check`, `build`, and `test` in order. Operational tooling belongs
+in `scripts/`; tests and their fixtures belong in `tests/`. Verification uses
+the committed dependency graph without local package substitutions.
+
 ## Related repositories
 
 - [`@phreshos/core`](https://github.com/PhreshOS/core) owns every contract

package/dist/desktop-provider.d.ts

@@ -1,16 +1,16 @@
 import { type ReactNode } from "react";
-import type { Desktop, DesktopPreferences, DesktopSurfaceSnapshot } from "@phreshos/core";
+import type { Desktop, DesktopPreferences, DesktopViewportSnapshot } from "@phreshos/core";
 import LiveSnapshot from "./live-snapshot.js";
 /** Provides one complete Client Desktop environment to a React tree. */
 export default function DesktopProvider({ children, desktop, fallback }: DesktopProviderProperties): string | number | bigint | boolean | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").FunctionComponentElement<import("react").ProviderProps<Readonly<{
     desktop: Desktop;
-    surface: LiveSnapshot<DesktopSurfaceSnapshot>;
+    viewport: LiveSnapshot<DesktopViewportSnapshot>;
     preferences: LiveSnapshot<DesktopPreferences>;
 }> | null>> | null;
 /** Returns the complete Desktop supplied by the nearest provider. */
 export declare function useDesktop(): Desktop;
-/** Resolves and follows the current Desktop surface. */
-export declare function useDesktopSurface(): DesktopSurfaceSnapshot;
+/** Resolves and follows the current Desktop viewport. */
+export declare function useDesktopViewport(): DesktopViewportSnapshot;
 /** Resolves and follows the effective Desktop preferences. */
 export declare function useDesktopPreferences(): DesktopPreferences;
 export type DesktopProviderProperties = Readonly<{

package/dist/desktop-provider.js

@@ -6,10 +6,10 @@ const DesktopContext = createContext(null);
 export default function DesktopProvider({ children, desktop, fallback = null }) {
     const value = useMemo(() => ({
         desktop,
-        surface: new LiveSnapshot(() => desktop.surface.snapshot(), subscriber => desktop.surface.subscribe("resize", subscriber)),
+        viewport: new LiveSnapshot(() => desktop.viewport.snapshot(), subscriber => desktop.viewport.subscribe("resize", subscriber)),
         preferences: new LiveSnapshot(() => desktop.preferences.snapshot(), subscriber => desktop.preferences.subscribe("change", subscriber))
     }), [desktop]);
-    const stores = useMemo(() => [value.surface, value.preferences], [value]);
+    const stores = useMemo(() => [value.viewport, value.preferences], [value]);
     const ready = useProviderResolution(stores);
     return ready ? createElement(DesktopContext.Provider, { value }, children) : fallback;
 }
@@ -17,9 +17,9 @@ export default function DesktopProvider({ children, desktop, fallback = null })
 export function useDesktop() {
     return useValue().desktop;
 }
-/** Resolves and follows the current Desktop surface. */
-export function useDesktopSurface() {
-    const store = useValue().surface;
+/** Resolves and follows the current Desktop viewport. */
+export function useDesktopViewport() {
+    const store = useValue().viewport;
     return useSyncExternalStore(store.subscribe, store.snapshot, store.snapshot);
 }
 /** Resolves and follows the effective Desktop preferences. */

package/dist/main.d.ts

@@ -1,6 +1,6 @@
 export { default as ContextProvider, useContext, useParent, useProcess, useProgram, type ContextProviderProperties } from "./context-provider.js";
 export { default as SystemProvider, useSystem, useSystemAppearance, type SystemProviderProperties } from "./system-provider.js";
-export { default as DesktopProvider, useDesktop, useDesktopSurface, useDesktopPreferences, type DesktopProviderProperties } from "./desktop-provider.js";
+export { default as DesktopProvider, useDesktop, useDesktopViewport, useDesktopPreferences, type DesktopProviderProperties } from "./desktop-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useProgramState, type ProgramState } from "./use-program-state.js";
 export { default as useProcessState, type ProcessState } from "./use-process-state.js";

package/dist/main.js

@@ -1,6 +1,6 @@
 export { default as ContextProvider, useContext, useParent, useProcess, useProgram } from "./context-provider.js";
 export { default as SystemProvider, useSystem, useSystemAppearance } from "./system-provider.js";
-export { default as DesktopProvider, useDesktop, useDesktopSurface, useDesktopPreferences } from "./desktop-provider.js";
+export { default as DesktopProvider, useDesktop, useDesktopViewport, useDesktopPreferences } from "./desktop-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useProgramState } from "./use-program-state.js";
 export { default as useProcessState } from "./use-process-state.js";

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

@@ -1,9 +1,7 @@
 import type { Process } from "@phreshos/core";
-/** Mutable lifecycle state of one Process and its Endpoint incarnations. */
+/** Mutable lifecycle state of one Process. */
 export type ProcessState = Readonly<{
     exited: boolean;
-    serverExists: boolean;
-    clientExists: boolean;
 }>;
 /** Explicitly reads and follows one Process while this hook is mounted. */
 export default function useProcessState(process: Process): ProcessState | undefined;

package/dist/use-process-state.js

@@ -1,14 +1,7 @@
 import { useMemo, useSyncExternalStore } from "react";
-import LiveState, { combineCleanups } from "./live-state.js";
+import LiveState from "./live-state.js";
 /** Explicitly reads and follows one Process while this hook is mounted. */
 export default function useProcessState(process) {
-    const state = useMemo(() => new LiveState(async () => {
-        const [exited, serverExists, clientExists] = await Promise.all([
-            process.exited(),
-            process.server.exists(),
-            process.client.exists()
-        ]);
-        return { exited, serverExists, clientExists };
-    }, reduce => combineCleanups(process.server.lifecycle.subscribe("start", () => reduce(current => current.serverExists ? current : { ...current, serverExists: true })), process.server.lifecycle.subscribe("stop", () => reduce(current => current.serverExists ? { ...current, serverExists: false } : current)), process.client.lifecycle.subscribe("start", () => reduce(current => current.clientExists ? current : { ...current, clientExists: true })), process.client.lifecycle.subscribe("stop", () => reduce(current => current.clientExists ? { ...current, clientExists: false } : current)), process.subscribe("exit", () => reduce(current => ({ ...current, exited: true, serverExists: false, clientExists: false }))))), [process]);
+    const state = useMemo(() => new LiveState(async () => ({ exited: await process.exited() }), reduce => process.subscribe("exit", () => reduce(current => current.exited ? current : { exited: true }))), [process]);
     return useSyncExternalStore(state.subscribe, state.snapshot, state.snapshot);
 }

package/dist/use-window-state.js

@@ -3,16 +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] = await Promise.all([
+        const [title, position, size, minimized, maximized, front, layer] = await Promise.all([
             window.title(),
             window.position(),
             window.size(),
             window.minimized(),
+            window.maximized(),
             window.front(),
-            window.layer(),
-            window.location()
+            window.layer()
         ]);
-        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 { title, 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("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.20",
+  "version": "0.1.22",
   "description": "Runtime-neutral React adapters for PhreshOS contracts.",
   "type": "module",
   "main": "dist/main.js",
@@ -40,18 +40,18 @@
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "check": "tsc --noEmit && tsc -p tsconfig.test.json",
-    "test": "vitest run --environment jsdom",
+    "test": "vitest run --project default",
     "build": "node --run clean && tsc --noEmit false --outDir dist --rootDir source",
-    "verify:package": "node scripts/verify-package.mjs",
-    "verify": "node --run check && node --run test && node --run build && node --run verify:package",
-    "prepack": "node --run test && node --run build"
+    "verify": "node --run check && node --run build && node --run test",
+    "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.41",
+    "@phreshos/core": "^0.1.43",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.41",
+    "@phreshos/core": "^0.1.43",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
@@ -59,6 +59,6 @@
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.10"
   }
 }