@thunderid/react 1.4.1 → 1.6.0

package/dist/hooks/management/users/useGetUserGroups.js

@@ -0,0 +1,39 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceQuery_default from "../useResourceQuery.js";
+import { GroupQueryKeys, getUserGroups } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useGetUserGroups.ts
+/**
+* Fetches a page of the groups a user belongs to.
+*
+* @param userId - Identifier of the user. Fetching waits until it is defined.
+* @param params - Pagination parameters.
+* @param options - Query options, including a per-hook `fetcher`.
+* @returns The query state.
+*/
+const useGetUserGroups = (userId, { limit, offset } = {}, options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceQuery_default([
+		GroupQueryKeys.MEMBERSHIPS,
+		"user",
+		userId,
+		{
+			limit,
+			offset
+		}
+	], (fetcher) => getUserGroups({
+		...endpoint,
+		fetcher,
+		limit,
+		offset,
+		userId
+	}), {
+		...options,
+		enabled: Boolean(userId) && options?.enabled !== false
+	});
+};
+var useGetUserGroups_default = useGetUserGroups;
+
+//#endregion
+export { useGetUserGroups_default as default };
+//# sourceMappingURL=useGetUserGroups.js.map

package/dist/hooks/management/users/useGetUserGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUserGroups.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceQuery"],"sources":["../../../../src/hooks/management/users/useGetUserGroups.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {GroupQueryKeys, MembershipGroupListResponse, getUserGroups} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceQuery, {ResourceQueryOptions, ResourceQueryResult} from '../useResourceQuery';\n\n/**\n * Fetches a page of the groups a user belongs to.\n *\n * @param userId - Identifier of the user. Fetching waits until it is defined.\n * @param params - Pagination parameters.\n * @param options - Query options, including a per-hook `fetcher`.\n * @returns The query state.\n */\nconst useGetUserGroups = (\n  userId: string | undefined,\n  {limit, offset}: {limit?: number; offset?: number} = {},\n  options?: ResourceQueryOptions,\n): ResourceQueryResult<MembershipGroupListResponse> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceQuery(\n    [GroupQueryKeys.MEMBERSHIPS, 'user', userId, {limit, offset}],\n    (fetcher) => getUserGroups({...endpoint, fetcher, limit, offset, userId: userId!}),\n    {...options, enabled: Boolean(userId) && options?.enabled !== false},\n  );\n};\n\nexport default useGetUserGroups;\n"],"mappings":";;;;;;;;;;;;;AAeA,MAAM,oBACJ,QACA,EAAC,OAAO,WAA6C,EAAE,EACvD,YACqD;CACrD,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,yBACL;EAAC,eAAe;EAAa;EAAQ;EAAQ;GAAC;GAAO;GAAO;EAAC,GAC5D,YAAY,cAAc;EAAC,GAAG;EAAU;EAAS;EAAO;EAAgB;EAAQ,CAAC,EAClF;EAAC,GAAG;EAAS,SAAS,QAAQ,OAAO,IAAI,SAAS,YAAY;EAAM,CACrE;;AAGH,+BAAe"}

package/dist/hooks/management/users/useGetUserTypes.d.ts

@@ -0,0 +1,15 @@
+import { ManagedUserTypeListResponse } from '@thunderid/browser';
+import { ResourceQueryOptions, ResourceQueryResult } from '../useResourceQuery';
+/**
+ * Fetches a page of user types.
+ *
+ * @param params - Pagination parameters.
+ * @param options - Query options, including a per-hook `fetcher`.
+ * @returns The query state.
+ */
+declare const useGetUserTypes: ({ limit, offset }?: {
+    limit?: number;
+    offset?: number;
+}, options?: ResourceQueryOptions) => ResourceQueryResult<ManagedUserTypeListResponse>;
+export default useGetUserTypes;
+//# sourceMappingURL=useGetUserTypes.d.ts.map

package/dist/hooks/management/users/useGetUserTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUserTypes.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useGetUserTypes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,2BAA2B,EAA8B,MAAM,oBAAoB,CAAC;AAE5F,OAAyB,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAEhG;;;;;;GAMG;AACH,QAAA,MAAM,eAAe,GACnB,oBAAiB;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,EACvD,UAAU,oBAAoB,KAC7B,mBAAmB,CAAC,2BAA2B,CAQjD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/hooks/management/users/useGetUserTypes.js

@@ -0,0 +1,29 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceQuery_default from "../useResourceQuery.js";
+import { UserQueryKeys, getUserTypes } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useGetUserTypes.ts
+/**
+* Fetches a page of user types.
+*
+* @param params - Pagination parameters.
+* @param options - Query options, including a per-hook `fetcher`.
+* @returns The query state.
+*/
+const useGetUserTypes = ({ limit, offset } = {}, options) => {
+	const endpoint = useManagementEndpoint_default("userTypes");
+	return useResourceQuery_default([UserQueryKeys.USER_TYPES, {
+		limit,
+		offset
+	}], (fetcher) => getUserTypes({
+		...endpoint,
+		fetcher,
+		limit,
+		offset
+	}), options);
+};
+var useGetUserTypes_default = useGetUserTypes;
+
+//#endregion
+export { useGetUserTypes_default as default };
+//# sourceMappingURL=useGetUserTypes.js.map

package/dist/hooks/management/users/useGetUserTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUserTypes.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceQuery"],"sources":["../../../../src/hooks/management/users/useGetUserTypes.ts"],"sourcesContent":["// Copyright 2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ManagedUserTypeListResponse, UserQueryKeys, getUserTypes} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceQuery, {ResourceQueryOptions, ResourceQueryResult} from '../useResourceQuery';\n\n/**\n * Fetches a page of user types.\n *\n * @param params - Pagination parameters.\n * @param options - Query options, including a per-hook `fetcher`.\n * @returns The query state.\n */\nconst useGetUserTypes = (\n  {limit, offset}: {limit?: number; offset?: number} = {},\n  options?: ResourceQueryOptions,\n): ResourceQueryResult<ManagedUserTypeListResponse> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('userTypes');\n\n  return useResourceQuery(\n    [UserQueryKeys.USER_TYPES, {limit, offset}],\n    (fetcher) => getUserTypes({...endpoint, fetcher, limit, offset}),\n    options,\n  );\n};\n\nexport default useGetUserTypes;\n"],"mappings":";;;;;;;;;;;;AAcA,MAAM,mBACJ,EAAC,OAAO,WAA6C,EAAE,EACvD,YACqD;CACrD,MAAMA,WAA+BC,8BAAsB,YAAY;AAEvE,QAAOC,yBACL,CAAC,cAAc,YAAY;EAAC;EAAO;EAAO,CAAC,GAC1C,YAAY,aAAa;EAAC,GAAG;EAAU;EAAS;EAAO;EAAO,CAAC,EAChE,QACD;;AAGH,8BAAe"}

