doct-ui-auth-kit 1.0.2 → 1.0.4

package/dist/pages/index.d.ts

@@ -1,5 +1,5 @@
-export { LoginEntry, type LoginEntryMode, type LoginEntryProps, } from './login-entry';
-export { MainLogin, type MainLoginProps } from './main-login';
-export { OtpVerification, type OtpVerificationMode, type OtpVerificationProps, } from './otp-verification';
-export { RepeatLogin, type RepeatLoginProps } from './repeat-login';
-export { type SignupEntryMode, SignupPage, type SignupPageProps, } from './signup';
+export { type LoginEntryMode, LoginEntryPage, type LoginEntryPageProps, type LoginEntryProps, } from './login-entry';
+export { type MainLoginAppleProviderConfig, type MainLoginGoogleProviderConfig, MainLoginPage, type MainLoginPageProps, type MainLoginPageProvidersConfig, } from './main-login';
+export { type OtpVerificationMode, OtpVerificationPage, type OtpVerificationPageProps, type OtpVerificationProps, } from './otp-verification';
+export { RepeatLoginPage, type RepeatLoginPageProps, type RepeatLoginProps, } from './repeat-login';
+export { SignupPage, type SignupPageFullProps, type SignupPageProps, } from './signup';

package/dist/pages/login-entry.d.ts

@@ -1,23 +1,42 @@
-import type { LoginEntryMode } from '@/hooks/use-login-entry-form';
-export type { LoginEntryMode };
-export interface LoginEntryProps {
-    /** Mode: phone number or email input */
-    mode: LoginEntryMode;
-    /** Override title (consumers render via AuthLayout.Title) */
-    title?: string;
-    /** Override subtitle (consumers render via AuthLayout.Description) */
-    subtitle?: string;
-    /** Handler when back button is clicked (consumers render back button in AuthLayout.Logo) */
-    onBack?: () => void;
-    /** Handler when form is submitted with valid phone or email */
-    onSubmit?: (data: {
-        phone?: string;
-        email?: string;
-    }) => void;
-}
+import type { LoginEntryPageProps, LoginEntryProps } from '@/types';
+export type { LoginEntryMode, LoginEntryPageProps, LoginEntryProps, } from '@/types';
 /**
- * Login entry screen: single form for phone or email based on mode.
- * Uses FormProvider and react-hook-form. Slot into AuthLayout.Body;
- * layout (MainLayout, AuthLayout with Logo, Title, etc.) is provided by the consumer.
+ * Full LoginEntry page with AuthLayoutWrapper, back button, and slider/standalone layout.
+ * Use when rendering the login entry screen as a standalone page.
+ *
+ * @example Next.js: API call in hook, redirect via callback
+ * ```tsx
+ * <LoginEntryPage
+ *   mode="phone"
+ *   onBack={() => router.back()}
+ *   submitApi={(data) => api.sendOtp(data)}
+ *   onSuccess={() => router.push('/otp')}
+ * />
+ * ```
+ *
+ * @example Sync callback (caller owns API)
+ * ```tsx
+ * <LoginEntryPage mode="phone" onSubmit={(data) => sendOtp(data)} />
+ * ```
  */
