@phreshos/react 0.1.10 → 0.1.11

package/README.md

@@ -20,8 +20,9 @@ It provides two kinds of adapter:
   `provide` prop, then exposes them synchronously through `useProgram()`,
   `useProcess()`, and `useParent()`.
 - `SystemProvider` subscribes before reading exactly the system values named by its
-  required `provide` prop. `useSystemAppearance()`, `useSystemTheme()`, `useDesktopSize()`, and
-  `usePointerPosition()` expose those values synchronously after resolution.
+  required `provide` prop. `useSystemAppearance()`, `useDesktopPreferences()`,
+  `useDesktopSize()`, and `usePointerPosition()` expose those values synchronously
+  after resolution.
 - `useSubscribe()` and `useObserve()` own persistent ordinary-event
   registrations for one mounted React consumer.
 - `useProgramState(program)`, `useProcessState(process)`,
@@ -88,10 +89,10 @@ subscribes before requesting each selected snapshot and prevents an older read
 from overwriting a newer event:
 
 ```tsx
-import { SystemProvider, useDesktopSize, useSystemAppearance, useSystemTheme } from "@phreshos/react"
+import { SystemProvider, useDesktopPreferences, useDesktopSize, useSystemAppearance } from "@phreshos/react"
 
 function Content() {
-  const theme = useSystemTheme()
+  const { theme } = useDesktopPreferences()
   const appearance = useSystemAppearance()
   const desktop = useDesktopSize()
 
@@ -99,7 +100,7 @@ function Content() {
 }
 
 function App() {
-  return <SystemProvider provide={["appearance", "theme", "desktopSize"]} fallback={<p>Loading…</p>}>
+  return <SystemProvider provide={["appearance", "desktopPreferences", "desktopSize"]} fallback={<p>Loading…</p>}>
     <Content />
   </SystemProvider>
 }
@@ -109,7 +110,9 @@ The selection is required and non-empty. Nothing is read or subscribed merely
 because either SDK was imported, and an unselected system value never enters the
 Client. `pointerPosition` is permission-guarded: selecting it does not request
 permission, and resolution fails unless the Program already holds `pointer`.
-The provider renders its fallback until every selected value resolves.
+The provider renders its optional fallback, or `null`, until every selected
+value resolves. `useDesktopPreferences()` is a pure state adapter; document
+presentation remains an explicit concern of the consuming interface.
 
 ```tsx
 import { current } from "@phreshos/client"

package/dist/current-provider.d.ts

