@flopay/shared 1.11.6 → 1.12.0

package/dist/index.d.cts

@@ -2075,11 +2075,22 @@ interface ProcessingOverlayThemeColors {
     noteColor: string;
 }
 /**
- * The card-setup processing / success / error modal for a named preset: the
- * panel reuses the credit-card pane surface and typography; processing wears
- * the preset primary on the spinner; success and error keep semantic accents.
+ * The resolved look an overlay is drawn from: a preset bundle, or the
+ * effective appearance and buttons layout once a stored theme's overrides are
+ * merged over it. A `ThemeBundle` is one.
  */
-declare function computeCardSetupOverlayTheme(bundle: ThemeBundle): ProcessingOverlayThemeColors;
+interface CardSetupOverlaySource {
+    appearance?: FloPayAppearance | undefined;
+    buttonsLayout: ButtonsLayoutStyles;
+}
+/**
+ * The card-setup processing / success / error modal for a named preset (or a
+ * stored theme resolved over one): the panel reuses the credit-card pane
+ * surface and typography; processing wears the primary on the spinner; success
+ * and error keep semantic accents. A missing appearance reads as an empty one,
+ * which resolves to the neutral light defaults.
+ */
+declare function computeCardSetupOverlayTheme({ appearance, buttonsLayout, }: CardSetupOverlaySource): ProcessingOverlayThemeColors;
 
 /**
  * Surface treatment for the card-setup container — the same complete
@@ -2097,14 +2108,62 @@ declare function computeCardSetupOverlayTheme(bundle: ThemeBundle): ProcessingOv
  *    `containerStyle` therefore replaces the preset's background family
  *    entirely, so a merchant color never shows a glass gradient through it.
  *
- * `classic` and raw `VaultCardThemeColors` supply no surface, so `containerStyle`
- * applies alone — byte-for-byte the released behavior.
+ * Raw `VaultCardThemeColors` supply no surface, and neither does `classic`
+ * unless a stored `buttonsStyles.cardFormContainer` is given (sdk#447); without
+ * a surface `containerStyle` applies alone — byte-for-byte the released behavior.
  *
  * Framework-free (any style-object type), so every UI binding merges the same
  * way (TeamFloPay/sdk#410, CTO decision 1).
  */
 declare function mergeCardSetupSurface<Style extends object>(surface: Style | undefined, containerStyle: Style | undefined): Style | undefined;
 
