doct-ui-auth-kit 1.0.13 → 1.0.15

package/dist/adapters/http-auth-adapter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reference HTTP adapter for connecting to a real auth API (e.g. doct-auth-mock-api).
+ * Consumers can use this adapter directly or create their own implementing `AuthApiAdapter`.
+ * Usage: `SSOAuthProvider config={{ apiAdapter: createHttpAuthAdapter('http://localhost:3001') }}`
+ */
+import type { AuthApiAdapter } from '../core/auth-api-adapter';
+/**
+ * Creates an AuthApiAdapter that calls the given API base URL.
+ * Expects routes: POST /api/auth/send-otp, verify-otp, complete-profile,
+ * authenticate-provider, validate-session, refresh-session; GET validate-session
+ * (with credentials) for validateSessionFromCookie.
+ */
+export declare function createHttpAuthAdapter(baseUrl: string): AuthApiAdapter;

package/dist/adapters/index.d.ts

@@ -0,0 +1 @@
+export { createHttpAuthAdapter } from './http-auth-adapter';

package/dist/auth/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Simple Auth API — `Auth.Provider` / `Auth.Login` / `Auth.Signup` / `Auth.Otp`.
+ * Less flexible but zero-config for basic usage. For full control, use
+ * SSOAuthProvider + individual page components directly.
+ */
+import { SSOAuthProvider } from '../core/auth-provider';
+import type { OtpVerificationProps } from '../pages/otp-verification';
+import type { SignupPageProps } from '../pages/signup';
+/** Simple API: full login/signup flow (method select → identifier → OTP → profile). Use inside Auth.Provider. */
+declare function AuthLogin(): React.ReactElement;
+/** Simple API: signup (profile completion) screen with signup layout preset. Layout only; pass props for behavior. */
+declare function AuthSignup(props: SignupPageProps): React.ReactElement;
+/** Simple API: OTP verification screen with verification layout preset. Layout only; pass props for behavior. */
+declare function AuthOtp(props: OtpVerificationProps): React.ReactElement;
+/**
+ * Auth SDK simple + namespace API.
+ * - Auth.Provider: config (methods, MFA, rememberMe, apiAdapter, callbacks).
+ * - Auth.Login: full flow (simple).
+ * - Auth.Signup: signup screen with signup preset (simple).
+ * - Auth.Otp: OTP screen with verification preset (simple).
+ */
+export declare const Auth: {
+    Provider: typeof SSOAuthProvider;
+    Login: typeof AuthLogin;
+    Signup: typeof AuthSignup;
+    Otp: typeof AuthOtp;
+};
+export type { SignupPageProps, OtpVerificationProps };

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

@@ -0,0 +1,19 @@
+/**
+ * Apple Sign-In (future-ready stub).
+ * Implement when backend supports Apple ID credential validation.
+ */
+export interface UseAppleSignInOptions {
+    /** Apple client ID (Services ID). */
+    clientId: string;
+    /** Redirect URI registered in Apple Developer. */
+    redirectUri: string;
+    /** Callback when user signs in; receives the authorization code or id_token. */
+    onCredential: (credential: string) => void;
+}
+/**
+ * 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): {
+    triggerSignIn: () => void;
+};

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

@@ -0,0 +1,5 @@
+/**
+ * Google Identity Services: custom button + optional One Tap.
+ * Use useGoogleAuth and render your own button that calls loginWithGoogle.
+ */
+export { type UseGoogleAuthOptions, type UseGoogleAuthReturn, useGoogleAuth, } from './use-google-auth';

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

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

package/dist/auth-methods/use-google-auth.d.ts

