@xaui/native 0.9.1-alpha.4 → 0.9.1-alpha.40

package/dist/system/index.js

@@ -1,45 +1,114 @@
+import "../chunk-WHJTBTYM.js";
 import {
+  Portal,
+  PortalContext,
+  PortalHost
+} from "../chunk-2PMXMKS5.js";
+import {
+  INDICATOR_ROTATION,
+  INDICATOR_SPRING,
+  anchoredEntering,
+  anchoredExiting,
+  overlayEntering,
+  overlayExiting
+} from "../chunk-64MXEVT3.js";
+import {
+  CloseButton,
+  closeButtonBase
+} from "../chunk-KCMYU7WF.js";
+import {
+  ChevronDownIcon,
+  Icon,
+  IconContext,
+  useIconContext
+} from "../chunk-FHUYHV6J.js";
+import {
+  SelectionFill
+} from "../chunk-BA2DBSAN.js";
+import {
+  FEEDBACK_OVERLAY,
+  HIGHLIGHT_DURATION,
   HIGHLIGHT_OPACITY,
   PRESS_DURATION,
   PRESS_SCALE,
-  Portal,
-  PortalContext,
-  PortalHost,
   PressableFeedback,
-  RELEASE_DURATION,
-  RIPPLE_COVERAGE,
-  RIPPLE_DURATION,
+  RIPPLE_CONFIRM_DURATION,
+  RIPPLE_EXPAND_DURATION,
+  RIPPLE_FADE_IN,
+  RIPPLE_FADE_OUT,
+  RIPPLE_FADE_OUT_DELAY,
   RIPPLE_OPACITY,
-  Slot,
-  childrenToString,
-  createRecipe,
-  createSlotContext,
-  mergeProps,
-  mergeRefs,
+  RIPPLE_START_SCALE,
+  SCALE_REFERENCE_WIDTH,
+  markOverlay,
+  pressScaleFor,
   resolveAnimation,
   resolveSlotAnimation,
+  rippleRadiusFor,
   useFeedback
-} from "../chunk-ECDWSSHJ.js";
-import "../chunk-X2K2FX3W.js";
+} from "../chunk-6UEZJRVI.js";
+import "../chunk-423RQBOX.js";
+import "../chunk-EGLLDKN6.js";
+import {
+  createRecipe,
+  radiusAxis
+} from "../chunk-4GTAZM2C.js";
+import "../chunk-A3EGFI6T.js";
+import {
+  Slot,
+  childrenToString,
+  createSlotContext,
+  mergeProps
+} from "../chunk-K72UDPVN.js";
+import {
+  mergeRefs
+} from "../chunk-36PRYGAM.js";
+import {
+  useStyleProps
+} from "../chunk-M63GFNKV.js";
 export {
+  ChevronDownIcon,
+  CloseButton,
+  FEEDBACK_OVERLAY,
+  HIGHLIGHT_DURATION,
   HIGHLIGHT_OPACITY,
+  INDICATOR_ROTATION,
+  INDICATOR_SPRING,
+  Icon,
+  IconContext,
   PRESS_DURATION,
   PRESS_SCALE,
   Portal,
   PortalContext,
   PortalHost,
   PressableFeedback,
-  RELEASE_DURATION,
-  RIPPLE_COVERAGE,
-  RIPPLE_DURATION,
+  RIPPLE_CONFIRM_DURATION,
+  RIPPLE_EXPAND_DURATION,
+  RIPPLE_FADE_IN,
+  RIPPLE_FADE_OUT,
+  RIPPLE_FADE_OUT_DELAY,
   RIPPLE_OPACITY,
+  RIPPLE_START_SCALE,
+  SCALE_REFERENCE_WIDTH,
+  SelectionFill,
   Slot,
+  anchoredEntering,
+  anchoredExiting,
   childrenToString,
+  closeButtonBase,
   createRecipe,
   createSlotContext,
+  markOverlay,
   mergeProps,
   mergeRefs,
+  overlayEntering,
+  overlayExiting,
+  pressScaleFor,
+  radiusAxis,
   resolveAnimation,
   resolveSlotAnimation,
-  useFeedback
+  rippleRadiusFor,
+  useFeedback,
+  useIconContext,
+  useStyleProps
 };

package/dist/text-field.type-0l73acce.d.ts

