@apia/validations 2.0.11 → 3.0.2

package/dist/form/FormContext.d.ts

@@ -1,27 +0,0 @@
-import React__default from 'react';
-import { TValidationResult } from '../types.js';
-
-interface IFormContext<ValueType extends Record<string, unknown> = Record<string, unknown>, SubmitValueType extends Record<keyof ValueType, unknown> = ValueType> {
-    avoidFieldsTouch?: boolean;
-    name: string;
-    validate: () => Promise<TValidationResult<ValueType, SubmitValueType>>;
-}
-declare const FormContext: React__default.Context<IFormContext<Record<string, unknown>, Record<string, unknown>>>;
-/**
- * Provee acceso de forma sencilla al contexto de
- * validación, que básicamente posee el nombre del
- * form en caso de que se quiera usar para acceder
- * a través de Redux a la información del mismo y un
- * método validate, que dispara la validación del
- * form.
- *
- * En la práctica, el método validate es casi
- * innecesario, ya que la validación se puede disparar
- * con cualquier botón que no tenga seteado el
- * atributo type="button" (esto es así ya que en el
- * DOM se renderiza un elemento de tipo form).
- */
-declare function useFormContext(): IFormContext<Record<string, unknown>, Record<string, unknown>>;
-
-export { FormContext, type IFormContext, useFormContext };
-//# sourceMappingURL=FormContext.d.ts.map

package/dist/form/FormContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FormContext.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/hooks/useField.d.ts

@@ -1,76 +0,0 @@
-import React__default from 'react';
-import { TValidationField } from '../types.js';
-
-type TUseField<ValueType = unknown, SubmitValueType = ValueType> = Omit<TValidationField<ValueType, SubmitValueType>, 'error' | 'value' | 'isTouched'> & {
-    /**
-     * Con esta propiedad es posible evitar que el campo
-     * se registre cuando ya fue registrado previamente en
-     * el store. De esta forma, se evitaría escribir sobre
-     * un valor que ya estaba seteado anteriormente.
-     */
-    avoidRegisterIfExists?: boolean;
-    /**
-     * Si se está fuera de contexto de validación, se puede pasar un formName
-     * para evitar que el hook lo intente tomar de contexto.
-     */
-    formName?: string;
-    initialValue?: ValueType;
-    removeOnUnmount?: boolean;
-};
-/**
- * Este hook permite registrar un field para ser validado,
- * o simplemente para recolectar su valor, e incluso aplicar
- * una función de transformación de dicho valor antes de
- * hacer submit.
- *
- * @returns
- * *error:* Es null mientras que no haya errores de
- * validación, y un string en caso de que si lo haya.
- *
- * *value:* Es el valor actual del campo.
- *
- * *name:* Debería utilizarse para dar * valor al atributo
- * name o id del contenedor que debe recibir el foco en caso
- * de que la validación fallara. (Esto es, cuando se deba
- * realizar foco porque la validación falló, la librería
- * intentará encontrar un campo con el selector
- * [name=${name}, #${name}] dentro del formulario).
- *
- * *onChange:* Se utiliza para setear el valor del campo,
- * puede utilizarse directamente como callback para la
- * propiedad onChange que aceptan la mayoría de los campos,
- * ya que intentará setear el valor con ev.target.value
- * y si esa propiedad no está definida, lo hará directamente
- * con ev.
- *
- * @example
- *  // Si se desea un ejemplo más complejo, vea el componente
- *  // Invitations.tsx que se encuentra dentro del directorio
- *  // de la librería.
- *
- *  const inputProps = useField<string>({
-      name: 'name',
-      validationRules: {
-        required: true,
-        minLength: 5,
-        maxLength: 10
-      },
-      initialValue: metadata.value,
- *  });
-
-    return <Box>
-      <Input {...inputProps} />
-      <ValidationError name="name" />
-    </Box>
- */
-declare function useField<ValueType = unknown, SubmitValueType = ValueType>(fieldDefinition: TUseField<ValueType, SubmitValueType>): {
-    error: string | null | undefined;
-    isTouched: boolean;
-    name: string;
-    onChange: (ev: React__default.ChangeEvent | ValueType) => void;
-    updateValidations: ({ validationFunction, validationRules, }: Pick<TValidationField, 'validationRules' | 'validationFunction'>) => void;
-    value: ValueType;
-};
-
-export { type TUseField, useField };
-//# sourceMappingURL=useField.d.ts.map