@@ -0,0 +1,69 @@
+/** GSI callback payload when user signs in. */
+interface CredentialResponse {
+    credential: string;
+}
+/** OAuth2 Code Client callback payload (popup mode). */
+interface CodeResponse {
+    code: string;
+}
+declare global {
+    interface Window {
+        google?: {
+            accounts: {
+                id: {
+                    initialize: (config: {
+                        client_id: string;
+                        callback: (response: CredentialResponse) => void;
+                        auto_select?: boolean;
+                        /**
+                         * When false, avoids using FedCM for One Tap prompts (helps when FedCM is
+                         * disabled via browser/site settings).
+                         */
+                        use_fedcm_for_prompt?: boolean;
+                    }) => void;
+                    prompt: (momentListener?: (moment: {
+                        getMomentType: () => string;
+                    }) => void) => void;
+                };
+                oauth2: {
+                    initCodeClient: (config: {
+                        client_id: string;
+                        scope: string;
+                        ux_mode: 'popup';
+                        callback: (response: CodeResponse) => void;
+                        error_callback?: (error: {
+                            type: string;
+                            message?: string;
+                        }) => void;
+                    }) => {
+                        requestCode: () => void;
+                    };
+                };
+            };
+        };
+    }
+}
+export interface UseGoogleAuthOptions {
+    /** Google OAuth 2.0 client ID. Hook is a no-op when empty. */
+    clientId: string;
+    /**
+     * Called with a Google credential suitable for backend verification.
+     *
+     * - **One Tap** returns an **ID token**.
+     * - **Button click** uses OAuth popup and returns an **authorization code**.
+     *
+     * Your backend should verify/exchange this value for a session.
+     */
+    onCredential: (credential: string) => void;
+    /** When true, shows One Tap prompt automatically after init. Default false. */
+    enableOneTap?: boolean;
+}
+export interface UseGoogleAuthReturn {
+    /**
+     * Opens the Google sign-in popup (OAuth code flow).
+     * Intended for use with a custom "Continue with Google" button.
+     */
+    loginWithGoogle: () => Promise<void>;
+}
+export declare function useGoogleAuth({ clientId, onCredential, enableOneTap, }: UseGoogleAuthOptions): UseGoogleAuthReturn;
+export {};

package/dist/components/common/back-button.d.ts

@@ -0,0 +1,13 @@
+/** Props for the shared auth back button. */
+export interface BackButtonProps {
+    /** Click handler that navigates the user back. */
+    onClick: () => void;
+    /** Optional aria-label override. @default 'Go back' */
+    ariaLabel?: string;
+}
+/**
+ * Outlined square back button used at the top of auth pages
+ * (LoginEntry, OtpVerification, etc.). 36px box with a 20px arrow,
+ * 2px neutral-10 border and 10px radius — matches Figma spec.
+ */
+export declare function BackButton({ onClick, ariaLabel, }: Readonly<BackButtonProps>): import("react/jsx-runtime").JSX.Element;