package/dist/hooks/management/users/useGetUsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUsers.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useGetUsers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,kBAAkB,EAAE,uBAAuB,EAA0B,MAAM,oBAAoB,CAAC;AAExG,OAAyB,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAEhG;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,WAAW,GACf,4BAAyB,kBAAuB,EAChD,UAAU,oBAAoB,KAC7B,mBAAmB,CAAC,uBAAuB,CAQ7C,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/hooks/management/users/useGetUsers.js

@@ -0,0 +1,36 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceQuery_default from "../useResourceQuery.js";
+import { UserQueryKeys, getUsers } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useGetUsers.ts
+/**
+* Fetches a page of users.
+*
+* @param params - Pagination and filter parameters.
+* @param options - Query options, including a per-hook `fetcher`.
+* @returns The query state.
+*
+* @example
+* ```tsx
+* const {data, isLoading} = useGetUsers({limit: 20, filter: 'username sw "a"'});
+* ```
+*/
+const useGetUsers = ({ filter, limit, offset } = {}, options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceQuery_default([UserQueryKeys.USERS, {
+		filter,
+		limit,
+		offset
+	}], (fetcher) => getUsers({
+		...endpoint,
+		fetcher,
+		filter,
+		limit,
+		offset
+	}), options);
+};
+var useGetUsers_default = useGetUsers;
+
+//#endregion
+export { useGetUsers_default as default };
+//# sourceMappingURL=useGetUsers.js.map

package/dist/hooks/management/users/useGetUsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetUsers.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceQuery"],"sources":["../../../../src/hooks/management/users/useGetUsers.ts"],"sourcesContent":["// Copyright 2025-2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ApiFilteringParams, ManagedUserListResponse, UserQueryKeys, getUsers} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceQuery, {ResourceQueryOptions, ResourceQueryResult} from '../useResourceQuery';\n\n/**\n * Fetches a page of users.\n *\n * @param params - Pagination and filter parameters.\n * @param options - Query options, including a per-hook `fetcher`.\n * @returns The query state.\n *\n * @example\n * ```tsx\n * const {data, isLoading} = useGetUsers({limit: 20, filter: 'username sw \"a\"'});\n * ```\n */\nconst useGetUsers = (\n  {filter, limit, offset}: ApiFilteringParams = {},\n  options?: ResourceQueryOptions,\n): ResourceQueryResult<ManagedUserListResponse> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceQuery(\n    [UserQueryKeys.USERS, {filter, limit, offset}],\n    (fetcher) => getUsers({...endpoint, fetcher, filter, limit, offset}),\n    options,\n  );\n};\n\nexport default useGetUsers;\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAM,eACJ,EAAC,QAAQ,OAAO,WAA8B,EAAE,EAChD,YACiD;CACjD,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,yBACL,CAAC,cAAc,OAAO;EAAC;EAAQ;EAAO;EAAO,CAAC,GAC7C,YAAY,SAAS;EAAC,GAAG;EAAU;EAAS;EAAQ;EAAO;EAAO,CAAC,EACpE,QACD;;AAGH,0BAAe"}

package/dist/hooks/management/users/useUpdateUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateUser.d.ts","sourceRoot":"","sources":["../../../../src/hooks/management/users/useUpdateUser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,WAAW,EAAE,wBAAwB,EAA4B,MAAM,oBAAoB,CAAC;AAEpG,OAA4B,EAAC,uBAAuB,EAAE,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AAE5G;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,QAAA,MAAM,aAAa,GACjB,UAAU,uBAAuB,CAAC,WAAW,EAAE,mBAAmB,CAAC,KAClE,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,CAQzD,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/management/users/useUpdateUser.js

@@ -0,0 +1,25 @@
+import useManagementEndpoint_default from "../useManagementEndpoint.js";
+import useResourceMutation_default from "../useResourceMutation.js";
+import { UserQueryKeys, updateUser } from "@thunderid/browser";
+
+//#region src/hooks/management/users/useUpdateUser.ts
+/**
+* Updates a user, then refetches it and any mounted user lists.
+*
+* @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.
+* @returns The mutation state. Call `mutate({userId, data})` to update.
+*/
+const useUpdateUser = (options) => {
+	const endpoint = useManagementEndpoint_default("users");
+	return useResourceMutation_default(({ userId, data }, fetcher) => updateUser({
+		...endpoint,
+		fetcher,
+		payload: data,
+		userId
+	}), ({ userId }) => [[UserQueryKeys.USER, userId], [UserQueryKeys.USERS]], options);
+};
+var useUpdateUser_default = useUpdateUser;
+
+//#endregion
+export { useUpdateUser_default as default };
+//# sourceMappingURL=useUpdateUser.js.map

