@usethrottle/auth 0.1.1 → 0.2.0

package/dist/react/components/index.d.cts

@@ -0,0 +1,735 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType, ReactNode } from 'react';
+import { ThrottleAuthConfig, ThrottleAuth } from '../index.cjs';
+export { Address, AddressInput, AuthSnapshot, AuthStatus, AuthStorage, Customer, DeviceSession, Invoice, Order, Page, PaymentMethod, ProfilePatch, Resource, Session, Subscription, ThrottleAccount, ThrottleAuthError, ThrottleAuthProvider, ThrottleAuthProviderProps, UseAuthResult, createAccount, createThrottleAuth, localStorageAdapter, memoryStorage, useAddresses, useAuth, useAuthContext, useCustomer, useInvoice, useInvoices, useOrder, useOrders, useSavedCards, useSubscriptions } from '../index.cjs';
+
+type ThrottleThemeName = 'light' | 'dark' | 'auto';
+declare const VARIABLE_PROPERTY: {
+    readonly colorPrimary: "--throttle-color-primary";
+    readonly colorPrimaryForeground: "--throttle-color-primary-foreground";
+    readonly colorBackground: "--throttle-color-background";
+    readonly colorSurface: "--throttle-color-surface";
+    readonly colorForeground: "--throttle-color-foreground";
+    readonly colorMuted: "--throttle-color-muted";
+    readonly colorMutedForeground: "--throttle-color-muted-foreground";
+    readonly colorBorder: "--throttle-color-border";
+    readonly colorDanger: "--throttle-color-danger";
+    readonly colorDangerSurface: "--throttle-color-danger-surface";
+    readonly colorDangerBorder: "--throttle-color-danger-border";
+    readonly colorSuccess: "--throttle-color-success";
+    readonly colorSuccessSurface: "--throttle-color-success-surface";
+    readonly colorSuccessBorder: "--throttle-color-success-border";
+    readonly colorWarning: "--throttle-color-warning";
+    readonly colorWarningSurface: "--throttle-color-warning-surface";
+    readonly colorWarningBorder: "--throttle-color-warning-border";
+    readonly fontFamily: "--throttle-font-family";
+    readonly fontSize: "--throttle-font-size";
+    readonly borderRadius: "--throttle-radius";
+    readonly borderWidth: "--throttle-border-width";
+    readonly spacing: "--throttle-spacing";
+    readonly shadowCard: "--throttle-shadow-card";
+    readonly shadowPopover: "--throttle-shadow-popover";
+    readonly transition: "--throttle-transition";
+    readonly zModal: "--throttle-z-modal";
+    readonly zPopover: "--throttle-z-popover";
+};
+type ThrottleVariables = Partial<Record<keyof typeof VARIABLE_PROPERTY, string>>;
+/**
+ * Every addressable part of every component. A merchant maps any of these to a
+ * className through `appearance.elements`. The list is the API: adding a
+ * rendered element without adding its key here ships something a merchant
+ * cannot restyle, which the drift test in Task 15 catches.
+ */
+declare const THROTTLE_ELEMENT_KEYS: readonly ["card", "card.header", "card.title", "card.description", "card.body", "card.footer", "card.logo", "field", "field.label", "field.input", "field.hint", "field.error", "field.group", "button", "alert", "spinner", "skeleton", "avatar", "badge", "emptyState", "emptyState.title", "emptyState.description", "modal.overlay", "modal.container", "modal.closeButton", "dropdown.trigger", "dropdown.menu", "dropdown.item", "dropdown.separator", "tabs.list", "tabs.tab", "table", "table.head", "table.row", "table.cell", "signIn.root", "signIn.title", "signIn.logo", "signIn.emailField", "signIn.passwordField", "signIn.submitButton", "signIn.forgotLink", "signIn.switchLink", "signUp.root", "signUp.title", "signUp.logo", "signUp.emailField", "signUp.passwordField", "signUp.submitButton", "signUp.switchLink", "forgotPassword.root", "forgotPassword.title", "forgotPassword.logo", "forgotPassword.emailField", "forgotPassword.submitButton", "forgotPassword.backLink", "resetPassword.root", "resetPassword.title", "resetPassword.logo", "resetPassword.passwordField", "resetPassword.submitButton", "verifyEmail.root", "verifyEmail.title", "verifyEmail.logo", "verifyEmail.resendButton", "authFlow.root", "authModal.overlay", "authModal.container", "signInButton.root", "signUpButton.root", "signOutButton.root", "stepUp.root", "stepUp.title", "stepUp.passwordField", "stepUp.submitButton", "stepUp.cancelButton", "signInPage.root", "signInPage.logo", "signInPage.footer", "signUpPage.root", "signUpPage.logo", "signUpPage.footer", "userButton.root", "userButton.trigger", "userButton.menu", "userButton.identity", "userButton.email", "userButton.badge", "userButton.item", "userButton.manageButton", "userButton.signOutButton", "userButton.signOutAllButton", "accountDashboard.root", "accountDashboard.tabs", "accountDashboard.sidebar", "accountDashboard.panel", "accountModal.overlay", "accountModal.container", "accountModal.header", "accountModal.title", "accountModal.body", "verifyBanner.root", "verifyBanner.message", "verifyBanner.resendButton", "verifyBanner.dismissButton", "profilePanel.root", "profilePanel.form", "profilePanel.submitButton", "addressesPanel.root", "addressesPanel.list", "addressesPanel.item", "addressesPanel.addButton", "addressesPanel.form", "addressesPanel.defaultButton", "addressesPanel.editButton", "addressesPanel.deleteButton", "addressesPanel.table", "addressesPanel.row", "paymentMethodsPanel.root", "paymentMethodsPanel.list", "paymentMethodsPanel.item", "paymentMethodsPanel.defaultButton", "paymentMethodsPanel.deleteButton", "paymentMethodsPanel.table", "paymentMethodsPanel.row", "ordersPanel.root", "ordersPanel.table", "ordersPanel.row", "ordersPanel.list", "ordersPanel.item", "ordersPanel.viewButton", "orderDetail.root", "orderDetail.backButton", "orderDetail.lineItems", "orderDetail.lineItem", "orderDetail.totals", "invoicesPanel.root", "invoicesPanel.table", "invoicesPanel.row", "invoicesPanel.list", "invoicesPanel.item", "invoicesPanel.viewButton", "invoiceDetail.root", "invoiceDetail.backButton", "invoiceDetail.downloadButton", "invoiceDetail.totals", "subscriptionsPanel.root", "subscriptionsPanel.list", "subscriptionsPanel.item", "subscriptionsPanel.cancelButton", "subscriptionsPanel.cancelNowButton", "subscriptionsPanel.pauseButton", "subscriptionsPanel.resumeButton", "subscriptionsPanel.table", "subscriptionsPanel.row", "securityPanel.root", "securityPanel.passwordForm", "securityPanel.passwordButton", "securityPanel.sessionList", "securityPanel.sessionItem", "securityPanel.revokeButton", "securityPanel.revokeAllButton", "securityPanel.table", "securityPanel.row"];
+type ThrottleElementKey = (typeof THROTTLE_ELEMENT_KEYS)[number];
+interface ThrottleSlots {
+    Spinner?: ComponentType<{
+        className?: string;
+    }>;
+    Avatar?: ComponentType<{
+        name: string;
+        email: string;
+        className?: string;
+    }>;
+    Alert?: ComponentType<{
+        tone: 'error' | 'success' | 'info';
+        children: ReactNode;
+        className?: string;
+    }>;
+    EmptyState?: ComponentType<{
+        title: string;
+        description?: string;
+        className?: string;
+    }>;
+    Button?: ComponentType<any>;
+}
+interface ThrottleAppearance {
+    theme?: ThrottleThemeName;
+    variables?: ThrottleVariables;
+    elements?: Partial<Record<ThrottleElementKey, string>>;
+    components?: ThrottleSlots;
+}
+
+declare const enUS: {
+    locale: string;
+    common: {
+        save: string;
+        cancel: string;
+        delete: string;
+        edit: string;
+        back: string;
+        retry: string;
+        loading: string;
+        close: string;
+        confirm: string;
+        somethingWentWrong: string;
+        actions: string;
+        view: string;
+    };
+    signIn: {
+        title: string;
+        description: string;
+        email: string;
+        password: string;
+        submitButton: string;
+        forgotLink: string;
+        switchPrompt: string;
+        switchLink: string;
+    };
+    signUp: {
+        title: string;
+        description: string;
+        email: string;
+        password: string;
+        submitButton: string;
+        switchPrompt: string;
+        switchLink: string;
+        pendingNotice: string;
+    };
+    forgotPassword: {
+        title: string;
+        description: string;
+        email: string;
+        submitButton: string;
+        sentNotice: string;
+        backLink: string;
+    };
+    resetPassword: {
+        title: string;
+        password: string;
+        submitButton: string;
+        doneNotice: string;
+        missingToken: string;
+    };
+    verifyEmail: {
+        title: string;
+        verifying: string;
+        success: string;
+        resendButton: string;
+        resentNotice: string;
+        instructions: string;
+    };
+    stepUp: {
+        title: string;
+        description: string;
+        password: string;
+        submitButton: string;
+        cancelButton: string;
+    };
+    userButton: {
+        manage: string;
+        signOut: string;
+        signOutAll: string;
+        verified: string;
+        unverified: string;
+        openMenu: string;
+    };
+    verifyBanner: {
+        message: string;
+        resendButton: string;
+        dismissButton: string;
+    };
+    account: {
+        title: string;
+        tabs: {
+            profile: string;
+            addresses: string;
+            paymentMethods: string;
+            orders: string;
+            invoices: string;
+            subscriptions: string;
+            security: string;
+        };
+    };
+    profile: {
+        firstName: string;
+        lastName: string;
+        phone: string;
+        company: string;
+        acceptsMarketing: string;
+        email: string;
+        emailReadOnly: string;
+        saveButton: string;
+        savedNotice: string;
+    };
+    addresses: {
+        addButton: string;
+        defaultBadge: string;
+        makeDefault: string;
+        empty: string;
+        emptyDescription: string;
+        label: string;
+        firstName: string;
+        lastName: string;
+        company: string;
+        addressLine1: string;
+        addressLine2: string;
+        city: string;
+        stateProvince: string;
+        postalCode: string;
+        countryCode: string;
+        phone: string;
+        deleteConfirm: string;
+        columnAddress: string;
+    };
+    paymentMethods: {
+        empty: string;
+        emptyDescription: string;
+        gatedDescription: string;
+        defaultBadge: string;
+        makeDefault: string;
+        expires: string;
+        deleteConfirm: string;
+        columnCard: string;
+    };
+    orders: {
+        empty: string;
+        emptyDescription: string;
+        gatedDescription: string;
+        number: string;
+        date: string;
+        status: string;
+        total: string;
+        /**
+         * Display copy for `order.status`. Mirrors ORDER_STATUS_META in
+         * `@commerce/orders`, which is the server's single source of status copy —
+         * copied rather than imported because this package ships with no runtime
+         * dependencies and is a client for the wire API, not for server packages.
+         * If a status is added there, add it here.
+         */
+        statusLabels: {
+            draft: string;
+            pending: string;
+            processing: string;
+            partiallyFulfilled: string;
+            fulfilled: string;
+            cancelled: string;
+            closed: string;
+        };
+        /**
+         * The money half of the label, shown as a second badge beside the
+         * lifecycle one. `captured` is deliberately empty: paid in full is the
+         * assumed happy path, and announcing it on every settled order is noise.
+         */
+        paymentLabels: {
+            pending: string;
+            authorized: string;
+            captured: string;
+            partiallyPaid: string;
+            partiallyRefunded: string;
+            refunded: string;
+            failed: string;
+            voided: string;
+            processing: string;
+            disputed: string;
+            expired: string;
+        };
+        items: string;
+        subtotal: string;
+        discount: string;
+        shipping: string;
+        tax: string;
+        quantity: string;
+        shippingAddress: string;
+        billingAddress: string;
+        viewSubscription: string;
+    };
+    invoices: {
+        empty: string;
+        emptyDescription: string;
+        gatedDescription: string;
+        number: string;
+        issued: string;
+        due: string;
+        status: string;
+        total: string;
+        refunded: string;
+        period: string;
+        downloadButton: string;
+        /** Display copy for `invoice.status` — the wire values are paid|open|void. */
+        statusLabels: {
+            paid: string;
+            open: string;
+            void: string;
+        };
+        downloadUnavailable: string;
+    };
+    subscriptions: {
+        empty: string;
+        emptyDescription: string;
+        gatedDescription: string;
+        renewsOn: string;
+        endsOn: string;
+        cancelledOn: string;
+        trialEnds: string;
+        cancelButton: string;
+        cancelAtPeriodEnd: string;
+        cancelNow: string;
+        pauseButton: string;
+        resumeButton: string;
+        cancelConfirm: string;
+        cancelScheduled: string;
+        columnPlan: string;
+        columnPrice: string;
+        columnRenews: string;
+        columnStatus: string;
+        /**
+         * Display copy for `subscription.status`. Mirrors SubscriptionStatus in
+         * `@commerce/subscriptions`; copied rather than imported because this
+         * package has no runtime dependencies. Without it a buyer in dunning saw
+         * the literal pill `past_due`.
+         */
+        statusLabels: {
+            active: string;
+            paused: string;
+            cancelled: string;
+            pastDue: string;
+            trialing: string;
+            unpaid: string;
+        };
+    };
+    security: {
+        passwordTitle: string;
+        newPassword: string;
+        changeButton: string;
+        changedNotice: string;
+        sessionsTitle: string;
+        thisDevice: string;
+        lastActive: string;
+        revokeButton: string;
+        revokeAllButton: string;
+        sessionsEmpty: string;
+        columnDevice: string;
+    };
+    errors: Record<string, string>;
+};
+/** Every field optional, at every depth — a merchant overrides one string. */
+type ThrottleLocalization = DeepPartial<typeof enUS>;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+
+/**
+ * Composition of the list of records a panel renders. `'boxed'` is today's
+ * shipped look (each item its own bordered box, outlined action buttons) and
+ * must stay byte-for-byte identical to it. `'rows'` separates items with a
+ * hairline instead, and renders actions as plain text — the motivation is
+ * that the account dashboard is itself a bordered card, so a panel built from
+ * bordered boxes is a card inside a card with nothing establishing hierarchy.
+ * `'table'` is a real `<table>` with column headers, for merchants who want
+ * their buyer's records (especially money) in aligned tabular columns.
+ */
+type AccountPanelVariant = 'rows' | 'boxed' | 'table';
+declare function AddressesPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+}): react_jsx_runtime.JSX.Element;
+
+type AccountTab = 'profile' | 'addresses' | 'paymentMethods' | 'orders' | 'invoices' | 'subscriptions' | 'security';
+declare const ACCOUNT_TABS: readonly AccountTab[];
+interface AccountDashboardProps {
+    /** Which panels to show, in order. Defaults to all seven. */
+    tabs?: AccountTab[];
+    tab?: AccountTab;
+    onTabChange?(tab: AccountTab): void;
+    routing?: 'virtual' | 'hash';
+    /**
+     * `'sidebar'` (default) puts the seven panels in a vertical rail beside the
+     * content; `'tabs'` is the original horizontal strip above it. Seven is a lot
+     * for a strip — at narrow widths most of them sit off-screen behind a scroll
+     * with nothing signalling they exist — so the rail is the default. The strip
+     * remains for merchants whose surrounding page already has a side nav and
+     * would end up with two.
+     */
+    layout?: 'sidebar' | 'tabs';
+    /**
+     * Default composition for every panel rendered here. A panel's own
+     * `variant` prop cannot be set through the dashboard (it does not expose
+     * per-tab overrides), so in practice this is the only source of `variant`
+     * each panel receives when rendered through `AccountDashboard` — a panel
+     * rendered directly, outside the dashboard, keeps deciding its own default
+     * from its own `variant` prop rather than this one.
+     */
+    panelVariant?: AccountPanelVariant;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}
+declare function AccountDashboard(props: AccountDashboardProps): react_jsx_runtime.JSX.Element | null;
+
+interface ThrottleProviderProps extends Partial<ThrottleAuthConfig> {
+    publishableKey: string;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Default logo for the `branded` card variant. A card's own `logo` prop wins over this. */
+    logo?: ReactNode;
+    /** Default true. Set false and import `@usethrottle/auth/styles.css` for a flash-free SSR paint. */
+    injectStyles?: boolean;
+    /** Returns the guest cart id to attach after a successful sign-in or sign-up. */
+    claimCartOnSignIn?: () => string | null | undefined;
+    /** Inject a pre-built client. Tests use it. */
+    auth?: ThrottleAuth;
+    children: ReactNode;
+    /** @internal test seam — receives the step-up callback handed to the core. */
+    __captureStepUp?: (fn: () => Promise<string | null>) => void;
+}
+interface UseThrottleResult {
+    openSignIn(): void;
+    openSignUp(): void;
+    openAccount(): void;
+    close(): void;
+    isOpen: boolean;
+}
+/**
+ * The equivalent of Clerk's `useClerk().openSignIn()`. Lets a merchant open
+ * the auth/account overlay from their own UI — a pricing CTA, a gated action,
+ * a keyboard shortcut — driving the SAME modal `SignInButton`/`SignUpButton`
+ * open, rather than a second competing one.
+ *
+ * Outside a `<ThrottleProvider>` (e.g. under a plain `ThrottleAuthProvider`)
+ * this degrades to no-op functions and `isOpen: false`, with a one-time
+ * development warning, rather than throwing.
+ */
+declare function useThrottle(): UseThrottleResult;
+/**
+ * Composes rather than replaces. It creates the client (so it can supply
+ * `onStepUpRequired` at construction time, which is the only moment the core
+ * reads it) and hands it to the existing `<ThrottleAuthProvider>` through the
+ * `auth` injection prop that already exists for this purpose. Every hook —
+ * useAuth, useCustomer, useOrders — keeps working underneath unchanged.
+ *
+ * It also owns the ONE modal overlay (sign-in/sign-up/account) alongside the
+ * step-up dialog it already hosts, so a `SignInButton`/`SignUpButton` click
+ * and a programmatic `useThrottle().openSignIn()` call always drive the same
+ * dialog rather than stacking two.
+ */
+declare function ThrottleProvider(props: ThrottleProviderProps): react_jsx_runtime.JSX.Element;
+
+declare const THROTTLE_STYLE_ID = "throttle-auth-styles";
+/**
+ * The whole component stylesheet, as a string, so one source feeds both the
+ * runtime injector and the `dist/styles.css` the build emits. There is no CSS
+ * pipeline in tsup — adding one would mean the file and the injected styles
+ * could drift.
+ *
+ * Every rule a merchant might restyle uses a SINGLE class selector. Merchant
+ * classNames from `appearance.elements` land on the same element, so equal
+ * specificity plus source order is what lets them win. A descendant selector
+ * here would silently outrank them.
+ */
+declare const THROTTLE_STYLES = "\n.throttle-root {\n  --throttle-color-primary: #18181b;\n  --throttle-color-primary-foreground: #ffffff;\n  --throttle-color-background: #ffffff;\n  --throttle-color-surface: #f8fafc;\n  --throttle-color-foreground: #0e1116;\n  --throttle-color-muted: #eceef2;\n  --throttle-color-muted-foreground: #5b6472;\n  --throttle-color-border: #e2e8f0;\n  --throttle-color-danger: #c2321f;\n  --throttle-color-danger-surface: #fef2f2;\n  --throttle-color-danger-border: #fecaca;\n  --throttle-color-success: #127a4a;\n  --throttle-color-success-surface: #ecfdf5;\n  --throttle-color-success-border: #a7f3d0;\n  --throttle-color-warning: #92400e;\n  --throttle-color-warning-surface: #fffbeb;\n  --throttle-color-warning-border: #fde68a;\n  --throttle-font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n  --throttle-font-size: 16px;\n  --throttle-font-size-xs: 12px;\n  --throttle-font-size-sm: 14px;\n  --throttle-font-size-lg: 20px;\n  --throttle-font-size-xl: 24px;\n  --throttle-line-height: 1.5;\n  --throttle-line-height-tight: 1.25;\n  --throttle-radius: 12px;\n  --throttle-radius-sm: 8px;\n  --throttle-radius-full: 999px;\n  --throttle-border-width: 1px;\n  --throttle-spacing: 8px;\n  --throttle-space-1: 4px;\n  --throttle-space-2: var(--throttle-spacing);\n  --throttle-space-3: 12px;\n  --throttle-space-4: 16px;\n  --throttle-space-5: 24px;\n  --throttle-space-6: 32px;\n  --throttle-control-height: 48px;\n  --throttle-control-padding-x: 16px;\n  --throttle-shadow-card: 0 1px 3px rgba(15,23,42,.08), 0 1px 2px rgba(15,23,42,.04);\n  --throttle-shadow-popover: 0 10px 24px rgba(15,23,42,.12), 0 2px 6px rgba(15,23,42,.06);\n  --throttle-transition: 150ms cubic-bezier(.2,0,.2,1);\n  --throttle-z-modal: 2147483000;\n  --throttle-z-popover: 2147482000;\n  font-family: var(--throttle-font-family);\n  font-size: var(--throttle-font-size);\n  line-height: var(--throttle-line-height);\n  color: var(--throttle-color-foreground);\n  box-sizing: border-box;\n}\n.throttle-root *, .throttle-root *::before, .throttle-root *::after { box-sizing: inherit; }\n\n.throttle-root[data-throttle-theme=\"dark\"] {\n  --throttle-color-primary: #e6edf3;\n  --throttle-color-primary-foreground: #0d1117;\n  --throttle-color-background: #0d1117;\n  --throttle-color-surface: #1c2129;\n  --throttle-color-foreground: #e6edf3;\n  --throttle-color-muted: #21262d;\n  --throttle-color-muted-foreground: #9aa4b2;\n  --throttle-color-border: #30363d;\n  --throttle-color-danger: #ff6b58;\n  --throttle-color-danger-surface: #2a1513;\n  --throttle-color-danger-border: #5c2b25;\n  --throttle-color-success: #45c08a;\n  --throttle-color-success-surface: #0f2419;\n  --throttle-color-success-border: #1f4d36;\n  --throttle-color-warning: #e0a53a;\n  --throttle-color-warning-surface: #2a2113;\n  --throttle-color-warning-border: #5c4a25;\n  --throttle-shadow-card: 0 1px 3px rgba(0,0,0,.6), 0 1px 2px rgba(0,0,0,.4);\n  --throttle-shadow-popover: 0 10px 24px rgba(0,0,0,.5), 0 2px 6px rgba(0,0,0,.35);\n}\n@media (prefers-color-scheme: dark) {\n  .throttle-root[data-throttle-theme=\"auto\"] {\n    --throttle-color-primary: #e6edf3;\n    --throttle-color-primary-foreground: #0d1117;\n    --throttle-color-background: #0d1117;\n    --throttle-color-surface: #1c2129;\n    --throttle-color-foreground: #e6edf3;\n    --throttle-color-muted: #21262d;\n    --throttle-color-muted-foreground: #9aa4b2;\n    --throttle-color-border: #30363d;\n    --throttle-color-danger: #ff6b58;\n    --throttle-color-danger-surface: #2a1513;\n    --throttle-color-danger-border: #5c2b25;\n    --throttle-color-success: #45c08a;\n    --throttle-color-success-surface: #0f2419;\n    --throttle-color-success-border: #1f4d36;\n    --throttle-color-warning: #e0a53a;\n    --throttle-color-warning-surface: #2a2113;\n    --throttle-color-warning-border: #5c4a25;\n    --throttle-shadow-card: 0 1px 3px rgba(0,0,0,.6), 0 1px 2px rgba(0,0,0,.4);\n    --throttle-shadow-popover: 0 10px 24px rgba(0,0,0,.5), 0 2px 6px rgba(0,0,0,.35);\n  }\n}\n\n.throttle-card {\n  background: var(--throttle-color-background);\n  border: var(--throttle-border-width) solid var(--throttle-color-border);\n  border-radius: var(--throttle-radius);\n  box-shadow: var(--throttle-shadow-card);\n  padding: var(--throttle-space-5);\n  width: 100%;\n  max-width: 400px;\n  margin-inline: auto;\n}\n/* Inside a Modal the dialog already provides the surface \u2014 background, radius\n   and elevation. A card that draws its own on top is the \"box inside a box\":\n   two shadowed rounded rectangles nested, with the card's max-width stranding\n   it in the middle of a much wider dialog. */\n.throttle-card--bare { border: none; box-shadow: none; background: none; max-width: none; }\n.throttle-card__header { margin-bottom: var(--throttle-space-4); }\n.throttle-card__header--branded { text-align: center; }\n.throttle-card__logo { display: flex; justify-content: center; margin-bottom: var(--throttle-space-3); }\n.throttle-card__title { font-size: var(--throttle-font-size-xl); line-height: var(--throttle-line-height-tight); font-weight: 600; letter-spacing: -0.02em; margin: 0; }\n.throttle-card__title--branded { font-size: var(--throttle-font-size-xl); }\n.throttle-card__description { color: var(--throttle-color-muted-foreground); margin: var(--throttle-space-1) 0 0; }\n.throttle-card__body { display: flex; flex-direction: column; gap: var(--throttle-space-3); }\n.throttle-card__footer { margin-top: var(--throttle-space-4); text-align: center; }\n.throttle-card__footer--ruled { border-top: var(--throttle-border-width) solid var(--throttle-color-border); padding-top: var(--throttle-space-4); }\n\n.throttle-field { display: flex; flex-direction: column; gap: var(--throttle-space-1); }\n.throttle-field__labelrow { display: flex; align-items: baseline; justify-content: space-between; gap: var(--throttle-space-2); }\n.throttle-field__label { font-weight: 500; }\n.throttle-field__input {\n  font: inherit;\n  font-size: var(--throttle-font-size);\n  color: var(--throttle-color-foreground);\n  background: var(--throttle-color-background);\n  border: var(--throttle-border-width) solid var(--throttle-color-border);\n  border-radius: var(--throttle-radius-sm);\n  /* padding-block stays 0 so min-height alone owns the height, exactly as\n     .throttle-button does. With 12px vertical padding the box computed to\n     50px against the button's 48px \u2014 a 2px mismatch, measured in a browser\n     across 19 controls. An input element centres its own text vertically. */\n  padding-block: 0;\n  padding-inline: var(--throttle-control-padding-x);\n  min-height: var(--throttle-control-height);\n  width: 100%;\n  transition: border-color var(--throttle-transition), box-shadow var(--throttle-transition);\n}\n.throttle-field__input:focus-visible {\n  outline: none;\n  border-color: var(--throttle-color-primary);\n  box-shadow: 0 0 0 2px var(--throttle-color-background), 0 0 0 4px var(--throttle-color-primary);\n}\n.throttle-field__input:disabled { background: var(--throttle-color-muted); color: var(--throttle-color-muted-foreground); cursor: not-allowed; }\n.throttle-field__input::placeholder { color: var(--throttle-color-muted-foreground); opacity: 1; }\n.throttle-field__input--grouped { border: none; border-radius: 0; padding-inline: 0; }\n.throttle-field__hint { color: var(--throttle-color-muted-foreground); font-size: var(--throttle-font-size-xs); }\n/* Always mounted, so it reserves its line whether or not there is an error:\n   an error appearing on submit must not push the submit button out from\n   under the buyer's pointer. */\n.throttle-field__error { color: var(--throttle-color-danger); font-size: var(--throttle-font-size-xs); min-height: 1rem; line-height: 1rem; }\n\n.throttle-field-group {\n  display: flex;\n  flex-direction: column;\n  border: var(--throttle-border-width) solid var(--throttle-color-border);\n  border-radius: var(--throttle-radius-sm);\n  overflow: hidden;\n}\n.throttle-field-group__item { padding: var(--throttle-space-3) var(--throttle-control-padding-x); }\n.throttle-field-group__divider { height: var(--throttle-border-width); background: var(--throttle-color-border); }\n.throttle-field-group__forgot { margin-left: auto; }\n\n.throttle-button {\n  font: inherit;\n  font-weight: 500;\n  border-radius: var(--throttle-radius-sm);\n  border: var(--throttle-border-width) solid transparent;\n  padding-inline: var(--throttle-control-padding-x);\n  padding-block: 0;\n  min-height: var(--throttle-control-height);\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  cursor: pointer;\n  transition: opacity var(--throttle-transition), background-color var(--throttle-transition), border-color var(--throttle-transition), filter var(--throttle-transition), box-shadow var(--throttle-transition);\n}\n.throttle-button:disabled { opacity: .55; cursor: not-allowed; }\n.throttle-button:focus-visible { outline: none; box-shadow: 0 0 0 2px var(--throttle-color-background), 0 0 0 4px var(--throttle-color-primary); }\n.throttle-button--primary { background: var(--throttle-color-primary); color: var(--throttle-color-primary-foreground); width: 100%; }\n.throttle-button--primary:hover:not(:disabled) { filter: brightness(0.92); }\n.throttle-button--secondary { background: var(--throttle-color-surface); color: var(--throttle-color-foreground); border-color: var(--throttle-color-border); }\n.throttle-button--secondary:hover:not(:disabled) { background: var(--throttle-color-muted); }\n.throttle-button--danger { background: transparent; color: var(--throttle-color-danger); border-color: var(--throttle-color-border); }\n.throttle-button--danger:hover:not(:disabled) { background: color-mix(in srgb, var(--throttle-color-danger) 10%, transparent); }\n/* Link-style actions are the rows panel default, and they carry Delete,\n   Remove, Cancel and Sign out. Zero padding with min-height 0 made those\n   roughly 20px tall and ~8px apart \u2014 a mis-tap on a phone lands on something\n   irreversible. The target is expanded with vertical padding and pulled back\n   with an equal negative margin, so the hit box clears 44px while the text\n   sits exactly where it did. Collapsing this back to zero padding shrinks the\n   target again. */\n.throttle-button--link { background: none; border: none; color: var(--throttle-color-primary); padding-inline: 0; padding-block: var(--throttle-space-3); margin-block: calc(var(--throttle-space-3) * -1); min-height: 0; text-decoration: underline; width: auto; }\n.throttle-button--link:hover:not(:disabled) { opacity: .8; }\n.throttle-button--linkDanger { background: none; border: none; color: var(--throttle-color-danger); padding-inline: 0; padding-block: var(--throttle-space-3); margin-block: calc(var(--throttle-space-3) * -1); min-height: 0; text-decoration: underline; width: auto; }\n.throttle-button--linkDanger:hover:not(:disabled) { opacity: .8; }\n.throttle-button--xs { font-size: var(--throttle-font-size-xs); }\n\n.throttle-alert { border-radius: var(--throttle-radius-sm); padding: var(--throttle-space-3); font-size: var(--throttle-font-size-sm); }\n.throttle-alert--error { background: var(--throttle-color-danger-surface); border: var(--throttle-border-width) solid var(--throttle-color-danger-border); color: var(--throttle-color-danger); }\n.throttle-alert--success { background: var(--throttle-color-success-surface); border: var(--throttle-border-width) solid var(--throttle-color-success-border); color: var(--throttle-color-success); }\n.throttle-alert--info { background: var(--throttle-color-surface); color: var(--throttle-color-muted-foreground); }\n\n.throttle-spinner {\n  display: inline-block; width: 1em; height: 1em;\n  border: 2px solid currentColor; border-right-color: transparent; border-radius: 50%;\n  animation: throttle-spin 700ms linear infinite;\n}\n@keyframes throttle-spin { to { transform: rotate(360deg); } }\n@media (prefers-reduced-motion: reduce) { .throttle-spinner { animation-duration: 2.4s; } }\n\n.throttle-skeleton {\n  background: var(--throttle-color-muted);\n  border-radius: var(--throttle-radius-sm);\n  animation: throttle-pulse 1.4s ease-in-out infinite; height: 2.5em; }\n@keyframes throttle-pulse { 50% { opacity: .5; } }\n@media (prefers-reduced-motion: reduce) { .throttle-skeleton { animation: none; } }\n\n.throttle-modal__overlay {\n  position: fixed; inset: 0; z-index: var(--throttle-z-modal);\n  background: rgba(14,17,22,.45);\n  display: flex; align-items: center; justify-content: center;\n  padding: var(--throttle-space-4);\n  overflow-y: auto;\n}\n.throttle-modal__container {\n  background: var(--throttle-color-background);\n  border-radius: var(--throttle-radius);\n  box-shadow: var(--throttle-shadow-popover);\n  max-width: 720px; width: 100%; max-height: 90vh; overflow-y: auto;\n  position: relative;\n}\n/* After the base rule on purpose: both are single-class, so equal specificity\n   means source order decides. Declared before it, this silently lost. */\n.throttle-modal__container--compact { max-width: 440px; }\n.throttle-modal__close {\n  position: absolute; top: var(--throttle-space-3); right: var(--throttle-space-3);\n  background: none; border: none; cursor: pointer; font-size: var(--throttle-font-size-lg);\n  color: var(--throttle-color-muted-foreground);\n  transition: color var(--throttle-transition);\n}\n.throttle-modal__close:hover { color: var(--throttle-color-foreground); }\n.throttle-modal__header { padding: var(--throttle-space-4) var(--throttle-space-4) 0; }\n.throttle-modal__title { font-size: var(--throttle-font-size-lg); line-height: var(--throttle-line-height-tight); font-weight: 600; margin: 0; }\n.throttle-modal__body { padding: var(--throttle-space-4); }\n\n.throttle-dropdown__trigger { background: none; border: none; cursor: pointer; padding: 0; border-radius: var(--throttle-radius-full); transition: background-color var(--throttle-transition); }\n.throttle-dropdown__trigger:hover { background: var(--throttle-color-surface); }\n.throttle-dropdown__trigger:focus-visible { outline: 2px solid var(--throttle-color-primary); outline-offset: 2px; }\n.throttle-dropdown__menu {\n  position: absolute; right: 0; top: calc(100% + var(--throttle-space-2));\n  z-index: var(--throttle-z-popover);\n  min-width: 260px;\n  background: var(--throttle-color-background);\n  border: var(--throttle-border-width) solid var(--throttle-color-border);\n  border-radius: var(--throttle-radius);\n  box-shadow: var(--throttle-shadow-popover);\n  padding: var(--throttle-space-1);\n}\n.throttle-dropdown__item {\n  display: flex; align-items: center; gap: var(--throttle-space-2);\n  width: 100%; text-align: left; font: inherit; color: inherit;\n  background: none; border: none; cursor: pointer;\n  padding: var(--throttle-space-3);\n  border-radius: var(--throttle-radius-sm);\n  text-decoration: none;\n  transition: background-color var(--throttle-transition);\n}\n.throttle-dropdown__item:hover { background: var(--throttle-color-surface); }\n.throttle-dropdown__item:focus-visible { outline: 2px solid var(--throttle-color-primary); outline-offset: -2px; }\n.throttle-dropdown__separator { height: 1px; background: var(--throttle-color-border); margin: var(--throttle-space-1) 0; border: 0; }\n\n.throttle-tabs__list {\n  display: flex; gap: var(--throttle-space-1);\n  border-bottom: var(--throttle-border-width) solid var(--throttle-color-border);\n  overflow-x: auto; scrollbar-width: thin;\n}\n.throttle-tabs__tab {\n  font: inherit; background: none; border: none; cursor: pointer; white-space: nowrap;\n  padding: var(--throttle-space-3);\n  color: var(--throttle-color-muted-foreground);\n  border-bottom: 2px solid transparent;\n  transition: color var(--throttle-transition), border-color var(--throttle-transition);\n}\n.throttle-tabs__tab:hover { color: var(--throttle-color-foreground); }\n.throttle-tabs__tab--active { color: var(--throttle-color-foreground); border-bottom-color: var(--throttle-color-primary); }\n.throttle-tabs__panel { padding-top: var(--throttle-space-4); }\n\n/* Paints its own ground. A UserButton in a navbar should stay transparent, but\n   the dashboard is a large surface of themed text: in dark theme its foreground\n   is near-white, so on a light host page it was rendering white-on-white. */\n.throttle-account-root { container-type: inline-size; background: var(--throttle-color-background); color: var(--throttle-color-foreground); }\n.throttle-account { display: flex; gap: var(--throttle-space-5); align-items: flex-start; }\n.throttle-account__content { flex: 1; min-width: 0; }\n.throttle-tabs__rail { flex: none; width: 220px; display: flex; flex-direction: column; gap: 2px; }\n.throttle-tabs__railitem {\n  font: inherit;\n  font-size: var(--throttle-font-size-sm);\n  display: flex;\n  align-items: center;\n  gap: var(--throttle-space-3);\n  width: 100%;\n  text-align: left;\n  background: none;\n  border: none;\n  border-radius: var(--throttle-radius-sm);\n  padding: 0 var(--throttle-space-3);\n  min-height: var(--throttle-control-height);\n  color: var(--throttle-color-muted-foreground);\n  cursor: pointer;\n  transition: background var(--throttle-transition), color var(--throttle-transition);\n}\n.throttle-tabs__railitem:hover { background: var(--throttle-color-surface); color: var(--throttle-color-foreground); }\n.throttle-tabs__railitem:focus-visible { outline: 2px solid var(--throttle-color-primary); outline-offset: -2px; }\n.throttle-tabs__tab:focus-visible { outline: 2px solid var(--throttle-color-primary); outline-offset: -2px; }\n.throttle-tabs__railitem--active { background: var(--throttle-color-surface); color: var(--throttle-color-foreground); font-weight: 500; }\n.throttle-tabs__railicon { flex: none; opacity: .75; }\n\n/* A CONTAINER query, not a viewport one: these components render inside a\n   merchant's page, so the viewport says nothing about how much room the\n   dashboard actually has \u2014 it could sit in a 400px column on a 1920px screen.\n   Below ~560px of container the rail becomes a full-width list above the\n   panel: all seven still visible, each still a 44px target. */\n@container (max-width: 560px) {\n  /* align-items: flex-start is right in row direction and wrong in column \u2014\n     it shrinks the rail to its content width, so width:100% alone cannot make\n     it span. Stretch it explicitly when stacked. */\n  .throttle-account { flex-direction: column; align-items: stretch; gap: var(--throttle-space-4); }\n  .throttle-tabs__rail { width: 100%; }\n}\n\n.throttle-table { width: 100%; border-collapse: collapse; text-align: left; }\n.throttle-table__head { color: var(--throttle-color-muted-foreground); font-weight: 500; font-size: var(--throttle-font-size-sm); }\n.throttle-table__row { border-top: var(--throttle-border-width) solid var(--throttle-color-border); cursor: pointer; transition: background-color var(--throttle-transition); }\n.throttle-table__row:hover { background: var(--throttle-color-surface); }\n.throttle-table__row:focus-visible { outline: 2px solid var(--throttle-color-primary); outline-offset: -2px; }\n.throttle-table__cell { padding: var(--throttle-space-3) var(--throttle-space-2); height: 56px; box-sizing: border-box; }\n.throttle-table__scroll { overflow-x: auto; }\n\n.throttle-empty { text-align: center; padding: var(--throttle-space-6) var(--throttle-space-4); }\n.throttle-empty__title { font-weight: 600; margin: 0 0 var(--throttle-space-1); }\n.throttle-empty__description { color: var(--throttle-color-muted-foreground); margin: 0; }\n\n.throttle-avatar {\n  display: inline-flex; align-items: center; justify-content: center;\n  width: 32px; height: 32px; border-radius: var(--throttle-radius-full);\n  background: var(--throttle-color-primary); color: var(--throttle-color-primary-foreground);\n  font-size: var(--throttle-font-size-xs); font-weight: 600; text-transform: uppercase;\n}\n\n.throttle-badge {\n  display: inline-block; font-size: var(--throttle-font-size-xs); font-weight: 500;\n  padding: 2px var(--throttle-space-2); border-radius: var(--throttle-radius-full);\n  background: var(--throttle-color-muted); color: var(--throttle-color-muted-foreground);\n}\n.throttle-badge--muted { background: none; border: var(--throttle-border-width) solid var(--throttle-color-border); color: var(--throttle-color-muted-foreground); font-weight: 400; padding: 1px calc(var(--throttle-space-2) - 1px); }\n.throttle-badge--success { background: color-mix(in srgb, var(--throttle-color-success) 15%, transparent); color: var(--throttle-color-success); }\n.throttle-badge--warning { background: color-mix(in srgb, var(--throttle-color-warning) 15%, transparent); color: var(--throttle-color-warning); }\n.throttle-badge--danger { background: color-mix(in srgb, var(--throttle-color-danger) 15%, transparent); color: var(--throttle-color-danger); }\n\n.throttle-stack { display: flex; flex-direction: column; gap: var(--throttle-space-3); }\n.throttle-row { display: flex; align-items: center; justify-content: space-between; gap: var(--throttle-space-2); flex-wrap: wrap; }\n.throttle-muted { color: var(--throttle-color-muted-foreground); }\n.throttle-banner {\n  display: flex; align-items: center; justify-content: space-between; gap: var(--throttle-space-2);\n  flex-wrap: wrap;\n  background: color-mix(in srgb, var(--throttle-color-warning) 12%, transparent);\n  color: var(--throttle-color-warning);\n  border-radius: var(--throttle-radius-sm);\n  padding: var(--throttle-space-3);\n  margin-bottom: var(--throttle-space-4);\n}\n.throttle-panel { display: flex; flex-direction: column; gap: var(--throttle-space-4); }\n/* 100dvh, not 100vh: on mobile browsers 100vh includes the space behind the\n   dynamic address/toolbar, so the page would be taller than the visible\n   viewport and the card would sit off-centre until the toolbar collapsed. */\n.throttle-page {\n  min-height: 100dvh;\n  width: 100%;\n  background: var(--throttle-color-surface);\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: var(--throttle-space-5);\n  padding: var(--throttle-space-5);\n}\n.throttle-page__logo { display: flex; justify-content: center; }\n.throttle-page__footer { color: var(--throttle-color-muted-foreground); text-align: center; font-size: var(--throttle-font-size-sm); }\n.throttle-listitem {\n  display: flex; align-items: flex-start; justify-content: space-between; gap: var(--throttle-space-2);\n  flex-wrap: wrap;\n  border: var(--throttle-border-width) solid var(--throttle-color-border);\n  border-radius: var(--throttle-radius-sm);\n  padding: var(--throttle-space-3);\n}\n/* 'rows' variant: hairline rules between items instead of each item carrying\n   its own border+radius, so a panel does not read as a card inside a card. */\n.throttle-rows { display: flex; flex-direction: column; }\n.throttle-rowitem {\n  display: flex; align-items: flex-start; justify-content: space-between; gap: var(--throttle-space-2);\n  flex-wrap: wrap;\n  border-top: var(--throttle-border-width) solid var(--throttle-color-border);\n  padding: var(--throttle-space-3) 0;\n}\n.throttle-rowitem:first-child { border-top: none; padding-top: 0; }\n.throttle-actions { display: flex; gap: var(--throttle-space-2); flex-wrap: wrap; }\n.throttle-table__money { display: block; text-align: right; font-variant-numeric: tabular-nums; }\n.throttle-lineitem { display: flex; align-items: center; gap: var(--throttle-space-3); padding: var(--throttle-space-2) 0; }\n.throttle-lineitem__image { width: 48px; height: 48px; object-fit: cover; border-radius: var(--throttle-radius-sm); flex: none; }\n.throttle-totals { display: flex; flex-direction: column; gap: var(--throttle-space-1); }\n\n@media (prefers-reduced-motion: reduce) {\n  .throttle-button, .throttle-field__input, .throttle-dropdown__item, .throttle-dropdown__trigger, .throttle-tabs__tab, .throttle-table__row, .throttle-modal__close {\n    transition: none;\n  }\n}\n";
+
+/**
+ * The only place minor units become major units. Every amount on the wire is
+ * an integer in the currency's smallest unit, and the exponent varies: USD and
+ * EUR are 2, JPY and KRW are 0, and a few are 3. `Intl` knows all of them, so
+ * ask it rather than hardcoding 100.
+ */
+declare function formatMoney(minorUnits: number, currency: string, locale: string): string;
+declare function formatDate(value: string | Date, locale: string): string;
+
+type AuthCardVariant = 'quiet' | 'grouped' | 'branded';
+interface SignInProps {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Composition of the card. Default `'quiet'`. */
+    variant?: AuthCardVariant;
+    /** Rendered above the title in the `branded` variant. Falls back to `ThrottleProvider`'s `logo`. */
+    logo?: ReactNode;
+    onSuccess?(): void;
+    onForgotPassword?(): void;
+    onSignUp?(): void;
+}
+declare function SignIn(props: SignInProps): react_jsx_runtime.JSX.Element;
+
+interface SignUpProps {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Composition of the card. Default `'quiet'`. */
+    variant?: AuthCardVariant;
+    /** Rendered above the title in the `branded` variant. Falls back to `ThrottleProvider`'s `logo`. */
+    logo?: ReactNode;
+    onSuccess?(): void;
+    onSignIn?(): void;
+}
+declare function SignUp(props: SignUpProps): react_jsx_runtime.JSX.Element;
+
+interface ForgotPasswordProps {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Composition of the card. Default `'quiet'`. A single input, so `'grouped'` renders the same as `'quiet'`. */
+    variant?: AuthCardVariant;
+    /** Rendered above the title in the `branded` variant. Falls back to `ThrottleProvider`'s `logo`. */
+    logo?: ReactNode;
+    onBack?(): void;
+}
+declare function ForgotPassword(props: ForgotPasswordProps): react_jsx_runtime.JSX.Element;
+
+interface ResetPasswordProps {
+    token?: string;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Composition of the card. Default `'quiet'`. A single input, so `'grouped'` renders the same as `'quiet'`. */
+    variant?: AuthCardVariant;
+    /** Rendered above the title in the `branded` variant. Falls back to `ThrottleProvider`'s `logo`. */
+    logo?: ReactNode;
+    onSuccess?(): void;
+}
+declare function ResetPassword(props: ResetPasswordProps): react_jsx_runtime.JSX.Element;
+
+interface VerifyEmailProps {
+    token?: string;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Composition of the card. Default `'quiet'`. This card has no inputs, so `'grouped'` renders the same as `'quiet'`. */
+    variant?: AuthCardVariant;
+    /** Rendered above the title in the `branded` variant. Falls back to `ThrottleProvider`'s `logo`. */
+    logo?: ReactNode;
+    onSuccess?(): void;
+}
+declare function VerifyEmail(props: VerifyEmailProps): react_jsx_runtime.JSX.Element;
+
+type AuthView = 'signIn' | 'signUp' | 'forgotPassword' | 'resetPassword' | 'verifyEmail';
+interface AuthFlowProps {
+    initialView?: AuthView;
+    /** Controlled mode: pass both to own the value yourself. */
+    view?: AuthView;
+    onViewChange?(view: AuthView): void;
+    /** Wins over the token in the URL. */
+    token?: string;
+    routing?: 'virtual' | 'hash';
+    afterSignIn?(): void;
+    afterSignUp?(): void;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}
+declare function AuthFlow(props: AuthFlowProps): react_jsx_runtime.JSX.Element;
+
+interface AuthModalProps {
+    open: boolean;
+    onClose(): void;
+    initialView?: AuthView;
+    afterSignIn?(): void;
+    afterSignUp?(): void;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}
+declare function AuthModal(props: AuthModalProps): react_jsx_runtime.JSX.Element;
+
+interface SignInButtonProps {
+    mode?: 'modal' | 'redirect';
+    /** Required when mode is "redirect". */
+    url?: string;
+    initialView?: AuthView;
+    asChild?: boolean;
+    children?: ReactNode;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    afterSignIn?(): void;
+}
+declare function SignInButton(props: SignInButtonProps): react_jsx_runtime.JSX.Element;
+
+/** The twin of `SignInButton`, opening the same flow on the sign-up view. */
+interface SignUpButtonProps {
+    mode?: 'modal' | 'redirect';
+    /** Required when mode is "redirect". */
+    url?: string;
+    initialView?: AuthView;
+    asChild?: boolean;
+    children?: ReactNode;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    afterSignUp?(): void;
+}
+declare function SignUpButton(props: SignUpButtonProps): react_jsx_runtime.JSX.Element;
+
+interface SignOutButtonProps {
+    /** Revokes every session, not just this device. May raise a step-up prompt. */
+    everywhere?: boolean;
+    children?: ReactNode;
+    localization?: ThrottleLocalization;
+    onSignedOut?(): void;
+}
+declare function SignOutButton(props: SignOutButtonProps): react_jsx_runtime.JSX.Element;
+
+interface SignInPageProps {
+    /** Rendered above the card. Absent by default. */
+    logo?: ReactNode;
+    /** Rendered below the card. Absent by default. */
+    footer?: ReactNode;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    onSuccess?(): void;
+    onForgotPassword?(): void;
+    onSignUp?(): void;
+}
+/**
+ * A full-viewport, centred shell around `<SignIn/>` for merchants who drop it
+ * directly on a route (e.g. `/sign-in`) and would otherwise get a card stuck
+ * at the top of a bare page. `100dvh`, not `100vh` — see styles.ts.
+ */
+declare function SignInPage(props: SignInPageProps): react_jsx_runtime.JSX.Element;
+
+interface SignUpPageProps {
+    /** Rendered above the card. Absent by default. */
+    logo?: ReactNode;
+    /** Rendered below the card. Absent by default. */
+    footer?: ReactNode;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    onSuccess?(): void;
+    onSignIn?(): void;
+}
+/** The `<SignUp/>` twin of `SignInPage`. */
+declare function SignUpPage(props: SignUpPageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * All three render nothing while `status === 'loading'`. A guard that treated
+ * loading as signed-out would flash a "Sign in" button at a buyer whose
+ * session is a few milliseconds from being restored.
+ */
+declare function SignedIn(props: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function SignedOut(props: {
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function Protect(props: {
+    requireVerified?: boolean;
+    fallback?: ReactNode;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface UserButtonProps {
+    /** "modal" opens the dashboard in an overlay; "navigate" links to accountUrl. */
+    mode?: 'modal' | 'navigate';
+    accountUrl?: string;
+    /** Forwarded to the dashboard in modal mode. */
+    tabs?: AccountTab[];
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    afterSignOut?(): void;
+    children?: ReactNode;
+}
+declare function UserButtonRoot(props: UserButtonProps): react_jsx_runtime.JSX.Element | null;
+/** `<UserButton.Link href label icon?/>` — a merchant link inside the menu. */
+declare function UserButtonLink(props: {
+    href: string;
+    label: string;
+    icon?: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/** `<UserButton.Action onClick label icon?/>` — a merchant action inside the menu. */
+declare function UserButtonAction(props: {
+    onClick(): void;
+    label: string;
+    icon?: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+declare const UserButton: typeof UserButtonRoot & {
+    Link: typeof UserButtonLink;
+    Action: typeof UserButtonAction;
+};
+
+declare function VerifyEmailBanner(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}): react_jsx_runtime.JSX.Element | null;
+
+declare function ProfilePanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Read-only by design. There is no buyer-plane route to add a payment method —
+ * the embed-token endpoint lives on the merchant plane behind a pm_client_token
+ * — so this panel offers no "Add card" control, not even a disabled one. The
+ * empty state explains where cards actually come from, which stays true if a
+ * buyer-plane add route is built later.
+ */
+declare function PaymentMethodsPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+}): react_jsx_runtime.JSX.Element;
+
+declare function OrdersPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+    onViewSubscription?(id: string): void;
+}): react_jsx_runtime.JSX.Element;
+
+declare function OrderDetail(props: {
+    orderId: string;
+    onBack?(): void;
+    onViewSubscription?(id: string): void;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}): react_jsx_runtime.JSX.Element;
+
+declare function InvoicesPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+}): react_jsx_runtime.JSX.Element;
+
+declare function InvoiceDetail(props: {
+    invoiceId: string;
+    onBack?(): void;
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+}): react_jsx_runtime.JSX.Element;
+
+declare function SubscriptionsPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+}): react_jsx_runtime.JSX.Element;
+
+declare function SecurityPanel(props: {
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    variant?: AccountPanelVariant;
+}): react_jsx_runtime.JSX.Element;
+
+interface AccountModalProps {
+    open: boolean;
+    onClose(): void;
+    tabs?: AccountTab[];
+    appearance?: ThrottleAppearance;
+    localization?: ThrottleLocalization;
+    /** Where focus returns on close. See `Modal`'s own doc for why a caller
+     *  sometimes has to name this rather than let the modal capture it. */
+    restoreFocusTo?: Element | null;
+}
+/**
+ * The account dashboard, reachable without going through `UserButton`'s
+ * menu — a merchant can wire this to a "Settings" control anywhere. Mirrors
+ * `AuthModal`'s shape (a `Modal` hosting the existing card/dashboard), so a
+ * merchant who wants to own the open/close state themselves has the same
+ * kind of component available for the account surface that they already
+ * have for sign-in.
+ */
+declare function AccountModal(props: AccountModalProps): react_jsx_runtime.JSX.Element;
+
+export { ACCOUNT_TABS, AccountDashboard, type AccountDashboardProps, AccountModal, type AccountModalProps, type AccountPanelVariant, type AccountTab, AddressesPanel, type AuthCardVariant, AuthFlow, type AuthFlowProps, AuthModal, type AuthModalProps, type AuthView, ForgotPassword, type ForgotPasswordProps, InvoiceDetail, InvoicesPanel, OrderDetail, OrdersPanel, PaymentMethodsPanel, ProfilePanel, Protect, ResetPassword, type ResetPasswordProps, SecurityPanel, SignIn, SignInButton, type SignInButtonProps, SignInPage, type SignInPageProps, type SignInProps, SignOutButton, type SignOutButtonProps, SignUp, SignUpButton, type SignUpButtonProps, SignUpPage, type SignUpPageProps, type SignUpProps, SignedIn, SignedOut, SubscriptionsPanel, THROTTLE_ELEMENT_KEYS, THROTTLE_STYLES, THROTTLE_STYLE_ID, type ThrottleAppearance, ThrottleAuth, ThrottleAuthConfig, type ThrottleElementKey, type ThrottleLocalization, ThrottleProvider, type ThrottleProviderProps, type ThrottleSlots, type ThrottleThemeName, type ThrottleVariables, type UseThrottleResult, UserButton, type UserButtonProps, VerifyEmail, VerifyEmailBanner, type VerifyEmailProps, enUS, formatDate, formatMoney, useThrottle };