package/dist/components/common/default-footer.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared demo footer with Docthub terms and privacy links.
+ * Used in auth flow and stories (MainLogin, RepeatLogin, AuthLayout, etc.).
+ */
+export declare function DefaultFooter(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+import type { RHFDoctPhoneInputFieldProps } from '../../types/components/forms';
+export declare function RHFDoctPhoneInputField({ name, label, countryCode, countryCodeName, phoneArrayName, selectedCountryName, countries, defaultCountry, onValuesChange, onCountryChange, onCountryCodeChange, placeholder, disabled, required, className, helperText, control, ...doctPhoneInputProps }: Readonly<RHFDoctPhoneInputFieldProps>): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+import type { RHFInputFieldProps } from '../../types/components/forms';
+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

@@ -0,0 +1,3 @@
+import type { RHFOtpInputFieldProps } from '../../types/components/forms';
+/** RHF-controlled wrapper around `DoctOtpInput` from docthub-core-components. Manages a string[] field value for OTP digit inputs. */
+export declare function RHFOtpInputField({ name, label, className, control, length, inputClassName, autoFocus, }: RHFOtpInputFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/layout/auth-layout-preset.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from 'react';
+import type { LayoutPresetName } from '../../types/components/layout-presets';
+export interface AuthLayoutPresetProps {
+    /**
+     * Preset name. Controls structure only (layoutType, variant, maxWidth, contentWidth, align).
+     * Use "" for no preset (children rendered as-is; use AuthLayout.Root for full composition).
+     */
+    preset: LayoutPresetName;
+    /** Main content (e.g. form). Rendered in layout body. */
+    children: ReactNode;
+    /** Optional slot overrides. When not provided, slot is empty. */
+    logo?: ReactNode;
+    /** Title element or string rendered below the logo. */
+    title?: ReactNode;
+    /** Description element or string rendered below the title. */
+    description?: ReactNode;
+    /** Footer element rendered at the bottom of the layout. */
+    footer?: ReactNode;
+    /** Header element rendered above the main content area. */
+    header?: ReactNode;
+    /** Custom back button element rendered in place of the logo slot. */
+    backButton?: ReactNode;
+    /** Extra class for root. */
+    className?: string;
+}
+/**
+ * Layout shell driven by a preset. Structure only — no auth logic.
+ * Use for advanced usage when you need a consistent layout without wiring AuthFlow.
+ */
+export declare function AuthLayoutPreset({ preset, children, logo, title, description, footer, header, backButton, className, }: AuthLayoutPresetProps): React.ReactElement;

package/dist/components/layout/auth-layout-public.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Public AuthLayout API: compound components + preset-based layout.
+ * Merged here to avoid circular dependencies (preset uses wrapper, wrapper uses compound).
+ */
+import { AuthLayoutPreset } from './auth-layout-preset';
+/** Compound layout + preset-based layout. Use .Root/.Header/... for composition, .Preset for preset. */
+export declare const AuthLayout: {
+    Preset: typeof AuthLayoutPreset;
+    Root: ({ children, variant, maxWidth, className, }: Readonly<import(".").AuthLayoutRootProps>) => import("react/jsx-runtime").JSX.Element;
+    Header: ({ children, className, }: Readonly<import(".").AuthLayoutHeaderProps>) => import("react/jsx-runtime").JSX.Element;
+    Main: ({ children, sm, className, }: Readonly<import(".").AuthLayoutMainProps>) => import("react/jsx-runtime").JSX.Element;
+    Logo: ({ children, align, className, }: Readonly<import(".").AuthLayoutLogoProps>) => import("react/jsx-runtime").JSX.Element;
+    Title: ({ children, align, className, }: Readonly<import(".").AuthLayoutTitleProps>) => import("react/jsx-runtime").JSX.Element;
+    Description: ({ children, align, className, }: Readonly<import(".").AuthLayoutDescriptionProps>) => import("react/jsx-runtime").JSX.Element;
+    Body: ({ children, className, }: Readonly<import(".").AuthLayoutBodyProps>) => import("react/jsx-runtime").JSX.Element;
+    Footer: ({ children, className, }: Readonly<import(".").AuthLayoutFooterProps>) => import("react/jsx-runtime").JSX.Element;
+};

package/dist/components/layout/auth-layout-wrapper.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+import type { AuthLayoutAlign, AuthLayoutMaxWidth, AuthLayoutVariant } from '../../types/components/auth-layout-types';
+/** Layout mode: `'withSlider'` renders inside a split-screen with an image slider, `'standalone'` renders without. */
+export type AuthLayoutType = 'withSlider' | 'standalone';
+/** Props for the AuthLayoutWrapper component that assembles the auth page shell. */
+export interface AuthLayoutWrapperProps {
+    /** Main content (typically the form body) rendered inside the layout. */
+    children: ReactNode;
+    /** Layout mode controlling the outer chrome. @default `'withSlider'` */
+    layoutType?: AuthLayoutType;
+    /** Logo or back-button element rendered at the top of the content area. */
+    logo?: ReactNode;
+    /** Heading element or string rendered below the logo. */
+    title?: ReactNode;
+    /** Descriptive text or element rendered below the title. */
+    description?: ReactNode;
+    /** Footer element rendered at the bottom of the content area. */
+    footer?: ReactNode;
+    /** Header element rendered above the main content area. */
+    header?: ReactNode;
+    /** Called when the back button is clicked. Pass `null` to hide the back button explicitly. */
+    onBack?: (() => void) | null;
+    /** Custom back button element. When provided, overrides the default back arrow button. */
+    backButton?: ReactNode;
+    /** Image URLs for the slider panel (only used when `layoutType` is `'withSlider'`). */
+    sliderImages?: string[];
+    /** Auto-play interval in milliseconds for the slider. */
+    sliderAutoPlayInterval?: number;
+    /** Titles displayed alongside each slider image. */
+    sliderTitles?: (ReactNode | string)[];
+    /** Layout variant controlling responsive behavior (e.g. `'desktop'`, `'mobile'`). */
+    variant?: AuthLayoutVariant | undefined;
+    /** Maximum width constraint for the content area (e.g. `'sm'`, `'md'`, `'lg'`). @default `'sm'` */
+    maxWidth?: AuthLayoutMaxWidth;
+    /** Content width preset: `'sm'` for narrow forms, `'default'` for standard width. @default `'default'` */
+    contentWidth?: 'sm' | 'default';
+    /** Horizontal alignment of logo, title, and description. @default `'center'` */
+    align?: AuthLayoutAlign;
+    /** Additional CSS class name(s) applied to the outermost layout element. */
+    className?: string;
+}
+export declare function AuthLayoutWrapper({ children, layoutType, logo, title, description, footer, header, onBack, backButton, sliderImages, sliderAutoPlayInterval, sliderTitles, variant, maxWidth, contentWidth, align, className, }: AuthLayoutWrapperProps): React.ReactElement;

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

@@ -0,0 +1,89 @@
+import type { AuthLayoutBodyProps, AuthLayoutDescriptionProps, AuthLayoutFooterProps, AuthLayoutHeaderProps, AuthLayoutLogoProps, AuthLayoutMainProps, AuthLayoutRootProps, AuthLayoutTitleProps } from '../../types/components/auth-layout-types';
+/**
+ * Root container component for auth layouts.
+ * Provides layout context to child slot components.
+ *
+ * @example
+ * ```tsx
+ * <AuthLayout.Root variant="desktop" maxWidth="md">
+ *   <AuthLayout.Header>...</AuthLayout.Header>
+ *   <AuthLayout.Logo>...</AuthLayout.Logo>
+ *   <AuthLayout.Title>...</AuthLayout.Title>
+ *   <AuthLayout.Description>...</AuthLayout.Description>
+ *   <AuthLayout.Body>...</AuthLayout.Body>
+ *   <AuthLayout.Footer>...</AuthLayout.Footer>
+ * </AuthLayout.Root>
+ * ```
+ */
+declare function AuthLayoutRoot({ children, variant, maxWidth, className, }: Readonly<AuthLayoutRootProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Header slot component - renders differently based on layout variant.
+ * In desktop variant, renders top-right. In mobile variant, renders above logo.
+ */
+declare function AuthLayoutHeader({ children, className, }: Readonly<AuthLayoutHeaderProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Logo slot component - alignment configurable via align prop
+ */
+declare function AuthLayoutLogo({ children, align, className, }: Readonly<AuthLayoutLogoProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Title slot component - alignment configurable via align prop
+ */
+declare function AuthLayoutTitle({ children, align, className, }: Readonly<AuthLayoutTitleProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Description slot component - alignment configurable via align prop
+ */
+declare function AuthLayoutDescription({ children, align, className, }: Readonly<AuthLayoutDescriptionProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Body slot component - main content area with vertical spacing
+ */
+declare function AuthLayoutBody({ children, className, }: Readonly<AuthLayoutBodyProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Main content wrapper - centers and constrains width of inner slots
+ */
+declare function AuthLayoutMain({ children, sm, className, }: Readonly<AuthLayoutMainProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Footer slot component - centered with consistent spacing
+ */
+declare function AuthLayoutFooter({ children, className, }: Readonly<AuthLayoutFooterProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Compound component for authentication layouts.
+ * Uses composition pattern for maximum flexibility and scalability.
+ *
+ * @example
+ * ```tsx
+ * <AuthLayout.Root variant="desktop" maxWidth="md">
+ *   <AuthLayout.Header>
+ *     <EnterpriseHeader />
+ *   </AuthLayout.Header>
+ *   <AuthLayout.Main>
+ *     <AuthLayout.Logo>
+ *       <img src="/logo.svg" alt="Docthub" />
+ *     </AuthLayout.Logo>
+ *     <AuthLayout.Title>
+ *       <h1>The Healthcare Career App</h1>
+ *     </AuthLayout.Title>
+ *     <AuthLayout.Description>
+ *       <p>Continue to Signup</p>
+ *     </AuthLayout.Description>
+ *     <AuthLayout.Body>
+ *       <button>Continue with Mobile</button>
+ *       <button>Continue with Email</button>
+ *     </AuthLayout.Body>
+ *   </AuthLayout.Main>
+ *   <AuthLayout.Footer>
+ *     <p>Terms and Privacy</p>
+ *   </AuthLayout.Footer>
+ * </AuthLayout.Root>
+ * ```
+ */
+export declare const AuthLayout: {
+    Root: typeof AuthLayoutRoot;
+    Header: typeof AuthLayoutHeader;
+    Main: typeof AuthLayoutMain;
+    Logo: typeof AuthLayoutLogo;
+    Title: typeof AuthLayoutTitle;
+    Description: typeof AuthLayoutDescription;
+    Body: typeof AuthLayoutBody;
+    Footer: typeof AuthLayoutFooter;
+};
+export {};

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

@@ -0,0 +1,28 @@
+import type { ImageSliderProps } from '../../types';
+export type { ImageSliderProps } from '../../types';
+/**
+ * Image slider component with indicator dots.
+ * Supports both controlled and uncontrolled modes.
+ *
+ * @example Uncontrolled mode (manages its own state)
+ * ```tsx
+ * <ImageSlider
+ *   images={['/image1.jpg', '/image2.jpg']}
+ *   autoPlayInterval={3000}
+ *   onSlideChange={(index) => console.log('Slide changed to', index)}
+ * />
+ * ```
+ *
+ * @example Controlled mode (parent manages state)
+ * ```tsx
+ * const [activeIndex, setActiveIndex] = useState(0);
+ *
+ * <ImageSlider
+ *   images={['/image1.jpg', '/image2.jpg']}
+ *   activeIndex={activeIndex}
+ *   onSlideChange={setActiveIndex}
+ *   onNavigate={setActiveIndex}
+ * />
+ * ```
+ */
+export declare function ImageSlider({ images, autoPlayInterval, className, hideIndicators, onSlideChange, activeIndex: controlledIndex, onNavigate, }: Readonly<ImageSliderProps>): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/layout/index.d.ts

@@ -0,0 +1,8 @@
+export type { AuthLayoutAlign, AuthLayoutBodyProps, AuthLayoutDescriptionProps, AuthLayoutFooterProps, AuthLayoutHeaderProps, AuthLayoutLogoProps, AuthLayoutMainProps, AuthLayoutMaxWidth, AuthLayoutRootProps, AuthLayoutTitleProps, AuthLayoutVariant, } from '../../types/components/auth-layout-types';
+export { AuthLayoutPreset, type AuthLayoutPresetProps, } from './auth-layout-preset';
+export { AuthLayout } from './auth-layout-public';
+export { type AuthLayoutType, AuthLayoutWrapper, type AuthLayoutWrapperProps, } from './auth-layout-wrapper';
+export type { ImageSliderProps } from './image-slider';
+export { ImageSlider } from './image-slider';
+export type { MainLayoutProps } from './main-layout';
+export { MainLayout } from './main-layout';

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

@@ -0,0 +1,30 @@
+import type { MainLayoutProps, MarketingPanelProps } from '../../types';
+export type { MainLayoutProps, MarketingPanelProps } from '../../types';
+/**
+ * Marketing panel component - displays CTA, image slider, and indicators
+ */
+declare function MarketingPanel({ sliderImages, sliderAutoPlayInterval, activeSlideIndex, onSlideChange, ctaText, sliderTitles, className, }: Readonly<MarketingPanelProps>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Main layout component - two-panel layout for authentication pages.
+ * Left panel displays marketing content, right panel displays auth content.
+ *
+ * @example
+ * ```tsx
+ * <MainLayout
+ *   sliderImages={['/image1.jpg', '/image2.jpg']}
+ *   ctaText="Get Healthcare Career App Now!"
+ * >
+ *   <AuthLayout.Root variant="desktop" maxWidth="md">
+ *     <AuthLayout.Header>...</AuthLayout.Header>
+ *     <AuthLayout.Main>
+ *       <AuthLayout.Logo>...</AuthLayout.Logo>
+ *       <AuthLayout.Title>...</AuthLayout.Title>
+ *       <AuthLayout.Body>...</AuthLayout.Body>
+ *     </AuthLayout.Main>
+ *     <AuthLayout.Footer>...</AuthLayout.Footer>
+ *   </AuthLayout.Root>
+ * </MainLayout>
+ * ```
+ */
+export declare function MainLayout({ sliderImages, sliderAutoPlayInterval, ctaText, sliderTitles, className, marketingClassName, contentClassName, children, }: Readonly<MainLayoutProps>): import("react/jsx-runtime").JSX.Element;
+export { MarketingPanel };

package/dist/constants/brand.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Brand asset paths used by auth pages.
+ * Consumers can serve these from their own /public directory or override
+ * the asset by replacing the file.
+ */
+/** Primary Docthub wordmark used in the auth page header. */
+export declare const BRAND_LOGO_URL = "/main-logo.svg";
+/** Compact Docthub mark used on the signup page. */
+export declare const SIGNUP_LOGO_URL = "/docthub.svg";

package/dist/constants/demo-slider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Demo data for MainLayout marketing slider.
+ * Used in Storybook and anywhere a consistent demo slider is needed.
+ */
+/**
+ * Marketing slider images exported from Figma.
+ * These are static PNG images saved in /public/slider/.
+ *
+ * To update: Export frames from Figma (nodes 2179:2215, 2179:2226, 2179:2236, 2179:2246, 2179:2256)
+ * and save as slide-1.png through slide-5.png in the public/slider/ directory.
+ */
+export declare const DEMO_SLIDER_IMAGES: string[];
+/** Default auto-play interval (ms) for the demo slider. */
+export declare const DEMO_SLIDER_AUTO_PLAY_INTERVAL = 5000;

package/dist/constants/index.d.ts

@@ -0,0 +1,4 @@
+export { BRAND_LOGO_URL, SIGNUP_LOGO_URL } from './brand';
+export { DEMO_SLIDER_AUTO_PLAY_INTERVAL, DEMO_SLIDER_IMAGES, } from './demo-slider';
+export { AUTH_TOP_ANCHORED_MAIN_CLASS } from './layout-classes';
+export { getLayoutPresetConfig } from './layout-presets';

package/dist/constants/layout-classes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared layout className overrides used by multiple auth pages.
+ */
+/**
+ * Top-anchors the AuthLayout `<main>` content on screens where the form should
+ * stick to the top (per Figma 1721:4649 / 1721:4942: ~20px top on mobile,
+ * ~104px on desktop) instead of being vertically centered. Targets the inner
+ * `<main>` element rendered by AuthLayout.Main without modifying the wrapper.
+ */
+export declare const AUTH_TOP_ANCHORED_MAIN_CLASS = "[&_main]:!justify-start [&_main]:!pt-5 md:[&_main]:!pt-[104px]";

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

@@ -0,0 +1,10 @@
+/**
+ * Layout preset configurations. Structure only — no auth behavior.
+ * Used by AuthLayout when preset="login" | "signup" | "verification".
+ */
+import type { LayoutPresetConfig, LayoutPresetName } from '../types/components/layout-presets';
+/**
+ * Returns layout structure config for a preset name.
+ * Empty string returns undefined (caller uses full composition / no preset).
+ */
+export declare function getLayoutPresetConfig(preset: LayoutPresetName): LayoutPresetConfig | undefined;

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

@@ -0,0 +1,6 @@
+/**
+ * API adapter interface for the SSO auth SDK.
+ * Consumers implement this to connect the SDK to their central auth service.
+ * The SDK never performs HTTP calls directly.
+ */
+export type { AuthApiAdapter, CheckIdentifierParams, CheckIdentifierResponse, SendOtpParams, VerifyOtpParams, } from '../types';

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

@@ -0,0 +1,21 @@
+/**
+ * Auth context: provides `useAuthFlow` (full state + actions) and `useAuthSession` (session-only)
+ * hooks for consumers. Must be used within an `SSOAuthProvider` tree.
+ */
+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.
+ */
+export declare function useAuthFlow(): AuthFlowContextValue;
+/**
+ * Hook to access SSO session state only. Must be used within SSOAuthProvider.
+ */
+export declare function useAuthSession(): {
+    session: import("../types").SSOSession | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    signOut: () => void;
+    authMethod: import("../types").AuthMethod | null;
+};

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

@@ -1,4 +1,4 @@
-import type { AuthFlowRouter, AuthFlowRoutes, OtpValidateFn } from '@/types';
+import type { AuthFlowRouter, AuthFlowRoutes, OtpValidateFn } from '../types';
 /** Props for the `AuthFlow` orchestrator. */
 export interface AuthFlowProps {
     /**

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

@@ -0,0 +1,8 @@
+import type { SSOAuthProviderProps } from '../types';
+export type { SSOAuthConfig, SSOAuthProviderProps } from '../types';
+/**
+ * SSO Auth provider: manages the auth flow state machine and provides context to all child components.
+ * On mount, checks for an existing session (token or cookie-based via `validateSessionFromCookie`).
+ * Dispatches reducer actions and exposes async `AuthFlowActions` for each auth step.
+ */
+export declare function SSOAuthProvider({ config, children }: SSOAuthProviderProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,5 @@
+/**
+ * Re-export of auth domain types from central types folder.
+ * Prefer importing from @/types; this file keeps @/core/auth-types working.
+ */
+export type { AuthError, AuthErrorCode, AuthenticateWithProviderParams, AuthMethod, AuthStep, CompleteProfileParams, RepeatLoginInfo, SendOtpResponse, SSOSession, SSOUser, UserType, VerifyOtpResponse, } from '../types';

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

@@ -0,0 +1,19 @@
+/**
+ * Device-based repeat login detection.
+ * Stores last-used method and masked identifier in localStorage (device-local UX only).
+ */
+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.
+ */
+export declare function getRepeatLoginInfo(): StoredRepeatLogin | null;
+/**
+ * Saves repeat-login info to localStorage after successful auth.
+ */
+export declare function setRepeatLoginInfo(info: StoredRepeatLogin): void;
+/**
+ * Clears repeat-login info (e.g. on sign out).
+ */
+export declare function clearRepeatLoginInfo(): void;

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SSO Auth SDK core: types, adapter, provider, flow, session, device detection.
+ */
+export * from './auth-api-adapter';
+export * from './auth-context';
+export * from './auth-flow';
+export * from './auth-provider';
+export * from './auth-types';
+export * from './device-detection';
+export * from './sso-session';
+export * from './use-auth-flow';
+export * from './use-auth-flow-router-sync';

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

@@ -0,0 +1,35 @@
+/**
+ * SSO session management: token persistence strategies.
+ * - `localStorageTokenStorage`: single-origin, suitable for dev.
+ * - `serverCookieTokenStorage`: HttpOnly cookie-based, for production SSO.
+ * - `createAxiosAuthInterceptors`: attaches withCredentials + 401 handling to an axios instance.
+ */
+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.
+ */
+export declare function localStorageTokenStorage(): TokenStorageStrategy;
+/**
+ * Token storage when the token lives in a server-set cookie (e.g. HttpOnly).
+ * The client never reads or writes the token; the server sets the cookie on
+ * login and reads it from the request. Use with validateSessionFromCookie
+ * in your adapter and createAxiosAuthInterceptors (withCredentials) so the
+ * cookie is sent on every request.
+ */
+export declare function serverCookieTokenStorage(): TokenStorageStrategy;
+/**
+ * Attaches request and response interceptors to an axios instance for SSO auth
+ * when using server-side cookies (e.g. serverCookieTokenStorage):
+ * - Request: sets withCredentials so the browser sends cookies on every request.
+ * - Response: on 401, calls onUnauthorized (e.g. redirect to login).
+ *
+ * @param axiosInstance - Your axios instance (e.g. axios.create({ baseURL: '...' }))
+ * @param onUnauthorized - Optional callback when a response has status 401
+ */
+export declare function createAxiosAuthInterceptors(axiosInstance: AxiosAuthInterceptorInstance, onUnauthorized?: () => void): void;
+/**
+ * useAuthSession hook is implemented in auth-context (uses AuthFlowContext).
+ * Re-exported from core index for consumer convenience.
+ */

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

@@ -20,7 +20,7 @@
  *   cannot be entered cold from a URL — the SDK snaps the URL back to the
  *   current state's path instead.
  */
-import type { AuthFlowRouter, AuthFlowRoutes } from '@/types';
+import type { AuthFlowRouter, AuthFlowRoutes } from '../types';
 /**
  * Wires `router` to the auth flow state machine. No-op when either
  * `router` or `routes` is missing.

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

@@ -0,0 +1,9 @@
+/**
+ * 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 { AuthFlowAction, AuthFlowState, AuthStep } from '../types';
+export type { AuthFlowAction, AuthFlowState, IdentifierType } from '../types';
+export declare const INITIAL_STEP: AuthStep;
+export declare function getInitialAuthFlowState(): AuthFlowState;
+export declare function authFlowReducer(state: AuthFlowState, action: AuthFlowAction): AuthFlowState;