+/**
+ * Merge a `buttonsStyles` override over a base buttons layout exactly as
+ * `FloPayCheckout` (its `SplitCardForm`) does: top-level members replace the
+ * base's, and each style group in {@link MERGED_BUTTONS_GROUPS} merges property
+ * by property. A group that is not an object (malformed persisted data) is
+ * ignored rather than spread, so it can never throw or leak junk keys.
+ */
+declare function mergeButtonsStyles(base: ButtonsLayoutStyles, override: ButtonsLayoutStyles | undefined): ButtonsLayoutStyles;
+/** Inputs for {@link resolveCardSetupTheme}: the `FloPayCardSetup` theming props. */
+interface CardSetupThemeSource {
+    theme: ThemeId | VaultCardThemeColors;
+    appearance?: FloPayAppearance | undefined;
+    buttonsStyles?: ButtonsLayoutStyles | undefined;
+}
+/** Everything the card-setup surface paints, resolved from one stored theme. */
+interface CardSetupThemeResolution {
+    /**
+     * The hosted-widget directive: computed colors, raw colors passed through
+     * untouched, or `null` — the explicit classic reset.
+     */
+    vaultTheme: VaultCardThemeColors | null;
+    /** The pane surface laid beneath the merchant's `containerStyle`, if any. */
+    surface: Record<string, string | number> | undefined;
+    /** The outcome overlay's theme; `undefined` keeps the neutral modal. */
+    overlayTheme: ProcessingOverlayThemeColors | undefined;
+}
+/**
+ * Resolve the card-setup theming props the same way `FloPayCheckout` resolves
+ * its own, so one stored theme (`themePreset` → `theme`, plus `appearance` and
+ * `buttonsStyles`) renders the hosted card form identically on both surfaces:
+ *
+ * - An `appearance` override replaces the preset's appearance outright.
+ * - `buttonsStyles` merges over the preset's buttons layout
+ *   ({@link mergeButtonsStyles}).
+ * - `'classic'` only means "no bundle base": overrides still apply over the
+ *   default (empty) layout, and with none it keeps the historic `null` reset,
+ *   no surface and the neutral overlay.
+ * - Raw `VaultCardThemeColors` pass through untouched; overrides are ignored.
+ * - Empty override groups count as absent; an unknown preset id resolves to
+ *   `modern-light`.
+ *
+ * The effective appearance and layout drive all four outputs: the hosted field
+ * colors and font, the hosted submit snapshot, the container surface and the
+ * outcome overlay.
+ */
+declare function resolveCardSetupTheme({ theme, appearance, buttonsStyles, }: CardSetupThemeSource): CardSetupThemeResolution;
+
 /**
  * The PayPal gateway fields the direct PayPal button needs: the session's
  * `gateways.paypal`, or the normalized `data.paypal` copy of it.
@@ -2341,7 +2400,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.11.6";
+declare const SDK_VERSION = "1.12.0";
 /**
  * HTTP header the SDK sends on checkout-session create/read requests so the
  * backend can observe compatibility. Version 1.4.9 is the first release that
@@ -3598,4 +3657,4 @@ declare function resolveWalletModeOptions(amountInMinorUnits: number | undefined
     captureMethod: 'automatic_async' | 'manual';
 };
 
-export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutLogLayout, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessAvsInput, type CheckoutProcessError, type CheckoutProcessMetadataInput, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DirectPayPalConfig, type DirectPayPalGatewaySource, type DisplayLineItem, EXTERNAL_METHOD_CALLBACK_GRACE_MS, type ExternalMethodFailureClassification, type ExternalMethodFailureContext, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_ONCE_NAMES, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloInstrumentSource, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalBrowserEnvironment, type PayPalBuyerIdentity, type PayPalPaymentResult, type PayPalProcessPaymentInput, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentMethodSetupAdvertisement, type PaymentProviderAdapter, type PaymentResult, type PriceData, type PrimaryTileStyle, type PrimaryTileStyleSource, type PrimaryTileSubmitStyle, type ProcessPaymentParams, type ProcessingOverlayStatus, type ProcessingOverlayThemeColors, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, STRIPE_PAYPAL_RESUME_KEY, STRIPE_REDIRECT_PARAMS, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type SetupOverlayWording, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripePayPalResumeContinuation, type StripeSafeAppearance, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type VaultThemeSource, type WalletPresentation, type WebhookEvent, advertisedMethodKeys, advertisesAnyMethod, apiError, applyFriendlyMessageOverride, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildCheckoutProcessMetadata, buildExternalMethodRecoveryMessage, buildItemPayload, buildPayPalProcessPaymentRequest, buildPayPalSessionIntentRequest, buildPayPalTokenizedBody, buildProcessPaymentAvsAccount, buildProcessPaymentAvsExposure, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, canRecoverHostedCardForm, classifyExternalMethodFailure, classifyPaymentRejection, classifyTelemetryFailure, clearCachedInlineCheckout, clearCachedInlineSession, clearStripePayPalReturn, compactBuyerIdentity, computeCardSetupOverlayTheme, computeVaultCardThemeColors, configureFlopay, darkenHex, derivePrimaryTileStyle, describePayPalProcessFailure, detectPayPalEnvironment, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCountryGate, filterStripeMethodsByCurrency, foldIntoProducts, friendlyPayPalFailureMessage, generateIdempotencyKey, getButtonMethodLabel, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getProviderDeclineCode, getProviderErrorCode, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasMatchingStripePayPalReturn, hasServerSideCardGateway, hasVendoredStripeMethodLogo, hashCreateParams, invokeMerchantCallback, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPayPalAcknowledgementDeadWindow, isPayPalTeardownMessage, isPopupBlockedError, isPostalCodeSupported, isProviderDecline, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, legacyCachedSessionMatchesDraft, markSessionRecentlyCompleted, mergeCardSetupSurface, mergePayPalPayerIdentity, needsPayPalPayerDetails, needsStripeMethodExplicitConfirm, networkError, normalizeBeforeButtonClickError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, paypalProviderIdentityRequired, persistCachedInlineIdempotencyKey, persistCachedInlineSession, projectFloInstrument, randomUuidV4, rateLimitError, readCachedInlineIdempotencyKey, readCachedInlineSession, readMatchingStripePayPalContinuation, readPayPalPayerIdentity, readSetupAdvertisement, readStripeRedirectParams, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveCheckoutLogLayout, resolveDirectPaypalConfig, resolveIdempotencyKey, resolvePayPalApprovalIdentity, resolvePayPalDeclineReason, resolvePayPalPresentationMode, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveStripePayPalPresentation, resolveTheme, resolveVaultMountOptions, resolveWalletModeOptions, sanitizeExternalFailureCode, serializeCreateParams, serializeTelemetryBatch, setupOverlayLabels, splitFullName, stripeExpressMethodToOptionKey, stripeMethodCategory, stripeRedirectReturnUrl, telemetryStatusClass, toCssWeight, toStripeAppearance, toStripeAppearanceTheme, usesPayPalVaultedChannel, validationError, wasSessionRecentlyCompleted, writeStripePayPalContinuation };
+export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CardSetupOverlaySource, type CardSetupThemeResolution, type CardSetupThemeSource, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutLogLayout, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessAvsInput, type CheckoutProcessError, type CheckoutProcessMetadataInput, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DirectPayPalConfig, type DirectPayPalGatewaySource, type DisplayLineItem, EXTERNAL_METHOD_CALLBACK_GRACE_MS, type ExternalMethodFailureClassification, type ExternalMethodFailureContext, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_ONCE_NAMES, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloInstrumentSource, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalBrowserEnvironment, type PayPalBuyerIdentity, type PayPalPaymentResult, type PayPalProcessPaymentInput, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentMethodSetupAdvertisement, type PaymentProviderAdapter, type PaymentResult, type PriceData, type PrimaryTileStyle, type PrimaryTileStyleSource, type PrimaryTileSubmitStyle, type ProcessPaymentParams, type ProcessingOverlayStatus, type ProcessingOverlayThemeColors, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, STRIPE_PAYPAL_RESUME_KEY, STRIPE_REDIRECT_PARAMS, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type SetupOverlayWording, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripePayPalResumeContinuation, type StripeSafeAppearance, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type VaultThemeSource, type WalletPresentation, type WebhookEvent, advertisedMethodKeys, advertisesAnyMethod, apiError, applyFriendlyMessageOverride, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildCheckoutProcessMetadata, buildExternalMethodRecoveryMessage, buildItemPayload, buildPayPalProcessPaymentRequest, buildPayPalSessionIntentRequest, buildPayPalTokenizedBody, buildProcessPaymentAvsAccount, buildProcessPaymentAvsExposure, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, canRecoverHostedCardForm, classifyExternalMethodFailure, classifyPaymentRejection, classifyTelemetryFailure, clearCachedInlineCheckout, clearCachedInlineSession, clearStripePayPalReturn, compactBuyerIdentity, computeCardSetupOverlayTheme, computeVaultCardThemeColors, configureFlopay, darkenHex, derivePrimaryTileStyle, describePayPalProcessFailure, detectPayPalEnvironment, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCountryGate, filterStripeMethodsByCurrency, foldIntoProducts, friendlyPayPalFailureMessage, generateIdempotencyKey, getButtonMethodLabel, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getProviderDeclineCode, getProviderErrorCode, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasMatchingStripePayPalReturn, hasServerSideCardGateway, hasVendoredStripeMethodLogo, hashCreateParams, invokeMerchantCallback, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPayPalAcknowledgementDeadWindow, isPayPalTeardownMessage, isPopupBlockedError, isPostalCodeSupported, isProviderDecline, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, legacyCachedSessionMatchesDraft, markSessionRecentlyCompleted, mergeButtonsStyles, mergeCardSetupSurface, mergePayPalPayerIdentity, needsPayPalPayerDetails, needsStripeMethodExplicitConfirm, networkError, normalizeBeforeButtonClickError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, paypalProviderIdentityRequired, persistCachedInlineIdempotencyKey, persistCachedInlineSession, projectFloInstrument, randomUuidV4, rateLimitError, readCachedInlineIdempotencyKey, readCachedInlineSession, readMatchingStripePayPalContinuation, readPayPalPayerIdentity, readSetupAdvertisement, readStripeRedirectParams, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveCardSetupTheme, resolveCheckoutLogLayout, resolveDirectPaypalConfig, resolveIdempotencyKey, resolvePayPalApprovalIdentity, resolvePayPalDeclineReason, resolvePayPalPresentationMode, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveStripePayPalPresentation, resolveTheme, resolveVaultMountOptions, resolveWalletModeOptions, sanitizeExternalFailureCode, serializeCreateParams, serializeTelemetryBatch, setupOverlayLabels, splitFullName, stripeExpressMethodToOptionKey, stripeMethodCategory, stripeRedirectReturnUrl, telemetryStatusClass, toCssWeight, toStripeAppearance, toStripeAppearanceTheme, usesPayPalVaultedChannel, validationError, wasSessionRecentlyCompleted, writeStripePayPalContinuation };

package/dist/index.d.ts

@@ -2075,11 +2075,22 @@ interface ProcessingOverlayThemeColors {
     noteColor: string;
 }
 /**
- * The card-setup processing / success / error modal for a named preset: the
- * panel reuses the credit-card pane surface and typography; processing wears
- * the preset primary on the spinner; success and error keep semantic accents.
+ * The resolved look an overlay is drawn from: a preset bundle, or the
+ * effective appearance and buttons layout once a stored theme's overrides are
+ * merged over it. A `ThemeBundle` is one.
  */