@@ -0,0 +1,167 @@
+import { ReactNode } from 'react';
+import { StyleProp, TextStyle, ViewStyle, TextInputProps, TextProps, ViewProps } from 'react-native';
+import { T as TextStyleProps, V as ViewStyleProps } from './style-props.type-CfnoGEP7.js';
+import { S as Size, R as RadiusKey } from './theme.type-C2gNHpEx.js';
+
+type TextFieldSlot = 'root' | 'label' | 'field' | 'textArea' | 'placeholder' | 'description' | 'error' | 'prefix' | 'suffix' | 'icon';
+/**
+ * The library's four emphasis levels, narrowed like the `Card`'s (§1 bis). A field
+ * **reports nothing** — an error is `isInvalid`, which is a state and not a variant — so
+ * `success`, `warning` and `danger` are absent here for the same reason they are there.
+ *
+ * This is where the theme's `field*` family is finally read, and the four names split
+ * HeroUI's two-name `primary | secondary` by saying what each of their ends already is:
+ *
+ * - **`primary`** — the `fieldBackground` fill plus the theme's `field` shadow. HeroUI's
+ *   `primary`, with the elevation their flat token only implies.
+ * - **`secondary`** — the neutral `default` fill. HeroUI's `secondary`, and the default
+ *   here: on a plain background a white field is its border and nothing else, while on a
+ *   card the `fieldBackground` token *is* the card's own colour.
+ * - **`tertiary`** — the border alone, no fill. The same drop the `Button`'s `tertiary`
+ *   makes.
+ * - **`ghost`** — neither. A bare field for a toolbar or an inline edit; it has no border
+ *   to move, so its focus shows in the caret alone.
+ *
+ * The first three name the `fieldBorder` edge and `ghost` gives it up. Its width is the
+ * theme's `borderWidth.field` — HeroUI's `--field-border-width`, which they ship at `0`
+ * and we ship at `1`. That is the one shipped default where the two differ;
+ * `createTheme({ borderWidth: { field: 0 } })` reproduces theirs.
+ */
+type TextFieldVariant = 'primary' | 'secondary' | 'tertiary' | 'ghost';
+/**
+ * Where the label sits relative to the field's box.
+ *
+ * `outside` is the label above the box, in the column's flow. `inside` lifts it into the
+ * box, above the text — the label is taken **out of flow** and placed against the box's
+ * own padding, so the JSX is identical either way and nothing is reparented (R4).
+ *
+ * Because the inside label positions itself against the top of the root, it assumes the
+ * field is the first thing in the column's flow: write `TextField.Description` and
+ * `TextField.Error` after the field, which is where they belong anyway.
+ */
+type TextFieldLabelPlacement = 'outside' | 'inside';
+type TextFieldSize = Size;
+/**
+ * What the `TextField` itself understands. R14 — a name in here is the component's, so the
+ * style prop that shares it is not exposed: `size` is the field's scale and never
+ * `ViewStyle`'s, and `color` is R7's tint.
+ */
+type TextFieldOwnProps = {
+    variant?: TextFieldVariant;
+    /** The field's height, its padding, the gaps and the type. Never width. */
+    size?: TextFieldSize;
+    /** Overrides the `field` radius the theme chose for every size. */
+    radius?: RadiusKey;
+    /** Above the box, or lifted into it. @default 'outside' */
+    labelPlacement?: TextFieldLabelPlacement;
+    /**
+     * A raw tint (`'#7c3aed'`), never a token (R7). It lands where the variant put its
+     * tokens — the fill of a `default`, the border of a `tertiary` — and, because the focus
+     * colour is a role like any other, it is also what the field borders on focus.
+     */
+    color?: string;
+    /**
+     * Paints the border, the label and the description in `danger`, and takes the focus
+     * treatment off: an error outranks focus, and a field that is both should read as
+     * wrong rather than as busy.
+     *
+     * It does **not** mount or unmount `TextField.Error`. That stays the caller's — a slot that
+     * silently renders nothing is a slot you cannot debug.
+     */
+    isInvalid?: boolean;
+    /** Dims the field and makes it uneditable. */
+    isDisabled?: boolean;
+    style?: StyleProp<ViewStyle>;
+    children?: ReactNode;
+};
+/**
+ * R14 — the input's own props, the wrapper `View`'s, and every `ViewStyle` key neither
+ * already claims. **`TextInputProps` are not here**: they belong to `TextField.Field`, which
+ * is the node that has them.
+ */
+type TextFieldProps = TextFieldOwnProps & Omit<ViewProps, keyof TextFieldOwnProps> & Omit<ViewStyleProps, keyof TextFieldOwnProps | keyof ViewProps> & {
+    /** R12 — merge into the single child instead of rendering a `View`. */
+    asChild?: boolean;
+};
+/**
+ * Everything `TextInput` accepts, plus the `TextStyle` keys as props (R14).
+ *
+ * `editable` is absent: it is `disabled` under another name, and R8 keeps that off the
+ * public surface — `isDisabled` on the root is what stops the field.
+ */
+type TextFieldFieldProps = Omit<TextInputProps, 'editable'> & Omit<TextStyleProps, keyof TextInputProps>;
+/** `Text`'s own props win over the `TextStyle` keys of the same name (R14). */
+type TextFieldTextProps = TextProps & Omit<TextStyleProps, keyof TextProps> & {
+    children?: ReactNode;
+};
+type TextFieldLabelProps = TextFieldTextProps;
+type TextFieldDescriptionProps = TextFieldTextProps;
+type TextFieldErrorProps = TextFieldTextProps;
+/**
+ * Read off `TextInput`'s own props rather than spelled out: React Native has renamed the
+ * payload of these two more than once, and a hand-written `NativeSyntheticEvent<…>` here
+ * would be a second declaration free to drift from the node that actually fires them.
+ */
+type FieldFocusEvent = Parameters<NonNullable<TextInputProps['onFocus']>>[0];
+type FieldBlurEvent = Parameters<NonNullable<TextInputProps['onBlur']>>[0];
+/**
+ * R5 — resolved styles, not props for a slot to resolve a second time. Each entry is the
+ * cached `StyleSheet` reference with the uncached tint pass layered over it, so a slot
+ * merges its own `style` on top and does no work of its own.
+ */
+type TextFieldContextValue = {
+    labelStyle: StyleProp<TextStyle>;
+    fieldStyle: StyleProp<TextStyle>;
+    /** Layered *over* `fieldStyle` by `TextField.TextArea`: only what a multiline field adds. */
+    textAreaStyle: StyleProp<TextStyle>;
+    /**
+     * Values, not a style: `rows` is a raw number, so the height it implies is arithmetic
+     * the slot does — and these are the two measurements it needs, flattened once here
+     * rather than in every text area on the screen.
+     */
+    textArea: {
+        lineHeight: number;
+        paddingVertical: number;
+    };
+    descriptionStyle: StyleProp<TextStyle>;
+    errorStyle: StyleProp<TextStyle>;
+    /**
+     * The two decorators of a `FieldGroup`, already pinned to their edge and inset by the
+     * field's own padding. They are resolved here, on the root, because the size that
+     * decides that padding is the root's — the group itself adds no axis of its own.
+     */
+    prefixStyle: StyleProp<ViewStyle>;
+    suffixStyle: StyleProp<ViewStyle>;
+    /**
+     * Values, not a style: an icon is a third party's component, and `size` and `color` are
+     * props it takes rather than a style it accepts. Flattened once here, the way the `Chip`
+     * and the `Alert` publish theirs.
+     */
+    icon: {
+        size: number | undefined;
+        color: string | undefined;
+    };
+    /**
+     * A value and not a style: `placeholderTextColor` is a `TextInput` prop, so the root
+     * flattens its placeholder slot once here rather than in the field.
+     */
+    placeholderTextColor?: string;
+    /**
+     * The focus state lives on the **root**, because the root's recipe resolves on it (R5)
+     * and it needs the value before it renders — but the node that hears the event is
+     * `TextField.Field`, three levels down. These are how it reports back. Their identity is
+     * stable, so publishing them costs no re-render of a memoized slot.
+     */
+    onFieldFocus: (event: FieldFocusEvent) => void;
+    onFieldBlur: (event: FieldBlurEvent) => void;
+    /**
+     * The id the label carries and the field points at, so a screen reader reads "Courriel,
+     * champ de saisie" rather than just the placeholder.
+     */
+    labelId: string;
+    descriptionId: string;
+    isDisabled: boolean;
+    isInvalid: boolean;
+};
+
+export type { TextFieldFieldProps as T, TextFieldProps as a, TextFieldContextValue as b, TextFieldDescriptionProps as c, TextFieldErrorProps as d, TextFieldLabelPlacement as e, TextFieldLabelProps as f, TextFieldSize as g, TextFieldSlot as h, TextFieldVariant as i };

