@nevios/storefront-kit 1.0.0 → 1.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
+import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
 
 /**
  * NeviosProvider — puts a configured storefront client on React context so
@@ -173,6 +173,32 @@ declare const en: {
     "order.terminal.cancelled": string;
     "order.terminal.refunded": string;
     "order.terminal.returned": string;
+    "payment.title": string;
+    "payment.amountDue": string;
+    "payment.methodLabel": string;
+    "payment.payNow": string;
+    "payment.finish": string;
+    "payment.loading": string;
+    "payment.loadError": string;
+    "payment.actionError": string;
+    "payment.paidTitle": string;
+    "payment.paidBody": string;
+    "payment.paidAmount": string;
+    "payment.verifyingTitle": string;
+    "payment.verifyingBody": string;
+    "payment.blockedTitle": string;
+    "payment.blocked.orderCancelled": string;
+    "payment.blocked.alreadyPaid": string;
+    "payment.blocked.authorizationHeld": string;
+    "payment.blocked.documentIssued": string;
+    "payment.account": string;
+    "payment.beneficiary": string;
+    "payment.variableSymbol": string;
+    "payment.amount": string;
+    "payment.copy": string;
+    "payment.copied": string;
+    "payment.qrAlt": string;
+    "payment.qrCaption": string;
     "error.notFound.title": string;
     "error.notFound.body": string;
     "error.generic.title": string;
@@ -187,6 +213,20 @@ declare const en: {
     "account.signOut": string;
     "account.greeting": string;
     "account.orders": string;
+    "account.loadError": string;
+    "account.retry": string;
+    "account.loadMore": string;
+    "account.signInError": string;
+    "account.security": string;
+    "account.newEmail": string;
+    "account.changeEmail": string;
+    "account.recentLogin": string;
+    "account.sessions": string;
+    "account.currentSession": string;
+    "account.revokeSession": string;
+    "account.closeAccount": string;
+    "account.closeWarning": string;
+    "account.confirmClose": string;
     "account.noOrders": string;
     "account.addresses": string;
     "account.noAddresses": string;
@@ -729,6 +769,27 @@ interface OrderStatusState {
 }
 declare function useOrderStatus(statusToken: string | null, initial?: OrderStatus | null): OrderStatusState;
 
+interface PaymentPageState {
+    payment: PaymentState | null;
+    methods: PaymentMethod[];
+    loading: boolean;
+    /** True while a method change or a gateway start is in flight — the moment
+     *  to disable the buttons, because both mutate the order. */
+    busy: boolean;
+    error: Error | null;
+    reload(): Promise<void>;
+    /** Switch method. The order's total can move with it (the fee differs), so
+     *  the refreshed state is returned and stored, not merged. */
+    selectMethod(method: string): Promise<PaymentState | null>;
+    /** Open a gateway session. Returns the URL to send the browser to; null when
+     *  the connector needs no redirect. */
+    startPayment(input?: {
+        returnUrl?: string;
+        cancelUrl?: string;
+    }): Promise<string | null>;
+}
+declare function usePayment(token: string | null, initial?: PaymentState | null): PaymentPageState;
+
 /**
  * OrderConfirmation — the compact post-checkout "thank you" block. Drop it on
  * the return route after `checkout.complete()` / a gateway redirect back, keyed
@@ -762,9 +823,143 @@ interface OrderStatusPageProps {
     order?: OrderStatus;
     /** Contact-support callback (shown when the order allows it). */
     onContactSupport?: () => void;
