@asteby/storefront-react 0.25.0 → 0.26.0

package/dist/account.css

@@ -259,6 +259,97 @@
   border-top: 1px solid var(--sf-account-line, color-mix(in srgb, currentColor 14%, transparent));
 }
 
+/*
+ * Account settings (<SessionsList> and the other sections of the settings page). Optional and neutral.
+ * Variables: --sf-account-gap, --sf-account-muted, --sf-account-line, --sf-account-radius (same as the order screens).
+ */
+[data-sf-sessions] {
+  display: grid;
+  gap: var(--sf-account-gap, 1rem);
+}
+[data-sf-sessions-list] {
+  display: grid;
+  gap: 0.75rem;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+[data-sf-session] {
+  display: grid;
+  gap: 0.25rem;
+  padding: 0.875rem 1rem;
+  border: 1px solid var(--sf-account-line, color-mix(in srgb, currentColor 16%, transparent));
+  border-radius: var(--sf-account-radius, 0.75rem);
+}
+[data-sf-session-device],
+[data-sf-session-meta] {
+  margin: 0;
+}
+[data-sf-session-meta] {
+  color: var(--sf-account-muted, color-mix(in srgb, currentColor 72%, transparent));
+}
+[data-sf-session-current] {
+  font-weight: 600;
+}
+[data-sf-session-revoke],
+[data-sf-session-revoke-others] {
+  min-height: 44px;
+  justify-self: start;
+}
+[data-sf-sessions-error],
+[data-sf-sessions-degraded] {
+  margin: 0;
+}
+[data-sf-sessions-error] {
+  color: var(--sf-field-error, #b42318);
+}
+@media (prefers-reduced-motion: no-preference) {
+  [data-sf-session] {
+    transition: border-color 0.15s ease;
+  }
+}
+
+/* Language and notification preferences (<LanguagePreference>, <NotificationPreferences>). */
+[data-sf-lang] form,
+[data-sf-notif] form {
+  display: grid;
+  gap: var(--sf-account-gap, 1rem);
+}
+[data-sf-lang-select] {
+  min-height: 44px;
+}
+[data-sf-notif-table] {
+  width: 100%;
+  border-collapse: collapse;
+}
+[data-sf-notif-table] th,
+[data-sf-notif-table] td {
+  padding: 0.5rem 0.25rem;
+  text-align: center;
+}
+[data-sf-notif-table] tbody th {
+  text-align: start;
+  font-weight: 500;
+}
+[data-sf-notif-table] input[type='checkbox'] {
+  width: 1.5rem;
+  height: 1.5rem;
+}
+[data-sf-notif-required] {
+  margin: 0;
+  color: var(--sf-account-muted, color-mix(in srgb, currentColor 72%, transparent));
+}
+[data-sf-lang-submit],
+[data-sf-notif-submit] {
+  min-height: 44px;
+  justify-self: start;
+}
+[data-sf-lang-error],
+[data-sf-notif-error] {
+  margin: 0;
+  color: var(--sf-field-error, #b42318);
+}
+
 /* Paquetería sobre el nombre del envío (el texto lo escribe `shipment.carrier`). */
 [data-sf-shipment-eyebrow] {
   display: block;

package/dist/account.d.cts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, MouseEvent } from 'react';
-import { CustomerCapabilities, Order, NextAction, OrderProgress as OrderProgress$1, OrderLine, Shipment, ShipmentMap, InvoiceDoc, InvoiceSummary, InvoiceFileKind, PendingPayment, PaymentInfo, Refund, StorefrontClient, Connection, Money } from '@asteby/storefront';
+import { CustomerCapabilities, Order, NextAction, OrderProgress as OrderProgress$1, OrderLine, Shipment, ShipmentMap, InvoiceDoc, InvoiceSummary, InvoiceFileKind, PendingPayment, PaymentInfo, Refund, StorefrontClient, Connection, Money, CustomerSessionInfo, CustomerPreferences } from '@asteby/storefront';
 import { a as CheckoutFieldClassNames } from './fields-vnMUi2HB.cjs';
-import { A as AuthActionData, c as AuthStep, a as AuthErrorCode } from './types-D7pVK0GK.cjs';
-export { b as AuthIntent } from './types-D7pVK0GK.cjs';
+import { a as AuthActionData, d as AuthStep, b as AuthErrorCode, A as AccountSettingsActionData } from './settings-types-jxFQFFqP.cjs';
+export { c as AuthIntent, S as SettingsErrorCode, e as SettingsIntent } from './settings-types-jxFQFFqP.cjs';
 import { a as ProductPreviewClassNames, e as ProductThumbImage } from './product-preview-DRtLWGLS.cjs';
 export { P as ProductPreview, b as ProductPreviewProps, c as ProductThumb, f as ProductThumbProps, g as ProductThumbStack, h as ProductThumbStackProps, p as productInitials } from './product-preview-DRtLWGLS.cjs';
 import './components-B5XhSH-m.cjs';
@@ -137,7 +137,7 @@ declare function PostPurchaseAccountPrompt({ email, capabilities, data, next, pe
  * never as a raw code.
  */
 
-declare const ES: {
+declare const ES$1: {
     readonly 'order.number': "Pedido {number}";
     readonly 'order.placed': "Realizado el {date}";
     readonly 'order.total': "Total";
@@ -308,7 +308,7 @@ declare const ES: {
     readonly 'section.retry': "Reintentar";
     readonly 'section.loading': "Cargando";
 };
-type AccountMessageKey = keyof typeof ES;
+type AccountMessageKey = keyof typeof ES$1;
 type AccountMessages = Record<AccountMessageKey, string>;
 /** Messages for a locale (`es*` default, `en*`), with optional per-key overrides. */
 declare function accountMessages(locale?: string | null, overrides?: Partial<AccountMessages> | null): AccountMessages;
@@ -657,4 +657,128 @@ declare function barcodeGeometry(value: string, opts?: {
     height?: number;
 }): BarcodeGeometry | null;
 
-export { AccountAuth, type AccountAuthClassNames, type AccountAuthMessages, type AccountAuthProps, type AccountAuthView, type AccountFormProps, type AccountMessageKey, type AccountMessages, type AccountStatus, type AccountTextProps, AuthActionData, AuthErrorCode, AuthStep, Barcode, type BarcodeGeometry, type BarcodeProps, InvoiceList, type InvoiceListClassNames, type InvoiceListProps, NextActionBar, type NextActionBarClassNames, type NextActionBarProps, OrderCard, type OrderCardClassNames, type OrderCardProps, OrderLines, type OrderLinesClassNames, type OrderLinesProps, OrderList, type OrderListClassNames, type OrderListProps, OrderProductsStack, OrderProgress, type OrderProgressClassNames, type OrderProgressProps, OrderStatusBadge, type OrderStatusBadgeProps, type OrderTone, type PaymentLabelOptions, type PaymentMethodKey, PaymentSummary, type PaymentSummaryProps, PendingPaymentCard, type PendingPaymentCardClassNames, type PendingPaymentCardProps, PendingPaymentList, type PendingPaymentListProps, PostPurchaseAccountPrompt, type PostPurchaseAccountPromptClassNames, type PostPurchaseAccountPromptMessages, type PostPurchaseAccountPromptProps, RefundList, type RefundListClassNames, type RefundListProps, ShipmentCard, type ShipmentCardClassNames, type ShipmentCardProps, type ShipmentMapSlotProps, type UseConnectionResult, type UseCustomerOrderOptions, type UseCustomerOrderResult, type UseCustomerOrdersOptions, type UsePendingPaymentsOptions, type VoucherView, accountAuthMessages, accountMessages, barcodeGeometry, barcodeValue, code128Modules, enumText, lineImage, paymentLabel, paymentMethodKey, postPurchaseAccountPromptMessages, stageTone, useCustomerOrder, useCustomerOrders, usePendingPayments, voucherOf };
+/**
+ * Texts of the account settings screens (`SessionsList`, and the other sections). Spanish (es-MX) by default,
+ * English with `en*`, anything with `messages`. Server errors are codes (`SettingsErrorCode`); the words are here.
+ */
+
+declare const ES: {
+    'settings.saved': string;
+    'settings.error.session_expired': string;
+    'settings.error.invalid_credential': string;
+    'settings.error.reauth_required': string;
+    'settings.error.rate_limited': string;
+    'settings.error.rate_limited_in': string;
+    'settings.error.validation': string;
+    'settings.error.blocked_orders': string;
+    'settings.error.blocked_pending_payments': string;
+    'settings.error.unsupported': string;
+    'settings.error.unavailable': string;
+    'lang.title': string;
+    'lang.label': string;
+    'lang.default': string;
+    'lang.save': string;
+    'notif.title': string;
+    'notif.intro': string;
+    'notif.event.order_updates': string;
+    'notif.event.shipping': string;
+    'notif.event.restock': string;
+    'notif.event.unknown': string;
+    'notif.channel.email': string;
+    'notif.channel.whatsapp': string;
+    'notif.channel.unknown': string;
+    'notif.required': string;
+    'notif.save': string;
+    'notif.matrixLabel': string;
+    'sessions.title': string;
+    'sessions.intro': string;
+    'sessions.current': string;
+    'sessions.lastUsed': string;
+    'sessions.signedIn': string;
+    'sessions.method.email': string;
+    'sessions.method.phone': string;
+    'sessions.method.password': string;
+    'sessions.method.unknown': string;
+    'sessions.revoke': string;
+    'sessions.revokeLabel': string;
+    'sessions.revokeOthers': string;
+    'sessions.revoked': string;
+    'sessions.revokedOthers': string;
+    'sessions.none': string;
+    'sessions.error': string;
+    'sessions.loading': string;
+    'sessions.listLabel': string;
+};
+type SettingsMessageKey = keyof typeof ES;
+type SettingsMessages = Record<SettingsMessageKey, string>;
+/** Messages for a locale (`es*` default, `en*`), with optional per-key overrides. */
+declare function settingsMessages(locale?: string | null, overrides?: Partial<SettingsMessages> | null): SettingsMessages;
+/** The text of an open enum (`<group>.<value>`), else `<group>.unknown`. Never the raw value. */
+declare function settingsEnumText(m: SettingsMessages, group: string, value: unknown): string;
+
+type SettingsTextProps = {
+    /** BCP 47; defaults to the provider's, then `es-MX`. */
+    locale?: string;
+    /** Per-key text overrides (a store's own words). */
+    messages?: Partial<SettingsMessages>;
+    /** IANA time zone for dates. Pass the store's own to get the same text on server and browser. */
+    timeZone?: string;
+};
+
+type SessionsListClassNames = Partial<Record<'root' | 'title' | 'intro' | 'list' | 'item' | 'device' | 'badge' | 'meta' | 'revoke' | 'revokeOthers' | 'notice' | 'error' | 'empty', string>>;
+type SessionsListProps = SettingsTextProps & {
+    /** From `loadAccountSessions`. `null` = could not be loaded (the section degrades). */
+    sessions: CustomerSessionInfo[] | null;
+    /** What the settings action returned (`useActionData()`); drives the confirmation and the errors. */
+    data?: AccountSettingsActionData | null;
+    /** A submit is in flight: disables the buttons. */
+    pending?: boolean;
+    /** Form component, e.g. React Router's `Form`. Default: the HTML `<form>`. */
+    form?: 'form' | ComponentType<AccountFormProps>;
+    /** `action` of the forms: the route that mounts `createAccountSettingsAction`. Default: the current URL. */
+    action?: string;
+    /** Heading level of the title (default 3). */
+    headingLevel?: 2 | 3 | 4;
+    classNames?: SessionsListClassNames;
+    /** Extra content under the list. */
+    children?: ReactNode;
+};
+declare function SessionsList({ sessions, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: SessionsListProps): react.JSX.Element;
+
+/** The optional events the server accepts (anything else is refused by it). */
+declare const NOTIFICATION_EVENTS: readonly ["order_updates", "shipping", "restock"];
+type SectionProps = SettingsTextProps & {
+    data?: AccountSettingsActionData | null;
+    pending?: boolean;
+    /** Form component, e.g. React Router's `Form`. Default: the HTML `<form>`. */
+    form?: 'form' | ComponentType<AccountFormProps>;
+    /** `action` of the form: the route that mounts `createAccountSettingsAction`. Default: the current URL. */
+    action?: string;
+    headingLevel?: 2 | 3 | 4;
+    children?: ReactNode;
+};
+type LanguagePreferenceClassNames = Partial<Record<'root' | 'title' | 'form' | 'label' | 'select' | 'submit' | 'notice' | 'error', string>>;
+type LanguagePreferenceProps = SectionProps & {
+    /** The languages the store offers (`shop.locales`), as BCP 47 tags or `{ value, label }`. Fewer than two renders nothing. */
+    locales: ReadonlyArray<string | {
+        value: string;
+        label?: string;
+    }> | null | undefined;
+    /** The buyer's current language (`customer.locale`); `null` = the store's own. */
+    value?: string | null;
+    classNames?: LanguagePreferenceClassNames;
+};
+declare function LanguagePreference({ locales, value, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: LanguagePreferenceProps): react.JSX.Element | null;
+type NotificationPreferencesClassNames = Partial<Record<'root' | 'title' | 'intro' | 'form' | 'table' | 'row' | 'event' | 'channel' | 'check' | 'required' | 'submit' | 'notice' | 'error', string>>;
+type NotificationPreferencesProps = SectionProps & {
+    /** `capabilities.notifications.channels`: the channels the store can deliver on. Empty or absent renders nothing. */
+    channels: ReadonlyArray<string> | null | undefined;
+    /** `customer.preferences`. A choice never made counts as on (what the store sends today). */
+    preferences?: CustomerPreferences | null;
+    /** Events to offer (default: all the optional ones). */
+    events?: ReadonlyArray<string>;
+    classNames?: NotificationPreferencesClassNames;
+};
+declare function NotificationPreferences({ channels, preferences, events, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: NotificationPreferencesProps): react.JSX.Element | null;
+
+export { AccountAuth, type AccountAuthClassNames, type AccountAuthMessages, type AccountAuthProps, type AccountAuthView, type AccountFormProps, type AccountMessageKey, type AccountMessages, AccountSettingsActionData, type AccountStatus, type AccountTextProps, AuthActionData, AuthErrorCode, AuthStep, Barcode, type BarcodeGeometry, type BarcodeProps, InvoiceList, type InvoiceListClassNames, type InvoiceListProps, LanguagePreference, type LanguagePreferenceClassNames, type LanguagePreferenceProps, NOTIFICATION_EVENTS, NextActionBar, type NextActionBarClassNames, type NextActionBarProps, NotificationPreferences, type NotificationPreferencesClassNames, type NotificationPreferencesProps, OrderCard, type OrderCardClassNames, type OrderCardProps, OrderLines, type OrderLinesClassNames, type OrderLinesProps, OrderList, type OrderListClassNames, type OrderListProps, OrderProductsStack, OrderProgress, type OrderProgressClassNames, type OrderProgressProps, OrderStatusBadge, type OrderStatusBadgeProps, type OrderTone, type PaymentLabelOptions, type PaymentMethodKey, PaymentSummary, type PaymentSummaryProps, PendingPaymentCard, type PendingPaymentCardClassNames, type PendingPaymentCardProps, PendingPaymentList, type PendingPaymentListProps, PostPurchaseAccountPrompt, type PostPurchaseAccountPromptClassNames, type PostPurchaseAccountPromptMessages, type PostPurchaseAccountPromptProps, RefundList, type RefundListClassNames, type RefundListProps, SessionsList, type SessionsListClassNames, type SessionsListProps, type SettingsMessageKey, type SettingsMessages, type SettingsTextProps, ShipmentCard, type ShipmentCardClassNames, type ShipmentCardProps, type ShipmentMapSlotProps, type UseConnectionResult, type UseCustomerOrderOptions, type UseCustomerOrderResult, type UseCustomerOrdersOptions, type UsePendingPaymentsOptions, type VoucherView, accountAuthMessages, accountMessages, barcodeGeometry, barcodeValue, code128Modules, enumText, lineImage, paymentLabel, paymentMethodKey, postPurchaseAccountPromptMessages, settingsEnumText, settingsMessages, stageTone, useCustomerOrder, useCustomerOrders, usePendingPayments, voucherOf };

package/dist/account.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ComponentType, ReactNode, MouseEvent } from 'react';
-import { CustomerCapabilities, Order, NextAction, OrderProgress as OrderProgress$1, OrderLine, Shipment, ShipmentMap, InvoiceDoc, InvoiceSummary, InvoiceFileKind, PendingPayment, PaymentInfo, Refund, StorefrontClient, Connection, Money } from '@asteby/storefront';
+import { CustomerCapabilities, Order, NextAction, OrderProgress as OrderProgress$1, OrderLine, Shipment, ShipmentMap, InvoiceDoc, InvoiceSummary, InvoiceFileKind, PendingPayment, PaymentInfo, Refund, StorefrontClient, Connection, Money, CustomerSessionInfo, CustomerPreferences } from '@asteby/storefront';
 import { a as CheckoutFieldClassNames } from './fields-vnMUi2HB.js';
-import { A as AuthActionData, c as AuthStep, a as AuthErrorCode } from './types-D7pVK0GK.js';
-export { b as AuthIntent } from './types-D7pVK0GK.js';
+import { a as AuthActionData, d as AuthStep, b as AuthErrorCode, A as AccountSettingsActionData } from './settings-types-jxFQFFqP.js';
+export { c as AuthIntent, S as SettingsErrorCode, e as SettingsIntent } from './settings-types-jxFQFFqP.js';
 import { a as ProductPreviewClassNames, e as ProductThumbImage } from './product-preview-DaICr4f2.js';
 export { P as ProductPreview, b as ProductPreviewProps, c as ProductThumb, f as ProductThumbProps, g as ProductThumbStack, h as ProductThumbStackProps, p as productInitials } from './product-preview-DaICr4f2.js';
 import './components-B5XhSH-m.js';
@@ -137,7 +137,7 @@ declare function PostPurchaseAccountPrompt({ email, capabilities, data, next, pe
  * never as a raw code.
  */
 
-declare const ES: {
+declare const ES$1: {
     readonly 'order.number': "Pedido {number}";
     readonly 'order.placed': "Realizado el {date}";
     readonly 'order.total': "Total";
@@ -308,7 +308,7 @@ declare const ES: {
     readonly 'section.retry': "Reintentar";
     readonly 'section.loading': "Cargando";
 };
-type AccountMessageKey = keyof typeof ES;
+type AccountMessageKey = keyof typeof ES$1;
 type AccountMessages = Record<AccountMessageKey, string>;
 /** Messages for a locale (`es*` default, `en*`), with optional per-key overrides. */
 declare function accountMessages(locale?: string | null, overrides?: Partial<AccountMessages> | null): AccountMessages;
@@ -657,4 +657,128 @@ declare function barcodeGeometry(value: string, opts?: {
     height?: number;
 }): BarcodeGeometry | null;
 
-export { AccountAuth, type AccountAuthClassNames, type AccountAuthMessages, type AccountAuthProps, type AccountAuthView, type AccountFormProps, type AccountMessageKey, type AccountMessages, type AccountStatus, type AccountTextProps, AuthActionData, AuthErrorCode, AuthStep, Barcode, type BarcodeGeometry, type BarcodeProps, InvoiceList, type InvoiceListClassNames, type InvoiceListProps, NextActionBar, type NextActionBarClassNames, type NextActionBarProps, OrderCard, type OrderCardClassNames, type OrderCardProps, OrderLines, type OrderLinesClassNames, type OrderLinesProps, OrderList, type OrderListClassNames, type OrderListProps, OrderProductsStack, OrderProgress, type OrderProgressClassNames, type OrderProgressProps, OrderStatusBadge, type OrderStatusBadgeProps, type OrderTone, type PaymentLabelOptions, type PaymentMethodKey, PaymentSummary, type PaymentSummaryProps, PendingPaymentCard, type PendingPaymentCardClassNames, type PendingPaymentCardProps, PendingPaymentList, type PendingPaymentListProps, PostPurchaseAccountPrompt, type PostPurchaseAccountPromptClassNames, type PostPurchaseAccountPromptMessages, type PostPurchaseAccountPromptProps, RefundList, type RefundListClassNames, type RefundListProps, ShipmentCard, type ShipmentCardClassNames, type ShipmentCardProps, type ShipmentMapSlotProps, type UseConnectionResult, type UseCustomerOrderOptions, type UseCustomerOrderResult, type UseCustomerOrdersOptions, type UsePendingPaymentsOptions, type VoucherView, accountAuthMessages, accountMessages, barcodeGeometry, barcodeValue, code128Modules, enumText, lineImage, paymentLabel, paymentMethodKey, postPurchaseAccountPromptMessages, stageTone, useCustomerOrder, useCustomerOrders, usePendingPayments, voucherOf };
+/**
+ * Texts of the account settings screens (`SessionsList`, and the other sections). Spanish (es-MX) by default,
+ * English with `en*`, anything with `messages`. Server errors are codes (`SettingsErrorCode`); the words are here.
+ */
+
+declare const ES: {
+    'settings.saved': string;
+    'settings.error.session_expired': string;
+    'settings.error.invalid_credential': string;
+    'settings.error.reauth_required': string;
+    'settings.error.rate_limited': string;
+    'settings.error.rate_limited_in': string;
+    'settings.error.validation': string;
+    'settings.error.blocked_orders': string;
+    'settings.error.blocked_pending_payments': string;
+    'settings.error.unsupported': string;
+    'settings.error.unavailable': string;
+    'lang.title': string;
+    'lang.label': string;
+    'lang.default': string;
+    'lang.save': string;
+    'notif.title': string;
+    'notif.intro': string;
+    'notif.event.order_updates': string;
+    'notif.event.shipping': string;
+    'notif.event.restock': string;
+    'notif.event.unknown': string;
+    'notif.channel.email': string;
+    'notif.channel.whatsapp': string;
+    'notif.channel.unknown': string;
+    'notif.required': string;
+    'notif.save': string;
+    'notif.matrixLabel': string;
+    'sessions.title': string;
+    'sessions.intro': string;
+    'sessions.current': string;
+    'sessions.lastUsed': string;
+    'sessions.signedIn': string;
+    'sessions.method.email': string;
+    'sessions.method.phone': string;
+    'sessions.method.password': string;
+    'sessions.method.unknown': string;
+    'sessions.revoke': string;
+    'sessions.revokeLabel': string;
+    'sessions.revokeOthers': string;
+    'sessions.revoked': string;
+    'sessions.revokedOthers': string;
+    'sessions.none': string;
+    'sessions.error': string;
+    'sessions.loading': string;
+    'sessions.listLabel': string;
+};
+type SettingsMessageKey = keyof typeof ES;
+type SettingsMessages = Record<SettingsMessageKey, string>;
+/** Messages for a locale (`es*` default, `en*`), with optional per-key overrides. */
+declare function settingsMessages(locale?: string | null, overrides?: Partial<SettingsMessages> | null): SettingsMessages;
+/** The text of an open enum (`<group>.<value>`), else `<group>.unknown`. Never the raw value. */
+declare function settingsEnumText(m: SettingsMessages, group: string, value: unknown): string;
+
+type SettingsTextProps = {
+    /** BCP 47; defaults to the provider's, then `es-MX`. */
+    locale?: string;
+    /** Per-key text overrides (a store's own words). */
+    messages?: Partial<SettingsMessages>;
+    /** IANA time zone for dates. Pass the store's own to get the same text on server and browser. */
+    timeZone?: string;
+};
+
+type SessionsListClassNames = Partial<Record<'root' | 'title' | 'intro' | 'list' | 'item' | 'device' | 'badge' | 'meta' | 'revoke' | 'revokeOthers' | 'notice' | 'error' | 'empty', string>>;
+type SessionsListProps = SettingsTextProps & {
+    /** From `loadAccountSessions`. `null` = could not be loaded (the section degrades). */
+    sessions: CustomerSessionInfo[] | null;
+    /** What the settings action returned (`useActionData()`); drives the confirmation and the errors. */
+    data?: AccountSettingsActionData | null;
+    /** A submit is in flight: disables the buttons. */
+    pending?: boolean;
+    /** Form component, e.g. React Router's `Form`. Default: the HTML `<form>`. */
+    form?: 'form' | ComponentType<AccountFormProps>;
+    /** `action` of the forms: the route that mounts `createAccountSettingsAction`. Default: the current URL. */
+    action?: string;
+    /** Heading level of the title (default 3). */
+    headingLevel?: 2 | 3 | 4;
+    classNames?: SessionsListClassNames;
+    /** Extra content under the list. */
+    children?: ReactNode;
+};
+declare function SessionsList({ sessions, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: SessionsListProps): react.JSX.Element;
+
+/** The optional events the server accepts (anything else is refused by it). */
+declare const NOTIFICATION_EVENTS: readonly ["order_updates", "shipping", "restock"];
+type SectionProps = SettingsTextProps & {
+    data?: AccountSettingsActionData | null;
+    pending?: boolean;
+    /** Form component, e.g. React Router's `Form`. Default: the HTML `<form>`. */
+    form?: 'form' | ComponentType<AccountFormProps>;
+    /** `action` of the form: the route that mounts `createAccountSettingsAction`. Default: the current URL. */
+    action?: string;
+    headingLevel?: 2 | 3 | 4;
+    children?: ReactNode;
+};
+type LanguagePreferenceClassNames = Partial<Record<'root' | 'title' | 'form' | 'label' | 'select' | 'submit' | 'notice' | 'error', string>>;
+type LanguagePreferenceProps = SectionProps & {
+    /** The languages the store offers (`shop.locales`), as BCP 47 tags or `{ value, label }`. Fewer than two renders nothing. */
+    locales: ReadonlyArray<string | {
+        value: string;
+        label?: string;
+    }> | null | undefined;
+    /** The buyer's current language (`customer.locale`); `null` = the store's own. */
+    value?: string | null;
+    classNames?: LanguagePreferenceClassNames;
+};
+declare function LanguagePreference({ locales, value, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: LanguagePreferenceProps): react.JSX.Element | null;
+type NotificationPreferencesClassNames = Partial<Record<'root' | 'title' | 'intro' | 'form' | 'table' | 'row' | 'event' | 'channel' | 'check' | 'required' | 'submit' | 'notice' | 'error', string>>;
+type NotificationPreferencesProps = SectionProps & {
+    /** `capabilities.notifications.channels`: the channels the store can deliver on. Empty or absent renders nothing. */
+    channels: ReadonlyArray<string> | null | undefined;
+    /** `customer.preferences`. A choice never made counts as on (what the store sends today). */
+    preferences?: CustomerPreferences | null;
+    /** Events to offer (default: all the optional ones). */
+    events?: ReadonlyArray<string>;
+    classNames?: NotificationPreferencesClassNames;
+};
+declare function NotificationPreferences({ channels, preferences, events, data, pending, form: FormTag, action, headingLevel, classNames: cx, children, ...text }: NotificationPreferencesProps): react.JSX.Element | null;
+
+export { AccountAuth, type AccountAuthClassNames, type AccountAuthMessages, type AccountAuthProps, type AccountAuthView, type AccountFormProps, type AccountMessageKey, type AccountMessages, AccountSettingsActionData, type AccountStatus, type AccountTextProps, AuthActionData, AuthErrorCode, AuthStep, Barcode, type BarcodeGeometry, type BarcodeProps, InvoiceList, type InvoiceListClassNames, type InvoiceListProps, LanguagePreference, type LanguagePreferenceClassNames, type LanguagePreferenceProps, NOTIFICATION_EVENTS, NextActionBar, type NextActionBarClassNames, type NextActionBarProps, NotificationPreferences, type NotificationPreferencesClassNames, type NotificationPreferencesProps, OrderCard, type OrderCardClassNames, type OrderCardProps, OrderLines, type OrderLinesClassNames, type OrderLinesProps, OrderList, type OrderListClassNames, type OrderListProps, OrderProductsStack, OrderProgress, type OrderProgressClassNames, type OrderProgressProps, OrderStatusBadge, type OrderStatusBadgeProps, type OrderTone, type PaymentLabelOptions, type PaymentMethodKey, PaymentSummary, type PaymentSummaryProps, PendingPaymentCard, type PendingPaymentCardClassNames, type PendingPaymentCardProps, PendingPaymentList, type PendingPaymentListProps, PostPurchaseAccountPrompt, type PostPurchaseAccountPromptClassNames, type PostPurchaseAccountPromptMessages, type PostPurchaseAccountPromptProps, RefundList, type RefundListClassNames, type RefundListProps, SessionsList, type SessionsListClassNames, type SessionsListProps, type SettingsMessageKey, type SettingsMessages, type SettingsTextProps, ShipmentCard, type ShipmentCardClassNames, type ShipmentCardProps, type ShipmentMapSlotProps, type UseConnectionResult, type UseCustomerOrderOptions, type UseCustomerOrderResult, type UseCustomerOrdersOptions, type UsePendingPaymentsOptions, type VoucherView, accountAuthMessages, accountMessages, barcodeGeometry, barcodeValue, code128Modules, enumText, lineImage, paymentLabel, paymentMethodKey, postPurchaseAccountPromptMessages, settingsEnumText, settingsMessages, stageTone, useCustomerOrder, useCustomerOrders, usePendingPayments, voucherOf };