package/dist/hooks/management/users/useUpdateUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateUser.js","names":["endpoint: ManagementEndpoint","useManagementEndpoint","useResourceMutation"],"sources":["../../../../src/hooks/management/users/useUpdateUser.ts"],"sourcesContent":["// Copyright 2025-2026 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {ManagedUser, UpdateManagedUserRequest, UserQueryKeys, updateUser} from '@thunderid/browser';\nimport useManagementEndpoint, {ManagementEndpoint} from '../useManagementEndpoint';\nimport useResourceMutation, {ResourceMutationOptions, ResourceMutationResult} from '../useResourceMutation';\n\n/**\n * Variables accepted by {@link useUpdateUser}'s `mutate`.\n */\nexport interface UpdateUserVariables {\n  data: UpdateManagedUserRequest;\n  userId: string;\n}\n\n/**\n * Updates a user, then refetches it and any mounted user lists.\n *\n * @param options - Mutation options, including `onSuccess`, `onError`, and a per-hook `fetcher`.\n * @returns The mutation state. Call `mutate({userId, data})` to update.\n */\nconst useUpdateUser = (\n  options?: ResourceMutationOptions<ManagedUser, UpdateUserVariables>,\n): ResourceMutationResult<ManagedUser, UpdateUserVariables> => {\n  const endpoint: ManagementEndpoint = useManagementEndpoint('users');\n\n  return useResourceMutation(\n    ({userId, data}: UpdateUserVariables, fetcher) => updateUser({...endpoint, fetcher, payload: data, userId}),\n    ({userId}: UpdateUserVariables) => [[UserQueryKeys.USER, userId], [UserQueryKeys.USERS]],\n    options,\n  );\n};\n\nexport default useUpdateUser;\n"],"mappings":";;;;;;;;;;;AAqBA,MAAM,iBACJ,YAC6D;CAC7D,MAAMA,WAA+BC,8BAAsB,QAAQ;AAEnE,QAAOC,6BACJ,EAAC,QAAQ,QAA4B,YAAY,WAAW;EAAC,GAAG;EAAU;EAAS,SAAS;EAAM;EAAO,CAAC,GAC1G,EAAC,aAAiC,CAAC,CAAC,cAAc,MAAM,OAAO,EAAE,CAAC,cAAc,MAAM,CAAC,EACxF,QACD;;AAGH,4BAAe"}