package/dist/text-field.type-DBh06DU5.d.cts

@@ -0,0 +1,167 @@
+import { ReactNode } from 'react';
+import { StyleProp, TextStyle, ViewStyle, TextInputProps, TextProps, ViewProps } from 'react-native';
+import { T as TextStyleProps, V as ViewStyleProps } from './style-props.type-CfnoGEP7.cjs';
+import { S as Size, R as RadiusKey } from './theme.type-C2gNHpEx.cjs';
+
+type TextFieldSlot = 'root' | 'label' | 'field' | 'textArea' | 'placeholder' | 'description' | 'error' | 'prefix' | 'suffix' | 'icon';
+/**
+ * The library's four emphasis levels, narrowed like the `Card`'s (§1 bis). A field
+ * **reports nothing** — an error is `isInvalid`, which is a state and not a variant — so
+ * `success`, `warning` and `danger` are absent here for the same reason they are there.
+ *
+ * This is where the theme's `field*` family is finally read, and the four names split
+ * HeroUI's two-name `primary | secondary` by saying what each of their ends already is:
+ *
+ * - **`primary`** — the `fieldBackground` fill plus the theme's `field` shadow. HeroUI's
+ *   `primary`, with the elevation their flat token only implies.
+ * - **`secondary`** — the neutral `default` fill. HeroUI's `secondary`, and the default
+ *   here: on a plain background a white field is its border and nothing else, while on a
+ *   card the `fieldBackground` token *is* the card's own colour.
+ * - **`tertiary`** — the border alone, no fill. The same drop the `Button`'s `tertiary`
+ *   makes.
+ * - **`ghost`** — neither. A bare field for a toolbar or an inline edit; it has no border
+ *   to move, so its focus shows in the caret alone.
+ *
+ * The first three name the `fieldBorder` edge and `ghost` gives it up. Its width is the
+ * theme's `borderWidth.field` — HeroUI's `--field-border-width`, which they ship at `0`
+ * and we ship at `1`. That is the one shipped default where the two differ;
+ * `createTheme({ borderWidth: { field: 0 } })` reproduces theirs.
+ */
+type TextFieldVariant = 'primary' | 'secondary' | 'tertiary' | 'ghost';
+/**
+ * Where the label sits relative to the field's box.
+ *
+ * `outside` is the label above the box, in the column's flow. `inside` lifts it into the
+ * box, above the text — the label is taken **out of flow** and placed against the box's
+ * own padding, so the JSX is identical either way and nothing is reparented (R4).
+ *
+ * Because the inside label positions itself against the top of the root, it assumes the
+ * field is the first thing in the column's flow: write `TextField.Description` and
+ * `TextField.Error` after the field, which is where they belong anyway.
+ */
+type TextFieldLabelPlacement = 'outside' | 'inside';
+type TextFieldSize = Size;
+/**
+ * What the `TextField` itself understands. R14 — a name in here is the component's, so the
+ * style prop that shares it is not exposed: `size` is the field's scale and never
+ * `ViewStyle`'s, and `color` is R7's tint.
+ */
+type TextFieldOwnProps = {
+    variant?: TextFieldVariant;
+    /** The field's height, its padding, the gaps and the type. Never width. */
+    size?: TextFieldSize;
+    /** Overrides the `field` radius the theme chose for every size. */
+    radius?: RadiusKey;
+    /** Above the box, or lifted into it. @default 'outside' */
+    labelPlacement?: TextFieldLabelPlacement;
+    /**
+     * A raw tint (`'#7c3aed'`), never a token (R7). It lands where the variant put its
+     * tokens — the fill of a `default`, the border of a `tertiary` — and, because the focus
+     * colour is a role like any other, it is also what the field borders on focus.
+     */
+    color?: string;
+    /**
+     * Paints the border, the label and the description in `danger`, and takes the focus
+     * treatment off: an error outranks focus, and a field that is both should read as
+     * wrong rather than as busy.
+     *
+     * It does **not** mount or unmount `TextField.Error`. That stays the caller's — a slot that
+     * silently renders nothing is a slot you cannot debug.
+     */
+    isInvalid?: boolean;
+    /** Dims the field and makes it uneditable. */
+    isDisabled?: boolean;
+    style?: StyleProp<ViewStyle>;
+    children?: ReactNode;
+};
+/**
+ * R14 — the input's own props, the wrapper `View`'s, and every `ViewStyle` key neither
+ * already claims. **`TextInputProps` are not here**: they belong to `TextField.Field`, which
+ * is the node that has them.
+ */
+type TextFieldProps = TextFieldOwnProps & Omit<ViewProps, keyof TextFieldOwnProps> & Omit<ViewStyleProps, keyof TextFieldOwnProps | keyof ViewProps> & {
+    /** R12 — merge into the single child instead of rendering a `View`. */
+    asChild?: boolean;
+};
+/**
+ * Everything `TextInput` accepts, plus the `TextStyle` keys as props (R14).
+ *
+ * `editable` is absent: it is `disabled` under another name, and R8 keeps that off the
+ * public surface — `isDisabled` on the root is what stops the field.
+ */
+type TextFieldFieldProps = Omit<TextInputProps, 'editable'> & Omit<TextStyleProps, keyof TextInputProps>;
+/** `Text`'s own props win over the `TextStyle` keys of the same name (R14). */
+type TextFieldTextProps = TextProps & Omit<TextStyleProps, keyof TextProps> & {
+    children?: ReactNode;
+};
+type TextFieldLabelProps = TextFieldTextProps;
+type TextFieldDescriptionProps = TextFieldTextProps;
+type TextFieldErrorProps = TextFieldTextProps;
+/**
+ * Read off `TextInput`'s own props rather than spelled out: React Native has renamed the
+ * payload of these two more than once, and a hand-written `NativeSyntheticEvent<…>` here
+ * would be a second declaration free to drift from the node that actually fires them.
+ */
+type FieldFocusEvent = Parameters<NonNullable<TextInputProps['onFocus']>>[0];
+type FieldBlurEvent = Parameters<NonNullable<TextInputProps['onBlur']>>[0];
+/**
+ * R5 — resolved styles, not props for a slot to resolve a second time. Each entry is the
+ * cached `StyleSheet` reference with the uncached tint pass layered over it, so a slot
+ * merges its own `style` on top and does no work of its own.
+ */
+type TextFieldContextValue = {
+    labelStyle: StyleProp<TextStyle>;
+    fieldStyle: StyleProp<TextStyle>;
+    /** Layered *over* `fieldStyle` by `TextField.TextArea`: only what a multiline field adds. */
+    textAreaStyle: StyleProp<TextStyle>;
+    /**
+     * Values, not a style: `rows` is a raw number, so the height it implies is arithmetic
+     * the slot does — and these are the two measurements it needs, flattened once here
+     * rather than in every text area on the screen.
+     */
+    textArea: {
+        lineHeight: number;
+        paddingVertical: number;
+    };
+    descriptionStyle: StyleProp<TextStyle>;
+    errorStyle: StyleProp<TextStyle>;
+    /**
+     * The two decorators of a `FieldGroup`, already pinned to their edge and inset by the
+     * field's own padding. They are resolved here, on the root, because the size that
+     * decides that padding is the root's — the group itself adds no axis of its own.
+     */
+    prefixStyle: StyleProp<ViewStyle>;
+    suffixStyle: StyleProp<ViewStyle>;
+    /**
+     * Values, not a style: an icon is a third party's component, and `size` and `color` are
+     * props it takes rather than a style it accepts. Flattened once here, the way the `Chip`
+     * and the `Alert` publish theirs.
+     */
+    icon: {
+        size: number | undefined;
+        color: string | undefined;
+    };
+    /**
+     * A value and not a style: `placeholderTextColor` is a `TextInput` prop, so the root
+     * flattens its placeholder slot once here rather than in the field.
+     */
+    placeholderTextColor?: string;
+    /**
+     * The focus state lives on the **root**, because the root's recipe resolves on it (R5)
+     * and it needs the value before it renders — but the node that hears the event is
+     * `TextField.Field`, three levels down. These are how it reports back. Their identity is
+     * stable, so publishing them costs no re-render of a memoized slot.
+     */
+    onFieldFocus: (event: FieldFocusEvent) => void;
+    onFieldBlur: (event: FieldBlurEvent) => void;
+    /**
+     * The id the label carries and the field points at, so a screen reader reads "Courriel,
+     * champ de saisie" rather than just the placeholder.
+     */
+    labelId: string;
+    descriptionId: string;
+    isDisabled: boolean;
+    isInvalid: boolean;
+};
+
+export type { TextFieldFieldProps as T, TextFieldProps as a, TextFieldContextValue as b, TextFieldDescriptionProps as c, TextFieldErrorProps as d, TextFieldLabelPlacement as e, TextFieldLabelProps as f, TextFieldSize as g, TextFieldSlot as h, TextFieldVariant as i };

