import { CardProps } from '@heroui/react';
/** Native HeroUI card variants used by auth shells. */
export type AuthCardVariant = NonNullable<CardProps["variant"]>;
/**
 * HeroUI field variants (`TextField`, `InputGroup`, `Checkbox`, …).
 *
 * HeroUI semantics: `secondary` is the on-surface variant (fields sitting on
 * a card/surface background), `primary` is the default page-level variant.
 */
export type AuthInputVariant = "primary" | "secondary";
/**
 * Public shell variant accepted by `AuthPage` / `Auth` / sign-in / sign-up.
 *
 * This is the set of native HeroUI card variants plus the field-only alias
 * `"primary"`: `<AuthPage variant="primary" />` renders transparent card
 * chrome with primary-emphasis fields. `primary` is never a card variant —
 * it only describes field emphasis.
 */
export type AuthSurfaceVariant = AuthCardVariant | AuthInputVariant;
/**
 * Fully resolved surface variant: the concrete HeroUI card variant plus the
 * field variant that matches it.
 */
export interface ResolvedAuthSurfaceVariant {
    card: AuthCardVariant;
    field: AuthInputVariant;
}
/**
 * Canonical surface resolver — the single source of truth for mapping a
 * public Athena shell variant onto card chrome and field emphasis.
 *
 * Pure and synchronous: no context, no state, no effects — output is
 * identical on server and client, so the resolved surface can never drift
 * during hydration.
 *
 * Contract:
 * - `undefined` → card `default`, fields `secondary`
 * - native card variants pass through (`default`/`secondary`/`tertiary`
 *   → painted card, `secondary` fields; `transparent` → bare page,
 *   `primary` fields)
 * - `primary` is a field-emphasis alias: card `transparent`, fields `primary`
 */
export declare function resolveAuthSurfaceVariant(variant?: AuthSurfaceVariant): ResolvedAuthSurfaceVariant;
/**
 * Visual surface classes for elements that need card chrome but cannot be a
 * HeroUI `Card` (e.g. a `<nav>` or a dialog container).
 *
 * Built through HeroUI's public `cardVariants` API instead of hand-written
 * `card`/`card--*` class strings, so Auth UI does not depend on HeroUI's
 * internal generated class names.
 */
export declare function authSurfaceClassName(variant?: AuthCardVariant): string;
/**
 * Map a shell variant onto a HeroUI card variant.
 *
 * `primary` is field-only emphasis — HeroUI cards have no `primary` style, so
 * the card renders `transparent` chrome and lets primary fields carry the
 * look. Every other value is already a native card variant and passes through
 * unchanged; `undefined` resolves to the card's own `"default"`.
 *
 * Thin wrapper around {@link resolveAuthSurfaceVariant} — kept for
 * compatibility. Prefer the canonical resolver when both card and field
 * variants are needed.
 */
export declare function resolveAuthCardVariant(variant?: AuthSurfaceVariant): AuthCardVariant;
/**
 * Map a shell variant onto the HeroUI field variant, following HeroUI's
 * surface rule: fields on a painted surface use `variant="secondary"`;
 * fields on the bare page (`transparent` chrome, or the `primary` emphasis
 * alias which maps to transparent) stay `primary`.
 *
 * Thin wrapper around {@link resolveAuthSurfaceVariant} — kept for
 * compatibility. Prefer the canonical resolver when both card and field
 * variants are needed.
 */
export declare function resolveAuthInputVariant(variant?: AuthSurfaceVariant): AuthInputVariant;