+    /** Builds the URL of your payment page from the payment's token. Given one,
+     *  an unpaid order shows a "finish payment" link; without it the page stays
+     *  read-only, because a link to a route the shop does not have is worse than
+     *  no link. */
+    payHref?: (paymentToken: string) => string;
+    locale?: string;
+}
+declare function OrderStatusPage({ statusToken, order: initial, onContactSupport, payHref, locale, }: OrderStatusPageProps): React.ReactElement;
+
+/**
+ * Shared presentational parts for the order views — phase timeline, terminal
+ * status banner, line items, and totals. Themeable via `--nv-*`. Internal to
+ * the order slice.
+ */
+
+declare function isTerminal(phase: OrderPhase): boolean;
+/** The happy-path progress bar. Hidden for terminal phases (use StatusBanner). */
+declare function PhaseTimeline({ phase }: {
+    phase: OrderPhase;
+}): React.ReactElement | null;
+/** Banner shown for terminal phases (cancelled / refunded / returned). */
+declare function StatusBanner({ phase }: {
+    phase: OrderPhase;
+}): React.ReactElement | null;
+declare function OrderLines({ order, locale, }: {
+    order: OrderStatus;
+    locale?: string;
+}): React.ReactElement;
+declare function OrderTotals({ order, locale, }: {
+    order: OrderStatus;
+    locale?: string;
+}): React.ReactElement;
+
+/**
+ * PaymentPage — the merchant's own payment page for a placed order.
+ *
+ * A whole page, not a widget, because of who reaches it: somebody who clicked
+ * "finish your payment" in an order e-mail, possibly days later, on a phone,
+ * with none of the shop's context around them. It has to answer "what do I owe
+ * and what do I do now" on its own.
+ *
+ *     <PaymentPage token={order.payment.token} statusHref={`/order/${t}`} />
+ *
+ * It renders exactly one of four situations, and the difference between them is
+ * the entire job:
+ *
+ *   1. THERE IS SOMETHING TO PAY  — the picker plus one button named after what
+ *      it does. The surcharge sits on the row and the amount due moves when the
+ *      method changes, so nobody picks cash-on-delivery and watches the total
+ *      grow afterwards.
+ *   2. BANK TRANSFER             — account, variable symbol, amount, QR. No
+ *      button; the details are the action.
+ *   3. ALREADY PAID              — a receipt, NOT an error. Arriving at a paid
+ *      link is the normal end of the happy path (and of every gateway return).
+ *   4. LOCKED                    — one of four reasons, each its own sentence.
+ *      `blocked_reason` carries four values precisely so the page can say four
+ *      different things; collapsing them into "cannot pay" sends the customer
+ *      to support.
+ *
+ * `token === null` renders nothing at all. The token is minted only while there
+ * is something to pay, so its absence is the server saying "no button here" —
+ * a disabled button would be a worse answer.
+ *
+ * **Returning from a gateway.** The page can be the `return_url`. Before it
+ * sends the browser to a gateway it remembers that in `sessionStorage`, so on
+ * the way back it knows to show "verifying your payment" and poll instead of
+ * offering to pay again — the callback often lands a second or two after the
+ * customer does, and a payable-looking page at that moment invites a double
+ * payment. Needs no cooperation from the route.
+ */
+
+interface PaymentPageProps {
+    /** The payment page's own token — the status page hands it over as
+     *  `order.payment.token`. `null` renders nothing. */
+    token: string | null;
+    /** Pre-fetched state (SSR / loader) — skips the first client fetch. */
+    payment?: PaymentState | null;
+    /** Where the gateway returns the customer after paying. Defaults to the
+     *  current URL, which makes this page its own return route. */
+    returnUrl?: string;
+    cancelUrl?: string;
+    /** Link to the full order status page, offered once there is nothing to pay. */
+    statusHref?: string;
     locale?: string;
+    /** Called once the payment reads as settled — e.g. to refresh an order view. */
+    onPaid?(payment: PaymentState): void;
 }