package/dist/theme/index.cjs

@@ -9,14 +9,16 @@
 
 
 
-var _chunkAW63PTQ4cjs = require('../chunk-AW63PTQ4.cjs');
+var _chunkACAPTWE3cjs = require('../chunk-ACAPTWE3.cjs');
+require('../chunk-WDDXU3OH.cjs');
 
 
 
 
 
 
-var _chunk3QBT3Q65cjs = require('../chunk-3QBT3Q65.cjs');
+var _chunk57SJ4LJFcjs = require('../chunk-57SJ4LJF.cjs');
+require('../chunk-TK44VBIE.cjs');
 
 
 
@@ -33,4 +35,4 @@ var _chunk3QBT3Q65cjs = require('../chunk-3QBT3Q65.cjs');
 
 
 
-exports.ThemeContext = _chunk3QBT3Q65cjs.ThemeContext; exports.XAUIProvider = _chunkAW63PTQ4cjs.XAUIProvider; exports.buildRadius = _chunkAW63PTQ4cjs.buildRadius; exports.buildShadows = _chunkAW63PTQ4cjs.buildShadows; exports.createTheme = _chunkAW63PTQ4cjs.createTheme; exports.defaultTheme = _chunkAW63PTQ4cjs.defaultTheme; exports.deriveColors = _chunkAW63PTQ4cjs.deriveColors; exports.deriveTint = _chunk3QBT3Q65cjs.deriveTint; exports.palette = _chunkAW63PTQ4cjs.palette; exports.primitives = _chunkAW63PTQ4cjs.primitives; exports.sourceKeys = _chunkAW63PTQ4cjs.sourceKeys; exports.tokens = _chunkAW63PTQ4cjs.tokens; exports.useColorMode = _chunk3QBT3Q65cjs.useColorMode; exports.useThemeColor = _chunk3QBT3Q65cjs.useThemeColor; exports.useXAUITheme = _chunk3QBT3Q65cjs.useXAUITheme;
+exports.ThemeContext = _chunk57SJ4LJFcjs.ThemeContext; exports.XAUIProvider = _chunkACAPTWE3cjs.XAUIProvider; exports.buildRadius = _chunkACAPTWE3cjs.buildRadius; exports.buildShadows = _chunkACAPTWE3cjs.buildShadows; exports.createTheme = _chunkACAPTWE3cjs.createTheme; exports.defaultTheme = _chunkACAPTWE3cjs.defaultTheme; exports.deriveColors = _chunkACAPTWE3cjs.deriveColors; exports.deriveTint = _chunk57SJ4LJFcjs.deriveTint; exports.palette = _chunkACAPTWE3cjs.palette; exports.primitives = _chunkACAPTWE3cjs.primitives; exports.sourceKeys = _chunkACAPTWE3cjs.sourceKeys; exports.tokens = _chunkACAPTWE3cjs.tokens; exports.useColorMode = _chunk57SJ4LJFcjs.useColorMode; exports.useThemeColor = _chunk57SJ4LJFcjs.useThemeColor; exports.useXAUITheme = _chunk57SJ4LJFcjs.useXAUITheme;

