orn-ui 0.2.5 → 0.2.7

package/src/atoms/Transition.tsx

@@ -13,25 +13,25 @@ export type TransitionPreset =
 
 export interface TransitionProps {
   children: React.ReactNode;
-  /** Entra en true, sale (y desmonta) en false. @default true */
+  /** Enters when true, exits (and unmounts) when false. @default true */
   visible?: boolean;
-  /** Uno o varios: 'fade scale' combina opacidad y escala. @default 'fade' */
+  /** One or more: 'fade scale' combines opacity and scale. @default 'fade' */
   preset?: TransitionPreset | TransitionPreset[];
-  /** ms del timing. @default tokens.duration.base */
+  /** Timing duration in ms. @default tokens.duration.base */
   duration?: number;
-  /** ms antes de arrancar. Un índice por delay escalona una lista. @default 0 */
+  /** ms before starting. A per-index delay staggers a list. @default 0 */
   delay?: number;
-  /** Píxeles que recorren los presets de slide. @default 24 */
+  /** Pixels traveled by the slide presets. @default 24 */
   distance?: number;
-  /** Spring en vez de timing (implícito en 'pop'). */
+  /** Spring instead of timing (implicit in 'pop'). */
   spring?: boolean;
-  /** Anima también el primer render. En false arranca ya presente. @default true */
+  /** Also animates the first render. When false it starts already present. @default true */
   appear?: boolean;
-  /** Deja el nodo montado al salir, sólo lo esconde. @default false */
+  /** Keeps the node mounted on exit, only hides it. @default false */
   keepMounted?: boolean;
   /**
-   * Progreso 0→1 manejado desde afuera. Con esto el Transition sólo interpola:
-   * quien lo pasa decide cuándo y cómo avanza (un PanResponder, por ejemplo).
+   * 0→1 progress driven from outside. With this, Transition only interpolates:
+   * whoever passes it decides when and how it advances (a PanResponder, for example).
    */
   value?: Animated.Value;
   onEntered?: () => void;

package/src/molecules/AvatarHeader.tsx

@@ -6,10 +6,10 @@ import { Icon } from '../icons/Icon';
 import type { IconName } from '../icons/types';
 
 export interface AvatarHeaderProps {
-  /** Ícono a mostrar dentro del círculo. Si se omite, se usan `initials`. */
+  /** Icon to show inside the circle. If omitted, `initials` is used instead. */
   iconName?: IconName;
   iconColor?: string;
-  /** Texto corto (ej. 2 letras) mostrado si no se pasa `iconName`. */
+  /** Short text (e.g. 2 letters) shown when `iconName` isn't provided. */
   initials?: string;
   title: string;
   subtitle?: React.ReactNode;

package/src/molecules/FormActions.tsx

@@ -5,7 +5,7 @@ import type { IconName } from '../icons/types';
 import { useLabels } from '../theme/UIProvider';
 
 export interface FormActionsProps {
-  /** Si se omite, solo se muestra el botón secundario. */
+  /** If omitted, only the secondary button is shown. */
   primaryLabel?: string;
   onPrimaryPress?: () => void;
   primaryDisabled?: boolean;

package/src/molecules/OptionCard.tsx

@@ -8,13 +8,13 @@ import type { IconName } from '../icons/types';
 
 export interface OptionCardProps {
   label: string;
-  /** Línea secundaria: el detalle que decide la elección ("llega en 3 días"). */
+  /** Secondary line: the detail that decides the choice ("arrives in 3 days"). */
   description?: string;
   iconName?: IconName;
   isSelected: boolean;
   onPress: () => void;
   disabled?: boolean;
-  /** 'vertical': ícono arriba, texto abajo centrado. 'horizontal': en fila. @default 'horizontal' */
+  /** 'vertical': icon on top, text centered below. 'horizontal': in a row. @default 'horizontal' */
   layout?: 'vertical' | 'horizontal';
   style?: StyleProp<ViewStyle>;
   testID?: string;

package/src/molecules/Stepper.tsx

@@ -11,23 +11,23 @@ export interface StepperProps {
   onChangeText: (text: string) => void;
   onIncrement: () => void;
   onDecrement: () => void;
-  /** Escala del control: alto, botones, ícono y tipografía. @default 'md' */
+  /** Scale of the control: height, buttons, icon and typography. @default 'md' */
   size?: StepperSize;
-  /** Ocupa todo el ancho disponible y el input se lleva el sobrante. @default false */
+  /** Takes up all available width and the input absorbs the extra space. @default false */
   block?: boolean;
   /**
-   * En false el valor sólo se cambia con los botones: el teclado no se abre y
-   * el campo pierde el fondo que lo anuncia como editable. @default true
+   * When false the value can only be changed with the buttons: the keyboard doesn't open and
+   * the field loses the background that marks it as editable. @default true
    */
   editable?: boolean;
   /**
-   * Mínimo permitido. Deshabilita "-" al alcanzarlo y acota lo tipeado al
-   * salir del campo. Los negativos se aceptan sólo si `min` es negativo.
+   * Minimum allowed value. Disables "-" when reached and clamps the typed value on
+   * blur. Negative values are only accepted if `min` is negative.
    */
   min?: number;
-  /** Máximo permitido. Deshabilita "+" al alcanzarlo y acota lo tipeado. */
+  /** Maximum allowed value. Disables "+" when reached and clamps the typed value. */
   max?: number;
-  /** Acepta un separador decimal, normalizando la coma a punto. @default false */
+  /** Accepts a decimal separator, normalizing comma to dot. @default false */
   allowDecimals?: boolean;
   style?: StyleProp<ViewStyle>;
   incrementAccessibilityLabel?: string;

package/src/molecules/Steps.tsx

@@ -13,16 +13,16 @@ export type StepStatus = 'completed' | 'current' | 'pending';
 
 export interface StepsProps {
   steps: StepItem[];
-  /** Índice del paso actual (0-based). Los anteriores quedan 'completed'. */
+  /** Index of the current step (0-based). Earlier steps become 'completed'. */
   current: number;
   /** @default 'horizontal' */
   orientation?: 'horizontal' | 'vertical';
   /**
-   * Qué muestra el círculo de un paso ya completado: un check, o su número.
+   * What the circle of an already-completed step shows: a check, or its number.
    * @default 'check'
    */
   completedIndicator?: 'check' | 'number';
-  /** Si se pasa, cada paso es tocable y reporta su índice. */
+  /** If provided, each step is tappable and reports its index. */
   onStepPress?: (index: number) => void;
   style?: StyleProp<ViewStyle>;
 }

package/src/molecules/SymmetricGrid.tsx

@@ -6,13 +6,13 @@ export interface SymmetricGridProps<T> {
   data: T[];
   renderItem: (item: T, index: number) => React.ReactElement;
   keyExtractor: (item: T, index: number) => string;
-  /** Columnas por fila. @default 2 */
+  /** Columns per row. @default 2 */
   columns?: number;
-  /** Separación entre celdas, en ambos ejes. @default theme.tokens.spacing.md */
+  /** Spacing between cells, on both axes. @default theme.tokens.spacing.md */
   gap?: number;
   /**
-   * Última fila incompleta: centrada (simétrica) en vez de pegada a la
-   * izquierda con un hueco a la derecha. @default true
+   * Incomplete last row: centered (symmetric) instead of stuck to the
+   * left with a gap on the right. @default true
    */
   balanceLastRow?: boolean;
   style?: StyleProp<ViewStyle>;

package/src/organisms/BottomSheet.tsx

@@ -27,21 +27,21 @@ export interface BottomSheetProps {
   visible: boolean;
   onClose: () => void;
   children: React.ReactNode;
-  /** Con título aparece el header, con su botón de cerrar. */
+  /** With a title, the header appears, with its close button. */
   title?: string;
-  /** Acciones de la hoja. Dónde vive lo decide `footerPlacement`. */
+  /** Sheet actions. Where they live is decided by `footerPlacement`. */
   footer?: React.ReactNode;
   /**
-   * 'fixed' lo ancla al pie de la hoja; 'scroll' lo deja al final del
-   * contenido; 'hide-with-keyboard' lo esconde mientras se escribe, que en un
-   * formulario largo le devuelve esa franja al campo enfocado. @default 'fixed'
+   * 'fixed' anchors it to the bottom of the sheet; 'scroll' leaves it at the
+   * end of the content; 'hide-with-keyboard' hides it while typing, which in a
+   * long form gives that strip back to the focused field. @default 'fixed'
    */
   footerPlacement?: FooterPlacement;
-  /** El contenido scrollea cuando no entra. @default true */
+  /** The content scrolls when it doesn't fit. @default true */
   scrollable?: boolean;
-  /** Arrastrar la hoja hacia abajo la cierra. @default true */
+  /** Dragging the sheet down closes it. @default true */
   draggable?: boolean;
-  /** Fracción de la pantalla (0-1) o píxeles. @default 0.9 */
+  /** Fraction of the screen (0-1) or pixels. @default 0.9 */
   maxHeight?: number;
   closeAccessibilityLabel?: string;
   containerStyle?: ViewStyle;

package/src/organisms/DateField.tsx

@@ -11,31 +11,31 @@ export interface DateFieldProps
   label?: string;
   required?: boolean;
   /**
-   * 'single' elige una fecha; 'range' elige un intervalo con dos toques.
+   * 'single' picks one date; 'range' picks an interval with two taps.
    * @default 'single'
    */
   mode?: 'single' | 'range';
-  /** Fecha elegida en mode="single". */
+  /** Selected date in mode="single". */
   value?: Date;
-  /** Se llama en mode="single". */
+  /** Called in mode="single". */
   onChange?: (date: Date) => void;
-  /** Rango elegido en mode="range". */
+  /** Selected range in mode="range". */
   range?: DateRange;
-  /** Se llama en mode="range", tanto al fijar el inicio como al cerrar el rango. */
+  /** Called in mode="range", both when setting the start and when closing the range. */
   onRangeChange?: (range: DateRange) => void;
   placeholder?: string;
   error?: string;
   disabled?: boolean;
-  /** Formatea la fecha en el campo. @default "Month D, YYYY" */
+  /** Formats the date in the field. @default "Month D, YYYY" */
   format?: (date: Date) => string;
-  /** Título del modal del calendario. @default el `selectDate` de `useLabels()` */
+  /** Title of the calendar modal. @default the `selectDate` from `useLabels()` */
   modalTitle?: string;
   /**
-   * Si se pasa, el modal muestra un botón que borra la selección y cierra.
-   * Sin esto no hay botón: el "Clear" anterior sólo cerraba, sin limpiar nada.
+   * If provided, the modal shows a button that clears the selection and closes.
+   * Without this there's no button: the previous "Clear" only closed, without clearing anything.
    */
   onClear?: () => void;
-  /** Texto de ese botón. @default el `clear` de `useLabels()` */
+  /** Text for that button. @default the `clear` from `useLabels()` */
   clearLabel?: string;
   containerStyle?: StyleProp<ViewStyle>;
   testID?: string;
@@ -150,7 +150,7 @@ export const DateField = memo(
           disabled={disabled}
           activeOpacity={0.7}
           accessibilityRole="button"
-          accessibilityLabel={label ?? placeholder}
+          accessibilityLabel={hasValue ? `${label ?? placeholder}, ${display}` : (label ?? placeholder)}
           accessibilityState={{ disabled, expanded: open }}
         >
           <Text allowFontScaling={allowFontScaling} style={[styles.fieldText, !hasValue && styles.placeholder]}>

package/src/organisms/DatePicker.tsx

@@ -20,29 +20,29 @@ export interface DateRange {
 
 export interface DatePickerProps {
   /**
-   * 'single' elige una fecha; 'range' elige un intervalo con dos toques.
+   * 'single' picks one date; 'range' picks an interval with two taps.
    * @default 'single'
    */
   mode?: 'single' | 'range';
-  /** Fecha elegida en mode="single". */
+  /** Selected date in mode="single". */
   value?: Date;
-  /** Se llama en mode="single". */
+  /** Called in mode="single". */
   onChange?: (date: Date) => void;
-  /** Rango elegido en mode="range". */
+  /** Selected range in mode="range". */
   range?: DateRange;
-  /** Se llama en mode="range", tanto al fijar el inicio como al cerrar el rango. */
+  /** Called in mode="range", both when setting the start and when closing the range. */
   onRangeChange?: (range: DateRange) => void;
   minDate?: Date;
   maxDate?: Date;
-  /** Mes mostrado al abrir si no hay `value`. @default hoy */
+  /** Month shown on open if there's no `value`. @default today */
   defaultMonth?: Date;
-  /** Nombres de los meses. @default los de `useLabels()` */
+  /** Month names. @default those from `useLabels()` */
   monthNames?: string[];
-  /** Iniciales de los días, índice 0 = domingo. @default las de `useLabels()` */
+  /** Day initials, index 0 = Sunday. @default those from `useLabels()` */
   weekdayNames?: string[];
-  /** 0 = domingo, 1 = lunes. @default 0 */
+  /** 0 = Sunday, 1 = Monday. @default 0 */
   firstDayOfWeek?: 0 | 1;
-  /** Avisa qué mes quedó a la vista al navegar con las flechas. */
+  /** Reports which month became visible when navigating with the arrows. */
   onVisibleMonthChange?: (month: Date) => void;
   style?: StyleProp<ViewStyle>;
   testID?: string;

package/src/organisms/List.tsx

@@ -12,19 +12,19 @@ export interface ListProps<T> {
   keyExtractor: (item: T, index: number) => string;
   renderItem: FlatListProps<T>['renderItem'];
 
-  /** Carga inicial: mientras sea true y no haya datos, se muestran placeholders. */
+  /** Initial load: while true and there's no data, placeholders are shown. */
   isLoading: boolean;
-  /** Recarga con datos ya en pantalla (pull-to-refresh). @default false */
+  /** Reload with data already on screen (pull-to-refresh). @default false */
   isRefreshing?: boolean;
   isLoadingMore?: boolean;
-  /** Controlado por el consumidor: mientras es false, se muestra un spinner de pantalla completa. @default true */
+  /** Controlled by the consumer: while false, a fullscreen spinner is shown. @default true */
   isReady?: boolean;
   loadingText?: string;
   loadingMoreText?: string;
 
-  /** Filas fantasma de la carga inicial. @default 6 */
+  /** Ghost rows for the initial load. @default 6 */
   skeletonCount?: number;
-  /** Placeholder propio, para que calce con la forma real del ítem. */
+  /** Custom placeholder, to match the real shape of the item. */
   renderSkeletonItem?: () => React.ReactElement;
 
   onEndReached?: () => void;
@@ -41,7 +41,7 @@ export interface ListProps<T> {
   contentContainerStyle?: ViewStyle;
   containerStyle?: ViewStyle;
 
-  /** Componente de lista a usar (FlashList, etc). @default FlatList */
+  /** List component to use (FlashList, etc). @default FlatList */
   ListComponent?: React.ComponentType<any>;
   listProps?: Record<string, unknown>;
 }

package/src/organisms/NavigationBar.tsx

@@ -26,11 +26,11 @@ export interface NavigationBarProps {
   items: NavigationBarItem[];
   activeKey: string;
   onChange: (key: string) => void;
-  /** Borde de la pantalla donde vive la barra. @default 'bottom' */
+  /** Screen edge where the bar lives. @default 'bottom' */
   position?: 'bottom' | 'top';
   /** @default true */
   showLabels?: boolean;
-  /** Suma el inset de safe area del borde donde vive la barra. @default true */
+  /** Adds the safe area inset for the edge where the bar lives. @default true */
   safeArea?: boolean;
   style?: StyleProp<ViewStyle>;
   testID?: string;

package/src/organisms/ReorderableList.tsx

@@ -5,19 +5,19 @@ import { createStyles } from '../theme/createStyles';
 export interface ReorderableListProps<T> {
   data: T[];
   keyExtractor: (item: T, index: number) => string;
-  /** Alto fijo de cada fila: necesario para calcular el índice destino sin medir layout async. */
+  /** Fixed height of each row: needed to calculate the target index without measuring layout async. */
   itemHeight: number;
   renderItem: (item: T, index: number, dragging: boolean) => React.ReactElement;
-  /** Se llama al soltar, con el arreglo ya reordenado. No muta `data`. */
+  /** Called on release, with the array already reordered. Does not mutate `data`. */
   onReorder: (data: T[]) => void;
   /**
-   * Empieza el arrastre de la fila `index`. Úsalo para apagar el scroll del
-   * contenedor (`scrollEnabled={false}`) mientras dura: en iOS el
-   * `UIScrollView` padre cancela los toques del contenido apenas su gesto
-   * vertical arranca, y sin eso el arrastre muere a los pocos píxeles.
+   * Starts dragging row `index`. Use it to turn off the container's scroll
+   * (`scrollEnabled={false}`) while it lasts: on iOS the parent
+   * `UIScrollView` cancels touches on the content as soon as its
+   * vertical gesture starts, and without this the drag dies within a few pixels.
    */
   onDragStart?: (index: number) => void;
-  /** Termina el arrastre — soltando o por cancelación. Siempre corre si corrió `onDragStart`. */
+  /** Ends the drag — on release or cancellation. Always runs if `onDragStart` ran. */
   onDragEnd?: () => void;
   disabled?: boolean;
   style?: StyleProp<ViewStyle>;

package/src/organisms/Screen.tsx

@@ -10,14 +10,14 @@ export interface ScreenProps {
   style?: ViewStyle;
   scrollable?: boolean;
   contentContainerStyle?: ViewStyle;
-  /** Qué insets de safe area aplicar. @default ['top', 'bottom'] */
+  /** Which safe area insets to apply. @default ['top', 'bottom'] */
   edges?: ScreenEdge[];
   /**
-   * Compensa el teclado: en iOS con scroll lo hace el propio ScrollView, en el
-   * resto de los casos con un KeyboardAvoidingView. Ponelo en false cuando
-   * el contenido ya trae su propio scroller que maneja el teclado (Wizard,
-   * List, SearchList): las dos compensaciones se suman y el campo enfocado
-   * termina empujado fuera de la pantalla.
+   * Compensates for the keyboard: on iOS with scroll the ScrollView itself does it, in
+   * other cases a KeyboardAvoidingView does. Set to false when
+   * the content already brings its own scroller that handles the keyboard (Wizard,
+   * List, SearchList): the two compensations add up and the focused field
+   * ends up pushed off screen.
    * @default true
    */
   keyboardAvoiding?: boolean;

package/src/organisms/SearchList.tsx

@@ -19,7 +19,7 @@ import { IconButton } from '../atoms/IconButton';
 import type { IconName } from '../icons/types';
 
 export interface SearchListProps<T> {
-  /** Chrome opcional arriba del buscador (ej. back button + título). */
+  /** Optional chrome above the search bar (e.g. back button + title). */
   header?: React.ReactNode;
 
   searchValue: string;
@@ -34,23 +34,23 @@ export interface SearchListProps<T> {
   keyExtractor: (item: T, index: number) => string;
   renderItem: FlatListProps<T>['renderItem'];
 
-  /** Carga inicial: mientras sea true y no haya datos, se muestran placeholders. */
+  /** Initial load: while true and there's no data, placeholders are shown. */
   isLoading?: boolean;
-  /** 'replace' cambia toda la lista por un spinner/skeleton; 'overlay' lo muestra encima manteniendo el layout. */
+  /** 'replace' swaps the whole list for a spinner/skeleton; 'overlay' shows it on top while keeping the layout. */
   loadingMode?: 'replace' | 'overlay';
-  /** Recarga con datos ya en pantalla (pull-to-refresh). @default false */
+  /** Reload with data already on screen (pull-to-refresh). @default false */
   isRefreshing?: boolean;
   isLoadingMore?: boolean;
-  /** Controlado por el consumidor: mientras es false, se muestra un spinner de pantalla completa. @default true */
+  /** Controlled by the consumer: while false, a fullscreen spinner is shown. @default true */
   isReady?: boolean;
   loadingText?: string;
   loadingMoreText?: string;
   hasMore?: boolean;
   noMoreText?: string;
 
-  /** Filas fantasma de la carga inicial. @default 6 */
+  /** Ghost rows for the initial load. @default 6 */
   skeletonCount?: number;
-  /** Placeholder propio, para que calce con la forma real del ítem. */
+  /** Custom placeholder, to match the real shape of the item. */
   renderSkeletonItem?: () => React.ReactElement;
 
   onLoadMore?: () => void;
@@ -68,7 +68,7 @@ export interface SearchListProps<T> {
   contentContainerStyle?: StyleProp<ViewStyle>;
   containerStyle?: ViewStyle;
 
-  /** Componente de lista a usar (FlashList, etc). @default FlatList */
+  /** List component to use (FlashList, etc). @default FlatList */
   ListComponent?: React.ComponentType<any>;
   listProps?: Record<string, unknown>;
 }

package/src/organisms/Select.tsx

@@ -38,10 +38,10 @@ export interface SelectProps<T> {
   error?: string;
   isLoading?: boolean;
   disabled?: boolean;
-  /** Agrega un buscador dentro del desplegable. @default false */
+  /** Adds a search box inside the dropdown. @default false */
   searchable?: boolean;
   searchPlaceholder?: string;
-  /** Alto máximo del desplegable, si el espacio disponible lo permite. @default 280 */
+  /** Maximum height of the dropdown, if the available space allows it. @default 280 */
   maxHeight?: number;
   onOpenChange?: (open: boolean) => void;
   containerStyle?: StyleProp<ViewStyle>;

package/src/organisms/Toast.tsx

@@ -12,10 +12,10 @@ export interface ToastProps {
   title: string;
   message?: string;
   variant?: ToastVariant;
-  /** Se dispara al tocar el toast (además de cerrarlo). */
+  /** Fires when the toast is tapped (in addition to closing it). */
   onPress?: () => void;
   onDismiss?: () => void;
-  /** Oculta la X de cerrar. El toast igual se auto-descarta por tiempo. */
+  /** Hides the close X. The toast still auto-dismisses by timeout. */
   hideCloseButton?: boolean;
   style?: StyleProp<ViewStyle>;
   testID?: string;

package/src/organisms/ToastProvider.tsx

@@ -54,9 +54,9 @@ export interface ToastProviderProps {
   children: React.ReactNode;
   /** @default 'top' */
   position?: 'top' | 'bottom';
-  /** Máximo de toasts simultáneos; los más viejos se descartan. @default 3 */
+  /** Maximum simultaneous toasts; the oldest ones are dropped. @default 3 */
   maxVisible?: number;
-  /** Duración por defecto en ms. @default 4000 */
+  /** Default duration in ms. @default 4000 */
   defaultDuration?: number;
 }
 

package/src/organisms/Wizard.tsx

@@ -13,28 +13,28 @@ export interface WizardStep extends StepItem {
 
 export interface WizardProps {
   steps: WizardStep[];
-  /** Paso actual (controlado). Si se omite, el Wizard maneja su propio estado. */
+  /** Current step (controlled). If omitted, the Wizard manages its own state. */
   current?: number;
   onStepChange?: (index: number) => void;
   onFinish?: () => void;
   /** @default 'horizontal' */
   orientation?: 'horizontal' | 'vertical';
   completedIndicator?: 'check' | 'number';
-  /** Permite volver a un paso ya completado tocándolo en el indicador. @default true */
+  /** Allows returning to an already-completed step by tapping it in the indicator. @default true */
   allowStepNavigation?: boolean;
   backLabel?: string;
   nextLabel?: string;
   finishLabel?: string;
   /**
-   * El contenido del paso scrollea cuando no entra. Ponelo en false sólo si
-   * un paso renderiza su propia lista virtualizada (anidar una
-   * VirtualizedList dentro de un ScrollView rompe la virtualización).
+   * The step content scrolls when it doesn't fit. Set to false only if
+   * a step renders its own virtualized list (nesting a
+   * VirtualizedList inside a ScrollView breaks virtualization).
    * @default true
    */
   scrollableContent?: boolean;
   /**
-   * El contenido del paso entra deslizándose en el sentido de la navegación.
-   * Sólo opacity y transform, así que la animación corre en el hilo nativo.
+   * The step content slides in following the navigation direction.
+   * Only opacity and transform, so the animation runs on the native thread.
    * @default true
    */
   animated?: boolean;

package/src/theme/UIProvider.tsx

@@ -42,24 +42,24 @@ const UIContext = createContext<UIContextValue | undefined>(undefined);
 
 export interface UIProviderProps {
   children: React.ReactNode;
-  /** Par light/dark. Por defecto el theme de marca de la librería (créalo con createTheme()). */
+  /** Light/dark pair. Defaults to the library's brand theme (create one with createTheme()). */
   theme?: ThemePair;
-  /** Modo inicial (no controlado) si no se pasa `mode`. @default 'system' */
+  /** Initial mode (uncontrolled) if `mode` isn't passed. @default 'system' */
   defaultMode?: ThemeMode;
-  /** Modo controlado. Si se pasa junto a onModeChange, el provider no gestiona estado propio. */
+  /** Controlled mode. If passed together with onModeChange, the provider doesn't manage its own state. */
   mode?: ThemeMode;
   onModeChange?: (mode: ThemeMode) => void;
-  /** Renderer de íconos. Por defecto usa los glifos zero-dep incluidos. */
+  /** Icon renderer. Defaults to the included zero-dep glyphs. */
   icons?: IconRenderer;
-  /** Insets de safe area (de useSafeAreaInsets()). Por defecto {0,0,0,0}. */
+  /** Safe area insets (from useSafeAreaInsets()). Defaults to {0,0,0,0}. */
   insets?: EdgeInsets;
   labels?: Partial<Labels>;
-  /** @default false, para paridad con el resto de la librería (accesibilidad primero). */
+  /** @default false, for parity with the rest of the library (accessibility first). */
   allowFontScaling?: boolean;
   /**
-   * Fuente de insets que usan `Modal`/`BottomSheet` para su propia ventana
-   * nativa. No la pases a mano — `SafeAreaUIProvider` la cablea sola.
-   * @default repite los insets ambientes (comportamiento sin safe-area-context)
+   * Source of insets used by `Modal`/`BottomSheet` for their own native
+   * window. Don't pass this by hand — `SafeAreaUIProvider` wires it up itself.
+   * @default repeats the ambient insets (behavior without safe-area-context)
    */
   ModalSafeAreaBoundary?: ModalSafeAreaBoundaryComponent;
 }