-declare function OrderStatusPage({ statusToken, order: initial, onContactSupport, locale, }: OrderStatusPageProps): React.ReactElement;
+declare function PaymentPage({ token, payment: initial, returnUrl, cancelUrl, statusHref, locale, onPaid, }: PaymentPageProps): React.ReactElement | null;
+
+/**
+ * PaymentMethodPicker — the ONE payment picker in the kit.
+ *
+ * Used by both the checkout's payment step and the payment page, and that is
+ * the whole point of it existing separately: switching from card to transfer
+ * has to look identical in the shop and on the page a customer reaches from an
+ * e-mail two days later. Two pickers that drift make the second one feel like
+ * somebody else's site — at the exact moment the customer is deciding whether
+ * to send money.
+ *
+ * The surcharge rides on the row because it is the consequence of the choice.
+ * Cash on delivery costs 39 Kč more; a picker that hides that until the total
+ * moves has let the shopper choose blind.
+ */
+
+interface PaymentMethodPickerProps {
+    methods: PaymentMethod[];
+    /** The chosen method's key (`PaymentMethod.method`), or null when none is. */
+    value: string | null;
+    onSelect(method: string): void;
+    /** Currency of the order/checkout — the surcharge is formatted in it. */
+    currency: string;
+    locale?: string;
+    /** Renders the rows unselectable (e.g. while a switch is in flight). */
+    disabled?: boolean;
+    /** Accessible name for the group. */
+    label?: string;
+}
+declare function PaymentMethodPicker({ methods, value, onSelect, currency, locale, disabled, label, }: PaymentMethodPickerProps): React.ReactElement;
+
+/**
+ * TransferInstructions — where to send the money for a bank-transfer order.
+ *
+ * Nothing in the kit rendered this until now, which meant a shopper who chose
+ * "bank transfer" placed the order and was told nothing about where to pay.
+ * The backend has always returned the account, the variable symbol, the amount
+ * and a ready-made QR image; it just had no home.
+ *
+ * There is deliberately NO button here. For a transfer these details ARE the
+ * action — the customer leaves for their banking app. A button would either lie
+ * about what it does or do nothing.
+ */
+
+interface TransferInstructionsProps {
+    instructions: PaymentInstructions;
+    locale?: string;
+}
+declare function TransferInstructions({ instructions: i, locale, }: TransferInstructionsProps): React.ReactElement;
 
 /**
  * AccountProvider + useAccount — shared logged-in-customer state. Resolves the
@@ -777,6 +972,7 @@ interface AccountState {
     signedIn: boolean;
     /** True until the initial session check resolves. */
     loading: boolean;
+    error: boolean;
     requestMagicLink(email: string): Promise<MagicLinkResult>;
     /** Exchange a magic token for a session (sets `customer`). */
     verify(token: string): Promise<Customer>;
@@ -852,6 +1048,9 @@ declare function AddressBook(): React.ReactElement;
 
 declare function ProfileEditor(): React.ReactElement | null;
 
+/** Email verification, session revocation and explicit account-closure confirmation. */
+declare function AccountSecurity(): React.ReactElement | null;
+
 /**
  * ProductJsonLd — schema.org/Product structured data for rich results (price,
  * availability, brand). Drop it in the PDP <head> (or anywhere; it's a script).
@@ -928,4 +1127,4 @@ interface JsonLdProps {
 /** Render a JSON-LD `<script>` for the given (already-shaped) data object. */
 declare function JsonLd({ data }: JsonLdProps): React.ReactElement;
 