@@ -18,7 +18,7 @@ export interface CurrentProviderProperties {
     /** Content rendered after every selected current handle has resolved. */
     readonly children: ReactNode;
     /** Content rendered while selected handles or optional Server readiness resolve. */
-    readonly fallback: ReactNode;
+    readonly fallback?: ReactNode;
     /** Exact current values made available to descendant hooks. */
     readonly provide: CurrentProvision;
     /**

package/dist/current-provider.js

@@ -3,7 +3,7 @@ import { current } from "@phreshos/client";
 const provisionNames = ["program", "process", "parent"];
 const CurrentContext = createContext(null);
 /** Resolves only the current handles explicitly selected by the program. */
-export default function CurrentProvider({ children, fallback, provide, waitServer = false }) {
+export default function CurrentProvider({ children, fallback = null, provide, waitServer = false }) {
     const normalized = normalizeProvision(provide);
     const selectionKey = normalized.join("\0");
     const selection = useMemo(() => normalized, [selectionKey]);

package/dist/main.d.ts

@@ -1,5 +1,5 @@
 export { default as CurrentProvider, useParent, useProcess, useProgram, type CurrentProvision, type CurrentProvisionName, type CurrentProviderProperties } from "./current-provider.js";
-export { default as SystemProvider, usePointerPosition, useDesktopSize, useSystemAppearance, useSystemTheme, type SystemProvision, type SystemProvisionName, type SystemProviderProperties } from "./system-provider.js";
+export { default as SystemProvider, usePointerPosition, useDesktopSize, useDesktopPreferences, useSystemAppearance, type SystemProvision, type SystemProvisionName, type SystemProviderProperties } from "./system-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useObserve } from "./use-observe.js";
 export { default as useProgramState, type ProgramState } from "./use-program-state.js";

package/dist/main.js

@@ -1,5 +1,5 @@
 export { default as CurrentProvider, useParent, useProcess, useProgram } from "./current-provider.js";
-export { default as SystemProvider, usePointerPosition, useDesktopSize, useSystemAppearance, useSystemTheme } from "./system-provider.js";
+export { default as SystemProvider, usePointerPosition, useDesktopSize, useDesktopPreferences, useSystemAppearance } from "./system-provider.js";
 export { default as useSubscribe } from "./use-subscribe.js";
 export { default as useObserve } from "./use-observe.js";
 export { default as useProgramState } from "./use-program-state.js";

package/dist/system-provider.d.ts

@@ -1,12 +1,12 @@
 import { type ReactNode } from "react";
-import { type Appearance, type DesktopSize, type PointerPosition, type Theme } from "@phreshos/client";
-declare const provisionNames: readonly ["appearance", "theme", "desktopSize", "pointerPosition"];
+import { type Appearance, type DesktopPreferences, type DesktopSize, type PointerPosition } from "@phreshos/client";
+declare const provisionNames: readonly ["appearance", "desktopPreferences", "desktopSize", "pointerPosition"];
 /** Requests and follows only the system values explicitly selected by the program. */
 export default function SystemProvider(properties: SystemProviderProperties): import("react").FunctionComponentElement<SelectedSystemProviderProperties>;
 /** Returns the complete unresolved Appearance and follows authoritative updates. */
 export declare function useSystemAppearance(): Appearance;
-/** Returns the effective local Desktop Theme and follows future changes. */
-export declare function useSystemTheme(): Theme;
+/** Returns all effective Desktop preferences and follows authoritative updates. */
+export declare function useDesktopPreferences(): DesktopPreferences;
 /** Returns the selected desktop size and follows future resize events. */
 export declare function useDesktopSize(): DesktopSize;
 /** Returns the selected Pointer position and follows future move events. */
@@ -20,7 +20,7 @@ export interface SystemProviderProperties {
     /** Content rendered after every selected system value has resolved. */
     readonly children: ReactNode;
     /** Content rendered while selected system values resolve. */
-    readonly fallback: ReactNode;
+    readonly fallback?: ReactNode;
     /** Exact system values requested and followed for mounted descendants. */
     readonly provide: SystemProvision;
 }

package/dist/system-provider.js

@@ -1,14 +1,14 @@
 import { createContext, createElement, useContext, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import { system } from "@phreshos/client";
 import LiveSnapshot from "./live-snapshot.js";
-const provisionNames = ["appearance", "theme", "desktopSize", "pointerPosition"];
+const provisionNames = ["appearance", "desktopPreferences", "desktopSize", "pointerPosition"];
 const SystemContext = createContext(null);
 /** Requests and follows only the system values explicitly selected by the program. */
 export default function SystemProvider(properties) {
     const normalized = normalizeProvision(properties.provide);
     const selectionKey = normalized.join("\0");
     const selection = useMemo(() => normalized, [selectionKey]);
-    return createElement(SelectedSystemProvider, { ...properties, key: selectionKey, selection });
+    return createElement(SelectedSystemProvider, { ...properties, fallback: properties.fallback ?? null, key: selectionKey, selection });
 }
 function SelectedSystemProvider({ children, fallback, selection }) {
     const stores = useMemo(() => createStores(selection), [selection]);
@@ -41,9 +41,9 @@ function SelectedSystemProvider({ children, fallback, selection }) {
 export function useSystemAppearance() {
     return useProvided("appearance");
 }
-/** Returns the effective local Desktop Theme and follows future changes. */
-export function useSystemTheme() {
-    return useProvided("theme");
+/** Returns all effective Desktop preferences and follows authoritative updates. */
+export function useDesktopPreferences() {
+    return useProvided("desktopPreferences");
 }
 /** Returns the selected desktop size and follows future resize events. */
 export function useDesktopSize() {
@@ -69,8 +69,8 @@ function createStores(selection) {
             case "appearance":
                 stores.appearance = new LiveSnapshot(() => system.appearance.snapshot(), subscriber => system.appearance.subscribe("change", subscriber));
                 break;
-            case "theme":
-                stores.theme = new LiveSnapshot(() => system.theme.snapshot(), subscriber => system.theme.subscribe("change", subscriber));
+            case "desktopPreferences":
+                stores.desktopPreferences = new LiveSnapshot(() => system.desktopPreferences.snapshot(), subscriber => system.desktopPreferences.subscribe("change", subscriber));
                 break;
             case "desktopSize":
                 stores.desktopSize = new LiveSnapshot(() => system.desktop.size(), subscriber => system.desktop.subscribe("resize", subscriber));
@@ -97,7 +97,7 @@ function normalizeProvision(provide) {
 }
 const hookNames = {
     appearance: "useSystemAppearance",
-    theme: "useSystemTheme",
+    desktopPreferences: "useDesktopPreferences",
     desktopSize: "useDesktopSize",
     pointerPosition: "usePointerPosition"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "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.22",
-    "@phreshos/core": "^0.1.19",
+    "@phreshos/client": "^0.1.23",
+    "@phreshos/core": "^0.1.22",
     "react": "^19.2.0"
   },
   "devDependencies": {
-    "@phreshos/client": "^0.1.22",
-    "@phreshos/core": "^0.1.19",
+    "@phreshos/client": "^0.1.23",
+    "@phreshos/core": "^0.1.22",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",