@satellatickets/ui 0.1.0 → 0.2.1

package/dist/web/index.d.ts

@@ -1,6 +1,17 @@
-import { BadgeProps, BadgeProps as BadgeProps$1, BoxProps, BoxProps as BoxProps$1, ButtonProps as ButtonProps$1, ColorScheme, IconProps as IconProps$1, SpinnerProps, SpinnerProps as SpinnerProps$1, StackProps, StackProps as StackProps$1, TextProps, TextProps as TextProps$1, ThemeMode, UIProviderProps, UIProviderProps as UIProviderProps$1, useBrand, useColorScheme, useTheme } from "@satellatickets/core";
+
+import { AlertProps, AlertProps as AlertProps$1, BadgeProps, BadgeProps as BadgeProps$1, BoxProps, BoxProps as BoxProps$1, ButtonProps as ButtonProps$1, CardProps, CardProps as CardProps$1, CheckboxProps, CheckboxProps as CheckboxProps$1, ColorScheme, DividerProps, DividerProps as DividerProps$1, FormFieldProps, FormFieldProps as FormFieldProps$1, IconButtonProps as IconButtonProps$1, IconProps as IconProps$1, InputProps as InputProps$1, LinkPressEvent, LinkProps, LinkProps as LinkProps$1, ModalProps, ModalProps as ModalProps$1, SelectOption, SelectProps, SelectProps as SelectProps$1, SheetProps, SkeletonProps, SkeletonProps as SkeletonProps$1, SpinnerProps, SpinnerProps as SpinnerProps$1, StackProps, StackProps as StackProps$1, SwitchProps, SwitchProps as SwitchProps$1, TabItem as TabItem$1, TabsProps as TabsProps$1, TextAreaProps, TextAreaProps as TextAreaProps$1, TextProps, TextProps as TextProps$1, ThemeMode, ToastAction, ToastApi, ToastOptions, UIProviderProps, UIProviderProps as UIProviderProps$1, useBrand, useColorScheme, useTheme, useToast } from "@satellatickets/core";
 import { CSSProperties, Ref } from "react";
 import "react-native";
