@flopay/react 1.4.21 → 1.4.23

package/README.md

@@ -123,6 +123,11 @@ count as success while pending. Completion fires only after verification says
 the card is usable; decline, validation, retryable technical failure, and
 unmount cancellation remain separate outcomes.
 
+Submission feedback matches checkout: the same processing overlay covers the
+form from the buyer's submit ("SAVING CARD...") and flips to "CARD SAVED"
+(held briefly before `onComplete`) or "CARD NOT SAVED" with the decline
+message (cleared automatically so the buyer can retry in place).
+
 Saved-card listing, setup-session creation, and deletion remain authenticated
 merchant REST calls. Replacement is composition: complete setup for the new
 card, then ask your server to delete the old card. `FloPayCardSetup` deliberately
@@ -284,7 +289,7 @@ legacy props will be removed in `2.0`.
 
 #### Theming
 
-`FloPayCheckout`, `FloPayAutomaticPaymentButton`, and `SplitCardForm` accept a single `theme` prop that maps to a coherent `{appearance, buttonsLayout}` bundle in `@flopay/shared`'s `THEMES` map. One value styles non-card Stripe Elements, the React-rendered wrapper and AVS inputs, the hosted vault widget, and — for `FloPayAutomaticPaymentButton` — the fallback modal that opens when a saved-payment charge can't complete silently.
+`FloPayCheckout`, `FloPayAutomaticPaymentButton`, `SplitCardForm`, and `FloPayCardSetup` accept a single `theme` prop that maps to a coherent `{appearance, buttonsLayout}` bundle in `@flopay/shared`'s `THEMES` map. (`FloPayCardSetup` styles only the hosted vault widget — there are no surrounding Stripe Elements on that surface — and unlike the checkout components it defaults to `'modern-light'` rather than `'classic'`.) One value styles non-card Stripe Elements, the React-rendered wrapper and AVS inputs, the hosted vault widget, and — for `FloPayAutomaticPaymentButton` — the fallback modal that opens when a saved-payment charge can't complete silently.
 
 | `theme` | Aesthetic |
 |---|---|
@@ -831,7 +836,7 @@ function PaymentStatus() {
 | `nonce` | `string` | Required session-bound read/capture token. |
 | `billingApiUrl` | `string?` | Billing API base URL; defaults through normal FloPay environment resolution. |
 | `telemetry` | `boolean?` | Privacy-safe operational telemetry; set `false` to opt out. |
-| `theme` | `VaultCardThemeColors?` | Hosted widget colors. |
+| `theme` | `ThemeId \| VaultCardThemeColors?` | High-level theme id (same values as `FloPayCheckout`, resolved through the same bundle) or raw hosted-widget colors. Defaults to `'modern-light'`; `'classic'` keeps the historic FloPay look. |
 | `containerStyle` | `React.CSSProperties?` | Inline styles for the hosted-widget container. |
 | `loading` | `React.ReactNode?` | Content shown while the session and hosted widget load. |
 | `onReady` | `() => void` | Hosted widget is mounted and accepting input. |