-export { AccountDashboard, type AccountDashboardProps, AccountProvider, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentSection, type PaymentSectionProps, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, useStorefront, useStorefrontOptional, useT };
+export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
+import { StorefrontClient, Money, Product, ProductMedia, ProductVariant, CollectionDetail, ProductSort, Cart, AddLineInput, CartLine, Checkout, CreateCheckoutInput, SetAddressInput, ShippingQuote, PaymentMethod, OrderStatus, PaymentState, OrderPhase, PaymentInstructions, Customer, MagicLinkResult, ReorderResult } from '@nevios/storefront-js';
 
 /**
  * NeviosProvider — puts a configured storefront client on React context so
@@ -173,6 +173,32 @@ declare const en: {
     "order.terminal.cancelled": string;
     "order.terminal.refunded": string;
     "order.terminal.returned": string;
+    "payment.title": string;
+    "payment.amountDue": string;
+    "payment.methodLabel": string;
+    "payment.payNow": string;
+    "payment.finish": string;
+    "payment.loading": string;
+    "payment.loadError": string;
+    "payment.actionError": string;
+    "payment.paidTitle": string;
+    "payment.paidBody": string;
+    "payment.paidAmount": string;
+    "payment.verifyingTitle": string;
+    "payment.verifyingBody": string;
+    "payment.blockedTitle": string;
+    "payment.blocked.orderCancelled": string;
+    "payment.blocked.alreadyPaid": string;
+    "payment.blocked.authorizationHeld": string;
+    "payment.blocked.documentIssued": string;
+    "payment.account": string;
+    "payment.beneficiary": string;
+    "payment.variableSymbol": string;
+    "payment.amount": string;
+    "payment.copy": string;
+    "payment.copied": string;
+    "payment.qrAlt": string;
+    "payment.qrCaption": string;
     "error.notFound.title": string;
     "error.notFound.body": string;
     "error.generic.title": string;
@@ -187,6 +213,20 @@ declare const en: {
     "account.signOut": string;
     "account.greeting": string;
     "account.orders": string;
+    "account.loadError": string;
+    "account.retry": string;
+    "account.loadMore": string;
+    "account.signInError": string;
+    "account.security": string;
+    "account.newEmail": string;
+    "account.changeEmail": string;
+    "account.recentLogin": string;
+    "account.sessions": string;
+    "account.currentSession": string;
+    "account.revokeSession": string;
+    "account.closeAccount": string;
+    "account.closeWarning": string;
+    "account.confirmClose": string;
     "account.noOrders": string;
     "account.addresses": string;
     "account.noAddresses": string;
@@ -729,6 +769,27 @@ interface OrderStatusState {
 }
 declare function useOrderStatus(statusToken: string | null, initial?: OrderStatus | null): OrderStatusState;
 
+interface PaymentPageState {
+    payment: PaymentState | null;
+    methods: PaymentMethod[];
+    loading: boolean;
+    /** True while a method change or a gateway start is in flight — the moment
+     *  to disable the buttons, because both mutate the order. */
+    busy: boolean;
+    error: Error | null;
+    reload(): Promise<void>;
+    /** Switch method. The order's total can move with it (the fee differs), so
+     *  the refreshed state is returned and stored, not merged. */
+    selectMethod(method: string): Promise<PaymentState | null>;
+    /** Open a gateway session. Returns the URL to send the browser to; null when
+     *  the connector needs no redirect. */
+    startPayment(input?: {
+        returnUrl?: string;
+        cancelUrl?: string;
+    }): Promise<string | null>;
+}
+declare function usePayment(token: string | null, initial?: PaymentState | null): PaymentPageState;
+
 /**
  * OrderConfirmation — the compact post-checkout "thank you" block. Drop it on
  * the return route after `checkout.complete()` / a gateway redirect back, keyed
@@ -762,9 +823,143 @@ interface OrderStatusPageProps {
     order?: OrderStatus;
     /** Contact-support callback (shown when the order allows it). */
     onContactSupport?: () => void;
