@thunderid/react 0.0.1

package/dist/contexts/ThunderID/ThunderIDProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThunderIDProvider.d.ts","sourceRoot":"","sources":["../../../src/contexts/ThunderID/ThunderIDProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,OAAO,EAAC,EAAE,EAAa,iBAAiB,EAAkE,MAAM,OAAO,CAAC;AAGxH,OAAO,EAAC,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AAgBzD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE1D,QAAA,MAAM,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CA6pBpE,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/contexts/ThunderID/useThunderID.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { ThunderIDContextProps } from './ThunderIDContext';
+declare const useThunderID: () => ThunderIDContextProps;
+export default useThunderID;
+//# sourceMappingURL=useThunderID.d.ts.map

package/dist/contexts/ThunderID/useThunderID.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThunderID.d.ts","sourceRoot":"","sources":["../../../src/contexts/ThunderID/useThunderID.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAyB,EAAC,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAI3E,QAAA,MAAM,YAAY,QAAO,qBA6BxB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/contexts/User/UserContext.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { User, Schema, UpdateMeProfileConfig } from '@thunderid/browser';
+import { Context } from 'react';
+/**
+ * Props interface of {@link UserContext}
+ */
+export interface UserContextProps {
+    flattenedProfile: User | null;
+    onUpdateProfile: (payload: User) => void;
+    profile: User | null;
+    revalidateProfile: () => Promise<void>;
+    schemas: Schema[] | null;
+    updateProfile: (requestConfig: UpdateMeProfileConfig, sessionId?: string) => Promise<{
+        data: {
+            user: User;
+        };
+        error: string;
+        success: boolean;
+    }>;
+}
+/**
+ * Context object for managing user profile data and related operations.
+ */
+declare const UserContext: Context<UserContextProps | null>;
+export default UserContext;
+//# sourceMappingURL=UserContext.d.ts.map

package/dist/contexts/User/UserContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserContext.d.ts","sourceRoot":"","sources":["../../../src/contexts/User/UserContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAC,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAC,OAAO,EAAgB,MAAM,OAAO,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,CACb,aAAa,EAAE,qBAAqB,EACpC,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC;QAAC,IAAI,EAAE;YAAC,IAAI,EAAE,IAAI,CAAA;SAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,QAAA,MAAM,WAAW,EAAE,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAOhD,CAAC;AAIH,eAAe,WAAW,CAAC"}

package/dist/contexts/User/UserProvider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { UpdateMeProfileConfig, User, UserProfile } from '@thunderid/browser';
+import { FC, PropsWithChildren } from 'react';
+/**
+ * Props interface of {@link UserProvider}
+ */
+export interface UserProviderProps {
+    onUpdateProfile?: (payload: User) => void;
+    profile: UserProfile;
+    revalidateProfile?: () => Promise<void>;
+    updateProfile?: (requestConfig: UpdateMeProfileConfig, sessionId?: string) => Promise<{
+        data: {
+            user: User;
+        };
+        error: string;
+        success: boolean;
+    }>;
+}
+/**
+ * UserProvider component that manages user profile data and provides it through UserContext.
+ *
+ * This provider:
+ * - Fetches user profile data from the ME endpoint
+ * - Retrieves SCIM2 schemas for profile structure
+ * - Generates both nested and flattened user profiles
+ * - Provides functions for refreshing and updating user data
+ * - Handles loading states and errors
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <UserProvider>
+ *   <App />
+ * </UserProvider>
+ *
+ * // With custom error handling
+ * <UserProvider onError={(error) => console.error('User error:', error)}>
+ *   <App />
+ * </UserProvider>
+ *
+ * // Disable auto-fetch (fetch manually using refreshUser)
+ * <UserProvider autoFetch={false}>
+ *   <App />
+ * </UserProvider>
+ * ```
+ */
+declare const UserProvider: FC<PropsWithChildren<UserProviderProps>>;
+export default UserProvider;
+//# sourceMappingURL=UserProvider.d.ts.map

