cuenti-dna 0.1.0-beta.1

package/dist/index.d.cts

@@ -0,0 +1,491 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import { ChangeEventHandler, FocusEventHandler } from 'react';
+import { ClassValue } from 'clsx';
+
+/**
+ * Propiedades publicas del componente `Button`.
+ */
+type ButtonProps = {
+    /**
+     * Variante visual del boton.
+     * @default 'primary'
+     * @variation 'primary' | 'alt' | 'secondary' | 'ghost' | 'primary-ghost' | 'link' | 'destructive' | 'success' | 'accent' | 'outline' | 'secondary-outline'
+     * @see {@link ButtonVariants}
+     */
+    variant?: ButtonVariants;
+    /**
+     * Tamano del boton.
+     * @default 'md'
+     * @variation 'sm' | 'md' | 'lg' | 'icon' | 'icon-sm' | 'icon-lg'
+     * @see {@link ButtonSizes}
+     */
+    size?: ButtonSizes;
+} & React.ButtonHTMLAttributes<HTMLButtonElement>;
+/** Variantes visuales disponibles para el boton. */
+type ButtonVariants = 'primary' | 'alt' | 'secondary' | 'ghost' | 'link' | 'destructive' | 'success' | 'accent' | 'outline' | 'primary-ghost' | 'secondary-outline';
+/** Tamanos disponibles para el boton. */
+type ButtonSizes = 'sm' | 'md' | 'lg' | 'icon' | 'icon-sm' | 'icon-lg';
+
+/**
+ * Componente Button.
+ *
+ * Renderiza un boton reutilizable con variantes y tamanos predefinidos.
+ * El tipo por defecto es `button` para evitar submits accidentales en formularios.
+ *
+ * @see {@link ButtonProps}
+ */
+declare function Button({ variant, size, className, children, type, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Propiedades publicas del componente `Checkbox`.
+ */
+type CheckboxProps = {
+    /**
+     * Variante visual del checkbox.
+     * @default 'default'
+     * @variation 'default' | 'success'
+     */
+    variant?: CheckboxVariants;
+    /**
+     * Estilo de esquinas para el control.
+     * @default 'square'
+     * @variation 'square' | 'rounded'
+     */
+    size?: CheckboxSizes;
+    /**
+     * Muestra el estado indeterminado.
+     * Es un tercer estado visual y debe controlarse desde el componente padre.
+     * @default false
+     */
+    indeterminate?: boolean;
+    /**
+     * Clases opcionales para personalizar elementos internos.
+     */
+    classNames?: {
+        /**
+         * Clase para el contenedor raiz.
+         */
+        root?: string;
+        /**
+         * Clase para el input nativo.
+         */
+        input?: string;
+        /**
+         * Clase para el contenido de la etiqueta.
+         */
+        label?: string;
+    };
+} & Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'>;
+/** Variantes visuales disponibles para el checkbox. */
+type CheckboxVariants = 'default' | 'success';
+/** Estilos de esquina disponibles para el checkbox. */
+type CheckboxSizes = 'square' | 'rounded';
+
+/**
+ * Componente Checkbox.
+ *
+ * Renderiza un control de seleccion con soporte para estados
+ * marcado, desmarcado e indeterminado.
+ * Incluye protecciones de interaccion para readOnly y disabled, ademas de variantes y tamanos visuales.
+ *
+ * @see {@link CheckboxProps}
+ */
+declare function Checkbox({ variant, size, indeterminate, children, className, classNames, readOnly, onClick, onChange, disabled, ...props }: CheckboxProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Propiedades publicas del componente `Input`.
+ */
+type InputProps = {
+    /**
+     * Tipo de campo a renderizar.
+     */
+    type?: InputTypes;
+    /**
+     * Variante visual del campo.
+     */
+    variant?: InputVariants;
+    /**
+     * Tamano visual del campo.
+     */
+    size?: InputSizes;
+    /**
+     * Prefijo de moneda cuando el tipo es `money`.
+     */
+    moneySymbol?: string;
+    /**
+     * Clases opcionales para contenedor e input interno.
+     */
+    classNames?: {
+        /**
+         * Clase para el contenedor raiz.
+         */
+        root?: string;
+        /**
+         * Clase para el elemento input.
+         */
+        input?: string;
+    };
+    /**
+     * Elimina validaciones y formatos especiales, renderizando un input basico, sin los comportamientos por defecto de cada tipo especializado.
+     *
+     * Útil para los tipos 'number' y 'money' cuando se desea un campo con formato libre, sin restricciones de caracteres ni formato visual, pero manteniendo la consistencia visual con los campos especializados.
+     */
+    reset?: boolean;
+} & Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size'>;
+/** Tipos de input soportados por el componente base. */
+type InputTypes = 'text' | 'password' | 'email' | 'number' | 'money';
+/** Variantes visuales disponibles para Input. */
+type InputVariants = 'default' | 'error' | 'success';
+/** Tamanos visuales disponibles para Input. */
+type InputSizes = 'sm' | 'md' | 'lg';
+/** Lista utilitaria de tipos permitidos para controles de UI y validacion. */
+declare const inputTypes: InputTypes[];
+
+/**
+ * Componente Input.
+ *
+ * Punto de entrada para todos los campos de texto del sistema.
+ * Segun el `type`, delega en implementaciones especializadas para password,
+ * number y money, o renderiza un input nativo para tipos simples.
+ *
+ * @see {@link InputProps}
+ */
+declare function Input({ variant, size, classNames, moneySymbol, type, ...props }: InputProps): react_jsx_runtime.JSX.Element | undefined;
+
+/**
+ * Propiedades comunes para inputs especializados que no necesitan redefinir
+ * el tipo visual ni simbolo monetario.
+ */
+type SpecializedInputProps = Omit<InputProps, 'type' | 'variant' | 'moneySymbol'>;
+/**
+ * Propiedades para el input monetario especializado.
+ * Conserva `moneySymbol` para definir prefijo de visualizacion.
+ */
+type SpecializedMoneyInputProps = Omit<InputProps, 'type' | 'variant'>;
+
+/**
+ * Propiedades internas para `MoneyInput`.
+ */
+type MoneyInputProps = SpecializedMoneyInputProps & {
+    reset?: boolean;
+};
+/**
+ * Campo especializado para montos monetarios.
+ *
+ * Mantiene un valor editable mientras el input esta en foco y un valor
+ * formateado al perder foco, emitiendo siempre el valor crudo al exterior.
+ * En formularios, envia el valor crudo (sin simbolos ni separadores visuales).
+ */
+declare function MoneyInput({ size: _size, classNames, moneySymbol, reset, ...props }: MoneyInputProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Propiedades internas para `NumberInput`.
+ */
+type NumberInputProps = SpecializedInputProps & {
+    reset?: boolean;
+};
+/**
+ * Campo especializado para valores numericos.
+ *
+ * Filtra teclas y pegado para garantizar que el valor ingresado
+ * respete el patron definido para numeros del sistema.
+ * En formularios, envia el valor crudo (sin formato visual) mediante un campo oculto.
+ */
+declare function NumberInput({ size: _size, classNames, reset, ...props }: NumberInputProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Propiedades internas para `PasswordInput`.
+ */
+type PasswordInputProps = SpecializedInputProps;
+/**
+ * Campo especializado para contrasenas.
+ *
+ * Permite alternar visibilidad entre texto plano y password,
+ * manteniendo nombre accesible para el boton de alternancia.
+ */
+declare function PasswordInput({ size, classNames, ...props }: PasswordInputProps): react_jsx_runtime.JSX.Element;
+
+/** Variantes visuales disponibles para los radios. */
+type RadioVariants = 'default' | 'success';
+/** Clases opcionales para personalizar subpartes del item de radio. */
+type RadioGroupItemClassNames = {
+    /** Clase para el contenedor raiz del item. */
+    root?: string;
+    /** Clase para el input nativo. */
+    input?: string;
+    /** Clase para el indicador de estado seleccionado. */
+    indicator?: string;
+    /** Clase para la etiqueta de texto. */
+    label?: string;
+};
+/**
+ * Propiedades publicas del contenedor `RadioGroup`.
+ */
+type RadioGroupProps = {
+    /** Valor seleccionado en modo controlado. */
+    value?: string;
+    /** Valor inicial en modo no controlado. */
+    defaultValue?: string;
+    /** Se ejecuta cuando cambia el valor seleccionado. */
+    onValueChange?: (value: string) => void;
+    /** Nombre compartido para todos los radios del grupo. */
+    name?: string;
+    /**
+     * Variante visual aplicada por defecto a los items del grupo.
+     * @default 'default'
+     * @variation 'default' | 'success'
+     */
+    variant?: RadioVariants;
+    /** Deshabilita todos los items del grupo. */
+    disabled?: boolean;
+    /** Evita cambios manteniendo foco y semantica accesible. */
+    readOnly?: boolean;
+} & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>;
+/**
+ * Propiedades publicas de cada item de radio dentro del grupo.
+ */
+type RadioGroupItemProps = {
+    /** Valor emitido cuando este item queda seleccionado. */
+    value: string;
+    /** Variante visual opcional para sobrescribir la del grupo. */
+    variant?: RadioVariants;
+    /** Clases opcionales para personalizar subpartes del item. */
+    classNames?: RadioGroupItemClassNames;
+    /** Contenido opcional de etiqueta renderizado junto al control. */
+    children?: React.ReactNode;
+} & Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'size' | 'value' | 'name' | 'checked' | 'defaultChecked'>;
+/** Contrato interno de contexto compartido entre RadioGroup y RadioItem. */
+type RadioGroupContextValue = {
+    name: string;
+    value?: string;
+    variant: RadioVariants;
+    disabled: boolean;
+    readOnly: boolean;
+    onValueChange: (value: string) => void;
+};
+
+/**
+ * Componente RadioGroup.
+ *
+ * Contenedor de radios con contexto interno compartido.
+ * Permite uso controlado y no controlado del valor seleccionado.
+ *
+ * @see {@link RadioGroupProps}
+ */
+declare function RadioGroup({ value, defaultValue, onValueChange, name, variant, disabled, readOnly, className, children, ...props }: RadioGroupProps): react_jsx_runtime.JSX.Element;
+/**
+ * Componente RadioItem.
+ *
+ * Item de radio integrado con etiqueta interna, preparado para trabajar con RadioGroup.
+ *
+ * @see {@link RadioGroupItemProps}
+ */
+declare function RadioItem({ variant, children, className, classNames, readOnly, onClick, onChange, disabled, value, id: propId, ...props }: RadioGroupItemProps): react_jsx_runtime.JSX.Element;
+
+/** Variantes visuales disponibles para el switch. */
+type SwitchVariants = 'default' | 'alt';
+/**
+ * Clases opcionales para personalizar cada parte visual del switch.
+ */
+type SwitchClassNames = {
+    /**
+     * Clase para la etiqueta raiz que envuelve todo el switch.
+     */
+    root?: string;
+    /**
+     * Clase para el contenedor de la pista.
+     */
+    input?: string;
+    /**
+     * Clase para el indicador deslizante.
+     */
+    indicator?: string;
+};
+type SwitchProps = {
+    /**
+     * Variante visual del switch.
+     * @default 'default'
+     * @variation 'default' | 'alt'
+     */
+    variant?: SwitchVariants;
+    /**
+     * Clases opcionales para personalizar cada parte visual.
+     */
+    classNames?: SwitchClassNames;
+} & Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type'>;
+
+/**
+ * Componente Switch.
+ *
+ * Renderiza un interruptor accesible basado en un input de tipo checkbox.
+ * Soporta variantes visuales, estado deshabilitado y personalizacion por classNames.
+ *
+ * @see {@link SwitchProps}
+ */
+declare function Switch({ variant, classNames, id: propsId, children, className, ...props }: SwitchProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Propiedades del contenedor principal `Card`.
+ */
+type CardProps = {
+    /**
+     * Etiqueta HTML a utilizar para el contenedor.
+     */
+    as?: 'div' | 'article' | 'section';
+    /**
+     * Habilita estilos de interaccion para estados de sobrevuelo y foco.
+     */
+    interactive?: boolean;
+    /**
+     * Clases adicionales para personalizacion visual.
+     */
+    className?: string;
+} & React$1.ComponentPropsWithoutRef<'div'>;
+/** Propiedades del encabezado de `Card`. */
+type CardHeaderProps = React$1.ComponentPropsWithoutRef<'header'>;
+/** Propiedades del titulo de `Card`. */
+type CardTitleProps = React$1.ComponentPropsWithoutRef<'h3'>;
+/** Propiedades de la descripcion de `Card`. */
+type CardDescriptionProps = React$1.ComponentPropsWithoutRef<'p'>;
+/** Propiedades de la region de acciones de `Card`. */
+type CardActionProps = React$1.ComponentPropsWithoutRef<'div'>;
+/** Propiedades de la region de contenido principal de `Card`. */
+type CardContentProps = React$1.ComponentPropsWithoutRef<'section'>;
+/** Propiedades del pie de `Card`. */
+type CardFooterProps = React$1.ComponentPropsWithoutRef<'footer'>;
+
+/**
+ * Componente contenedor principal para superficies Card.
+ *
+ * Permite cambiar la etiqueta semantica mediante `as` y habilitar
+ * un estado visual interactivo.
+ */
+declare function Card({ as, className, interactive, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+/**
+ * Cabecera composable de Card.
+ */
+declare function CardHeader({ className, ...props }: CardHeaderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Titulo principal de Card.
+ */
+declare function CardTitle({ className, ...props }: CardTitleProps): react_jsx_runtime.JSX.Element;
+/**
+ * Texto descriptivo secundario de Card.
+ */
+declare function CardDescription({ className, ...props }: CardDescriptionProps): react_jsx_runtime.JSX.Element;
+/**
+ * Region auxiliar para acciones de Card (ej. botones en cabecera).
+ */
+declare function CardAction({ className, ...props }: CardActionProps): react_jsx_runtime.JSX.Element;
+/**
+ * Region de contenido principal de Card.
+ */
+declare function CardContent({ className, ...props }: CardContentProps): react_jsx_runtime.JSX.Element;
+/**
+ * Pie de Card para acciones o informacion complementaria.
+ */
+declare function CardFooter({ className, ...props }: CardFooterProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Tipo de valor compatible con controles HTML para normalizacion numerica.
+ */
+type NormalizableValue = string | number | readonly string[] | undefined;
+/**
+ * Parametros requeridos por `useFormattedNumericInput`.
+ *
+ * Define funciones de conversion entre los tres estados de valor:
+ * - Crudo: usado para formularios/eventos.
+ * - Editable: usado durante foco.
+ * - Presentacion: usado fuera de foco.
+ */
+type UseFormattedNumericInputParams = {
+    value: NormalizableValue;
+    defaultValue: NormalizableValue;
+    onChange?: ChangeEventHandler<HTMLInputElement>;
+    onBlur?: FocusEventHandler<HTMLInputElement>;
+    onFocus?: FocusEventHandler<HTMLInputElement>;
+    normalizeRawValue: (value: NormalizableValue) => string;
+    rawToEditableValue: (rawValue: string) => string;
+    rawToDisplayValue: (rawValue: string) => string;
+    editableToRawValue: (editableValue: string) => string;
+    sanitizeEditableValue?: (editableValue: string) => string;
+};
+/**
+ * Contrato de retorno de `useFormattedNumericInput`.
+ */
+type UseFormattedNumericInputReturn = {
+    rawValue: string;
+    displayValue: string;
+    isFocused: boolean;
+    handleFocus: FocusEventHandler<HTMLInputElement>;
+    handleChange: ChangeEventHandler<HTMLInputElement>;
+    handleBlur: FocusEventHandler<HTMLInputElement>;
+};
+
+/**
+ * Hook compartido para inputs numericos con valor crudo y valor de presentacion.
+ *
+ * Mantiene:
+ * - Valor crudo: usado para formularios y eventos.
+ * - Valor visible: usado para mostrar formato amigable al usuario.
+ */
+declare function useFormattedNumericInput({ value, defaultValue, onChange, onBlur, onFocus, normalizeRawValue, rawToEditableValue, rawToDisplayValue, editableToRawValue, sanitizeEditableValue }: UseFormattedNumericInputParams): UseFormattedNumericInputReturn;
+
+type UseRadioProps = Pick<RadioGroupItemProps, 'variant' | 'readOnly' | 'disabled' | 'value' | 'onClick' | 'onChange' | 'id'>;
+/**
+ * Resuelve estado y manejadores de un `RadioItem` conectado al contexto.
+ *
+ * Fusiona configuracion local con la heredada desde `RadioGroup` y entrega
+ * un contrato listo para renderizar el input nativo sin duplicar logica.
+ */
+declare function useRadio({ variant, readOnly, disabled, value, onClick, onChange, id }: UseRadioProps): {
+    id: string;
+    name: string;
+    resolvedVariant: RadioVariants;
+    isReadOnly: boolean;
+    isDisabled: boolean;
+    isChecked: boolean;
+    handleClick: React$1.MouseEventHandler<HTMLInputElement>;
+    handleChange: React$1.ChangeEventHandler<HTMLInputElement, Element>;
+};
+
+type UseRadioGroupParams = Pick<RadioGroupProps, 'value' | 'defaultValue' | 'onValueChange' | 'name' | 'variant' | 'disabled' | 'readOnly'>;
+type UseRadioGroupReturn = {
+    contextValue: RadioGroupContextValue;
+};
+/**
+ * Encapsula la logica de estado y eventos de `RadioGroup`.
+ *
+ * Resuelve:
+ * - Modo controlado (`value`) y no controlado (`defaultValue`).
+ * - Nombre final del grupo para atributos `name`.
+ * - Bloqueo de cambios cuando el grupo esta en `disabled` o `readOnly`.
+ * - Objeto de contexto memoizado para evitar renders innecesarios.
+ */
+declare function useRadioGroup({ value, defaultValue, onValueChange, name, variant, disabled, readOnly }: UseRadioGroupParams): UseRadioGroupReturn;
+
+/**
+ * Icono de check para estados seleccionados o exitosos.
+ */
+declare function Check({ className, ...props }: React.SVGProps<SVGSVGElement>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Icono de menos para estados indeterminados o acciones de resta.
+ */
+declare function Minus({ ...props }: React.SVGProps<SVGSVGElement>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Icono de cierre con forma de X.
+ */
+declare function CloseX({ className, ...props }: React.SVGProps<SVGSVGElement>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Combina clases condicionales y resuelve conflictos de Tailwind.
+ *
+ * Usa `clsx` para componer entradas heterogeneas y `tailwind-merge`
+ * para priorizar la ultima clase utilitaria en conflicto.
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+export { Button, type ButtonProps, type ButtonSizes, type ButtonVariants, Card, CardAction, type CardActionProps, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, type CardProps, CardTitle, type CardTitleProps, Check, Checkbox, type CheckboxProps, type CheckboxSizes, type CheckboxVariants, CloseX, Input, type InputProps, type InputSizes, type InputTypes, type InputVariants, Minus, MoneyInput, type NormalizableValue, NumberInput, PasswordInput, RadioItem as Radio, RadioGroup, type RadioGroupContextValue, type RadioGroupItemClassNames, type RadioGroupItemProps, type RadioGroupProps, RadioItem, type RadioVariants, Switch, type SwitchClassNames, type SwitchProps, type SwitchVariants, type UseFormattedNumericInputParams, type UseFormattedNumericInputReturn, cn, inputTypes, useFormattedNumericInput, useRadio, useRadioGroup };