@phreshos/react 0.1.19 → 0.1.21

package/README.md

@@ -2,9 +2,20 @@
 
 Runtime-neutral React adapters for PhreshOS contracts.
 
-The React SDK receives explicit Core handles and live sources. It does not
-initialize transport, import the Client SDK, access the browser, or define
-domain state.
+[Documentation](https://docs.phreshos.com/sdks/react) ·
+[Runtime model](https://docs.phreshos.com/runtime) ·
+[Source](https://github.com/PhreshOS/react)
+
+## Role
+
+The React SDK adapts explicitly supplied Core contracts and live sources to
+React providers and hooks. It does not initialize a transport, import the
+Client SDK, access the browser, define domain state, or render visual language.
+
+`SystemProvider`, `ContextProvider`, and `DesktopProvider` preserve the
+separation between the global System, current Client Context, and containing
+Desktop. State and subscription hooks preserve unresolved state and own only
+their React lifecycle.
 
 ## Installation
 
@@ -17,54 +28,22 @@ domain state.
 
 `@phreshos/core` and React are peer dependencies.
 
-## Providers
-
 ```tsx
-import { ContextProvider, DesktopProvider, SystemProvider } from "@phreshos/react"
+import {
+  ContextProvider,
+  DesktopProvider,
+  SystemProvider,
+} from "@phreshos/react"
 
 <SystemProvider system={system}>
   <DesktopProvider desktop={desktop}>
-    <ContextProvider context={context}>
-      {children}
-    </ContextProvider>
+    <ContextProvider context={context}>{children}</ContextProvider>
   </DesktopProvider>
 </SystemProvider>
 ```
 
-Each provider receives one complete Core contract. The three roots remain
-separate: global System, current Client Context, and Client Desktop.
-
-## Hooks
-
-Context hooks expose the supplied handles:
-
-- `useContext()`
-- `useProgram()`
-- `useProcess()`
-- `useParent()`
-
-System hooks expose the System and its live Appearance:
-
-- `useSystem()`
-- `useSystemAppearance()`
-
-Desktop hooks expose the Desktop and its live state:
-
-- `useDesktop()`
-- `useDesktopSurface()`
-- `useDesktopPreferences()`
-
-State hooks compose one explicit read with future events:
-
-- `useProgramState()`
-- `useProcessState()`
-- `useEndpointState()`
-- `useServiceState()`
-- `useWindowState()`
-
-`useSubscribe()`, `useSubscribeAsks()`, and `useSubscribeAnswers()` own
-their mounted registrations and clean them up on unmount. Unresolved initial
-reads remain `undefined`; the adapters do not invent fallback domain state.
+See [React SDK](https://docs.phreshos.com/sdks/react) for providers, state
+hooks, and subscription hooks.
 
 ## Development
 
@@ -73,13 +52,21 @@ bun install --frozen-lockfile
 bun run verify
 ```
 
-`verify` checks the contracts, tests the adapters in React, builds the package,
-and validates its public artifact.
+`verify` checks the contracts, tests the adapters, builds the package, and
+validates its published shape.
+
+## Related repositories
 
-## Repository boundary
+- [`@phreshos/core`](https://github.com/PhreshOS/core) owns every contract
+  accepted by these adapters.
+- [`@phreshos/client`](https://github.com/PhreshOS/client) supplies Client
+  runtime values without becoming a dependency of this package.
+- [`@phreshos/react-ui`](https://github.com/PhreshOS/react-ui) owns reusable
+  visual components and Appearance interpretation.
+- [PhreshOS System](https://github.com/PhreshOS/system) composes these adapters
+  in the Desktop.
 
-This repository owns React lifecycle adaptation only. Core owns the contracts,
-runtime SDKs provide the sources, and React UI owns visual components.
+## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for the repository workflow and
 [SECURITY.md](SECURITY.md) for private vulnerability reporting.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Runtime-neutral React adapters for PhreshOS contracts.",
   "type": "module",
   "main": "dist/main.js",
@@ -47,11 +47,12 @@
     "prepack": "node --run test && node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.37",
+    "@phreshos/core": "^0.1.42",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.37",
+    "@phreshos/core": "^0.1.42",
+    "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",