Changed

• Add release candidate logic to publish script (#618)

Fixes

• Fix Shipping/BillingAddressElement Render (#616)

Changed

• Bump sha.js from 2.4.11 to 2.4.12 (#610)
• Bump cipher-base from 1.0.4 to 1.0.6 (#614)

Fixes

• Remove broken Travis badge (#612)

Changed

• Add SPM events/types/tests (#613)

Changed

• [breaking] split out custom checkout imports (#609)
• Update useCheckout to return loading/error states (#606)

Upgrade guidance

Import changes

Checkout paths changed:
Note: this only applies to Elements with Checkout Sessions API integrations.

import {useCheckout, PaymentElement} from '@stripe/react-stripe-js';

to

import {useCheckout, PaymentElement} from '@stripe/react-stripe-js/checkout';

useCheckout changes

Previously:

• CheckoutProvider renders children if initCheckout succeeded, and null otherwise.
• useCheckout() returns the SDK if initCheckout succeeded, and throws an error otherwise.

Now (>= v4.0.0):

• CheckoutProvider renders children unconditionally.
• useCheckout() returns a disjoint union describing the asynchronous state. The new return value now looks like:

type useCheckout = () =>
  | {type: 'loading'}
  | {
      type: 'success';
      checkout: CheckoutValue;
    }
  | {type: 'error'; error: {message: string}};

Changed

• Fix JSDoc elements link (#608)

Fixes

• Patch for global JSX namespace deprecation in React 19 (#607)

New features

• feat: load fonts when they change (#605)

Changed

• Update docs link Elements.tsx (#602)

New features

• Add Tax ID Element Types (#604)

Fixes

• Bump pbkdf2 from 3.1.1 to 3.1.3 (#599)
• Migrate to stale action from stable bot (#600)
• adds check for prerequisites (#590)

Changed

New features

• Export CheckoutContextValue type for useCheckout hook (#588)

Fixes

• Fix clean publish bug (#583)
• Fix issue with ignored appearance changes. (#589)

Changed