package/dist/theme/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { i as XAUIThemeSet, h as XAUIThemeConfig, f as XAUISourceColors, b as XAUIDerivedColors, g as XAUITheme, d as XAUIRadius, C as ColorMode, X as XAUIColors } from '../theme.type-C9bFJKFm.cjs';
-export { F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, c as XAUIPrimitiveColors, e as XAUIShadow } from '../theme.type-C9bFJKFm.cjs';
+import { i as XAUIThemeSet, h as XAUIThemeConfig, g as XAUISourceColors, c as XAUIDerivedColors, X as XAUITheme, e as XAUIRadius, C as ColorMode, a as XAUIColors } from '../theme.type-C2gNHpEx.cjs';
+export { F as FontSizeKey, b as FontWeightKey, R as RadiusKey, S as Size, d as XAUIPrimitiveColors, f as XAUIShadow } from '../theme.type-C2gNHpEx.cjs';
 import 'react-native';
 
 /** `'system'` follows the device; the resolved value is never `'system'`. */
@@ -12,6 +12,14 @@ type XAUIProviderProps = {
     theme?: XAUIThemeSet;
     /** Controlled: the library owns neither the state nor its persistence. */
     colorMode?: ColorModePreference;
+    /**
+     * Mounts the `PortalHost` overlays render into. Set false only to mount one yourself,
+     * somewhere the provider cannot reach — under a gesture root, say. Without a host
+     * anywhere, `Portal` renders nothing and overlays are silently absent.
+     *
+     * @default true
+     */
+    hasPortalHost?: boolean;
 };
 
 /**
@@ -20,8 +28,14 @@ type XAUIProviderProps = {
  * `theme` is expected to come from `createTheme` at module level. The provider selects a
  * mode from an already-resolved set rather than memoizing on the prop's identity — which
  * is what the v0 provider did, rebuilding every style in the app on each parent render.
+ *
+ * It also mounts the `PortalHost` every overlay renders into. That is here rather than in
+ * the app because forgetting it is silent: `Portal` renders nothing outside a host, so a
+ * select would open onto an empty screen with no error to read. An app that needs the
+ * host somewhere else — under a gesture root, or inside its own navigation container —
+ * sets `hasPortalHost={false}` and mounts one itself.
  */