package/dist/hooks/useField.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useField.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/hooks/useFieldStatesClassNames.d.ts

@@ -1,4 +0,0 @@
-declare function useFieldStatesClassNames<T = unknown>(name: string, formName?: string): string;
-
-export { useFieldStatesClassNames };
-//# sourceMappingURL=useFieldStatesClassNames.d.ts.map

package/dist/hooks/useFieldStatesClassNames.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useFieldStatesClassNames.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/hooks/useFieldValue.d.ts

@@ -1,8 +0,0 @@
-interface IUseFieldValue {
-    formName?: string;
-    name: string;
-}
-declare function useFieldValue<T = unknown>({ formName, name }: IUseFieldValue): T;
-
-export { useFieldValue };
-//# sourceMappingURL=useFieldValue.d.ts.map

package/dist/hooks/useFieldValue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useFieldValue.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/hooks/useValidationClass.d.ts

@@ -1,49 +0,0 @@
-import { TDefaultFieldType } from '../components/types.js';
-import { TValidationFunction } from '../types.js';
-
-declare function useValidationClass<T>({ customValidation, formName, name, validationClass, validationFunction, validationRules, }: Pick<TDefaultFieldType<T>, 'validationClass' | 'validationFunction' | 'validationRules' | 'name'> & {
-    customValidation?: TValidationFunction<T>;
-    formName?: string;
-}): {
-    actualValidationFunction: TValidationFunction<T>;
-    actualValidationRules: {
-        number?: boolean | undefined;
-        required?: boolean | undefined;
-        alpha?: boolean | undefined;
-        alphanum?: boolean | undefined;
-        nodigit?: boolean | undefined;
-        digit?: boolean | undefined;
-        email?: boolean | undefined;
-        image?: boolean | undefined;
-        phone?: boolean | undefined;
-        url?: boolean | undefined;
-        lengthmax?: boolean | undefined;
-        lengthmin?: boolean | undefined;
-        checkbox?: boolean | undefined;
-        radios?: boolean | undefined;
-        select?: boolean | undefined;
-        select_multiple?: boolean | undefined;
-        errorsTitle?: boolean | undefined;
-        digitmin?: number | undefined;
-        digitltd?: [number, number] | undefined;
-        confirm?: string | undefined;
-        differs?: string | undefined;
-        length_str?: [number, number] | undefined;
-        length_fix?: number | undefined;
-        words_min?: number | undefined;
-        words_max?: number | undefined;
-        words_range?: [number, number] | undefined;
-        checkboxes_group?: number | undefined;
-        patternMessage?: string | undefined;
-        pattern?: string | RegExp | undefined;
-        digitmax?: number | undefined;
-        validName?: string | undefined;
-        maxLength?: number | undefined;
-        minLength?: number | undefined;
-        min?: number | undefined;
-        max?: number | undefined;
-    };
-};
-
-export { useValidationClass };
-//# sourceMappingURL=useValidationClass.d.ts.map

package/dist/hooks/useValidationClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useValidationClass.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/lang/es.d.ts

@@ -1,32 +0,0 @@
-declare const formcheckLanguage: {
-    required: string;
-    alpha: string;
-    alphanum: string;
-    nodigit: string;
-    digit: string;
-    digitmin: string;
-    digitltd: string;
-    number: string;
-    email: string;
-    image: string;
-    phone: string;
-    url: string;
-    confirm: string;
-    differs: string;
-    length_str: string;
-    length_fix: string;
-    lengthmax: string;
-    lengthmin: string;
-    words_min: string;
-    words_max: string;
-    words_range: string;
-    checkbox: string;
-    checkboxes_group: string;
-    radios: string;
-    select: string;
-    select_multiple: string;
-    errorsTitle: string;
-};
-
-export { formcheckLanguage as default };
-//# sourceMappingURL=es.d.ts.map