+    /** Builds the URL of your payment page from the payment's token. Given one,
+     *  an unpaid order shows a "finish payment" link; without it the page stays
+     *  read-only, because a link to a route the shop does not have is worse than
+     *  no link. */
+    payHref?: (paymentToken: string) => string;
+    locale?: string;
+}
+declare function OrderStatusPage({ statusToken, order: initial, onContactSupport, payHref, locale, }: OrderStatusPageProps): React.ReactElement;
+
+/**
+ * Shared presentational parts for the order views — phase timeline, terminal
+ * status banner, line items, and totals. Themeable via `--nv-*`. Internal to
+ * the order slice.
+ */
+
+declare function isTerminal(phase: OrderPhase): boolean;
+/** The happy-path progress bar. Hidden for terminal phases (use StatusBanner). */
+declare function PhaseTimeline({ phase }: {
+    phase: OrderPhase;
+}): React.ReactElement | null;
+/** Banner shown for terminal phases (cancelled / refunded / returned). */
+declare function StatusBanner({ phase }: {
+    phase: OrderPhase;
+}): React.ReactElement | null;
+declare function OrderLines({ order, locale, }: {
+    order: OrderStatus;
+    locale?: string;
+}): React.ReactElement;
+declare function OrderTotals({ order, locale, }: {
+    order: OrderStatus;
+    locale?: string;
+}): React.ReactElement;
+
+/**
+ * PaymentPage — the merchant's own payment page for a placed order.
+ *
+ * A whole page, not a widget, because of who reaches it: somebody who clicked
+ * "finish your payment" in an order e-mail, possibly days later, on a phone,
+ * with none of the shop's context around them. It has to answer "what do I owe
+ * and what do I do now" on its own.
+ *
+ *     <PaymentPage token={order.payment.token} statusHref={`/order/${t}`} />
+ *
+ * It renders exactly one of four situations, and the difference between them is
+ * the entire job:
+ *
+ *   1. THERE IS SOMETHING TO PAY  — the picker plus one button named after what
+ *      it does. The surcharge sits on the row and the amount due moves when the
+ *      method changes, so nobody picks cash-on-delivery and watches the total
+ *      grow afterwards.
+ *   2. BANK TRANSFER             — account, variable symbol, amount, QR. No
+ *      button; the details are the action.
+ *   3. ALREADY PAID              — a receipt, NOT an error. Arriving at a paid
+ *      link is the normal end of the happy path (and of every gateway return).
+ *   4. LOCKED                    — one of four reasons, each its own sentence.
+ *      `blocked_reason` carries four values precisely so the page can say four
+ *      different things; collapsing them into "cannot pay" sends the customer
+ *      to support.
+ *
+ * `token === null` renders nothing at all. The token is minted only while there
+ * is something to pay, so its absence is the server saying "no button here" —
+ * a disabled button would be a worse answer.
+ *
+ * **Returning from a gateway.** The page can be the `return_url`. Before it
+ * sends the browser to a gateway it remembers that in `sessionStorage`, so on
+ * the way back it knows to show "verifying your payment" and poll instead of
+ * offering to pay again — the callback often lands a second or two after the
+ * customer does, and a payable-looking page at that moment invites a double
+ * payment. Needs no cooperation from the route.
+ */
+
+interface PaymentPageProps {
+    /** The payment page's own token — the status page hands it over as
+     *  `order.payment.token`. `null` renders nothing. */
+    token: string | null;
+    /** Pre-fetched state (SSR / loader) — skips the first client fetch. */
+    payment?: PaymentState | null;
+    /** Where the gateway returns the customer after paying. Defaults to the
+     *  current URL, which makes this page its own return route. */
+    returnUrl?: string;
+    cancelUrl?: string;
+    /** Link to the full order status page, offered once there is nothing to pay. */
+    statusHref?: string;
     locale?: string;
+    /** Called once the payment reads as settled — e.g. to refresh an order view. */
+    onPaid?(payment: PaymentState): void;
 }
-declare function OrderStatusPage({ statusToken, order: initial, onContactSupport, locale, }: OrderStatusPageProps): React.ReactElement;
+declare function PaymentPage({ token, payment: initial, returnUrl, cancelUrl, statusHref, locale, onPaid, }: PaymentPageProps): React.ReactElement | null;
+
+/**
+ * PaymentMethodPicker — the ONE payment picker in the kit.
+ *
+ * Used by both the checkout's payment step and the payment page, and that is
+ * the whole point of it existing separately: switching from card to transfer
+ * has to look identical in the shop and on the page a customer reaches from an
+ * e-mail two days later. Two pickers that drift make the second one feel like
+ * somebody else's site — at the exact moment the customer is deciding whether
+ * to send money.
+ *
+ * The surcharge rides on the row because it is the consequence of the choice.
+ * Cash on delivery costs 39 Kč more; a picker that hides that until the total
+ * moves has let the shopper choose blind.
+ */
+
+interface PaymentMethodPickerProps {
+    methods: PaymentMethod[];
+    /** The chosen method's key (`PaymentMethod.method`), or null when none is. */
+    value: string | null;
+    onSelect(method: string): void;
+    /** Currency of the order/checkout — the surcharge is formatted in it. */
+    currency: string;
+    locale?: string;
+    /** Renders the rows unselectable (e.g. while a switch is in flight). */
+    disabled?: boolean;
+    /** Accessible name for the group. */
+    label?: string;
+}
+declare function PaymentMethodPicker({ methods, value, onSelect, currency, locale, disabled, label, }: PaymentMethodPickerProps): React.ReactElement;
+
+/**
+ * TransferInstructions — where to send the money for a bank-transfer order.
+ *
+ * Nothing in the kit rendered this until now, which meant a shopper who chose
+ * "bank transfer" placed the order and was told nothing about where to pay.
+ * The backend has always returned the account, the variable symbol, the amount
+ * and a ready-made QR image; it just had no home.
+ *
+ * There is deliberately NO button here. For a transfer these details ARE the
+ * action — the customer leaves for their banking app. A button would either lie
+ * about what it does or do nothing.
+ */
+
+interface TransferInstructionsProps {
+    instructions: PaymentInstructions;
+    locale?: string;
+}
+declare function TransferInstructions({ instructions: i, locale, }: TransferInstructionsProps): React.ReactElement;
 
 /**
  * AccountProvider + useAccount — shared logged-in-customer state. Resolves the
@@ -777,6 +972,7 @@ interface AccountState {
     signedIn: boolean;
     /** True until the initial session check resolves. */
     loading: boolean;