package/dist/hooks/useForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useForm.js","names":["fieldError: string | null","getFieldConfig: (name: keyof T) => FormField | undefined","validateField: (name: keyof T) => string | null","revalidateTouchedFields: () => void","newErrors: Record<keyof T, string>","freshError: string | null","validateForm: () => ValidationResult","error: string | null","globalErrors: Record<string, string>","isValid: boolean","setValue: (name: keyof T, value: string) => void","setValues: (newValues: Partial<T>) => void","setTouched: (name: keyof T, isTouched?: boolean) => void","setTouchedFields: (touchedFields: Partial<Record<keyof T, boolean>>) => void","touchAllFields: () => void","validation: ValidationResult","setError: (name: keyof T, error: string) => void","setErrors: (newErrors: Partial<Record<keyof T, string>>) => void","clearErrors: () => void","reset: () => void","handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>","fieldConfig: FormField | undefined"],"sources":["../../src/hooks/useForm.ts"],"sourcesContent":["// Copyright 2025 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {useState, useCallback, useRef, FormEvent} from 'react';\n\n/**\n * Generic form field configuration\n */\nexport interface FormField {\n  initialValue?: string;\n  name: string;\n  required?: boolean;\n  validator?: (value: string) => string | null;\n}\n\n/**\n * Form validation result\n */\nexport interface ValidationResult {\n  errors: Record<string, string>;\n  isValid: boolean;\n}\n\n/**\n * Configuration for the useForm hook\n */\nexport interface UseFormConfig<T extends Record<string, string>> {\n  /**\n   * Form field definitions\n   */\n  fields?: FormField[];\n  /**\n   * Initial form values\n   */\n  initialValues?: Partial<T>;\n  /**\n   * Custom required field validation message\n   */\n  requiredMessage?: string;\n  /**\n   * When a field has been touched (blurred at least once), re-run validation on every\n   * subsequent change so a rendered error clears the moment the value becomes valid.\n   *\n   * Independent of `validateOnChange`: this only affects fields that have already been\n   * blurred, so users don't see errors while initially typing. Default `false` to\n   * preserve prior behavior; enable per-form for a \"correct-as-you-type\" UX.\n   */\n  revalidateOnChangeAfterBlur?: boolean;\n  /**\n   * Whether to validate on blur (default: true)\n   */\n  validateOnBlur?: boolean;\n  /**\n   * Whether to validate on change (default: false). When true, every keystroke\n   * triggers validation — including the first, which surfaces errors before the user\n   * has had a chance to finish typing. Prefer `revalidateOnChangeAfterBlur` for the\n   * common \"clear the error as the user corrects\" UX.\n   */\n  validateOnChange?: boolean;\n  /**\n   * Global form validator function\n   */\n  validator?: (values: T) => Record<string, string>;\n}\n\n/**\n * Pure per-field validator. Kept outside `useForm` so `setValue` can validate against\n * the value it just wrote — inline validation via the closure-based `validateField`\n * inside the hook would read stale `values` (state is committed asynchronously).\n */\nconst computeFieldError = (\n  value: string,\n  fieldConfig: FormField | undefined,\n  requiredMessage: string,\n): string | null => {\n  if (fieldConfig?.required && (!value || value.trim() === '')) {\n    return requiredMessage;\n  }\n  if (fieldConfig?.validator) {\n    const fieldError: string | null = fieldConfig.validator(value);\n    if (fieldError) return fieldError;\n  }\n  return null;\n};\n\n/**\n * Return type for the useForm hook\n */\nexport interface UseFormReturn<T extends Record<string, string>> {\n  /**\n   * Clear all errors\n   */\n  clearErrors: () => void;\n  /**\n   * Current validation errors\n   */\n  errors: Record<keyof T, string>;\n  /**\n   * Get field props for easy integration with form components\n   */\n  getFieldProps: (name: keyof T) => {\n    error: string | undefined;\n    name: keyof T;\n    onBlur: () => void;\n    onChange: (value: string) => void;\n    required: boolean;\n    touched: boolean;\n    value: string;\n  };\n  /**\n   * Handle form submission\n   */\n  handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>;\n  /**\n   * Whether the form has been submitted\n   */\n  isSubmitted: boolean;\n  /**\n   * Whether the form is currently valid\n   */\n  isValid: boolean;\n  /**\n   * Reset the form to initial values\n   */\n  reset: () => void;\n  /**\n   * Set a field error\n   */\n  setError: (name: keyof T, error: string) => void;\n  /**\n   * Set multiple field errors\n   */\n  setErrors: (errors: Partial<Record<keyof T, string>>) => void;\n  /**\n   * Mark a field as touched\n   */\n  setTouched: (name: keyof T, touched?: boolean) => void;\n  /**\n   * Mark multiple fields as touched\n   */\n  setTouchedFields: (touched: Partial<Record<keyof T, boolean>>) => void;\n  /**\n   * Set a single field value\n   */\n  setValue: (name: keyof T, value: string) => void;\n  /**\n   * Set multiple field values\n   */\n  setValues: (values: Partial<T>) => void;\n  /**\n   * Mark all fields as touched\n   */\n  touchAllFields: () => void;\n  /**\n   * Fields that have been touched by the user\n   */\n  touched: Record<keyof T, boolean>;\n  /**\n   * Validate a single field\n   */\n  validateField: (name: keyof T) => string | null;\n  /**\n   * Validate all fields\n   */\n  validateForm: () => ValidationResult;\n  /**\n   * Re-run validation for all touched fields that have a client-side config,\n   * refreshing stored error strings to the current language.\n   */\n  revalidateTouchedFields: () => void;\n  /**\n   * Current form values\n   */\n  values: T;\n}\n\n/**\n * Generic form hook that provides comprehensive form state management and validation.\n *\n * @template T - The type of form values (must extend Record<string, string>)\n * @param config - Configuration options for the form\n * @returns Form state and methods\n *\n * @example\n * ```tsx\n * interface LoginForm {\n *   username: string;\n *   password: string;\n * }\n *\n * const {\n *   values,\n *   touched,\n *   errors,\n *   isValid,\n *   setValue,\n *   handleSubmit,\n *   getFieldProps\n * } = useForm<LoginForm>({\n *   initialValues: { username: '', password: '' },\n *   fields: [\n *     { name: 'username', required: true },\n *     { name: 'password', required: true }\n *   ]\n * });\n *\n * const onSubmit = handleSubmit((values) => {\n *   console.log('Form submitted:', values);\n * });\n *\n * return (\n *   <form onSubmit={onSubmit}>\n *     <input {...getFieldProps('username')} />\n *     <input {...getFieldProps('password')} type=\"password\" />\n *     <button type=\"submit\" disabled={!isValid}>Submit</button>\n *   </form>\n * );\n * ```\n */\nexport const useForm = <T extends Record<string, string>>(config: UseFormConfig<T> = {}): UseFormReturn<T> => {\n  const {\n    initialValues = {} as T,\n    fields = [],\n    validator,\n    validateOnChange = false,\n    validateOnBlur = true,\n    revalidateOnChangeAfterBlur = false,\n    requiredMessage = 'This field is required',\n  } = config;\n\n  // Initialize form state\n  const [values, setFormValues] = useState<T>({...initialValues} as T);\n  const [touched, setFormTouched] = useState<Record<keyof T, boolean>>({} as Record<keyof T, boolean>);\n  const [errors, setFormErrors] = useState<Record<keyof T, string>>({} as Record<keyof T, string>);\n  const [isSubmitted, setIsSubmitted] = useState(false);\n\n  // Ref to track which fields have client-side validation rules. Errors injected via\n  // serErrors are not added here, so revalidateTouchedFields preserves server-side errors.\n  const clientErrorFieldRef = useRef(new Set<keyof T>());\n  // Get field configuration by name\n  const getFieldConfig: (name: keyof T) => FormField | undefined = useCallback(\n    (name: keyof T): FormField | undefined => fields.find((field: FormField) => field.name === name),\n    [fields],\n  );\n\n  // Validate a single field against currently-committed state. Used by the blur path\n  // (where `values` is already up-to-date) and by `validateForm`.\n  const validateField: (name: keyof T) => string | null = useCallback(\n    (name: keyof T): string | null => {\n      const value: string = values[name] || '';\n      const fieldConfig: FormField | undefined = getFieldConfig(name);\n      return computeFieldError(value, fieldConfig, requiredMessage);\n    },\n    [values, getFieldConfig, requiredMessage],\n  );\n\n  // \"Latest value\" ref so revalidateTouchedFields can read fresh validators without\n  // appearing in any effect dep array (avoids exhaustive-deps violations at call sites).\n  const validateFieldRef = useRef(validateField);\n  validateFieldRef.current = validateField;\n\n  // Re-translate all, client-validated error strings on language change.\n  // Stable identity ([] deps): uses only refs and the stable state setter.\n  const revalidateTouchedFields: () => void = useCallback((): void => {\n    setFormErrors((prevErrors: Record<keyof T, string>) => {\n      if (Object.keys(prevErrors).length === 0) return prevErrors;\n\n      const newErrors: Record<keyof T, string> = {...prevErrors};\n      let changed = false;\n\n      (Object.keys(prevErrors) as Array<keyof T>).forEach((name: keyof T) => {\n        // Skip errors that were not produced by client-side validation - preserve server messages.\n        if (!clientErrorFieldRef.current.has(name)) return;\n\n        const freshError: string | null = validateFieldRef.current(name);\n        if (freshError === prevErrors[name]) return;\n\n        changed = true;\n        if (freshError) {\n          newErrors[name] = freshError;\n        } else {\n          delete newErrors[name];\n          clientErrorFieldRef.current.delete(name);\n        }\n      });\n\n      return changed ? newErrors : prevErrors;\n    });\n  }, []);\n\n  // Validate the entire form\n  const validateForm: () => ValidationResult = useCallback((): ValidationResult => {\n    const newErrors: Record<keyof T, string> = {} as Record<keyof T, string>;\n\n    // Validate individual fields\n    fields.forEach((field: FormField) => {\n      const error: string | null = validateField(field.name as keyof T);\n      if (error) {\n        newErrors[field.name as keyof T] = error;\n      }\n    });\n\n    // Run global validator if provided\n    if (validator) {\n      const globalErrors: Record<string, string> = validator(values);\n      Object.keys(globalErrors).forEach((key: string) => {\n        if (globalErrors[key]) {\n          newErrors[key as keyof T] = globalErrors[key];\n        }\n      });\n    }\n\n    return {\n      errors: newErrors,\n      isValid: Object.keys(newErrors).length === 0,\n    };\n  }, [fields, validateField, validator, values]);\n\n  // Check if form is currently valid\n  const isValid: boolean = Object.keys(errors).length === 0;\n\n  // Set a single field value.\n  //\n  // Validation policy:\n  //  - `validateOnChange: true`               → validate on every keystroke.\n  //  - `revalidateOnChangeAfterBlur: true`    → validate only if the field has\n  //                                             already been touched (blurred once),\n  //                                             so errors clear as the user corrects\n  //                                             without appearing while first typing.\n  //  - both false                             → no on-change validation.\n  //\n  // Validation runs against the NEXT value (the string being written) rather than\n  // going through `validateField` which reads the stale closed-over `values`. This\n  // prevents the one-keystroke-lag bug where the error clears one character late.\n  const setValue: (name: keyof T, value: string) => void = useCallback(\n    (name: keyof T, value: string): void => {\n      setFormValues((prev: T) => ({\n        ...prev,\n        [name]: value,\n      }));\n\n      const shouldValidate: boolean = validateOnChange || (revalidateOnChangeAfterBlur && touched[name] === true);\n      if (!shouldValidate) {\n        return;\n      }\n\n      const error: string | null = computeFieldError(value, getFieldConfig(name), requiredMessage);\n      setFormErrors((prev: Record<keyof T, string>) => {\n        const newErrors: Record<keyof T, string> = {...prev};\n        if (error) {\n          newErrors[name] = error;\n          clientErrorFieldRef.current.add(name);\n        } else {\n          delete newErrors[name];\n          clientErrorFieldRef.current.delete(name);\n        }\n        return newErrors;\n      });\n    },\n    [validateOnChange, revalidateOnChangeAfterBlur, touched, getFieldConfig, requiredMessage],\n  );\n\n  // Set multiple field values\n  const setValues: (newValues: Partial<T>) => void = useCallback((newValues: Partial<T>): void => {\n    setFormValues((prev: T) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Mark a field as touched\n  const setTouched: (name: keyof T, isTouched?: boolean) => void = useCallback(\n    (name: keyof T, isTouched = true): void => {\n      setFormTouched((prev: Record<keyof T, boolean>) => ({\n        ...prev,\n        [name]: isTouched,\n      }));\n\n      // Validate on blur if enabled and field is touched\n      if (validateOnBlur && isTouched) {\n        const error: string | null = validateField(name);\n        setFormErrors((prev: Record<keyof T, string>) => {\n          const newErrors: Record<keyof T, string> = {...prev};\n          if (error) {\n            newErrors[name] = error;\n            clientErrorFieldRef.current.add(name);\n          } else {\n            delete newErrors[name];\n            clientErrorFieldRef.current.delete(name);\n          }\n          return newErrors;\n        });\n      }\n    },\n    [validateField, validateOnBlur],\n  );\n\n  // Set multiple touched fields\n  const setTouchedFields: (touchedFields: Partial<Record<keyof T, boolean>>) => void = useCallback(\n    (touchedFields: Partial<Record<keyof T, boolean>>): void => {\n      setFormTouched((prev: Record<keyof T, boolean>) => ({\n        ...prev,\n        ...touchedFields,\n      }));\n    },\n    [],\n  );\n\n  // Mark all fields as touched\n  const touchAllFields: () => void = useCallback((): void => {\n    const allTouched: Record<keyof T, boolean> = fields.reduce(\n      (acc: Record<keyof T, boolean>, field: FormField) => {\n        acc[field.name as keyof T] = true;\n        return acc;\n      },\n      {} as Record<keyof T, boolean>,\n    );\n\n    setFormTouched(allTouched);\n\n    // Validate all fields\n    const validation: ValidationResult = validateForm();\n    setFormErrors(validation.errors as Record<keyof T, string>);\n    clientErrorFieldRef.current = new Set(Object.keys(validation.errors) as Array<keyof T>);\n  }, [fields, validateForm]);\n\n  // Set a field error\n  const setError: (name: keyof T, error: string) => void = useCallback((name: keyof T, error: string): void => {\n    setFormErrors((prev: Record<keyof T, string>) => ({\n      ...prev,\n      [name]: error,\n    }));\n  }, []);\n\n  // Set multiple field errors\n  const setErrors: (newErrors: Partial<Record<keyof T, string>>) => void = useCallback(\n    (newErrors: Partial<Record<keyof T, string>>): void => {\n      setFormErrors((prev: Record<keyof T, string>) => ({\n        ...prev,\n        ...newErrors,\n      }));\n    },\n    [],\n  );\n\n  // Clear all errors\n  const clearErrors: () => void = useCallback((): void => {\n    setFormErrors({} as Record<keyof T, string>);\n    clientErrorFieldRef.current.clear();\n  }, []);\n\n  // Reset form to initial state\n  const reset: () => void = useCallback((): void => {\n    setFormValues({...initialValues} as T);\n    setFormTouched({} as Record<keyof T, boolean>);\n    setFormErrors({} as Record<keyof T, string>);\n    setIsSubmitted(false);\n    clientErrorFieldRef.current.clear();\n  }, [initialValues]);\n\n  // Handle form submission\n  const handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void> = useCallback(\n    (onSubmit: (values: T) => void | Promise<void>) =>\n      async (e?: FormEvent): Promise<void> => {\n        if (e) {\n          e.preventDefault();\n        }\n\n        setIsSubmitted(true);\n        touchAllFields();\n\n        const validation: ValidationResult = validateForm();\n\n        if (validation.isValid) {\n          await onSubmit(values);\n        }\n      },\n    [values, touchAllFields, validateForm],\n  );\n\n  // Get field props for easy integration\n  const getFieldProps: (name: keyof T) => any = useCallback(\n    (name: keyof T) => {\n      const fieldConfig: FormField | undefined = getFieldConfig(name);\n\n      return {\n        error: touched[name] ? errors[name] : undefined,\n        name,\n        onBlur: (): void => setTouched(name, true),\n        onChange: (value: string): void => setValue(name, value),\n        required: fieldConfig?.required || false,\n        touched: touched[name] || false,\n        value: values[name] || '',\n      };\n    },\n    [values, errors, touched, setValue, setTouched, getFieldConfig],\n  );\n\n  return {\n    clearErrors,\n    errors,\n    getFieldProps,\n    handleSubmit,\n    isSubmitted,\n    isValid,\n    reset,\n    revalidateTouchedFields,\n    setError,\n    setErrors,\n    setTouched,\n    setTouchedFields,\n    setValue,\n    setValues,\n    touchAllFields,\n    touched,\n    validateField,\n    validateForm,\n    values,\n  };\n};\n\nexport default useForm;\n"],"mappings":"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"}
+{"version":3,"file":"useForm.js","names":["fieldError: string | null","getFieldConfig: (name: keyof T) => FormField | undefined","validateField: (name: keyof T) => string | null","revalidateTouchedFields: () => void","newErrors: Record<keyof T, string>","freshError: string | null","validateForm: () => ValidationResult","error: string | null","globalErrors: Record<string, string>","isValid: boolean","setValue: (name: keyof T, value: string) => void","setValues: (newValues: Partial<T>) => void","setTouched: (name: keyof T, isTouched?: boolean) => void","setTouchedFields: (touchedFields: Partial<Record<keyof T, boolean>>) => void","touchAllFields: () => void","validation: ValidationResult","setError: (name: keyof T, error: string) => void","setErrors: (newErrors: Partial<Record<keyof T, string>>) => void","clearErrors: () => void","reset: () => void","handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>","fieldConfig: FormField | undefined"],"sources":["../../src/hooks/useForm.ts"],"sourcesContent":["// Copyright 2025 The ThunderID Authors\n// SPDX-License-Identifier: Apache-2.0\n\nimport {useState, useCallback, useRef, FormEvent} from 'react';\n\n/**\n * Generic form field configuration\n */\nexport interface FormField {\n  initialValue?: string;\n  name: string;\n  required?: boolean;\n  validator?: (value: string) => string | null;\n}\n\n/**\n * Form validation result\n */\nexport interface ValidationResult {\n  errors: Record<string, string>;\n  isValid: boolean;\n}\n\n/**\n * Configuration for the useForm hook\n */\nexport interface UseFormConfig<T extends Record<string, string>> {\n  /**\n   * Form field definitions\n   */\n  fields?: FormField[];\n  /**\n   * Initial form values\n   */\n  initialValues?: Partial<T>;\n  /**\n   * Custom required field validation message\n   */\n  requiredMessage?: string;\n  /**\n   * When a field has been touched (blurred at least once), re-run validation on every\n   * subsequent change so a rendered error clears the moment the value becomes valid.\n   *\n   * Independent of `validateOnChange`: this only affects fields that have already been\n   * blurred, so users don't see errors while initially typing. Default `false` to\n   * preserve prior behavior; enable per-form for a \"correct-as-you-type\" UX.\n   */\n  revalidateOnChangeAfterBlur?: boolean;\n  /**\n   * Whether to validate on blur (default: true)\n   */\n  validateOnBlur?: boolean;\n  /**\n   * Whether to validate on change (default: false). When true, every keystroke\n   * triggers validation — including the first, which surfaces errors before the user\n   * has had a chance to finish typing. Prefer `revalidateOnChangeAfterBlur` for the\n   * common \"clear the error as the user corrects\" UX.\n   */\n  validateOnChange?: boolean;\n  /**\n   * Global form validator function\n   */\n  validator?: (values: T) => Record<string, string>;\n}\n\n/**\n * Pure per-field validator. Kept outside `useForm` so `setValue` can validate against\n * the value it just wrote — inline validation via the closure-based `validateField`\n * inside the hook would read stale `values` (state is committed asynchronously).\n */\nconst computeFieldError = (\n  value: string,\n  fieldConfig: FormField | undefined,\n  requiredMessage: string,\n): string | null => {\n  if (fieldConfig?.required && (!value || value.trim() === '')) {\n    return requiredMessage;\n  }\n  if (fieldConfig?.validator) {\n    const fieldError: string | null = fieldConfig.validator(value);\n    if (fieldError) return fieldError;\n  }\n  return null;\n};\n\n/**\n * Return type for the useForm hook\n */\nexport interface UseFormReturn<T extends Record<string, string>> {\n  /**\n   * Clear all errors\n   */\n  clearErrors: () => void;\n  /**\n   * Current validation errors\n   */\n  errors: Record<keyof T, string>;\n  /**\n   * Get field props for easy integration with form components\n   */\n  getFieldProps: (name: keyof T) => {\n    error: string | undefined;\n    name: keyof T;\n    onBlur: () => void;\n    onChange: (value: string) => void;\n    required: boolean;\n    touched: boolean;\n    value: string;\n  };\n  /**\n   * Handle form submission\n   */\n  handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>;\n  /**\n   * Whether the form has been submitted\n   */\n  isSubmitted: boolean;\n  /**\n   * Whether the form is currently valid\n   */\n  isValid: boolean;\n  /**\n   * Reset the form to initial values\n   */\n  reset: () => void;\n  /**\n   * Set a field error\n   */\n  setError: (name: keyof T, error: string) => void;\n  /**\n   * Set multiple field errors\n   */\n  setErrors: (errors: Partial<Record<keyof T, string>>) => void;\n  /**\n   * Mark a field as touched\n   */\n  setTouched: (name: keyof T, touched?: boolean) => void;\n  /**\n   * Mark multiple fields as touched\n   */\n  setTouchedFields: (touched: Partial<Record<keyof T, boolean>>) => void;\n  /**\n   * Set a single field value\n   */\n  setValue: (name: keyof T, value: string) => void;\n  /**\n   * Set multiple field values\n   */\n  setValues: (values: Partial<T>) => void;\n  /**\n   * Mark all fields as touched\n   */\n  touchAllFields: () => void;\n  /**\n   * Fields that have been touched by the user\n   */\n  touched: Record<keyof T, boolean>;\n  /**\n   * Validate a single field\n   */\n  validateField: (name: keyof T) => string | null;\n  /**\n   * Validate all fields\n   */\n  validateForm: () => ValidationResult;\n  /**\n   * Re-run validation for all touched fields that have a client-side config,\n   * refreshing stored error strings to the current language.\n   */\n  revalidateTouchedFields: () => void;\n  /**\n   * Current form values\n   */\n  values: T;\n}\n\n/**\n * Generic form hook that provides comprehensive form state management and validation.\n *\n * @template T - The type of form values (must extend Record<string, string>)\n * @param config - Configuration options for the form\n * @returns Form state and methods\n *\n * @example\n * ```tsx\n * interface LoginForm {\n *   username: string;\n *   password: string;\n * }\n *\n * const {\n *   values,\n *   touched,\n *   errors,\n *   isValid,\n *   setValue,\n *   handleSubmit,\n *   getFieldProps\n * } = useForm<LoginForm>({\n *   initialValues: { username: '', password: '' },\n *   fields: [\n *     { name: 'username', required: true },\n *     { name: 'password', required: true }\n *   ]\n * });\n *\n * const onSubmit = handleSubmit((values) => {\n *   console.log('Form submitted:', values);\n * });\n *\n * return (\n *   <form onSubmit={onSubmit}>\n *     <input {...getFieldProps('username')} />\n *     <input {...getFieldProps('password')} type=\"password\" />\n *     <button type=\"submit\" disabled={!isValid}>Submit</button>\n *   </form>\n * );\n * ```\n */\nexport const useForm = <T extends Record<string, string>>(config: UseFormConfig<T> = {}): UseFormReturn<T> => {\n  const {\n    initialValues = {} as T,\n    fields = [],\n    validator,\n    validateOnChange = false,\n    validateOnBlur = true,\n    revalidateOnChangeAfterBlur = false,\n    requiredMessage = 'This field is required',\n  } = config;\n\n  // Initialize form state\n  const [values, setFormValues] = useState<T>({...initialValues} as T);\n  const [touched, setFormTouched] = useState<Record<keyof T, boolean>>({} as Record<keyof T, boolean>);\n  const [errors, setFormErrors] = useState<Record<keyof T, string>>({} as Record<keyof T, string>);\n  const [isSubmitted, setIsSubmitted] = useState(false);\n\n  // Ref to track which fields have client-side validation rules. Errors injected via\n  // serErrors are not added here, so revalidateTouchedFields preserves server-side errors.\n  const clientErrorFieldRef = useRef(new Set<keyof T>());\n  // Get field configuration by name\n  const getFieldConfig: (name: keyof T) => FormField | undefined = useCallback(\n    (name: keyof T): FormField | undefined => fields.find((field: FormField) => field.name === name),\n    [fields],\n  );\n\n  // Validate a single field against currently-committed state. Used by the blur path\n  // (where `values` is already up-to-date) and by `validateForm`.\n  const validateField: (name: keyof T) => string | null = useCallback(\n    (name: keyof T): string | null => {\n      const value: string = values[name] || '';\n      const fieldConfig: FormField | undefined = getFieldConfig(name);\n      return computeFieldError(value, fieldConfig, requiredMessage);\n    },\n    [values, getFieldConfig, requiredMessage],\n  );\n\n  // \"Latest value\" ref so revalidateTouchedFields can read fresh validators without\n  // appearing in any effect dep array (avoids exhaustive-deps violations at call sites).\n  const validateFieldRef = useRef(validateField);\n  validateFieldRef.current = validateField;\n\n  // Re-translate all, client-validated error strings on language change.\n  // Stable identity ([] deps): uses only refs and the stable state setter.\n  const revalidateTouchedFields: () => void = useCallback((): void => {\n    setFormErrors((prevErrors: Record<keyof T, string>) => {\n      if (Object.keys(prevErrors).length === 0) return prevErrors;\n\n      const newErrors: Record<keyof T, string> = {...prevErrors};\n      let changed = false;\n\n      (Object.keys(prevErrors) as (keyof T)[]).forEach((name: keyof T) => {\n        // Skip errors that were not produced by client-side validation - preserve server messages.\n        if (!clientErrorFieldRef.current.has(name)) return;\n\n        const freshError: string | null = validateFieldRef.current(name);\n        if (freshError === prevErrors[name]) return;\n\n        changed = true;\n        if (freshError) {\n          newErrors[name] = freshError;\n        } else {\n          delete newErrors[name];\n          clientErrorFieldRef.current.delete(name);\n        }\n      });\n\n      return changed ? newErrors : prevErrors;\n    });\n  }, []);\n\n  // Validate the entire form\n  const validateForm: () => ValidationResult = useCallback((): ValidationResult => {\n    const newErrors: Record<keyof T, string> = {} as Record<keyof T, string>;\n\n    // Validate individual fields\n    fields.forEach((field: FormField) => {\n      const error: string | null = validateField(field.name as keyof T);\n      if (error) {\n        newErrors[field.name as keyof T] = error;\n      }\n    });\n\n    // Run global validator if provided\n    if (validator) {\n      const globalErrors: Record<string, string> = validator(values);\n      Object.keys(globalErrors).forEach((key: string) => {\n        if (globalErrors[key]) {\n          newErrors[key as keyof T] = globalErrors[key];\n        }\n      });\n    }\n\n    return {\n      errors: newErrors,\n      isValid: Object.keys(newErrors).length === 0,\n    };\n  }, [fields, validateField, validator, values]);\n\n  // Check if form is currently valid\n  const isValid: boolean = Object.keys(errors).length === 0;\n\n  // Set a single field value.\n  //\n  // Validation policy:\n  //  - `validateOnChange: true`               → validate on every keystroke.\n  //  - `revalidateOnChangeAfterBlur: true`    → validate only if the field has\n  //                                             already been touched (blurred once),\n  //                                             so errors clear as the user corrects\n  //                                             without appearing while first typing.\n  //  - both false                             → no on-change validation.\n  //\n  // Validation runs against the NEXT value (the string being written) rather than\n  // going through `validateField` which reads the stale closed-over `values`. This\n  // prevents the one-keystroke-lag bug where the error clears one character late.\n  const setValue: (name: keyof T, value: string) => void = useCallback(\n    (name: keyof T, value: string): void => {\n      setFormValues((prev: T) => ({\n        ...prev,\n        [name]: value,\n      }));\n\n      const shouldValidate: boolean = validateOnChange || (revalidateOnChangeAfterBlur && touched[name] === true);\n      if (!shouldValidate) {\n        return;\n      }\n\n      const error: string | null = computeFieldError(value, getFieldConfig(name), requiredMessage);\n      setFormErrors((prev: Record<keyof T, string>) => {\n        const newErrors: Record<keyof T, string> = {...prev};\n        if (error) {\n          newErrors[name] = error;\n          clientErrorFieldRef.current.add(name);\n        } else {\n          delete newErrors[name];\n          clientErrorFieldRef.current.delete(name);\n        }\n        return newErrors;\n      });\n    },\n    [validateOnChange, revalidateOnChangeAfterBlur, touched, getFieldConfig, requiredMessage],\n  );\n\n  // Set multiple field values\n  const setValues: (newValues: Partial<T>) => void = useCallback((newValues: Partial<T>): void => {\n    setFormValues((prev: T) => ({\n      ...prev,\n      ...newValues,\n    }));\n  }, []);\n\n  // Mark a field as touched\n  const setTouched: (name: keyof T, isTouched?: boolean) => void = useCallback(\n    (name: keyof T, isTouched = true): void => {\n      setFormTouched((prev: Record<keyof T, boolean>) => ({\n        ...prev,\n        [name]: isTouched,\n      }));\n\n      // Validate on blur if enabled and field is touched\n      if (validateOnBlur && isTouched) {\n        const error: string | null = validateField(name);\n        setFormErrors((prev: Record<keyof T, string>) => {\n          const newErrors: Record<keyof T, string> = {...prev};\n          if (error) {\n            newErrors[name] = error;\n            clientErrorFieldRef.current.add(name);\n          } else {\n            delete newErrors[name];\n            clientErrorFieldRef.current.delete(name);\n          }\n          return newErrors;\n        });\n      }\n    },\n    [validateField, validateOnBlur],\n  );\n\n  // Set multiple touched fields\n  const setTouchedFields: (touchedFields: Partial<Record<keyof T, boolean>>) => void = useCallback(\n    (touchedFields: Partial<Record<keyof T, boolean>>): void => {\n      setFormTouched((prev: Record<keyof T, boolean>) => ({\n        ...prev,\n        ...touchedFields,\n      }));\n    },\n    [],\n  );\n\n  // Mark all fields as touched\n  const touchAllFields: () => void = useCallback((): void => {\n    const allTouched: Record<keyof T, boolean> = fields.reduce(\n      (acc: Record<keyof T, boolean>, field: FormField) => {\n        acc[field.name as keyof T] = true;\n        return acc;\n      },\n      {} as Record<keyof T, boolean>,\n    );\n\n    setFormTouched(allTouched);\n\n    // Validate all fields\n    const validation: ValidationResult = validateForm();\n    setFormErrors(validation.errors as Record<keyof T, string>);\n    clientErrorFieldRef.current = new Set(Object.keys(validation.errors) as (keyof T)[]);\n  }, [fields, validateForm]);\n\n  // Set a field error\n  const setError: (name: keyof T, error: string) => void = useCallback((name: keyof T, error: string): void => {\n    setFormErrors((prev: Record<keyof T, string>) => ({\n      ...prev,\n      [name]: error,\n    }));\n  }, []);\n\n  // Set multiple field errors\n  const setErrors: (newErrors: Partial<Record<keyof T, string>>) => void = useCallback(\n    (newErrors: Partial<Record<keyof T, string>>): void => {\n      setFormErrors((prev: Record<keyof T, string>) => ({\n        ...prev,\n        ...newErrors,\n      }));\n    },\n    [],\n  );\n\n  // Clear all errors\n  const clearErrors: () => void = useCallback((): void => {\n    setFormErrors({} as Record<keyof T, string>);\n    clientErrorFieldRef.current.clear();\n  }, []);\n\n  // Reset form to initial state\n  const reset: () => void = useCallback((): void => {\n    setFormValues({...initialValues} as T);\n    setFormTouched({} as Record<keyof T, boolean>);\n    setFormErrors({} as Record<keyof T, string>);\n    setIsSubmitted(false);\n    clientErrorFieldRef.current.clear();\n  }, [initialValues]);\n\n  // Handle form submission\n  const handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void> = useCallback(\n    (onSubmit: (values: T) => void | Promise<void>) =>\n      async (e?: FormEvent): Promise<void> => {\n        if (e) {\n          e.preventDefault();\n        }\n\n        setIsSubmitted(true);\n        touchAllFields();\n\n        const validation: ValidationResult = validateForm();\n\n        if (validation.isValid) {\n          await onSubmit(values);\n        }\n      },\n    [values, touchAllFields, validateForm],\n  );\n\n  // Get field props for easy integration\n  const getFieldProps: (name: keyof T) => any = useCallback(\n    (name: keyof T) => {\n      const fieldConfig: FormField | undefined = getFieldConfig(name);\n\n      return {\n        error: touched[name] ? errors[name] : undefined,\n        name,\n        onBlur: (): void => setTouched(name, true),\n        onChange: (value: string): void => setValue(name, value),\n        required: fieldConfig?.required || false,\n        touched: touched[name] || false,\n        value: values[name] || '',\n      };\n    },\n    [values, errors, touched, setValue, setTouched, getFieldConfig],\n  );\n\n  return {\n    clearErrors,\n    errors,\n    getFieldProps,\n    handleSubmit,\n    isSubmitted,\n    isValid,\n    reset,\n    revalidateTouchedFields,\n    setError,\n    setErrors,\n    setTouched,\n    setTouchedFields,\n    setValue,\n    setValues,\n    touchAllFields,\n    touched,\n    validateField,\n    validateForm,\n    values,\n  };\n};\n\nexport default useForm;\n"],"mappings":"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"}