package/dist/lang/es.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"es.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -1,152 +0,0 @@
-import { TModify } from '@apia/util';
-import formcheckLanguage from './lang/es.js';
-
-type TValidate = Partial<TModify<Record<keyof typeof formcheckLanguage, boolean>, {
-    digitmin: number;
-    digitltd: [number, number];
-    confirm: string;
-    differs: string;
-    length_str: [number, number];
-    length_fix: number;
-    words_min: number;
-    words_max: number;
-    words_range: [number, number];
-    checkboxes_group: number;
-}> & {
-    patternMessage: string;
-    pattern: RegExp | string;
-    digitmax: number;
-    validName?: string;
-    maxLength: number;
-    minLength: number;
-    min: number;
-    max: number;
-}>;
-interface IFieldDefinition<ValueType = string> {
-    toolTip: string;
-    label: string;
-    name: string;
-    validate?: TValidate;
-    value: ValueType;
-    options?: {
-        label: string;
-        value: number | number;
-        selected?: boolean;
-    }[];
-}
-type TPromiseOrNot<Type> = Promise<Type> | Type;
-type TSuccessfulValidation<ValueType extends Record<string, unknown>, SubmitValueType extends Record<keyof ValueType, unknown> = ValueType> = {
-    values: ValueType;
-    submitValues: SubmitValueType;
-};
-type TWrongValidation = {
-    errors: Record<string, string>;
-};
-/**
- * Esta interfaz representa el resultado de la validación
- * de un formulario.
- */
-type TValidationResult<ValueType extends Record<string, unknown>, SubmitValueType extends Record<keyof ValueType, unknown> = ValueType> = TSuccessfulValidation<ValueType, SubmitValueType> | TWrongValidation;
-type TFieldValidationResult = true | string;
-type TValidationFunction<ValueType> = (value: ValueType, formName: string) => TPromiseOrNot<TFieldValidationResult>;
-type TValidationSubmitValueParser<ValueType = unknown, SubmitValueType = ValueType> = (value: ValueType) => SubmitValueType;
-type TValidationValueParser<ValueType = unknown, ValidationValueType = unknown> = (value: ValueType) => ValidationValueType;
-type TValidationRules = IFieldDefinition['validate'];
-type TFocusRetriever = () => Promise<boolean> | void;
-/**
- * Esta interfaz representa el estado de un campo dentro
- * del hook de validación.
- *
- * Las funcionalidades contempladas hasta el momento son:
- *
- * - Contener los valores del formulario.
- * - Foco: Se hará querySelector sobre el form que lo contiene
- * con el nombre provisto.
- * - Función de validación o lista de reglas.
- * - Manejo de errores.
- * - Parsearlos para hacer submit.
- */
-type TValidationField<ValueType = any, SubmitValueType = ValueType> = {
-    error?: string | null;
-    /**
-     * Permite definir una función personalizada para hacer foco sobre el campo. Se utiliza a la hora de validar el campo, cuando el mismo falla.
-     */
-    focus?: TFocusRetriever;
-    isTouched: boolean;
-    /**
-     * El nombre se utilizará para hacer foco en el campo en caso
-     * de que la validación del mismo fallara. Para ello se
-     * intenta recuperar un campo con el selector
-     * [name=${name}, #${name}], en caso de que el selector no
-     * encontrar ningún campo, se intentará hacer foco en el
-     * siguiente campo con error.
-     */
-    name: string;
-    /**
-     * Como dice el nombre, es posible cambiar el nombre de un
-     * campo al hacer submit.
-     */
-    submitName?: string;
-    /**
-     * Es posible recibir un valor ya parseado en el callback
-     * onValidate del Form, para ello se puede proveer este
-     * callback, que será llamado previo a llamar a onValidate.
-     */
-    submitValueParser?: TValidationSubmitValueParser<ValueType, SubmitValueType | Promise<SubmitValueType> | undefined>;
-    /**
-     * Es posible pasar una función de validación personalizada
-     * para casos en los que la validación es significativamente
-     * compleja. En la mayoría de los casos debería bastar con
-     * la propiedad validationRules.
-     */
-    validationFunction?: TValidationFunction<ValueType>;
-    /**
-     * Permite pasar una serie de reglas que el campo debe cumplir
-     * al validar.
-     */
-    validationRules?: TValidationRules;
-    validationValueParser?: TValidationValueParser<ValueType>;
-    value: ValueType;
-};
-type TRegisterFormOptions = Partial<{
-    /**
-     * Si esta propiedad está seteada en true, el formulario se registrará y
-     * aquellos campos que ya tuvieran valor en el store no se volverán a
-     * registrar. En caso de que se incluyera initialValue, se hará updateValue de
-     * estos campos.
-     */
-    avoidFieldsOverride: boolean;
-    initialValues: Record<string, unknown>;
-    /**
-     * Esta propiedad fuerza al formulario a guardarse en el localStorage. Adicionalmente,
-     * si al registrar el formulario ya existe información almacenada, la carga en el store
-     * e ignora las propiedades provistas en el método, a excepción de:
-     *  - fields:validationFunction
-     *  - fields:submitValueParser
-     */
-    persistToSessionStorage: boolean;
-}>;
-type TUpdateFieldOptions = Partial<{
-    avoidPropagation?: boolean;
-    /**
-     * Cuando se hace seteo de propiedades iniciales, se puede pasar este flag
-     * en false para que el formulario no aparezca como touched debido a estos
-     * cambios.
-     */
-    markFormAsTouched: boolean;
-}> & Pick<TRegisterFormOptions, 'avoidFieldsOverride'>;
-type TRegisterFieldOptions = {
-    avoidPropagation?: boolean;
-    registerIfExists?: boolean;
-};
-type TRegisterField = Partial<TValidationField> & Pick<TValidationField, 'name'>;
-type TFormState = {
-    fields: string[];
-    name: string;
-    isTouched: boolean;
-    isValid: boolean;
-    validationResult: TValidationResult<Record<string, unknown>> | null;
-} & Pick<TRegisterFormOptions, 'avoidFieldsOverride' | 'persistToSessionStorage'>;
-
-export type { IFieldDefinition, TFieldValidationResult, TFocusRetriever, TFormState, TPromiseOrNot, TRegisterField, TRegisterFieldOptions, TRegisterFormOptions, TSuccessfulValidation, TUpdateFieldOptions, TValidate, TValidationField, TValidationFunction, TValidationResult, TValidationRules, TValidationSubmitValueParser, TValidationValueParser, TWrongValidation };
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/util.d.ts

