doct-ui-auth-kit 1.0.7 → 1.0.9

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

@@ -1,39 +0,0 @@
-import { 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>;
-}

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

@@ -1,94 +0,0 @@
-import { ReactNode } from 'react';
-/**
- * Layout configuration types
- */
-export type AuthLayoutVariant = 'mobile' | 'desktop';
-export type AuthLayoutMaxWidth = 'sm' | 'md' | 'lg';
-/** Text/alignment variant for Logo, Title, Description slots */
-export type AuthLayoutAlign = 'left' | 'center' | 'right';
-/**
- * Props for AuthLayout.Root component
- */
-export interface AuthLayoutRootProps {
-    /** Main content (compound components) */
-    children: ReactNode;
-    /** Layout variation for spacing and alignment */
-    variant?: AuthLayoutVariant;
-    /** Maximum width constraint for the content area */
-    maxWidth?: AuthLayoutMaxWidth;
-    /** Additional className for the root container */
-    className?: string;
-    /** Additional className for the content wrapper */
-    contentClassName?: string;
-}
-/**
- * Props for AuthLayout.Header component
- */
-export interface AuthLayoutHeaderProps {
-    /** Header content */
-    children: ReactNode;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Logo component
- */
-export interface AuthLayoutLogoProps {
-    /** Logo content */
-    children: ReactNode;
-    /** Alignment: left, center (default), or right */
-    align?: AuthLayoutAlign;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Title component
- */
-export interface AuthLayoutTitleProps {
-    /** Title content */
-    children: ReactNode;
-    /** Alignment: left, center (default), or right */
-    align?: AuthLayoutAlign;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Description component
- */
-export interface AuthLayoutDescriptionProps {
-    /** Description content */
-    children: ReactNode;
-    /** Alignment: left, center (default), or right */
-    align?: AuthLayoutAlign;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Body component
- */
-export interface AuthLayoutBodyProps {
-    /** Body content (forms, buttons, etc.) */
-    children: ReactNode;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Main component
- */
-export interface AuthLayoutMainProps {
-    /** Main content (Logo, Title, Description, Body slots) */
-    children: ReactNode;
-    /** When true, constrains main content width to 320px (max-w-[320px]) */
-    sm?: boolean;
-    /** Additional className */
-    className?: string;
-}
-/**
- * Props for AuthLayout.Footer component
- */
-export interface AuthLayoutFooterProps {
-    /** Footer content */
-    children: ReactNode;
-    /** Additional className */
-    className?: string;
-}

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

@@ -1,40 +0,0 @@
-import { ReactNode } from 'react';
-import { AuthApiAdapter } from './auth-api-adapter';
-import { AuthError, SSOSession } from './auth-types';
-import { TokenStorageStrategy } from './sso-session';
-/** Consumer-provided config for SSOAuthProvider. */
-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?: ReactNode;
-        sliderImages?: string[];
-    };
-}
-/** Props for the SSOAuthProvider context wrapper that supplies auth state to the component tree. */
-export interface SSOAuthProviderProps {
-    /** Auth configuration including API adapter, provider settings, and callbacks. */
-    config: SSOAuthConfig;
-    /** Child components that will have access to the SSO auth context. */
-    children: ReactNode;
-}

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

@@ -1,70 +0,0 @@
-/**
- * SSO auth domain types: session, flow steps, adapter contracts, and error codes.
- * Used by the flow engine, provider, and adapter implementations.
- */
-/** 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;
-}

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

@@ -1,10 +0,0 @@
-import { AuthMethod } from './auth-types';
-/** Stored repeat-login info (method + masked identifier). */
-export interface StoredRepeatLogin {
-    /** The authentication method used in the previous login (e.g. `'phone'`, `'email'`, `'google'`). */
-    method: AuthMethod;
-    /** Partially masked identifier shown to the user (e.g. `"****1234"` or `"j***@example.com"`). */
-    maskedIdentifier: string;
-    /** Unix epoch (ms) when this login record was stored. Used for expiry checks. */
-    timestamp: number;
-}

package/dist/types/flow.d.ts

@@ -1,122 +0,0 @@
-import { 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;
-}
-/** 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';
-};
-/** 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;
-}
-/** Auth flow context value provided by SSOAuthProvider. */
-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;
-}

package/dist/types/forms.d.ts

@@ -1,68 +0,0 @@
-import { KeyboardEvent } from 'react';
-import { Control, FieldValues } from 'react-hook-form';
-/** Base props shared by RHF form field components. */
-export interface BaseFormFieldProps {
-    /** Field name used by react-hook-form for registration and validation. */
-    name: string;
-    /** Visible label rendered above or beside the input. */
-    label?: string;
-    /** Placeholder text shown when the input is empty. */
-    placeholder?: string;
-    /** Whether the field is required for form submission. */
-    required?: boolean;
-    /** Whether the field is disabled (non-interactive). */
-    disabled?: boolean;
-    /** Additional CSS class name(s) applied to the field wrapper. */
-    className?: string;
-    /** Validation error message to display below the input. */
-    error?: string;
-    /** Supplementary helper text shown below the input when there is no error. */
-    helperText?: string;
-    /** Focus this field when form/screen opens (PRODUCT_PROTOCOLS #26). */
-    autoFocus?: boolean;
-}
-/** Props for the text/email/number input field component. */
-export interface RHFInputFieldProps extends BaseFormFieldProps {
-    /** HTML input type. Allowed: `'text'`, `'email'`, `'password'`, `'number'`, `'tel'`, `'url'`, `'search'`. */
-    type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
-    /** HTML `autocomplete` attribute value (e.g. `'email'`, `'tel'`). */
-    autoComplete?: string;
-    /** Maximum character length enforced on the input. */
-    maxLength?: number;
-    /** Minimum character length enforced on the input. */
-    minLength?: number;
-    /** Regex pattern string for native HTML validation. */
-    pattern?: string;
-    /** react-hook-form `Control` instance. When omitted, the field uses the nearest `FormProvider`. */
-    control?: Control<FieldValues>;
-    /** Called when a key is pressed while the input is focused. */
-    onKeyDown?: (event: KeyboardEvent<HTMLInputElement>) => void;
-    /** When true, restricts input to numeric characters only. */
-    numericOnly?: boolean;
-}
-/** Props for RHF wrapper around DoctPhoneInput (docthub-core-components). */
-export interface RHFDoctPhoneInputFieldProps extends BaseFormFieldProps {
-    /** ISO 3166-1 alpha-2 country code pre-selected in the phone input (e.g. `'IN'`, `'US'`). */
-    defaultCountry?: string;
-    /** Display variant: `'default'` shows full country selector, `'flag'` shows flag icon only. */
-    variant?: 'default' | 'flag';
-    /** react-hook-form `Control` instance. When omitted, the field uses the nearest `FormProvider`. */
-    control?: Control<FieldValues>;
-}
-/** Props for the OTP input field component. */
-export interface RHFOtpInputFieldProps extends BaseFormFieldProps {
-    /** Number of OTP digit boxes to render. @default 6 */
-    length?: number;
-    /** Input type for each OTP box: `'text'`, `'number'`, or `'password'` (masked). */
-    type?: 'text' | 'number' | 'password';
-    /** Focus the first OTP box on mount. */
-    autoFocus?: boolean;
-    /** Automatically trigger submission when all boxes are filled. */
-    autoSubmit?: boolean;
-    /** Called with the complete OTP string once all boxes are filled. */
-    onComplete?: (otp: string) => void;
-    /** CSS class name(s) applied to each individual OTP input box. */
-    inputClassName?: string;
-    /** react-hook-form `Control` instance. When omitted, the field uses the nearest `FormProvider`. */
-    control?: Control<FieldValues>;
-}

package/dist/types/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Central export file for all types and interfaces.
- * Import types from here: import type { RHFInputFieldProps } from '@/types';
- */
-export * from './auth-api-adapter';
-export * from './auth-layout-types';
-export * from './auth-provider';
-export * from './auth-types';
-export * from './device-detection';
-export * from './flow';
-export * from './forms';
-export * from './layout';
-export * from './layout-presets';
-export * from './login-form';
-export * from './main-login';
-export * from './otp-verification';
-export * from './pages';
-export * from './repeat-login';
-export * from './signup-form';
-export * from './sso-session';

package/dist/types/layout-presets.d.ts

@@ -1,24 +0,0 @@
-import { AuthLayoutAlign, AuthLayoutMaxWidth, AuthLayoutVariant } from './auth-layout-types';
-/** Layout type: two-panel with slider vs single centered column. */
-export type LayoutType = 'withSlider' | 'standalone';
-/**
- * Named presets for auth screens. Kept minimal to avoid preset explosion.
- * Add new presets only for distinct layout structures, not for auth methods.
- */
-export type LayoutPresetName = 'login' | 'signup' | 'verification' | '';
-/**
- * Structure-only config derived from a preset.
- * Used by AuthLayout to render the correct shell (slider, width, alignment).
- */
-export interface LayoutPresetConfig {
-    /** Whether to show the two-panel slider (e.g. login) or standalone column. */
-    layoutType: LayoutType;
-    /** Mobile vs desktop spacing/breakpoints. */
-    variant: AuthLayoutVariant;
-    /** Max width of the content area. */
-    maxWidth: AuthLayoutMaxWidth;
-    /** Constrain main content to 320px when 'sm'. */
-    contentWidth: 'sm' | 'default';
-    /** Title/description alignment. */
-    align: AuthLayoutAlign;
-}

package/dist/types/layout.d.ts

@@ -1,57 +0,0 @@
-import { ReactNode } from 'react';
-/** 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;
-}
-/**
- * Props for the MainLayout component.
- * Two-panel auth page: left panel (marketing/slider), right panel (auth content).
- */
-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;
-}

package/dist/types/login-form.d.ts

@@ -1,56 +0,0 @@
-import { UseFormReturn } from 'react-hook-form';
-import { z } from 'zod';
-import { loginEmailFormSchema, loginPhoneFormSchema } from '../validations';
-/** Login mode: phone number or email */
-export type LoginEntryMode = 'phone' | 'email';
-/** Form values for phone-based login, inferred from the Zod schema. */
-export type PhoneFormValues = z.infer<typeof loginPhoneFormSchema>;
-/** Form values for email-based login, inferred from the Zod schema. */
-export type EmailFormValues = z.infer<typeof loginEmailFormSchema>;
-/** Discriminated union of phone or email login form values. */
-export type LoginEntryFormValues = PhoneFormValues | EmailFormValues;
-/** Payload when login entry form is valid (phone or email). */
-export type LoginEntrySubmitData = {
-    phone?: string;
-    email?: string;
-};
-/**
- * Params passed to onSuccess after submitApi resolves.
- * Lets the consumer redirect to OTP with mode and recipient (for recipientDisplay) without storing them in refs.
- */
-export interface LoginEntrySuccessParams {
-    /** Current login entry mode (phone or email). */
-    mode: LoginEntryMode;
-    /** Submitted phone or email string; use for OTP page recipientDisplay or verify API. */
-    recipient: string;
-}
-export interface UseLoginEntryFormOptions {
-    mode: LoginEntryMode;
-    /**
-     * Sync callback with valid form data. Used when parent owns API (e.g. AuthFlow passes actions.submitIdentifier).
-     * Ignored when submitApi is provided.
-     */
-    onSubmit?: ((data: LoginEntrySubmitData) => void) | undefined;
-    /**
-     * When provided, hook runs business logic: validate → call submitApi(data) → onSuccess(params).
-     * Use from consumer (e.g. Next.js): submitApi = sendOtp, onSuccess = (params) => router.push(`/otp?mode=${params.mode}&recipient=${encodeURIComponent(params.recipient)}`).
-     */
-    submitApi?: (data: LoginEntrySubmitData) => Promise<void>;
-    /** Called after submitApi resolves successfully; receives mode and recipient for OTP redirect/display. */
-    onSuccess?: (params: LoginEntrySuccessParams) => void;
-    /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
-}
-/** Return value of the `useLoginEntryForm` hook, providing form state and mode info. */
-export interface UseLoginEntryFormReturn {
-    /** react-hook-form methods bound to the current login mode's schema. */
-    methods: UseFormReturn<LoginEntryFormValues>;
-    /** Submit handler to pass to the form's `onSubmit`. Validates and dispatches the login data. */
-    handleSubmit: (data: LoginEntryFormValues) => void;
-    /** True when the current mode is `'phone'`; use for conditional field rendering. */
-    isPhone: boolean;
-    /** True when current form values pass validation (for disabling Continue until valid – edge cases 3, 4). */
-    isFormValid: (data: LoginEntryFormValues) => boolean;
-    /** True while submitApi is in flight. Use to disable Continue button and show loading. */
-    isSubmitting: boolean;
-}

package/dist/types/main-login.d.ts

@@ -1,40 +0,0 @@
-/** Handlers exposed by the main auth page (method select). */
-export interface MainAuthPageHandlers {
-    /** Called when the user selects "Continue with Mobile". */
-    onContinueWithMobile: () => void;
-    /** Called when the user selects "Continue with Email". */
-    onContinueWithEmail: () => void;
-    /** Called when the user selects "Continue with Google". */
-    onContinueWithGoogle: () => void;
-    /** Called when the user selects "Continue with Apple". */
-    onContinueWithApple: () => void;
-}
-/** Config for lib-handled Google sign-in. When set, the lib runs the OAuth flow and calls onCredential. */
-export interface MainLoginGoogleProviderConfig {
-    /** Google OAuth 2.0 client ID. */
-    clientId: string;
-    /** Called with ID token (One Tap) or auth code (button popup). Send to your backend to verify. */
-    onCredential: (credential: string) => void;
-    /** Enable Google One Tap prompt for automatic sign-in. */
-    enableOneTap?: boolean;
-}
-/** Config for lib-handled Apple sign-in (stub). When set, the lib will run the flow and call onCredential when implemented. */
-export interface MainLoginAppleProviderConfig {
-    /** Apple Services ID (client ID) configured in the Apple Developer portal. */
-    clientId: string;
-    /** OAuth redirect URI registered with Apple for the sign-in flow. */
-    redirectUri: string;
-    /** Called with the Apple identity token after a successful sign-in. Send to your backend to verify. */
-    onCredential: (credential: string) => void;
-}
-/** Optional provider config so the lib handles Google/Apple API calls. */
-export interface MainLoginPageProvidersConfig {
-    /** Google sign-in configuration. When set, the lib handles the Google OAuth flow. */
-    google?: MainLoginGoogleProviderConfig;
-    /** Apple sign-in configuration. When set, the lib handles the Apple OAuth flow. */
-    apple?: MainLoginAppleProviderConfig;
-}
-/** Options for useMainAuthPageHandlers: optional callback overrides + optional provider config for lib-handled OAuth. */
-export type UseMainAuthPageHandlersOptions = Partial<MainAuthPageHandlers> & {
-    providers?: MainLoginPageProvidersConfig;
-};