@satellatickets/core 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -1,56 +1,24 @@
-import { ReactNode } from "react";
+
+import { $ as useFormFieldControl, A as LinkUnderline, B as textVariants, C as UIProviderProps, D as useLink, E as UseLinkResult, F as TextVariant, G as useButton, H as useControllableState, I as TextVariantStyle, J as FormFieldControlOptions, K as FormFieldContext, L as textAligns, M as TextAlign, N as TextColorToken, O as LinkPressEvent, P as TextProps, Q as resolveFormFieldControl, R as textColors, S as ThemeMode, T as UseLinkOptions, U as UseButtonOptions, V as UseControllableStateOptions, W as UseButtonResult, X as FormFieldValueOptions, Y as FormFieldValue, Z as createFormFieldValue, _ as useBrand, a as ToastStore, b as useUIContext, c as ToastApi, d as FeedbackTone, f as feedbackTones, g as createUIContextValue, h as UIContextValue, i as TOAST_MAX_VISIBLE, j as linkUnderlines, k as LinkProps, l as ToastItem, m as UIContext, n as useToast, o as createToastStore, p as isFeedbackTone, q as FormFieldControl, r as TOAST_DEFAULT_DURATION, s as ToastAction, t as ToastContext, u as ToastOptions, v as useColorScheme, w as themeModes, x as ColorScheme, y as useTheme, z as textVariantStyles } from "./client-DpHlKasm.js";
 import { BrandName, Theme, ThemeName, ThemeOverrides } from "@satellatickets/tokens";
