@satellatickets/core 0.2.0 → 0.3.0

package/dist/client-DpHlKasm.d.ts

@@ -0,0 +1,300 @@
+
+import { BrandName, Theme, ThemeName } from "@satellatickets/tokens";
+import { ReactNode } from "react";
+//#region src/form-field/context.d.ts
+/** Lo que `FormField` publica para el control que envuelve (ADR-037). */
+interface FormFieldValue {
+  /** `id` del control. `FormField` lo usa en el `htmlFor` de su etiqueta (web). */
+  controlId: string;
+  /** `id` del texto de ayuda, si lo hay (web). */
+  helpId: string | undefined;
+  /** `id` del mensaje de error, si lo hay (web). */
+  errorId: string | undefined;
+  label: string;
+  help: string | undefined;
+  error: string | undefined;
+  disabled: boolean;
+  required: boolean;
+}
+interface FormFieldValueOptions {
+  label: string;
+  help?: string | undefined;
+  error?: string | undefined;
+  disabled?: boolean | undefined;
+  required?: boolean | undefined;
+}
+/** Construye el valor del contexto a partir de un id base (el de `useId()`). */
+declare function createFormFieldValue(baseId: string, { label, help, error, disabled, required }: FormFieldValueOptions): FormFieldValue;
+/** `null` fuera de un `FormField`. */
+declare const FormFieldContext: import("react").Context<FormFieldValue | null>;
+/** Las props propias de un control que se combinan con las de su `FormField`. */
+interface FormFieldControlOptions {
+  id?: string | undefined;
+  invalid?: boolean | undefined;
+  disabled?: boolean | undefined;
+  required?: boolean | undefined;
+  accessibilityLabel?: string | undefined;
+}
+/** Lo que un control necesita para enlazarse con su `FormField`, en web y en nativo. */
+interface FormFieldControl {
+  /** `id` del control (web): el propio o el que espera la etiqueta del campo. */
+  id: string | undefined;
+  /** Ids de la ayuda y el error para `aria-describedby` (web). */
+  describedBy: string | undefined;
+  /** Nombre accesible (nativo): el propio o la etiqueta del campo. */
+  accessibilityLabel: string | undefined;
+  /** El error y la ayuda, uno tras otro, para `accessibilityHint` (nativo). */
+  accessibilityHint: string | undefined;
+  invalid: boolean;
+  disabled: boolean;
+  required: boolean;
+}
+/**
+ * Combina las props de un control con las de su `FormField`. Las del control
+ * mandan en `id` y nombre accesible; `invalid`, `disabled` y `required` se suman:
+ * basta con que lo diga uno de los dos.
+ */
+declare function resolveFormFieldControl(field: FormFieldValue | null, { id, invalid, disabled, required, accessibilityLabel }?: FormFieldControlOptions): FormFieldControl;
+/** Enlaza un control con el `FormField` que lo contiene, si lo hay. */
+declare function useFormFieldControl(options?: FormFieldControlOptions): FormFieldControl;
+//#endregion
+//#region src/hooks/use-button.d.ts
+interface UseButtonOptions {
+  disabled?: boolean | undefined;
+  loading?: boolean | undefined;
+  onPress?: (() => void) | undefined;
+}
+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).
+ */
+declare function useButton({ disabled, loading, onPress }: UseButtonOptions): UseButtonResult;
+//#endregion
+//#region src/hooks/use-controllable-state.d.ts
+interface UseControllableStateOptions<T> {
+  /** Valor controlado por la app. Si existe, manda sobre el estado interno. */
+  value?: T | undefined;
+  /** Valor inicial cuando el componente guarda su propio estado. */
+  defaultValue: T;
+  /** Se llama con el valor nuevo cuando cambia, en los dos modos. */
+  onChange?: ((value: T) => void) | undefined;
+}
+/**
+ * Estado controlado o no, a elección de la app (ADR-037). Con `value`, el componente
+ * solo avisa del cambio y espera a que la app le pase el valor nuevo; sin él, guarda
+ * el estado a partir de `defaultValue`. No avisa si el valor no cambia.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange }: UseControllableStateOptions<T>): [T, (next: T) => void];
+//#endregion
+//#region src/types/text.d.ts
+declare const textVariants: readonly ["hero", "display", "title", "heading", "subheading", "body", "bodySmall", "label", "caption", "code"];
+type TextVariant = (typeof textVariants)[number];
+type TextColorToken = keyof Theme['color']['text'];
+declare const textColors: TextColorToken[];
+declare const textAligns: readonly ["left", "center", "right"];
+type TextAlign = (typeof textAligns)[number];
+/** Tokens que componen una variante tipográfica; ambas vistas los leen del tema. */
+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. */
+declare const textVariantStyles: Readonly<Record<TextVariant, TextVariantStyle>>;
+interface TextProps {
+  variant?: TextVariant | undefined;
+  color?: TextColorToken | undefined;
+  align?: TextAlign | undefined;
+  /** Una sola línea con puntos suspensivos. */
+  truncate?: boolean | undefined;
+  testID?: string | undefined;
+  children?: ReactNode;
+}
+//#endregion
+//#region src/types/link.d.ts
+/**
+ * Cuándo se subraya un `Link` (ADR-009). `always` es lo correcto dentro de un párrafo:
+ * el color solo no basta para distinguir un enlace. `hover` lo subraya al pasar el
+ * puntero o enfocarlo en web, y mientras se pulsa en nativo.
+ */
+declare const linkUnderlines: readonly ["always", "hover"];
+type LinkUnderline = (typeof linkUnderlines)[number];
+/** Lo que recibe `onPress` de un `Link`: permite cancelar la navegación por defecto. */
+interface LinkPressEvent {
+  /** Cancela la navegación por defecto, por ejemplo para hacerla con el router de la app. */
+  preventDefault: () => void;
+  readonly defaultPrevented: boolean;
+}
+interface LinkProps {
+  /** Destino. En web es el `href` del `<a>`; en nativo se abre con `Linking`. */
+  href: string;
+  /**
+   * Tipografía, con las mismas variantes que `Text`. Sin ella hereda la del texto
+   * que lo contiene; fuera de un `Text`, usa `body`.
+   */
+  variant?: TextVariant | undefined;
+  /** Color del texto (por defecto `link`). */
+  color?: TextColorToken | undefined;
+  underline?: LinkUnderline | undefined;
+  /**
+   * Se llama antes de navegar. Con `event.preventDefault()` la librería no navega y
+   * la app decide qué hacer. En web no se llama si el clic lleva un modificador
+   * (Ctrl, Cmd, Mayús, Alt) o no es del botón principal: ahí manda el navegador.
+   */
+  onPress?: ((event: LinkPressEvent) => void) | undefined;
+  /** Nombre accesible cuando el texto visible no basta para describir el destino. */
+  accessibilityLabel?: string | undefined;
+  /** `data-testid` en web, `testID` en nativo. */
+  testID?: string | undefined;
+  children: ReactNode;
+}
+//#endregion
+//#region src/hooks/use-link.d.ts
+interface UseLinkOptions {
+  onPress?: ((event: LinkPressEvent) => void) | undefined;
+}
+interface UseLinkResult {
+  /**
+   * Llama a `onPress` y devuelve `true` si la navegación por defecto debe seguir,
+   * es decir, si nadie llamó a `preventDefault()`.
+   */
+  press: () => boolean;
+}
+/**
+ * Comportamiento de `Link` común a web y nativo: `onPress` se llama antes de navegar
+ * y puede cancelar la navegación por defecto. Cada vista aporta esa navegación
+ * (el `<a>` en web, `Linking` en nativo).
+ */
+declare function useLink({ onPress }: UseLinkOptions): UseLinkResult;
+//#endregion
+//#region src/types/ui-provider.d.ts
+/** Modo de tema que acepta `UIProvider` (ADR-010). */
+declare const themeModes: readonly ["light", "dark", "system"];
+type ThemeMode = (typeof themeModes)[number];
+/** Esquema resuelto: siempre uno de los temas definidos en tokens. */
+type ColorScheme = ThemeName;
+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;
+}
+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. */
+declare const UIContext: import("react").Context<UIContextValue>;
+declare function useUIContext(): UIContextValue;
+/** Tema resuelto (tokens con la marca aplicada). Imprescindible en las vistas nativas (ADR-008). */
+declare function useTheme(): Theme;
+/** `'light' | 'dark'` ya resuelto, también con `theme="system"`. */
+declare function useColorScheme(): ColorScheme;
+declare function useBrand(): BrandName | undefined;
+//#endregion
+//#region src/types/feedback.d.ts
+/**
+ * Los cuatro significados de `color.feedback` en los tokens: éxito, aviso, error e
+ * información. Los comparten los componentes que comunican un estado.
+ */
+declare const feedbackTones: readonly ["success", "warning", "danger", "info"];
+type FeedbackTone = (typeof feedbackTones)[number];
+declare function isFeedbackTone(value: string): value is FeedbackTone;
+//#endregion
+//#region src/types/toast.d.ts
+/** Acción opcional de un toast, por ejemplo "Deshacer". */
+interface ToastAction {
+  label: string;
+  onPress: () => void;
+}
+/** Lo que recibe `show()` de `useToast` (ADR-039). */
+interface ToastOptions {
+  /** Qué comunica (por defecto `info`). Fija el icono y la urgencia con que se anuncia. */
+  tone?: FeedbackTone | undefined;
+  /** El mensaje, en una línea. */
+  title: string;
+  /** Detalle opcional. */
+  description?: string | undefined;
+  /**
+   * Milisegundos hasta que se cierra solo (por defecto 5000). Con `0` no se cierra
+   * solo: necesita `closeLabel`, una `action` o una llamada a `dismiss`.
+   */
+  duration?: number | undefined;
+  /** Botón de acción. Al pulsarlo se llama a `onPress` y el toast se cierra. */
+  action?: ToastAction | undefined;
+  /**
+   * Si existe, el toast muestra un botón de cierre con este nombre accesible
+   * ("Cerrar aviso"). La librería no trae textos propios.
+   */
+  closeLabel?: string | undefined;
+}
+/** Un toast ya en la cola: sus opciones resueltas y su identificador. */
+interface ToastItem {
+  id: string;
+  tone: FeedbackTone;
+  title: string;
+  description: string | undefined;
+  duration: number;
+  action: ToastAction | undefined;
+  closeLabel: string | undefined;
+}
+/** Lo que devuelve `useToast`. */
+interface ToastApi {
+  /** Muestra un toast y devuelve su `id`. */
+  show: (options: ToastOptions) => string;
+  /** Cierra el toast con ese `id`; sin `id`, los cierra todos. */
+  dismiss: (id?: string) => void;
+}
+//#endregion
+//#region src/toast/store.d.ts
+/** Milisegundos que un toast permanece visible si no se indica otra cosa. */
+declare const TOAST_DEFAULT_DURATION = 5000;
+/** Toasts visibles a la vez. Al llegar uno más, se retira el más antiguo. */
+declare const TOAST_MAX_VISIBLE = 3;
+interface ToastStore extends ToastApi {
+  /** Para `useSyncExternalStore`: avisa de cada cambio y devuelve cómo dejar de escuchar. */
+  subscribe: (listener: () => void) => () => void;
+  /** Los toasts visibles, del más antiguo al más reciente. Cambia de identidad con cada cambio. */
+  getSnapshot: () => readonly ToastItem[];
+  /** Detiene el cierre automático, por ejemplo mientras el puntero está sobre los toasts. */
+  pause: () => void;
+  /** Reanuda el cierre automático con el tiempo que le quedaba a cada toast. */
+  resume: () => void;
+}
+/**
+ * La cola de toasts de un `UIProvider` (ADR-039): alta, baja, cierre automático, pausa
+ * y límite de visibles. No depende de React ni de la plataforma.
+ */
+declare function createToastStore(): ToastStore;
+//#endregion
+//#region src/toast/context.d.ts
+/** La cola de toasts del `UIProvider` más cercano; `null` fuera de uno. */
+declare const ToastContext: import("react").Context<ToastStore | null>;
+/**
+ * Muestra y cierra toasts (ADR-039). Necesita un `UIProvider` por encima: es él quien
+ * guarda la cola y los pinta.
+ */
+declare function useToast(): ToastApi;
+//#endregion
+export { useFormFieldControl as $, LinkUnderline as A, textVariants as B, UIProviderProps as C, useLink as D, UseLinkResult as E, TextVariant as F, useButton as G, useControllableState as H, TextVariantStyle as I, FormFieldControlOptions as J, FormFieldContext as K, textAligns as L, TextAlign as M, TextColorToken as N, LinkPressEvent as O, TextProps as P, resolveFormFieldControl as Q, textColors as R, ThemeMode as S, UseLinkOptions as T, UseButtonOptions as U, UseControllableStateOptions as V, UseButtonResult as W, FormFieldValueOptions as X, FormFieldValue as Y, createFormFieldValue as Z, useBrand as _, ToastStore as a, useUIContext as b, ToastApi as c, FeedbackTone as d, feedbackTones as f, createUIContextValue as g, UIContextValue as h, TOAST_MAX_VISIBLE as i, linkUnderlines as j, LinkProps as k, ToastItem as l, UIContext as m, useToast as n, createToastStore as o, isFeedbackTone as p, FormFieldControl as q, TOAST_DEFAULT_DURATION as r, ToastAction as s, ToastContext as t, ToastOptions as u, useColorScheme as v, themeModes as w, ColorScheme as x, useTheme as y, textVariantStyles as z };

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+
+import { $ as useFormFieldControl, D as useLink, E as UseLinkResult, G as useButton, H as useControllableState, J as FormFieldControlOptions, K as FormFieldContext, Q as resolveFormFieldControl, T as UseLinkOptions, U as UseButtonOptions, V as UseControllableStateOptions, W as UseButtonResult, X as FormFieldValueOptions, Y as FormFieldValue, Z as createFormFieldValue, _ as useBrand, b as useUIContext, g as createUIContextValue, h as UIContextValue, m as UIContext, n as useToast, q as FormFieldControl, t as ToastContext, v as useColorScheme, y as useTheme } from "./client-DpHlKasm.js";
+export { FormFieldContext, FormFieldControl, FormFieldControlOptions, FormFieldValue, FormFieldValueOptions, ToastContext, UIContext, type UIContextValue, UseButtonOptions, UseButtonResult, UseControllableStateOptions, UseLinkOptions, UseLinkResult, createFormFieldValue, createUIContextValue, resolveFormFieldControl, useBrand, useButton, useColorScheme, useControllableState, useFormFieldControl, useLink, useTheme, useToast, useUIContext };

