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

package/dist/index.cjs

@@ -5,7 +5,6 @@
 
 
 
-var _chunkB755PRVJcjs = require('./chunk-B755PRVJ.cjs');
 
 
 
@@ -17,25 +16,26 @@ var _chunkB755PRVJcjs = require('./chunk-B755PRVJ.cjs');
 
 
 
+var _chunkV63JO65Fcjs = require('./chunk-V63JO65F.cjs');
 
 
 
 
-var _chunkNHPQQQ7Pcjs = require('./chunk-NHPQQQ7P.cjs');
 
 
-var _chunkM7P46XKIcjs = require('./chunk-M7P46XKI.cjs');
 
 
 
 
 
+var _chunkAW63PTQ4cjs = require('./chunk-AW63PTQ4.cjs');
 
 
 
 
 
 
+var _chunk3QBT3Q65cjs = require('./chunk-3QBT3Q65.cjs');
 
 
 
@@ -47,4 +47,26 @@ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.HIGHLIGHT_OPACITY = _chunkV63JO65Fcjs.HIGHLIGHT_OPACITY; exports.PRESS_DURATION = _chunkV63JO65Fcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkV63JO65Fcjs.PRESS_SCALE; exports.PressableFeedback = _chunkV63JO65Fcjs.PressableFeedback; exports.RELEASE_DURATION = _chunkV63JO65Fcjs.RELEASE_DURATION; exports.RIPPLE_COVERAGE = _chunkV63JO65Fcjs.RIPPLE_COVERAGE; exports.RIPPLE_DURATION = _chunkV63JO65Fcjs.RIPPLE_DURATION; exports.RIPPLE_OPACITY = _chunkV63JO65Fcjs.RIPPLE_OPACITY; exports.Slot = _chunkV63JO65Fcjs.Slot; exports.ThemeContext = _chunk3QBT3Q65cjs.ThemeContext; exports.XAUIProvider = _chunkAW63PTQ4cjs.XAUIProvider; exports.buildRadius = _chunkAW63PTQ4cjs.buildRadius; exports.buildShadows = _chunkAW63PTQ4cjs.buildShadows; exports.childrenToString = _chunkV63JO65Fcjs.childrenToString; exports.createRecipe = _chunkV63JO65Fcjs.createRecipe; exports.createSlotContext = _chunkV63JO65Fcjs.createSlotContext; exports.createTheme = _chunkAW63PTQ4cjs.createTheme; exports.defaultTheme = _chunkAW63PTQ4cjs.defaultTheme; exports.deriveColors = _chunkAW63PTQ4cjs.deriveColors; exports.deriveTint = _chunk3QBT3Q65cjs.deriveTint; exports.mergeProps = _chunkV63JO65Fcjs.mergeProps; exports.mergeRefs = _chunkV63JO65Fcjs.mergeRefs; exports.palette = _chunkAW63PTQ4cjs.palette; exports.primitives = _chunkAW63PTQ4cjs.primitives; exports.resolveAnimation = _chunkV63JO65Fcjs.resolveAnimation; exports.resolveSlotAnimation = _chunkV63JO65Fcjs.resolveSlotAnimation; exports.sourceKeys = _chunkAW63PTQ4cjs.sourceKeys; exports.tokens = _chunkAW63PTQ4cjs.tokens; exports.useColorMode = _chunk3QBT3Q65cjs.useColorMode; exports.useFeedback = _chunkV63JO65Fcjs.useFeedback; exports.useThemeColor = _chunk3QBT3Q65cjs.useThemeColor; exports.useXAUITheme = _chunk3QBT3Q65cjs.useXAUITheme;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-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 { AnimationConfig, AnimationProp, AsChildProps, Axes, CompoundVariant, FeedbackContext, FeedbackVariant, HIGHLIGHT_OPACITY, MergeableProps, PRESS_DURATION, PRESS_SCALE, PossibleRef, PressableFeedback, PressableFeedbackHighlightProps, PressableFeedbackProps, PressableFeedbackRippleProps, RELEASE_DURATION, RIPPLE_COVERAGE, RIPPLE_DURATION, RIPPLE_OPACITY, Recipe, RecipeConfig, ResolveArgs, ResolvedAnimation, ResolvedSelection, ResolvedStyles, Selection, Slot, SlotAnimation, SlotProps, SlotStyle, SlotStyles, StateName, States, StyleFn, TintArgs, VariantColors, VariantRole, VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs, resolveAnimation, resolveSlotAnimation, useFeedback } from './system/index.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';
+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-C9bFJKFm.cjs';
 import 'react';
