@xaui/native 0.9.1-alpha.2 → 0.9.1-alpha.21

package/dist/index.cjs

@@ -1,37 +1,41 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
 
+var _chunkAPCBIHLRcjs = require('./chunk-APCBIHLR.cjs');
 
 
 
-var _chunkB755PRVJcjs = require('./chunk-B755PRVJ.cjs');
 
 
 
+var _chunkBPBY7ON7cjs = require('./chunk-BPBY7ON7.cjs');
 
 
 
+var _chunkRRRGLRRPcjs = require('./chunk-RRRGLRRP.cjs');
 
 
 
 
+var _chunkUBA6AEY6cjs = require('./chunk-UBA6AEY6.cjs');
 
 
 
 
 
-var _chunkNHPQQQ7Pcjs = require('./chunk-NHPQQQ7P.cjs');
 
+var _chunk33QILJJHcjs = require('./chunk-33QILJJH.cjs');
 
-var _chunkM7P46XKIcjs = require('./chunk-M7P46XKI.cjs');
 
 
 
+var _chunk2WMVDMFVcjs = require('./chunk-2WMVDMFV.cjs');
 
 
 
 
+var _chunk5LC6KVL3cjs = require('./chunk-5LC6KVL3.cjs');
 
 
 
@@ -47,4 +51,162 @@ var _chunkM7P46XKIcjs = require('./chunk-M7P46XKI.cjs');
 
 
 