package/dist/client.js

@@ -0,0 +1,158 @@
+'use client';
+import { n as resolveColorScheme, r as resolveTheme } from "./resolve-theme-DbIlzBBD.js";
+import { createContext, useCallback, useContext, useState } from "react";
+//#region src/form-field/context.ts
+/** Un texto vacío cuenta como ausente: `error={errores.email}` suele llegar así. */
+function present(text) {
+	return text === void 0 || text === "" ? void 0 : text;
+}
+/** Construye el valor del contexto a partir de un id base (el de `useId()`). */
+function createFormFieldValue(baseId, { label, help, error, disabled = false, required = false }) {
+	const helpText = present(help);
+	const errorText = present(error);
+	return {
+		controlId: `${baseId}-control`,
+		helpId: helpText === void 0 ? void 0 : `${baseId}-help`,
+		errorId: errorText === void 0 ? void 0 : `${baseId}-error`,
+		label,
+		help: helpText,
+		error: errorText,
+		disabled,
+		required
+	};
+}
+/** `null` fuera de un `FormField`. */
+const FormFieldContext = createContext(null);
+/**
+* Combina las props de un control con las de su `FormField`. Las del control
+* mandan en `id` y nombre accesible; `invalid`, `disabled` y `required` se suman:
+* basta con que lo diga uno de los dos.
+*/
+function resolveFormFieldControl(field, { id, invalid = false, disabled = false, required = false, accessibilityLabel } = {}) {
+	if (field === null) return {
+		id,
+		describedBy: void 0,
+		accessibilityLabel,
+		accessibilityHint: void 0,
+		invalid,
+		disabled,
+		required
+	};
+	const describedBy = [field.helpId, field.errorId].filter((part) => part !== void 0).join(" ");
+	const hint = [field.error, field.help].filter((part) => part !== void 0).join(" ");
+	return {
+		id: id ?? field.controlId,
+		describedBy: describedBy === "" ? void 0 : describedBy,
+		accessibilityLabel: accessibilityLabel ?? field.label,
+		accessibilityHint: hint === "" ? void 0 : hint,
+		invalid: invalid || field.error !== void 0,
+		disabled: disabled || field.disabled,
+		required: required || field.required
+	};
+}
+/** Enlaza un control con el `FormField` que lo contiene, si lo hay. */
+function useFormFieldControl(options) {
+	return resolveFormFieldControl(useContext(FormFieldContext), options);
+}
+//#endregion
+//#region src/hooks/use-button.ts
+/**
+* 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).
+*/
+function useButton({ disabled = false, loading = false, onPress }) {
+	const interactive = !disabled && !loading;
+	return {
+		disabled,
+		loading,
+		interactive,
+		press: useCallback(() => {
+			if (interactive) onPress?.();
+		}, [interactive, onPress])
+	};
+}
+//#endregion
+//#region src/hooks/use-controllable-state.ts
+/**
+* Estado controlado o no, a elección de la app (ADR-037). Con `value`, el componente
+* solo avisa del cambio y espera a que la app le pase el valor nuevo; sin él, guarda
+* el estado a partir de `defaultValue`. No avisa si el valor no cambia.
+*/
+function useControllableState({ value, defaultValue, onChange }) {
+	const [internal, setInternal] = useState(defaultValue);
+	const controlled = value !== void 0;
+	const current = controlled ? value : internal;
+	return [current, useCallback((next) => {
+		if (Object.is(next, current)) return;
+		if (!controlled) setInternal(next);
+		onChange?.(next);
+	}, [
+		controlled,
+		current,
+		onChange
+	])];
+}
+//#endregion
+//#region src/hooks/use-link.ts
+/**
+* Comportamiento de `Link` común a web y nativo: `onPress` se llama antes de navegar
+* y puede cancelar la navegación por defecto. Cada vista aporta esa navegación
+* (el `<a>` en web, `Linking` en nativo).
+*/
+function useLink({ onPress }) {
+	return { press: useCallback(() => {
+		let prevented = false;
+		onPress?.({
+			preventDefault: () => {
+				prevented = true;
+			},
+			get defaultPrevented() {
+				return prevented;
+			}
+		});
+		return !prevented;
+	}, [onPress]) };
+}
+//#endregion
+//#region src/theme/context.ts
+function createUIContextValue(mode, systemScheme, brand) {
+	const colorScheme = resolveColorScheme(mode, systemScheme);
+	return {
+		theme: resolveTheme(colorScheme, brand),
+		colorScheme,
+		mode,
+		brand
+	};
+}
+/** Sin `UIProvider` se usa el tema claro por defecto, para que los componentes funcionen aislados. */
+const UIContext = createContext(createUIContextValue("light", "light"));
+function useUIContext() {
+	return useContext(UIContext);
+}
+/** Tema resuelto (tokens con la marca aplicada). Imprescindible en las vistas nativas (ADR-008). */
+function useTheme() {
+	return useContext(UIContext).theme;
+}
+/** `'light' | 'dark'` ya resuelto, también con `theme="system"`. */
+function useColorScheme() {
+	return useContext(UIContext).colorScheme;
+}
+function useBrand() {
+	return useContext(UIContext).brand;
+}
+//#endregion
+//#region src/toast/context.ts
+/** La cola de toasts del `UIProvider` más cercano; `null` fuera de uno. */
+const ToastContext = createContext(null);
+/**
+* Muestra y cierra toasts (ADR-039). Necesita un `UIProvider` por encima: es él quien
+* guarda la cola y los pinta.
+*/
+function useToast() {
+	const store = useContext(ToastContext);
+	if (store === null) throw new Error("useToast necesita un <UIProvider> por encima: es él quien pinta los toasts.");
+	return store;
+}
+//#endregion
+export { FormFieldContext, ToastContext, UIContext, createFormFieldValue, createUIContextValue, resolveFormFieldControl, useBrand, useButton, useColorScheme, useControllableState, useFormFieldControl, useLink, useTheme, useToast, useUIContext };