+import 'react-native';
+import 'react-native-reanimated';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-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 { AnimationConfig, AnimationProp, AsChildProps, Axes, CompoundVariant, FeedbackContext, FeedbackVariant, HIGHLIGHT_OPACITY, MergeableProps, PRESS_DURATION, PRESS_SCALE, PossibleRef, PressableFeedback, PressableFeedbackHighlightProps, PressableFeedbackProps, PressableFeedbackRippleProps, RELEASE_DURATION, RIPPLE_COVERAGE, RIPPLE_DURATION, RIPPLE_OPACITY, Recipe, RecipeConfig, ResolveArgs, ResolvedAnimation, ResolvedSelection, ResolvedStyles, Selection, Slot, SlotAnimation, SlotProps, SlotStyle, SlotStyles, StateName, States, StyleFn, TintArgs, VariantColors, VariantRole, VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs, resolveAnimation, resolveSlotAnimation, useFeedback } from './system/index.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';
+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-C9bFJKFm.js';
 import 'react';
+import 'react-native';
+import 'react-native-reanimated';

package/dist/index.js

@@ -1,13 +1,23 @@
 import {
+  HIGHLIGHT_OPACITY,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  PressableFeedback,
+  RELEASE_DURATION,
+  RIPPLE_COVERAGE,
+  RIPPLE_DURATION,
+  RIPPLE_OPACITY,
   Slot,
   childrenToString,
   createRecipe,
   createSlotContext,
   mergeProps,
-  mergeRefs
-} from "./chunk-RCP3SD26.js";
+  mergeRefs,
+  resolveAnimation,
+  resolveSlotAnimation,
+  useFeedback
+} from "./chunk-QAMNNTGM.js";
 import {
-  ThemeContext,
   XAUIProvider,
   buildRadius,
   buildShadows,
@@ -17,15 +27,24 @@ import {
   palette,
   primitives,
   sourceKeys,
-  tokens,
+  tokens
+} from "./chunk-2KXQATVL.js";
+import {
+  ThemeContext,
+  deriveTint,
   useColorMode,
   useThemeColor,
   useXAUITheme
-} from "./chunk-PBVPOX7D.js";
-import {
-  deriveTint
-} from "./chunk-RBNCR5KB.js";
+} from "./chunk-X2K2FX3W.js";
 export {
+  HIGHLIGHT_OPACITY,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  PressableFeedback,
+  RELEASE_DURATION,
+  RIPPLE_COVERAGE,
+  RIPPLE_DURATION,
+  RIPPLE_OPACITY,
   Slot,
   ThemeContext,
   XAUIProvider,
@@ -42,9 +61,12 @@ export {
   mergeRefs,
   palette,
   primitives,
+  resolveAnimation,
+  resolveSlotAnimation,
   sourceKeys,
   tokens,
   useColorMode,
+  useFeedback,
   useThemeColor,
   useXAUITheme
 };

package/dist/system/index.cjs

@@ -5,8 +5,6 @@
 
 
 
-var _chunkB755PRVJcjs = require('../chunk-B755PRVJ.cjs');
-require('../chunk-M7P46XKI.cjs');
 
 
 
@@ -14,4 +12,28 @@ require('../chunk-M7P46XKI.cjs');
 
 
 
-exports.Slot = _chunkB755PRVJcjs.Slot; exports.childrenToString = _chunkB755PRVJcjs.childrenToString; exports.createRecipe = _chunkB755PRVJcjs.createRecipe; exports.createSlotContext = _chunkB755PRVJcjs.createSlotContext; exports.mergeProps = _chunkB755PRVJcjs.mergeProps; exports.mergeRefs = _chunkB755PRVJcjs.mergeRefs;
+
+
+
+
+var _chunkV63JO65Fcjs = require('../chunk-V63JO65F.cjs');
+require('../chunk-3QBT3Q65.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.HIGHLIGHT_OPACITY = _chunkV63JO65Fcjs.HIGHLIGHT_OPACITY; exports.PRESS_DURATION = _chunkV63JO65Fcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkV63JO65Fcjs.PRESS_SCALE; exports.PressableFeedback = _chunkV63JO65Fcjs.PressableFeedback; exports.RELEASE_DURATION = _chunkV63JO65Fcjs.RELEASE_DURATION; exports.RIPPLE_COVERAGE = _chunkV63JO65Fcjs.RIPPLE_COVERAGE; exports.RIPPLE_DURATION = _chunkV63JO65Fcjs.RIPPLE_DURATION; exports.RIPPLE_OPACITY = _chunkV63JO65Fcjs.RIPPLE_OPACITY; exports.Slot = _chunkV63JO65Fcjs.Slot; exports.childrenToString = _chunkV63JO65Fcjs.childrenToString; exports.createRecipe = _chunkV63JO65Fcjs.createRecipe; exports.createSlotContext = _chunkV63JO65Fcjs.createSlotContext; exports.mergeProps = _chunkV63JO65Fcjs.mergeProps; exports.mergeRefs = _chunkV63JO65Fcjs.mergeRefs; exports.resolveAnimation = _chunkV63JO65Fcjs.resolveAnimation; exports.resolveSlotAnimation = _chunkV63JO65Fcjs.resolveSlotAnimation; exports.useFeedback = _chunkV63JO65Fcjs.useFeedback;

package/dist/system/index.d.cts

@@ -1,7 +1,186 @@
-import { g as XAUITheme, X as XAUIColors } from '../theme.type-B3ODSLbB.cjs';
-import { ViewStyle, TextStyle } from 'react-native';
 import * as react from 'react';
 import { ReactNode, Provider, Ref, RefCallback } from 'react';
+import * as react_native from 'react-native';
+import { PressableProps, StyleProp, ViewStyle, TextStyle } from 'react-native';
+import { SharedValue } from 'react-native-reanimated';
+import { g as XAUITheme, X as XAUIColors } from '../theme.type-C9bFJKFm.cjs';
+
+/**
+ * What the root does under the finger. `scale-highlight` and `scale-ripple` mount their
+ * overlay themselves; `scale` mounts none, which is what a root picks when it renders its
+ * own `<PressableFeedback.Highlight>` to style it (R1: no prop reaches into another
+ * component's insides).
+ */
+type FeedbackVariant = 'scale-highlight' | 'scale-ripple' | 'scale' | 'none';
+type AnimationConfig = {
+    scale?: boolean;
+    highlight?: boolean;
+    ripple?: boolean;
+};
+/**
+ * `false` and `'disabled'` turn this component's animations off. `'disable-all'` turns
+ * them off for its descendants too — a long list kills every row's worklets with one
+ * prop instead of threading it down. An object switches them off one at a time.
+ */
+type AnimationProp = boolean | 'disabled' | 'disable-all' | AnimationConfig;
+/** `animation` once normalised — what the components actually read. */
+type ResolvedAnimation = {
+    scale: boolean;
+    highlight: boolean;
+    ripple: boolean;
+    /** True when every sub-animation is off: the branch that mounts no worklet at all. */
+    none: boolean;
+    /** Propagated to descendants through context. */
+    disableAll: boolean;
+};
+type PressableFeedbackProps = Omit<PressableProps, 'style' | 'children' | 'disabled'> & {
+    /** Controlled: the root owns the state, because its recipe resolves on it (R5). */
+    isPressed?: boolean;
+    /** R8: `disabled` is not part of the public vocabulary, `isX` is. */
+    isDisabled?: boolean;
+    /**
+     * Merge into the single child instead of rendering a pressable (R12) — **keeping the
+     * feedback**. Swapping this component out for a bare `Slot` would silently drop the
+     * touch feedback of every `asChild` control.
+     */
+    asChild?: boolean;
+    feedbackVariant?: FeedbackVariant;
+    animation?: AnimationProp;
+    style?: StyleProp<ViewStyle>;
+    /**
+     * `Pressable`'s function form is dropped on purpose. It exists to hand the press state
+     * to children; here the root above already owns that state and this publishes it
+     * through context, so the function form would be a second, quieter source of truth.
+     */
+    children?: ReactNode;
+};
+/**
+ * A slot's own animation, overriding the blanket one on the root. `false` switches that
+ * slot off; the object tunes it. Deliberately two knobs rather than a full timing
+ * surface — anything past this is a different animation, and that is a component's job,
+ * not a prop's.
+ */
+type SlotAnimation = boolean | {
+    /** Milliseconds. Falls back to the shared press timing. */
+    duration?: number;
+    /** How far the overlay goes at full press, 0 to 1. */
+    opacity?: number;
+};
+type FeedbackContext = {
+    isPressed: boolean;
+    animation: ResolvedAnimation;
+    /** Absent on the static branch, where nothing animates and no worklet is mounted. */
+    progress?: SharedValue<number>;
+    /**
+     * Bumped on every press-in. The ripple starts from this rather than from a `useEffect`
+     * on `isPressed`: a one-shot driven by a boolean depends on React re-rendering between
+     * the two touch events, and starting it from the event that carries the coordinates is
+     * both simpler and impossible to miss.
+     */
+    pressCount?: SharedValue<number>;
+    /** Where the finger landed, and how big the root is — the ripple needs both. */
+    origin?: SharedValue<{
+        x: number;
+        y: number;
+    }>;
+    size?: SharedValue<{
+        width: number;
+        height: number;
+    }>;
+};
+
+type PressableFeedbackHighlightProps = {
+    style?: StyleProp<ViewStyle>;
+    /** Overrides the blanket `animation` on the root, for this overlay only. */
+    animation?: SlotAnimation;
+};
+/**
+ * The press wash: one flat overlay fading in under the finger.
+ *
+ * It is a **neutral** wash, not the variant's pressed colour. A component picks one or
+ * the other — this overlay, or a `pressed` state in its recipe swapping `bg` for
+ * `bgPressed` — never both, or a pressed button darkens twice.
+ */
+declare function PressableFeedbackHighlight({ style, animation: override, }: PressableFeedbackHighlightProps): react.JSX.Element;
+declare namespace PressableFeedbackHighlight {
+    var displayName: string;
+}
+
+type PressableFeedbackRippleProps = {
+    style?: StyleProp<ViewStyle>;
+    /** Overrides the blanket `animation` on the root, for this overlay only. */
+    animation?: SlotAnimation;
+};
+/**
+ * A circle washing outwards from where the finger landed.
+ *
+ * It is a **one-shot, independent of how long the press lasts**: the wave runs its course
+ * and ends, the way a ripple in water does. Tying it to the press would leave a disc
+ * parked on the control for as long as a finger rests there.
+ *
+ * It needs the root to clip — `PressableFeedback` sets `overflow: 'hidden'` when it
+ * mounts one — and it renders nothing on the static branch: a ripple that cannot expand
+ * is a coloured disc sitting on the control, which reads as a defect rather than as
+ * reduced motion.
+ */
+declare function PressableFeedbackRipple({ style, animation: override, }: PressableFeedbackRippleProps): react.JSX.Element | null;
+declare namespace PressableFeedbackRipple {
+    var displayName: string;
+}
+
+declare const useFeedback: () => FeedbackContext;
+
+/**
+ * The values the v0 tree shipped with (`Animated.spring` to `0.975`, `bounciness: 0`,
+ * over roughly 100ms). Kept identical on purpose: the touch feedback is the part of a
+ * library users feel rather than read, and changing its timing in a rewrite would be a
+ * regression nobody asked for. `bounciness: 0` is why a duration replaces the spring —
+ * a spring with no bounce is a curve.
+ */
+declare const PRESS_SCALE = 0.975;
+declare const PRESS_DURATION = 100;
+declare const RELEASE_DURATION = 150;
+/** How far the wash and the ripple go at full press. */
+declare const HIGHLIGHT_OPACITY = 0.08;
+declare const RIPPLE_OPACITY = 0.12;
+declare const RIPPLE_DURATION = 350;
+/**
+ * The circle's radius as a multiple of the control's diagonal. Above 1 it covers from
+ * any point on the control, so where the finger landed never enters the calculation.
+ */
+declare const RIPPLE_COVERAGE = 1.25;
+/**
+ * One shape out of four accepted ones, so the components read a record instead of
+ * re-deciding what `'disable-all'` meant.
+ *
+ * `inheritedDisableAll` comes from an ancestor that asked for it, and it wins: a list
+ * that switched its rows' animations off cannot be overridden by a row.
+ */
+declare function resolveAnimation(animation: AnimationProp | undefined, inheritedDisableAll?: boolean): ResolvedAnimation;
+type ResolvedSlotAnimation = {
+    enabled: boolean;
+    duration: number;
+    opacity: number;
+};
+/**
+ * A slot's own `animation` over the root's blanket one, with the root winning when it
+ * switched everything off — `animation="disable-all"` on an ancestor cannot be undone by
+ * an overlay that asks nicely.
+ */
+declare function resolveSlotAnimation(override: SlotAnimation | undefined, enabledByRoot: boolean, defaultOpacity: number, defaultDuration?: number): ResolvedSlotAnimation;
+
+declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "disabled" | "style" | "children"> & {
+    isPressed?: boolean;
+    isDisabled?: boolean;
+    asChild?: boolean;
+    feedbackVariant?: FeedbackVariant;
+    animation?: AnimationProp;
+    style?: react_native.StyleProp<react_native.ViewStyle>;
+    children?: react.ReactNode;
+} & react.RefAttributes<react_native.View>> & {
+    Highlight: typeof PressableFeedbackHighlight;
+    Ripple: typeof PressableFeedbackRipple;
+};
 
 /**
  * A slot is a view or a text node, and a recipe writes one object per slot, so the two
@@ -171,4 +350,4 @@ type SlotProps = MergeableProps & {
  */
 declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
 
-export { type AsChildProps, type Axes, type CompoundVariant, type MergeableProps, type PossibleRef, type Recipe, type RecipeConfig, type ResolveArgs, type ResolvedSelection, type ResolvedStyles, type Selection, Slot, type SlotProps, type SlotStyle, type SlotStyles, type StateName, type States, type StyleFn, type TintArgs, type VariantColors, type VariantRole, type VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs };
+export { type AnimationConfig, type AnimationProp, type AsChildProps, type Axes, type CompoundVariant, type FeedbackContext, type FeedbackVariant, HIGHLIGHT_OPACITY, type MergeableProps, PRESS_DURATION, PRESS_SCALE, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, type PressableFeedbackProps, type PressableFeedbackRippleProps, RELEASE_DURATION, RIPPLE_COVERAGE, RIPPLE_DURATION, RIPPLE_OPACITY, type Recipe, type RecipeConfig, type ResolveArgs, type ResolvedAnimation, type ResolvedSelection, type ResolvedStyles, type Selection, Slot, type SlotAnimation, type SlotProps, type SlotStyle, type SlotStyles, type StateName, type States, type StyleFn, type TintArgs, type VariantColors, type VariantRole, type VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs, resolveAnimation, resolveSlotAnimation, useFeedback };

package/dist/system/index.d.ts

@@ -1,7 +1,186 @@
-import { g as XAUITheme, X as XAUIColors } from '../theme.type-B3ODSLbB.js';
-import { ViewStyle, TextStyle } from 'react-native';
 import * as react from 'react';
 import { ReactNode, Provider, Ref, RefCallback } from 'react';
+import * as react_native from 'react-native';
+import { PressableProps, StyleProp, ViewStyle, TextStyle } from 'react-native';
+import { SharedValue } from 'react-native-reanimated';
+import { g as XAUITheme, X as XAUIColors } from '../theme.type-C9bFJKFm.js';
+
+/**
+ * What the root does under the finger. `scale-highlight` and `scale-ripple` mount their
+ * overlay themselves; `scale` mounts none, which is what a root picks when it renders its
+ * own `<PressableFeedback.Highlight>` to style it (R1: no prop reaches into another
+ * component's insides).
+ */
+type FeedbackVariant = 'scale-highlight' | 'scale-ripple' | 'scale' | 'none';
+type AnimationConfig = {
+    scale?: boolean;
+    highlight?: boolean;
+    ripple?: boolean;
+};
+/**
+ * `false` and `'disabled'` turn this component's animations off. `'disable-all'` turns
+ * them off for its descendants too — a long list kills every row's worklets with one
+ * prop instead of threading it down. An object switches them off one at a time.
+ */
+type AnimationProp = boolean | 'disabled' | 'disable-all' | AnimationConfig;
+/** `animation` once normalised — what the components actually read. */
+type ResolvedAnimation = {
+    scale: boolean;
+    highlight: boolean;
+    ripple: boolean;
+    /** True when every sub-animation is off: the branch that mounts no worklet at all. */
+    none: boolean;
+    /** Propagated to descendants through context. */
+    disableAll: boolean;
+};
+type PressableFeedbackProps = Omit<PressableProps, 'style' | 'children' | 'disabled'> & {
+    /** Controlled: the root owns the state, because its recipe resolves on it (R5). */
+    isPressed?: boolean;
+    /** R8: `disabled` is not part of the public vocabulary, `isX` is. */
+    isDisabled?: boolean;
+    /**
+     * Merge into the single child instead of rendering a pressable (R12) — **keeping the
+     * feedback**. Swapping this component out for a bare `Slot` would silently drop the
+     * touch feedback of every `asChild` control.
+     */
+    asChild?: boolean;
+    feedbackVariant?: FeedbackVariant;
+    animation?: AnimationProp;
+    style?: StyleProp<ViewStyle>;
+    /**
+     * `Pressable`'s function form is dropped on purpose. It exists to hand the press state
+     * to children; here the root above already owns that state and this publishes it
+     * through context, so the function form would be a second, quieter source of truth.
+     */
+    children?: ReactNode;
+};
+/**
+ * A slot's own animation, overriding the blanket one on the root. `false` switches that
+ * slot off; the object tunes it. Deliberately two knobs rather than a full timing
+ * surface — anything past this is a different animation, and that is a component's job,
+ * not a prop's.
+ */
+type SlotAnimation = boolean | {
+    /** Milliseconds. Falls back to the shared press timing. */
+    duration?: number;
+    /** How far the overlay goes at full press, 0 to 1. */
+    opacity?: number;
+};
+type FeedbackContext = {
+    isPressed: boolean;
+    animation: ResolvedAnimation;
+    /** Absent on the static branch, where nothing animates and no worklet is mounted. */
+    progress?: SharedValue<number>;
+    /**
+     * Bumped on every press-in. The ripple starts from this rather than from a `useEffect`
+     * on `isPressed`: a one-shot driven by a boolean depends on React re-rendering between
+     * the two touch events, and starting it from the event that carries the coordinates is
+     * both simpler and impossible to miss.
+     */
+    pressCount?: SharedValue<number>;
+    /** Where the finger landed, and how big the root is — the ripple needs both. */
+    origin?: SharedValue<{
+        x: number;
+        y: number;
+    }>;
+    size?: SharedValue<{
+        width: number;
+        height: number;
+    }>;
+};
+
+type PressableFeedbackHighlightProps = {
+    style?: StyleProp<ViewStyle>;
+    /** Overrides the blanket `animation` on the root, for this overlay only. */
+    animation?: SlotAnimation;
+};
+/**
+ * The press wash: one flat overlay fading in under the finger.
+ *
+ * It is a **neutral** wash, not the variant's pressed colour. A component picks one or
+ * the other — this overlay, or a `pressed` state in its recipe swapping `bg` for
+ * `bgPressed` — never both, or a pressed button darkens twice.
+ */
+declare function PressableFeedbackHighlight({ style, animation: override, }: PressableFeedbackHighlightProps): react.JSX.Element;
+declare namespace PressableFeedbackHighlight {
+    var displayName: string;
+}
+
+type PressableFeedbackRippleProps = {
+    style?: StyleProp<ViewStyle>;
+    /** Overrides the blanket `animation` on the root, for this overlay only. */
+    animation?: SlotAnimation;
+};
+/**
+ * A circle washing outwards from where the finger landed.
+ *
+ * It is a **one-shot, independent of how long the press lasts**: the wave runs its course
+ * and ends, the way a ripple in water does. Tying it to the press would leave a disc
+ * parked on the control for as long as a finger rests there.
+ *
+ * It needs the root to clip — `PressableFeedback` sets `overflow: 'hidden'` when it
+ * mounts one — and it renders nothing on the static branch: a ripple that cannot expand
+ * is a coloured disc sitting on the control, which reads as a defect rather than as
+ * reduced motion.
+ */
+declare function PressableFeedbackRipple({ style, animation: override, }: PressableFeedbackRippleProps): react.JSX.Element | null;
+declare namespace PressableFeedbackRipple {
+    var displayName: string;
+}
+
+declare const useFeedback: () => FeedbackContext;
+
+/**
+ * The values the v0 tree shipped with (`Animated.spring` to `0.975`, `bounciness: 0`,
+ * over roughly 100ms). Kept identical on purpose: the touch feedback is the part of a
+ * library users feel rather than read, and changing its timing in a rewrite would be a
+ * regression nobody asked for. `bounciness: 0` is why a duration replaces the spring —
+ * a spring with no bounce is a curve.
+ */
+declare const PRESS_SCALE = 0.975;
+declare const PRESS_DURATION = 100;
+declare const RELEASE_DURATION = 150;
+/** How far the wash and the ripple go at full press. */
+declare const HIGHLIGHT_OPACITY = 0.08;
+declare const RIPPLE_OPACITY = 0.12;
+declare const RIPPLE_DURATION = 350;
+/**
+ * The circle's radius as a multiple of the control's diagonal. Above 1 it covers from
+ * any point on the control, so where the finger landed never enters the calculation.
+ */
+declare const RIPPLE_COVERAGE = 1.25;
+/**
+ * One shape out of four accepted ones, so the components read a record instead of
+ * re-deciding what `'disable-all'` meant.
+ *
+ * `inheritedDisableAll` comes from an ancestor that asked for it, and it wins: a list
+ * that switched its rows' animations off cannot be overridden by a row.
+ */
+declare function resolveAnimation(animation: AnimationProp | undefined, inheritedDisableAll?: boolean): ResolvedAnimation;
+type ResolvedSlotAnimation = {
+    enabled: boolean;
+    duration: number;
+    opacity: number;
+};
+/**
+ * A slot's own `animation` over the root's blanket one, with the root winning when it
+ * switched everything off — `animation="disable-all"` on an ancestor cannot be undone by
+ * an overlay that asks nicely.
+ */
+declare function resolveSlotAnimation(override: SlotAnimation | undefined, enabledByRoot: boolean, defaultOpacity: number, defaultDuration?: number): ResolvedSlotAnimation;
+
+declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "disabled" | "style" | "children"> & {
+    isPressed?: boolean;
+    isDisabled?: boolean;
+    asChild?: boolean;
+    feedbackVariant?: FeedbackVariant;
+    animation?: AnimationProp;
+    style?: react_native.StyleProp<react_native.ViewStyle>;
+    children?: react.ReactNode;
+} & react.RefAttributes<react_native.View>> & {
+    Highlight: typeof PressableFeedbackHighlight;
+    Ripple: typeof PressableFeedbackRipple;
+};
 
 /**
  * A slot is a view or a text node, and a recipe writes one object per slot, so the two
@@ -171,4 +350,4 @@ type SlotProps = MergeableProps & {
  */
 declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
 
-export { type AsChildProps, type Axes, type CompoundVariant, type MergeableProps, type PossibleRef, type Recipe, type RecipeConfig, type ResolveArgs, type ResolvedSelection, type ResolvedStyles, type Selection, Slot, type SlotProps, type SlotStyle, type SlotStyles, type StateName, type States, type StyleFn, type TintArgs, type VariantColors, type VariantRole, type VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs };
+export { type AnimationConfig, type AnimationProp, type AsChildProps, type Axes, type CompoundVariant, type FeedbackContext, type FeedbackVariant, HIGHLIGHT_OPACITY, type MergeableProps, PRESS_DURATION, PRESS_SCALE, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, type PressableFeedbackProps, type PressableFeedbackRippleProps, RELEASE_DURATION, RIPPLE_COVERAGE, RIPPLE_DURATION, RIPPLE_OPACITY, type Recipe, type RecipeConfig, type ResolveArgs, type ResolvedAnimation, type ResolvedSelection, type ResolvedStyles, type Selection, Slot, type SlotAnimation, type SlotProps, type SlotStyle, type SlotStyles, type StateName, type States, type StyleFn, type TintArgs, type VariantColors, type VariantRole, type VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs, resolveAnimation, resolveSlotAnimation, useFeedback };

package/dist/system/index.js

@@ -1,17 +1,39 @@
 import {
+  HIGHLIGHT_OPACITY,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  PressableFeedback,
+  RELEASE_DURATION,
+  RIPPLE_COVERAGE,
+  RIPPLE_DURATION,
+  RIPPLE_OPACITY,
   Slot,
   childrenToString,
   createRecipe,
   createSlotContext,
   mergeProps,
-  mergeRefs
-} from "../chunk-RCP3SD26.js";
-import "../chunk-RBNCR5KB.js";
+  mergeRefs,
+  resolveAnimation,
+  resolveSlotAnimation,
+  useFeedback
+} from "../chunk-QAMNNTGM.js";
+import "../chunk-X2K2FX3W.js";
 export {
+  HIGHLIGHT_OPACITY,
+  PRESS_DURATION,
+  PRESS_SCALE,
+  PressableFeedback,
+  RELEASE_DURATION,
+  RIPPLE_COVERAGE,
+  RIPPLE_DURATION,
+  RIPPLE_OPACITY,
   Slot,
   childrenToString,
   createRecipe,
   createSlotContext,
   mergeProps,
-  mergeRefs
+  mergeRefs,
+  resolveAnimation,
+  resolveSlotAnimation,
+  useFeedback
 };

package/dist/theme/index.cjs

@@ -9,14 +9,14 @@
 
 
 
+var _chunkAW63PTQ4cjs = require('../chunk-AW63PTQ4.cjs');
 
 
 
 
-var _chunkNHPQQQ7Pcjs = require('../chunk-NHPQQQ7P.cjs');
 
 
-var _chunkM7P46XKIcjs = require('../chunk-M7P46XKI.cjs');
+var _chunk3QBT3Q65cjs = require('../chunk-3QBT3Q65.cjs');
 
 
 
@@ -33,4 +33,4 @@ var _chunkM7P46XKIcjs = require('../chunk-M7P46XKI.cjs');
 
 
 
-exports.ThemeContext = _chunkNHPQQQ7Pcjs.ThemeContext; exports.XAUIProvider = _chunkNHPQQQ7Pcjs.XAUIProvider; exports.buildRadius = _chunkNHPQQQ7Pcjs.buildRadius; exports.buildShadows = _chunkNHPQQQ7Pcjs.buildShadows; exports.createTheme = _chunkNHPQQQ7Pcjs.createTheme; exports.defaultTheme = _chunkNHPQQQ7Pcjs.defaultTheme; exports.deriveColors = _chunkNHPQQQ7Pcjs.deriveColors; exports.deriveTint = _chunkM7P46XKIcjs.deriveTint; 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;
+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;

package/dist/theme/index.d.cts

@@ -1,7 +1,8 @@
 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-B3ODSLbB.cjs';
-export { F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, c as XAUIPrimitiveColors, e as XAUIShadow } from '../theme.type-B3ODSLbB.cjs';
+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 'react-native';
 
 /** `'system'` follows the device; the resolved value is never `'system'`. */
 type ColorModePreference = 'light' | 'dark' | 'system';