doct-ui-auth-kit 1.0.3 → 1.0.5

package/README.md

@@ -14,6 +14,21 @@ Peer dependencies (install in your app if not already present):
 npm install react react-dom docthub-core-components react-hook-form zod
 ```
 
+## Global styles
+
+Import the kit CSS once in your app (e.g. in `main.tsx` or `_app.tsx`) so Tailwind and base styles apply:
+
+```tsx
+import 'doct-ui-auth-kit/style.css';
+```
+
+If you use `docthub-core-components`, import its styles first, then the auth kit:
+
+```tsx
+import 'docthub-core-components/style.css';
+import 'doct-ui-auth-kit/style.css';
+```
+
 ## Consumer imports
 
 Install the package and import components, layouts, and types from the library:

package/dist/auth-methods/apple.d.ts

@@ -14,6 +14,6 @@ export interface UseAppleSignInOptions {
  * Stub: Apple Sign-In hook. Not implemented yet.
  * Use adapter.authenticateWithProvider({ provider: 'apple', credential }) when you have the token.
  */
-export declare function useAppleSignIn(_options: UseAppleSignInOptions): {
+export declare function useAppleSignIn(options: UseAppleSignInOptions): {
     triggerSignIn: () => void;
 };

package/dist/auth-methods/index.d.ts

@@ -1 +1,2 @@
+export { type UseAppleSignInOptions, useAppleSignIn, } from './apple';
 export { type UseGoogleAuthOptions, type UseGoogleAuthReturn, useGoogleAuth, } from './google';

package/dist/components/form/rhf-doct-phone-input.d.ts

@@ -1,2 +1,2 @@
 import type { RHFDoctPhoneInputFieldProps } from '@/types/forms';
-export declare function RHFDoctPhoneInputField({ name, label, placeholder, helperText, defaultCountry, variant, required, disabled, control, error, }: RHFDoctPhoneInputFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function RHFDoctPhoneInputField({ name, label, placeholder, helperText, defaultCountry, variant, required, disabled, control, error, autoFocus, }: RHFDoctPhoneInputFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/form/rhf-input-field.d.ts

@@ -1,2 +1,2 @@
 import type { RHFInputFieldProps } from '@/types/forms';
-export declare function RHFInputField({ name, label, placeholder, className, control, required, type, disabled, onKeyDown, maxLength, numericOnly, }: RHFInputFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function RHFInputField({ name, label, placeholder, className, control, required, type, disabled, onKeyDown, maxLength, numericOnly, autoFocus, }: RHFInputFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/form/rhf-otp-input-field.d.ts

@@ -1,2 +1,2 @@
 import type { RHFOtpInputFieldProps } from '@/types/forms';
-export declare function RHFOtpInputField({ name, label, className, control, length, inputClassName, }: RHFOtpInputFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function RHFOtpInputField({ name, label, className, control, length, inputClassName, autoFocus, }: RHFOtpInputFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/image-slider.d.ts

@@ -1,22 +1,5 @@
-/**
- * Props for the ImageSlider component.
- */
-export interface ImageSliderProps {
-    /** Array of image URLs to display */
-    images: string[];
-    /** Auto-play interval in milliseconds (0 to disable) */
-    autoPlayInterval?: number;
-    /** Additional className for the root container */
-    className?: string;
-    /** Whether to hide the built-in slider indicators */
-    hideIndicators?: boolean;
-    /** Optional callback fired whenever the active slide changes */
-    onSlideChange?: (index: number) => void;
-    /** Controlled active index (makes component controlled) */
-    activeIndex?: number;
-    /** Callback for manual slide navigation in controlled mode */
-    onNavigate?: (index: number) => void;
-}
+import type { ImageSliderProps } from '@/types';
+export type { ImageSliderProps } from '@/types';
 /**
  * Image slider component with indicator dots.
  * Supports both controlled and uncontrolled modes.

package/dist/components/layout/main-layout.d.ts

@@ -1,49 +1,5 @@
-import { type ReactNode } from 'react';
-/**
- * Props for the MainLayout component.
- *
- * @remarks
- * This layout provides a two-panel authentication page structure:
- * - Left panel: Marketing content with image slider, CTA, and image card
- * - Right panel: Authentication content (provided as children)
- */
-export interface MainLayoutProps {
-    /** Array of image URLs for the slider */
-    sliderImages?: string[];
-    /** Auto-play interval for slider in milliseconds (0 to disable) */
-    sliderAutoPlayInterval?: number;
-    /** Call-to-action text displayed above the image card. Set to null to hide */
-    ctaText?: ReactNode | null;
-    /** Per-slide title/CTA (overrides ctaText when provided; uses active slide index) */
-    sliderTitles?: (ReactNode | string)[] | undefined;
-    /** Additional className for the root container */
-    className?: string;
-    /** Additional className for the marketing panel (left side) */
-    marketingClassName?: string;
-    /** Additional className for the content panel (right side) */
-    contentClassName?: string;
-    /** Main authentication content (typically AuthLayout.Root with slots) */
-    children: ReactNode;
-}
-/**
- * Props for the MarketingPanel component (left side)
- */
-export interface MarketingPanelProps {
-    /** Array of image URLs for the slider */
-    sliderImages: string[];
-    /** Auto-play interval for slider in milliseconds */
-    sliderAutoPlayInterval: number;
-    /** Active slide index (controlled) */
-    activeSlideIndex: number;
-    /** Callback when slide changes */
-    onSlideChange: (index: number) => void;
-    /** Call-to-action text */
-    ctaText?: ReactNode | null;
-    /** Per-slide title/CTA (overrides ctaText when provided) */
-    sliderTitles?: (ReactNode | string)[] | undefined;
-    /** Additional className */
-    className?: string;
-}
+import type { MainLayoutProps, MarketingPanelProps } from '@/types';
+export type { MainLayoutProps, MarketingPanelProps } from '@/types';
 /**
  * Marketing panel component - displays CTA, image slider, and indicators
  */

package/dist/core/auth-api-adapter.d.ts

@@ -3,42 +3,4 @@
  * Consumers implement this to connect the SDK to their central auth service.
  * The SDK never performs HTTP calls directly.
  */
-import type { AuthenticateWithProviderParams, CompleteProfileParams, SendOtpResponse, SSOSession, VerifyOtpResponse } from './auth-types';
-/** Parameters for sending OTP to phone or email. */
-export interface SendOtpParams {
-    type: 'phone' | 'email';
-    value: string;
-}
-/** Parameters for verifying OTP. */
-export interface VerifyOtpParams {
-    type: 'phone' | 'email';
-    value: string;
-    otp: string;
-}
-/**
- * Adapter implemented by the consumer to talk to the central auth service.
- * All methods return promises; the SDK handles loading/error state.
- */
-export interface AuthApiAdapter {
-    /** Send OTP to the given phone or email. */
-    sendOtp(params: SendOtpParams): Promise<SendOtpResponse>;
-    /**
-     * Verify OTP. Returns session if existing user, or isNewUser flag for profile completion.
-     * May return conflict error when identifier is linked to another account.
-     */
-    verifyOtp(params: VerifyOtpParams): Promise<VerifyOtpResponse>;
-    /** Complete profile for new users; returns SSO session. */
-    completeProfile(params: CompleteProfileParams): Promise<SSOSession>;
-    /** Authenticate with a third-party provider (Google/Apple) credential. */
-    authenticateWithProvider(params: AuthenticateWithProviderParams): Promise<VerifyOtpResponse>;
-    /** Validate an existing SSO session token; called on SDK mount. Returns null if invalid/expired. */
-    validateSession(token: string): Promise<SSOSession | null>;
-    /**
-     * Optional: validate session using server-read cookie (no token from client).
-     * Required when using serverCookieTokenStorage. Client sends credentials;
-     * server reads cookie from the request and returns session or null.
-     */
-    validateSessionFromCookie?(): Promise<SSOSession | null>;
-    /** Optional: refresh an expired SSO session using refresh token. */
-    refreshSession?(refreshToken: string): Promise<SSOSession | null>;
-}
+export type { AuthApiAdapter, SendOtpParams, VerifyOtpParams, } from '@/types';

package/dist/core/auth-context.d.ts

@@ -1,51 +1,5 @@
-import type { SSOSession } from './auth-types';
-import type { AuthFlowState } from './use-auth-flow';
-/** Provider config slice exposed to flow for Google/Apple wiring. */
-export interface AuthFlowProviderConfig {
-    google?: {
-        clientId: string;
-        enableOneTap?: boolean;
-    };
-    apple?: {
-        clientId: string;
-        redirectUri: string;
-    };
-}
-/** Async actions that perform I/O and dispatch to the flow reducer. */
-export interface AuthFlowActions {
-    selectMethod: (method: 'phone' | 'email' | 'google' | 'apple') => void;
-    /** From REPEAT_LOGIN: continue with last used method. */
-    continueWithLastMethod: () => void;
-    submitIdentifier: (data: {
-        phone?: string;
-        email?: string;
-    }) => void;
-    /** SIGNUP_DETAILS step: submit name + phone/email, then OTP (foreign) or complete (Indian). */
-    submitSignupDetails: (data: {
-        fullName: string;
-        phone?: string;
-        email?: string;
-    }) => void;
-    verifyOtp: (otp: string) => void;
-    resendOtp: () => void;
-    providerCallback: (params: {
-        provider: 'google' | 'apple';
-        credential: string;
-    }) => void;
-    goBack: () => void;
-    reset: () => void;
-    signOut: () => void;
-}
-export interface AuthFlowContextValue {
-    state: AuthFlowState;
-    actions: AuthFlowActions;
-    /** Session when step is AUTHENTICATED. */
-    session: SSOSession | null;
-    /** True while step is CHECKING_SESSION. */
-    isLoading: boolean;
-    /** Provider config for Google/Apple (One Tap, Sign-In button). */
-    providerConfig: AuthFlowProviderConfig | undefined;
-}
+import type { AuthFlowContextValue } from '@/types';
+export type { AuthFlowActions, AuthFlowContextValue, AuthFlowProviderConfig, } from '@/types';
 export declare const AuthFlowContext: import("react").Context<AuthFlowContextValue | null>;
 /**
  * Hook to access auth flow state and actions. Must be used within SSOAuthProvider.
@@ -55,9 +9,9 @@ export declare function useAuthFlow(): AuthFlowContextValue;
  * Hook to access SSO session state only. Must be used within SSOAuthProvider.
  */
 export declare function useAuthSession(): {
-    session: SSOSession | null;
+    session: import("@/types").SSOSession | null;
     isAuthenticated: boolean;
     isLoading: boolean;
     signOut: () => void;
-    authMethod: import("./auth-types").AuthMethod | null;
+    authMethod: import("@/types").AuthMethod | null;
 };

package/dist/core/auth-provider.d.ts

@@ -1,38 +1,5 @@
-import type { AuthApiAdapter } from './auth-api-adapter';
-import type { AuthError, SSOSession } from './auth-types';
-import type { TokenStorageStrategy } from './sso-session';
-export interface SSOAuthConfig {
-    /** Consumer-provided adapter to their central auth service. */
-    apiAdapter: AuthApiAdapter;
-    /** Auth method configs (Google client ID, Apple client ID, etc.). */
-    providers?: {
-        google?: {
-            clientId: string;
-            enableOneTap?: boolean;
-        };
-        apple?: {
-            clientId: string;
-            redirectUri: string;
-        };
-    };
-    /** Called when SSO session is established (any method). */
-    onAuthSuccess: (session: SSOSession) => void;
-    /** Called on auth errors. */
-    onAuthError?: (error: AuthError) => void;
-    /** Optional: called when user signs out. */
-    onSignOut?: () => void;
-    /** SSO token persistence strategy. Defaults to localStorage. */
-    tokenStorage?: TokenStorageStrategy;
-    /** Branding customization (logo, slider images). */
-    branding?: {
-        logo?: React.ReactNode;
-        sliderImages?: string[];
-    };
-}
-export interface SSOAuthProviderProps {
-    config: SSOAuthConfig;
-    children: React.ReactNode;
-}
+import type { SSOAuthProviderProps } from '@/types';
+export type { SSOAuthConfig, SSOAuthProviderProps } from '@/types';
 /**
  * SSO Auth provider: runs session check on mount, holds flow state, and provides async actions.
  */

package/dist/core/auth-types.d.ts

@@ -1,70 +1,5 @@
 /**
- * SSO auth domain types: session, flow steps, adapter contracts, and error codes.
- * Used by the flow engine, provider, and adapter implementations.
+ * Re-export of auth domain types from central types folder.
+ * Prefer importing from @/types; this file keeps @/core/auth-types working.
  */
-/** Auth methods available in the SSO system. */
-export type AuthMethod = 'phone' | 'email' | 'google' | 'apple';
-/** User payload in the SSO session. */
-export interface SSOUser {
-    id: string;
-    name: string;
-    email?: string;
-    phone?: string;
-    avatar?: string;
-    isNewUser: boolean;
-}
-/** The SSO session — same structure regardless of auth method used. */
-export interface SSOSession {
-    accessToken: string;
-    refreshToken?: string;
-    expiresAt: number;
-    user: SSOUser;
-    authMethod: AuthMethod;
-}
-/** User type for layout and OTP routing: Indian (+91) vs Foreign (non +91). */
-export type UserType = 'INDIAN' | 'FOREIGN';
-/** Flow states for the state machine. */
-export type AuthStep = 'CHECKING_SESSION' | 'REPEAT_LOGIN' | 'METHOD_SELECT' | 'PHONE_ENTRY' | 'EMAIL_ENTRY' | 'OTP_VERIFICATION' | 'SIGNUP_DETAILS' | 'PROVIDER_PENDING' | 'AUTHENTICATED';
-/** Error codes from the central auth service. */
-export type AuthErrorCode = 'IDENTIFIER_CONFLICT' | 'OTP_EXPIRED' | 'OTP_INVALID' | 'OTP_RATE_LIMIT' | 'SESSION_EXPIRED' | 'PROVIDER_AUTH_FAILED' | 'NETWORK_ERROR' | 'UNKNOWN';
-/** Auth error with code and optional message / linked identifier. */
-export interface AuthError {
-    code: AuthErrorCode;
-    message?: string;
-    /** Masked linked identifier when conflict (e.g. "+91 98XXXX0X0X"). */
-    linkedIdentifier?: string;
-}
-/** Response from sendOtp. */
-export interface SendOtpResponse {
-    success: boolean;
-    /** Masked value for display (e.g. "+91 9825910X0X" or "j***@gmail.com"). */
-    maskedValue?: string;
-    error?: AuthError;
-}
-/** Result of verifyOtp or authenticateWithProvider: existing user gets session, new user gets profile step. */
-export interface VerifyOtpResponse {
-    /** Present when user exists and is authenticated. */
-    session?: SSOSession;
-    /** True when user is new and must complete profile. */
-    isNewUser: boolean;
-    /** When isNewUser and conflict (e.g. email already linked), masked linked identifier. */
-    conflict?: AuthError;
-}
-/** Input for completeProfile (new users). */
-export interface CompleteProfileParams {
-    fullName: string;
-    email?: string;
-    phone?: string;
-}
-/** Input for authenticateWithProvider (Google/Apple credential). */
-export interface AuthenticateWithProviderParams {
-    provider: 'google' | 'apple';
-    /** Id token or equivalent from the provider. */
-    credential: string;
-}
-/** Repeat-login device history (method + masked identifier). */
-export interface RepeatLoginInfo {
-    method: AuthMethod;
-    maskedIdentifier: string;
-    timestamp: number;
-}
+export type { AuthError, AuthErrorCode, AuthenticateWithProviderParams, AuthMethod, AuthStep, CompleteProfileParams, RepeatLoginInfo, SendOtpResponse, SSOSession, SSOUser, UserType, VerifyOtpResponse, } from '@/types';

package/dist/core/device-detection.d.ts

@@ -2,12 +2,8 @@
  * Device-based repeat login detection.
  * Stores last-used method and masked identifier in localStorage (device-local UX only).
  */
-import type { AuthMethod } from './auth-types';
-export interface StoredRepeatLogin {
-    method: AuthMethod;
-    maskedIdentifier: string;
-    timestamp: number;
-}
+import type { StoredRepeatLogin } from '@/types';
+export type { StoredRepeatLogin } from '@/types';
 /**
  * Reads repeat-login info from localStorage if present.
  * Safe to call in browser; returns null in SSR or when not found.

package/dist/core/sso-session.d.ts

@@ -2,12 +2,8 @@
  * SSO session management: token persistence strategies and useAuthSession hook.
  * Token storage is consumer-configurable for cross-app SSO (e.g. shared cookie domain).
  */
-/** How/where the SSO token is stored for cross-app access. */
-export interface TokenStorageStrategy {
-    get(): string | null;
-    set(token: string, expiresAt: number): void;
-    remove(): void;
-}
+import type { AxiosAuthInterceptorInstance, TokenStorageStrategy } from '@/types';
+export type { AxiosAuthInterceptorInstance, AxiosRequestConfig, TokenStorageStrategy, } from '@/types';
 /**
  * Token storage using localStorage (single-origin).
  * Suitable for dev or when all Docthub apps share the same origin.
@@ -21,30 +17,6 @@ export declare function localStorageTokenStorage(): TokenStorageStrategy;
  * cookie is sent on every request.
  */
 export declare function serverCookieTokenStorage(): TokenStorageStrategy;
-/**
- * Axios instance shape needed to attach auth interceptors (avoids hard axios dependency).
- * Use createAxiosAuthInterceptors with your axios instance.
- */
-export interface AxiosAuthInterceptorInstance {
-    interceptors: {
-        request: {
-            use(onFulfilled?: (config: AxiosRequestConfig) => AxiosRequestConfig | Promise<AxiosRequestConfig>, onRejected?: (err: unknown) => unknown): number;
-        };
-        response: {
-            use(onFulfilled?: (res: unknown) => unknown, onRejected?: (err: unknown) => unknown): number;
-        };
-    };
-    defaults: {
-        withCredentials?: boolean;
-    };
-}
-/** Minimal request config type for the interceptor (no axios import). */
-export interface AxiosRequestConfig {
-    headers?: Record<string, string> | {
-        [key: string]: string;
-    };
-    withCredentials?: boolean;
-}
 /**
  * Attaches request and response interceptors to an axios instance for SSO auth
  * when using server-side cookies (e.g. serverCookieTokenStorage):

package/dist/core/use-auth-flow.d.ts

@@ -2,81 +2,8 @@
  * Auth flow state machine: reducer and state type.
  * Side effects (API calls, token persistence) are performed by the provider; this module is pure.
  */
-import type { AuthStep, SSOSession, UserType } from './auth-types';
-/** Identifier type for OTP / profile steps. */
-export type IdentifierType = 'phone' | 'email';
-/** Full state for the auth flow. */
-export interface AuthFlowState {
-    step: AuthStep;
-    /** Previous step for goBack. */
-    lastStep: AuthStep;
-    /** Indian (+91) vs Foreign (non +91); drives layout and OTP routing. */
-    userType: UserType;
-    /** Current identifier value (phone or email) when in OTP or signup. */
-    identifierValue: string;
-    /** Type of identifier (phone vs email). */
-    identifierType: IdentifierType;
-    /** Masked value for display (e.g. "+91 9825910X0X"). */
-    maskedRecipient: string;
-    /** For SIGNUP_DETAILS (Indian): which field to collect (phone or email). */
-    signupCollectField: IdentifierType;
-    /** For REPEAT_LOGIN: last used method label. */
-    lastMethod: string;
-    /** Set when step is AUTHENTICATED. */
-    session: SSOSession | null;
-    /** Foreign flow: phone value when user entered phone before signup details. */
-    pendingPhone: string;
-    /** Foreign flow: signup form data for completeProfile after OTP verify. */
-    pendingFullName: string;
-    pendingEmail: string;
-}
+import type { AuthFlowAction, AuthFlowState, AuthStep } from '@/types';
+export type { AuthFlowAction, AuthFlowState, IdentifierType } from '@/types';
 export declare const INITIAL_STEP: AuthStep;
 export declare function getInitialAuthFlowState(): AuthFlowState;
-/** Pure reducer actions. */
-export type AuthFlowAction = {
-    type: 'SET_SESSION';
-    session: SSOSession;
-} | {
-    type: 'SET_STEP_REPEAT_LOGIN';
-    lastMethod: string;
-    maskedIdentifier: string;
-} | {
-    type: 'SET_STEP_METHOD_SELECT';
-} | {
-    type: 'SET_STEP_PHONE_ENTRY';
-} | {
-    type: 'SET_STEP_EMAIL_ENTRY';
-} | {
-    type: 'SET_STEP_OTP_VERIFICATION';
-    userType: UserType;
-    identifierType: IdentifierType;
-    value: string;
-    maskedValue: string;
-    /** Foreign flow: for completeProfile after OTP. */
-    pendingFullName?: string;
-    pendingEmail?: string;
-    pendingPhone?: string;
-} | {
-    type: 'SET_STEP_SIGNUP_DETAILS';
-    userType: UserType;
-    /** Indian: which field to collect (phone or email). Foreign: ignored. */
-    signupCollectField: IdentifierType;
-    /** Foreign only: phone value when user entered phone before signup. */
-    pendingPhone?: string;
-    /** When coming from identifier entry (foreign): preserve for later OTP. */
-    identifierType?: IdentifierType;
-    identifierValue?: string;
-    maskedRecipient?: string;
-} | {
-    type: 'SET_STEP_PROVIDER_PENDING';
-} | {
-    type: 'SET_STEP_AUTHENTICATED';
-    session: SSOSession;
-} | {
-    type: 'GO_BACK';
-} | {
-    type: 'RESET';
-} | {
-    type: 'SIGN_OUT';
-};
 export declare function authFlowReducer(state: AuthFlowState, action: AuthFlowAction): AuthFlowState;

package/dist/doct-ui-auth-kit.css

@@ -0,0 +1 @@
+*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:var(--font-inter),Inter,system-ui,Avenir,Helvetica,Arial,sans-serif;font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media(min-width:640px){.container{max-width:640px}}@media(min-width:768px){.container{max-width:768px}}@media(min-width:1024px){.container{max-width:1024px}}@media(min-width:1280px){.container{max-width:1280px}}@media(min-width:1536px){.container{max-width:1536px}}.visible{visibility:visible}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{inset:0}.-top-10{top:-2.5rem}.left-1\/2{left:50%}.top-2\.5{top:.625rem}.top-\[152\.5px\]{top:152.5px}.z-10{z-index:10}.z-20{z-index:20}.mb-1{margin-bottom:.25rem}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-6{margin-bottom:1.5rem}.block{display:block}.inline{display:inline}.flex{display:flex}.hidden{display:none}.h-1{height:.25rem}.h-10{height:2.5rem}.h-5{height:1.25rem}.h-\[100dvh\]{height:100dvh}.h-\[30px\]{height:30px}.h-full{height:100%}.min-h-0{min-height:0px}.min-h-svh{min-height:100svh}.w-10{width:2.5rem}.w-2{width:.5rem}.w-5{width:1.25rem}.w-8{width:2rem}.w-\[140px\]{width:140px}.w-\[328px\]{width:328px}.w-auto{width:auto}.w-full{width:100%}.w-screen{width:100vw}.min-w-0{min-width:0px}.min-w-full{min-width:100%}.max-w-\[320px\]{max-width:320px}.max-w-\[360px\]{max-width:360px}.max-w-\[400px\]{max-width:400px}.max-w-lg{max-width:32rem}.max-w-md{max-width:28rem}.flex-1{flex:1 1 0%}.flex-shrink-0{flex-shrink:0}.-translate-x-1\/2{--tw-translate-x: -50%;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-pointer{cursor:pointer}.flex-col{flex-direction:column}.items-center{align-items:center}.justify-start{justify-content:flex-start}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.gap-1\.5{gap:.375rem}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.gap-\[12px\]{gap:12px}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.whitespace-pre-line{white-space:pre-line}.rounded-\[10px\]{border-radius:10px}.rounded-\[3px\]{border-radius:3px}.border{border-width:1px}.border-\[rgba\(0\,0\,0\,0\.12\)\]{border-color:#0000001f}.bg-\[\#002830\]{--tw-bg-opacity: 1;background-color:rgb(0 40 48 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-white\/40{background-color:#fff6}.bg-white\/50{background-color:#ffffff80}.object-cover{-o-object-fit:cover;object-fit:cover}.object-center{-o-object-position:center;object-position:center}.p-2{padding:.5rem}.p-8{padding:2rem}.px-4{padding-left:1rem;padding-right:1rem}.px-5{padding-left:1.25rem;padding-right:1.25rem}.px-\[22px\]{padding-left:22px;padding-right:22px}.py-12{padding-top:3rem;padding-bottom:3rem}.py-6{padding-top:1.5rem;padding-bottom:1.5rem}.py-8{padding-top:2rem;padding-bottom:2rem}.py-\[14px\]{padding-top:14px;padding-bottom:14px}.pt-5{padding-top:1.25rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-bold{font-weight:700}.font-semibold{font-weight:600}.lowercase{text-transform:lowercase}.capitalize{text-transform:capitalize}.text-\[\#002830\]{--tw-text-opacity: 1;color:rgb(0 40 48 / var(--tw-text-opacity, 1))}.text-\[\#1e595a\]{--tw-text-opacity: 1;color:rgb(30 89 90 / var(--tw-text-opacity, 1))}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-black\/80{color:#000c}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.underline{text-decoration-line:underline}.opacity-40{opacity:.4}.opacity-60{opacity:.6}.opacity-80{opacity:.8}.outline{outline-style:solid}.blur{--tw-blur: blur(8px);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-transform{transition-property:transform;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-500{transition-duration:.5s}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}@keyframes enter{0%{opacity:var(--tw-enter-opacity, 1);transform:translate3d(var(--tw-enter-translate-x, 0),var(--tw-enter-translate-y, 0),0) scale3d(var(--tw-enter-scale, 1),var(--tw-enter-scale, 1),var(--tw-enter-scale, 1)) rotate(var(--tw-enter-rotate, 0))}}@keyframes exit{to{opacity:var(--tw-exit-opacity, 1);transform:translate3d(var(--tw-exit-translate-x, 0),var(--tw-exit-translate-y, 0),0) scale3d(var(--tw-exit-scale, 1),var(--tw-exit-scale, 1),var(--tw-exit-scale, 1)) rotate(var(--tw-exit-rotate, 0))}}.duration-300{animation-duration:.3s}.duration-500{animation-duration:.5s}.ease-in-out{animation-timing-function:cubic-bezier(.4,0,.2,1)}:root{font-family:var( --font-inter, "Inter", system-ui, Avenir, Helvetica, Arial, sans-serif );line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#242424;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}body{margin:0;min-width:320px;min-height:100vh}#root{min-height:100vh;width:100%}.hover\:bg-white\/60:hover{background-color:#fff9}@media(min-width:640px){.sm\:flex{display:flex}}@media(min-width:768px){.md\:mb-6{margin-bottom:1.5rem}.md\:px-\[20px\]{padding-left:20px;padding-right:20px}.md\:py-12{padding-top:3rem;padding-bottom:3rem}.md\:py-8{padding-top:2rem;padding-bottom:2rem}.md\:pt-\[20px\]{padding-top:20px}}@media(min-width:1024px){.lg\:block{display:block}.lg\:h-\[100dvh\]{height:100dvh}.lg\:w-\[432px\]{width:432px}.lg\:flex-shrink-0{flex-shrink:0}.lg\:flex-grow-0{flex-grow:0}.lg\:flex-row{flex-direction:row}}

package/dist/hooks/index.d.ts

@@ -1,3 +1,5 @@
 export { type EmailFormValues, type LoginEntryFormValues, type LoginEntryMode, type PhoneFormValues, type UseLoginEntryFormOptions, type UseLoginEntryFormReturn, useLoginEntryForm, } from './use-login-entry-form';
+export { type MainAuthPageHandlers, type MainLoginAppleProviderConfig, type MainLoginGoogleProviderConfig, type MainLoginPageProvidersConfig, type UseMainAuthPageHandlersOptions, useMainAuthPageHandlers, } from './use-main-auth-page-handlers';
 export { DEFAULT_OTP_TITLES, OTP_LENGTH, type OtpFormValues, type OtpVerificationMode, RESEND_COOLDOWN_EMAIL_SECONDS, RESEND_COOLDOWN_PHONE_SECONDS, type UseOtpVerificationOptions, type UseOtpVerificationReturn, useOtpVerification, } from './use-otp-verification';
+export { type UseRepeatLoginOptions, type UseRepeatLoginReturn, useRepeatLogin, } from './use-repeat-login';
 export { type SignupEmailFormValues, type SignupEntryMode, type SignupFormValues, type SignupPhoneFormValues, type UseSignupFormOptions, type UseSignupFormReturn, useSignupForm, } from './use-signup-form';

package/dist/hooks/use-login-entry-form.d.ts

@@ -1,32 +1,8 @@
-import type { UseFormReturn } from 'react-hook-form';
-import { z } from 'zod';
-/** Login mode: phone number or email */
-export type LoginEntryMode = 'phone' | 'email';
-declare const phoneFormSchema: z.ZodObject<{
-    phone: z.ZodString;
-}, z.core.$strip>;
-declare const emailFormSchema: z.ZodObject<{
-    email: z.ZodString;
-}, z.core.$strip>;
-export type PhoneFormValues = z.infer<typeof phoneFormSchema>;
-export type EmailFormValues = z.infer<typeof emailFormSchema>;
-export type LoginEntryFormValues = PhoneFormValues | EmailFormValues;
-export interface UseLoginEntryFormOptions {
-    mode: LoginEntryMode;
-    /** Called with valid form data on submit. Omit or pass undefined when not needed. */
-    onSubmit?: ((data: {
-        phone?: string;
-        email?: string;
-    }) => void) | undefined;
-}
-export interface UseLoginEntryFormReturn {
-    methods: UseFormReturn<LoginEntryFormValues>;
-    handleSubmit: (data: LoginEntryFormValues) => void;
-    isPhone: boolean;
-}
+import type { UseLoginEntryFormOptions, UseLoginEntryFormReturn } from '@/types';
+export type { EmailFormValues, LoginEntryFormValues, LoginEntryMode, LoginEntrySubmitData, PhoneFormValues, UseLoginEntryFormOptions, UseLoginEntryFormReturn, } from '@/types';
 /**
  * Form state and validation for the login entry screen (phone or email).
+ * Business logic: when submitApi is provided, hook runs validate → submitApi(data) → onSuccess() (e.g. redirect).
  * Use with LoginEntry component or build a custom UI with the returned methods.
  */
-export declare function useLoginEntryForm({ mode, onSubmit, }: UseLoginEntryFormOptions): UseLoginEntryFormReturn;
-export {};
+export declare function useLoginEntryForm({ mode, onSubmit, submitApi, onSuccess, onError, }: UseLoginEntryFormOptions): UseLoginEntryFormReturn;

package/dist/hooks/use-main-auth-page-handlers.d.ts

@@ -0,0 +1,8 @@
+import type { MainAuthPageHandlers, UseMainAuthPageHandlersOptions } from '@/types';
+export type { MainAuthPageHandlers, MainLoginAppleProviderConfig, MainLoginGoogleProviderConfig, MainLoginPageProvidersConfig, UseMainAuthPageHandlersOptions, } from '@/types';
+/**
+ * Main auth page business logic: resolves CTA handlers from optional overrides and optional provider config.
+ * When providers.google / providers.apple are set, the lib runs Google/Apple OAuth and calls onCredential;
+ * otherwise uses overrides or no-op defaults.
+ */
+export declare function useMainAuthPageHandlers(options?: Readonly<UseMainAuthPageHandlersOptions>): MainAuthPageHandlers;

package/dist/hooks/use-otp-verification.d.ts

@@ -1,36 +1,12 @@
-import type { UseFormReturn } from 'react-hook-form';
-import { z } from 'zod';
-/** OTP verification mode: mobile (phone) or email */
-export type OtpVerificationMode = 'phone' | 'email';
-export declare const OTP_LENGTH = 6;
-/** Resend cooldown: 60s for phone OTP, 2 min for email OTP (per design). */
-export declare const RESEND_COOLDOWN_PHONE_SECONDS = 60;
-export declare const RESEND_COOLDOWN_EMAIL_SECONDS = 120;
-export declare function getResendCooldownSeconds(mode: OtpVerificationMode): number;
-declare const otpFormSchema: z.ZodObject<{
-    otp: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export type OtpFormValues = z.infer<typeof otpFormSchema>;
-export declare const DEFAULT_OTP_TITLES: Record<OtpVerificationMode, string>;
+import type { OtpVerificationMode, UseOtpVerificationOptions, UseOtpVerificationReturn } from '@/types';
+export type { OtpFormValues, OtpVerificationMode, UseOtpVerificationOptions, UseOtpVerificationReturn, } from '@/types';
 /** Instruction line below recipient (Figma: "Kindly check your Email Inbox."). */
 export declare const DEFAULT_OTP_INSTRUCTIONS: Record<OtpVerificationMode, string>;
-export interface UseOtpVerificationOptions {
-    /** OTP mode: phone (60s cooldown) or email (2 min cooldown). */
-    mode: OtpVerificationMode;
-    onSubmit?: ((otp: string) => void) | undefined;
-    onResendCode?: (() => void) | undefined;
-}
-export interface UseOtpVerificationReturn {
-    methods: UseFormReturn<OtpFormValues>;
-    handleSubmit: (data: OtpFormValues) => void;
-    handleResend: () => void;
-    resendSecondsLeft: number;
-    canResend: boolean;
-    timerText: string;
-}
+export declare const DEFAULT_OTP_TITLES: Record<OtpVerificationMode, string>;
+/** Re-export for consumers who import from hooks. */
+export { getResendCooldownSeconds, OTP_LENGTH, RESEND_COOLDOWN_EMAIL_SECONDS, RESEND_COOLDOWN_PHONE_SECONDS, } from '@/validations';
 /**
  * Form state, resend countdown, and validation for OTP verification.
- * Use with OtpVerification component or build a custom OTP UI.
+ * When submitApi is provided, hook runs: validate → submitApi(otp) → onSuccess() (e.g. redirect).
  */
-export declare function useOtpVerification({ mode, onSubmit, onResendCode, }: UseOtpVerificationOptions): UseOtpVerificationReturn;
-export {};
+export declare function useOtpVerification({ mode, onSubmit, onResendCode, submitApi, onSuccess, onError, }: UseOtpVerificationOptions): UseOtpVerificationReturn;

package/dist/hooks/use-repeat-login.d.ts

@@ -0,0 +1,7 @@
+import type { UseRepeatLoginOptions, UseRepeatLoginReturn } from '@/types';
+export type { UseRepeatLoginOptions, UseRepeatLoginReturn } from '@/types';
+/**
+ * Business logic for repeat login: continue with last method (sync or async via continueApi).
+ * When continueApi is provided, runs: continueApi() → onSuccess(); otherwise calls onContinueWithLastMethod.
+ */
+export declare function useRepeatLogin(options?: UseRepeatLoginOptions): UseRepeatLoginReturn;