reactaform 1.5.0 → 1.8.1

package/dist/hooks/useDebouncedCallback.d.ts

@@ -0,0 +1,27 @@
+export type DebouncedCallback = {
+    callback: (...args: unknown[]) => void;
+    cancel: () => void;
+    flush: () => void;
+};
+/**
+ * useDebouncedCallback
+ * - callback: function to call
+ * - wait: debounce delay in ms
+ * - options.leading: if true, call on leading edge (optional)
+ *
+ * Returns { callback, cancel, flush } where callback is debounced.
+ */
+export declare function useDebouncedCallback(callback: (...args: unknown[]) => unknown, wait?: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): DebouncedCallback;
+/**
+ * createDebouncedCallback - non-hook variant that returns the same API but
+ * doesn't use React hooks. Useful for creating many debounced callbacks
+ * programmatically (e.g., driven from a static schema) while handling
+ * lifecycle cleanup manually.
+ */
+export declare function createDebouncedCallback(callback: (...args: unknown[]) => unknown, wait?: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+}): DebouncedCallback;

package/dist/hooks/useDropdownPosition.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+export declare function useDropdownPosition(controlRef: React.RefObject<HTMLElement | null>, open: boolean, baseWidth?: number, maxHeight?: number): {
+    left: number;
+    top: number;
+    width: number;
+} | null;

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/useReactaFormContext.d.ts

@@ -0,0 +1,4 @@
+import type { ReactaFormContextType } from '../core/reactaFormTypes';
+export declare const ReactaFormContext: import("react").Context<ReactaFormContextType | undefined>;
+declare const useReactaFormContext: () => ReactaFormContextType;
+export default useReactaFormContext;

package/dist/hooks/useUncontrolledValidatedInput.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export type UseUncontrolledValidatedInputProps = {
+    value?: string | number;
+    onChange?: (value: string) => void;
+    onError?: (error: string | null) => void;
+    validate: (value: string) => string | null;
+};
+/**
+ * Handles:
+ * - Uncontrolled input
+ * - Validation
+ * - Error sync
+ */
+export declare function useUncontrolledValidatedInput<T extends HTMLInputElement | HTMLTextAreaElement = HTMLInputElement>({ value, onChange, onError, validate, }: UseUncontrolledValidatedInputProps): {
+    inputRef: React.MutableRefObject<T | null>;
+    error: string | null;
+    handleChange: (e: React.ChangeEvent<T>) => void;
+};

package/dist/hooks/useUnitValueField.d.ts

@@ -0,0 +1,13 @@
+import type { DefinitionPropertyField } from "../core/reactaFormTypes";
+export declare function useUnitValueField(definitionName: string, field: DefinitionPropertyField, value: [string | number, string], unitFactors: {
+    default: string;
+    labels: Record<string, string>;
+    reverseLabels?: Record<string, string>;
+}, t: (key: string) => string, onChange?: (v: [string, string], err: string | null) => void, onError?: (err: string | null) => void): {
+    value: string;
+    unit: string;
+    error: string | null;
+    setValue: (v: string) => void;
+    setUnit: (u: string) => void;
+    setBoth: (v: string, u: string) => void;
+};

package/dist/index.d.ts

@@ -6,19 +6,20 @@ 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 { registerComponent, getComponent, } from './core/registries/componentRegistry';
-export { validateFieldValue } from './core/validation';
-export { registerPlugin, unregisterPlugin, getPlugin, getAllPlugins, hasPlugin, registerComponents, } from './core/registries/pluginRegistry';
-export type { ReactaFormPlugin, ConflictResolution, PluginRegistrationOptions, PluginConflict, } from './core/registries/pluginRegistry';
+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
+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/registries/submissionHandlerRegistry';
-export { registerFieldValidationHandler, registerFormValidationHandler, } from './core/registries/validationHandlerRegistry';
-export type { DebouncedCallback } from './hooks/useDebouncedCallback';
-export { useDebouncedCallback } from './hooks/useDebouncedCallback';
+export { registerSubmissionHandler, } from './core/submissionHandlerRegistry';
+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';