-exports.Slot = _chunkB755PRVJcjs.Slot; exports.ThemeContext = _chunkNHPQQQ7Pcjs.ThemeContext; exports.XAUIProvider = _chunkNHPQQQ7Pcjs.XAUIProvider; exports.buildRadius = _chunkNHPQQQ7Pcjs.buildRadius; exports.buildShadows = _chunkNHPQQQ7Pcjs.buildShadows; exports.childrenToString = _chunkB755PRVJcjs.childrenToString; exports.createRecipe = _chunkB755PRVJcjs.createRecipe; exports.createSlotContext = _chunkB755PRVJcjs.createSlotContext; exports.createTheme = _chunkNHPQQQ7Pcjs.createTheme; exports.defaultTheme = _chunkNHPQQQ7Pcjs.defaultTheme; exports.deriveColors = _chunkNHPQQQ7Pcjs.deriveColors; exports.deriveTint = _chunkM7P46XKIcjs.deriveTint; exports.mergeProps = _chunkB755PRVJcjs.mergeProps; exports.mergeRefs = _chunkB755PRVJcjs.mergeRefs; exports.palette = _chunkNHPQQQ7Pcjs.palette; exports.primitives = _chunkNHPQQQ7Pcjs.primitives; exports.sourceKeys = _chunkNHPQQQ7Pcjs.sourceKeys; exports.tokens = _chunkNHPQQQ7Pcjs.tokens; exports.useColorMode = _chunkNHPQQQ7Pcjs.useColorMode; exports.useThemeColor = _chunkNHPQQQ7Pcjs.useThemeColor; exports.useXAUITheme = _chunkNHPQQQ7Pcjs.useXAUITheme;
+
+
+
+
+
+
+var _chunk4NE3SLTMcjs = require('./chunk-4NE3SLTM.cjs');
+
+
+var _chunkUVO4GFSWcjs = require('./chunk-UVO4GFSW.cjs');
+
+
+
+
+
+
+
+var _chunkEVXZGNPAcjs = require('./chunk-EVXZGNPA.cjs');
+
+
+
+
+
+
+
+
+
+
+
+var _chunkUL263KGMcjs = require('./chunk-UL263KGM.cjs');
+
+
+
+
+
+
+var _chunk57SJ4LJFcjs = require('./chunk-57SJ4LJF.cjs');
+require('./chunk-MC7SY2QH.cjs');
+
+// src/hooks/use-controllable-state.ts
+var _react = require('react');
+function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = _react.useState.call(void 0, defaultValue);
+  const isControlled = value !== void 0;
+  const current = isControlled ? value : uncontrolled;
+  useControlWarning(isControlled);
+  const latest = _react.useRef.call(void 0, current);
+  latest.current = current;
+  const onChangeRef = _react.useRef.call(void 0, onChange);
+  onChangeRef.current = onChange;
+  const controlled = _react.useRef.call(void 0, isControlled);
+  controlled.current = isControlled;
+  const set = _react.useCallback.call(void 0, (next) => {
+    const resolved = typeof next === "function" ? next(latest.current) : next;
+    if (resolved === latest.current) return;
+    if (!controlled.current) setUncontrolled(resolved);
+    _optionalChain([onChangeRef, 'access', _ => _.current, 'optionalCall', _2 => _2(resolved)]);
+  }, []);
+  return [current, set];
+}
+function useControlWarning(isControlled) {
+  const wasControlled = _react.useRef.call(void 0, isControlled);
+  if (wasControlled.current !== isControlled) {
+    _chunkRRRGLRRPcjs.warnDev.call(void 0, 
+      `a component switched from ${wasControlled.current ? "controlled" : "uncontrolled"} to ${isControlled ? "controlled" : "uncontrolled"}. Decide for the life of the component: pass \`value\` always, or never. Passing \`undefined\` for a value you do control reads as "uncontrolled" here.`
+    );
+    wasControlled.current = isControlled;
+  }
+}
+
+// src/hooks/use-merged-ref.ts
+
+function useMergedRef(...refs) {
+  return _react.useMemo.call(void 0, () => _chunkEVXZGNPAcjs.mergeRefs.call(void 0, ...refs), refs);
+}
+
+// src/hooks/use-previous.ts
+
+function usePrevious(value) {
+  const previous = _react.useRef.call(void 0, void 0);
+  _react.useEffect.call(void 0, () => {
+    previous.current = value;
+  }, [value]);
+  return previous.current;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.Button = _chunkAPCBIHLRcjs.Button; exports.CARD_BACKGROUND = _chunkBPBY7ON7cjs.CARD_BACKGROUND; exports.Card = _chunkBPBY7ON7cjs.Card; exports.Column = _chunk33QILJJHcjs.Column; exports.FEEDBACK_OVERLAY = _chunk4NE3SLTMcjs.FEEDBACK_OVERLAY; exports.Grid = _chunk33QILJJHcjs.Grid; exports.HIGHLIGHT_DURATION = _chunk4NE3SLTMcjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunk4NE3SLTMcjs.HIGHLIGHT_OPACITY; exports.Icon = _chunk5LC6KVL3cjs.Icon; exports.IconContext = _chunk5LC6KVL3cjs.IconContext; exports.PRESS_DURATION = _chunk4NE3SLTMcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunk4NE3SLTMcjs.PRESS_SCALE; exports.Portal = _chunk2WMVDMFVcjs.Portal; exports.PortalContext = _chunk2WMVDMFVcjs.PortalContext; exports.PortalHost = _chunk2WMVDMFVcjs.PortalHost; exports.PressableFeedback = _chunk4NE3SLTMcjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunk4NE3SLTMcjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunk4NE3SLTMcjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunk4NE3SLTMcjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunk4NE3SLTMcjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunk4NE3SLTMcjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunk4NE3SLTMcjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunk4NE3SLTMcjs.RIPPLE_START_SCALE; exports.Row = _chunk33QILJJHcjs.Row; exports.SCALE_REFERENCE_WIDTH = _chunk4NE3SLTMcjs.SCALE_REFERENCE_WIDTH; exports.Slot = _chunkEVXZGNPAcjs.Slot; exports.Stack = _chunk33QILJJHcjs.Stack; exports.TextSpan = _chunkUBA6AEY6cjs.TextSpan; exports.ThemeContext = _chunk57SJ4LJFcjs.ThemeContext; exports.Typography = _chunkUBA6AEY6cjs.Typography; exports.XAUIProvider = _chunkUL263KGMcjs.XAUIProvider; exports.buildRadius = _chunkUL263KGMcjs.buildRadius; exports.buildShadows = _chunkUL263KGMcjs.buildShadows; exports.buttonRecipe = _chunkAPCBIHLRcjs.buttonRecipe; exports.cardRecipe = _chunkBPBY7ON7cjs.cardRecipe; exports.childrenToString = _chunkEVXZGNPAcjs.childrenToString; exports.createRecipe = _chunkUVO4GFSWcjs.createRecipe; exports.createSlotContext = _chunkEVXZGNPAcjs.createSlotContext; exports.createTheme = _chunkUL263KGMcjs.createTheme; exports.defaultTheme = _chunkUL263KGMcjs.defaultTheme; exports.deriveColors = _chunkUL263KGMcjs.deriveColors; exports.deriveTint = _chunk57SJ4LJFcjs.deriveTint; exports.markBackground = _chunkBPBY7ON7cjs.markBackground; exports.markOverlay = _chunk4NE3SLTMcjs.markOverlay; exports.mergeProps = _chunkEVXZGNPAcjs.mergeProps; exports.mergeRefs = _chunkEVXZGNPAcjs.mergeRefs; exports.palette = _chunkUL263KGMcjs.palette; exports.pressScaleFor = _chunk4NE3SLTMcjs.pressScaleFor; exports.primitives = _chunkUL263KGMcjs.primitives; exports.resolveAnimation = _chunk4NE3SLTMcjs.resolveAnimation; exports.resolveSlotAnimation = _chunk4NE3SLTMcjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunk4NE3SLTMcjs.rippleRadiusFor; exports.sourceKeys = _chunkUL263KGMcjs.sourceKeys; exports.tokens = _chunkUL263KGMcjs.tokens; exports.typographyRecipe = _chunkUBA6AEY6cjs.typographyRecipe; exports.useButton = _chunkAPCBIHLRcjs.useButton; exports.useCard = _chunkBPBY7ON7cjs.useCard; exports.useColorMode = _chunk57SJ4LJFcjs.useColorMode; exports.useControllableState = useControllableState; exports.useFeedback = _chunk4NE3SLTMcjs.useFeedback; exports.useGrid = _chunk33QILJJHcjs.useGrid; exports.useIconContext = _chunk5LC6KVL3cjs.useIconContext; exports.useMergedRef = useMergedRef; exports.usePressState = _chunkRRRGLRRPcjs.usePressState; exports.usePrevious = usePrevious; exports.useStyleProps = _chunkEVXZGNPAcjs.useStyleProps; exports.useThemeColor = _chunk57SJ4LJFcjs.useThemeColor; exports.useXAUITheme = _chunk57SJ4LJFcjs.useXAUITheme;

package/dist/index.d.cts

@@ -1,5 +1,80 @@
-export { AsChildProps, Axes, CompoundVariant, MergeableProps, PossibleRef, Recipe, RecipeConfig, ResolveArgs, ResolvedSelection, ResolvedStyles, Selection, Slot, SlotProps, SlotStyle, SlotStyles, StateName, States, StyleFn, TintArgs, VariantColors, VariantRole, VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs } from './system/index.cjs';
+export { Button, ButtonContextValue, ButtonIconProps, ButtonLabelProps, ButtonProps, ButtonSize, ButtonSlot, ButtonSpinnerProps, ButtonVariant, buttonRecipe, useButton } from './components/button/index.cjs';
+export { CARD_BACKGROUND, Card, CardBackgroundProps, CardBodyProps, CardContextValue, CardDescriptionProps, CardFooterProps, CardHeaderProps, CardProps, CardSize, CardSlot, CardTitleProps, CardVariant, cardRecipe, markBackground, useCard } from './components/card/index.cjs';
+export { TextSpan, TextSpanProps, Typography, TypographyProps, TypographySlot, TypographyVariant, typographyRecipe } from './components/typography/index.cjs';
+export { AxisProps, Column, ColumnProps, Grid, GridContextValue, GridItemProps, GridProps, Row, RowProps, Stack, StackItemProps, StackProps, useGrid } from './components/view/index.cjs';
+import { RefCallback } from 'react';
+import { PossibleRef } from './system/index.cjs';
+export { AsChildProps, FEEDBACK_OVERLAY, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, PortalHostProps, PortalMethods, PortalProps, PressableFeedback, PressableFeedbackHighlightProps, PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, SCALE_REFERENCE_WIDTH, Slot, SlotProps, childrenToString, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps } from './system/index.cjs';
+import { GestureResponderEvent } from 'react-native';
+export { I as IconComponentProps, a as IconContextValue, b as IconProps } from './icon.type-Cs1tMX0W.cjs';
+export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, f as SlotStyle, g as SlotStyles, h as StateName, i as States, j as StyleFn, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from './create-recipe-CPBFg7ym.cjs';
+export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps, V as ViewStyleProps } from './style-props.type-B1BG5TCm.cjs';
 export { ColorModePreference, PaletteFamily, PaletteShade, ThemeContext, XAUIProvider, XAUIProviderProps, XAUITint, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, deriveTint, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme } from './theme/index.cjs';
