@retray-dev/ui-kit 5.4.0 → 6.1.0

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 import React from 'react';
 import { TouchableOpacityProps, ViewStyle, TextProps as TextProps$1, TextInputProps, TextStyle, ActivityIndicatorProps, ImageSourcePropType } from 'react-native';
-export { BottomSheetModalProvider } from '@gorhom/bottom-sheet';
+import * as sonner_native from 'sonner-native';
+export { toast } from 'sonner-native';
+export { BottomSheetModalProvider, BottomSheetTextInput as SheetTextInput } from '@gorhom/bottom-sheet';
 
 type ThemeColors = {
     background: string;
@@ -15,6 +17,12 @@ type ThemeColors = {
     successForeground: string;
     warning: string;
     warningForeground: string;
+    /** Backdrop/overlay color. Default: 'rgba(0,0,0,0.45)' */
+    overlay?: string;
+    /** Color accent (e.g. Airbnb coral). Default: same as primary */
+    accent?: string;
+    /** Text color on accent background. Default: same as primaryForeground */
+    accentForeground?: string;
 };
 type ResolvedColors = ThemeColors & {
     foregroundSubtle: string;
@@ -27,6 +35,9 @@ type ResolvedColors = ThemeColors & {
     successBorder: string;
     warningTint: string;
     warningBorder: string;
+    overlay: string;
+    accentResolved: string;
+    accentForegroundResolved: string;
     ring: string;
     input: string;
 };
@@ -134,6 +145,8 @@ interface InputProps extends TextInputProps {
     error?: string;
     /** Helper text shown below the input when there is no error. */
     hint?: string;
+    /** Disabled visual state — dimmed appearance, not editable. Also sets `editable={false}`. */
+    disabled?: boolean;
     /** Text or component rendered before the input text. */
     prefix?: React.ReactNode;
     /** Text or component rendered after the input text. */
@@ -163,7 +176,7 @@ interface InputProps extends TextInputProps {
     /** Style for the inner border wrapper (overrides padding, etc). */
     inputWrapperStyle?: ViewStyle;
 }
-declare function Input({ label, error, hint, prefix, suffix, prefixStyle, suffixStyle, prefixIcon, suffixIcon, prefixIconColor, suffixIconColor, type, containerStyle, inputWrapperStyle, style, onFocus, onBlur, secureTextEntry, ...props }: InputProps): React.JSX.Element;
+declare function Input({ label, error, hint, disabled, prefix, suffix, prefixStyle, suffixStyle, prefixIcon, suffixIcon, prefixIconColor, suffixIconColor, type, containerStyle, inputWrapperStyle, style, onFocus, onBlur, secureTextEntry, editable, ...props }: InputProps): React.JSX.Element;
 
 type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline' | 'success' | 'warning' | 'successOutline' | 'destructiveOutline' | 'warningOutline';
 type BadgeSize = 'sm' | 'md' | 'lg';
@@ -296,12 +309,17 @@ interface EmptyStateProps {
     iconColor?: string;
     title: string;
     description?: string;
+    /** Custom action node. Use `actionLabel` + `onAction` for a pre-built primary Button. */
     action?: React.ReactNode;
+    /** Label for a convenience primary Button rendered below description. Ignored in compact size. */
+    actionLabel?: string;
+    /** Called when the convenience action Button is pressed. Required when `actionLabel` is set. */
+    onAction?: () => void;
     /** `compact` hides description/action and uses tighter spacing and a smaller icon. */
     size?: 'default' | 'compact';
     style?: ViewStyle;
 }
-declare function EmptyState({ icon, iconName, iconColor, title, description, action, size, style }: EmptyStateProps): React.JSX.Element;
+declare function EmptyState({ icon, iconName, iconColor, title, description, action, actionLabel, onAction, size, style }: EmptyStateProps): React.JSX.Element;
 
 interface TextareaProps extends TextInputProps {
     label?: string;
@@ -449,20 +467,57 @@ interface SheetProps {
     open: boolean;
     onClose: () => void;
     title?: string;
+    /** Secondary text below title. */
+    subtitle?: string;
+    /** @deprecated Use `subtitle` instead. */
     description?: string;
+    /** Show an X close button in the header. */
+    showCloseButton?: boolean;
     children?: React.ReactNode;
     /** Style for the inner content container. */
     style?: ViewStyle;
-    /** Render children inside BottomSheetScrollView so gestures are handled correctly on both platforms. */
+    /** Style for the content wrapper (outside the scroll container). */
+    contentStyle?: ViewStyle;
+    /** Render children inside BottomSheetScrollView. */
     scrollable?: boolean;
     /** Cap sheet height (dp). Children scroll when content exceeds this value. */
     maxHeight?: number;
-    /** Wrap content in KeyboardAvoidingView. Defaults to platform-appropriate behavior when set. */
-    keyboardBehavior?: 'padding' | 'height' | 'position' | 'none';
-    /** Extra vertical offset for the keyboard avoiding view. */
-    keyboardOffset?: number;
+    /**
+     * Keyboard behavior — how the sheet responds to keyboard appearance.
+     * - 'interactive': offset sheet by keyboard size (default, works on both platforms)
+     * - 'fillParent': extend sheet to fill parent view (can cause restore issues with dynamic sizing)
+     * - 'extend': extend sheet to maximum snap point
+     *
+     * Default: 'interactive' on both platforms.
+     */
+    keyboardBehavior?: 'extend' | 'fillParent' | 'interactive';
+    /**
+     * Keyboard blur behavior — what happens when keyboard dismisses.
+     * - 'none': do nothing
+     * - 'restore': restore sheet to previous position (default)
+     */
+    keyboardBlurBehavior?: 'none' | 'restore';
+    /**
+     * Blur keyboard when user starts dragging the sheet down.
+     * Default: true (recommended for better UX)
+     */
+    enableBlurKeyboardOnGesture?: boolean;
+    /**
+     * Android-only: defines keyboard input mode.
+     * - 'adjustPan': pan the sheet content (default, fixes restore issues with dynamic sizing)
+     * - 'adjustResize': resize the sheet container (can cause transparent gap on dismiss)
+     */
+    android_keyboardInputMode?: 'adjustPan' | 'adjustResize';
+    /** Sticky footer rendered below the scroll area. */
+    footer?: React.ReactNode;
+    /**
+     * Array of snap points for the sheet (e.g., ['50%', '85%'] or [200, 500]).
+     * When provided, disables enableDynamicSizing.
+     * When omitted, sheet uses dynamic sizing (auto-fits content).
+     */
+    snapPoints?: (string | number)[];
 }
-declare function Sheet({ open, onClose, title, description, children, style, scrollable, maxHeight, keyboardBehavior, keyboardOffset, }: SheetProps): React.JSX.Element;
+declare function Sheet({ open, onClose, title, subtitle, description, showCloseButton, children, style, contentStyle, scrollable, maxHeight, keyboardBehavior, keyboardBlurBehavior, enableBlurKeyboardOnGesture, android_keyboardInputMode, footer, snapPoints, }: SheetProps): React.JSX.Element;
 
 interface SelectOption {
     label: string;
@@ -481,38 +536,47 @@ interface SelectProps {
 }
 declare function Select({ options, value, onValueChange, placeholder, label, error, disabled, style, }: SelectProps): React.JSX.Element;
 
-type ToastVariant = 'default' | 'destructive' | 'success' | 'warning';
-interface ToastAction {
-    label: string;
-    onPress: () => void;
-}
-interface ToastItem {
-    id: string;
-    title?: string;
-    description?: string;
-    variant?: ToastVariant;
-    icon?: React.ReactNode;
-    iconName?: string;
-    iconColor?: string;
-    /** Auto-dismiss delay in milliseconds. Defaults to `3000`. */
-    duration?: number;
-    /** Optional inline action button rendered at the end of the toast. */
-    action?: ToastAction;
-}
-interface ToastContextValue {
-    toast: (item: Omit<ToastItem, 'id'>) => void;
-    dismiss: (id: string) => void;
-}
-declare function useToast(): ToastContextValue;
-/**
- * Must wrap the app root alongside ThemeProvider.
- * Renders toasts in an absolute overlay at the top of the screen.
- * Use `useToast()` anywhere inside to trigger toasts.
- */
-interface ToastProviderProps {
+declare function useToast(): {
+    toast: ((message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+        id?: string | number;
+    }) => string | number) & {
+        success: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        info: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        error: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        warning: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        custom: (jsx: React.ReactElement, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        promise: <T>(promise: Promise<T>, options: Omit<{
+            promise: Promise<unknown>;
+            success: (result: any) => string;
+            error: ((error: unknown) => string) | string;
+            loading: string;
+            styles?: {
+                loading?: sonner_native.ToastStyles;
+                success?: sonner_native.ToastStyles;
+                error?: sonner_native.ToastStyles;
+            };
+        }, "promise">) => string | number;
+        loading: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        dismiss: (id?: string | number) => string | number | undefined;
+        wiggle: (id: string | number) => void;
+    };
+    dismiss: (id?: string | number) => string | number | undefined;
+};
+declare function ToastProvider({ children }: {
     children: React.ReactNode;
-}
-declare function ToastProvider({ children }: ToastProviderProps): React.JSX.Element;
+}): React.JSX.Element;
 
 interface CurrencyInputProps {
     value?: string;
@@ -612,6 +676,47 @@ interface ListItemProps {
 }
 declare function ListItem({ leftRender, rightRender, trailing, icon, leftIcon, rightIcon, leftIconColor, rightIconColor, title, subtitle, caption, variant, showChevron, showSeparator, onPress, disabled, style, titleStyle, subtitleStyle, captionStyle, }: ListItemProps): React.JSX.Element;
 
+type MenuItemVariant = 'plain' | 'card';
+interface MenuItemProps {
+    label: string;
+    /** Secondary text rendered below the label. */
+    subtitle?: string;
+    /**
+     * Icon name from `@expo/vector-icons` rendered on the left.
+     * See https://icons.expo.fyi.
+     */
+    iconName?: string;
+    /** Custom icon node rendered on the left. */
+    icon?: React.ReactNode;
+    /** Override icon color. Defaults to `foreground`. */
+    iconColor?: string;
+    /**
+     * Custom content rendered on the right.
+     * When provided, replaces the default chevron.
+     * Use for checkboxes, switches, badges, or other controls.
+     */
+    rightRender?: React.ReactNode;
+    /**
+     * Show chevron on the right. Defaults to `true`.
+     * Ignored when `rightRender` is provided.
+     */
+    showChevron?: boolean;
+    onPress: () => void;
+    disabled?: boolean;
+    /**
+     * - `plain` (default): no background — sits inside a parent surface.
+     * - `card`: standalone surface with background + border.
+     */
+    variant?: MenuItemVariant;
+    /** Visual separator line at the bottom. */
+    showSeparator?: boolean;
+    /** Style applied to the outer container. */
+    style?: ViewStyle;
+    /** Style applied to the label Text. */
+    labelStyle?: TextStyle;
+}
+declare function MenuItem({ label, subtitle, iconName, icon, iconColor, rightRender, showChevron, onPress, disabled, variant, showSeparator, style, labelStyle, }: MenuItemProps): React.JSX.Element;
+
 interface ChipProps {
     label: string;
     selected?: boolean;
@@ -762,11 +867,11 @@ type DetailRowSeparator = 'dotted' | 'solid' | 'dashed' | 'none';
 type DetailRowLabelWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 interface DetailRowProps {
     label: React.ReactNode;
-    value: string;
+    value: string | React.ReactNode;
     /** Dotted/dashed/solid line between label and value. Defaults to 'dotted'. */
     separator?: DetailRowSeparator;
     labelWeight?: DetailRowLabelWeight;
-    /** Semantic color key or hex string for value text. */
+    /** Semantic color key or hex string for value text. Only applies when value is a string. */
     valueColor?: string;
     /** Node rendered left of the label (e.g. Avatar, Icon). */
     leftIcon?: React.ReactNode;
@@ -780,6 +885,7 @@ interface DetailRowProps {
     rightIconColor?: string;
     style?: ViewStyle;
     labelStyle?: TextStyle;
+    /** Only applies when value is a string. */
     valueStyle?: TextStyle;
 }
 declare function DetailRow({ label, value, separator, labelWeight, valueColor, leftIcon, leftIconName, leftIconColor, rightIconName, rightIconColor, style, labelStyle, valueStyle, }: DetailRowProps): React.JSX.Element;
@@ -975,10 +1081,10 @@ declare const TYPOGRAPHY: {
     };
     readonly 'uppercase-tag': {
         readonly fontFamily: "Poppins-Bold";
-        readonly fontSize: 8;
+        readonly fontSize: 10;
         readonly fontWeight: "700";
-        readonly lineHeight: 10;
-        readonly letterSpacing: 0.32;
+        readonly lineHeight: 13;
+        readonly letterSpacing: 0.8;
         readonly textTransform: "uppercase";
     };
     readonly 'button-lg': {
@@ -1005,4 +1111,4 @@ type RadiusKey = keyof Radius;
 type Typography = typeof TYPOGRAPHY;
 type TypographyKey = keyof Typography;
 
-export { Accordion, type AccordionItem, type AccordionProps, AlertBanner, type AlertBannerProps, type AlertBannerVariant, Avatar, type AvatarProps, type AvatarSize, BREAKPOINTS, Badge, type BadgeProps, type BadgeVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, type CategoryItem, CategoryStrip, type CategoryStripProps, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipOption, type ChipProps, type ColorScheme, ConfirmDialog, type ConfirmDialogProps, CurrencyDisplay, type CurrencyDisplayProps, type CurrencyDisplayVariant, CurrencyInput, CurrencyInput as CurrencyInputLarge, type CurrencyInputProps, DetailRow, type DetailRowLabelWeight, type DetailRowProps, type DetailRowSeparator, EmptyState, type EmptyStateProps, ICON_SIZES, Icon, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, type IconFamily, type IconProps, type IconSize, type IconSizeKey, Input, type InputProps, LabelValue, type LabelValueProps, ListItem, type ListItemProps, MediaCard, type MediaCardAspectRatio, type MediaCardProps, MonthPicker, type MonthPickerProps, type MonthPickerValue, Pressable, type PressableProps, Progress, type ProgressProps, RADIUS, RadioGroup, type RadioGroupProps, type RadioOption, type Radius, type RadiusKey, type ResolvedColors, SHADOWS, SPACING, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type Spacing, type SpacingKey, Spinner, type SpinnerProps, type SpinnerSize, Switch, type SwitchProps, TYPOGRAPHY, type TabItem, Tabs, TabsContent, type TabsContentProps, type TabsProps, Text, type TextProps, type TextVariant, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, type ThemeProviderProps, type ToastItem, ToastProvider, type ToastProviderProps, type ToastVariant, Toggle, type ToggleProps, type ToggleSize, type ToggleVariant, type Typography, type TypographyKey, defaultDark, defaultLight, deriveColors, getResponsiveFontSize, renderIcon, useTheme, useToast };
+export { Accordion, type AccordionItem, type AccordionProps, AlertBanner, type AlertBannerProps, type AlertBannerVariant, Avatar, type AvatarProps, type AvatarSize, BREAKPOINTS, Badge, type BadgeProps, type BadgeVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, type CategoryItem, CategoryStrip, type CategoryStripProps, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipOption, type ChipProps, type ColorScheme, ConfirmDialog, type ConfirmDialogProps, CurrencyDisplay, type CurrencyDisplayProps, type CurrencyDisplayVariant, CurrencyInput, CurrencyInput as CurrencyInputLarge, type CurrencyInputProps, DetailRow, type DetailRowLabelWeight, type DetailRowProps, type DetailRowSeparator, EmptyState, type EmptyStateProps, ICON_SIZES, Icon, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, type IconFamily, type IconProps, type IconSize, type IconSizeKey, Input, type InputProps, LabelValue, type LabelValueProps, ListItem, type ListItemProps, MediaCard, type MediaCardAspectRatio, type MediaCardProps, MenuItem, type MenuItemProps, type MenuItemVariant, MonthPicker, type MonthPickerProps, type MonthPickerValue, Pressable, type PressableProps, Progress, type ProgressProps, RADIUS, RadioGroup, type RadioGroupProps, type RadioOption, type Radius, type RadiusKey, type ResolvedColors, SHADOWS, SPACING, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type Spacing, type SpacingKey, Spinner, type SpinnerProps, type SpinnerSize, Switch, type SwitchProps, TYPOGRAPHY, type TabItem, Tabs, TabsContent, type TabsContentProps, type TabsProps, Text, type TextProps, type TextVariant, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, type ThemeProviderProps, ToastProvider, Toggle, type ToggleProps, type ToggleSize, type ToggleVariant, type Typography, type TypographyKey, defaultDark, defaultLight, deriveColors, getResponsiveFontSize, renderIcon, useTheme, useToast };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import React from 'react';
 import { TouchableOpacityProps, ViewStyle, TextProps as TextProps$1, TextInputProps, TextStyle, ActivityIndicatorProps, ImageSourcePropType } from 'react-native';
-export { BottomSheetModalProvider } from '@gorhom/bottom-sheet';
+import * as sonner_native from 'sonner-native';
+export { toast } from 'sonner-native';
+export { BottomSheetModalProvider, BottomSheetTextInput as SheetTextInput } from '@gorhom/bottom-sheet';
 
 type ThemeColors = {
     background: string;
@@ -15,6 +17,12 @@ type ThemeColors = {
     successForeground: string;
     warning: string;
     warningForeground: string;
+    /** Backdrop/overlay color. Default: 'rgba(0,0,0,0.45)' */
+    overlay?: string;
+    /** Color accent (e.g. Airbnb coral). Default: same as primary */
+    accent?: string;
+    /** Text color on accent background. Default: same as primaryForeground */
+    accentForeground?: string;
 };
 type ResolvedColors = ThemeColors & {
     foregroundSubtle: string;
@@ -27,6 +35,9 @@ type ResolvedColors = ThemeColors & {
     successBorder: string;
     warningTint: string;
     warningBorder: string;
+    overlay: string;
+    accentResolved: string;
+    accentForegroundResolved: string;
     ring: string;
     input: string;
 };
@@ -134,6 +145,8 @@ interface InputProps extends TextInputProps {
     error?: string;
     /** Helper text shown below the input when there is no error. */
     hint?: string;
+    /** Disabled visual state — dimmed appearance, not editable. Also sets `editable={false}`. */
+    disabled?: boolean;
     /** Text or component rendered before the input text. */
     prefix?: React.ReactNode;
     /** Text or component rendered after the input text. */
@@ -163,7 +176,7 @@ interface InputProps extends TextInputProps {
     /** Style for the inner border wrapper (overrides padding, etc). */
     inputWrapperStyle?: ViewStyle;
 }
-declare function Input({ label, error, hint, prefix, suffix, prefixStyle, suffixStyle, prefixIcon, suffixIcon, prefixIconColor, suffixIconColor, type, containerStyle, inputWrapperStyle, style, onFocus, onBlur, secureTextEntry, ...props }: InputProps): React.JSX.Element;
+declare function Input({ label, error, hint, disabled, prefix, suffix, prefixStyle, suffixStyle, prefixIcon, suffixIcon, prefixIconColor, suffixIconColor, type, containerStyle, inputWrapperStyle, style, onFocus, onBlur, secureTextEntry, editable, ...props }: InputProps): React.JSX.Element;
 
 type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline' | 'success' | 'warning' | 'successOutline' | 'destructiveOutline' | 'warningOutline';
 type BadgeSize = 'sm' | 'md' | 'lg';
@@ -296,12 +309,17 @@ interface EmptyStateProps {
     iconColor?: string;
     title: string;
     description?: string;
+    /** Custom action node. Use `actionLabel` + `onAction` for a pre-built primary Button. */
     action?: React.ReactNode;
+    /** Label for a convenience primary Button rendered below description. Ignored in compact size. */
+    actionLabel?: string;
+    /** Called when the convenience action Button is pressed. Required when `actionLabel` is set. */
+    onAction?: () => void;
     /** `compact` hides description/action and uses tighter spacing and a smaller icon. */
     size?: 'default' | 'compact';
     style?: ViewStyle;
 }
-declare function EmptyState({ icon, iconName, iconColor, title, description, action, size, style }: EmptyStateProps): React.JSX.Element;
+declare function EmptyState({ icon, iconName, iconColor, title, description, action, actionLabel, onAction, size, style }: EmptyStateProps): React.JSX.Element;
 
 interface TextareaProps extends TextInputProps {
     label?: string;
@@ -449,20 +467,57 @@ interface SheetProps {
     open: boolean;
     onClose: () => void;
     title?: string;
+    /** Secondary text below title. */
+    subtitle?: string;
+    /** @deprecated Use `subtitle` instead. */
     description?: string;
+    /** Show an X close button in the header. */
+    showCloseButton?: boolean;
     children?: React.ReactNode;
     /** Style for the inner content container. */
     style?: ViewStyle;
-    /** Render children inside BottomSheetScrollView so gestures are handled correctly on both platforms. */
+    /** Style for the content wrapper (outside the scroll container). */
+    contentStyle?: ViewStyle;
+    /** Render children inside BottomSheetScrollView. */
     scrollable?: boolean;
     /** Cap sheet height (dp). Children scroll when content exceeds this value. */
     maxHeight?: number;
-    /** Wrap content in KeyboardAvoidingView. Defaults to platform-appropriate behavior when set. */
-    keyboardBehavior?: 'padding' | 'height' | 'position' | 'none';
-    /** Extra vertical offset for the keyboard avoiding view. */
-    keyboardOffset?: number;
+    /**
+     * Keyboard behavior — how the sheet responds to keyboard appearance.
+     * - 'interactive': offset sheet by keyboard size (default, works on both platforms)
+     * - 'fillParent': extend sheet to fill parent view (can cause restore issues with dynamic sizing)
+     * - 'extend': extend sheet to maximum snap point
+     *
+     * Default: 'interactive' on both platforms.
+     */
+    keyboardBehavior?: 'extend' | 'fillParent' | 'interactive';
+    /**
+     * Keyboard blur behavior — what happens when keyboard dismisses.
+     * - 'none': do nothing
+     * - 'restore': restore sheet to previous position (default)
+     */
+    keyboardBlurBehavior?: 'none' | 'restore';
+    /**
+     * Blur keyboard when user starts dragging the sheet down.
+     * Default: true (recommended for better UX)
+     */
+    enableBlurKeyboardOnGesture?: boolean;
+    /**
+     * Android-only: defines keyboard input mode.
+     * - 'adjustPan': pan the sheet content (default, fixes restore issues with dynamic sizing)
+     * - 'adjustResize': resize the sheet container (can cause transparent gap on dismiss)
+     */
+    android_keyboardInputMode?: 'adjustPan' | 'adjustResize';
+    /** Sticky footer rendered below the scroll area. */
+    footer?: React.ReactNode;
+    /**
+     * Array of snap points for the sheet (e.g., ['50%', '85%'] or [200, 500]).
+     * When provided, disables enableDynamicSizing.
+     * When omitted, sheet uses dynamic sizing (auto-fits content).
+     */
+    snapPoints?: (string | number)[];
 }
-declare function Sheet({ open, onClose, title, description, children, style, scrollable, maxHeight, keyboardBehavior, keyboardOffset, }: SheetProps): React.JSX.Element;
+declare function Sheet({ open, onClose, title, subtitle, description, showCloseButton, children, style, contentStyle, scrollable, maxHeight, keyboardBehavior, keyboardBlurBehavior, enableBlurKeyboardOnGesture, android_keyboardInputMode, footer, snapPoints, }: SheetProps): React.JSX.Element;
 
 interface SelectOption {
     label: string;
@@ -481,38 +536,47 @@ interface SelectProps {
 }
 declare function Select({ options, value, onValueChange, placeholder, label, error, disabled, style, }: SelectProps): React.JSX.Element;
 
-type ToastVariant = 'default' | 'destructive' | 'success' | 'warning';
-interface ToastAction {
-    label: string;
-    onPress: () => void;
-}
-interface ToastItem {
-    id: string;
-    title?: string;
-    description?: string;
-    variant?: ToastVariant;
-    icon?: React.ReactNode;
-    iconName?: string;
-    iconColor?: string;
-    /** Auto-dismiss delay in milliseconds. Defaults to `3000`. */
-    duration?: number;
-    /** Optional inline action button rendered at the end of the toast. */
-    action?: ToastAction;
-}
-interface ToastContextValue {
-    toast: (item: Omit<ToastItem, 'id'>) => void;
-    dismiss: (id: string) => void;
-}
-declare function useToast(): ToastContextValue;
-/**
- * Must wrap the app root alongside ThemeProvider.
- * Renders toasts in an absolute overlay at the top of the screen.
- * Use `useToast()` anywhere inside to trigger toasts.
- */
-interface ToastProviderProps {
+declare function useToast(): {
+    toast: ((message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+        id?: string | number;
+    }) => string | number) & {
+        success: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        info: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        error: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        warning: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        custom: (jsx: React.ReactElement, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        promise: <T>(promise: Promise<T>, options: Omit<{
+            promise: Promise<unknown>;
+            success: (result: any) => string;
+            error: ((error: unknown) => string) | string;
+            loading: string;
+            styles?: {
+                loading?: sonner_native.ToastStyles;
+                success?: sonner_native.ToastStyles;
+                error?: sonner_native.ToastStyles;
+            };
+        }, "promise">) => string | number;
+        loading: (message: string, data?: Omit<sonner_native.ToastProps, "title" | "type" | "variant" | "id" | "jsx" | "promise"> & {
+            id?: string | number;
+        }) => string | number;
+        dismiss: (id?: string | number) => string | number | undefined;
+        wiggle: (id: string | number) => void;
+    };
+    dismiss: (id?: string | number) => string | number | undefined;
+};
+declare function ToastProvider({ children }: {
     children: React.ReactNode;
-}
-declare function ToastProvider({ children }: ToastProviderProps): React.JSX.Element;
+}): React.JSX.Element;
 
 interface CurrencyInputProps {
     value?: string;
@@ -612,6 +676,47 @@ interface ListItemProps {
 }
 declare function ListItem({ leftRender, rightRender, trailing, icon, leftIcon, rightIcon, leftIconColor, rightIconColor, title, subtitle, caption, variant, showChevron, showSeparator, onPress, disabled, style, titleStyle, subtitleStyle, captionStyle, }: ListItemProps): React.JSX.Element;
 
+type MenuItemVariant = 'plain' | 'card';
+interface MenuItemProps {
+    label: string;
+    /** Secondary text rendered below the label. */
+    subtitle?: string;
+    /**
+     * Icon name from `@expo/vector-icons` rendered on the left.
+     * See https://icons.expo.fyi.
+     */
+    iconName?: string;
+    /** Custom icon node rendered on the left. */
+    icon?: React.ReactNode;
+    /** Override icon color. Defaults to `foreground`. */
+    iconColor?: string;
+    /**
+     * Custom content rendered on the right.
+     * When provided, replaces the default chevron.
+     * Use for checkboxes, switches, badges, or other controls.
+     */
+    rightRender?: React.ReactNode;
+    /**
+     * Show chevron on the right. Defaults to `true`.
+     * Ignored when `rightRender` is provided.
+     */
+    showChevron?: boolean;
+    onPress: () => void;
+    disabled?: boolean;
+    /**
+     * - `plain` (default): no background — sits inside a parent surface.
+     * - `card`: standalone surface with background + border.
+     */
+    variant?: MenuItemVariant;
+    /** Visual separator line at the bottom. */
+    showSeparator?: boolean;
+    /** Style applied to the outer container. */
+    style?: ViewStyle;
+    /** Style applied to the label Text. */
+    labelStyle?: TextStyle;
+}
+declare function MenuItem({ label, subtitle, iconName, icon, iconColor, rightRender, showChevron, onPress, disabled, variant, showSeparator, style, labelStyle, }: MenuItemProps): React.JSX.Element;
+
 interface ChipProps {
     label: string;
     selected?: boolean;
@@ -762,11 +867,11 @@ type DetailRowSeparator = 'dotted' | 'solid' | 'dashed' | 'none';
 type DetailRowLabelWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 interface DetailRowProps {
     label: React.ReactNode;
-    value: string;
+    value: string | React.ReactNode;
     /** Dotted/dashed/solid line between label and value. Defaults to 'dotted'. */
     separator?: DetailRowSeparator;
     labelWeight?: DetailRowLabelWeight;
-    /** Semantic color key or hex string for value text. */
+    /** Semantic color key or hex string for value text. Only applies when value is a string. */
     valueColor?: string;
     /** Node rendered left of the label (e.g. Avatar, Icon). */
     leftIcon?: React.ReactNode;
@@ -780,6 +885,7 @@ interface DetailRowProps {
     rightIconColor?: string;
     style?: ViewStyle;
     labelStyle?: TextStyle;
+    /** Only applies when value is a string. */
     valueStyle?: TextStyle;
 }
 declare function DetailRow({ label, value, separator, labelWeight, valueColor, leftIcon, leftIconName, leftIconColor, rightIconName, rightIconColor, style, labelStyle, valueStyle, }: DetailRowProps): React.JSX.Element;
@@ -975,10 +1081,10 @@ declare const TYPOGRAPHY: {
     };
     readonly 'uppercase-tag': {
         readonly fontFamily: "Poppins-Bold";
-        readonly fontSize: 8;
+        readonly fontSize: 10;
         readonly fontWeight: "700";
-        readonly lineHeight: 10;
-        readonly letterSpacing: 0.32;
+        readonly lineHeight: 13;
+        readonly letterSpacing: 0.8;
         readonly textTransform: "uppercase";
     };
     readonly 'button-lg': {
@@ -1005,4 +1111,4 @@ type RadiusKey = keyof Radius;
 type Typography = typeof TYPOGRAPHY;
 type TypographyKey = keyof Typography;
 
-export { Accordion, type AccordionItem, type AccordionProps, AlertBanner, type AlertBannerProps, type AlertBannerVariant, Avatar, type AvatarProps, type AvatarSize, BREAKPOINTS, Badge, type BadgeProps, type BadgeVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, type CategoryItem, CategoryStrip, type CategoryStripProps, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipOption, type ChipProps, type ColorScheme, ConfirmDialog, type ConfirmDialogProps, CurrencyDisplay, type CurrencyDisplayProps, type CurrencyDisplayVariant, CurrencyInput, CurrencyInput as CurrencyInputLarge, type CurrencyInputProps, DetailRow, type DetailRowLabelWeight, type DetailRowProps, type DetailRowSeparator, EmptyState, type EmptyStateProps, ICON_SIZES, Icon, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, type IconFamily, type IconProps, type IconSize, type IconSizeKey, Input, type InputProps, LabelValue, type LabelValueProps, ListItem, type ListItemProps, MediaCard, type MediaCardAspectRatio, type MediaCardProps, MonthPicker, type MonthPickerProps, type MonthPickerValue, Pressable, type PressableProps, Progress, type ProgressProps, RADIUS, RadioGroup, type RadioGroupProps, type RadioOption, type Radius, type RadiusKey, type ResolvedColors, SHADOWS, SPACING, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type Spacing, type SpacingKey, Spinner, type SpinnerProps, type SpinnerSize, Switch, type SwitchProps, TYPOGRAPHY, type TabItem, Tabs, TabsContent, type TabsContentProps, type TabsProps, Text, type TextProps, type TextVariant, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, type ThemeProviderProps, type ToastItem, ToastProvider, type ToastProviderProps, type ToastVariant, Toggle, type ToggleProps, type ToggleSize, type ToggleVariant, type Typography, type TypographyKey, defaultDark, defaultLight, deriveColors, getResponsiveFontSize, renderIcon, useTheme, useToast };
+export { Accordion, type AccordionItem, type AccordionProps, AlertBanner, type AlertBannerProps, type AlertBannerVariant, Avatar, type AvatarProps, type AvatarSize, BREAKPOINTS, Badge, type BadgeProps, type BadgeVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, type CategoryItem, CategoryStrip, type CategoryStripProps, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipOption, type ChipProps, type ColorScheme, ConfirmDialog, type ConfirmDialogProps, CurrencyDisplay, type CurrencyDisplayProps, type CurrencyDisplayVariant, CurrencyInput, CurrencyInput as CurrencyInputLarge, type CurrencyInputProps, DetailRow, type DetailRowLabelWeight, type DetailRowProps, type DetailRowSeparator, EmptyState, type EmptyStateProps, ICON_SIZES, Icon, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, type IconFamily, type IconProps, type IconSize, type IconSizeKey, Input, type InputProps, LabelValue, type LabelValueProps, ListItem, type ListItemProps, MediaCard, type MediaCardAspectRatio, type MediaCardProps, MenuItem, type MenuItemProps, type MenuItemVariant, MonthPicker, type MonthPickerProps, type MonthPickerValue, Pressable, type PressableProps, Progress, type ProgressProps, RADIUS, RadioGroup, type RadioGroupProps, type RadioOption, type Radius, type RadiusKey, type ResolvedColors, SHADOWS, SPACING, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, type SheetProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type Spacing, type SpacingKey, Spinner, type SpinnerProps, type SpinnerSize, Switch, type SwitchProps, TYPOGRAPHY, type TabItem, Tabs, TabsContent, type TabsContentProps, type TabsProps, Text, type TextProps, type TextVariant, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, type ThemeProviderProps, ToastProvider, Toggle, type ToggleProps, type ToggleSize, type ToggleVariant, type Typography, type TypographyKey, defaultDark, defaultLight, deriveColors, getResponsiveFontSize, renderIcon, useTheme, useToast };