@phreshos/react-ui 0.1.36 → 0.1.38

package/dist/tree.js

@@ -1,134 +1,89 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { createContext, forwardRef, useContext, useMemo } from "react";
 import { Button as AriaButton, Collection as AriaCollection, Tree as AriaTree, TreeItem as AriaTreeItem, TreeItemContent as AriaTreeItemContent } from "react-aria-components";
-import { controlOpacity, useControlTheme } from "./control.js";
-import { resolveDirection, useDirection } from "./direction.js";
-import { multipleSelection, singleSelection, stringKey, stringKeys, toAriaSelection } from "./selection.js";
-import { AriaDirectionBoundary } from "./aria-direction.js";
-const TreeThemeContext = createContext(null);
-const TreeRootImplementation = forwardRef(function TreeRoot(properties, ref) {
-    const { className, color, defaultExpanded, defaultValue, disabledValues, expanded, onChange, onExpandedChange, onItemAction, radius = "medium", selectionMode = "none", size = "medium", style, value, ...native } = properties;
-    const theme = useControlTheme({ color, radius, size });
+import { proportionalRadius, transition, useControlMetrics } from "./control/control.js";
+import { itemPaint, itemStyle } from "./control/item.js";
+import { ariaSelection, stringKey, stringKeys } from "./control/selection.js";
+import { AriaDirectionBoundary } from "./foundation/aria-direction.js";
+import { colorOpacity } from "./foundation/color.js";
+import { resolveDirection, useDirection } from "./foundation/direction.js";
+import { dimmedClass } from "./surface/surface.js";
+import { ChevronRight } from "lucide-react";
+import { iconProps } from "./control/icon.js";
+const TreeStyleContext = createContext(null);
+const TreeRootImplementation = forwardRef(function Tree(properties, ref) {
+    const { className, color = "primary", defaultExpanded, defaultValue: _defaultValue, expanded, onAction, onChange: _onChange, onExpandedChange, radius, selectOnPressUp, selectionMode = "none", size, style, value: _value, ...native } = properties;
+    const metrics = useControlMetrics(size, radius);
+    // Items are controls: they take the control radius at their size.
+    const itemRadius = metrics.radius;
     const direction = resolveDirection(native.dir, useDirection());
-    const context = useMemo(() => ({ direction, interactive: selectionMode !== "none" || onItemAction != null, theme }), [direction, onItemAction, selectionMode, theme]);
-    return _jsx(TreeThemeContext.Provider, { value: context, children: _jsx(AriaDirectionBoundary, { direction: direction, children: _jsx(AriaTree, { ...native, ...selectionProperties(properties), ...expansionProperties({ defaultExpanded, expanded, onExpandedChange }), ref: ref, dir: direction, className: className, disabledKeys: disabledValues, selectionMode: selectionMode, onAction: onItemAction == null ? undefined : key => onItemAction(stringKey(key)), style: {
+    const context = useMemo(() => ({ color, direction, interactive: selectionMode !== "none" || onAction != null, metrics, itemRadius }), [color, direction, metrics, itemRadius, onAction, selectionMode]);
+    return _jsx(TreeStyleContext.Provider, { value: context, children: _jsx(AriaDirectionBoundary, { direction: direction, children: _jsx(AriaTree, { ...native, shouldSelectOnPressUp: selectOnPressUp, ...ariaSelection(properties, "none"), ...(expanded !== undefined ? { expandedKeys: new Set(expanded) } : {}), ...(defaultExpanded !== undefined ? { defaultExpandedKeys: new Set(defaultExpanded) } : {}), ...(onExpandedChange !== undefined ? { onExpandedChange: (keys) => onExpandedChange(stringKeys(keys)) } : {}), ref: ref, dir: direction, className: className, onAction: onAction == null ? undefined : key => onAction(stringKey(key)), style: {
                     display: "grid",
                     alignContent: "start",
-                    gap: theme.gap,
+                    gap: 2,
                     minWidth: 0,
-                    padding: theme.gap,
+                    padding: metrics.listInset,
                     boxSizing: "border-box",
                     outline: "none",
                     fontFamily: "inherit",
-                    fontSize: theme.fontSize,
+                    fontSize: metrics.fontSize,
                     ...style
                 } }) }) });
 });
-export const TreeRoot = TreeRootImplementation;
-function selectionProperties(properties) {
-    const selectedKeys = toAriaSelection(properties.value);
-    const defaultSelectedKeys = toAriaSelection(properties.defaultValue);
-    const onSelectionChange = properties.onChange == null
-        ? undefined
-        : (selection) => {
-            if (properties.selectionMode === "multiple") {
-                properties.onChange?.(multipleSelection(selection));
-                return;
-            }
-            if (properties.selectionMode === "single")
-                properties.onChange?.(singleSelection(selection));
-        };
-    return {
-        ...(selectedKeys !== undefined ? { selectedKeys } : {}),
-        ...(defaultSelectedKeys !== undefined ? { defaultSelectedKeys } : {}),
-        ...(onSelectionChange !== undefined ? { onSelectionChange } : {})
-    };
-}
-function expansionProperties({ defaultExpanded, expanded, onExpandedChange }) {
-    return {
-        ...(expanded !== undefined ? { expandedKeys: new Set(expanded) } : {}),
-        ...(defaultExpanded !== undefined ? { defaultExpandedKeys: new Set(defaultExpanded) } : {}),
-        ...(onExpandedChange !== undefined
-            ? { onExpandedChange: (keys) => onExpandedChange(stringKeys(keys)) }
-            : {})
-    };
-}
-const TreeItemImplementation = forwardRef(function TreeItem({ className, disabled = false, onAction, style, ...properties }, ref) {
-    const { interactive, theme } = useTreeTheme();
-    return _jsx(AriaTreeItem, { ...properties, ref: ref, className: className, isDisabled: disabled, onAction: onAction, style: state => {
+/** Tree entries use the collection Item treatment as their own paint. */
+const TreeItemImplementation = forwardRef(function TreeItem({ arrowNavigation, className, disabled = false, expandable, onAction, style, ...properties }, ref) {
+    const { color, interactive, itemRadius, metrics } = useTreeStyle();
+    return _jsx(AriaTreeItem, { ...properties, allowsArrowNavigation: arrowNavigation, hasChildItems: expandable, ref: ref, className: state => dimmedClass(state.isDisabled, className ?? state.defaultClassName) ?? "", isDisabled: disabled, onAction: onAction, style: state => {
             const responds = interactive || onAction != null || state.hasChildItems;
             return {
-                ...theme.transition,
-                display: "flex",
-                alignItems: "center",
-                gap: theme.gap,
-                minWidth: 0,
-                minHeight: theme.height,
-                paddingBlock: 0,
-                paddingInlineEnd: Math.max(8, theme.spacing),
-                paddingInlineStart: Math.max(8, theme.spacing) + Math.max(0, state.level - 1) * theme.spacing,
-                boxSizing: "border-box",
-                borderRadius: theme.radius,
-                outline: state.isFocusVisible ? `1px solid ${theme.focusColor}` : "none",
+                ...itemStyle(metrics, state.isDisabled),
+                ...itemPaint(metrics.visual, color, {
+                    selected: state.isSelected,
+                    hovered: responds && state.isHovered,
+                    pressed: responds && state.isPressed,
+                    focusVisible: false,
+                    disabled: state.isDisabled
+                }),
+                paddingInlineStart: metrics.inset / 2 + Math.max(0, state.level - 1) * metrics.spacing,
+                borderRadius: itemRadius,
+                outline: `3px solid ${state.isFocusVisible ? colorOpacity(metrics.visual.colors.primary, 0.34) : "transparent"}`,
                 outlineOffset: 1,
-                cursor: disabled ? "not-allowed" : responds ? "pointer" : "default",
-                opacity: disabled ? controlOpacity.disabled : 1,
-                userSelect: "none",
-                ...(state.isSelected
-                    ? state.isPressed
-                        ? theme.paints.palette.pressed
-                        : state.isHovered
-                            ? theme.paints.palette.hover
-                            : theme.paints.palette.rest
-                    : state.isHovered && responds
-                        ? theme.paints.subtle.hover
-                        : { background: "transparent", color: "inherit" }),
+                cursor: state.isDisabled ? "not-allowed" : responds ? "pointer" : "default",
                 ...style
             };
         } });
 });
-export const TreeItem = TreeItemImplementation;
-export const TreeContent = forwardRef(function TreeContent({ children }, ref) {
-    const { direction, theme } = useTreeTheme();
+const TreeContent = forwardRef(function TreeContent({ children }, ref) {
+    const { direction, metrics } = useTreeStyle();
+    const box = Math.round(metrics.indicator);
     return _jsx(AriaTreeItemContent, { ref: ref, children: state => _jsxs(_Fragment, { children: [state.hasChildItems
                     ? _jsx(AriaButton, { slot: "chevron", style: ({ isFocusVisible }) => ({
-                            ...theme.transition,
-                            appearance: "none",
                             display: "inline-grid",
                             flex: "0 0 auto",
                             placeItems: "center",
-                            width: theme.indicatorSize,
-                            height: theme.indicatorSize,
+                            width: box,
+                            height: box,
                             padding: 0,
                             border: 0,
-                            borderRadius: theme.radius,
-                            outline: isFocusVisible ? `1px solid ${theme.focusColor}` : "none",
-                            outlineOffset: 1,
+                            borderRadius: proportionalRadius(metrics.visual, box),
+                            outline: `3px solid ${isFocusVisible ? colorOpacity(metrics.visual.colors.primary, 0.34) : "transparent"}`,
                             background: "transparent",
                             color: "inherit",
                             cursor: state.isDisabled ? "not-allowed" : "pointer",
                             font: "inherit"
-                        }), children: _jsx(Chevron, { direction: direction, expanded: state.isExpanded, theme: theme }) })
-                    : _jsx("span", { "aria-hidden": "true", style: { flex: `0 0 ${theme.indicatorSize}px`, width: theme.indicatorSize } }), _jsx("span", { style: { flex: "1 1 auto", minWidth: 0 }, children: typeof children === "function" ? children(state) : children })] }) });
+                        }), children: _jsx(ChevronRight, { ...iconProps(14), style: { ...transition(metrics.visual, "rotate"), rotate: state.isExpanded ? "90deg" : direction === "rtl" ? "180deg" : "0deg" } }) })
+                    : _jsx("span", { "aria-hidden": "true", style: { flex: `0 0 ${box}px` } }), _jsx("span", { style: { flex: "1 1 auto", minWidth: 0, display: "flex", alignItems: "center", gap: metrics.gap }, children: typeof children === "function" ? children(state) : children })] }) });
 });
-function Chevron({ direction, expanded, theme }) {
-    const collapsedRotation = direction === "rtl" ? 180 : 0;
-    return _jsx("svg", { "aria-hidden": "true", width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", style: {
-            ...theme.transition,
-            transitionProperty: "transform",
-            transform: `rotate(${expanded ? 90 : collapsedRotation}deg)`
-        }, children: _jsx("path", { d: "m4 2 4 4-4 4" }) });
+function useTreeStyle() {
+    const context = useContext(TreeStyleContext);
+    if (context == null)
+        throw new Error("Tree parts must be used inside Tree");
+    return context;
 }
-export const TreeCollection = AriaCollection;
-/** Hierarchical navigation with independently controlled expansion, selection, and item actions. */
-export const Tree = Object.assign(TreeRoot, {
-    Item: TreeItem,
+/** Hierarchical navigation with independently controlled expansion, selection, and actions. */
+export const Tree = Object.assign(TreeRootImplementation, {
+    Item: TreeItemImplementation,
     Content: TreeContent,
-    Collection: TreeCollection
+    Collection: AriaCollection
 });
-function useTreeTheme() {
-    const value = useContext(TreeThemeContext);
-    if (value == null)
-        throw new Error("Tree parts must be used inside Tree");
-    return value;
-}

package/dist/window.d.ts

@@ -1,8 +1,8 @@
 import type { HTMLAttributes, ReactNode } from "react";
 import type { BeginWindowMoveGesture } from "@phreshos/core";
-import { type ButtonProps } from "./button.js";
-import { type Color } from "./color.js";
-import { type SurfaceProps } from "./surface.js";
+import { type ButtonActionProps } from "./button.js";
+import { type Color } from "./foundation/color.js";
+import { type SurfaceProps } from "./surface/surface.js";
 /** The material shell that establishes the complete header-and-content layout. */
 export type WindowProps = SurfaceProps;
 /** The remaining window area. Its consumer owns content behavior, including overflow. */
@@ -27,7 +27,7 @@ export interface WindowIdentityProps extends Omit<HTMLAttributes<HTMLDivElement>
 }
 export type WindowCenterProps = HTMLAttributes<HTMLDivElement>;
 export type WindowActionsProps = HTMLAttributes<HTMLDivElement>;
-export type WindowActionProps = Omit<ButtonProps, "size">;
+export type WindowActionProps = Omit<ButtonActionProps, "size">;
 export type WindowControlProps = Omit<WindowActionProps, "children">;
 export interface WindowMaximizeProps extends WindowControlProps {
     readonly maximized?: boolean;

package/dist/window.js

@@ -1,12 +1,15 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { createContext, forwardRef, useContext } from "react";
-import { useResolvedAppearance } from "./appearance-context.js";
 import { Button } from "./button.js";
-import { resolveColor } from "./color.js";
-import { transitionTiming } from "./motion-style.js";
-import { scale } from "./scale.js";
-import { Surface } from "./surface.js";
+import { transition } from "./control/control.js";
+import { resolveColor } from "./foundation/color.js";
+import { headerHeight } from "./foundation/layout.js";
+import { scale } from "./foundation/scale.js";
+import { useVisual } from "./foundation/visual.js";
+import { Surface } from "./surface/surface.js";
 import useWindowMoveHandle from "./use-window-move-handle.js";
+import { ArrowDownLeft, Maximize2, Minimize2, X } from "lucide-react";
+import { iconProps } from "./control/icon.js";
 const HeaderContext = createContext(null);
 function useHeader() {
     const value = useContext(HeaderContext);
@@ -34,17 +37,17 @@ const WindowContent = forwardRef(function WindowContent({ style, ...properties }
 });
 /** The composable top region of a window; its enclosing Surface owns the material. */
 const HeaderRoot = forwardRef(function HeaderRoot({ active = true, beginMoveGesture, children, color, maximized = false, onDoubleClick, onLostPointerCapture, onMaximize, onMoveError, onPointerCancel, onPointerDown, onPointerMove, onPointerUp, style, ...properties }, ref) {
-    const resolved = useResolvedAppearance();
-    const spacing = resolved.appearance.spacing;
-    const foreground = style?.color ?? resolveColor(color ?? "foreground:base", resolved.colors);
+    const visual = useVisual();
+    const spacing = visual.spacing;
+    const foreground = style?.color ?? resolveColor(color ?? "foreground", visual.colors);
     const state = {
         active,
         foreground,
-        iconRadius: scale(resolved.appearance.radius, "xsmall"),
+        iconRadius: scale(visual.radius, "xsmall"),
         maximized,
         onMaximize,
         spacing,
-        transition: transitionTiming(resolved.transaction, resolved.preferences.animations)
+        transition: transition(visual, "opacity")
     };
     const move = useWindowMoveHandle(beginMoveGesture, onMoveError);
     return _jsx(HeaderContext.Provider, { value: state, children: _jsx("div", { ...properties, ref: ref, onPointerDown: event => {
@@ -61,7 +64,7 @@ const HeaderRoot = forwardRef(function HeaderRoot({ active = true, beginMoveGest
                 alignItems: "center",
                 gap: spacing,
                 minWidth: 0,
-                height: 16 + spacing * 2,
+                height: headerHeight(spacing),
                 paddingInline: spacing,
                 flexShrink: 0,
                 userSelect: "none",
@@ -122,21 +125,16 @@ const WindowAction = forwardRef(function WindowAction({ ...properties }, ref) {
     return _jsx(Button, { ...properties, ref: ref, size: "xsmall" });
 });
 const WindowMinimize = forwardRef(function WindowMinimize({ "aria-label": label = "Minimize", preventFocusOnPress = true, ...properties }, ref) {
-    return _jsx(WindowAction, { ...properties, ref: ref, "aria-label": label, preventFocusOnPress: preventFocusOnPress, children: _jsx(ControlIcon, { children: _jsx("path", { d: "M1.5 7.5h7" }) }) });
+    return _jsx(WindowAction, { ...properties, ref: ref, "aria-label": label, preventFocusOnPress: preventFocusOnPress, children: _jsx(ArrowDownLeft, { ...iconProps(14) }) });
 });
 const WindowMaximize = forwardRef(function WindowMaximize({ "aria-label": label, maximized, onPress, ...properties }, ref) {
     const header = useHeader();
     const selected = maximized ?? header.maximized;
-    return _jsx(WindowAction, { ...properties, ref: ref, onPress: onPress ?? header.onMaximize, "aria-label": label ?? (selected ? "Restore" : "Maximize"), children: _jsx(ControlIcon, { children: selected
-                ? _jsx("path", { d: "M1 4h5v5H1zM4 1h5v5H6.5", strokeWidth: "1.3", strokeLinejoin: "round" })
-                : _jsx("path", { d: "M1.5 1.5h7v7h-7z", strokeWidth: "1.3", strokeLinejoin: "round" }) }) });
+    return _jsx(WindowAction, { ...properties, ref: ref, onPress: onPress ?? header.onMaximize, "aria-label": label ?? (selected ? "Restore" : "Maximize"), children: selected ? _jsx(Minimize2, { ...iconProps(14) }) : _jsx(Maximize2, { ...iconProps(14) }) });
 });
-const WindowClose = forwardRef(function WindowClose({ "aria-label": label = "Close", color = "danger:base", preventFocusOnPress = true, ...properties }, ref) {
-    return _jsx(WindowAction, { ...properties, ref: ref, "aria-label": label, color: color, preventFocusOnPress: preventFocusOnPress, children: _jsx(ControlIcon, { children: _jsx("path", { d: "M1.5 1.5 8.5 8.5M8.5 1.5 1.5 8.5" }) }) });
+const WindowClose = forwardRef(function WindowClose({ "aria-label": label = "Close", color = "danger", preventFocusOnPress = true, ...properties }, ref) {
+    return _jsx(WindowAction, { ...properties, ref: ref, "aria-label": label, color: color, preventFocusOnPress: preventFocusOnPress, children: _jsx(X, { ...iconProps(14) }) });
 });
-function ControlIcon({ children }) {
-    return _jsx("svg", { "aria-hidden": "true", width: "10", height: "10", viewBox: "0 0 10 10", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", children: children });
-}
 const Header = Object.assign(HeaderRoot, {
     Identity: WindowIdentity,
     Center: WindowCenter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/react-ui",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "React components for coherent PhreshOS Program interfaces.",
   "type": "module",
   "sideEffects": false,
@@ -57,9 +57,9 @@
   "dependencies": {
     "@base-ui/react": "^1.7.0",
     "@internationalized/date": "^3.12.3",
-    "@phreshos/core": "^0.1.60",
+    "@phreshos/core": "^0.1.62",
     "colorjs.io": "^0.7.1",
-    "motion": "^13.2.0",
+    "lucide-react": "^1.48.0",
     "react-aria": "^3.51.0",
     "react-aria-components": "^1.20.0"
   },

package/dist/appearance-context.d.ts

@@ -1,54 +0,0 @@
-import { type Appearance, type ThemedValue } from "./appearance.js";
-import type { Preferences } from "./preferences.js";
-export declare const AppearanceContext: import("react").Context<Appearance>;
-export interface PreferencesSource {
-    readonly getSnapshot: () => Preferences;
-    readonly getServerSnapshot: () => Preferences;
-    readonly subscribe: (change: () => void) => () => void;
-}
-/** Returns the nearest unresolved appearance, or React UI's default. */
-export declare function useAppearance(): Appearance;
-/** Returns the nearest complete Preferences, or reactively follows the browser. */
-export declare function usePreferences(): Preferences;
-/** Reactively reads the browser's complete visual preferences. */
-export declare function useBrowserPreferences(): Preferences;
-/** Selects the active branch of one complete ThemedValue. */
-export declare function useThemedValue<Value>(value: ThemedValue<Value>): Value;
-/** Resolves one coherent Appearance snapshot for internal component derivation. */
-export declare function useResolvedAppearance(): {
-    appearance: Appearance;
-    preferences: Preferences;
-    colors: Readonly<{
-        background: string;
-        foreground: string;
-        default: string;
-        primary: string;
-        secondary: string;
-        success: string;
-        warning: string;
-        danger: string;
-        info: string;
-    }>;
-    material: Readonly<{
-        grain: number;
-        grainAmount: number;
-        backdrop: number;
-        opacity: number;
-        distortion: number;
-        saturation: number;
-    }>;
-    shadow: Readonly<{
-        x: number;
-        y: number;
-        blur: number;
-        spread: number;
-        opacity: number;
-    }>;
-    transaction: Readonly<{
-        duration: number;
-        easing: import("@phreshos/core").Easing;
-    }>;
-};
-/** Creates a stable source for a complete explicitly supplied Preferences value. */
-export declare function fixedPreferencesSource(preferences: Preferences): PreferencesSource;
-export declare const PreferencesContext: import("react").Context<PreferencesSource>;

package/dist/appearance.d.ts

@@ -1,11 +0,0 @@
-import { appearanceLimits, type Appearance as SystemAppearance, type AppearanceUpdate as SystemAppearanceUpdate, type AppearanceColor, type AppearanceColors, type AppearanceMaterial, type AppearanceRange, type AppearanceShadow, type AppearanceTransaction, type Easing, type ThemedValue } from "@phreshos/core";
-/** Complete visual input consumed by React UI. */
-export type Appearance = Pick<SystemAppearance, "colors" | "spacing" | "radius" | "shadow" | "material" | "transaction">;
-type AppearanceUpdateFields = Pick<SystemAppearanceUpdate, "colors" | "spacing" | "radius" | "shadow" | "material" | "transaction">;
-/** At least one partial visual field recursively merged with the nearest UIProvider. */
-export type AppearanceUpdate = {
-    [Field in keyof AppearanceUpdateFields]-?: Readonly<Required<Pick<AppearanceUpdateFields, Field>> & Omit<AppearanceUpdateFields, Field>>;
-}[keyof AppearanceUpdateFields];
-export { appearanceLimits, type AppearanceColor, type AppearanceColors, type AppearanceMaterial, type AppearanceRange, type AppearanceShadow, type AppearanceTransaction, type Easing, type ThemedValue };
-/** React UI's default visual input, derived from the System default. */
-export declare const defaultAppearance: Appearance;

package/dist/appearance.js

@@ -1,11 +0,0 @@
-import { appearanceLimits, defaultAppearance as systemDefaultAppearance } from "@phreshos/core";
-export { appearanceLimits };
-/** React UI's default visual input, derived from the System default. */
-export const defaultAppearance = Object.freeze({
-    colors: systemDefaultAppearance.colors,
-    spacing: systemDefaultAppearance.spacing,
-    radius: systemDefaultAppearance.radius,
-    shadow: systemDefaultAppearance.shadow,
-    material: systemDefaultAppearance.material,
-    transaction: systemDefaultAppearance.transaction
-});

package/dist/color.d.ts

@@ -1,69 +0,0 @@
-import type { AppearanceColor, AppearanceColors } from "./appearance.js";
-/** A visual treatment derived from one concrete CSS color. */
-export type ColorLevel = "subtle" | "soft" | "base" | "strong" | "intense";
-/** Every visual treatment derived from one concrete CSS color. */
-export type ColorScale = Readonly<Record<ColorLevel, string>>;
-/** One Appearance color and resting level, or a direct CSS color. */
-export type Color = `${AppearanceColor}:${ColorLevel}` | (string & {});
-export declare const defaultColor = "background:base";
-/** Distinguishes derived color levels from direct CSS colors. */
-export declare function isColorLevel(value: string | undefined): value is ColorLevel;
-/** Derives visual treatments while preserving the concrete value at `base`. */
-export declare function color(value: string): ColorScale;
-/** Resolves the same named treatment for solid paint and contrast calculations. */
-export declare function resolveColorLevel(value: string, level: ColorLevel): string;
-/** Returns the complete visual treatments derived from one concrete color. */
-export declare function useColor(value: string): ColorScale;
-/** Returns the readable Appearance content color for one semantic or CSS fill. */
-export declare function useContrastingColor(value: Color): string;
-/** Resolves a semantic color from an already selected Appearance branch. */
-export declare function resolveColor(value: Color | undefined, colors: AppearanceColors): string;
-/** Resolves opaque control paint from an already selected Appearance branch. */
-export declare function resolveSolidColor(value: Color, colors: AppearanceColors): string;
-/** Applies material opacity without restricting the source CSS color syntax. */
-export declare function colorOpacity(value: string, opacity: number): string;
-/** Reads perceptual lightness from a resolved CSS color. */
-export declare function colorLightness(value: string): number;
-/** Orders resolved CSS colors by perceptual lightness, never by their role. */
-export declare function orderColors(first: string, second: string): {
-    lighter: string;
-    darker: string;
-};
-/** Solid controls use opaque, gamut-mapped colors for both paint and contrast. */
-export declare function opaqueColor(value: string): string;
-/** Changes only perceptual lightness; theme names never determine direction. */
-export declare function colorShade(value: string, amount: number): string;
-/** Chooses the perceptually opposite Appearance color for the actual painted fill. */
-export declare function onColor(fill: string, background: string, foreground: string): string;
-/** Chooses readable content when the fill can be evaluated, otherwise preserves Appearance foreground. */
-export declare function contrastingColor(value: Color, colors: AppearanceColors): string;
-/** Solid controls start at base; interaction shades preserve its text choice. */
-export declare function solidColors(base: string, background: string, foreground: string): {
-    rest: {
-        background: string;
-        color: string;
-    };
-    hover: {
-        background: string;
-        color: string;
-    };
-    pressed: {
-        background: string;
-        color: string;
-    };
-};
-/** Low-emphasis interaction paints derived from the same component-owned base. */
-export declare function subtleColors(base: string, background: string, foreground: string): {
-    rest: {
-        background: string;
-        color: string;
-    };
-    hover: {
-        background: string;
-        color: string;
-    };
-    pressed: {
-        background: string;
-        color: string;
-    };
-};