-declare function XAUIProvider({ children, theme, colorMode, }: XAUIProviderProps): react.JSX.Element;
+declare function XAUIProvider({ children, theme, colorMode, hasPortalHost, }: XAUIProviderProps): react.JSX.Element;
 
 /**
  * Build a theme once, at module level:
@@ -44,6 +58,17 @@ declare const defaultTheme: XAUIThemeSet;
  * These are HeroUI's `color-mix(in oklab, …)` formulas transposed to JS, because React
  * Native has no `color-mix()`. Their `-hover` names became `-pressed`: what they feed is
  * the press overlay, and the web name was a leftover.
+ *
+ * **One deliberate divergence: a pressed state always moves towards the mode's ink**
+ * (P2-API-REVIEW §E). Mixing towards the variant's own foreground — which is what their
+ * formula does — makes the direction follow the fill's lightness rather than a decision:
+ * `#9333ea` has near-white text and lightened under the finger in light mode, while
+ * `#c084fc` has dark text and darkened in dark mode. Same component, opposite gesture,
+ * nobody's choice. Towards `foreground` it is one direction — darker in light, lighter in
+ * dark — and the label's contrast rises in both instead of falling in one.
+ *
+ * The neutral fills already did this: `defaultForeground` and `surfaceForeground` *are*
+ * the ink, so only the four saturated intents ever flipped.
  */
 declare function deriveColors(s: XAUISourceColors): XAUIDerivedColors;
 