package/dist/index.d.ts

@@ -1,185 +1,36 @@
-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/form-field/context.d.ts
-/** Lo que `FormField` publica para el control que envuelve (ADR-037). */
-export interface FormFieldValue {
-  /** `id` del control. `FormField` lo usa en el `htmlFor` de su etiqueta (web). */
-  controlId: string;
-  /** `id` del texto de ayuda, si lo hay (web). */
-  helpId: string | undefined;
-  /** `id` del mensaje de error, si lo hay (web). */
-  errorId: string | undefined;
-  label: string;
-  help: string | undefined;
-  error: string | undefined;
-  disabled: boolean;
-  required: boolean;
-}
-export interface FormFieldValueOptions {
+import { ReactNode } from "react";
+//#region src/select/navigation.d.ts
+/** Lo mínimo que hace falta saber de una opción para moverse entre ellas y buscarla. */
+export interface NavigableOption {
+  value: string;
   label: string;
-  help?: string | undefined;
-  error?: string | undefined;
-  disabled?: boolean | undefined;
-  required?: boolean | undefined;
-}
-/** Construye el valor del contexto a partir de un id base (el de `useId()`). */
-export declare function createFormFieldValue(baseId: string, { label, help, error, disabled, required }: FormFieldValueOptions): FormFieldValue;
-/** `null` fuera de un `FormField`. */
-export declare const FormFieldContext: import("react").Context<FormFieldValue | null>;
-/** Las props propias de un control que se combinan con las de su `FormField`. */
-export interface FormFieldControlOptions {
-  id?: string | undefined;
-  invalid?: boolean | undefined;
   disabled?: boolean | undefined;
-  required?: boolean | undefined;
-  accessibilityLabel?: string | undefined;
-}
-/** Lo que un control necesita para enlazarse con su `FormField`, en web y en nativo. */
-export interface FormFieldControl {
-  /** `id` del control (web): el propio o el que espera la etiqueta del campo. */
-  id: string | undefined;
-  /** Ids de la ayuda y el error para `aria-describedby` (web). */
-  describedBy: string | undefined;
-  /** Nombre accesible (nativo): el propio o la etiqueta del campo. */
-  accessibilityLabel: string | undefined;
-  /** El error y la ayuda, uno tras otro, para `accessibilityHint` (nativo). */
-  accessibilityHint: string | undefined;
-  invalid: boolean;
-  disabled: boolean;
-  required: boolean;
-}
-/**
- * Combina las props de un control con las de su `FormField`. Las del control
- * mandan en `id` y nombre accesible; `invalid`, `disabled` y `required` se suman:
- * basta con que lo diga uno de los dos.
- */
-export declare function resolveFormFieldControl(field: FormFieldValue | null, { id, invalid, disabled, required, accessibilityLabel }?: FormFieldControlOptions): FormFieldControl;
-/** Enlaza un control con el `FormField` que lo contiene, si lo hay. */
-export declare function useFormFieldControl(options?: FormFieldControlOptions): FormFieldControl;
-//#endregion
-//#region src/hooks/use-button.d.ts
-export interface UseButtonOptions {
-  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;
 }
+/** Hacia dónde mueve el resaltado una tecla: flechas, Inicio, Fin, AvPág y RePág. */
+export declare const optionDirections: readonly ["next", "previous", "first", "last", "nextPage", "previousPage"];
+export type OptionDirection = (typeof optionDirections)[number];
+/** Cuántas opciones salta AvPág o RePág. */
+export declare const OPTION_PAGE_SIZE = 10;
 /**
- * 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).
+ * La opción a la que lleva una tecla desde la actual, saltando las deshabilitadas. No da
+ * la vuelta: al llegar a un extremo se queda en él (ADR-042). Si no hay ninguna a la
+ * que ir, devuelve la actual.
  */
-export declare function useButton({ disabled, loading, onPress }: UseButtonOptions): UseButtonResult;
-//#endregion
-//#region src/hooks/use-controllable-state.d.ts
-export interface UseControllableStateOptions<T> {
-  /** Valor controlado por la app. Si existe, manda sobre el estado interno. */
-  value?: T | undefined;
-  /** Valor inicial cuando el componente guarda su propio estado. */
-  defaultValue: T;
-  /** Se llama con el valor nuevo cuando cambia, en los dos modos. */
-  onChange?: ((value: T) => void) | undefined;
-}
+export declare function getOptionInDirection(options: readonly NavigableOption[], current: string | undefined, direction: OptionDirection): string | undefined;
 /**
- * Estado controlado o no, a elección de la app (ADR-037). Con `value`, el componente
- * solo avisa del cambio y espera a que la app le pase el valor nuevo; sin él, guarda
- * el estado a partir de `defaultValue`. No avisa si el valor no cambia.
+ * La opción habilitada cuyo texto empieza por lo que el usuario ha escrito, o `undefined`
+ * si no hay ninguna.
+ *
+ * - Una sola letra busca a partir de la siguiente a la actual, así que pulsarla varias
+ *   veces recorre las que empiezan por ella.
+ * - Un texto más largo se queda en la actual mientras siga coincidiendo.
+ * - La misma letra repetida ("bb") que no es el principio de ninguna opción vale como
+ *   pulsarla otra vez.
  */
-export declare function useControllableState<T>({ value, defaultValue, onChange }: UseControllableStateOptions<T>): [T, (next: T) => void];
-//#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;
-  testID?: string | undefined;
-  children?: ReactNode;
-}
-//#endregion
-//#region src/types/link.d.ts
-/**
- * Cuándo se subraya un `Link` (ADR-009). `always` es lo correcto dentro de un párrafo:
- * el color solo no basta para distinguir un enlace. `hover` lo subraya al pasar el
- * puntero o enfocarlo en web, y mientras se pulsa en nativo.
- */
-export declare const linkUnderlines: readonly ["always", "hover"];
-export type LinkUnderline = (typeof linkUnderlines)[number];
-/** Lo que recibe `onPress` de un `Link`: permite cancelar la navegación por defecto. */
-export interface LinkPressEvent {
-  /** Cancela la navegación por defecto, por ejemplo para hacerla con el router de la app. */
-  preventDefault: () => void;
-  readonly defaultPrevented: boolean;
-}
-export interface LinkProps {
-  /** Destino. En web es el `href` del `<a>`; en nativo se abre con `Linking`. */
-  href: string;
-  /**
-   * Tipografía, con las mismas variantes que `Text`. Sin ella hereda la del texto
-   * que lo contiene; fuera de un `Text`, usa `body`.
-   */
-  variant?: TextVariant | undefined;
-  /** Color del texto (por defecto `link`). */
-  color?: TextColorToken | undefined;
-  underline?: LinkUnderline | undefined;
-  /**
-   * Se llama antes de navegar. Con `event.preventDefault()` la librería no navega y
-   * la app decide qué hacer. En web no se llama si el clic lleva un modificador
-   * (Ctrl, Cmd, Mayús, Alt) o no es del botón principal: ahí manda el navegador.
-   */
-  onPress?: ((event: LinkPressEvent) => void) | undefined;
-  /** Nombre accesible cuando el texto visible no basta para describir el destino. */
-  accessibilityLabel?: string | undefined;
-  /** `data-testid` en web, `testID` en nativo. */
-  testID?: string | undefined;
-  children: ReactNode;
-}
-//#endregion
-//#region src/hooks/use-link.d.ts
-export interface UseLinkOptions {
-  onPress?: ((event: LinkPressEvent) => void) | undefined;
-}
-export interface UseLinkResult {
-  /**
-   * Llama a `onPress` y devuelve `true` si la navegación por defecto debe seguir,
-   * es decir, si nadie llamó a `preventDefault()`.
-   */
-  press: () => boolean;
-}
-/**
- * Comportamiento de `Link` común a web y nativo: `onPress` se llama antes de navegar
- * y puede cancelar la navegación por defecto. Cada vista aporta esa navegación
- * (el `<a>` en web, `Linking` en nativo).
- */
-export declare function useLink({ onPress }: UseLinkOptions): UseLinkResult;
+export declare function findOptionByText(options: readonly NavigableOption[], text: string, current?: string): string | undefined;
 //#endregion
 //#region src/tabs/navigation.d.ts
 /** Lo mínimo que hace falta saber de una pestaña para moverse entre ellas. */