+    error: boolean;
     requestMagicLink(email: string): Promise<MagicLinkResult>;
     /** Exchange a magic token for a session (sets `customer`). */
     verify(token: string): Promise<Customer>;
@@ -852,6 +1048,9 @@ declare function AddressBook(): React.ReactElement;
 
 declare function ProfileEditor(): React.ReactElement | null;
 
+/** Email verification, session revocation and explicit account-closure confirmation. */
+declare function AccountSecurity(): React.ReactElement | null;
+
 /**
  * ProductJsonLd — schema.org/Product structured data for rich results (price,
  * availability, brand). Drop it in the PDP <head> (or anywhere; it's a script).
@@ -928,4 +1127,4 @@ interface JsonLdProps {
 /** Render a JSON-LD `<script>` for the given (already-shaped) data object. */
 declare function JsonLd({ data }: JsonLdProps): React.ReactElement;
 
-export { AccountDashboard, type AccountDashboardProps, AccountProvider, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentSection, type PaymentSectionProps, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, useStorefront, useStorefrontOptional, useT };
+export { AccountDashboard, type AccountDashboardProps, AccountProvider, AccountSecurity, type AccountState, AddToCart, type AddToCartProps, AddressBook, AddressForm, type AddressFormProps, AvailabilityFilter, type AvailabilityFilterProps, BackInStockForm, type BackInStockFormProps, type BreadcrumbItem, BreadcrumbJsonLd, type BreadcrumbJsonLdProps, CartDrawer, type CartDrawerProps, CartLineItem, type CartLineItemProps, CartProvider, type CartState, CartSummary, type CartSummaryProps, CheckoutFlow, type CheckoutFlowProps, CheckoutProvider, type CheckoutState, CollectionPage, type CollectionPageProps, I18nProvider, type I18nProviderProps, type I18nValue, JsonLd, type JsonLdProps, LoginForm, type LoginFormProps, type MarketOption, MarketSwitcher, type MarketSwitcherProps, type MessageKey, type Messages, NeviosProvider, type NeviosProviderProps, OrderConfirmation, type OrderConfirmationProps, OrderHistory, type OrderHistoryProps, OrderLines, OrderStatusPage, type OrderStatusPageProps, type OrderStatusState, OrderSummary, type OrderSummaryProps, OrderTotals, OrganizationJsonLd, type OrganizationJsonLdProps, type PayOptions, type PayResult, PaymentMethodPicker, type PaymentMethodPickerProps, PaymentPage, type PaymentPageProps, type PaymentPageState, PaymentSection, type PaymentSectionProps, PhaseTimeline, PriceMoney, type PriceMoneyProps, PriceRangeFilter, type PriceRangeFilterProps, ProductCard, type ProductCardProps, ProductDetailPage, type ProductDetailPageProps, ProductGallery, type ProductGalleryProps, ProductJsonLd, type ProductJsonLdProps, ProfileEditor, ShippingPicker, type ShippingPickerProps, SortSelect, type SortSelectProps, StatusBanner, StockBadge, type StockBadgeProps, type StorefrontTheme, type TFunction, type TVars, TagFilter, type TagFilterProps, ThemeProvider, type ThemeProviderProps, TransferInstructions, type TransferInstructionsProps, VariantPicker, type VariantPickerProps, type VerifyStatus, absoluteUrl, bundledMessages, cs, en, formatCents, formatMoney, isTerminal, serializeJsonLd, stripHtml, themeToCssVars, useAccount, useCart, useCheckout, useI18n, useMagicLinkVerify, useOrderStatus, usePayment, useStorefront, useStorefrontOptional, useT };