reactaform 1.8.0 → 1.8.2

package/dist/core/componentRegistry.d.ts

@@ -1,5 +1,12 @@
 import BaseRegistry from "./baseRegistry";
+export type DebounceConfig = false | {
+    wait?: number;
+    leading?: boolean;
+    trailing?: boolean;
+};
+export declare const DEBOUNCE_CONFIG: Record<string, DebounceConfig>;
 declare const registry: BaseRegistry<unknown>;
+export declare function isBuiltinComponentType(typeName: string): boolean;
 export declare function registerComponentInternal(type: string, component: unknown, isBaseComponent: boolean): void;
 export declare function registerComponent(type: string, component: unknown): void;
 export declare function getComponent(type: string): unknown;

package/dist/core/index.d.ts

@@ -1,23 +1 @@
-export * from "./reactaFormTypes";
-export * from "./submitForm";
-export * from "./fieldVisibility";
-export * from "./reactaFormModel";
-export * from "./pluginRegistry";
-export * from "./componentRegistry";
-export * from "./submissionHandlerRegistry";
-export * from "./baseRegistry";
-import * as submitForm from "./submitForm";
-import * as fieldVisibility from "./fieldVisibility";
-import * as reactaFormModel from "./reactaFormModel";
-import * as pluginRegistry from "./pluginRegistry";
-import * as componentRegistry from "./componentRegistry";
-import * as submissionRegistry from "./submissionHandlerRegistry";
-declare const _default: {
-    submitForm: typeof submitForm;
-    fieldVisibility: typeof fieldVisibility;
-    reactaFormModel: typeof reactaFormModel;
-    pluginRegistry: typeof pluginRegistry;
-    componentRegistry: typeof componentRegistry;
-    submissionRegistry: typeof submissionRegistry;
-};
-export default _default;
+export {};

package/dist/core/pluginRegistry.d.ts

@@ -3,7 +3,7 @@
  * Tracks installed plugins, components, validators, submission handlers
  * Handles conflicts with customizable strategy
  */
-import type { FieldValidationHandler, FormValidationHandler, FormSubmissionHandler } from './reactaFormTypes';
+import type { FieldCustomValidationHandler, FieldTypeValidationHandler, FormValidationHandler, FormSubmissionHandler } from './reactaFormTypes';
 /** Conflict resolution strategies */
 export type ConflictResolution = 'error' | 'warn' | 'override' | 'skip';
 /** Plugin registration options */
