@flopay/react 1.7.0 → 1.8.1

package/README.md

@@ -791,57 +791,13 @@ The SDK exposes the relevant pieces in three ways:
 
 - **`DirectPayPalButton`** (standalone): can be rendered outside `SplitCardForm` when you only need the PayPal button. Pass `clientId`, `currency`, `environment`, `isSubscription`, and the backend-advertised `providerObjectType` when present. `isSubscription` remains the compatibility fallback when the field is absent.
 
-- **`PayPalButton`** (standalone): Must be rendered inside its own `FloPayProvider`:
-
-```tsx
-{/* Main checkout provider */}
-<FloPayProvider flopay={flopay} options={{ amount, currency }}>
-  <SplitCardForm ... />
-</FloPayProvider>
-
-{/* PayPal provider (separate instance) */}
-<FloPayProvider flopay={flopay} options={{ amount, currency, paymentMethodCreation: 'auto' }}>
-  <PayPalButton
-    sessionId="session_uuid"
-    billingApiUrl="https://billing.example.com"
-    email="user@example.com"
-    onComplete={() => router.push('/success')}
-  />
-</FloPayProvider>
-```
-
-### Using Individual Non-card Elements
-
-```tsx
-import { AddressElement, PaymentElement } from '@flopay/react';
-
-function CustomForm() {
-  return (
-    <div>
-      <PaymentElement
-        options={{
-          layout: 'tabs',
-          paymentMethodTypes: ['cashapp', 'ideal'],
-        }}
-      />
-      <AddressElement />
-    </div>
-  );
-}
-```
-
-These elements support wallet/APM and address collection. `PaymentElement`
-requires a non-empty `paymentMethodTypes` allowlist and rejects `card`; use the
-hosted vault checkout surface for card payments.
-
 ### Using Hooks
 
 ```tsx
-import { useFloPay, useElements, useCheckout } from '@flopay/react';
+import { useFloPay, useCheckout } from '@flopay/react';
 
 function PaymentStatus() {
   const flopay = useFloPay();       // FloPay | null
-  const elements = useElements();    // FloPayElements | null
   const checkout = useCheckout();    // { session, loading, error, claimPending }
 
   if (!flopay) return <div>Loading SDK...</div>;
@@ -855,22 +811,18 @@ function PaymentStatus() {
 
 | Component | Description |
 |-----------|-------------|
-| `FloPayProvider` | Context provider. Accepts `flopay` (instance or promise), `options?`, and `children`. Creates the elements group automatically. |
+| `FloPayProvider` | Context provider. Accepts `flopay` (instance or promise), optional `paypalFlopay`, `options?`, and `children`. |
 | `FloPayCheckout` | Recommended self-contained session checkout. Resolves gateways, mounts hosted-vault cards, and preserves wallets/APMs/PayPal/saved-payment flows. |
 | `FloPayCardSetup` | Browser-only no-charge card verification for a merchant-server-created setup session. Requires `sessionId` + `nonce`; reports ready, verified completion, decline, validation, retryable technical error, and cancellation outcomes. |
 | `SplitCardForm` | Advanced checkout surface combining hosted-vault cards with wallets, APMs, and PayPal. Supports `ref` for imperative next-action handling. |
 | `VaultCardFields` | Hosted vault PCI card fields. Used internally by `SplitCardForm` on the vault path; consumes a `CardCaptureAdapter` from `useFloPay().cardCapture()`. |
-| `PayPalButton` | Standalone PayPal button. Requires its own `FloPayProvider` with `paymentMethodCreation` set to something other than `'manual'`. |
 | `DirectPayPalButton` | Standalone direct PayPal Order, provider-managed Subscription, or setup-token button using the session-scoped intent contract. |
-| `PaymentElement` | Provider element for an explicitly declared non-card `paymentMethodTypes` allowlist. |
-| `AddressElement` | Address input element |
 
 ### Hooks
 
 | Hook | Returns | Description |
 |------|---------|-------------|
 | `useFloPay()` | `FloPay \| null` | Current FloPay instance from context. `null` while loading. |
-| `useElements()` | `FloPayElements \| null` | Current elements group from context. `null` while loading. |
 | `useCheckout()` | `CheckoutState` | `{ session, loading, error, claimPending }` from CheckoutContext. `claimPending` remains true while a detached shell is not safe to charge. |
 
 ### FloPayProviderProps
@@ -878,12 +830,8 @@ function PaymentStatus() {
 | Prop | Type | Description |
 |------|------|-------------|
 | `flopay` | `Promise<FloPay> \| FloPay` | SDK instance or promise from `loadFloPay()` |
-| `options.locale` | `string?` | Locale |
-| `options.appearance` | `FloPayAppearance?` | Theme appearance |
-| `options.clientSecret` | `string?` | Existing non-card PaymentIntent or SetupIntent secret; the SDK verifies the provider intent against `PaymentElement`'s explicit wallet/APM allowlist before mounting and rejects card or undeclared methods. Card checkout uses the hosted vault. |
-| `options.amount` | `number?` | Amount in cents for deferred non-card Elements without a `clientSecret` |
-| `options.currency` | `string?` | ISO 4217 currency code for deferred non-card Elements without a `clientSecret` |
-| `options.paymentMethodCreation` | `'manual' \| 'auto'` | How payment methods are created |
+| `paypalFlopay` | `Promise<FloPay> \| FloPay \| null` | Optional Stripe instance used for the Stripe-rendered PayPal redirect leg. |
+| `options.billingApiUrl` | `string?` | Billing API base URL exposed to child components. |
 | `onInstrument` | `(event: FloInstrumentEvent) => void` | Versioned, privacy-safe checkout funnel and phased error feed for merchant analytics. |
 
 ### FloPayCardSetupProps
@@ -998,20 +946,6 @@ Backend rollout verification should confirm that create/read/replay no longer
 invoke PCIVault and that capture issuance occurs only through the deferred
 endpoint when a buyer enters the card path.
 
-### ElementComponentProps (shared by all element components)
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `className` | `string?` | CSS class for wrapper div |
-| `id` | `string?` | HTML id for wrapper div |
-| `style` | `CSSProperties?` | Inline styles for wrapper div |
-| `options` | `Partial<ElementOptions>?` | Options for the underlying element |
-| `onChange` | `(event: ElementChangeEvent) => void` | Value change handler |
-| `onReady` | `() => void` | Element ready handler |
-| `onFocus` | `() => void` | Focus handler |
-| `onBlur` | `() => void` | Blur handler |
-| `onEscape` | `() => void` | Escape key handler |
-
 ### Types
 
 | Type | Description |
@@ -1023,7 +957,5 @@ endpoint when a buyer enters the card path.
 | `FloPayCardSetupCancelEvent` | Unmount-before-terminal cancellation |
 | `FloPayCardSetupError` | Structured setup failure with stable `code` and `retryable` classification |
 | `SplitCardFormProps` | Props for `SplitCardForm` |
-| `PayPalButtonProps` | Props for `PayPalButton` |
-| `ElementComponentProps` | Shared props for all element components |
 | `CheckoutState` | `{ session, loading, error, claimPending }` |
 | `FloInstrumentEvent` | Versioned merchant instrument union with seven lifecycle names, four `checkout_error` phases, and an optional gateway. |