@phreshos/react-ui 0.1.26 → 0.1.27

package/README.md

@@ -39,19 +39,21 @@ import { Button, Surface } from "@phreshos/react-ui"
 
 Without a provider, components use Core's `defaultAppearance` and reactively
 follow the browser's complete visual preferences. `UIProvider` supplies the
-Appearance, Preferences, and direction shared by a React UI subtree. Omitted
-Appearance and Preferences values inherit from the nearest provider.
+Appearance, Preferences, and direction explicitly established for a React UI
+subtree. Each omitted property inherits independently from the nearest provider
+or follows its own default resolution. A provider with no properties introduces
+no boundary or behavior.
 React UI also exports that same canonical `defaultAppearance` value for callers
 that need it explicitly.
 See [Appearance](https://docs.phreshos.com/system/appearance) for the contract
 interpreted by the provider and components.
 
 React UI is neutral between left-to-right and right-to-left interfaces.
-`UIProvider` creates a direction boundary that participates in native DOM
-inheritance without creating a layout box. Its direction follows `<html dir>`
-unless `direction` supplies an explicit override. React UI reads that same
-resolved value only for JavaScript behavior and portals that cannot rely on
-native inheritance.
+An explicit `UIProvider` direction creates a boundary that participates in
+native DOM inheritance without creating a layout box. When direction is
+omitted, the provider leaves DOM inheritance unchanged. React UI reads the
+nearest explicit direction—or `<html dir>` when there is none—only for
+JavaScript behavior and portals that cannot rely on native inheritance.
 
 ```tsx
 import { UIProvider, Select } from "@phreshos/react-ui"

package/dist/ui-provider.d.ts

@@ -3,8 +3,8 @@ import { type Appearance, type DesktopPreferences as Preferences } from "@phresh
 import { type Direction } from "./direction.js";
 export { useAppearance, useBrowserPreferences, usePreferences, useThemedValue } from "./appearance-context.js";
 export { useDirection, useDocumentDirection } from "./direction.js";
-/** Supplies the complete shared environment of a React UI subtree. */
-export declare function UIProvider({ appearance, children, direction, preferences }: UIProviderProps): import("react").JSX.Element;
+/** Establishes only the explicitly supplied UI values for a React subtree. */
+export declare function UIProvider({ appearance, children, direction, preferences }: UIProviderProps): ReactNode;
 export interface UIProviderProps {
     readonly appearance?: Appearance;
     readonly children: ReactNode;

package/dist/ui-provider.js

@@ -1,18 +1,21 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
 import {} from "@phreshos/core";
-import MotionStyle from "./motion-style.js";
-import { AppearanceContext, PreferencesContext, useAppearance, usePreferences } from "./appearance-context.js";
-import { DirectionContext, useDocumentDirection } from "./direction.js";
+import { AppearanceContext, PreferencesContext } from "./appearance-context.js";
+import { DirectionContext } from "./direction.js";
 export { useAppearance, useBrowserPreferences, usePreferences, useThemedValue } from "./appearance-context.js";
 export { useDirection, useDocumentDirection } from "./direction.js";
 const directionBoundaryStyle = { display: "contents" };
-/** Supplies the complete shared environment of a React UI subtree. */
+/** Establishes only the explicitly supplied UI values for a React subtree. */
 export function UIProvider({ appearance, children, direction, preferences }) {
-    const inheritedAppearance = useAppearance();
-    const inheritedPreferences = usePreferences();
-    const documentDirection = useDocumentDirection();
-    const resolvedAppearance = appearance ?? inheritedAppearance;
-    const resolvedDirection = direction ?? documentDirection;
-    const resolvedPreferences = preferences ?? inheritedPreferences;
-    return _jsx(DirectionContext.Provider, { value: resolvedDirection, children: _jsx("div", { dir: resolvedDirection, style: directionBoundaryStyle, children: _jsx(AppearanceContext.Provider, { value: resolvedAppearance, children: _jsxs(PreferencesContext.Provider, { value: resolvedPreferences, children: [_jsx(MotionStyle, {}), children] }) }) }) });
+    let subtree = children;
+    if (preferences !== undefined) {
+        subtree = _jsx(PreferencesContext.Provider, { value: preferences, children: subtree });
+    }
+    if (appearance !== undefined) {
+        subtree = _jsx(AppearanceContext.Provider, { value: appearance, children: subtree });
+    }
+    if (direction !== undefined) {
+        subtree = _jsx(DirectionContext.Provider, { value: direction, children: _jsx("div", { dir: direction, style: directionBoundaryStyle, children: subtree }) });
+    }
+    return subtree;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react-ui",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "React components for coherent PhreshOS Program interfaces.",
   "type": "module",
   "sideEffects": false,