import type { Snippet } from 'svelte';
import type { PartialAuthLocale } from '../../../i18n/keys.js';
import type { PasswordPolicy } from '../../../password-policy.js';
import type { CsrfClientOptions } from '../../csrf.js';
import type { AuthPageSlotClasses } from '../types.js';
/**
 * @summary The ready-made sign-up page, with the password rules shown as you type.
 * @description Pre-built registration page with invitation-gated signup, password requirements checklist, and confirm field.
 * Sends POST to `apiPath` (default `/api/auth/register`). Pair with `createRegisterHandler(authDeps)` on the server.
 *
 * @tag form
 * @related LoginPage
 *
 * @example
 * ```svelte
 * <RegisterPage
 *   {t}
 *   token={page.url.searchParams.get('token') ?? ''}
 *   defaultEmail={page.url.searchParams.get('email') ?? ''}
 *   onSuccess={() => goto('/')}
 * />
 * ```
 */
export interface RegisterPageProps {
    /**
     * Locale overrides, deep-merged over the active built-in bundle (resolved
     * from the i18n context). Pass any subset, from a single string to a whole tree.
     */
    t?: PartialAuthLocale;
    /** Called after successful registration. */
    onSuccess?: () => void;
    /**
     * Pre-fills the email field. Pass the `?email=` query param from the
     * invitation link (`createInvitationHandlers` builds
     * `/auth/register?token=<secret>&email=<invitee>`) so an invited user lands on
     * a ready-to-submit form instead of retyping. Following the same explicit-prop
     * pattern as `ResetPasswordPage`/`VerifyEmailPage`'s `token`, read it from the
     * page in your route (SSR-safe), e.g.
     * `defaultEmail={page.url.searchParams.get('email') ?? ''}`.
     *
     * Convenience only — the invitation names its own address, and registering
     * with a different one is refused.
     * @default ''
     */
    defaultEmail?: string;
    /**
     * The invitation token from the `?token=` query param. **Required to
     * register**: possession of it is the entire proof of invitation, so
     * without it the request is rejected before anything is looked up.
     *
     * Read it in your route the same way as `defaultEmail`:
     * `token={page.url.searchParams.get('token') ?? ''}`.
     *
     * It is a credential: keep it out of logs and analytics, and do not put it in
     * a page title or a shared screenshot.
     *
     * Required rather than optional-with-a-default on purpose: a page rendered
     * without it can only ever produce a 400, and an optional prop makes that
     * mistake type-check. This way the compiler names every call site.
     */
    token: string;
    /** URL for the login page link. @default '/auth/login' */
    loginUrl?: string;
    /** API endpoint for the register request. @default '/api/auth/register' */
    apiPath?: string;
    /** CSRF cookie/header names, needed only when the server overrides the defaults via `config.csrf`. Mutating requests echo the token automatically. */
    csrf?: CsrfClientOptions;
    /** Custom fetch implementation for all API calls. Defaults to the global `fetch`. Useful for mock backends in demos/tests or custom retry/auth layers. */
    fetcher?: typeof globalThis.fetch;
    /**
     * The password policy to gate against, when you already have it server-side
     * (`resolvePasswordPolicy(config.password)` in a `+page.server.ts` load).
     * Supplying it skips the `policyPath` request — useful for SSR, and the only
     * way to gate correctly when the endpoint is not mounted.
     */
    passwordPolicy?: PasswordPolicy;
    /**
     * Endpoint serving `createPasswordPolicyHandler`, read once on mount so the
     * checklist and the submit gate match what the server enforces. `null`
     * disables the request and falls back to the package defaults (min 8, no
     * character classes).
     * @default '/api/auth/password-policy'
     */
    policyPath?: string | null;
    /** Show real-time password requirements checklist. @default true */
    showRequirements?: boolean;
    /** Content rendered above the form (e.g. social login buttons). */
    header?: Snippet;
    /** Content rendered below the form, above links (e.g. terms checkbox). */
    footer?: Snippet;
    /** Replaces the link area. */
    links?: Snippet;
    /** Strip all default styling. */
    unstyled?: boolean;
    /** Per-slot class overrides. Keys: `root`, `card`, `title`, `form`, `field`, `submit`, `error`, `success`, `links`. */
    slotClasses?: AuthPageSlotClasses;
    /**
     * Apply a named preset registered via `<BlocksProvider presets={{ RegisterPage: { … } }}>`.
     * Resolves after the provider defaults and before this instance's own
     * `slotClasses`, so a project-wide look lives in one place instead of being
     * repeated at every usage site.
     */
    preset?: string;
    /** Extra classes on the root element. */
    class?: string;
}
export type { PasswordPolicy } from '../../../password-policy.js';
export type { AuthPageSlotClasses } from '../types.js';
export { default as RegisterPage } from './RegisterPage.svelte';