package/dist/contexts/User/UserProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserProvider.d.ts","sourceRoot":"","sources":["../../../src/contexts/User/UserProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAC,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAC,EAAE,EAAE,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAGnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,CACd,aAAa,EAAE,qBAAqB,EACpC,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC;QAAC,IAAI,EAAE;YAAC,IAAI,EAAE,IAAI,CAAA;SAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAC,CAAC,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,QAAA,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAoB1D,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/contexts/User/useUser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { UserContextProps } from './UserContext';
+/**
+ * Hook to access the User context.
+ *
+ * This hook provides access to user profile data including:
+ * - Raw profile API response
+ * - SCIM2 schemas
+ * - Nested user object
+ * - Flattened user profile
+ * - Functions to refresh and update user data
+ * - Loading states and error handling
+ *
+ * @returns {UserContextProps} The user context value containing all user-related data and functions
+ * @throws {Error} Throws an error if used outside of UserProvider
+ *
+ * @example
+ * ```tsx
+ * import {useUser} from '@thunderid/react';
+ *
+ * function ProfileComponent() {
+ *   const {
+ *     isLoading,
+ *     profile,
+ *     schemas,
+ *     user,
+ *     flattenedUser,
+ *     refreshUser,
+ *     updateUser,
+ *     error
+ *   } = useUser();
+ *
+ *   if (isLoading) {
+ *     return <div>Loading user data...</div>;
+ *   }
+ *
+ *   if (error) {
+ *     return <div>Error: {error.message}</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h1>Welcome {user?.name?.givenName}!</h1>
+ *       <p>Email: {flattenedUser?.emails}</p>
+ *       <button onClick={refreshUser}>Refresh Profile</button>
+ *     </div>
+ *   );
+ * }
+ *
+ * // Access specific user properties
+ * function UserEmail() {
+ *   const {flattenedUser} = useUser();
+ *   return <span>{flattenedUser?.emails?.[0]}</span>;
+ * }
+ *
+ * // Update user profile
+ * function EditProfile() {
+ *   const {updateUser, user} = useUser();
+ *
+ *   const handleUpdate = async () => {
+ *     try {
+ *       await updateUser({
+ *         name: {
+ *           givenName: 'John',
+ *           familyName: 'Doe'
+ *         }
+ *       });
+ *     } catch (error) {
+ *       console.error('Update failed:', error);
+ *     }
+ *   };
+ *
+ *   return <button onClick={handleUpdate}>Update Name</button>;
+ * }
+ * ```
+ */
+declare const useUser: () => UserContextProps;
+export default useUser;
+//# sourceMappingURL=useUser.d.ts.map