@@ -1,36 +0,0 @@
-import { TFieldValidationResult, TValidationResult, TSuccessfulValidation, TValidationField, IFieldDefinition } from './types.js';
-import formcheckLanguage from './lang/es.js';
-
-declare global {
-    interface Window {
-        NO_LANGUAGE_EXCEPTION: string;
-        MSG_INVALID_REG_EXP: string;
-        GNR_INVALID_NAME: string;
-    }
-}
-/**
- * Determina si la validación de un campo resultó exitosa.
- */
-declare function hasSucceedFieldValidation(result: TFieldValidationResult): result is true;
-/**
- * Determina si la validación de un formulario resultó
- * exitosa. Está pensada para utilizar en el callback
- * onValidate de Form o en la acción validationsActions.validateForm
- */
-declare function hasSucceedFormValidation<ValueType extends Record<string, unknown>, SubmitValueType extends Record<keyof ValueType, unknown> = ValueType>(result: TValidationResult<ValueType, SubmitValueType>): result is TSuccessfulValidation<ValueType, SubmitValueType>;
-/**
- * Devuelve la cadena correspondiente a un código
- * de error, realizando los reemplazos correspondientes.
- */
-declare function lang(errorCode: keyof typeof formcheckLanguage, ...replacements: (string | number)[]): string;
-declare function classToValidationFunction<T = string>(className: string): TValidationField<T>['validationFunction'];
-declare function classToValidate(className: string): IFieldDefinition['validate'];
-/**
- * Realiza la carga de los mensajes de errores para el lenguaje
- * especificado. Este método debe llamarse antes de utilizar
- * las validaciones.
- */
-declare function initValidations(): Promise<void>;
-
-export { classToValidate, classToValidationFunction, hasSucceedFieldValidation, hasSucceedFormValidation, initValidations, lang };
-//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"util.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/validationStore.d.ts