@@ -380,6 +405,12 @@ declare function buildRadius(base: number): XAUIRadius;
 /**
  * Three roles, not an sm→xl scale — which is what lets dark mode drop the surface shadow
  * entirely instead of shipping a scale that reads as dirt on a dark background.
+ *
+ * `overlay` was heavier: a 24-point blur eight points down at 16 of Android's elevation.
+ * Android draws elevation on its own curve and draws it strongly, so a panel that read as
+ * lifted on iOS read as detached on Android — a dark halo the width of the gap between it
+ * and the field it came out of. Half the elevation and two thirds of the blur still say
+ * "above the page" without the panel looking cut out of it.
  */
 declare function buildShadows(mode: ColorMode): XAUITheme['shadows'];
 
@@ -389,7 +420,7 @@ declare const tokens: {
         readonly foreground: "#18181b";
         readonly surface: "#ffffff";
         readonly surfaceForeground: "#18181b";
-        readonly surfaceSecondary: "#f4f4f5";
+        readonly surfaceSecondary: "#ececee";
         readonly surfaceSecondaryForeground: "#18181b";
         readonly surfaceTertiary: "#e4e4e7";
         readonly surfaceTertiaryForeground: "#18181b";
@@ -397,7 +428,7 @@ declare const tokens: {
         readonly overlayForeground: "#18181b";
         readonly backdrop: "rgba(0, 0, 0, 0.2)";
         readonly muted: "#71717a";
-        readonly default: "#f4f4f5";
+        readonly default: "#e4e4e7";
         readonly defaultForeground: "#18181b";
         readonly accent: "#9333ea";
         readonly accentForeground: "#faf5ff";
@@ -407,7 +438,7 @@ declare const tokens: {
         readonly fieldBorder: "#e4e4e7";
         readonly success: "#15803d";
         readonly successForeground: "#fafafa";
-        readonly warning: "#b45309";
+        readonly warning: "#c2410c";
         readonly warningForeground: "#fafafa";
         readonly danger: "#dc2626";
         readonly dangerForeground: "#fafafa";
@@ -417,24 +448,24 @@ declare const tokens: {
         readonly separator: "#d4d4d8";
         readonly focus: "#9333ea";
         readonly link: "#18181b";
-        readonly accentPressed: "#9c4eee";
-        readonly successPressed: "#378c50";
-        readonly warningPressed: "#bd642f";
-        readonly dangerPressed: "#e2473f";
-        readonly defaultPressed: "#eaeaeb";
+        readonly accentPressed: "#8533d3";
+        readonly successPressed: "#1b753a";
+        readonly warningPressed: "#af3e15";
+        readonly dangerPressed: "#c72927";
+        readonly defaultPressed: "#dbdbde";
         readonly surfacePressed: "#eaeaea";
-        readonly defaultSoft: "rgba(244, 244, 245, 0.5)";
+        readonly defaultSoft: "rgba(228, 228, 231, 0.5)";
         readonly defaultSoftForeground: "#18181b";
-        readonly defaultSoftPressed: "rgba(244, 244, 245, 0.6)";
+        readonly defaultSoftPressed: "rgba(228, 228, 231, 0.6)";
         readonly accentSoft: "rgba(147, 51, 234, 0.15)";
         readonly accentSoftForeground: "#7833bc";
         readonly accentSoftPressed: "rgba(147, 51, 234, 0.2)";
         readonly successSoft: "rgba(21, 128, 61, 0.15)";
         readonly successSoftForeground: "#205f34";
         readonly successSoftPressed: "rgba(21, 128, 61, 0.2)";
-        readonly warningSoft: "rgba(180, 83, 9, 0.15)";
-        readonly warningSoftForeground: "#793f1e";
-        readonly warningSoftPressed: "rgba(180, 83, 9, 0.2)";
+        readonly warningSoft: "rgba(194, 65, 12, 0.15)";
+        readonly warningSoftForeground: "#82361e";
+        readonly warningSoftPressed: "rgba(194, 65, 12, 0.2)";
         readonly dangerSoft: "rgba(220, 38, 38, 0.15)";
         readonly dangerSoftForeground: "#b22b28";
         readonly dangerSoftPressed: "rgba(220, 38, 38, 0.2)";
@@ -477,7 +508,7 @@ declare const tokens: {
         readonly fieldBorder: "#3f3f46";
         readonly success: "#4ade80";
         readonly successForeground: "#18181b";
-        readonly warning: "#fbbf24";
+        readonly warning: "#fb923c";
         readonly warningForeground: "#18181b";
         readonly danger: "#f87171";
         readonly dangerForeground: "#18181b";
@@ -487,10 +518,10 @@ declare const tokens: {
         readonly separator: "#52525b";
         readonly focus: "#c084fc";
         readonly link: "#fafafa";
-        readonly accentPressed: "#ad78e3";
-        readonly successPressed: "#47c875";
-        readonly warningPressed: "#e1ac2b";
-        readonly dangerPressed: "#df6868";
+        readonly accentPressed: "#c691fd";
+        readonly successPressed: "#64e18d";
+        readonly warningPressed: "#fc9d55";
+        readonly dangerPressed: "#fa807e";
         readonly defaultPressed: "#2e2e31";
         readonly surfacePressed: "#27272a";
         readonly defaultSoft: "rgba(39, 39, 42, 0.5)";
@@ -502,9 +533,9 @@ declare const tokens: {
         readonly successSoft: "rgba(74, 222, 128, 0.15)";
         readonly successSoftForeground: "#8de8a6";
         readonly successSoftPressed: "rgba(74, 222, 128, 0.2)";
-        readonly warningSoft: "rgba(251, 191, 36, 0.15)";
-        readonly warningSoftForeground: "#fbd586";
-        readonly warningSoftPressed: "rgba(251, 191, 36, 0.2)";
+        readonly warningSoft: "rgba(251, 146, 60, 0.15)";
+        readonly warningSoftForeground: "#feb887";
+        readonly warningSoftPressed: "rgba(251, 146, 60, 0.2)";
         readonly dangerSoft: "rgba(248, 113, 113, 0.15)";
         readonly dangerSoftForeground: "#fc8f8c";
         readonly dangerSoftPressed: "rgba(248, 113, 113, 0.2)";