@@ -13,7 +13,7 @@ export interface PluginRegistrationOptions {
 }
 /** Plugin conflict information */
 export interface PluginConflict {
-    type: 'component' | 'fieldValidator' | 'formValidator' | 'submissionHandler' | 'plugin';
+    type: 'component' | 'fieldCustomValidator' | 'fieldTypeValidator' | 'formValidator' | 'submissionHandler' | 'plugin';
     name: string;
     existingPlugin: string;
     newPlugin: string;
@@ -24,7 +24,8 @@ export interface ReactaFormPlugin {
     version: string;
     description?: string;
     components?: Record<string, React.ComponentType<unknown>>;
-    fieldValidators?: Record<string, Record<string, FieldValidationHandler>>;
+    fieldCustomValidators?: Record<string, Record<string, FieldCustomValidationHandler>>;
+    fieldTypeValidators?: Record<string, FieldTypeValidationHandler>;
     formValidators?: Record<string, FormValidationHandler>;
     submissionHandlers?: Record<string, FormSubmissionHandler>;
     setup?: () => void;

package/dist/core/reactaFormTypes.d.ts

@@ -70,18 +70,23 @@ export interface ReactaFormProps {
     className?: string;
     theme?: string;
     style?: React.CSSProperties;
+    fieldValidationMode?: FieldValidationMode;
 }
 export type TranslationFunction = (text: string, ...args: unknown[]) => string;
-export type FieldValidationHandler = (fieldName: string, value: FieldValueType | unknown, t: TranslationFunction) => string | undefined;
+/** Validation mode controls where validation is performed. */
+export type FieldValidationMode = 'realTime' | 'onSubmission';
+export type FieldCustomValidationHandler = (fieldName: string, value: FieldValueType | unknown, t: TranslationFunction) => string | undefined;
+export type FieldTypeValidationHandler = (field: DefinitionPropertyField, input: FieldValueType, t: TranslationFunction) => string | null;
 export type FormValidationHandler = (valuesMap: Record<string, FieldValueType | unknown>, t: TranslationFunction) => string[] | undefined | Promise<string[] | undefined>;
-export type FormSubmissionHandler = (definition: ReactaDefinition | Record<string, unknown>, instanceName: string | null, valuesMap: Record<string, FieldValueType | unknown>, t: TranslationFunction) => string[] | undefined | Promise<string[] | undefined>;
-export type InputOnChange<T> = (value: T | string, error: string | null) => void;
+export type FormSubmissionHandler = (definition: ReactaDefinition, instanceName: string | null, valuesMap: Record<string, FieldValueType | unknown>, t: TranslationFunction) => string[] | undefined | Promise<string[] | undefined>;
+export type InputOnChange<T> = (value: T | string) => void;
 export interface BaseInputProps<TValue = unknown, TField extends DefinitionPropertyField = DefinitionPropertyField> {
     field: TField;
     value: TValue;
     placeholder?: string;
     onChange?: InputOnChange<TValue>;
     onError?: (error: string | null) => void;
+    error?: string | null;
 }
 export type ReactaFormContextType = {
     definitionName: string;
@@ -93,6 +98,7 @@ export type ReactaFormContextType = {
     };
     fieldStyle: Record<string, unknown>;
     t: TranslationFunction;
+    fieldValidationMode?: FieldValidationMode;
 };
 export type ReactaFormProviderProps = {
     children: ReactNode;
@@ -101,6 +107,7 @@ export type ReactaFormProviderProps = {
     defaultLanguage?: string;
     defaultTheme?: string;
     defaultLocalizeName?: string;
+    defaultFieldValidationMode?: FieldValidationMode;
     className?: string;
 };
 export type TranslationMap = Record<string, string>;

package/dist/hooks/useFieldValidator.d.ts

@@ -0,0 +1,2 @@
+import type { DefinitionPropertyField, FieldValueType } from '../core/reactaFormTypes';
+export declare function useFieldValidator(field: DefinitionPropertyField, externalError?: string | null): (value: FieldValueType) => string | null;

package/dist/hooks/useUncontrolledValidatedInput.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 export type UseUncontrolledValidatedInputProps = {
-    value?: string;
-    onChange?: (value: string, error: string | null) => void;
+    value?: string | number;
+    onChange?: (value: string) => void;
     onError?: (error: string | null) => void;
     validate: (value: string) => string | null;
 };

package/dist/index.d.ts

@@ -6,21 +6,21 @@ export { ReactaFormProvider } from './components/ReactaFormProvider';
 export { default as useReactaFormContext } from './hooks/useReactaFormContext';
 export { StandardFieldLayout } from './components/LayoutComponents';
 export { CSS_CLASSES, combineClasses } from './utils/cssClasses';
-export type { ReactaFormContextType, ReactaFormProviderProps, DefinitionPropertyField, ReactaDefinition, ReactaInstance, ReactaFormProps, FieldValueType, ErrorType, FieldValidationHandler, FormValidationHandler, FormSubmissionHandler, InputOnChange, BaseInputProps, TranslationFunction, } from './core/reactaFormTypes';
+export type { ReactaFormContextType, ReactaFormProviderProps, DefinitionPropertyField, ReactaDefinition, ReactaInstance, ReactaFormProps, FieldValueType, ErrorType, FieldCustomValidationHandler, FieldTypeValidationHandler, FormValidationHandler, FormSubmissionHandler, InputOnChange, BaseInputProps, TranslationFunction, FieldValidationMode } from './core/reactaFormTypes';
 export { registerComponent, getComponent, } from './core/componentRegistry';
 export { validateFieldValue, // Deprecated, use validateFieldWithHandler instead
-validateFieldWithHandler } from './validation/validation';
-import './validation';
-export { registerPlugin, unregisterPlugin, getPlugin, getAllPlugins, hasPlugin, registerComponents, } from './core/pluginRegistry';
-export type { ReactaFormPlugin, ConflictResolution, PluginRegistrationOptions, PluginConflict, } from './core/pluginRegistry';
+validateFieldWithCustomHandler } from './validation/validation';
+export { type ReactaFormPlugin, type ConflictResolution, type PluginRegistrationOptions, type PluginConflict, registerPlugin, unregisterPlugin, getPlugin, getAllPlugins, hasPlugin, registerComponents, } from './core/pluginRegistry';
 export type { LoadDefinitionOptions, DefinitionLoadResult, InstanceLoadResult, } from './core/reactaFormModel';
 export { loadJsonDefinition, createInstanceFromDefinition, // Create new instance with default values
 loadInstance, // Load existing instance (valuesMap)
 upgradeInstanceToLatestDefinition } from './core/reactaFormModel';
 export { registerSubmissionHandler, } from './core/submissionHandlerRegistry';
-export { registerFieldValidationHandler, registerFormValidationHandler, } from './validation/validationHandlerRegistry';
-export type { DebouncedCallback } from './hooks/useDebouncedCallback';
-export { useDebouncedCallback } from './hooks/useDebouncedCallback';
+export { registerFieldCustomValidationHandler, registerFieldTypeValidationHandler, registerFormValidationHandler, } from './validation/validationHandlerRegistry';
+export { type DebouncedCallback, useDebouncedCallback } from './hooks/useDebouncedCallback';
+export { useFieldValidator } from './hooks/useFieldValidator';
+export { useUncontrolledValidatedInput, type UseUncontrolledValidatedInputProps } from './hooks/useUncontrolledValidatedInput';
 export * as Units from './utils/unitValueMapper';
 export { isDarkTheme } from './utils/themeUtils';
 export { serializeInstance, deserializeInstance, serializeDefinition, deserializeDefinition } from './utils/definitionSerializers';
+export { getSupportedLanguages } from './utils/translationCache';