-//#region src/hooks/use-button.d.ts
-export interface UseButtonOptions {
+import { ReactNode } from "react";
+//#region src/tabs/navigation.d.ts
+/** Lo mínimo que hace falta saber de una pestaña para moverse entre ellas. */
+export interface NavigableTab {
+  value: string;
   disabled?: boolean | undefined;
-  loading?: boolean | undefined;
-  onPress?: (() => void) | undefined;
-}
-export interface UseButtonResult {
-  disabled: boolean;
-  loading: boolean;
-  /** `false` si está deshabilitado o cargando: el botón no responde a la pulsación. */
-  interactive: boolean;
-  /** Llama a `onPress` solo si el botón es interactivo. */
-  press: () => void;
-}
-/**
- * Comportamiento de `Button` común a web y nativo: un botón deshabilitado o que
- * está cargando no dispara `onPress`. Cada vista añade su accesibilidad
- * (`disabled`/`aria-busy` en web, `accessibilityState` en nativo).
- */
-export declare function useButton({ disabled, loading, onPress }: UseButtonOptions): UseButtonResult;
-//#endregion
-//#region src/types/ui-provider.d.ts
-/** Modo de tema que acepta `UIProvider` (ADR-010). */
-export declare const themeModes: readonly ["light", "dark", "system"];
-export type ThemeMode = (typeof themeModes)[number];
-/** Esquema resuelto: siempre uno de los temas definidos en tokens. */
-export type ColorScheme = ThemeName;
-export interface UIProviderProps {
-  /** Tema claro, oscuro o el del sistema (por defecto `system`). */
-  theme?: ThemeMode | undefined;
-  /** Marca registrada en tokens. Sin marca se usa la identidad por defecto. */
-  brand?: BrandName | undefined;
-  children: ReactNode;
-}
-//#endregion
-//#region src/theme/context.d.ts
-interface UIContextValue {
-  theme: Theme;
-  colorScheme: ColorScheme;
-  mode: ThemeMode;
-  brand: BrandName | undefined;
 }
-export declare function createUIContextValue(mode: ThemeMode, systemScheme: ColorScheme, brand?: BrandName): UIContextValue;
-/** Sin `UIProvider` se usa el tema claro por defecto, para que los componentes funcionen aislados. */
-export declare const UIContext: import("react").Context<UIContextValue>;
-export declare function useUIContext(): UIContextValue;
-/** Tema resuelto (tokens con la marca aplicada). Imprescindible en las vistas nativas (ADR-008). */
-export declare function useTheme(): Theme;
-/** `'light' | 'dark'` ya resuelto, también con `theme="system"`. */
-export declare function useColorScheme(): ColorScheme;
-export declare function useBrand(): BrandName | undefined;
+/** Hacia dónde mueve el foco una tecla: flechas, Inicio y Fin. */
+export declare const tabDirections: readonly ["next", "previous", "first", "last"];
+export type TabDirection = (typeof tabDirections)[number];
+/** La primera pestaña habilitada: la elegida por defecto. `undefined` si no hay ninguna. */
+export declare function firstEnabledTab(items: readonly NavigableTab[]): string | undefined;
+/**
+ * La pestaña a la que lleva una tecla desde la actual, saltando las deshabilitadas.
+ * `next` y `previous` dan la vuelta al llegar al final. Si no hay otra a la que ir,
+ * devuelve la actual.
+ */
+export declare function getTabInDirection(items: readonly NavigableTab[], current: string, direction: TabDirection): string;
 //#endregion
 //#region src/theme/resolve-theme.d.ts
 /** Combina los overrides de una marca sobre un tema (ADR-010). Los arrays (sombras) se sustituyen enteros. */
@@ -59,6 +27,37 @@ export declare function mergeTheme(base: Theme, overrides: ThemeOverrides): Them
 export declare function resolveTheme(scheme: ThemeName, brand?: BrandName): Theme;
 export declare function resolveColorScheme(mode: ThemeMode, systemScheme: ColorScheme): ColorScheme;
 //#endregion
+//#region src/types/alert.d.ts
+interface AlertBaseProps {
+  /** Qué comunica (por defecto `info`). Fija el color y el icono. */
+  tone?: FeedbackTone | undefined;
+  /** Resumen en una línea. */
+  title?: string | undefined;
+  /** Explicación o siguiente paso. */
+  children?: ReactNode;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+interface AlertStaticProps extends AlertBaseProps {
+  onClose?: undefined;
+  closeLabel?: undefined;
+}
+interface AlertClosableProps extends AlertBaseProps {
+  /** Si existe, el aviso muestra un botón para cerrarlo y la llama al pulsarlo. */
+  onClose: () => void;
+  /**
+   * Nombre accesible del botón de cierre ("Cerrar aviso"). Es obligatorio con
+   * `onClose`: la librería no trae textos propios.
+   */
+  closeLabel: string;
+}
+/**
+ * Contrato de `Alert`: un mensaje dentro de la página que no desaparece solo. `danger`
+ * y `warning` se anuncian de inmediato a los lectores de pantalla; `success` e `info`,
+ * cuando terminan lo que estén leyendo.
+ */
+export type AlertProps = AlertStaticProps | AlertClosableProps;
+//#endregion
 //#region src/types/badge.d.ts
 /**
  * Variantes de `Badge` (ADR-009): una por cada color de `color.feedback`. Las historias
@@ -146,46 +145,123 @@ export interface ButtonProps<IconName extends string = string> {
   children: ReactNode;
 }
 //#endregion
-//#region src/types/text.d.ts
-export declare const textVariants: readonly ["hero", "display", "title", "heading", "subheading", "body", "bodySmall", "label", "caption", "code"];
-export type TextVariant = (typeof textVariants)[number];
-export type TextColorToken = keyof Theme['color']['text'];
-export declare const textColors: TextColorToken[];
-export declare const textAligns: readonly ["left", "center", "right"];
-export type TextAlign = (typeof textAligns)[number];
-/** Tokens que componen una variante tipográfica; ambas vistas los leen del tema. */
-export interface TextVariantStyle {
-  family: keyof Theme['font']['family'];
-  /** Tamaño; `font.lineHeight` comparte las mismas claves (lo comprueba el typecheck de las vistas). */
-  size: keyof Theme['font']['size'];
-  weight: keyof Theme['font']['weight'];
-  uppercase?: boolean;
-  /** Espaciado entre letras en px. */
-  letterSpacing?: number;
-  /** Nivel de encabezado semántico (h1–h4) si la variante es un título. */
-  headingLevel?: 1 | 2 | 3 | 4;
-}
-/** Escala tipográfica de Satella: Unbounded para titulares, Hanken Grotesk para texto, IBM Plex Mono para etiquetas. */
-export declare const textVariantStyles: Readonly<Record<TextVariant, TextVariantStyle>>;
-export interface TextProps {
-  variant?: TextVariant | undefined;
-  color?: TextColorToken | undefined;
-  align?: TextAlign | undefined;
-  /** Una sola línea con puntos suspensivos. */
-  truncate?: boolean | undefined;
+//#region src/types/card.d.ts
+/**
+ * Variantes de `Card` (ADR-009): `outlined` se apoya en el borde; `elevated` añade
+ * sombra para separarse de lo que tiene debajo.
+ */
+export declare const cardVariants: readonly ["outlined", "elevated"];
+export type CardVariant = (typeof cardVariants)[number];
+/**
+ * Contrato de `Card`: una superficie que agrupa contenido relacionado. Con `onPress`
+ * toda la tarjeta es pulsable; en ese caso no debe contener otros controles.
+ */
+export interface CardProps {
+  variant?: CardVariant | undefined;
+  /** Relleno interior (por defecto 4). Con `0`, el contenido llega hasta el borde, por ejemplo una imagen. */
+  padding?: SpaceToken | undefined;
+  /** Hace pulsable toda la tarjeta, con ratón, teclado o toque. */
+  onPress?: (() => void) | undefined;
+  /**
+   * Nombre accesible de una tarjeta pulsable. Sin él, es su contenido, que suele ser lo
+   * correcto. Si se indica, tiene que incluir el texto visible: quien navega por voz
+   * dice lo que ve.
+   */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+  children?: ReactNode;
+}
+//#endregion
+//#region src/types/checkbox.d.ts
+/** Contrato de `Checkbox`: una opción que se marca o no, con su etiqueta como `children`. */
+export interface CheckboxProps {
+  /** Estado controlado por la app. Sin él, guarda su propio estado (ADR-037). */
+  checked?: boolean | undefined;
+  /** Estado inicial cuando guarda su propio estado. */
+  defaultChecked?: boolean | undefined;
+  /**
+   * Ni marcado ni sin marcar: representa a un grupo donde solo algunas opciones lo
+   * están. Es solo visual; al pulsarlo pasa a marcado o sin marcar según `checked`.
+   */
+  indeterminate?: boolean | undefined;
+  /** Se llama con el estado nuevo al pulsarlo. */
+  onCheckedChange?: ((checked: boolean) => void) | undefined;
+  /** No se puede pulsar ni enfocar. */
+  disabled?: boolean | undefined;
+  /** El estado no es válido, por ejemplo unas condiciones sin aceptar. */
+  invalid?: boolean | undefined;
+  required?: boolean | undefined;
+  /** Nombre accesible cuando no hay etiqueta visible. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
   testID?: string | undefined;
+  /** Etiqueta. Pulsarla también marca la casilla. */
   children?: ReactNode;
 }
 //#endregion
+//#region src/types/control.d.ts
+/**
+ * Alturas de los controles interactivos de una línea (`Input`, `Select`). Coinciden
+ * con `size.control` de los tokens y con los tamaños de `Button`, para que un campo y
+ * un botón del mismo tamaño queden alineados en una fila.
+ */
+export declare const controlSizes: readonly ["sm", "md", "lg"];
+export type ControlSize = (typeof controlSizes)[number];
+//#endregion
+//#region src/types/divider.d.ts
+/** Orientación de `Divider` (ADR-009). */
+export declare const dividerOrientations: readonly ["horizontal", "vertical"];
+export type DividerOrientation = (typeof dividerOrientations)[number];
+/** Contrato de `Divider`: una línea fina que separa dos bloques de contenido. */
+export interface DividerProps {
+  /**
+   * `horizontal` (por defecto) separa bloques apilados. `vertical` separa elementos de
+   * una fila y ocupa su altura.
+   */
+  orientation?: DividerOrientation | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+//#region src/types/form-field.d.ts
+/**
+ * Contrato de `FormField`: la etiqueta, la ayuda y el error de un control, enlazados
+ * con él para los lectores de pantalla (ADR-037). Envuelve un `Input`, un `TextArea`
+ * o un `Select`.
+ */
+export interface FormFieldProps {
+  /** Etiqueta visible. Es texto porque en nativo hace de nombre accesible del control. */
+  label: string;
+  /** Ayuda bajo el control: formato esperado, para qué se usa el dato. */
+  help?: string | undefined;
+  /** Mensaje de error. Si existe, el control se marca como inválido. */
+  error?: string | undefined;
+  /** Marca la etiqueta como obligatoria y lo comunica al control. */
+  required?: boolean | undefined;
+  /** Deshabilita el control. */
+  disabled?: boolean | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+  /** El control. */
+  children: ReactNode;
+}
+//#endregion
 //#region src/types/icon.d.ts
-export declare const iconSizes: readonly ["sm", "md", "lg"];
+export declare const iconSizes: readonly ["sm", "md", "lg", "xl"];
 export type IconSize = (typeof iconSizes)[number];
 /** Tamaño en px/puntos de cada icono. */
 export declare const iconSizePx: {
   sm: number;
   md: number;
   lg: number;
+  xl: number;
 };
+/**
+ * Color de un icono: un color de texto o el de un estado de feedback (`success`,
+ * `warning`, `danger`, `info`), que usa el token `color.feedback.<estado>.icon`.
+ */
+export type IconColor = TextColorToken | FeedbackTone;
 /**
  * Contrato de `Icon`. El conjunto de nombres lo aporta `@satellatickets/icons`,
  * que está fuera de `core` (ADR-002), por eso el nombre es un parámetro de tipo.
@@ -193,24 +269,214 @@ export declare const iconSizePx: {
 export interface IconProps<Name extends string = string> {
   name: Name;
   size?: IconSize | undefined;
-  color?: TextColorToken | undefined;
+  color?: IconColor | undefined;
   /** Texto alternativo. Sin él, el icono es decorativo y se oculta a los lectores de pantalla. */
   label?: string | undefined;
   testID?: string | undefined;
 }
 //#endregion
+//#region src/types/icon-button.d.ts
+/**
+ * Tamaño del icono para cada tamaño de `IconButton`. Es un paso mayor que en
+ * `Button`, porque aquí el icono es todo el contenido.
+ */
+export declare const iconButtonIconSize: {
+  readonly sm: "sm";
+  readonly md: "md";
+  readonly lg: "lg";
+};
+/**
+ * Contrato de `IconButton`: un `Button` cuadrado cuyo único contenido es un icono.
+ * Comparte variantes y tamaños con `Button` (`buttonVariants`). El conjunto de iconos
+ * lo aporta `@satellatickets/icons`, que está fuera de `core` (ADR-002), por eso el
+ * nombre es un parámetro de tipo.
+ */
+export interface IconButtonProps<IconName extends string = string> {
+  icon: IconName;
+  /**
+   * Nombre accesible. Es obligatorio porque no hay texto visible: describe la
+   * acción ("Cerrar"), no el dibujo ("Aspa").
+   */
+  label: string;
+  /** Jerarquía visual de la acción (por defecto `ghost`). */
+  variant?: ButtonVariant | undefined;
+  size?: ButtonSize | undefined;
+  /** No se puede pulsar ni enfocar. */
+  disabled?: boolean | undefined;
+  /** Acción en curso: sustituye el icono por un spinner y no dispara `onPress`, pero conserva el foco. */
+  loading?: boolean | undefined;
+  /** Se pulsa con ratón, teclado o toque. Nombre neutral: la vista web lo mapea a `click`. */
+  onPress?: (() => void) | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+//#region src/types/input.d.ts
+/**
+ * Qué se escribe en un `Input` (ADR-009). Cada vista lo traduce a su plataforma:
+ * el atributo `type` y el teclado en web, y el teclado, las mayúsculas automáticas
+ * y el autocompletado en nativo.
+ */
+export declare const inputTypes: readonly ["text", "email", "password", "search", "tel", "url", "number"];
+export type InputType = (typeof inputTypes)[number];
+/** Tamaño de los iconos de un `Input` para cada tamaño de campo. */
+export declare const inputIconSize: {
+  readonly sm: "sm";
+  readonly md: "md";
+  readonly lg: "md";
+};
+/**
+ * Contrato de `Input`: un campo de texto de una línea. El conjunto de iconos lo aporta
+ * `@satellatickets/icons`, que está fuera de `core` (ADR-002), por eso el nombre es
+ * un parámetro de tipo.
+ */
+export interface InputProps<IconName extends string = string> {
+  /** Texto controlado por la app. Sin él, el campo guarda su propio estado (ADR-037). */
+  value?: string | undefined;
+  /** Texto inicial cuando el campo guarda su propio estado. */
+  defaultValue?: string | undefined;
+  /** Se llama con el texto nuevo en cada cambio. */
+  onChangeText?: ((text: string) => void) | undefined;
+  placeholder?: string | undefined;
+  /** Qué se escribe (por defecto `text`). */
+  type?: InputType | undefined;
+  size?: ControlSize | undefined;
+  /** No se puede editar ni enfocar. */
+  disabled?: boolean | undefined;
+  /** Se puede enfocar y copiar, pero no editar. */
+  readOnly?: boolean | undefined;
+  /** El valor no es válido. Dentro de un `FormField` con `error` se activa solo. */
+  invalid?: boolean | undefined;
+  required?: boolean | undefined;
+  /** Icono decorativo delante del texto. */
+  iconStart?: IconName | undefined;
+  /** Icono decorativo detrás del texto. */
+  iconEnd?: IconName | undefined;
+  maxLength?: number | undefined;
+  onFocus?: (() => void) | undefined;
+  onBlur?: (() => void) | undefined;
+  /** Se pulsa Intro, o la tecla de envío del teclado en pantalla. */
+  onSubmit?: (() => void) | undefined;
+  /** Nombre accesible cuando no hay un `FormField` que lo etiquete. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+//#region src/types/modal.d.ts
+/**
+ * Contrato de `Modal` y de `Sheet` (ADR-040): un diálogo que interrumpe lo que hay
+ * debajo. `Modal` se centra; `Sheet` se ancla al borde inferior.
+ */
+export interface ModalProps {
+  /** Si está abierto. Lo decide la app. */
+  open: boolean;
+  /**
+   * El diálogo pide cerrarse: Escape, pulsar fuera, el botón atrás de Android o su
+   * botón de cierre. La app responde poniendo `open` a `false`.
+   */
+  onClose: () => void;
+  /** Título visible. Es también su nombre accesible. */
+  title: string;
+  /** Texto bajo el título. Los lectores de pantalla lo leen al abrirse. */
+  description?: string | undefined;
+  /**
+   * Si existe, muestra un botón de cierre con este nombre accesible ("Cerrar"). La
+   * librería no trae textos propios.
+   */
+  closeLabel?: string | undefined;
+  /**
+   * Con `false`, ni Escape, ni pulsar fuera, ni el botón atrás lo cierran: es para una
+   * pregunta que exige respuesta. Por defecto `true`.
+   */
+  dismissible?: boolean | undefined;
+  /** Acciones al pie, normalmente botones. */
+  footer?: ReactNode;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+  children?: ReactNode;
+}
+/** `Sheet` tiene el mismo contrato que `Modal`: solo cambia dónde se coloca. */
+export type SheetProps = ModalProps;
+/** Las dos presentaciones de un diálogo. */
+export declare const modalPresentations: readonly ["dialog", "sheet"];
+export type ModalPresentation = (typeof modalPresentations)[number];
+//#endregion
+//#region src/types/select.d.ts
+/** Una opción de `Select`. */
+export interface SelectOption {
+  /** Lo que recibe `onValueChange`. No puede ser una cadena vacía: eso es "sin elegir". */
+  value: string;
+  /** Lo que se muestra. */
+  label: string;
+  disabled?: boolean | undefined;
+}
+/** Contrato de `Select`: elegir una opción de una lista (ADR-038). */
+export interface SelectProps {
+  options: readonly SelectOption[];
+  /** Opción elegida, controlada por la app. Sin ella, guarda su propio estado (ADR-037). */
+  value?: string | undefined;
+  /** Opción inicial cuando guarda su propio estado. */
+  defaultValue?: string | undefined;
+  /** Se llama con el `value` de la opción elegida. */
+  onValueChange?: ((value: string) => void) | undefined;
+  /** Texto que se muestra mientras no hay ninguna opción elegida. */
+  placeholder?: string | undefined;
+  size?: ControlSize | undefined;
+  /** No se puede abrir ni enfocar. */
+  disabled?: boolean | undefined;
+  /** El valor no es válido. Dentro de un `FormField` con `error` se activa solo. */
+  invalid?: boolean | undefined;
+  required?: boolean | undefined;
+  /** Nombre accesible cuando no hay un `FormField` que lo etiquete. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+//#region src/types/skeleton.d.ts
+/**
+ * Formas de `Skeleton` (ADR-009): `text` ocupa el hueco de una línea de `Text`,
+ * `rectangle` el de una imagen o un control, y `circle` el de un avatar.
+ */
+export declare const skeletonShapes: readonly ["text", "rectangle", "circle"];
+export type SkeletonShape = (typeof skeletonShapes)[number];
+/**
+ * Contrato de `Skeleton`: el hueco de un contenido que todavía se está cargando. Es
+ * decorativo; que la zona está cargando lo comunica quien lo contiene.
+ */
+export interface SkeletonProps {
+  /** Forma (por defecto `text`). */
+  shape?: SkeletonShape | undefined;
+  /**
+   * Ancho, en puntos o como porcentaje del contenedor (`'60%'`). Por defecto ocupa
+   * todo el ancho; en `circle`, mide lo mismo que de alto.
+   */
+  width?: number | `${number}%` | undefined;
+  /** Alto en puntos. En `text` no se usa: lo fija `variant`. */
+  height?: number | undefined;
+  /** Con `text`: la variante de `Text` cuyo hueco ocupa (por defecto `body`). */
+  variant?: TextVariant | undefined;
+  /** Con `text`: número de líneas (por defecto 1). Si hay varias, la última es más corta. */
+  lines?: number | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
 //#region src/types/spinner.d.ts
 /**
  * `Spinner` comparte la escala de `Icon`: así puede ocupar el sitio de un icono
  * (por ejemplo, dentro de un botón que carga) sin mover el resto del contenido.
+ * `xl` es para la carga de una página o de una sección entera.
  */
-export declare const spinnerSizes: readonly ["sm", "md", "lg"];
+export declare const spinnerSizes: readonly ["sm", "md", "lg", "xl"];
 export type SpinnerSize = IconSize;
 /** Tamaño en px/puntos de cada spinner. */
 export declare const spinnerSizePx: {
   sm: number;
   md: number;
   lg: number;
+  xl: number;
 };
 export interface SpinnerProps {
   size?: SpinnerSize | undefined;
@@ -239,4 +505,89 @@ export interface StackProps extends BoxProps {
   wrap?: boolean | undefined;
 }
 //#endregion
-export type { UIContextValue };
+//#region src/types/switch.d.ts
+/**
+ * Contrato de `Switch`: un ajuste que se activa o desactiva con efecto inmediato.
+ * Para una opción que se confirma al enviar un formulario, usa `Checkbox`.
+ */
+export interface SwitchProps {
+  /** Estado controlado por la app. Sin él, guarda su propio estado (ADR-037). */
+  checked?: boolean | undefined;
+  /** Estado inicial cuando guarda su propio estado. */
+  defaultChecked?: boolean | undefined;
+  /** Se llama con el estado nuevo al pulsarlo. */
+  onCheckedChange?: ((checked: boolean) => void) | undefined;
+  /** No se puede pulsar ni enfocar. */
+  disabled?: boolean | undefined;
+  /** Nombre accesible cuando no hay etiqueta visible. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+  /** Etiqueta. Pulsarla también cambia el interruptor. */
+  children?: ReactNode;
+}
+//#endregion
+//#region src/types/tabs.d.ts
+/** Una pestaña de `Tabs`. */
+export interface TabItem<IconName extends string = string> {
+  /** Lo que recibe `onValueChange`. */
+  value: string;
+  /** Texto de la pestaña. */
+  label: string;
+  /** Icono decorativo delante del texto. */
+  icon?: IconName | undefined;
+  disabled?: boolean | undefined;
+  /**
+   * Contenido de su panel. Sin él, `Tabs` solo pinta las pestañas y la app decide qué
+   * mostrar con `value`, por ejemplo para filtrar una lista.
+   */
+  content?: ReactNode;
+}
+/**
+ * Contrato de `Tabs`: varias vistas del mismo nivel entre las que se cambia sin salir de
+ * la página. El conjunto de iconos lo aporta `@satellatickets/icons`, que está fuera de
+ * `core` (ADR-002), por eso el nombre es un parámetro de tipo.
+ */
+export interface TabsProps<IconName extends string = string> {
+  items: readonly TabItem<IconName>[];
+  /** Pestaña elegida, controlada por la app. Sin ella, guarda su propio estado (ADR-037). */
+  value?: string | undefined;
+  /** Pestaña inicial cuando guarda su propio estado. Por defecto, la primera habilitada. */
+  defaultValue?: string | undefined;
+  /** Se llama con el `value` de la pestaña elegida. */
+  onValueChange?: ((value: string) => void) | undefined;
+  /** Nombre accesible del grupo de pestañas ("Mis entradas"). */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+//#region src/types/text-area.d.ts
+/** Contrato de `TextArea`: un campo de texto de varias líneas. */
+export interface TextAreaProps {
+  /** Texto controlado por la app. Sin él, el campo guarda su propio estado (ADR-037). */
+  value?: string | undefined;
+  /** Texto inicial cuando el campo guarda su propio estado. */
+  defaultValue?: string | undefined;
+  /** Se llama con el texto nuevo en cada cambio. */
+  onChangeText?: ((text: string) => void) | undefined;
+  placeholder?: string | undefined;
+  /** Líneas visibles sin desplazarse (por defecto 3). Fija la altura mínima. */
+  rows?: number | undefined;
+  /** No se puede editar ni enfocar. */
+  disabled?: boolean | undefined;
+  /** Se puede enfocar y copiar, pero no editar. */
+  readOnly?: boolean | undefined;
+  /** El valor no es válido. Dentro de un `FormField` con `error` se activa solo. */
+  invalid?: boolean | undefined;
+  required?: boolean | undefined;
+  maxLength?: number | undefined;
+  onFocus?: (() => void) | undefined;
+  onBlur?: (() => void) | undefined;
+  /** Nombre accesible cuando no hay un `FormField` que lo etiquete. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+}
+//#endregion
+export { ColorScheme, FeedbackTone, FormFieldContext, FormFieldControl, FormFieldControlOptions, FormFieldValue, FormFieldValueOptions, LinkPressEvent, LinkProps, LinkUnderline, TOAST_DEFAULT_DURATION, TOAST_MAX_VISIBLE, TextAlign, TextColorToken, TextProps, TextVariant, TextVariantStyle, ThemeMode, ToastAction, ToastApi, ToastContext, ToastItem, ToastOptions, type ToastStore, UIContext, type UIContextValue, UIProviderProps, UseButtonOptions, UseButtonResult, UseControllableStateOptions, UseLinkOptions, UseLinkResult, createFormFieldValue, createToastStore, createUIContextValue, feedbackTones, isFeedbackTone, linkUnderlines, resolveFormFieldControl, textAligns, textColors, textVariantStyles, textVariants, themeModes, useBrand, useButton, useColorScheme, useControllableState, useFormFieldControl, useLink, useTheme, useToast, useUIContext };