package/dist/contexts/User/useUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUser.d.ts","sourceRoot":"","sources":["../../../src/contexts/User/useUser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAoB,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,QAAA,MAAM,OAAO,QAAO,gBAQnB,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/hooks/useBranding.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { BrandingPreference, Theme } from '@thunderid/browser';
+/**
+ * Configuration options for the useBranding hook
+ * @deprecated Use BrandingProvider instead for better performance and consistency
+ */
+export interface UseBrandingConfig {
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    autoFetch?: boolean;
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    fetcher?: (url: string, config: RequestInit) => Promise<Response>;
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    forceTheme?: 'light' | 'dark';
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    locale?: string;
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    name?: string;
+    /**
+     * @deprecated This configuration is now handled by BrandingProvider
+     */
+    type?: string;
+}
+/**
+ * Return type of the useBranding hook
+ */
+export interface UseBrandingReturn {
+    /**
+     * The active theme mode from branding preference ('light' | 'dark')
+     */
+    activeTheme: 'light' | 'dark' | null;
+    /**
+     * The raw branding preference data
+     */
+    brandingPreference: BrandingPreference | null;
+    /**
+     * Error state
+     */
+    error: Error | null;
+    /**
+     * Function to manually fetch branding preference
+     */
+    fetchBranding: () => Promise<void>;
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Function to refetch branding preference
+     * This bypasses the single-call restriction and forces a new API call
+     */
+    refetch: () => Promise<void>;
+    /**
+     * The transformed theme object
+     */
+    theme: Theme | null;
+}
+/**
+ * React hook for accessing branding preferences from the BrandingProvider context.
+ * This hook provides access to branding preferences, theme data, and loading states.
+ *
+ * @deprecated Consider using useBrandingContext directly for better performance.
+ * This hook is maintained for backward compatibility.
+ *
+ * @param config - Configuration options (deprecated, use BrandingProvider props instead)
+ * @returns Object containing branding preference data, theme, loading state, error, and refetch function
+ *
+ * @example
+ * Basic usage:
+ * ```tsx
+ * function MyComponent() {
+ *   const { theme, activeTheme, isLoading, error } = useBranding();
+ *
+ *   if (isLoading) return <div>Loading branding...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div style={{ color: theme?.colors?.primary?.main }}>
+ *       <p>Active theme mode: {activeTheme}</p>
+ *       <p>Styled with ThunderID branding</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * For new implementations, use BrandingProvider with useBrandingContext:
+ * ```tsx
+ * // In your root component
+ * <BrandingProvider baseUrl="https://api.asgardeo.io/t/your-org">
+ *   <App />
+ * </BrandingProvider>
+ *
+ * // In your component
+ * function MyComponent() {
+ *   const { theme, activeTheme, isLoading, error } = useBrandingContext();
+ *   // ... rest of your component
+ * }
+ * ```
+ */
+export declare const useBranding: () => UseBrandingReturn;
+export default useBranding;
+//# sourceMappingURL=useBranding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBranding.d.ts","sourceRoot":"","sources":["../../src/hooks/useBranding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAC,kBAAkB,EAAE,KAAK,EAA+B,MAAM,oBAAoB,CAAC;AAQ3F;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC;;OAEG;IACH,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,WAAW,QAAO,iBAmB9B,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/hooks/useBrowserUrl.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+/**
+ * Interface for the useBrowserUrl hook return value.
+ */
+export interface UseBrowserUrl {
+    /**
+     * Checks if the current URL contains authentication parameters.
+     *
+     * @param url - The URL object to check for authentication parameters
+     * @param afterSignInUrl - The URL where the authorization server should redirect after authentication
+     * @returns True if the URL contains authentication parameters and matches the afterSignInUrl, or if it contains an error parameter
+     */
+    hasAuthParams: (url: URL, afterSignInUrl: string) => boolean;
+    /**
+     * Checks if the URL indicates that the authentication flow has been called for this instance.
+     *
+     * @param url - The URL object to check
+     * @param instanceId - The instance ID to check against
+     * @returns True if the URL indicates the flow has been called for this instance
+     */
+    hasCalledForThisInstance: (url: URL, instanceId: number) => boolean;
+}
+/**
+ * Hook that provides utilities for handling browser URLs in authentication flows.
+ *
+ * @returns An object containing URL utility functions
+ *
+ * @example
+ * ```tsx
+ * const { hasAuthParams } = useBrowserUrl();
+ * const url = new URL(window.location.href);
+ *
+ * if (hasAuthParams(url, "/after-signin")) {
+ *   // Handle authentication callback
+ * }
+ * ```
+ */
+declare const useBrowserUrl: () => UseBrowserUrl;
+export default useBrowserUrl;
+//# sourceMappingURL=useBrowserUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBrowserUrl.d.ts","sourceRoot":"","sources":["../../src/hooks/useBrowserUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC;IAE7D;;;;;;OAMG;IACH,wBAAwB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CACrE;AAED;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,aAAa,QAAO,aAUzB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/useForm.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FormEvent } from 'react';
+/**
+ * Generic form field configuration
+ */
+export interface FormField {
+    initialValue?: string;
+    name: string;
+    required?: boolean;
+    validator?: (value: string) => string | null;
+}
+/**
+ * Form validation result
+ */
+export interface ValidationResult {
+    errors: Record<string, string>;
+    isValid: boolean;
+}
+/**
+ * Configuration for the useForm hook
+ */
+export interface UseFormConfig<T extends Record<string, string>> {
+    /**
+     * Form field definitions
+     */
+    fields?: FormField[];
+    /**
+     * Initial form values
+     */
+    initialValues?: Partial<T>;
+    /**
+     * Custom required field validation message
+     */
+    requiredMessage?: string;
+    /**
+     * Whether to validate on blur (default: true)
+     */
+    validateOnBlur?: boolean;
+    /**
+     * Whether to validate on change (default: false)
+     */
+    validateOnChange?: boolean;
+    /**
+     * Global form validator function
+     */
+    validator?: (values: T) => Record<string, string>;
+}
+/**
+ * Return type for the useForm hook
+ */
+export interface UseFormReturn<T extends Record<string, string>> {
+    /**
+     * Clear all errors
+     */
+    clearErrors: () => void;
+    /**
+     * Current validation errors
+     */
+    errors: Record<keyof T, string>;
+    /**
+     * Get field props for easy integration with form components
+     */
+    getFieldProps: (name: keyof T) => {
+        error: string | undefined;
+        name: keyof T;
+        onBlur: () => void;
+        onChange: (value: string) => void;
+        required: boolean;
+        touched: boolean;
+        value: string;
+    };
+    /**
+     * Handle form submission
+     */
+    handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: FormEvent) => Promise<void>;
+    /**
+     * Whether the form has been submitted
+     */
+    isSubmitted: boolean;
+    /**
+     * Whether the form is currently valid
+     */
+    isValid: boolean;
+    /**
+     * Reset the form to initial values
+     */
+    reset: () => void;
+    /**
+     * Set a field error
+     */
+    setError: (name: keyof T, error: string) => void;
+    /**
+     * Set multiple field errors
+     */
+    setErrors: (errors: Partial<Record<keyof T, string>>) => void;
+    /**
+     * Mark a field as touched
+     */
+    setTouched: (name: keyof T, touched?: boolean) => void;
+    /**
+     * Mark multiple fields as touched
+     */
+    setTouchedFields: (touched: Partial<Record<keyof T, boolean>>) => void;
+    /**
+     * Set a single field value
+     */
+    setValue: (name: keyof T, value: string) => void;
+    /**
+     * Set multiple field values
+     */
+    setValues: (values: Partial<T>) => void;
+    /**
+     * Mark all fields as touched
+     */
+    touchAllFields: () => void;
+    /**
+     * Fields that have been touched by the user
+     */
+    touched: Record<keyof T, boolean>;
+    /**
+     * Validate a single field
+     */
+    validateField: (name: keyof T) => string | null;
+    /**
+     * Validate all fields
+     */
+    validateForm: () => ValidationResult;
+    /**
+     * Current form values
+     */
+    values: T;
+}
+/**
+ * Generic form hook that provides comprehensive form state management and validation.
+ *
+ * @template T - The type of form values (must extend Record<string, string>)
+ * @param config - Configuration options for the form
+ * @returns Form state and methods
+ *
+ * @example
+ * ```tsx
+ * interface LoginForm {
+ *   username: string;
+ *   password: string;
+ * }
+ *
+ * const {
+ *   values,
+ *   touched,
+ *   errors,
+ *   isValid,
+ *   setValue,
+ *   handleSubmit,
+ *   getFieldProps
+ * } = useForm<LoginForm>({
+ *   initialValues: { username: '', password: '' },
+ *   fields: [
+ *     { name: 'username', required: true },
+ *     { name: 'password', required: true }
+ *   ]
+ * });
+ *
+ * const onSubmit = handleSubmit((values) => {
+ *   console.log('Form submitted:', values);
+ * });
+ *
+ * return (
+ *   <form onSubmit={onSubmit}>
+ *     <input {...getFieldProps('username')} />
+ *     <input {...getFieldProps('password')} type="password" />
+ *     <button type="submit" disabled={!isValid}>Submit</button>
+ *   </form>
+ * );
+ * ```
+ */
+export declare const useForm: <T extends Record<string, string>>(config?: UseFormConfig<T>) => UseFormReturn<T>;
+export default useForm;
+//# sourceMappingURL=useForm.d.ts.map

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

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