@sudobility/components 4.0.114 → 4.0.116

package/dist/hooks/index.d.ts

@@ -9,4 +9,5 @@ export { useCopyToClipboard, useMultipleCopyToClipboard, type CopyToClipboardOpt
 export { useLocalizedNavigate, addLanguageToPath, removeLanguageFromPath, } from './useLocalizedNavigate';
 export type { UseLocalizedNavigateOptions, UseLocalizedNavigateReturn, } from './useLocalizedNavigate';
 export { useRoutePerformance } from './useRoutePerformance';
+export { useFormValidation, type ValidationRule, type FieldConfig, type FormFieldState, type UseFormValidationOptions, type UseFormValidationResult, } from './useFormValidation';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}

package/dist/hooks/useFormValidation.d.ts

@@ -0,0 +1,116 @@
+export type ValidationRule<T> = (value: T) => string | undefined;
+export interface FieldConfig<T> {
+    /** Initial value */
+    initialValue: T;
+    /** Validation rules (return error string or undefined) */
+    validate?: ValidationRule<T>[];
+    /** Whether field is required */
+    required?: boolean;
+    /** Custom required message */
+    requiredMessage?: string;
+}
+export interface FormFieldState<T> {
+    value: T;
+    error?: string;
+    touched: boolean;
+    dirty: boolean;
+}
+export interface UseFormValidationOptions<T extends Record<string, unknown>> {
+    /** Field configurations */
+    fields: {
+        [K in keyof T]: FieldConfig<T[K]>;
+    };
+    /** Validate on change (default: only after blur) */
+    validateOnChange?: boolean;
+    /** Validate on blur (default: true) */
+    validateOnBlur?: boolean;
+}
+export interface UseFormValidationResult<T extends Record<string, unknown>> {
+    /** Current form values */
+    values: T;
+    /** Field errors */
+    errors: Partial<Record<keyof T, string>>;
+    /** Which fields have been touched (blurred) */
+    touched: Partial<Record<keyof T, boolean>>;
+    /** Which fields have been modified */
+    dirty: Partial<Record<keyof T, boolean>>;
+    /** Whether the form is valid */
+    isValid: boolean;
+    /** Whether any field has been modified */
+    isDirty: boolean;
+    /** Set a field value */
+    setValue: <K extends keyof T>(field: K, value: T[K]) => void;
+    /** Set multiple values at once */
+    setValues: (values: Partial<T>) => void;
+    /** Mark a field as touched (trigger validation) */
+    setTouched: (field: keyof T) => void;
+    /** Validate a single field */
+    validateField: (field: keyof T) => string | undefined;
+    /** Validate all fields */
+    validateAll: () => boolean;
+    /** Reset form to initial values */
+    reset: () => void;
+    /** Reset a single field */
+    resetField: (field: keyof T) => void;
+    /** Get props for an input field */
+    getFieldProps: <K extends keyof T>(field: K) => {
+        value: T[K];
+        onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => void;
+        onBlur: () => void;
+        name: string;
+        'aria-invalid': boolean;
+    };
+    /** Get error message for a field (only if touched) */
+    getFieldError: (field: keyof T) => string | undefined;
+}
+/**
+ * useFormValidation Hook
+ *
+ * A comprehensive form validation hook with touched state tracking,
+ * field-level validation, and accessibility support.
+ *
+ * @example
+ * ```tsx
+ * const { values, errors, getFieldProps, getFieldError, validateAll, isValid } = useFormValidation({
+ *   fields: {
+ *     email: {
+ *       initialValue: '',
+ *       required: true,
+ *       requiredMessage: 'Email is required',
+ *       validate: [
+ *         (v) => !v.includes('@') ? 'Invalid email format' : undefined,
+ *       ],
+ *     },
+ *     password: {
+ *       initialValue: '',
+ *       required: true,
+ *       validate: [
+ *         (v) => v.length < 8 ? 'Password must be at least 8 characters' : undefined,
+ *       ],
+ *     },
+ *   },
+ * });
+ *
+ * const handleSubmit = (e: FormEvent) => {
+ *   e.preventDefault();
+ *   if (validateAll()) {
+ *     // Submit form
+ *   }
+ * };
+ *
+ * return (
+ *   <form onSubmit={handleSubmit}>
+ *     <input {...getFieldProps('email')} type="email" />
+ *     {getFieldError('email') && <span>{getFieldError('email')}</span>}
+ *
+ *     <input {...getFieldProps('password')} type="password" />
+ *     {getFieldError('password') && <span>{getFieldError('password')}</span>}
+ *
+ *     <button type="submit" disabled={!isValid}>Submit</button>
+ *   </form>
+ * );
+ * ```
+ */
+export declare function useFormValidation<T extends Record<string, unknown>>({ fields, validateOnChange, validateOnBlur, }: UseFormValidationOptions<T>): UseFormValidationResult<T>;
+export default useFormValidation;
+//# sourceMappingURL=useFormValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormValidation.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormValidation.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -13,7 +13,6 @@ export * from './primitives';
 export * from './forms';
 export * from './ui/action-button';
 export * from './ui/address-link';
-export * from './ui/animated-counter';
 export * from './ui/animated-section';
 export * from './ui/backdrop';
 export * from './ui/banner';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjC,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC;AAG9B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,wBAAwB,CAAC;AAGhC,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,uCAAuC,CAAC;AAY/C,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;;;;;;AAEjC,wBAIE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGjC,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC;AAG9B,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,wBAAwB,CAAC;AAGhC,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,uCAAuC,CAAC;AAY/C,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;;;;;;AAEjC,wBAIE"}