+//#region src/alert/Alert.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+type AlertWebProps = AlertProps$1 & {
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+};
+//#endregion
+//#region src/alert/Alert.web.d.ts
+export declare function Alert({ tone, title, onClose, closeLabel, className, style, testID, children }: AlertWebProps): import("react").JSX.Element;
+//#endregion
 //#region src/badge/Badge.types.d.ts
 /** Extensión solo web del contrato (ADR-009). */
 interface BadgeWebProps extends BadgeProps$1 {
@@ -53,9 +64,160 @@ interface ButtonWebProps extends ButtonProps {
 //#region src/button/Button.web.d.ts
 export declare function Button({ variant, size, disabled, loading, iconStart, iconEnd, fullWidth, onPress, accessibilityLabel, type, className, style, testID, ref, children }: ButtonWebProps): import("react").JSX.Element;
 //#endregion
+//#region src/card/Card.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+interface CardWebProps extends CardProps$1 {
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLDivElement> | undefined;
+}
+//#endregion
+//#region src/card/Card.web.d.ts
+export declare function Card({ variant, padding, onPress, accessibilityLabel, className, style, testID, ref, children }: CardWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/checkbox/Checkbox.types.d.ts
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface CheckboxWebProps extends CheckboxProps$1 {
+  id?: string | undefined;
+  /** Nombre con el que viaja en un `<form>`. */
+  name?: string | undefined;
+  /** Valor que viaja en el `<form>` cuando está marcada (por defecto `on`). */
+  value?: string | undefined;
+  /** Se aplican a la etiqueta que envuelve la casilla y su texto. */
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLInputElement> | undefined;
+}
+//#endregion
+//#region src/checkbox/Checkbox.web.d.ts
+export declare function Checkbox({ checked, defaultChecked, indeterminate, onCheckedChange, disabled, invalid, required, accessibilityLabel, id, name, value, className, style, testID, ref, children }: CheckboxWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/divider/Divider.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+interface DividerWebProps extends DividerProps$1 {
+  className?: string | undefined;
+}
+//#endregion
+//#region src/divider/Divider.web.d.ts
+export declare function Divider({ orientation, className, testID }: DividerWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/form-field/FormField.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+interface FormFieldWebProps extends FormFieldProps$1 {
+  className?: string | undefined;
+}
+//#endregion
+//#region src/form-field/FormField.web.d.ts
+/**
+ * Etiqueta, ayuda y error de un control (ADR-037). El `<label>` apunta al `id` que
+ * toma el control, y la ayuda y el error se enlazan con `aria-describedby`.
+ */
+export declare function FormField({ label, help, error, required, disabled, className, testID, children }: FormFieldWebProps): import("react").JSX.Element;
+//#endregion
 //#region src/icon/Icon.web.d.ts
 export declare function Icon({ name, size, color, label, className, testID }: IconWebProps): import("react").JSX.Element;
 //#endregion
+//#region src/icon-button/IconButton.types.d.ts
+/** Contrato de `IconButton` con el conjunto de iconos de la librería. */
+type IconButtonProps = IconButtonProps$1<IconName>;
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface IconButtonWebProps extends IconButtonProps {
+  /** Tipo del `<button>`. Por defecto `button`, para no enviar formularios por accidente. */
+  type?: 'button' | 'submit' | 'reset' | undefined;
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLButtonElement> | undefined;
+}
+//#endregion
+//#region src/icon-button/IconButton.web.d.ts
+export declare function IconButton({ icon, label, variant, size, disabled, loading, onPress, type, className, style, testID, ref }: IconButtonWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/input/Input.types.d.ts
+/** Contrato de `Input` con el conjunto de iconos de la librería. */
+type InputProps = InputProps$1<IconName>;
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface InputWebProps extends InputProps {
+  /** `id` del `<input>`. Dentro de un `FormField` no hace falta: lo pone él. */
+  id?: string | undefined;
+  /** Nombre con el que viaja en un `<form>`. */
+  name?: string | undefined;
+  /** Pista de autocompletado del navegador (`email`, `current-password`, `one-time-code`…). */
+  autoComplete?: string | undefined;
+  /** Se aplican a la caja del campo, no al `<input>`. */
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLInputElement> | undefined;
+}
+//#endregion
+//#region src/input/Input.web.d.ts
+export declare function Input({ value, defaultValue, onChangeText, placeholder, type, size, disabled, readOnly, invalid, required, iconStart, iconEnd, maxLength, onFocus, onBlur, onSubmit, accessibilityLabel, id, name, autoComplete, className, style, testID, ref }: InputWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/link/Link.types.d.ts
+/** Extensión solo web del contrato (ADR-009): atributos del `<a>` y escape hatches. */
+interface LinkWebProps extends LinkProps$1 {
+  /** Dónde se abre. Con `_blank` se añade `rel="noopener noreferrer"` si no se indica otro. */
+  target?: '_self' | '_blank' | '_parent' | '_top' | undefined;
+  rel?: string | undefined;
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLAnchorElement> | undefined;
+}
+//#endregion
+//#region src/link/Link.web.d.ts
+export declare function Link({ href, variant, color, underline, onPress, accessibilityLabel, target, rel, className, style, testID, ref, children }: LinkWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/modal/Modal.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+interface ModalWebProps extends ModalProps$1 {
+  /** Se aplican al `<dialog>`. */
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLDialogElement> | undefined;
+}
+//#endregion
+//#region src/modal/Modal.web.d.ts
+/** Un diálogo centrado (ADR-040). */
+export declare function Modal(props: ModalWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/select/Select.types.d.ts
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface SelectWebProps extends SelectProps$1 {
+  /** `id` del `<select>`. Dentro de un `FormField` no hace falta: lo pone él. */
+  id?: string | undefined;
+  /** Nombre con el que viaja en un `<form>`. */
+  name?: string | undefined;
+  /** Se aplican a la caja del campo, no al `<select>`. */
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLSelectElement> | undefined;
+}
+//#endregion
+//#region src/select/Select.web.d.ts
+/**
+ * Un `<select>` real (ADR-038): el teclado, los lectores de pantalla y el selector del
+ * sistema en móvil son los del navegador.
+ */
+export declare function Select({ options, value, defaultValue, onValueChange, placeholder, size, disabled, invalid, required, accessibilityLabel, id, name, className, style, testID, ref }: SelectWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/sheet/Sheet.types.d.ts
+/** `Sheet` tiene las mismas props que `Modal` (ADR-040). */
+type SheetWebProps = ModalWebProps;
+//#endregion
+//#region src/sheet/Sheet.web.d.ts
+/** Un diálogo anclado al borde inferior (ADR-040). Comparte todo con `Modal` salvo dónde se coloca. */
+export declare function Sheet(props: SheetWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/skeleton/Skeleton.types.d.ts
+/** Extensión solo web del contrato (ADR-009). */
+interface SkeletonWebProps extends SkeletonProps$1 {
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+}
+//#endregion
+//#region src/skeleton/Skeleton.web.d.ts
+/** Decorativo: los lectores de pantalla lo ignoran. */
+export declare function Skeleton({ shape, width, height, variant, lines, className, style, testID }: SkeletonWebProps): import("react").JSX.Element;
+//#endregion
 //#region src/spinner/Spinner.types.d.ts
 interface SpinnerWebProps extends SpinnerProps$1 {
   className?: string | undefined;
@@ -63,9 +225,10 @@ interface SpinnerWebProps extends SpinnerProps$1 {
 //#endregion
 //#region src/spinner/Spinner.web.d.ts
 /**
- * Indicador de carga indeterminada. Versión mínima (ROADMAP Fase 3): el icono
- * `loader-circle` girando. Con `label` es una barra de progreso indeterminada
- * para los lectores de pantalla; sin él, es decorativo.
+ * Indicador de carga indeterminada: el icono `loader-circle` girando. Con `label` es
+ * una barra de progreso indeterminada para los lectores de pantalla; sin él, es
+ * decorativo. Con movimiento reducido gira más despacio, pero no se detiene: parado
+ * no diría que algo está en curso.
  */
 export declare function Spinner({ size, color, label, className, testID }: SpinnerWebProps): import("react").JSX.Element;
 //#endregion
@@ -75,6 +238,37 @@ interface StackWebProps extends StackProps$1, Pick<BoxWebProps, 'as' | 'classNam
 //#region src/stack/Stack.web.d.ts
 export declare function Stack({ direction, gap, align, justify, wrap, className, style, ...boxProps }: StackWebProps): import("react").JSX.Element;
 //#endregion
+//#region src/switch/Switch.types.d.ts
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface SwitchWebProps extends SwitchProps$1 {
+  id?: string | undefined;
+  /** Nombre con el que viaja en un `<form>`. */
+  name?: string | undefined;
+  /** Valor que viaja en el `<form>` cuando está activado (por defecto `on`). */
+  value?: string | undefined;
+  /** Se aplican a la etiqueta que envuelve el interruptor y su texto. */
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLInputElement> | undefined;
+}
+//#endregion
+//#region src/switch/Switch.web.d.ts
+export declare function Switch({ checked, defaultChecked, onCheckedChange, disabled, accessibilityLabel, id, name, value, className, style, testID, ref, children }: SwitchWebProps): import("react").JSX.Element;
+//#endregion
+//#region src/tabs/Tabs.types.d.ts
+/** Una pestaña, con el conjunto de iconos de la librería. */
+type TabItem = TabItem$1<IconName>;
+/** Contrato de `Tabs` con el conjunto de iconos de la librería. */
+type TabsProps = TabsProps$1<IconName>;
+/** Extensión solo web del contrato (ADR-009). */
+interface TabsWebProps extends TabsProps {
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+}
+//#endregion
+//#region src/tabs/Tabs.web.d.ts
+export declare function Tabs({ items, value, defaultValue, onValueChange, accessibilityLabel, className, style, testID }: TabsWebProps): import("react").JSX.Element;
+//#endregion
 //#region src/text/Text.types.d.ts
 type TextElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span' | 'div' | 'label' | 'code';
 interface TextWebProps extends TextProps$1 {
@@ -87,11 +281,27 @@ interface TextWebProps extends TextProps$1 {
 //#region src/text/Text.web.d.ts
 export declare function Text({ variant, color, align, truncate, as, className, style, testID, children }: TextWebProps): import("react").JSX.Element;
 //#endregion
+//#region src/text-area/TextArea.types.d.ts
+/** Extensión solo web del contrato (ADR-009): atributos de formulario y escape hatches. */
+interface TextAreaWebProps extends TextAreaProps$1 {
+  /** `id` del `<textarea>`. Dentro de un `FormField` no hace falta: lo pone él. */
+  id?: string | undefined;
+  /** Nombre con el que viaja en un `<form>`. */
+  name?: string | undefined;
+  className?: string | undefined;
+  style?: CSSProperties | undefined;
+  ref?: Ref<HTMLTextAreaElement> | undefined;
+}
+//#endregion
+//#region src/text-area/TextArea.web.d.ts
+export declare function TextArea({ value, defaultValue, onChangeText, placeholder, rows, disabled, readOnly, invalid, required, maxLength, onFocus, onBlur, accessibilityLabel, id, name, className, style, testID, ref }: TextAreaWebProps): import("react").JSX.Element;
+//#endregion
 //#region src/ui-provider/UIProvider.web.d.ts
 /**
  * Activa tema y marca para todo lo que envuelve (ADR-010). Pone `data-theme` y
- * `data-brand` en un contenedor sin caja propia; `tokens.css` hace el resto.
+ * `data-brand` en un contenedor sin caja propia; `tokens.css` hace el resto. También
+ * guarda la cola de toasts y los pinta (ADR-039).
  */
 export declare function UIProvider({ theme, brand, children }: UIProviderProps$1): import("react").JSX.Element;
 //#endregion
-export { type BadgeProps, type BadgeWebProps, type BoxElement, type BoxProps, type BoxWebProps, type ButtonProps, type ButtonWebProps, type ColorScheme, type IconName, type IconProps, type IconWebProps, type SpinnerProps, type SpinnerWebProps, type StackProps, type StackWebProps, type TextElement, type TextProps, type TextWebProps, type ThemeMode, type UIProviderProps, useBrand, useColorScheme, useTheme };
+export { type AlertProps, type AlertWebProps, type BadgeProps, type BadgeWebProps, type BoxElement, type BoxProps, type BoxWebProps, type ButtonProps, type ButtonWebProps, type CardProps, type CardWebProps, type CheckboxProps, type CheckboxWebProps, type ColorScheme, type DividerProps, type DividerWebProps, type FormFieldProps, type FormFieldWebProps, type IconButtonProps, type IconButtonWebProps, type IconName, type IconProps, type IconWebProps, type InputProps, type InputWebProps, type LinkPressEvent, type LinkProps, type LinkWebProps, type ModalProps, type ModalWebProps, type SelectOption, type SelectProps, type SelectWebProps, type SheetProps, type SheetWebProps, type SkeletonProps, type SkeletonWebProps, type SpinnerProps, type SpinnerWebProps, type StackProps, type StackWebProps, type SwitchProps, type SwitchWebProps, type TabItem, type TabsProps, type TabsWebProps, type TextAreaProps, type TextAreaWebProps, type TextElement, type TextProps, type TextWebProps, type ThemeMode, type ToastAction, type ToastApi, type ToastOptions, type UIProviderProps, useBrand, useColorScheme, useTheme, useToast };