@@ -199,37 +50,6 @@ export declare function firstEnabledTab(items: readonly NavigableTab[]): string
  */
 export declare function getTabInDirection(items: readonly NavigableTab[], current: string, direction: TabDirection): string;
 //#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;
-//#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. */
 export declare function mergeTheme(base: Theme, overrides: ThemeOverrides): Theme;
@@ -237,90 +57,6 @@ 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/feedback.d.ts
-/**
- * Los cuatro significados de `color.feedback` en los tokens: éxito, aviso, error e
- * información. Los comparten los componentes que comunican un estado.
- */
-export declare const feedbackTones: readonly ["success", "warning", "danger", "info"];
-export type FeedbackTone = (typeof feedbackTones)[number];
-export declare function isFeedbackTone(value: string): value is FeedbackTone;
-//#endregion
-//#region src/types/toast.d.ts
-/** Acción opcional de un toast, por ejemplo "Deshacer". */
-export interface ToastAction {
-  label: string;
-  onPress: () => void;
-}
-/** Lo que recibe `show()` de `useToast` (ADR-039). */
-export interface ToastOptions {
-  /** Qué comunica (por defecto `info`). Fija el icono y la urgencia con que se anuncia. */
-  tone?: FeedbackTone | undefined;
-  /** El mensaje, en una línea. */
-  title: string;
-  /** Detalle opcional. */
-  description?: string | undefined;
-  /**
-   * Milisegundos hasta que se cierra solo (por defecto 5000). Con `0` no se cierra
-   * solo: necesita `closeLabel`, una `action` o una llamada a `dismiss`.
-   */
-  duration?: number | undefined;
-  /** Botón de acción. Al pulsarlo se llama a `onPress` y el toast se cierra. */
-  action?: ToastAction | undefined;
-  /**
-   * Si existe, el toast muestra un botón de cierre con este nombre accesible
-   * ("Cerrar aviso"). La librería no trae textos propios.
-   */
-  closeLabel?: string | undefined;
-}
-/** Un toast ya en la cola: sus opciones resueltas y su identificador. */
-export interface ToastItem {
-  id: string;
-  tone: FeedbackTone;
-  title: string;
-  description: string | undefined;
-  duration: number;
-  action: ToastAction | undefined;
-  closeLabel: string | undefined;
-}
-/** Lo que devuelve `useToast`. */
-export interface ToastApi {
-  /** Muestra un toast y devuelve su `id`. */
-  show: (options: ToastOptions) => string;
-  /** Cierra el toast con ese `id`; sin `id`, los cierra todos. */
-  dismiss: (id?: string) => void;
-}
-//#endregion
-//#region src/toast/store.d.ts
-/** Milisegundos que un toast permanece visible si no se indica otra cosa. */
-export declare const TOAST_DEFAULT_DURATION = 5000;
-/** Toasts visibles a la vez. Al llegar uno más, se retira el más antiguo. */
-export declare const TOAST_MAX_VISIBLE = 3;
-interface ToastStore extends ToastApi {
-  /** Para `useSyncExternalStore`: avisa de cada cambio y devuelve cómo dejar de escuchar. */
-  subscribe: (listener: () => void) => () => void;
-  /** Los toasts visibles, del más antiguo al más reciente. Cambia de identidad con cada cambio. */
-  getSnapshot: () => readonly ToastItem[];
-  /** Detiene el cierre automático, por ejemplo mientras el puntero está sobre los toasts. */
-  pause: () => void;
-  /** Reanuda el cierre automático con el tiempo que le quedaba a cada toast. */
-  resume: () => void;
-}
-/**
- * La cola de toasts de un `UIProvider` (ADR-039): alta, baja, cierre automático, pausa
- * y límite de visibles. No depende de React ni de la plataforma.
- */
-export declare function createToastStore(): ToastStore;
-//#endregion
-//#region src/toast/context.d.ts
-/** La cola de toasts del `UIProvider` más cercano; `null` fuera de uno. */
-export declare const ToastContext: import("react").Context<ToastStore | null>;
-/**
- * Muestra y cierra toasts (ADR-039). Necesita un `UIProvider` por encima: es él quien
- * guarda la cola y los pinta.
- */
-export declare function useToast(): ToastApi;
-//#endregion
 //#region src/types/alert.d.ts
 interface AlertBaseProps {
   /** Qué comunica (por defecto `info`). Fija el color y el icono. */
@@ -705,7 +441,7 @@ export interface SelectOption {
   label: string;
   disabled?: boolean | undefined;
 }
-/** Contrato de `Select`: elegir una opción de una lista (ADR-038). */
+/** Contrato de `Select`: elegir una opción de una lista (ADR-042). */
 export interface SelectProps {
   options: readonly SelectOption[];
   /** Opción elegida, controlada por la app. Sin ella, guarda su propio estado (ADR-037). */
@@ -884,4 +620,4 @@ export interface TextAreaProps {
   testID?: string | undefined;
 }
 //#endregion
-export type { ToastStore, UIContextValue };
+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 };

package/dist/index.js

@@ -1,117 +1,67 @@
-import { createContext, useCallback, useContext, useState } from "react";
-import { brands, themes } from "@satellatickets/tokens";
-//#region src/form-field/context.ts
-/** Un texto vacío cuenta como ausente: `error={errores.email}` suele llegar así. */
-function present(text) {
-	return text === void 0 || text === "" ? void 0 : text;
-}
-/** Construye el valor del contexto a partir de un id base (el de `useId()`). */
-function createFormFieldValue(baseId, { label, help, error, disabled = false, required = false }) {
-	const helpText = present(help);
-	const errorText = present(error);
-	return {
-		controlId: `${baseId}-control`,
-		helpId: helpText === void 0 ? void 0 : `${baseId}-help`,
-		errorId: errorText === void 0 ? void 0 : `${baseId}-error`,
-		label,
-		help: helpText,
-		error: errorText,
-		disabled,
-		required
-	};
-}
-/** `null` fuera de un `FormField`. */
-const FormFieldContext = createContext(null);
+
+import { n as resolveColorScheme, r as resolveTheme, t as mergeTheme } from "./resolve-theme-DbIlzBBD.js";
+import { themes } from "@satellatickets/tokens";
+export * from "./client.js";
+//#region src/select/navigation.ts
+/** Hacia dónde mueve el resaltado una tecla: flechas, Inicio, Fin, AvPág y RePág. */
+const optionDirections = [
+	"next",
+	"previous",
+	"first",
+	"last",
+	"nextPage",
+	"previousPage"
+];
+/** Cuántas opciones salta AvPág o RePág. */
+const OPTION_PAGE_SIZE = 10;
+const steps = {
+	next: 1,
+	previous: -1,
+	nextPage: 10,
+	previousPage: -10
+};
 /**
-* Combina las props de un control con las de su `FormField`. Las del control
-* mandan en `id` y nombre accesible; `invalid`, `disabled` y `required` se suman:
-* basta con que lo diga uno de los dos.
+* La opción a la que lleva una tecla desde la actual, saltando las deshabilitadas. No da
+* la vuelta: al llegar a un extremo se queda en él (ADR-042). Si no hay ninguna a la
+* que ir, devuelve la actual.
 */
-function resolveFormFieldControl(field, { id, invalid = false, disabled = false, required = false, accessibilityLabel } = {}) {
-	if (field === null) return {
-		id,
-		describedBy: void 0,
-		accessibilityLabel,
-		accessibilityHint: void 0,
-		invalid,
-		disabled,
-		required
-	};
-	const describedBy = [field.helpId, field.errorId].filter((part) => part !== void 0).join(" ");
-	const hint = [field.error, field.help].filter((part) => part !== void 0).join(" ");
-	return {
-		id: id ?? field.controlId,
-		describedBy: describedBy === "" ? void 0 : describedBy,
-		accessibilityLabel: accessibilityLabel ?? field.label,
-		accessibilityHint: hint === "" ? void 0 : hint,
-		invalid: invalid || field.error !== void 0,
-		disabled: disabled || field.disabled,
-		required: required || field.required
-	};
-}
-/** Enlaza un control con el `FormField` que lo contiene, si lo hay. */
-function useFormFieldControl(options) {
-	return resolveFormFieldControl(useContext(FormFieldContext), options);
+function getOptionInDirection(options, current, direction) {
+	const enabled = options.filter((option) => option.disabled !== true).map(({ value }) => value);
+	const [first] = enabled;
+	const last = enabled[enabled.length - 1];
+	if (first === void 0 || last === void 0) return current;
+	if (direction === "first") return first;
+	if (direction === "last") return last;
+	const step = steps[direction];
+	const index = current === void 0 ? -1 : enabled.indexOf(current);
+	if (index === -1) return step > 0 ? first : last;
+	return enabled[Math.min(Math.max(index + step, 0), enabled.length - 1)] ?? current;
 }
-//#endregion
-//#region src/hooks/use-button.ts
-/**
-* 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).
-*/
-function useButton({ disabled = false, loading = false, onPress }) {
-	const interactive = !disabled && !loading;
-	return {
-		disabled,
-		loading,
-		interactive,
-		press: useCallback(() => {
-			if (interactive) onPress?.();
-		}, [interactive, onPress])
-	};
+/** Sin mayúsculas ni acentos: al escribir "avila" se encuentra "Ávila". */
+function normalize(text) {
+	return text.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLocaleLowerCase();
 }
-//#endregion
-//#region src/hooks/use-controllable-state.ts
 /**
-* Estado controlado o no, a elección de la app (ADR-037). Con `value`, el componente
-* solo avisa del cambio y espera a que la app le pase el valor nuevo; sin él, guarda
-* el estado a partir de `defaultValue`. No avisa si el valor no cambia.
+* La opción habilitada cuyo texto empieza por lo que el usuario ha escrito, o `undefined`
+* si no hay ninguna.
+*
+* - Una sola letra busca a partir de la siguiente a la actual, así que pulsarla varias
+*   veces recorre las que empiezan por ella.
+* - Un texto más largo se queda en la actual mientras siga coincidiendo.
+* - La misma letra repetida ("bb") que no es el principio de ninguna opción vale como
+*   pulsarla otra vez.
 */
-function useControllableState({ value, defaultValue, onChange }) {
-	const [internal, setInternal] = useState(defaultValue);
-	const controlled = value !== void 0;
-	const current = controlled ? value : internal;
-	return [current, useCallback((next) => {
-		if (Object.is(next, current)) return;
-		if (!controlled) setInternal(next);
-		onChange?.(next);
-	}, [
-		controlled,
-		current,
-		onChange
-	])];
-}
-//#endregion
-//#region src/hooks/use-link.ts
-/**
-* Comportamiento de `Link` común a web y nativo: `onPress` se llama antes de navegar
-* y puede cancelar la navegación por defecto. Cada vista aporta esa navegación
-* (el `<a>` en web, `Linking` en nativo).
-*/
-function useLink({ onPress }) {
-	return { press: useCallback(() => {
-		let prevented = false;
-		onPress?.({
-			preventDefault: () => {
-				prevented = true;
-			},
-			get defaultPrevented() {
-				return prevented;
-			}
-		});
-		return !prevented;
-	}, [onPress]) };
+function findOptionByText(options, text, current) {
+	const query = normalize(text);
+	const [letter] = query;
+	if (letter === void 0) return void 0;
+	const enabled = options.filter((option) => option.disabled !== true);
+	const index = enabled.findIndex((option) => option.value === current);
+	const startingWith = (prefix, from) => [...enabled.slice(from), ...enabled.slice(0, from)].find((option) => normalize(option.label).startsWith(prefix))?.value;
+	if (query.length === 1) return startingWith(letter, index + 1);
+	const match = startingWith(query, Math.max(index, 0));
+	if (match !== void 0) return match;
+	return [...query].every((char) => char === letter) ? startingWith(letter, index + 1) : void 0;
 }
 //#endregion
 //#region src/tabs/navigation.ts
@@ -144,79 +94,6 @@ function getTabInDirection(items, current, direction) {
 	return enabled[(index + (direction === "next" ? 1 : -1) + enabled.length) % enabled.length] ?? current;
 }
 //#endregion
-//#region src/theme/resolve-theme.ts
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function merge(base, overrides) {
-	const result = { ...base };
-	for (const [key, value] of Object.entries(overrides)) {
-		if (value === void 0) continue;
-		const current = base[key];
-		result[key] = isPlainObject(current) && isPlainObject(value) ? merge(current, value) : value;
-	}
-	return result;
-}
-/** Combina los overrides de una marca sobre un tema (ADR-010). Los arrays (sombras) se sustituyen enteros. */
-function mergeTheme(base, overrides) {
-	return merge(base, overrides);
-}
-const cache = /* @__PURE__ */ new Map();
-/** Tema resuelto para un esquema y una marca; memoizado para que la identidad sea estable. */
-function resolveTheme(scheme, brand) {
-	const key = `${scheme}/${brand ?? ""}`;
-	const cached = cache.get(key);
-	if (cached) return cached;
-	const base = themes[scheme];
-	const overrides = brand === void 0 ? void 0 : brands[brand]?.[scheme];
-	const resolved = overrides === void 0 ? base : mergeTheme(base, overrides);
-	cache.set(key, resolved);
-	return resolved;
-}
-function resolveColorScheme(mode, systemScheme) {
-	return mode === "system" ? systemScheme : mode;
-}
-//#endregion
-//#region src/theme/context.ts
-function createUIContextValue(mode, systemScheme, brand) {
-	const colorScheme = resolveColorScheme(mode, systemScheme);
-	return {
-		theme: resolveTheme(colorScheme, brand),
-		colorScheme,
-		mode,
-		brand
-	};
-}
-/** Sin `UIProvider` se usa el tema claro por defecto, para que los componentes funcionen aislados. */
-const UIContext = createContext(createUIContextValue("light", "light"));
-function useUIContext() {
-	return useContext(UIContext);
-}
-/** Tema resuelto (tokens con la marca aplicada). Imprescindible en las vistas nativas (ADR-008). */
-function useTheme() {
-	return useContext(UIContext).theme;
-}
-/** `'light' | 'dark'` ya resuelto, también con `theme="system"`. */
-function useColorScheme() {
-	return useContext(UIContext).colorScheme;
-}
-function useBrand() {
-	return useContext(UIContext).brand;
-}
-//#endregion
-//#region src/toast/context.ts
-/** La cola de toasts del `UIProvider` más cercano; `null` fuera de uno. */
-const ToastContext = createContext(null);
-/**
-* Muestra y cierra toasts (ADR-039). Necesita un `UIProvider` por encima: es él quien
-* guarda la cola y los pinta.
-*/
-function useToast() {
-	const store = useContext(ToastContext);
-	if (store === null) throw new Error("useToast necesita un <UIProvider> por encima: es él quien pinta los toasts.");
-	return store;
-}
-//#endregion
 //#region src/toast/store.ts
 /** Milisegundos que un toast permanece visible si no se indica otra cosa. */
 const TOAST_DEFAULT_DURATION = 5e3;
@@ -573,4 +450,4 @@ const themeModes = [
 	"system"
 ];
 //#endregion
-export { FormFieldContext, TOAST_DEFAULT_DURATION, TOAST_MAX_VISIBLE, ToastContext, UIContext, backgroundTokens, badgeVariants, borderColorTokens, buttonIconSize, buttonVariants, cardVariants, controlSizes, createFormFieldValue, createToastStore, createUIContextValue, dividerOrientations, feedbackTones, firstEnabledTab, getTabInDirection, iconButtonIconSize, iconSizePx, iconSizes, inputIconSize, inputTypes, isFeedbackTone, linkUnderlines, mergeTheme, modalPresentations, radiusTokens, resolveColorScheme, resolveFormFieldControl, resolveTheme, shadowTokens, skeletonShapes, spaceTokens, spinnerSizePx, spinnerSizes, stackAligns, stackDirections, stackJustifies, tabDirections, textAligns, textColors, textVariantStyles, textVariants, themeModes, useBrand, useButton, useColorScheme, useControllableState, useFormFieldControl, useLink, useTheme, useToast, useUIContext };
+export { OPTION_PAGE_SIZE, TOAST_DEFAULT_DURATION, TOAST_MAX_VISIBLE, backgroundTokens, badgeVariants, borderColorTokens, buttonIconSize, buttonVariants, cardVariants, controlSizes, createToastStore, dividerOrientations, feedbackTones, findOptionByText, firstEnabledTab, getOptionInDirection, getTabInDirection, iconButtonIconSize, iconSizePx, iconSizes, inputIconSize, inputTypes, isFeedbackTone, linkUnderlines, mergeTheme, modalPresentations, optionDirections, radiusTokens, resolveColorScheme, resolveTheme, shadowTokens, skeletonShapes, spaceTokens, spinnerSizePx, spinnerSizes, stackAligns, stackDirections, stackJustifies, tabDirections, textAligns, textColors, textVariantStyles, textVariants, themeModes };

package/dist/resolve-theme-DbIlzBBD.js

@@ -0,0 +1,36 @@
+
+import { brands, themes } from "@satellatickets/tokens";
+//#region src/theme/resolve-theme.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function merge(base, overrides) {
+	const result = { ...base };
+	for (const [key, value] of Object.entries(overrides)) {
+		if (value === void 0) continue;
+		const current = base[key];
+		result[key] = isPlainObject(current) && isPlainObject(value) ? merge(current, value) : value;
+	}
+	return result;
+}
+/** Combina los overrides de una marca sobre un tema (ADR-010). Los arrays (sombras) se sustituyen enteros. */
+function mergeTheme(base, overrides) {
+	return merge(base, overrides);
+}
+const cache = /* @__PURE__ */ new Map();
+/** Tema resuelto para un esquema y una marca; memoizado para que la identidad sea estable. */
+function resolveTheme(scheme, brand) {
+	const key = `${scheme}/${brand ?? ""}`;
+	const cached = cache.get(key);
+	if (cached) return cached;
+	const base = themes[scheme];
+	const overrides = brand === void 0 ? void 0 : brands[brand]?.[scheme];
+	const resolved = overrides === void 0 ? base : mergeTheme(base, overrides);
+	cache.set(key, resolved);
+	return resolved;
+}
+function resolveColorScheme(mode, systemScheme) {
+	return mode === "system" ? systemScheme : mode;
+}
+//#endregion
+export { resolveColorScheme as n, resolveTheme as r, mergeTheme as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satellatickets/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Lógica headless de satella-ui: contratos de props, constantes de variantes, contexto de tema y hooks compartidos por React y React Native",
   "license": "MIT",
   "repository": {