-export declare function LoginEntry({ mode, onSubmit }: Readonly<LoginEntryProps>): import("react/jsx-runtime").JSX.Element;
+export declare function LoginEntryPage(props: Readonly<LoginEntryPageProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Login entry form body without layout wrapper.
+ * Single form for phone or email based on mode. Use inside your own layout or AuthFlow.
+ * Validation per PRODUCT_PROTOCOLS and edge cases 3–5, 18; cursor focus on first field (#26).
+ *
+ * @example With AuthFlow (sync onSubmit)
+ * ```tsx
+ * <LoginEntry mode="phone" onSubmit={(data) => actions.submitIdentifier(data)} />
+ * ```
+ *
+ * @example Standalone Next.js (API + redirect in hook)
+ * ```tsx
+ * <LoginEntry
+ *   mode="phone"
+ *   submitApi={(data) => api.sendOtp(data)}
+ *   onSuccess={() => router.push('/otp')}
+ * />
+ * ```
+ */
+export declare function LoginEntry(props: Readonly<LoginEntryProps>): import("react/jsx-runtime").JSX.Element;

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

@@ -1,16 +1,32 @@
-export interface MainLoginProps {
-    /** Handler for "Continue with Mobile". */
-    onContinueWithMobile?: () => void;
-    /** Handler for "Continue with Email". */
-    onContinueWithEmail?: () => void;
-    /** Handler for "Continue with Google" (custom button; parent wires useGoogleAuth.loginWithGoogle when configured). */
-    onContinueWithGoogle?: () => void;
-    /** Handler for "Continue with Apple". */
-    onContinueWithApple?: () => void;
-}
+import type { MainLoginPageProps } from '@/types';
+export type { MainLoginAppleProviderConfig, MainLoginGoogleProviderConfig, MainLoginPageProps, MainLoginPageProvidersConfig, } from '@/types';
 /**
- * Main login page body: four sign-in options (Mobile, Email, Google, Apple).
- * Intended to be slotted into AuthLayout.Body. Layout shell (AuthLayout with
- * Logo, Title, Description) is provided by the app or story.
+ * Full MainLogin page with AuthLayoutWrapper, header, footer, and slider layout.
+ * Includes default branding and layout configuration.
+ *
+ * @example
+ * ```tsx
+ * <MainLoginPage
+ *   onContinueWithMobile={() => navigate('/auth/phone')}
+ *   onContinueWithEmail={() => navigate('/auth/email')}
+ *   onContinueWithGoogle={() => navigate('/auth/google')}
+ *   onContinueWithApple={() => navigate('/auth/apple')}
+ * />
+ * ```
  */
-export declare function MainLogin({ onContinueWithMobile, onContinueWithEmail, onContinueWithGoogle, onContinueWithApple, }: Readonly<MainLoginProps>): import("react/jsx-runtime").JSX.Element;
+export declare const MainLoginPage: (props: Readonly<MainLoginPageProps>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Login body component without layout wrapper.
+ * Displays four authentication method buttons (Mobile, Email, Google, Apple).
+ *
+ * Use this when you need custom layout or when integrating with AuthFlow.
+ *
+ * @example
+ * ```tsx
+ * <MainLogin
+ *   onContinueWithMobile={() => navigate('/auth/phone')}
+ *   onContinueWithEmail={() => navigate('/auth/email')}
+ * />
+ * ```
+ */
+export declare function MainLogin(props: Readonly<MainLoginPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/otp-verification.d.ts

@@ -1,23 +1,45 @@
-import type { OtpVerificationMode } from '@/hooks/use-otp-verification';
-export type { OtpVerificationMode };
-export interface OtpVerificationProps {
-    /** Mode: mobile (phone) or email OTP */
-    mode: OtpVerificationMode;
-    /** Title override. Default: "6 digit OTP has been sent to your Mobile" | "..." Email */
-    title?: string;
-    /** Masked phone (e.g. "+91 9825910X0X") or email (e.g. "j***@gmail.com") */
-    recipientDisplay: string;
-    /** When true, show instruction line ("Kindly check your Email Inbox."). Used for foreign user flow. */
-    isForeignUser?: boolean;
-    /** Handler when back is clicked */
-    onBack?: () => void;
-    /** Handler when form is submitted with valid 6-digit OTP */
-    onSubmit?: (otp: string) => void;
-    /** Handler when user requests resend code */
-    onResendCode?: () => void;
-}
+import type { OtpVerificationPageProps, OtpVerificationProps } from '@/types';
+export type { OtpVerificationMode, OtpVerificationPageProps, OtpVerificationProps, } from '@/types';
 /**
- * OTP verification screen: 6-digit OTP input, resend countdown, and submit.
- * Slot into AuthLayout.Body; layout shell is provided by the consumer.
+ * Full OTP verification page with AuthLayoutWrapper and back button.
+ * Use when rendering the OTP screen as a standalone page.
+ *
+ * @example Next.js: API in hook, redirect from consumer
+ * ```tsx
+ * <OtpVerificationPage
+ *   mode="phone"
+ *   recipientDisplay="+91 9825910X0X"
+ *   onBack={() => router.back()}
+ *   submitApi={(otp) => api.verifyOtp(otp)}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onResendCode={() => api.resendOtp()}
+ * />
+ * ```
+ *
+ * @example Sync callback (AuthFlow)
+ * ```tsx
+ * <OtpVerificationPage onSubmit={(otp) => actions.verifyOtp(otp)} ... />
+ * ```
  */
-export declare function OtpVerification({ mode, title, recipientDisplay, isForeignUser, onSubmit, onResendCode, }: Readonly<OtpVerificationProps>): import("react/jsx-runtime").JSX.Element;
+export declare function OtpVerificationPage(props: Readonly<OtpVerificationPageProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * OTP verification form body without layout wrapper.
+ * 6-digit OTP input, resend countdown, and submit. Use inside your own layout or AuthFlow.
+ * Validation per edge cases 6, 7 (invalid/expired OTP); cursor focus on first OTP box (#26).
+ *
+ * @example With submitApi + onSuccess (consumer redirect)
+ * ```tsx
+ * <OtpVerification
+ *   mode="phone"
+ *   recipientDisplay="+91 9825910X0X"
+ *   submitApi={(otp) => api.verifyOtp(otp)}
+ *   onSuccess={() => router.push('/dashboard')}
+ * />
+ * ```
+ *
+ * @example Sync onSubmit (AuthFlow)
+ * ```tsx
+ * <OtpVerification onSubmit={(otp) => actions.verifyOtp(otp)} ... />
+ * ```
+ */
+export declare function OtpVerification(props: Readonly<OtpVerificationProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/repeat-login.d.ts

@@ -1,20 +1,49 @@
-export interface RepeatLoginProps {
-    /**
-     * Last used authentication method shown in the primary button label.
-     * Example: "Mobile", "Email".
-     *
-     * @default "Mobile"
-     */
-    lastUsedMethod?: string;
-    /** Handler for the primary action (continue with last used method). */
-    onContinueWithLastMethod?: () => void;
-    /** Handler for the secondary action (choose another method). */
-    onUseAnotherMethod?: () => void;
-}
+import type { RepeatLoginPageProps, RepeatLoginProps } from '@/types';
+export type { RepeatLoginPageProps, RepeatLoginProps } from '@/types';
 /**
- * Repeat login page body: primary CTA (continue with last method) and secondary
- * "Use another method" button. Intended to be slotted into AuthLayout.Body.
- * Layout shell (AuthLayout with Logo, Title, Description) is provided by the
- * app or story.
+ * Full Repeat Login page with AuthLayoutWrapper, logo, title, description, and footer.
+ * Use when rendering the repeat login screen as a standalone page.
+ *
+ * @example Next.js: API in lib, redirect from consumer
+ * ```tsx
+ * <RepeatLoginPage
+ *   lastUsedMethod="Mobile"
+ *   continueApi={() => api.validateSession()}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onUseAnotherMethod={() => resetFlow()}
+ * />
+ * ```
+ *
+ * @example Sync (AuthFlow)
+ * ```tsx
+ * <RepeatLoginPage
+ *   onContinueWithLastMethod={() => actions.continueWithLastMethod()}
+ *   onUseAnotherMethod={() => actions.reset()}
+ * />
+ * ```
  */
-export declare function RepeatLogin({ lastUsedMethod, onContinueWithLastMethod, onUseAnotherMethod, }: Readonly<RepeatLoginProps>): import("react/jsx-runtime").JSX.Element;
+export declare function RepeatLoginPage(props: Readonly<RepeatLoginPageProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Repeat login body without layout wrapper.
+ * Primary CTA (continue with last method) and secondary "Use another method" button.
+ * When continueApi is provided, primary runs: continueApi() → onSuccess() (e.g. redirect).
+ *
+ * @example With continueApi + onSuccess (consumer redirect)
+ * ```tsx
+ * <RepeatLogin
+ *   lastUsedMethod="Mobile"
+ *   continueApi={() => api.validateSession()}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onUseAnotherMethod={() => resetFlow()}
+ * />
+ * ```
+ *
+ * @example Sync (AuthFlow)
+ * ```tsx
+ * <RepeatLogin
+ *   onContinueWithLastMethod={() => actions.continueWithLastMethod()}
+ *   onUseAnotherMethod={() => actions.reset()}
+ * />
+ * ```
+ */
+export declare function RepeatLogin(props: Readonly<RepeatLoginProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/signup.d.ts

@@ -1,25 +1,45 @@
-import type { UserType } from '@/core/auth-types';
-import type { IdentifierType } from '@/core/use-auth-flow';
-import type { SignupEntryMode } from '@/hooks/use-signup-form';
-export type { SignupEntryMode };
-export interface SignupPageProps {
-    /** Indian: which field to collect. Foreign: use 'foreign' mode (name + email + phone). */
-    userType: UserType;
-    /** How user started (phone or email). */
-    loginMethod: IdentifierType;
-    /** Indian only: which field to collect (phone or email). */
-    signupCollectField: IdentifierType;
-    /** Foreign only: phone when user entered phone before signup details. */
-    pendingPhone?: string;
-    /** Handler when form is submitted. */
-    onSubmit?: (data: {
-        fullName: string;
-        phone?: string;
-        email?: string;
-    }) => void;
-}
+import type { SignupPageFullProps, SignupPageProps } from '@/types';
+export type { SignupEntryMode, SignupPageFullProps, SignupPageProps, } from '@/types';
 /**
- * Signup screen: full name plus phone/email (Indian) or full name + email + phone (Foreign).
- * Always uses standalone layout when used in auth flow.
+ * Full Signup page with AuthLayoutWrapper, logo, and default welcome copy.
+ * Use when rendering the signup screen as a standalone page.
+ *
+ * @example Next.js: API in hook, redirect from consumer
+ * ```tsx
+ * <SignupPage
+ *   userType="INDIAN"
+ *   loginMethod="phone"
+ *   signupCollectField="email"
+ *   submitApi={(data) => api.completeProfile(data)}
+ *   onSuccess={() => router.push('/otp')}
+ * />
+ * ```
+ *
+ * @example Sync onSubmit (AuthFlow)
+ * ```tsx
+ * <SignupPage onSubmit={(data) => actions.submitSignupDetails(data)} ... />
+ * ```
  */
-export declare function SignupPage({ userType, signupCollectField, pendingPhone, onSubmit, }: Readonly<SignupPageProps>): import("react/jsx-runtime").JSX.Element;
+export declare function SignupPage(props: Readonly<SignupPageFullProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Signup form body without layout wrapper.
+ * Full name plus phone/email (Indian) or full name + email + phone (Foreign).
+ * Validation per PRODUCT_PROTOCOLS #1, #25 and edge cases 9, 10, 16, 19; cursor focus on first field (#26).
+ * Use inside your own layout or AuthFlow.
+ *
+ * @example With submitApi + onSuccess (consumer redirect)
+ * ```tsx
+ * <Signup
+ *   userType="INDIAN"
+ *   signupCollectField="email"
+ *   submitApi={(data) => api.completeProfile(data)}
+ *   onSuccess={() => router.push('/otp')}
+ * />
+ * ```
+ *
+ * @example Sync onSubmit (AuthFlow)
+ * ```tsx
+ * <Signup onSubmit={(data) => actions.submitSignupDetails(data)} ... />
+ * ```
+ */
+export declare function Signup(props: Readonly<SignupPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages.js

@@ -1,8 +1,8 @@
-import { L as n, M as o, O as e, R as g, S as s } from "./signup-x-Jm7XKn.js";
+import { L as g, M as i, O as n, R as o, S as s } from "./signup-BpiNvZy4.js";
 export {
-  n as LoginEntry,
-  o as MainLogin,
-  e as OtpVerification,
-  g as RepeatLogin,
+  g as LoginEntryPage,
+  i as MainLoginPage,
+  n as OtpVerificationPage,
+  o as RepeatLoginPage,
   s as SignupPage
 };