-export { C as ColorMode, F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, X as XAUIColors, b as XAUIDerivedColors, c as XAUIPrimitiveColors, d as XAUIRadius, e as XAUIShadow, f as XAUISourceColors, g as XAUITheme, h as XAUIThemeConfig, i as XAUIThemeSet } from './theme.type-B3ODSLbB.cjs';
-import 'react-native';
-import 'react';
+export { C as ColorMode, F as FontSizeKey, b as FontWeightKey, R as RadiusKey, S as Size, a as XAUIColors, c as XAUIDerivedColors, d as XAUIPrimitiveColors, e as XAUIRadius, f as XAUIShadow, g as XAUISourceColors, X as XAUITheme, h as XAUIThemeConfig, i as XAUIThemeSet } from './theme.type-C2gNHpEx.cjs';
+export { A as AnimationConfig, a as AnimationProp, F as FeedbackContext, P as PressableFeedbackProps, R as RadiusStyle, b as ResolvedAnimation, c as RippleWave, S as SlotAnimation } from './pressable-feedback.type-wfeiJz5m.cjs';
+import 'react-native-reanimated';
+
+type ControllableStateOptions<T> = {
+    /** Present means controlled: the caller owns the value and this never stores one. */
+    value?: T;
+    /** The starting value when uncontrolled. */
+    defaultValue: T;
+    /** Called with every new value, controlled or not. */
+    onChange?: (value: T) => void;
+};
+/**
+ * One state that works both ways, so a component never has two code paths for "the
+ * caller drives this" and "we do".
+ *
+ * The setter is stable across renders and reads the current value from a ref, so a
+ * handler built on it can be passed to a memoized child without rebuilding it on every
+ * render — which is the whole reason components reach for this rather than a local
+ * `useState` plus an `if`.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange, }: ControllableStateOptions<T>): [T, (next: T | ((current: T) => T)) => void];
+
+/**
+ * `mergeRefs` for a component that renders: memoized on the refs it was given, so React
+ * does not detach and reattach every one of them on each render — which it does whenever
+ * a ref callback changes identity, and which costs a node measurement every time.
+ */
+declare function useMergedRef<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
+
+/**
+ * `null` as much as `undefined`: that is how `PressableProps` types its handlers, and a
+ * root forwarding what it was given should not have to launder them first.
+ */
+type PressHandlers = {
+    onPressIn?: PressHandler | null;
+    onPressOut?: PressHandler | null;
+};
+type PressHandler = (event: GestureResponderEvent) => void;
+/**
+ * The press state a root owns, with the handlers that maintain it.
+ *
+ * It exists because every pressable component needs the same three things and gets one
+ * of them wrong on its own: the state has to be *up here* — the recipe resolves on it
+ * (R5) — the caller's handlers must be **composed, never replaced**, and the returned
+ * handlers must keep their identity so passing them down does not defeat a memo.
+ *
+ * ```tsx
+ * const [isPressed, pressHandlers] = usePressState(props)
+ * const styles = recipe.resolve({ theme, selection, states: { pressed: isPressed } })
+ * <PressableFeedback isPressed={isPressed} {...pressHandlers} />
+ * ```
+ */
+declare function usePressState(handlers?: PressHandlers): [boolean, {
+    onPressIn: PressHandler;
+    onPressOut: PressHandler;
+}];
+
+/**
+ * The value from the render before this one, `undefined` on the first.
+ *
+ * Written in an effect rather than during render on purpose: reading it mid-render would
+ * make "previous" mean something different depending on whether React re-ran the render,
+ * which under StrictMode it does.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+export { type ControllableStateOptions, PossibleRef, type PressHandlers, useControllableState, useMergedRef, usePressState, usePrevious };

package/dist/index.d.ts

@@ -1,5 +1,80 @@
-export { AsChildProps, Axes, CompoundVariant, MergeableProps, PossibleRef, Recipe, RecipeConfig, ResolveArgs, ResolvedSelection, ResolvedStyles, Selection, Slot, SlotProps, SlotStyle, SlotStyles, StateName, States, StyleFn, TintArgs, VariantColors, VariantRole, VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs } from './system/index.js';
+export { Button, ButtonContextValue, ButtonIconProps, ButtonLabelProps, ButtonProps, ButtonSize, ButtonSlot, ButtonSpinnerProps, ButtonVariant, buttonRecipe, useButton } from './components/button/index.js';
+export { CARD_BACKGROUND, Card, CardBackgroundProps, CardBodyProps, CardContextValue, CardDescriptionProps, CardFooterProps, CardHeaderProps, CardProps, CardSize, CardSlot, CardTitleProps, CardVariant, cardRecipe, markBackground, useCard } from './components/card/index.js';
+export { TextSpan, TextSpanProps, Typography, TypographyProps, TypographySlot, TypographyVariant, typographyRecipe } from './components/typography/index.js';
+export { AxisProps, Column, ColumnProps, Grid, GridContextValue, GridItemProps, GridProps, Row, RowProps, Stack, StackItemProps, StackProps, useGrid } from './components/view/index.js';
+import { RefCallback } from 'react';
+import { PossibleRef } from './system/index.js';
+export { AsChildProps, FEEDBACK_OVERLAY, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, PortalHostProps, PortalMethods, PortalProps, PressableFeedback, PressableFeedbackHighlightProps, PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, SCALE_REFERENCE_WIDTH, Slot, SlotProps, childrenToString, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps } from './system/index.js';
+import { GestureResponderEvent } from 'react-native';
+export { I as IconComponentProps, a as IconContextValue, b as IconProps } from './icon.type-BkcEPJbK.js';
+export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, f as SlotStyle, g as SlotStyles, h as StateName, i as States, j as StyleFn, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from './create-recipe-CC3NNCqF.js';
+export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps, V as ViewStyleProps } from './style-props.type-B1BG5TCm.js';
 export { ColorModePreference, PaletteFamily, PaletteShade, ThemeContext, XAUIProvider, XAUIProviderProps, XAUITint, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, deriveTint, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme } from './theme/index.js';
-export { C as ColorMode, F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, X as XAUIColors, b as XAUIDerivedColors, c as XAUIPrimitiveColors, d as XAUIRadius, e as XAUIShadow, f as XAUISourceColors, g as XAUITheme, h as XAUIThemeConfig, i as XAUIThemeSet } from './theme.type-B3ODSLbB.js';
-import 'react-native';
-import 'react';
+export { C as ColorMode, F as FontSizeKey, b as FontWeightKey, R as RadiusKey, S as Size, a as XAUIColors, c as XAUIDerivedColors, d as XAUIPrimitiveColors, e as XAUIRadius, f as XAUIShadow, g as XAUISourceColors, X as XAUITheme, h as XAUIThemeConfig, i as XAUIThemeSet } from './theme.type-C2gNHpEx.js';
+export { A as AnimationConfig, a as AnimationProp, F as FeedbackContext, P as PressableFeedbackProps, R as RadiusStyle, b as ResolvedAnimation, c as RippleWave, S as SlotAnimation } from './pressable-feedback.type-DsvWZXWC.js';
+import 'react-native-reanimated';
+
+type ControllableStateOptions<T> = {
+    /** Present means controlled: the caller owns the value and this never stores one. */
+    value?: T;
+    /** The starting value when uncontrolled. */
+    defaultValue: T;
+    /** Called with every new value, controlled or not. */
+    onChange?: (value: T) => void;
+};
+/**
+ * One state that works both ways, so a component never has two code paths for "the
+ * caller drives this" and "we do".
+ *
+ * The setter is stable across renders and reads the current value from a ref, so a
+ * handler built on it can be passed to a memoized child without rebuilding it on every
+ * render — which is the whole reason components reach for this rather than a local
+ * `useState` plus an `if`.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange, }: ControllableStateOptions<T>): [T, (next: T | ((current: T) => T)) => void];
+
+/**
+ * `mergeRefs` for a component that renders: memoized on the refs it was given, so React
+ * does not detach and reattach every one of them on each render — which it does whenever
+ * a ref callback changes identity, and which costs a node measurement every time.
+ */
+declare function useMergedRef<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
+
+/**
+ * `null` as much as `undefined`: that is how `PressableProps` types its handlers, and a
+ * root forwarding what it was given should not have to launder them first.
+ */
+type PressHandlers = {
+    onPressIn?: PressHandler | null;
+    onPressOut?: PressHandler | null;
+};
+type PressHandler = (event: GestureResponderEvent) => void;
+/**
+ * The press state a root owns, with the handlers that maintain it.
+ *
+ * It exists because every pressable component needs the same three things and gets one
+ * of them wrong on its own: the state has to be *up here* — the recipe resolves on it
+ * (R5) — the caller's handlers must be **composed, never replaced**, and the returned
+ * handlers must keep their identity so passing them down does not defeat a memo.
+ *
+ * ```tsx
+ * const [isPressed, pressHandlers] = usePressState(props)
+ * const styles = recipe.resolve({ theme, selection, states: { pressed: isPressed } })
+ * <PressableFeedback isPressed={isPressed} {...pressHandlers} />
+ * ```
+ */
+declare function usePressState(handlers?: PressHandlers): [boolean, {
+    onPressIn: PressHandler;
+    onPressOut: PressHandler;
+}];
+
+/**
+ * The value from the render before this one, `undefined` on the first.
+ *
+ * Written in an effect rather than during render on purpose: reading it mid-render would
+ * make "previous" mean something different depending on whether React re-ran the render,
+ * which under StrictMode it does.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+export { type ControllableStateOptions, PossibleRef, type PressHandlers, useControllableState, useMergedRef, usePressState, usePrevious };

package/dist/index.js

@@ -1,13 +1,75 @@
+import {
+  Button,
+  buttonRecipe,
+  useButton
+} from "./chunk-ISVUXVFL.js";
+import {
+  CARD_BACKGROUND,
+  Card,
+  cardRecipe,
+  markBackground,
+  useCard
+} from "./chunk-YRCUALUQ.js";
+import {
+  usePressState,
+  warnDev
+} from "./chunk-SGHP76GU.js";
+import {
+  TextSpan,
+  Typography,
+  typographyRecipe
+} from "./chunk-RMLFMRWL.js";
+import {
+  Column,
+  Grid,
+  Row,
+  Stack,
+  useGrid
+} from "./chunk-JXLRHKCQ.js";
+import {
+  Portal,
+  PortalContext,
+  PortalHost
+} from "./chunk-XHZBXYVU.js";
+import {
+  Icon,
+  IconContext,
+  useIconContext
+} from "./chunk-JL27KVRT.js";
+import {
+  FEEDBACK_OVERLAY,
+  HIGHLIGHT_DURATION,
+  HIGHLIGHT_OPACITY,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  PressableFeedback,
+  RIPPLE_CONFIRM_DURATION,
+  RIPPLE_EXPAND_DURATION,
+  RIPPLE_FADE_IN,
+  RIPPLE_FADE_OUT,
+  RIPPLE_FADE_OUT_DELAY,
+  RIPPLE_OPACITY,
+  RIPPLE_START_SCALE,
+  SCALE_REFERENCE_WIDTH,
+  markOverlay,
+  pressScaleFor,
+  resolveAnimation,
+  resolveSlotAnimation,
+  rippleRadiusFor,
+  useFeedback
+} from "./chunk-IBRVMLUF.js";
+import {
+  createRecipe
+} from "./chunk-N7C4UNUL.js";
 import {
   Slot,
   childrenToString,
-  createRecipe,
   createSlotContext,
   mergeProps,
-  mergeRefs
-} from "./chunk-RCP3SD26.js";
+  mergeRefs,
+  useStyleProps
+} from "./chunk-EXX6ATAS.js";
 import {
-  ThemeContext,
   XAUIProvider,
   buildRadius,
   buildShadows,
@@ -17,20 +79,103 @@ import {
   palette,
   primitives,
   sourceKeys,
-  tokens,
+  tokens
+} from "./chunk-TUJBDS5M.js";
+import {
+  ThemeContext,
+  deriveTint,
   useColorMode,
   useThemeColor,
   useXAUITheme
-} from "./chunk-PBVPOX7D.js";
-import {
-  deriveTint
-} from "./chunk-RBNCR5KB.js";
+} from "./chunk-A3EGFI6T.js";
+import "./chunk-GGW42MY4.js";
+
+// src/hooks/use-controllable-state.ts
+import { useCallback, useRef, useState } from "react";
+function useControllableState({
+  value,
+  defaultValue,
+  onChange
+}) {
+  const [uncontrolled, setUncontrolled] = useState(defaultValue);
+  const isControlled = value !== void 0;
+  const current = isControlled ? value : uncontrolled;
+  useControlWarning(isControlled);
+  const latest = useRef(current);
+  latest.current = current;
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const controlled = useRef(isControlled);
+  controlled.current = isControlled;
+  const set = useCallback((next) => {
+    const resolved = typeof next === "function" ? next(latest.current) : next;
+    if (resolved === latest.current) return;
+    if (!controlled.current) setUncontrolled(resolved);
+    onChangeRef.current?.(resolved);
+  }, []);
+  return [current, set];
+}
+function useControlWarning(isControlled) {
+  const wasControlled = useRef(isControlled);
+  if (wasControlled.current !== isControlled) {
+    warnDev(
+      `a component switched from ${wasControlled.current ? "controlled" : "uncontrolled"} to ${isControlled ? "controlled" : "uncontrolled"}. Decide for the life of the component: pass \`value\` always, or never. Passing \`undefined\` for a value you do control reads as "uncontrolled" here.`
+    );
+    wasControlled.current = isControlled;
+  }
+}
+
+// src/hooks/use-merged-ref.ts
+import { useMemo } from "react";
+function useMergedRef(...refs) {
+  return useMemo(() => mergeRefs(...refs), refs);
+}
+
+// src/hooks/use-previous.ts
+import { useEffect, useRef as useRef2 } from "react";
+function usePrevious(value) {
+  const previous = useRef2(void 0);
+  useEffect(() => {
+    previous.current = value;
+  }, [value]);
+  return previous.current;
+}
 export {
+  Button,
+  CARD_BACKGROUND,
+  Card,
+  Column,
+  FEEDBACK_OVERLAY,
+  Grid,
+  HIGHLIGHT_DURATION,
+  HIGHLIGHT_OPACITY,
+  Icon,
+  IconContext,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  Portal,
+  PortalContext,
+  PortalHost,
+  PressableFeedback,
+  RIPPLE_CONFIRM_DURATION,
+  RIPPLE_EXPAND_DURATION,
+  RIPPLE_FADE_IN,
+  RIPPLE_FADE_OUT,
+  RIPPLE_FADE_OUT_DELAY,
+  RIPPLE_OPACITY,
+  RIPPLE_START_SCALE,
+  Row,
+  SCALE_REFERENCE_WIDTH,
   Slot,
+  Stack,
+  TextSpan,
   ThemeContext,
+  Typography,
   XAUIProvider,
   buildRadius,
   buildShadows,
+  buttonRecipe,
+  cardRecipe,
   childrenToString,
   createRecipe,
   createSlotContext,
@@ -38,13 +183,30 @@ export {
   defaultTheme,
   deriveColors,
   deriveTint,
+  markBackground,
+  markOverlay,
   mergeProps,
   mergeRefs,
   palette,
+  pressScaleFor,
   primitives,
+  resolveAnimation,
+  resolveSlotAnimation,
+  rippleRadiusFor,
   sourceKeys,
   tokens,
+  typographyRecipe,
+  useButton,
+  useCard,
   useColorMode,
+  useControllableState,
+  useFeedback,
+  useGrid,
+  useIconContext,
+  useMergedRef,
+  usePressState,
+  usePrevious,
+  useStyleProps,
   useThemeColor,
   useXAUITheme
 };