-declare function computeCardSetupOverlayTheme(bundle: ThemeBundle): ProcessingOverlayThemeColors;
+interface CardSetupOverlaySource {
+    appearance?: FloPayAppearance | undefined;
+    buttonsLayout: ButtonsLayoutStyles;
+}
+/**
+ * The card-setup processing / success / error modal for a named preset (or a
+ * stored theme resolved over one): the panel reuses the credit-card pane
+ * surface and typography; processing wears the primary on the spinner; success
+ * and error keep semantic accents. A missing appearance reads as an empty one,
+ * which resolves to the neutral light defaults.
+ */
+declare function computeCardSetupOverlayTheme({ appearance, buttonsLayout, }: CardSetupOverlaySource): ProcessingOverlayThemeColors;
 
 /**
  * Surface treatment for the card-setup container — the same complete
@@ -2097,14 +2108,62 @@ declare function computeCardSetupOverlayTheme(bundle: ThemeBundle): ProcessingOv
  *    `containerStyle` therefore replaces the preset's background family
  *    entirely, so a merchant color never shows a glass gradient through it.
  *
- * `classic` and raw `VaultCardThemeColors` supply no surface, so `containerStyle`
- * applies alone — byte-for-byte the released behavior.
+ * Raw `VaultCardThemeColors` supply no surface, and neither does `classic`
+ * unless a stored `buttonsStyles.cardFormContainer` is given (sdk#447); without
+ * a surface `containerStyle` applies alone — byte-for-byte the released behavior.
  *
  * Framework-free (any style-object type), so every UI binding merges the same
  * way (TeamFloPay/sdk#410, CTO decision 1).
  */
 declare function mergeCardSetupSurface<Style extends object>(surface: Style | undefined, containerStyle: Style | undefined): Style | undefined;
 