@@ -1,105 +0,0 @@
-import { TPropsSelector, TPropsComparator, TPropsConfiguration } from '@apia/util';
-import { TValidationField, TFormState, TRegisterField, TRegisterFieldOptions, TUpdateFieldOptions, TValidationResult } from './types.js';
-
-declare global {
-    interface Window {
-        MSG_WRONG_VALIDATION_NO_FOCUSED_FILE: string;
-    }
-}
-declare const validationsStore: {
-    activeForms: string[];
-    timeouts: Record<string, ReturnType<typeof setTimeout> | true>;
-    getFieldStore(formName: string, fieldName: string): TValidationField;
-    getFormStore(formName: string): TFormState;
-    updateFieldStore(formName: string, fieldName: string, props: Partial<TValidationField>, noEmit?: boolean): void;
-    updateFormStore(formName: string, newState: Partial<TFormState>): void;
-    enableFormTouch(formName: string): void;
-    existsField: (formName: string, fieldName: string) => boolean;
-    makeFieldName(formName: string, fieldName: string): string;
-    makeFormName(formName: string): string;
-    resetForm(formName: string): void;
-    registerField: (formName: string, registerData: TRegisterField, options?: TRegisterFieldOptions) => void;
-    /**
-     * Inicializa el estado de un nuevo formulario
-     */
-    registerForm: (formName: string, props?: Partial<{
-        avoidFieldsOverride: boolean;
-        initialValues: Record<string, unknown>;
-        persistToSessionStorage: boolean;
-    }>) => void;
-    /**
-     * Setea el valor del campo con el nombre provisto. Si el campo no existe
-     * en el formulario lo crea.
-     */
-    setFieldValue: (formName: string, fieldName: string, newValue: unknown, options?: TUpdateFieldOptions) => void;
-    setFormIsTouched: (formName: string, isTouched?: boolean) => void;
-    /**
-     * Elimina un campo del registro de validación de un formulario. De esta
-     * forma cualquier validación que pudiera aplicarse sobre el mismo, ya no se
-     * aplicará.
-     */
-    unregisterField: (formName: string, fieldName: string) => void;
-    /**
-     * Elimina un formulario del store de validación junto con todos los campos
-     * asociados al mismo.
-     */
-    unregisterForm: (formName: string) => void;
-    /**
-     * Actualiza las propiedades de un campo, si no existe, lo registra en el
-     * formulario.
-     */
-    updateField: (formName: string, field: Partial<TValidationField> & Pick<TValidationField, 'name'>, options?: TUpdateFieldOptions) => void;
-    /**
-     * Actualiza múltiples campos al mismo tiempo.
-     */
-    updateMultipleFields: (formName: string, fields: (Partial<TValidationField> & Pick<TValidationField, 'name'>)[], options?: TUpdateFieldOptions) => void;
-    /**
-     * Ejecuta la validación sobre un formulario. En caso de que la validación
-     * falle, se intenta hacer foco sobre el campo que no pudo validar.
-     * Es importante notar que en caso de que un campo requiera validación,
-     * debería estar presente en el DOM.
-     *
-     * No es necesario que el campo esté visible, ya que en caso de estar oculto
-     * (por ejemplo por ser hijo de un acordeón), se emitirá un evento para
-     * expandir al elemento padre que lo estuviera ocultando.
-     *
-     * @returns Devuelve una promesa que al ser resuelta otorga un objeto de tipo
-     * TValidationResult. Este tipo está pensado para ser usado en conjunto con
-     * el método hasSucceedFormValidation, que determinará si la validación fue
-     * exitosa o hubo errores.
-     *
-     * @example
-     *
-     * const result = await validationStore.validateForm('myForm');
-     * if(hasSucceedValidation(result)) {
-     *   console.log('Success!', result);
-     * } else {
-     *   console.error('Validation error', result);
-     * }
-     */
-    validateForm: <ValueType extends Record<string, unknown>, SubmitValueType extends Record<keyof ValueType, unknown> = ValueType>(formName: string) => Promise<TValidationResult<ValueType, SubmitValueType>>;
-};
-/**
- * Este hook permite suscribirse a los cambios realizados en el
- * store de validación de un formulario. Funciona igual a un
- * useAppSelector en cuanto a la función selectora y comparadora.
- *
- * @param selector
- * @param comparator
- * @returns
- */
-declare function useFormSelector<Selected = any>(formName: string, selector: TPropsSelector<Selected, TFormState>, comparator?: TPropsComparator<Selected>): Selected;
-/**
- * Este hook permite suscribirse a los cambios realizados en el
- * store de validación de un campo de formulario. Funciona igual a un
- * useAppSelector en cuanto a la función selectora y comparadora.
- *
- * @param selector
- * @param comparator
- * @returns
- */
-declare function useFieldSelector<ValueType = unknown, SubmitValueType = unknown, Selected = any>(formName: string, fieldName: string, selector?: TPropsSelector<Selected, TValidationField<ValueType, SubmitValueType>>, comparator?: TPropsComparator<Selected>): Selected;
-declare function useFieldSelector<ValueType = unknown, SubmitValueType = unknown, Selected = any>(formName: string, fieldName: string, configurator?: TPropsConfiguration<Selected, TValidationField<ValueType, SubmitValueType>>): Selected;
-
-export { useFieldSelector, useFormSelector, validationsStore };
-//# sourceMappingURL=validationStore.d.ts.map

package/dist/validationStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validationStore.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}