+/**
+ * Merge a `buttonsStyles` override over a base buttons layout exactly as
+ * `FloPayCheckout` (its `SplitCardForm`) does: top-level members replace the
+ * base's, and each style group in {@link MERGED_BUTTONS_GROUPS} merges property
+ * by property. A group that is not an object (malformed persisted data) is
+ * ignored rather than spread, so it can never throw or leak junk keys.
+ */
+declare function mergeButtonsStyles(base: ButtonsLayoutStyles, override: ButtonsLayoutStyles | undefined): ButtonsLayoutStyles;
+/** Inputs for {@link resolveCardSetupTheme}: the `FloPayCardSetup` theming props. */
+interface CardSetupThemeSource {
+    theme: ThemeId | VaultCardThemeColors;
+    appearance?: FloPayAppearance | undefined;
+    buttonsStyles?: ButtonsLayoutStyles | undefined;
+}
+/** Everything the card-setup surface paints, resolved from one stored theme. */
+interface CardSetupThemeResolution {
+    /**
+     * The hosted-widget directive: computed colors, raw colors passed through
+     * untouched, or `null` — the explicit classic reset.
+     */
+    vaultTheme: VaultCardThemeColors | null;
+    /** The pane surface laid beneath the merchant's `containerStyle`, if any. */
+    surface: Record<string, string | number> | undefined;
+    /** The outcome overlay's theme; `undefined` keeps the neutral modal. */
+    overlayTheme: ProcessingOverlayThemeColors | undefined;
+}
+/**
+ * Resolve the card-setup theming props the same way `FloPayCheckout` resolves
+ * its own, so one stored theme (`themePreset` → `theme`, plus `appearance` and
+ * `buttonsStyles`) renders the hosted card form identically on both surfaces:
+ *
+ * - An `appearance` override replaces the preset's appearance outright.
+ * - `buttonsStyles` merges over the preset's buttons layout
+ *   ({@link mergeButtonsStyles}).
+ * - `'classic'` only means "no bundle base": overrides still apply over the
+ *   default (empty) layout, and with none it keeps the historic `null` reset,
+ *   no surface and the neutral overlay.
+ * - Raw `VaultCardThemeColors` pass through untouched; overrides are ignored.
+ * - Empty override groups count as absent; an unknown preset id resolves to
+ *   `modern-light`.
+ *
+ * The effective appearance and layout drive all four outputs: the hosted field
+ * colors and font, the hosted submit snapshot, the container surface and the
+ * outcome overlay.
+ */
+declare function resolveCardSetupTheme({ theme, appearance, buttonsStyles, }: CardSetupThemeSource): CardSetupThemeResolution;
+
 /**
  * The PayPal gateway fields the direct PayPal button needs: the session's
  * `gateways.paypal`, or the normalized `data.paypal` copy of it.
@@ -2341,7 +2400,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.11.6";
+declare const SDK_VERSION = "1.12.0";
 /**
  * HTTP header the SDK sends on checkout-session create/read requests so the
  * backend can observe compatibility. Version 1.4.9 is the first release that
@@ -3598,4 +3657,4 @@ declare function resolveWalletModeOptions(amountInMinorUnits: number | undefined
     captureMethod: 'automatic_async' | 'manual';
 };
 
-export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutLogLayout, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessAvsInput, type CheckoutProcessError, type CheckoutProcessMetadataInput, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DirectPayPalConfig, type DirectPayPalGatewaySource, type DisplayLineItem, EXTERNAL_METHOD_CALLBACK_GRACE_MS, type ExternalMethodFailureClassification, type ExternalMethodFailureContext, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_ONCE_NAMES, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloInstrumentSource, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalBrowserEnvironment, type PayPalBuyerIdentity, type PayPalPaymentResult, type PayPalProcessPaymentInput, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentMethodSetupAdvertisement, type PaymentProviderAdapter, type PaymentResult, type PriceData, type PrimaryTileStyle, type PrimaryTileStyleSource, type PrimaryTileSubmitStyle, type ProcessPaymentParams, type ProcessingOverlayStatus, type ProcessingOverlayThemeColors, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, STRIPE_PAYPAL_RESUME_KEY, STRIPE_REDIRECT_PARAMS, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type SetupOverlayWording, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripePayPalResumeContinuation, type StripeSafeAppearance, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type VaultThemeSource, type WalletPresentation, type WebhookEvent, advertisedMethodKeys, advertisesAnyMethod, apiError, applyFriendlyMessageOverride, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildCheckoutProcessMetadata, buildExternalMethodRecoveryMessage, buildItemPayload, buildPayPalProcessPaymentRequest, buildPayPalSessionIntentRequest, buildPayPalTokenizedBody, buildProcessPaymentAvsAccount, buildProcessPaymentAvsExposure, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, canRecoverHostedCardForm, classifyExternalMethodFailure, classifyPaymentRejection, classifyTelemetryFailure, clearCachedInlineCheckout, clearCachedInlineSession, clearStripePayPalReturn, compactBuyerIdentity, computeCardSetupOverlayTheme, computeVaultCardThemeColors, configureFlopay, darkenHex, derivePrimaryTileStyle, describePayPalProcessFailure, detectPayPalEnvironment, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCountryGate, filterStripeMethodsByCurrency, foldIntoProducts, friendlyPayPalFailureMessage, generateIdempotencyKey, getButtonMethodLabel, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getProviderDeclineCode, getProviderErrorCode, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasMatchingStripePayPalReturn, hasServerSideCardGateway, hasVendoredStripeMethodLogo, hashCreateParams, invokeMerchantCallback, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPayPalAcknowledgementDeadWindow, isPayPalTeardownMessage, isPopupBlockedError, isPostalCodeSupported, isProviderDecline, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, legacyCachedSessionMatchesDraft, markSessionRecentlyCompleted, mergeCardSetupSurface, mergePayPalPayerIdentity, needsPayPalPayerDetails, needsStripeMethodExplicitConfirm, networkError, normalizeBeforeButtonClickError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, paypalProviderIdentityRequired, persistCachedInlineIdempotencyKey, persistCachedInlineSession, projectFloInstrument, randomUuidV4, rateLimitError, readCachedInlineIdempotencyKey, readCachedInlineSession, readMatchingStripePayPalContinuation, readPayPalPayerIdentity, readSetupAdvertisement, readStripeRedirectParams, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveCheckoutLogLayout, resolveDirectPaypalConfig, resolveIdempotencyKey, resolvePayPalApprovalIdentity, resolvePayPalDeclineReason, resolvePayPalPresentationMode, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveStripePayPalPresentation, resolveTheme, resolveVaultMountOptions, resolveWalletModeOptions, sanitizeExternalFailureCode, serializeCreateParams, serializeTelemetryBatch, setupOverlayLabels, splitFullName, stripeExpressMethodToOptionKey, stripeMethodCategory, stripeRedirectReturnUrl, telemetryStatusClass, toCssWeight, toStripeAppearance, toStripeAppearanceTheme, usesPayPalVaultedChannel, validationError, wasSessionRecentlyCompleted, writeStripePayPalContinuation };
+export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CardSetupOverlaySource, type CardSetupThemeResolution, type CardSetupThemeSource, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutLogLayout, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessAvsInput, type CheckoutProcessError, type CheckoutProcessMetadataInput, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DirectPayPalConfig, type DirectPayPalGatewaySource, type DisplayLineItem, EXTERNAL_METHOD_CALLBACK_GRACE_MS, type ExternalMethodFailureClassification, type ExternalMethodFailureContext, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_ONCE_NAMES, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloInstrumentSource, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalBrowserEnvironment, type PayPalBuyerIdentity, type PayPalPaymentResult, type PayPalProcessPaymentInput, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentMethodSetupAdvertisement, type PaymentProviderAdapter, type PaymentResult, type PriceData, type PrimaryTileStyle, type PrimaryTileStyleSource, type PrimaryTileSubmitStyle, type ProcessPaymentParams, type ProcessingOverlayStatus, type ProcessingOverlayThemeColors, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, STRIPE_PAYPAL_RESUME_KEY, STRIPE_REDIRECT_PARAMS, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type SetupOverlayWording, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripePayPalResumeContinuation, type StripeSafeAppearance, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type VaultThemeSource, type WalletPresentation, type WebhookEvent, advertisedMethodKeys, advertisesAnyMethod, apiError, applyFriendlyMessageOverride, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildCheckoutProcessMetadata, buildExternalMethodRecoveryMessage, buildItemPayload, buildPayPalProcessPaymentRequest, buildPayPalSessionIntentRequest, buildPayPalTokenizedBody, buildProcessPaymentAvsAccount, buildProcessPaymentAvsExposure, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, canRecoverHostedCardForm, classifyExternalMethodFailure, classifyPaymentRejection, classifyTelemetryFailure, clearCachedInlineCheckout, clearCachedInlineSession, clearStripePayPalReturn, compactBuyerIdentity, computeCardSetupOverlayTheme, computeVaultCardThemeColors, configureFlopay, darkenHex, derivePrimaryTileStyle, describePayPalProcessFailure, detectPayPalEnvironment, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCountryGate, filterStripeMethodsByCurrency, foldIntoProducts, friendlyPayPalFailureMessage, generateIdempotencyKey, getButtonMethodLabel, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getProviderDeclineCode, getProviderErrorCode, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasMatchingStripePayPalReturn, hasServerSideCardGateway, hasVendoredStripeMethodLogo, hashCreateParams, invokeMerchantCallback, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPayPalAcknowledgementDeadWindow, isPayPalTeardownMessage, isPopupBlockedError, isPostalCodeSupported, isProviderDecline, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, legacyCachedSessionMatchesDraft, markSessionRecentlyCompleted, mergeButtonsStyles, mergeCardSetupSurface, mergePayPalPayerIdentity, needsPayPalPayerDetails, needsStripeMethodExplicitConfirm, networkError, normalizeBeforeButtonClickError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, paypalProviderIdentityRequired, persistCachedInlineIdempotencyKey, persistCachedInlineSession, projectFloInstrument, randomUuidV4, rateLimitError, readCachedInlineIdempotencyKey, readCachedInlineSession, readMatchingStripePayPalContinuation, readPayPalPayerIdentity, readSetupAdvertisement, readStripeRedirectParams, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveCardSetupTheme, resolveCheckoutLogLayout, resolveDirectPaypalConfig, resolveIdempotencyKey, resolvePayPalApprovalIdentity, resolvePayPalDeclineReason, resolvePayPalPresentationMode, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveStripePayPalPresentation, resolveTheme, resolveVaultMountOptions, resolveWalletModeOptions, sanitizeExternalFailureCode, serializeCreateParams, serializeTelemetryBatch, setupOverlayLabels, splitFullName, stripeExpressMethodToOptionKey, stripeMethodCategory, stripeRedirectReturnUrl, telemetryStatusClass, toCssWeight, toStripeAppearance, toStripeAppearanceTheme, usesPayPalVaultedChannel, validationError, wasSessionRecentlyCompleted, writeStripePayPalContinuation };